How vanyamel/diploma works
LogicMath is a web-based mathematics practice and gamification product. Learners browse categories, generate interactive problems, submit answers, and accumulate progress and XP; accounts support verification and password recovery. The client also exposes favorites, leaderboard, and administration features. The server routes API requests through controllers and domain services to repositories backed by PostgreSQL. The source index identifies several unsampled routes and pages, so their capabilities are represented, but uncertain implementation links are omitted.
Main entry points: App.jsx Page Router · problemsController.js Problem Controller · api.js API Client · authController.js Auth Controller
Components 26
Learner Client
- Page Router
logicmath/client/src/App.jsx - Problem Catalog
logicmath/client/src/pages/CatalogPage.jsx - Solve Page
logicmath/client/src/pages/SolvePage.jsx - Interactive Tasks
logicmath/client/src/features/interactive/InteractiveTaskPanel.jsx - Task Views
logicmath/client/src/features/interactive/tasks - API Client
logicmath/client/src/shared/api.js - Practice State
logicmath/client/src/shared/useStore.js
Accounts
- Auth Page
logicmath/client/src/pages/AuthPage.jsx - Auth State
logicmath/client/src/shared/useAuthStore.js - Auth Controller
logicmath/server/controllers/authController.js - Auth Service
logicmath/server/services/authService.js - Email Delivery
logicmath/server/services/emailService.js - User Repository
logicmath/server/repositories/userRepository.js
Progress & Admin
- Progress Page
logicmath/client/src/pages/ProgressPage.jsx - Favorites Page
logicmath/client/src/pages/FavoritesPage.jsx - Leaderboard Page
logicmath/client/src/pages/LeaderboardPage.jsx - Admin Page
logicmath/client/src/pages/AdminPage.jsx
API & Persistence
- API Route Mounts
logicmath/server/app.js - Problem Controller
logicmath/server/controllers/problemsController.js - Problem Generators
logicmath/server/services/generators - Answer Checker
logicmath/server/services/solvers/ProblemSolver.js - Problem Repository
logicmath/server/repositories/problemRepository.js - Attempt Repository
logicmath/server/repositories/attemptRepository.js - Database Pool
logicmath/server/db/pool.js
Other components
- Learner
- PostgreSQL
Connections 35
- Learner → Page Router: opens
logicmath/client/src/App.jsx - Page Router → Problem Catalog: routes to
logicmath/client/src/App.jsx - Page Router → Solve Page: routes to
logicmath/client/src/App.jsx - Page Router → Auth Page: routes to
logicmath/client/src/App.jsx - Page Router → Progress Page: routes to
logicmath/client/src/App.jsx - Page Router → Favorites Page: routes to
logicmath/client/src/App.jsx - Page Router → Leaderboard Page: routes to
logicmath/client/src/App.jsx - Page Router → Admin Page: routes to
logicmath/client/src/App.jsx - Auth Page → Auth State: uses
logicmath/client/src/pages/AuthPage.jsx - Auth State → API Client: calls
logicmath/client/src/shared/useAuthStore.js - Auth State → Practice State: updates
logicmath/client/src/shared/useAuthStore.js - Interactive Tasks → Task Views: renders
logicmath/client/src/features/interactive/InteractiveTaskPanel.jsx - Interactive Tasks → Practice State: updates
logicmath/client/src/features/interactive/InteractiveTaskPanel.jsx - Interactive Tasks → API Client: calls
logicmath/client/src/features/interactive/InteractiveTaskPanel.jsx - API Client → API Route Mounts: sends API requests
logicmath/client/src/shared/api.js - API Route Mounts → Auth Controller: mounts auth routes
logicmath/server/app.js - API Route Mounts → Problem Controller: mounts problem routes
logicmath/server/app.js - Auth Controller → Auth Service: delegates
logicmath/server/controllers/authController.js - Auth Controller → User Repository: reads user
logicmath/server/controllers/authController.js - Auth Controller → Attempt Repository: reads progress
logicmath/server/controllers/authController.js - Auth Service → User Repository: reads and writes
logicmath/server/services/authService.js - Auth Service → Email Delivery: sends email
logicmath/server/services/authService.js - Problem Controller → Problem Generators: creates problems
logicmath/server/controllers/problemsController.js - Problem Controller → Answer Checker: checks answers
logicmath/server/controllers/problemsController.js - Problem Controller → Problem Repository: stores and loads
logicmath/server/controllers/problemsController.js - Problem Controller → Attempt Repository: records attempts
logicmath/server/controllers/problemsController.js - Problem Controller → User Repository: reads user data
logicmath/server/controllers/problemsController.js - User Repository → Database Pool: queries
logicmath/server/repositories/userRepository.js - Attempt Repository → Database Pool: queries
logicmath/server/repositories/attemptRepository.js - Problem Repository → Database Pool: queries
logicmath/server/repositories/problemRepository.js - Database Pool → PostgreSQL: connects to
logicmath/server/db/pool.js - Favorites Page → API Client: calls
logicmath/client/src/pages/FavoritesPage.jsx - Leaderboard Page → API Client: calls
logicmath/client/src/pages/LeaderboardPage.jsx - Admin Page → API Client: calls
logicmath/client/src/pages/AdminPage.jsx - Progress Page → Practice State: reads progress
logicmath/client/src/pages/ProgressPage.jsx