How viraj42/aptify works
Aptify is a quantitative-learning and assessment platform. Learners browse a syllabus, follow topic difficulty levels, complete generated practice sessions, and review results; they can also take timed company mock exams and inspect analytics. The graph separates the learner experience, practice generation and progression, mock assessments, and shared platform services. Relationships are included where the excerpts, SOURCE INDEX references, or README support them; some documented capabilities, such as caching and OAuth, were not shown in implementation excerpts.
Main entry points: server.js Express API · mock.controller.js Mock lifecycle and scoring · question.model.js Question records · level.controller.js Level roadmap
Components 28
Learner experience
- React application
Frontend/my-app/src/App.jsx - Practice session UI
Frontend/my-app/src/pages/PracticeEnginePage.jsx - Practice API client
Frontend/my-app/src/api/practice.api.js - Mock exam pages
Frontend/my-app/src/pages/MockExam.jsx
Practice and progression
- Practice routes
Backend/routes/practice.routes.js - Practice session handler
Backend/controllers/practice.controller.js - Session selection
Backend/utils/sessionBuilder.js - Level roadmap
Backend/controllers/level.controller.js - Level unlock rules
Backend/utils/unlockEvaluator.js - AI question generation
Backend/utils/aiQuestionGenerator.js - Question records
Backend/models/question.model.js - Practice attempts
Backend/models/attempt.model.js
Mock assessments
- Mock routes
Backend/routes/mock.routes.js - Mock lifecycle and scoring
Backend/controllers/mock.controller.js - Mock paper builder
Backend/utils/MockpaperBuilder.js - Mock attempt records
Backend/models/mockAttempt.model.js - Mock answer records
Backend/models/mockAttemptQuestion.model.js
Platform services
- Express API
Backend/server.js - JWT authentication
Backend/middlewares/auth.middleware.js - Progressive cache
Backend/middlewares/cache.middleware.js - API rate limiting
Backend/middlewares/rateLimit.middleware.js - MongoDB
- Redis
- AI providers
- Google OAuth
Analytics and catalog
- Analytics handlers
Backend/controllers/analytics.controller.js - Syllabus catalog
Backend/controllers/section.controller.js
Other components
- Learner
Connections 35
- Learner → React application: uses
Frontend/my-app/src/App.jsx - React application → Practice session UI: routes to
Frontend/my-app/src/App.jsx - Practice session UI → Practice API client: starts and submits
Frontend/my-app/src/pages/PracticeEnginePage.jsx - Practice API client → Express API: sends requests
Frontend/my-app/src/api/practice.api.js - Express API → Practice routes: mounts
Backend/server.js - Practice routes → JWT authentication: authenticates
Backend/routes/practice.routes.js - Practice routes → Practice session handler: dispatches to
Backend/routes/practice.routes.js - Practice session handler → Session selection: builds session
Backend/controllers/practice.controller.js - Session selection → Level unlock rules: checks access
Backend/utils/sessionBuilder.js - Session selection → Question records: selects questions
Backend/utils/sessionBuilder.js - Practice session handler → Practice attempts: records answers
Backend/controllers/practice.controller.js - Practice session handler → Question records: validates answers
Backend/controllers/practice.controller.js - Level roadmap → Practice attempts: aggregates progress
Backend/controllers/level.controller.js - Level roadmap → Level unlock rules: checks levels
Backend/controllers/level.controller.js - Level roadmap → Question records: checks unseen pool
Backend/controllers/level.controller.js - Level roadmap → AI question generation: triggers generation
Backend/controllers/level.controller.js - Session selection → AI question generation: tops up pool
Backend/utils/sessionBuilder.js - AI question generation → Question records: saves questions
Backend/utils/aiQuestionGenerator.js - AI question generation → AI providers: generates with
- Express API → Mock routes: mounts
Backend/server.js - Mock routes → JWT authentication: authenticates
Backend/routes/mock.routes.js - Mock routes → Progressive cache: caches company list
Backend/routes/mock.routes.js - Mock routes → Mock lifecycle and scoring: dispatches to
Backend/routes/mock.routes.js - Mock exam pages → Express API: uses mock API
- Mock lifecycle and scoring → Mock paper builder: builds paper
Backend/controllers/mock.controller.js - Mock lifecycle and scoring → Mock attempt records: creates and reads attempts
Backend/controllers/mock.controller.js - Mock lifecycle and scoring → Mock answer records: records and reads answers
Backend/controllers/mock.controller.js - Mock lifecycle and scoring → Question records: loads questions
Backend/controllers/mock.controller.js - Express API → Analytics handlers: mounts analytics routes
Backend/server.js - Express API → Syllabus catalog: mounts syllabus routes
Backend/server.js - Express API → API rate limiting: limits API requests
Backend/server.js - Progressive cache → Redis: checks cache
- Progressive cache → MongoDB: falls back to database
- Express API → MongoDB: connects
Backend/server.js - Learner → Google OAuth: may authenticate with