How aguerta/tops_academy works
Top’s Academy combines a course-bank validator with a browser-based mastery practice platform. Students discover a course, review its competencies, practice and receive feedback, then see progress reflected in mastery tracking; the backend discovers and serves course banks. The README also documents a larger AI content-to-course pipeline, but its implementation is not present in the supplied tree, so it is not mapped here. Edges reflect excerpts, the source index, or README statements; unsampled frontend connections are omitted.
Main entry points: core.py Validation Core · App.tsx Application Flow · PracticeSession.tsx Practice Session · masteryStorage.ts Mastery Tracking
Components 26
Practice Platform
- Web App Entry
platform/src/main.tsx - Application Flow
platform/src/App.tsx - Course Library
platform/src/components/CourseLibrary.tsx - Course Overview
platform/src/components/CourseOverview.tsx - Practice Session
platform/src/components/PracticeSession.tsx - Question Card
platform/src/components/QuestionCard.tsx - Feedback
platform/src/components/FeedbackToast.tsx - Completion Screen
platform/src/components/CompletionScreen.tsx - Course Challenge
platform/src/components/CourseChallenge.tsx - Mastery Tracking
platform/src/utils/masteryStorage.ts - Session Recovery
platform/src/utils/sessionStore.ts - Math Equivalence
platform/src/utils/mathEquivalence.ts - Question Utilities
platform/src/utils/questionUtils.ts - Math Rendering
platform/src/components/MathText.tsx
Course Discovery
- Course API Server
platform/server/courseServer.cjs - Course Index
platform/server/courseIndex.cjs - Course Loader
platform/src/utils/courseLoader.ts - Course JSON Banks
Course Validation
- Validator CLI
src/validator/cli.py - Validation Core
src/validator/core.py - Lexical Scanner
src/validator/lexical_scanner.py - Schema Validator
src/validator/schema_validator.py - Structural Rules
src/validator/rules.py - Psychometric Checks
src/validator/psychometric_checker.py - Validation Results
src/validator/models.py
Other components
- Student
Connections 31
- Student → Web App Entry: opens
platform/src/main.tsx - Web App Entry → Application Flow: renders
platform/src/main.tsx - Application Flow → Course Loader: loads courses
platform/src/App.tsx - Application Flow → Course Library: shows
platform/src/App.tsx - Course Library → Application Flow: selects course
platform/src/App.tsx - Application Flow → Mastery Tracking: loads progress
platform/src/App.tsx - Application Flow → Session Recovery: restores session
platform/src/App.tsx - Course Overview → Mastery Tracking: reads progress
platform/src/components/CourseOverview.tsx - Practice Session → Question Card: renders
platform/src/components/PracticeSession.tsx - Practice Session → Feedback: shows feedback
platform/src/components/PracticeSession.tsx - Practice Session → Math Equivalence: checks answers
platform/src/components/PracticeSession.tsx - Practice Session → Question Utilities: grades choices
platform/src/components/PracticeSession.tsx - Practice Session → Session Recovery: saves session
platform/src/components/PracticeSession.tsx - Question Card → Question Utilities: normalizes questions
platform/src/components/QuestionCard.tsx - Question Card → Math Rendering: renders math
platform/src/components/QuestionCard.tsx - Course Overview → Math Rendering: renders content
platform/src/components/CourseOverview.tsx - Feedback → Math Rendering: renders content
platform/src/components/FeedbackToast.tsx - Completion Screen → Math Rendering: renders content
platform/src/components/CompletionScreen.tsx - Completion Screen → Mastery Tracking: reads progress
platform/src/components/CompletionScreen.tsx - Course Challenge → Mastery Tracking: records mastery
- Course API Server → Course Index: uses index
platform/server/courseServer.cjs - Course Index → Course JSON Banks: scans banks
platform/server/courseIndex.cjs - Course Loader → Course API Server: fetches course data
- Validator CLI → Validation Core: runs validation
src/validator/cli.py - Validation Core → Lexical Scanner: checks syntax
src/validator/core.py - Validation Core → Schema Validator: checks schema
src/validator/core.py - Validation Core → Structural Rules: checks rules
src/validator/core.py - Validation Core → Psychometric Checks: checks quality
src/validator/core.py - Validation Core → Validation Results: builds results
src/validator/core.py - Structural Rules → Validation Results: creates errors
src/validator/rules.py - Lexical Scanner → Validation Results: creates errors
src/validator/lexical_scanner.py