# viraj42/aptify architecture

> Architecture diagram of the GitHub repository viraj42/aptify, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/viraj42/aptify
- Repository: https://github.com/viraj42/aptify

## Overview

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: [`Backend/server.js`](https://github.com/viraj42/aptify/blob/main/Backend/server.js) (Express API), [`Backend/controllers/mock.controller.js`](https://github.com/viraj42/aptify/blob/main/Backend/controllers/mock.controller.js) (Mock lifecycle and scoring), [`Backend/models/question.model.js`](https://github.com/viraj42/aptify/blob/main/Backend/models/question.model.js) (Question records), [`Backend/controllers/level.controller.js`](https://github.com/viraj42/aptify/blob/main/Backend/controllers/level.controller.js) (Level roadmap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learner["Learner experience"]
  node_spa["React application<br/>[App.jsx]"]
  node_practice_ui["Practice session UI"]
  node_practice_api["Practice API client<br/>[practice.api.js]"]
  node_mock_ui["Mock exam pages<br/>[MockExam.jsx]"]
end

subgraph group_practice["Practice and progression"]
  node_practice_routes["Practice routes<br/>[practice.routes.js]"]
  node_practice_controller["Practice session handler"]
  node_session_builder["Session selection<br/>[sessionBuilder.js]"]
  node_levels["Level roadmap"]
  node_unlock["Level unlock rules<br/>[unlockEvaluator.js]"]
  node_generator["AI question generation"]
  node_question_store[("Question records<br/>[question.model.js]")]
  node_attempt_store[("Practice attempts<br/>[attempt.model.js]")]
end

subgraph group_assessment["Mock assessments"]
  node_mock_routes["Mock routes<br/>[mock.routes.js]"]
  node_mock_controller["Mock lifecycle and scoring<br/>[mock.controller.js]"]
  node_mock_builder["Mock paper builder"]
  node_mock_store[("Mock attempt records")]
  node_mock_answers[("Mock answer records")]
end

subgraph group_platform["Platform services"]
  node_backend["Express API<br/>[server.js]"]
  node_auth["JWT authentication<br/>[auth.middleware.js]"]
  node_cache["Progressive cache"]
  node_rate_limit["API rate limiting"]
  node_mongo[("MongoDB")]
  node_redis[("Redis")]
  node_llm["AI providers"]
  node_google["Google OAuth"]
end

subgraph group_insights["Analytics and catalog"]
  node_analytics["Analytics handlers"]
  node_catalog["Syllabus catalog"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_spa
node_spa -->|"routes to"| node_practice_ui
node_practice_ui -->|"starts and submits"| node_practice_api
node_practice_api -->|"sends requests"| node_backend
node_backend -->|"mounts"| node_practice_routes
node_practice_routes -->|"authenticates"| node_auth
node_practice_routes -->|"dispatches to"| node_practice_controller
node_practice_controller -->|"builds session"| node_session_builder
node_session_builder -->|"checks access"| node_unlock
node_session_builder -->|"selects questions"| node_question_store
node_practice_controller -->|"records answers"| node_attempt_store
node_practice_controller -->|"validates answers"| node_question_store
node_levels -->|"aggregates progress"| node_attempt_store
node_levels -->|"checks levels"| node_unlock
node_levels -->|"checks unseen pool"| node_question_store
node_levels -->|"triggers generation"| node_generator
node_session_builder -->|"tops up pool"| node_generator
node_generator -->|"saves questions"| node_question_store
node_generator -.->|"generates with"| node_llm
node_backend -->|"mounts"| node_mock_routes
node_mock_routes -->|"authenticates"| node_auth
node_mock_routes -->|"caches company list"| node_cache
node_mock_routes -->|"dispatches to"| node_mock_controller
node_mock_ui -.->|"uses mock API"| node_backend
node_mock_controller -->|"builds paper"| node_mock_builder
node_mock_controller -->|"creates and reads attempts"| node_mock_store
node_mock_controller -->|"records and reads answers"| node_mock_answers
node_mock_controller -->|"loads questions"| node_question_store
node_backend -->|"mounts analytics routes"| node_analytics
node_backend -->|"mounts syllabus routes"| node_catalog
node_backend -->|"limits API requests"| node_rate_limit
node_cache -->|"checks cache"| node_redis
node_cache -->|"falls back to database"| node_mongo
node_backend -->|"connects"| node_mongo
node_learner -.->|"may authenticate with"| node_google

click node_spa "https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/App.jsx"
click node_practice_ui "https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/pages/PracticeEnginePage.jsx"
click node_practice_api "https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/api/practice.api.js"
click node_mock_ui "https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/pages/MockExam.jsx"
click node_backend "https://github.com/viraj42/aptify/blob/main/Backend/server.js"
click node_practice_routes "https://github.com/viraj42/aptify/blob/main/Backend/routes/practice.routes.js"
click node_auth "https://github.com/viraj42/aptify/blob/main/Backend/middlewares/auth.middleware.js"
click node_practice_controller "https://github.com/viraj42/aptify/blob/main/Backend/controllers/practice.controller.js"
click node_session_builder "https://github.com/viraj42/aptify/blob/main/Backend/utils/sessionBuilder.js"
click node_levels "https://github.com/viraj42/aptify/blob/main/Backend/controllers/level.controller.js"
click node_unlock "https://github.com/viraj42/aptify/blob/main/Backend/utils/unlockEvaluator.js"
click node_generator "https://github.com/viraj42/aptify/blob/main/Backend/utils/aiQuestionGenerator.js"
click node_question_store "https://github.com/viraj42/aptify/blob/main/Backend/models/question.model.js"
click node_attempt_store "https://github.com/viraj42/aptify/blob/main/Backend/models/attempt.model.js"
click node_mock_routes "https://github.com/viraj42/aptify/blob/main/Backend/routes/mock.routes.js"
click node_mock_controller "https://github.com/viraj42/aptify/blob/main/Backend/controllers/mock.controller.js"
click node_mock_builder "https://github.com/viraj42/aptify/blob/main/Backend/utils/MockpaperBuilder.js"
click node_mock_store "https://github.com/viraj42/aptify/blob/main/Backend/models/mockAttempt.model.js"
click node_mock_answers "https://github.com/viraj42/aptify/blob/main/Backend/models/mockAttemptQuestion.model.js"
click node_analytics "https://github.com/viraj42/aptify/blob/main/Backend/controllers/analytics.controller.js"
click node_catalog "https://github.com/viraj42/aptify/blob/main/Backend/controllers/section.controller.js"
click node_cache "https://github.com/viraj42/aptify/blob/main/Backend/middlewares/cache.middleware.js"
click node_rate_limit "https://github.com/viraj42/aptify/blob/main/Backend/middlewares/rateLimit.middleware.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_spa,node_practice_ui,node_practice_api,node_mock_ui toneBlue
class node_practice_routes,node_practice_controller,node_session_builder,node_levels,node_unlock,node_generator,node_question_store,node_attempt_store toneAmber
class node_mock_routes,node_mock_controller,node_mock_builder,node_mock_store,node_mock_answers toneMint
class node_backend,node_auth,node_cache,node_rate_limit,node_mongo,node_redis,node_llm,node_google toneRose
class node_analytics,node_catalog,node_learner toneIndigo
```

## Components

### Learner experience

- [React application](https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/App.jsx): `Frontend/my-app/src/App.jsx`
- [Practice session UI](https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/pages/PracticeEnginePage.jsx): `Frontend/my-app/src/pages/PracticeEnginePage.jsx`
- [Practice API client](https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/api/practice.api.js): `Frontend/my-app/src/api/practice.api.js`
- [Mock exam pages](https://github.com/viraj42/aptify/blob/main/Frontend/my-app/src/pages/MockExam.jsx): `Frontend/my-app/src/pages/MockExam.jsx`

### Practice and progression

- [Practice routes](https://github.com/viraj42/aptify/blob/main/Backend/routes/practice.routes.js): `Backend/routes/practice.routes.js`
- [Practice session handler](https://github.com/viraj42/aptify/blob/main/Backend/controllers/practice.controller.js): `Backend/controllers/practice.controller.js`
- [Session selection](https://github.com/viraj42/aptify/blob/main/Backend/utils/sessionBuilder.js): `Backend/utils/sessionBuilder.js`
- [Level roadmap](https://github.com/viraj42/aptify/blob/main/Backend/controllers/level.controller.js): `Backend/controllers/level.controller.js`
- [Level unlock rules](https://github.com/viraj42/aptify/blob/main/Backend/utils/unlockEvaluator.js): `Backend/utils/unlockEvaluator.js`
- [AI question generation](https://github.com/viraj42/aptify/blob/main/Backend/utils/aiQuestionGenerator.js): `Backend/utils/aiQuestionGenerator.js`
- [Question records](https://github.com/viraj42/aptify/blob/main/Backend/models/question.model.js): `Backend/models/question.model.js`
- [Practice attempts](https://github.com/viraj42/aptify/blob/main/Backend/models/attempt.model.js): `Backend/models/attempt.model.js`

### Mock assessments

- [Mock routes](https://github.com/viraj42/aptify/blob/main/Backend/routes/mock.routes.js): `Backend/routes/mock.routes.js`
- [Mock lifecycle and scoring](https://github.com/viraj42/aptify/blob/main/Backend/controllers/mock.controller.js): `Backend/controllers/mock.controller.js`
- [Mock paper builder](https://github.com/viraj42/aptify/blob/main/Backend/utils/MockpaperBuilder.js): `Backend/utils/MockpaperBuilder.js`
- [Mock attempt records](https://github.com/viraj42/aptify/blob/main/Backend/models/mockAttempt.model.js): `Backend/models/mockAttempt.model.js`
- [Mock answer records](https://github.com/viraj42/aptify/blob/main/Backend/models/mockAttemptQuestion.model.js): `Backend/models/mockAttemptQuestion.model.js`

### Platform services

- [Express API](https://github.com/viraj42/aptify/blob/main/Backend/server.js): `Backend/server.js`
- [JWT authentication](https://github.com/viraj42/aptify/blob/main/Backend/middlewares/auth.middleware.js): `Backend/middlewares/auth.middleware.js`
- [Progressive cache](https://github.com/viraj42/aptify/blob/main/Backend/middlewares/cache.middleware.js): `Backend/middlewares/cache.middleware.js`
- [API rate limiting](https://github.com/viraj42/aptify/blob/main/Backend/middlewares/rateLimit.middleware.js): `Backend/middlewares/rateLimit.middleware.js`
- **MongoDB**
- **Redis**
- **AI providers**
- **Google OAuth**

### Analytics and catalog

- [Analytics handlers](https://github.com/viraj42/aptify/blob/main/Backend/controllers/analytics.controller.js): `Backend/controllers/analytics.controller.js`
- [Syllabus catalog](https://github.com/viraj42/aptify/blob/main/Backend/controllers/section.controller.js): `Backend/controllers/section.controller.js`

### Other components

- **Learner**

## Connections

- Learner → React application: uses (evidence: `Frontend/my-app/src/App.jsx`)
- React application → Practice session UI: routes to (evidence: `Frontend/my-app/src/App.jsx`)
- Practice session UI → Practice API client: starts and submits (evidence: `Frontend/my-app/src/pages/PracticeEnginePage.jsx`)
- Practice API client → Express API: sends requests (evidence: `Frontend/my-app/src/api/practice.api.js`)
- Express API → Practice routes: mounts (evidence: `Backend/server.js`)
- Practice routes → JWT authentication: authenticates (evidence: `Backend/routes/practice.routes.js`)
- Practice routes → Practice session handler: dispatches to (evidence: `Backend/routes/practice.routes.js`)
- Practice session handler → Session selection: builds session (evidence: `Backend/controllers/practice.controller.js`)
- Session selection → Level unlock rules: checks access (evidence: `Backend/utils/sessionBuilder.js`)
- Session selection → Question records: selects questions (evidence: `Backend/utils/sessionBuilder.js`)
- Practice session handler → Practice attempts: records answers (evidence: `Backend/controllers/practice.controller.js`)
- Practice session handler → Question records: validates answers (evidence: `Backend/controllers/practice.controller.js`)
- Level roadmap → Practice attempts: aggregates progress (evidence: `Backend/controllers/level.controller.js`)
- Level roadmap → Level unlock rules: checks levels (evidence: `Backend/controllers/level.controller.js`)
- Level roadmap → Question records: checks unseen pool (evidence: `Backend/controllers/level.controller.js`)
- Level roadmap → AI question generation: triggers generation (evidence: `Backend/controllers/level.controller.js`)
- Session selection → AI question generation: tops up pool (evidence: `Backend/utils/sessionBuilder.js`)
- AI question generation → Question records: saves questions (evidence: `Backend/utils/aiQuestionGenerator.js`)
- AI question generation → AI providers: generates with
- Express API → Mock routes: mounts (evidence: `Backend/server.js`)
- Mock routes → JWT authentication: authenticates (evidence: `Backend/routes/mock.routes.js`)
- Mock routes → Progressive cache: caches company list (evidence: `Backend/routes/mock.routes.js`)
- Mock routes → Mock lifecycle and scoring: dispatches to (evidence: `Backend/routes/mock.routes.js`)
- Mock exam pages → Express API: uses mock API
- Mock lifecycle and scoring → Mock paper builder: builds paper (evidence: `Backend/controllers/mock.controller.js`)
- Mock lifecycle and scoring → Mock attempt records: creates and reads attempts (evidence: `Backend/controllers/mock.controller.js`)
- Mock lifecycle and scoring → Mock answer records: records and reads answers (evidence: `Backend/controllers/mock.controller.js`)
- Mock lifecycle and scoring → Question records: loads questions (evidence: `Backend/controllers/mock.controller.js`)
- Express API → Analytics handlers: mounts analytics routes (evidence: `Backend/server.js`)
- Express API → Syllabus catalog: mounts syllabus routes (evidence: `Backend/server.js`)
- Express API → API rate limiting: limits API requests (evidence: `Backend/server.js`)
- Progressive cache → Redis: checks cache
- Progressive cache → MongoDB: falls back to database
- Express API → MongoDB: connects (evidence: `Backend/server.js`)
- Learner → Google OAuth: may authenticate with
