How anhtuansss/manmath works
ManMath is a Vietnamese high-school mathematics exam and practice application. Its principal workflow is discovering a published, versioned exam, answering it in the V2 client, submitting for server-authoritative grading and timing, then viewing an owner-authorized receipt, review, history, and learning progress. Separate branches cover quick and persistent topic practice, analytics and recommendations, authentication, and the content/question-bank lifecycle. Some subsystem links are based on README capability descriptions; unsampled implementation details are not inferred as direct calls.
Main entry points: examController.ts Exam controller · examContentAttemptService.ts Attempt persistence · app.ts Express application · ExamContentTakingClient.tsx V2 exam client
Components 28
Learner experience
- Exam discovery
frontend/src/components/exam/ExamListClient.tsx - V2 exam client
frontend/src/components/exam-v2/ExamContentTakingClient.tsx - Result and review
frontend/src/components/exam-v2/ExamContentResultClient.tsx - Topic practice
frontend/src/components/practice/PracticeClient.tsx - Persistent practice UI
frontend/src/components/practice/PersistentPracticeClient.tsx - Attempt history
frontend/src/components/history/HistoryClient.tsx - Learning dashboard
frontend/src/components/dashboard/LearningDashboardClient.tsx - API configuration
frontend/src/config/api.ts
HTTP and identity
- Express application
backend/src/app.ts - Exam routes
backend/src/routes/examRoutes.ts - Auth routes
backend/src/routes/authRoutes.ts - User routes
backend/src/routes/meRoutes.ts - Exam controller
backend/src/controllers/examController.ts - Authentication
backend/src/services/authService.ts
Exam domain
- Published exam read
backend/src/services/examContentReadService.ts - Timing sessions
backend/src/services/examTimingSessionService.ts - Attempt persistence
backend/src/services/examContentAttemptService.ts - Validation and grading
backend/src/services/examContentGradingService.ts - Score rules
backend/src/services/examGrading.ts
Practice and progress
- Quick practice grading
backend/src/services/examContentPracticeService.ts - Practice sessions
backend/src/services/practiceSessionService.ts - Question bank
backend/src/services/questionBankService.ts - Analytics and overview
backend/src/controllers/analyticsController.ts - Learning metrics
backend/src/services/learningOverviewService.ts
Content operations
- Content import and publishing
backend/src/scripts
Other components
- Learner
- PostgreSQL
- Google identity
Connections 35
- Learner → Exam discovery: browses
README.md - Exam discovery → API configuration: requests API
frontend/src/config/api.ts - V2 exam client → API configuration: requests API
frontend/src/config/api.ts - Learner → V2 exam client: answers exam
README.md - V2 exam client → Result and review: views result
README.md - Learner → Topic practice: practices topic
README.md - Learner → Persistent practice UI: practices persistently
README.md - Learner → Attempt history: views history
README.md - Learner → Learning dashboard: views progress
README.md - API configuration → Express application: targets API
- Express application → Exam routes: mounts
backend/src/app.ts - Express application → Auth routes: mounts
backend/src/app.ts - Express application → User routes: mounts
backend/src/app.ts - Exam routes → Exam controller: routes requests
backend/src/routes/examRoutes.ts - Auth routes → Authentication: handles identity
backend/src/routes/authRoutes.ts - User routes → Analytics and overview: routes requests
backend/src/routes/meRoutes.ts - Exam controller → Published exam read: loads exam
backend/src/controllers/examController.ts - Exam controller → Attempt persistence: submits attempt
backend/src/controllers/examController.ts - Exam controller → Quick practice grading: grades practice
backend/src/controllers/examController.ts - Exam controller → Practice sessions: saves response
backend/src/controllers/examController.ts - Attempt persistence → Validation and grading: grades submission
backend/src/services/examContentAttemptService.ts - Attempt persistence → Timing sessions: checks timing
backend/src/services/examContentAttemptService.ts - Attempt persistence → Published exam read: reads exam content
backend/src/services/examContentAttemptService.ts - Validation and grading → Score rules: scores questions
backend/src/services/examContentGradingService.ts - Quick practice grading → Validation and grading: reuses grading
backend/src/services/examContentPracticeService.ts - Practice sessions → Question bank: selects questions
backend/src/services/practiceSessionService.ts - Analytics and overview → Learning metrics: loads metrics
backend/src/controllers/analyticsController.ts - Published exam read → PostgreSQL: reads versions
backend/src/services/examContentReadService.ts - Timing sessions → PostgreSQL: persists sessions
backend/src/services/examTimingSessionService.ts - Attempt persistence → PostgreSQL: persists attempts
backend/src/services/examContentAttemptService.ts - Practice sessions → PostgreSQL: persists sessions
backend/src/services/practiceSessionService.ts - Question bank → PostgreSQL: reads bank
- Learning metrics → PostgreSQL: reads learning data
- Content import and publishing → PostgreSQL: publishes content
- Google identity → Authentication: provides login