How gaurang-5/mathlogs works
MathLogs is a tuition-center management platform with React web and Expo mobile clients backed by an Express API and PostgreSQL. The main workflow is institute staff using either client to manage onboarding, batches and student registration, collect and report fees, and run tests or quizzes; students and parents also use portal and quiz workflows. The README documents additional billing, marketplace, communication, OCR, and super-admin capabilities. Some subsystem paths are directories because their individual wiring was not sampled.
Main entry points: controllers Domain controllers · monthCoverageController.ts Fee collection · prisma.ts PostgreSQL data · routes API routes
Components 24
User applications
- Web application
client/src - Mobile application
mobile/app
API and domain
- API entry
server/src/index.ts - API routes
server/src/routes - Domain controllers
server/src/controllers - PostgreSQL data
server/src/prisma.ts
Institute operations
- Admissions and students
server/src/controllers/studentController.ts - Batch workflows
server/src/controllers/batchController.ts - Fee collection
server/src/controllers/monthCoverageController.ts - Coverage profiles
server/src/services/studentMonthCoverageService.ts - Coverage payments
server/src/services/monthCoveragePaymentService.ts - Fee summaries
server/src/services/monthCoverageSummaryService.ts - Tests and quizzes
server/src/controllers/testController.ts - Student portal
server/src/controllers/studentPortalController.ts
Platform services
- Plans and billing
server/src/controllers/billingController.ts - Institute marketplace
server/src/controllers/marketplaceController.ts - Super-admin tools
server/src/routes/superAdminRoutes.ts - Parent communications
server/src/utils/whatsapp.ts - Reports and files
server/src/utils/paymentStorage.ts - AI and OCR
server/src/utils/ai
External systems
- Object storage
server/src/utils/r2ObjectStorage.ts - Messaging and AI providers
Other components
- Institute staff
- Students and parents
Connections 28
- Institute staff → Web application: uses
- Institute staff → Mobile application: uses
- Students and parents → Web application: uses portal
- Web application → API entry: sends API requests
- Mobile application → API entry: sends API requests
- API entry → API routes: registers routes
- API routes → Domain controllers: dispatches requests
- Domain controllers → Admissions and students: handles student workflows
- Domain controllers → Batch workflows: handles batch workflows
- Domain controllers → Fee collection: handles fee workflows
- Domain controllers → Tests and quizzes: handles assessments
- Domain controllers → Student portal: serves portal workflows
- Domain controllers → Plans and billing: handles billing
- Domain controllers → Institute marketplace: handles marketplace
- API routes → Super-admin tools: dispatches admin routes
- Domain controllers → PostgreSQL data: reads and writes
- Fee collection → Coverage profiles: manages profiles
- Fee collection → Coverage payments: previews and records
- Fee collection → Fee summaries: requests summaries
- Coverage profiles → PostgreSQL data: reads and writes
- Coverage payments → PostgreSQL data: reads and writes
- Fee summaries → PostgreSQL data: reads fee data
- Tests and quizzes → AI and OCR: generates assessments
- Domain controllers → AI and OCR: processes scans
- Domain controllers → Parent communications: sends notifications
- Parent communications → Messaging and AI providers: delivers messages
- Reports and files → Object storage: stores receipt objects
- Object storage → Messaging and AI providers: uses R2 storage