prism-platform

Maulik Radadiya

IQ & Cognitive Assessment Web Platform – MVP 1. Project Overview The objective of this project is to develop a web based IQ and Cognitive Assessment platform that allows users to test their cognitive abilities, play brain training games, access learning courses, and track their cognitive development. The platform will focus on self-discovery and cognitive entertainment, offering structured assessments and activities mapped to specific cognitive skill areas. The MVP will provide the core platform features required for user interaction, testing, progress tracking, and report generation. 2. Technology Stack The platform will be developed using the following technologies: Frontend React.js Backend FastAPI (Python) Database MySQL This architecture ensures a scalable and maintainable system while keeping the MVP implementation efficient. 3. MVP Features The MVP will include the following modules. 3.1 Cognitive Assessment System The platform will include: One primary IQ-style cognitive assessment Additional supporting cognitive tests Tests will consist of: Multiple Choice Questions (MCQ) Image-based questions Logic, puzzles, and pattern recognition questions Each assessment will be mapped to five cognitive categories: Analytical Reasoning Pattern Recognition Spatial Awareness Logical Thinking Memory Training Users will be able to: Start the first test without logging in Complete the assessment Log in afterward to view results 3.2 Brain Games Integration The platform will include brain training games such as logic puzzles, memory games, and Sudoku-style challenges provided by the client as HTML5 game files.. The client will provide HTML5 game files (e.g., Sudoku, memory games, logic puzzles). The development scope includes: Integrating the HTML5 games into the platform Displaying game thumbnails in the UI Launching the games within the web application Tracking game completion or activity Updating the user's cognitive progress based on the relevant cognitive category Game development itself is not part of the scope, as the games will be provided by the client. 3.3 Learning Micro-Courses The platform will include text-based learning courses designed to improve cognitive abilities. Course characteristics: Text-based educational content Short learning modules Quiz questions after learning sections Multiple-choice questions Initial course content will be provided by the client. The system will track course completion and update the relevant cognitive skill metrics. 3.4 User Authentication Users will be able to start the first test without logging in. However, to access results and the dashboard, users must create an account or log in. Authentication features for MVP: Email and password registration Email verification Login using email and password Password reset functionality Phone-based login and two-factor authentication are not included in the MVP. 3.5 Subscription Access Control The billing system will be managed externally by the client. The platform will integrate with the client's billing system via API communication. The backend will receive subscription status notifications, such as: User subscription activated Subscription cancelled Subscription expired Based on this status, the platform will control user access to premium features. The development scope includes: API endpoints for billing communication Subscription status handling Feature access control Payment gateway integration is not part of this project. 3.6 User Dashboard After login, users will have access to a dashboard where they can view: Completed assessments Assessment results Games activity Course progress Cognitive skill development The dashboard will display progress indicators across the five cognitive categories. 3.7 Progress Tracking System The platform will track user development based on activities such as: Assessment performance Game completion Course participation Each activity will update the user's cognitive category scores. Progress will be visualized through graph-based indicators showing the user's development across the five cognitive categories. Advanced features such as percentile comparison are not included in the MVP. 3.8 Assessment Result Reports Each completed assessment will generate a structured report including: Assessment score Cognitive category breakdown Visual charts Narrative explanation based on score range Narratives will be predefined and mapped to specific score ranges. 3.9 Report Export Users will be able to export their results and activity summaries. Export formats include: PDF CSV Reports will follow a static template with dynamic data insertion. 4. System Architecture The platform architecture will consist of three primary components: Frontend Application Built using React Responsible for user interface, assessments, dashboard, and content display Backend API Built using FastAPI Handles authentication, assessments, results, progress tracking, and report generation Database MySQL database for storing users, tests, results, course activity, and progress data 5. Deliverables The following deliverables will be provided as part of the MVP: Fully functional web application Cognitive assessment engine HTML5 game integration Course learning module system User authentication system Subscription access control via API User dashboard Cognitive progress tracking Assessment result reporting PDF and CSV export functionality Deployment-ready backend and frontend services 7. Assumptions The client will provide: Assessment questions Course content HTML5 game files Game thumbnails Billing functionality will be handled by the client's existing billing system. The project scope covers only the web platform MVP. Additional Requirements: New Task Deploy MVP Platform Effort suggestion: Max: 4.0 days Min: 2.0 days Role: DevOps / Fullstack Phase: Final Phase Description Deploy the React frontend, FastAPI backend, and MySQL database to a production-ready environment for client testing and access. Subtasks Configure production server environment (Linux, runtime dependencies) — 0.5 days Deploy FastAPI backend service — 0.5 days Deploy React production build — 0.5 days Configure MySQL database in production — 0.5 days Configure environment variables and secrets — 0.5 days Configure domain, HTTPS, and API routing — 0.5 days Perform deployment testing and bug fixes — 1 day Total ≈ 4 days max