# tejucodes/wds_lab architecture

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

- Interactive diagram: https://gitdiagram.com/tejucodes/wds_lab
- Repository: https://github.com/tejucodes/wds_lab

## Overview

Web Vulnerability Learning Environment teaches OWASP through two tracks: an edition-by-edition history with lessons and server-graded activities, and a 24-module practical catalogue with local labs and puzzles. Learners can also follow security news and track progress. The frontend routes learners to pages; the API serves history, activity and progress data from MongoDB and the news service fetches allowlisted feeds. The module lessons are bundled in the frontend and loaded by family. Some page-to-API and unsampled subsystem connections are omitted where the excerpts do not establish them.

Main entry points: [`frontend/src/App.jsx`](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/App.jsx) (Route shell), [`frontend/src/pages/ModulePage.jsx`](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/ModulePage.jsx) (Module lesson), [`backend/src/app.js`](https://github.com/tejucodes/wds_lab/blob/main/backend/src/app.js) (Express app), [`backend/src/models/Vulnerability.js`](https://github.com/tejucodes/wds_lab/blob/main/backend/src/models/Vulnerability.js) (Category records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Learner app"]
  node_app["Route shell<br/>[App.jsx]"]
  node_home["Home dashboard<br/>[HomePage.jsx]"]
  node_api_client["API client<br/>[client.js]"]
end

subgraph group_modules["Module track"]
  node_modules_page["Module catalogue<br/>[ModulesPage.jsx]"]
  node_module_page["Module lesson<br/>[ModulePage.jsx]"]
  node_module_content["Module content"]
  node_module_puzzle["Interactive puzzle<br/>[Puzzle.jsx]"]
  node_module_diagram["Attack diagram<br/>[AttackDiagram.jsx]"]
  node_history_strip["Evolution strip<br/>[HistoryStrip.jsx]"]
end

subgraph group_api["API runtime"]
  node_api_app["Express app<br/>[app.js]"]
  node_mongo[("MongoDB")]
end

subgraph group_history["OWASP history"]
  node_history_page["History pages"]
  node_lesson_page["Category lesson"]
  node_owasp_api["OWASP API calls<br/>[owaspApi.js]"]
  node_owasp_routes["OWASP routes<br/>[owaspRoutes.js]"]
  node_vuln_routes["Vulnerability routes"]
  node_release_controller["Release queries"]
  node_vuln_controller["Lesson and quiz logic"]
  node_release_model["Release records<br/>[OwaspRelease.js]"]
  node_vulnerability_model["Category records<br/>[Vulnerability.js]"]
end

subgraph group_learning["Learning state"]
  node_progress_routes["Progress routes<br/>[progressRoutes.js]"]
  node_progress_controller["Progress logic"]
  node_progress_model["Learner records<br/>[Progress.js]"]
end

subgraph group_news["Security news"]
  node_news_page["News page<br/>[NewsPage.jsx]"]
  node_news_api["News API calls<br/>[newsApi.js]"]
  node_news_routes["News routes<br/>[newsRoutes.js]"]
  node_news_controller["News endpoint<br/>[newsController.js]"]
  node_news_service["Feed service<br/>[newsService.js]"]
  node_news_sources["Feed allowlist<br/>[newsSources.js]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_history_page
node_app -->|"routes to"| node_lesson_page
node_app -->|"routes to"| node_modules_page
node_app -->|"routes to"| node_module_page
node_app -->|"routes to"| node_news_page
node_modules_page -->|"reads catalogue"| node_module_content
node_module_page -->|"loads family"| node_module_content
node_module_page -->|"renders"| node_module_puzzle
node_module_page -->|"renders"| node_module_diagram
node_module_page -->|"renders"| node_history_strip
node_home -->|"requests"| node_owasp_api
node_news_page -->|"requests"| node_news_api
node_owasp_api -->|"uses"| node_api_client
node_news_api -->|"uses"| node_api_client
node_api_app -->|"mounts"| node_owasp_routes
node_api_app -->|"mounts"| node_vuln_routes
node_api_app -->|"mounts"| node_progress_routes
node_api_app -->|"mounts"| node_news_routes
node_owasp_routes -->|"dispatches"| node_release_controller
node_vuln_routes -->|"dispatches"| node_vuln_controller
node_progress_routes -->|"dispatches"| node_progress_controller
node_news_routes -->|"dispatches"| node_news_controller
node_release_controller -->|"queries"| node_release_model
node_release_controller -->|"queries"| node_vulnerability_model
node_vuln_controller -->|"queries"| node_vulnerability_model
node_vuln_controller -->|"records quiz"| node_progress_model
node_progress_controller -->|"reads and writes"| node_progress_model
node_progress_controller -->|"checks categories"| node_vulnerability_model
node_news_controller -->|"requests feeds"| node_news_service
node_news_service -->|"reads allowlist"| node_news_sources
node_release_model -.->|"persists"| node_mongo
node_vulnerability_model -.->|"persists"| node_mongo
node_progress_model -.->|"persists"| node_mongo

click node_app "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/HomePage.jsx"
click node_history_page "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/OwaspHistoryPage.jsx"
click node_lesson_page "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/VulnerabilityDetailPage.jsx"
click node_modules_page "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/ModulesPage.jsx"
click node_module_page "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/ModulePage.jsx"
click node_module_content "https://github.com/tejucodes/wds_lab/tree/main/frontend/src/data/modules"
click node_module_puzzle "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/components/module/Puzzle.jsx"
click node_module_diagram "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/components/module/AttackDiagram.jsx"
click node_history_strip "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/components/module/HistoryStrip.jsx"
click node_news_page "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/NewsPage.jsx"
click node_api_client "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/api/client.js"
click node_owasp_api "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/api/owaspApi.js"
click node_news_api "https://github.com/tejucodes/wds_lab/blob/main/frontend/src/api/newsApi.js"
click node_api_app "https://github.com/tejucodes/wds_lab/blob/main/backend/src/app.js"
click node_owasp_routes "https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/owaspRoutes.js"
click node_vuln_routes "https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/vulnerabilityRoutes.js"
click node_progress_routes "https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/progressRoutes.js"
click node_news_routes "https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/newsRoutes.js"
click node_release_controller "https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/owaspReleaseController.js"
click node_vuln_controller "https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/vulnerabilityController.js"
click node_progress_controller "https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/progressController.js"
click node_news_controller "https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/newsController.js"
click node_news_service "https://github.com/tejucodes/wds_lab/blob/main/backend/src/services/newsService.js"
click node_news_sources "https://github.com/tejucodes/wds_lab/blob/main/backend/src/data/newsSources.js"
click node_release_model "https://github.com/tejucodes/wds_lab/blob/main/backend/src/models/OwaspRelease.js"
click node_vulnerability_model "https://github.com/tejucodes/wds_lab/blob/main/backend/src/models/Vulnerability.js"
click node_progress_model "https://github.com/tejucodes/wds_lab/blob/main/backend/src/models/Progress.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_app,node_home,node_api_client toneBlue
class node_modules_page,node_module_page,node_module_content,node_module_puzzle,node_module_diagram,node_history_strip toneAmber
class node_api_app,node_mongo toneMint
class node_history_page,node_lesson_page,node_owasp_api,node_owasp_routes,node_vuln_routes,node_release_controller,node_vuln_controller,node_release_model,node_vulnerability_model toneRose
class node_progress_routes,node_progress_controller,node_progress_model,node_learner toneIndigo
class node_news_page,node_news_api,node_news_routes,node_news_controller,node_news_service,node_news_sources toneTeal
```

## Components

### Learner app

- [Route shell](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home dashboard](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [API client](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Module track

- [Module catalogue](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/ModulesPage.jsx): `frontend/src/pages/ModulesPage.jsx`
- [Module lesson](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/ModulePage.jsx): `frontend/src/pages/ModulePage.jsx`
- [Module content](https://github.com/tejucodes/wds_lab/tree/main/frontend/src/data/modules): `frontend/src/data/modules`
- [Interactive puzzle](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/components/module/Puzzle.jsx): `frontend/src/components/module/Puzzle.jsx`
- [Attack diagram](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/components/module/AttackDiagram.jsx): `frontend/src/components/module/AttackDiagram.jsx`
- [Evolution strip](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/components/module/HistoryStrip.jsx): `frontend/src/components/module/HistoryStrip.jsx`

### API runtime

- [Express app](https://github.com/tejucodes/wds_lab/blob/main/backend/src/app.js): `backend/src/app.js`
- **MongoDB**

### OWASP history

- [History pages](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/OwaspHistoryPage.jsx): `frontend/src/pages/OwaspHistoryPage.jsx`
- [Category lesson](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/VulnerabilityDetailPage.jsx): `frontend/src/pages/VulnerabilityDetailPage.jsx`
- [OWASP API calls](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/api/owaspApi.js): `frontend/src/api/owaspApi.js`
- [OWASP routes](https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/owaspRoutes.js): `backend/src/routes/owaspRoutes.js`
- [Vulnerability routes](https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/vulnerabilityRoutes.js): `backend/src/routes/vulnerabilityRoutes.js`
- [Release queries](https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/owaspReleaseController.js): `backend/src/controllers/owaspReleaseController.js`
- [Lesson and quiz logic](https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/vulnerabilityController.js): `backend/src/controllers/vulnerabilityController.js`
- [Release records](https://github.com/tejucodes/wds_lab/blob/main/backend/src/models/OwaspRelease.js): `backend/src/models/OwaspRelease.js`
- [Category records](https://github.com/tejucodes/wds_lab/blob/main/backend/src/models/Vulnerability.js): `backend/src/models/Vulnerability.js`

### Learning state

- [Progress routes](https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/progressRoutes.js): `backend/src/routes/progressRoutes.js`
- [Progress logic](https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/progressController.js): `backend/src/controllers/progressController.js`
- [Learner records](https://github.com/tejucodes/wds_lab/blob/main/backend/src/models/Progress.js): `backend/src/models/Progress.js`

### Security news

- [News page](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/pages/NewsPage.jsx): `frontend/src/pages/NewsPage.jsx`
- [News API calls](https://github.com/tejucodes/wds_lab/blob/main/frontend/src/api/newsApi.js): `frontend/src/api/newsApi.js`
- [News routes](https://github.com/tejucodes/wds_lab/blob/main/backend/src/routes/newsRoutes.js): `backend/src/routes/newsRoutes.js`
- [News endpoint](https://github.com/tejucodes/wds_lab/blob/main/backend/src/controllers/newsController.js): `backend/src/controllers/newsController.js`
- [Feed service](https://github.com/tejucodes/wds_lab/blob/main/backend/src/services/newsService.js): `backend/src/services/newsService.js`
- [Feed allowlist](https://github.com/tejucodes/wds_lab/blob/main/backend/src/data/newsSources.js): `backend/src/data/newsSources.js`

### Other components

- **Learner**

## Connections

- Learner → Route shell: uses (evidence: `frontend/src/App.jsx`)
- Route shell → Home dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → History pages: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Category lesson: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Module catalogue: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → Module lesson: routes to (evidence: `frontend/src/App.jsx`)
- Route shell → News page: routes to (evidence: `frontend/src/App.jsx`)
- Module catalogue → Module content: reads catalogue (evidence: `frontend/src/pages/ModulesPage.jsx`)
- Module lesson → Module content: loads family (evidence: `frontend/src/pages/ModulePage.jsx`)
- Module lesson → Interactive puzzle: renders (evidence: `frontend/src/pages/ModulePage.jsx`)
- Module lesson → Attack diagram: renders (evidence: `frontend/src/pages/ModulePage.jsx`)
- Module lesson → Evolution strip: renders (evidence: `frontend/src/pages/ModulePage.jsx`)
- Home dashboard → OWASP API calls: requests (evidence: `frontend/src/pages/HomePage.jsx`)
- News page → News API calls: requests (evidence: `frontend/src/pages/NewsPage.jsx`)
- OWASP API calls → API client: uses (evidence: `frontend/src/api/owaspApi.js`)
- News API calls → API client: uses (evidence: `frontend/src/api/newsApi.js`)
- Express app → OWASP routes: mounts (evidence: `backend/src/app.js`)
- Express app → Vulnerability routes: mounts (evidence: `backend/src/app.js`)
- Express app → Progress routes: mounts (evidence: `backend/src/app.js`)
- Express app → News routes: mounts (evidence: `backend/src/app.js`)
- OWASP routes → Release queries: dispatches (evidence: `backend/src/routes/owaspRoutes.js`)
- Vulnerability routes → Lesson and quiz logic: dispatches (evidence: `backend/src/routes/vulnerabilityRoutes.js`)
- Progress routes → Progress logic: dispatches (evidence: `backend/src/routes/progressRoutes.js`)
- News routes → News endpoint: dispatches (evidence: `backend/src/routes/newsRoutes.js`)
- Release queries → Release records: queries (evidence: `backend/src/controllers/owaspReleaseController.js`)
- Release queries → Category records: queries (evidence: `backend/src/controllers/owaspReleaseController.js`)
- Lesson and quiz logic → Category records: queries (evidence: `backend/src/controllers/vulnerabilityController.js`)
- Lesson and quiz logic → Learner records: records quiz (evidence: `backend/src/controllers/vulnerabilityController.js`)
- Progress logic → Learner records: reads and writes (evidence: `backend/src/controllers/progressController.js`)
- Progress logic → Category records: checks categories (evidence: `backend/src/controllers/progressController.js`)
- News endpoint → Feed service: requests feeds (evidence: `backend/src/controllers/newsController.js`)
- Feed service → Feed allowlist: reads allowlist (evidence: `backend/src/services/newsService.js`)
- Release records → MongoDB: persists
- Category records → MongoDB: persists
- Learner records → MongoDB: persists
