# sadiq-code-nest/devops-academy architecture

> Architecture diagram of the GitHub repository sadiq-code-nest/devops-academy, 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/sadiq-code-nest/devops-academy
- Repository: https://github.com/sadiq-code-nest/devops-academy

## Overview

DevOps Academy is a student-enrollment web application: visitors explore the academy, register or sign in, and use role-gated dashboards; administrators manage student and review data. The React client calls an Express API backed by MongoDB. The README also documents application metrics scraped by Prometheus. Deployment, CI/CD, Kubernetes, and monitoring-platform internals are outside this source tree, so they are not mapped. Some frontend and controller relationships are supported by the SOURCE INDEX rather than inspected implementation excerpts.

Main entry points: [`backend/app.js`](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/app.js) (Express API), [`frontend/src/api/axios.js`](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/api/axios.js) (HTTP client), [`frontend/src/App.jsx`](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/App.jsx) (React application), [`frontend/src/pages/Home.jsx`](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/Home.jsx) (Academy home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_reactapp["React application<br/>[App.jsx]"]
  node_academyhome["Academy home<br/>[Home.jsx]"]
  node_coursecontent["Course information<br/>[Curriculum.jsx]"]
  node_pricing["Enrollment offer<br/>[Pricing.jsx]"]
  node_reviewsui["Review experience<br/>[Reviews.jsx]"]
  node_authui["Login and registration<br/>[AuthContext.jsx]"]
  node_studentdash["Student dashboard<br/>[Dashboard.jsx]"]
  node_admindash["Admin dashboard<br/>[Dashboard.jsx]"]
  node_instructordash["Instructor dashboard<br/>[Dashboard.jsx]"]
  node_httpclient["HTTP client<br/>[axios.js]"]
end

subgraph group_api["API and access"]
  node_expressapp["Express API<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_authcontroller["Student authentication<br/>[authController.js]"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_admincontroller["Admin operations<br/>[adminController.js]"]
  node_enrollroutes["Enrollment routes<br/>[enrollRoutes.js]"]
  node_reviewroutes["Review routes<br/>[reviewRoutes.js]"]
  node_authmiddleware["JWT access control<br/>[authMiddleware.js]"]
end

subgraph group_domain["Enrollment domain"]
  node_enrollcontroller["Enrollment operations"]
  node_reviewcontroller["Review moderation"]
  node_users[("User records<br/>[User.js]")]
  node_enrollments[("Enrollment records<br/>[Enrollment.js]")]
  node_reviews[("Review records<br/>[Review.js]")]
  node_mongodb[("MongoDB")]
end

subgraph group_observability["App metrics"]
  node_metricsmodule["Request metrics<br/>[metrics.js]"]
  node_prometheus["Prometheus"]
end

node_visitor(("Visitor / student"))
node_adminactor(("Administrator"))

node_visitor -->|"uses"| node_reactapp
node_adminactor -->|"uses"| node_reactapp
node_reactapp -->|"routes to"| node_academyhome
node_reactapp -->|"provides auth"| node_authui
node_reactapp -->|"routes to"| node_studentdash
node_reactapp -->|"routes to"| node_admindash
node_academyhome -->|"renders"| node_coursecontent
node_academyhome -->|"renders"| node_pricing
node_academyhome -->|"renders"| node_reviewsui
node_authui -->|"calls"| node_httpclient
node_pricing -->|"calls"| node_httpclient
node_reviewsui -->|"calls"| node_httpclient
node_studentdash -->|"calls"| node_httpclient
node_admindash -->|"calls"| node_httpclient
node_instructordash -->|"calls"| node_httpclient
node_httpclient -->|"REST requests"| node_expressapp
node_expressapp -->|"mounts"| node_authroutes
node_expressapp -->|"mounts"| node_enrollroutes
node_expressapp -->|"mounts"| node_reviewroutes
node_expressapp -->|"mounts"| node_adminroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authcontroller -->|"reads / writes"| node_users
node_adminroutes -->|"dispatches"| node_admincontroller
node_adminroutes -->|"protects"| node_authmiddleware
node_admincontroller -->|"reads"| node_users
node_enrollroutes -->|"dispatches"| node_enrollcontroller
node_enrollroutes -->|"protects"| node_authmiddleware
node_enrollcontroller -->|"uses"| node_enrollments
node_reviewroutes -->|"dispatches"| node_reviewcontroller
node_reviewroutes -->|"protects approval"| node_authmiddleware
node_reviewcontroller -->|"reads / writes"| node_reviews
node_authmiddleware -->|"loads user"| node_users
node_users -->|"persists in"| node_mongodb
node_enrollments -->|"persists in"| node_mongodb
node_reviews -->|"persists in"| node_mongodb
node_expressapp -->|"registers middleware"| node_metricsmodule
node_prometheus -->|"scrapes metrics"| node_expressapp

click node_reactapp "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/App.jsx"
click node_academyhome "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/Home.jsx"
click node_coursecontent "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/components/Curriculum.jsx"
click node_pricing "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/components/Pricing.jsx"
click node_reviewsui "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/components/Reviews.jsx"
click node_authui "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/context/AuthContext.jsx"
click node_studentdash "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/student/Dashboard.jsx"
click node_admindash "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/admin/Dashboard.jsx"
click node_instructordash "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/instructor/Dashboard.jsx"
click node_httpclient "https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/api/axios.js"
click node_expressapp "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/app.js"
click node_authroutes "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/authRoutes.js"
click node_authcontroller "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/authController.js"
click node_adminroutes "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/adminRoutes.js"
click node_admincontroller "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/adminController.js"
click node_enrollroutes "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/enrollRoutes.js"
click node_enrollcontroller "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/enrollController.js"
click node_reviewroutes "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/reviewRoutes.js"
click node_reviewcontroller "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/reviewController.js"
click node_authmiddleware "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/middleware/authMiddleware.js"
click node_users "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/models/User.js"
click node_enrollments "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/models/Enrollment.js"
click node_reviews "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/models/Review.js"
click node_metricsmodule "https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/metrics.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_reactapp,node_academyhome,node_coursecontent,node_pricing,node_reviewsui,node_authui,node_studentdash,node_admindash,node_instructordash,node_httpclient toneBlue
class node_expressapp,node_authroutes,node_authcontroller,node_adminroutes,node_admincontroller,node_enrollroutes,node_reviewroutes,node_authmiddleware toneAmber
class node_enrollcontroller,node_reviewcontroller,node_users,node_enrollments,node_reviews,node_mongodb toneMint
class node_metricsmodule,node_prometheus toneRose
class node_visitor,node_adminactor toneIndigo
```

## Components

### Web client

- [React application](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Academy home](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Course information](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/components/Curriculum.jsx): `frontend/src/components/Curriculum.jsx`
- [Enrollment offer](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/components/Pricing.jsx): `frontend/src/components/Pricing.jsx`
- [Review experience](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/components/Reviews.jsx): `frontend/src/components/Reviews.jsx`
- [Login and registration](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Student dashboard](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/student/Dashboard.jsx): `frontend/src/pages/student/Dashboard.jsx`
- [Admin dashboard](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/admin/Dashboard.jsx): `frontend/src/pages/admin/Dashboard.jsx`
- [Instructor dashboard](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/pages/instructor/Dashboard.jsx): `frontend/src/pages/instructor/Dashboard.jsx`
- [HTTP client](https://github.com/sadiq-code-nest/devops-academy/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### API and access

- [Express API](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/app.js): `backend/app.js`
- [Authentication routes](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Student authentication](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Admin routes](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Admin operations](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`
- [Enrollment routes](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/enrollRoutes.js): `backend/routes/enrollRoutes.js`
- [Review routes](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/routes/reviewRoutes.js): `backend/routes/reviewRoutes.js`
- [JWT access control](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`

### Enrollment domain

- [Enrollment operations](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/enrollController.js): `backend/controllers/enrollController.js`
- [Review moderation](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/controllers/reviewController.js): `backend/controllers/reviewController.js`
- [User records](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/models/User.js): `backend/models/User.js`
- [Enrollment records](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/models/Enrollment.js): `backend/models/Enrollment.js`
- [Review records](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/models/Review.js): `backend/models/Review.js`
- **MongoDB**

### App metrics

- [Request metrics](https://github.com/sadiq-code-nest/devops-academy/blob/main/backend/metrics.js): `backend/metrics.js`
- **Prometheus**

### Other components

- **Visitor / student**
- **Administrator**

## Connections

- Visitor / student → React application: uses (evidence: `README.md`)
- Administrator → React application: uses (evidence: `README.md`)
- React application → Academy home: routes to (evidence: `frontend/src/App.jsx`)
- React application → Login and registration: provides auth (evidence: `frontend/src/App.jsx`)
- React application → Student dashboard: routes to (evidence: `frontend/src/App.jsx`)
- React application → Admin dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Academy home → Course information: renders (evidence: `frontend/src/pages/Home.jsx`)
- Academy home → Enrollment offer: renders (evidence: `frontend/src/pages/Home.jsx`)
- Academy home → Review experience: renders (evidence: `frontend/src/pages/Home.jsx`)
- Login and registration → HTTP client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Enrollment offer → HTTP client: calls (evidence: `frontend/src/components/Pricing.jsx`)
- Review experience → HTTP client: calls (evidence: `frontend/src/components/Reviews.jsx`)
- Student dashboard → HTTP client: calls (evidence: `frontend/src/pages/student/Dashboard.jsx`)
- Admin dashboard → HTTP client: calls (evidence: `frontend/src/pages/admin/Dashboard.jsx`)
- Instructor dashboard → HTTP client: calls (evidence: `frontend/src/pages/instructor/Dashboard.jsx`)
- HTTP client → Express API: REST requests (evidence: `README.md`)
- Express API → Authentication routes: mounts (evidence: `backend/app.js`)
- Express API → Enrollment routes: mounts (evidence: `backend/app.js`)
- Express API → Review routes: mounts (evidence: `backend/app.js`)
- Express API → Admin routes: mounts (evidence: `backend/app.js`)
- Authentication routes → Student authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- Student authentication → User records: reads / writes (evidence: `backend/controllers/authController.js`)
- Admin routes → Admin operations: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → JWT access control: protects (evidence: `backend/routes/adminRoutes.js`)
- Admin operations → User records: reads (evidence: `backend/controllers/adminController.js`)
- Enrollment routes → Enrollment operations: dispatches (evidence: `backend/routes/enrollRoutes.js`)
- Enrollment routes → JWT access control: protects (evidence: `backend/routes/enrollRoutes.js`)
- Enrollment operations → Enrollment records: uses (evidence: `backend/controllers/enrollController.js`)
- Review routes → Review moderation: dispatches (evidence: `backend/routes/reviewRoutes.js`)
- Review routes → JWT access control: protects approval (evidence: `backend/routes/reviewRoutes.js`)
- Review moderation → Review records: reads / writes (evidence: `backend/controllers/reviewController.js`)
- JWT access control → User records: loads user (evidence: `backend/middleware/authMiddleware.js`)
- User records → MongoDB: persists in (evidence: `README.md`)
- Enrollment records → MongoDB: persists in (evidence: `README.md`)
- Review records → MongoDB: persists in (evidence: `README.md`)
- Express API → Request metrics: registers middleware (evidence: `backend/app.js`)
- Prometheus → Express API: scrapes metrics (evidence: `README.md`)
