How tejucodes/wds_lab works
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: App.jsx Route shell · ModulePage.jsx Module lesson · app.js Express app · Vulnerability.js Category records
Components 30
Learner app
- Route shell
frontend/src/App.jsx - Home dashboard
frontend/src/pages/HomePage.jsx - API client
frontend/src/api/client.js
Module track
- Module catalogue
frontend/src/pages/ModulesPage.jsx - Module lesson
frontend/src/pages/ModulePage.jsx - Module content
frontend/src/data/modules - Interactive puzzle
frontend/src/components/module/Puzzle.jsx - Attack diagram
frontend/src/components/module/AttackDiagram.jsx - Evolution strip
frontend/src/components/module/HistoryStrip.jsx
API runtime
- Express app
backend/src/app.js - MongoDB
OWASP history
- History pages
frontend/src/pages/OwaspHistoryPage.jsx - Category lesson
frontend/src/pages/VulnerabilityDetailPage.jsx - OWASP API calls
frontend/src/api/owaspApi.js - OWASP routes
backend/src/routes/owaspRoutes.js - Vulnerability routes
backend/src/routes/vulnerabilityRoutes.js - Release queries
backend/src/controllers/owaspReleaseController.js - Lesson and quiz logic
backend/src/controllers/vulnerabilityController.js - Release records
backend/src/models/OwaspRelease.js - Category records
backend/src/models/Vulnerability.js
Learning state
- Progress routes
backend/src/routes/progressRoutes.js - Progress logic
backend/src/controllers/progressController.js - Learner records
backend/src/models/Progress.js
Security news
- News page
frontend/src/pages/NewsPage.jsx - News API calls
frontend/src/api/newsApi.js - News routes
backend/src/routes/newsRoutes.js - News endpoint
backend/src/controllers/newsController.js - Feed service
backend/src/services/newsService.js - Feed allowlist
backend/src/data/newsSources.js
Other components
- Learner
Connections 35
- Learner → Route shell: uses
frontend/src/App.jsx - Route shell → Home dashboard: routes to
frontend/src/App.jsx - Route shell → History pages: routes to
frontend/src/App.jsx - Route shell → Category lesson: routes to
frontend/src/App.jsx - Route shell → Module catalogue: routes to
frontend/src/App.jsx - Route shell → Module lesson: routes to
frontend/src/App.jsx - Route shell → News page: routes to
frontend/src/App.jsx - Module catalogue → Module content: reads catalogue
frontend/src/pages/ModulesPage.jsx - Module lesson → Module content: loads family
frontend/src/pages/ModulePage.jsx - Module lesson → Interactive puzzle: renders
frontend/src/pages/ModulePage.jsx - Module lesson → Attack diagram: renders
frontend/src/pages/ModulePage.jsx - Module lesson → Evolution strip: renders
frontend/src/pages/ModulePage.jsx - Home dashboard → OWASP API calls: requests
frontend/src/pages/HomePage.jsx - News page → News API calls: requests
frontend/src/pages/NewsPage.jsx - OWASP API calls → API client: uses
frontend/src/api/owaspApi.js - News API calls → API client: uses
frontend/src/api/newsApi.js - Express app → OWASP routes: mounts
backend/src/app.js - Express app → Vulnerability routes: mounts
backend/src/app.js - Express app → Progress routes: mounts
backend/src/app.js - Express app → News routes: mounts
backend/src/app.js - OWASP routes → Release queries: dispatches
backend/src/routes/owaspRoutes.js - Vulnerability routes → Lesson and quiz logic: dispatches
backend/src/routes/vulnerabilityRoutes.js - Progress routes → Progress logic: dispatches
backend/src/routes/progressRoutes.js - News routes → News endpoint: dispatches
backend/src/routes/newsRoutes.js - Release queries → Release records: queries
backend/src/controllers/owaspReleaseController.js - Release queries → Category records: queries
backend/src/controllers/owaspReleaseController.js - Lesson and quiz logic → Category records: queries
backend/src/controllers/vulnerabilityController.js - Lesson and quiz logic → Learner records: records quiz
backend/src/controllers/vulnerabilityController.js - Progress logic → Learner records: reads and writes
backend/src/controllers/progressController.js - Progress logic → Category records: checks categories
backend/src/controllers/progressController.js - News endpoint → Feed service: requests feeds
backend/src/controllers/newsController.js - Feed service → Feed allowlist: reads allowlist
backend/src/services/newsService.js - Release records → MongoDB: persists
- Category records → MongoDB: persists
- Learner records → MongoDB: persists