# athithyan-s-developer/techverse-backend architecture

> Architecture diagram of the GitHub repository athithyan-s-developer/techverse-backend, 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/athithyan-s-developer/techverse-backend
- Repository: https://github.com/athithyan-s-developer/techverse-backend

## Overview

TechVerse is an institutional education REST API. Its main learner journey is authenticated course access, sequential module/video progress, assessment, and certificate issuance; a parallel coding arena runs submissions and records outcomes. Faculty and administrators manage academic content and review analytics. The README documents the broader API and MongoDB architecture; source excerpts confirm selected routing, course-progression, and coding-runner relationships, while unsampled branches are represented without speculative call links.

Main entry points: [`src/app.js`](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/app.js) (Express API), [`src/controllers/courseController.js`](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/courseController.js) (Course catalog), [`src/controllers/codingController.js`](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/codingController.js) (Coding arena), [`src/services/moduleProgressionService.js`](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/moduleProgressionService.js) (Progression rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_apiapp["Express API<br/>[app.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_authmw["JWT protection<br/>[authMiddleware.js]"]
  node_roles["Role access<br/>[roleMiddleware.js]"]
  node_users["Profiles and streaks<br/>[userController.js]"]
end

subgraph group_learning["Learning and awards"]
  node_courses["Course catalog"]
  node_modules["Module content"]
  node_progress["Progression rules"]
  node_assessments["Course assessments"]
  node_certificates["Certificates"]
  node_certificateapi["Certificate endpoints"]
end

subgraph group_arena["Coding arena"]
  node_coding["Coding arena"]
  node_runner["Code execution"]
  node_arenaqueue["Run concurrency<br/>[semaphore.js]"]
end

subgraph group_institution["Institution operations"]
  node_institution["Academic structure"]
  node_resources["Learning resources"]
  node_announcements["Announcements"]
  node_placements["Placement events"]
  node_admin["Admin operations<br/>[adminController.js]"]
  node_analytics["Analytics dashboards"]
  node_audit["Audit logging<br/>[auditService.js]"]
end

subgraph group_persistence["Persistence"]
  node_mongo[("MongoDB")]
  node_coursemodels[("Course records<br/>[Course.js]")]
  node_usersmodel[("User records<br/>[User.js]")]
  node_progressmodel[("Enrollment progress<br/>[Enrollment.js]")]
  node_certmodel[("Certificate records<br/>[Certificate.js]")]
  node_codingmodels[("Coding records<br/>[CodingTest.js]")]
end

node_client(("Frontend client"))

node_client -->|"sends HTTP/JSON"| node_apiapp
node_apiapp -->|"routes requests"| node_auth
node_apiapp -->|"routes requests"| node_courses
node_apiapp -->|"routes requests"| node_coding
node_apiapp -->|"routes requests"| node_certificateapi
node_authmw -->|"loads user"| node_usersmodel
node_courses -->|"delegates progress"| node_progress
node_courses -->|"issues award"| node_certificates
node_courses -->|"updates streak"| node_users
node_courses -->|"reads course"| node_coursemodels
node_courses -->|"reads progress"| node_progressmodel
node_progress -->|"issues award"| node_certificates
node_progress -->|"updates enrollment"| node_progressmodel
node_progress -->|"updates streak"| node_users
node_coding -->|"runs submissions"| node_runner
node_coding -->|"handles saturation"| node_arenaqueue
node_coding -->|"updates streak"| node_users
node_coding -->|"reads tests"| node_codingmodels
node_auth -->|"reads credentials"| node_usersmodel
node_certificates -->|"creates certificates"| node_certmodel
node_analytics -->|"queries records"| node_mongo
node_apiapp -.->|"serves API data"| node_mongo
node_auth -->|"records activity"| node_audit
node_announcements -->|"records activity"| node_audit

click node_apiapp "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/app.js"
click node_auth "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/authController.js"
click node_authmw "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/middleware/authMiddleware.js"
click node_roles "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/middleware/roleMiddleware.js"
click node_users "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/userController.js"
click node_courses "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/courseController.js"
click node_modules "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/moduleController.js"
click node_progress "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/moduleProgressionService.js"
click node_assessments "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/courseAssessmentController.js"
click node_certificates "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/certificateService.js"
click node_certificateapi "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/certificateController.js"
click node_coding "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/codingController.js"
click node_runner "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/codeRunnerService.js"
click node_arenaqueue "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/semaphore.js"
click node_institution "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/departmentController.js"
click node_resources "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/resourceController.js"
click node_announcements "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/announcementController.js"
click node_placements "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/placementEventController.js"
click node_admin "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/adminController.js"
click node_analytics "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/adminDashboardService.js"
click node_audit "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/auditService.js"
click node_coursemodels "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/Course.js"
click node_usersmodel "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/User.js"
click node_progressmodel "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/Enrollment.js"
click node_certmodel "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/Certificate.js"
click node_codingmodels "https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/CodingTest.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_apiapp,node_auth,node_authmw,node_roles,node_users,node_client toneBlue
class node_courses,node_modules,node_progress,node_assessments,node_certificates,node_certificateapi toneAmber
class node_coding,node_runner,node_arenaqueue toneMint
class node_institution,node_resources,node_announcements,node_placements,node_admin,node_analytics,node_audit toneRose
class node_mongo,node_coursemodels,node_usersmodel,node_progressmodel,node_certmodel,node_codingmodels toneIndigo
```

## Components

### API and identity

- [Express API](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/app.js): `src/app.js`
- [Authentication](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/authController.js): `src/controllers/authController.js`
- [JWT protection](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/middleware/authMiddleware.js): `src/middleware/authMiddleware.js`
- [Role access](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/middleware/roleMiddleware.js): `src/middleware/roleMiddleware.js`
- [Profiles and streaks](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/userController.js): `src/controllers/userController.js`

### Learning and awards

- [Course catalog](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/courseController.js): `src/controllers/courseController.js`
- [Module content](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/moduleController.js): `src/controllers/moduleController.js`
- [Progression rules](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/moduleProgressionService.js): `src/services/moduleProgressionService.js`
- [Course assessments](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/courseAssessmentController.js): `src/controllers/courseAssessmentController.js`
- [Certificates](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/certificateService.js): `src/services/certificateService.js`
- [Certificate endpoints](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/certificateController.js): `src/controllers/certificateController.js`

### Coding arena

- [Coding arena](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/codingController.js): `src/controllers/codingController.js`
- [Code execution](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/codeRunnerService.js): `src/services/codeRunnerService.js`
- [Run concurrency](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/semaphore.js): `src/services/semaphore.js`

### Institution operations

- [Academic structure](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/departmentController.js): `src/controllers/departmentController.js`
- [Learning resources](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/resourceController.js): `src/controllers/resourceController.js`
- [Announcements](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/announcementController.js): `src/controllers/announcementController.js`
- [Placement events](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/placementEventController.js): `src/controllers/placementEventController.js`
- [Admin operations](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/controllers/adminController.js): `src/controllers/adminController.js`
- [Analytics dashboards](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/adminDashboardService.js): `src/services/adminDashboardService.js`
- [Audit logging](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/services/auditService.js): `src/services/auditService.js`

### Persistence

- **MongoDB**
- [Course records](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/Course.js): `src/models/Course.js`
- [User records](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/User.js): `src/models/User.js`
- [Enrollment progress](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/Enrollment.js): `src/models/Enrollment.js`
- [Certificate records](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/Certificate.js): `src/models/Certificate.js`
- [Coding records](https://github.com/athithyan-s-developer/techverse-backend/blob/main/src/models/CodingTest.js): `src/models/CodingTest.js`

### Other components

- **Frontend client**

## Connections

- Frontend client → Express API: sends HTTP/JSON
- Express API → Authentication: routes requests (evidence: `src/app.js`)
- Express API → Course catalog: routes requests (evidence: `src/app.js`)
- Express API → Coding arena: routes requests (evidence: `src/app.js`)
- Express API → Certificate endpoints: routes requests (evidence: `src/app.js`)
- JWT protection → User records: loads user (evidence: `src/middleware/authMiddleware.js`)
- Course catalog → Progression rules: delegates progress (evidence: `src/controllers/courseController.js`)
- Course catalog → Certificates: issues award (evidence: `src/controllers/courseController.js`)
- Course catalog → Profiles and streaks: updates streak (evidence: `src/controllers/courseController.js`)
- Course catalog → Course records: reads course (evidence: `src/controllers/courseController.js`)
- Course catalog → Enrollment progress: reads progress (evidence: `src/controllers/courseController.js`)
- Progression rules → Certificates: issues award (evidence: `src/services/moduleProgressionService.js`)
- Progression rules → Enrollment progress: updates enrollment (evidence: `src/services/moduleProgressionService.js`)
- Progression rules → Profiles and streaks: updates streak (evidence: `src/services/moduleProgressionService.js`)
- Coding arena → Code execution: runs submissions (evidence: `src/controllers/codingController.js`)
- Coding arena → Run concurrency: handles saturation (evidence: `src/controllers/codingController.js`)
- Coding arena → Profiles and streaks: updates streak (evidence: `src/controllers/codingController.js`)
- Coding arena → Coding records: reads tests (evidence: `src/controllers/codingController.js`)
- Authentication → User records: reads credentials (evidence: `src/controllers/authController.js`)
- Certificates → Certificate records: creates certificates (evidence: `src/services/certificateService.js`)
- Analytics dashboards → MongoDB: queries records (evidence: `src/services/adminDashboardService.js`)
- Express API → MongoDB: serves API data
- Authentication → Audit logging: records activity (evidence: `src/controllers/authController.js`)
- Announcements → Audit logging: records activity (evidence: `src/controllers/announcementController.js`)
