How h4r4k1ri/math-tutor-platform works
Math Tutor Platform is a teacher–student education product. Users enter through the React application, authenticate, and use domain pages for assignments, feedback, lessons, materials, groups, and other teaching workflows; the frontend API client connects those workflows to a FastAPI backend. Backend routers expose the domain services, which persist domain records in PostgreSQL, while chat also supports real-time Socket.IO messaging. The README documents file uploads and teacher review of student solutions. Some feature modules were not sampled, so their internal call paths are not asserted.
Main entry points: main.py FastAPI entry · db.py PostgreSQL · socket.py Realtime chat · App.tsx React application
Components 21
Web application
- React application
frontend/src/App.tsx - Auth context
frontend/src/context/AuthContext.tsx - API client
frontend/src/api/client.ts - Domain pages
frontend/src/pages - Realtime client
frontend/src/socket.ts
Learning workflow
- Assignments
backend/app/assignments/service.py - Solution review
backend/app/reviews/service.py - Lessons
backend/app/lessons/service.py - Learning materials
backend/app/materials/service.py - File uploads
backend/app/api/uploads.py - Student progress
backend/app/students/service.py
People and communication
- Groups
backend/app/groups/service.py - Tutoring requests
backend/app/tutoring_requests/service.py - Chat service
backend/app/chat/service.py - Realtime chat
backend/app/chat/socket.py
Platform services
- Authentication
backend/app/auth/service.py - FastAPI entry
backend/app/main.py - Payments
backend/app/payments/service.py - Reminders and email
backend/app/notifications
Persistence
- PostgreSQL
backend/app/shared/db.py
Other components
- Teacher / student
Connections 32
- Teacher / student → React application: uses
- React application → Auth context: provides auth
frontend/src/App.tsx - Auth context → API client: requests identity
frontend/src/context/AuthContext.tsx - Auth context → Realtime client: connects after login
frontend/src/context/AuthContext.tsx - React application → Domain pages: routes to
frontend/src/App.tsx - Domain pages → API client: requests materials
frontend/src/pages/MaterialsPage.tsx - API client → FastAPI entry: HTTP requests
frontend/src/api/client.ts - FastAPI entry → Authentication: registers router
backend/app/main.py - FastAPI entry → Assignments: registers router
backend/app/main.py - FastAPI entry → Solution review: registers router
backend/app/main.py - FastAPI entry → Lessons: registers router
backend/app/main.py - FastAPI entry → Learning materials: registers router
backend/app/main.py - FastAPI entry → Groups: registers router
backend/app/main.py - FastAPI entry → Tutoring requests: registers router
backend/app/main.py - FastAPI entry → Chat service: registers router
backend/app/main.py - FastAPI entry → Payments: registers router
backend/app/main.py - FastAPI entry → Student progress: registers router
backend/app/main.py - FastAPI entry → File uploads: registers uploads
backend/app/main.py - FastAPI entry → Realtime chat: mounts socket app
backend/app/main.py - Realtime client → Realtime chat: Socket.IO events
- Learning materials → Realtime chat: emits updates
backend/app/materials/service.py - Chat service → Realtime chat: emits chat events
backend/app/chat/service.py - Authentication → PostgreSQL: uses user model
- Assignments → PostgreSQL: uses models
- Solution review → PostgreSQL: uses models
- Lessons → PostgreSQL: uses models
- Learning materials → PostgreSQL: uses models
backend/app/materials/service.py - Student progress → PostgreSQL: queries domain data
backend/app/students/service.py - Groups → PostgreSQL: uses domain models
backend/app/groups/service.py - Chat service → PostgreSQL: uses chat models
backend/app/chat/service.py - Realtime chat → PostgreSQL: reads and writes
backend/app/chat/socket.py - Payments → PostgreSQL: uses payment model
backend/app/payments/service.py