How rachitmalik-byte/verson2-kidos works
PolyQuest Academy is an interactive STEM learning platform for students, with separate teacher and parent portals. Students enter through role and subject selection, explore chapter hubs and themed missions, and learn through simulations, quizzes, discovery tracking, and Pip’s AI/voice features. The map also preserves documented guidebook, video, arcade, and educator capabilities. Relationships are limited to routes, imports, and calls visible in the provided excerpts or SOURCE INDEX; unsampled subsystems are shown without speculative connections.
Main entry points: App.tsx App Router · Pip.tsx Pip Companion · DynamicMissionEngine.tsx Mission Engine · SuperSensesMissionEngine.tsx Super Senses
Components 26
App Navigation
- App Router
src/App.tsx - Role Selection
src/features/role-selection/RoleSelection.tsx - Subject Selection
src/features/subject-selection/SubjectSelection.tsx
Student Learning
- Chapter Hub
src/features/chapter-hub/ChapterHub.tsx - Master Curriculum
src/data/masterCurriculum.ts - Mission Engine
src/features/missions/universal-mission/DynamicMissionEngine.tsx - Raincoat Mission
src/features/missions/mission-01-raincoat/RaincoatMission.tsx - Super Senses
src/features/theme1/SuperSensesMissionEngine.tsx - Shelter Missions
src/features/theme-shelter/ShelterMissionEngine.tsx - Water Missions
src/features/theme-water/WaterMissionEngine.tsx - Learning Progress
src/stores/progressStore.ts - Discovery Journal
src/stores/discoveryStore.ts - Digital Guidebook
src/features/guidebook/DigitalGuidebook.tsx - Video Lab
src/features/video-lab/VideoLabPage.tsx
Interactive Science
- Activity Renderer
src/components/engine/ActivityRenderer.tsx - Diagram Engine
src/components/engine/InteractiveDiagramEngine.tsx - Microscope Studio
src/components/microscope/MultiTierMicroscopeStudio.tsx - Voxel Engine
src/components/voxel/VoxelEngine.ts - Science Arcade
src/features/arcade/ScienceArcadeModal.tsx
Pip and Audio
- Pip Companion
src/components/pip/Pip.tsx - Read Aloud Coach
src/components/voice/SpeechReadAloudCoach.tsx - Voice Assistant
src/lib/voiceAssistant.ts - AI Service
src/services/aiService.ts
Learning Portals
- Teacher Studio
src/features/teacher-studio/TeacherStudio.tsx - Parent Dashboard
src/features/parent/ParentDashboard.tsx
Other components
- Student
Connections 33
- Student → App Router: opens
src/App.tsx - App Router → Role Selection: routes to
src/App.tsx - App Router → Subject Selection: routes to
src/App.tsx - App Router → Chapter Hub: routes to
src/App.tsx - App Router → Mission Engine: routes to
src/App.tsx - App Router → Super Senses: routes to
src/App.tsx - App Router → Shelter Missions: routes to
src/App.tsx - App Router → Water Missions: routes to
src/App.tsx - App Router → Teacher Studio: routes to
src/App.tsx - Role Selection → Subject Selection: selects subject
- Chapter Hub → Master Curriculum: uses curriculum
- Mission Engine → Learning Progress: updates progress
src/features/missions/universal-mission/DynamicMissionEngine.tsx - Mission Engine → Discovery Journal: records discoveries
src/features/missions/universal-mission/DynamicMissionEngine.tsx - Mission Engine → Pip Companion: renders companion
src/features/missions/universal-mission/DynamicMissionEngine.tsx - Super Senses → Discovery Journal: records discoveries
src/features/theme1/SuperSensesMissionEngine.tsx - Super Senses → Pip Companion: renders companion
src/features/theme1/SuperSensesMissionEngine.tsx - Super Senses → Microscope Studio: renders studio
src/features/theme1/SuperSensesMissionEngine.tsx - Shelter Missions → Microscope Studio: renders studio
src/features/theme-shelter/ShelterMissionEngine.tsx - Shelter Missions → Pip Companion: renders companion
src/features/theme-shelter/ShelterMissionEngine.tsx - Water Missions → Diagram Engine: renders simulator
src/features/theme-water/WaterMissionEngine.tsx - Water Missions → Voxel Engine: renders diorama
src/features/theme-water/WaterMissionEngine.tsx - Activity Renderer → Diagram Engine: renders activity
- Activity Renderer → Microscope Studio: renders activity
- Pip Companion → Learning Progress: reads state
src/components/pip/Pip.tsx - Pip Companion → Voice Assistant: uses voice
src/components/pip/Pip.tsx - Read Aloud Coach → Voice Assistant: uses voice
src/components/voice/SpeechReadAloudCoach.tsx - Voice Assistant → AI Service: AI coaching
- Teacher Studio → Activity Renderer: renders activities
src/features/teacher-studio/TeacherStudio.tsx - Teacher Studio → AI Service: creates lessons
src/features/teacher-studio/TeacherStudio.tsx - Student → Digital Guidebook: consults guidebook
README.md - Student → Video Lab: explores video labs
README.md - Student → Science Arcade: plays science games
README.md - Student → Parent Dashboard: guardian oversight
README.md