# liyander/minerva architecture

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

- Interactive diagram: https://gitdiagram.com/liyander/minerva
- Repository: https://github.com/liyander/minerva

## Overview

Incognitrix Academy is a role-based learning platform with trainee, trainer, administrator, and developer experiences. The principal workflow is discovering learning content, enrolling, completing course or assessment activities, and tracking progress; trainers create and grade learning activities, while administrators manage platform configuration and users. The React application communicates with an Express API backed by MySQL. The graph includes documented backend domains and AI-assisted features; some frontend-to-backend connections are shown as unverified because the excerpts do not expose their complete wiring.

Main entry points: [`src/services/api.js`](https://github.com/liyander/minerva/blob/main/src/services/api.js) (API client), [`src/pages/CoursePage.jsx`](https://github.com/liyander/minerva/blob/main/src/pages/CoursePage.jsx) (Course experience), [`backend/src/routes/rooms.routes.js`](https://github.com/liyander/minerva/blob/main/backend/src/routes/rooms.routes.js) (Course and room API), [`backend/src/routes/adminAi.routes.js`](https://github.com/liyander/minerva/blob/main/backend/src/routes/adminAi.routes.js) (Admin AI tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web_app["React application<br/>[App.jsx]"]
end

subgraph group_learning["Learning and assessment"]
  node_course_page["Course experience<br/>[CoursePage.jsx]"]
  node_course_content["Course content data<br/>[coursesData.js]"]
  node_enrollment["Course enrollment"]
  node_trainer_workspace["Trainer workspace"]
  node_playlist_manager["Course playlists"]
  node_assessment_domain["Assessments and assignments"]
  node_training_api["Training services<br/>[training.js]"]
end

subgraph group_community["Community and careers"]
  node_community_page["Community experience<br/>[CommunityPage.jsx]"]
  node_community_api["Community services<br/>[community.js]"]
  node_career_domain["Careers and opportunities"]
end

subgraph group_backend["API and identity"]
  node_api_client["API client<br/>[api.js]"]
  node_api_server["Express API<br/>[app.js]"]
  node_identity["Authentication and roles<br/>[auth.js]"]
  node_room_api["Course and room API<br/>[rooms.routes.js]"]
  node_admin_ai["Admin AI tools<br/>[adminAi.routes.js]"]
  node_public_api["Public API"]
end

subgraph group_data_ai["Data and AI"]
  node_database[("MySQL database<br/>[pool.js]")]
  node_ai_settings["AI configuration<br/>[aiSettings.js]"]
  node_ai_prompts["AI prompts<br/>[aiPrompts.js]"]
  node_lab_research["AI lab research"]
  node_code_executor["Code execution<br/>[codeExecutor.js]"]
end

node_learner(("Learner"))
node_trainer(("Trainer"))
node_administrator(("Administrator"))

node_learner -.->|"uses"| node_web_app
node_trainer -.->|"uses"| node_web_app
node_administrator -.->|"uses"| node_web_app
node_web_app -->|"routes to"| node_course_page
node_course_page -->|"loads"| node_course_content
node_course_page -->|"renders"| node_enrollment
node_course_page -->|"requests data"| node_api_client
node_course_content -->|"syncs changes"| node_api_client
node_trainer_workspace -->|"uses"| node_training_api
node_trainer_workspace -->|"renders"| node_playlist_manager
node_playlist_manager -->|"requests playlist"| node_api_client
node_api_client -.->|"sends HTTP requests"| node_api_server
node_api_server -->|"mounts"| node_room_api
node_api_server -->|"mounts"| node_admin_ai
node_room_api -->|"loads configuration"| node_ai_settings
node_room_api -->|"uses prompts"| node_ai_prompts
node_admin_ai -->|"loads configuration"| node_ai_settings
node_admin_ai -->|"uses prompts"| node_ai_prompts
node_lab_research -->|"loads configuration"| node_ai_settings
node_lab_research -->|"executes submissions"| node_code_executor
node_identity -->|"checks accounts"| node_database
node_room_api -->|"reads and writes"| node_database
node_admin_ai -->|"queries data"| node_database
node_public_api -->|"queries data"| node_database
node_community_page -.->|"uses"| node_community_api
node_community_api -->|"delegates requests"| node_api_client

click node_web_app "https://github.com/liyander/minerva/blob/main/src/App.jsx"
click node_course_page "https://github.com/liyander/minerva/blob/main/src/pages/CoursePage.jsx"
click node_course_content "https://github.com/liyander/minerva/blob/main/src/data/coursesData.js"
click node_enrollment "https://github.com/liyander/minerva/blob/main/src/components/CourseEnrollmentPanel.jsx"
click node_trainer_workspace "https://github.com/liyander/minerva/blob/main/src/pages/trainer/TrainerWorkspacePage.jsx"
click node_playlist_manager "https://github.com/liyander/minerva/blob/main/src/components/CoursePlaylistManager.jsx"
click node_assessment_domain "https://github.com/liyander/minerva/tree/main/backend/src/routes"
click node_training_api "https://github.com/liyander/minerva/blob/main/src/services/training.js"
click node_community_page "https://github.com/liyander/minerva/blob/main/src/pages/CommunityPage.jsx"
click node_community_api "https://github.com/liyander/minerva/blob/main/src/services/community.js"
click node_career_domain "https://github.com/liyander/minerva/tree/main/backend/src/routes"
click node_api_client "https://github.com/liyander/minerva/blob/main/src/services/api.js"
click node_api_server "https://github.com/liyander/minerva/blob/main/backend/src/app.js"
click node_identity "https://github.com/liyander/minerva/blob/main/backend/src/middleware/auth.js"
click node_room_api "https://github.com/liyander/minerva/blob/main/backend/src/routes/rooms.routes.js"
click node_admin_ai "https://github.com/liyander/minerva/blob/main/backend/src/routes/adminAi.routes.js"
click node_database "https://github.com/liyander/minerva/blob/main/backend/src/db/pool.js"
click node_ai_settings "https://github.com/liyander/minerva/blob/main/backend/src/services/aiSettings.js"
click node_ai_prompts "https://github.com/liyander/minerva/blob/main/backend/src/services/aiPrompts.js"
click node_lab_research "https://github.com/liyander/minerva/blob/main/backend/src/routes/labResearch.routes.js"
click node_code_executor "https://github.com/liyander/minerva/blob/main/backend/src/services/codeExecutor.js"
click node_public_api "https://github.com/liyander/minerva/blob/main/backend/src/api/publicApi.routes.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_web_app toneBlue
class node_course_page,node_course_content,node_enrollment,node_trainer_workspace,node_playlist_manager,node_assessment_domain,node_training_api toneAmber
class node_community_page,node_community_api,node_career_domain toneMint
class node_api_client,node_api_server,node_identity,node_room_api,node_admin_ai,node_public_api toneRose
class node_database,node_ai_settings,node_ai_prompts,node_lab_research,node_code_executor,node_learner,node_trainer,node_administrator toneIndigo
```

## Components

### Web application

- [React application](https://github.com/liyander/minerva/blob/main/src/App.jsx): `src/App.jsx`

### Learning and assessment

- [Course experience](https://github.com/liyander/minerva/blob/main/src/pages/CoursePage.jsx): `src/pages/CoursePage.jsx`
- [Course content data](https://github.com/liyander/minerva/blob/main/src/data/coursesData.js): `src/data/coursesData.js`
- [Course enrollment](https://github.com/liyander/minerva/blob/main/src/components/CourseEnrollmentPanel.jsx): `src/components/CourseEnrollmentPanel.jsx`
- [Trainer workspace](https://github.com/liyander/minerva/blob/main/src/pages/trainer/TrainerWorkspacePage.jsx): `src/pages/trainer/TrainerWorkspacePage.jsx`
- [Course playlists](https://github.com/liyander/minerva/blob/main/src/components/CoursePlaylistManager.jsx): `src/components/CoursePlaylistManager.jsx`
- [Assessments and assignments](https://github.com/liyander/minerva/tree/main/backend/src/routes): `backend/src/routes`
- [Training services](https://github.com/liyander/minerva/blob/main/src/services/training.js): `src/services/training.js`

### Community and careers

- [Community experience](https://github.com/liyander/minerva/blob/main/src/pages/CommunityPage.jsx): `src/pages/CommunityPage.jsx`
- [Community services](https://github.com/liyander/minerva/blob/main/src/services/community.js): `src/services/community.js`
- [Careers and opportunities](https://github.com/liyander/minerva/tree/main/backend/src/routes): `backend/src/routes`

### API and identity

- [API client](https://github.com/liyander/minerva/blob/main/src/services/api.js): `src/services/api.js`
- [Express API](https://github.com/liyander/minerva/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication and roles](https://github.com/liyander/minerva/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Course and room API](https://github.com/liyander/minerva/blob/main/backend/src/routes/rooms.routes.js): `backend/src/routes/rooms.routes.js`
- [Admin AI tools](https://github.com/liyander/minerva/blob/main/backend/src/routes/adminAi.routes.js): `backend/src/routes/adminAi.routes.js`
- [Public API](https://github.com/liyander/minerva/blob/main/backend/src/api/publicApi.routes.js): `backend/src/api/publicApi.routes.js`

### Data and AI

- [MySQL database](https://github.com/liyander/minerva/blob/main/backend/src/db/pool.js): `backend/src/db/pool.js`
- [AI configuration](https://github.com/liyander/minerva/blob/main/backend/src/services/aiSettings.js): `backend/src/services/aiSettings.js`
- [AI prompts](https://github.com/liyander/minerva/blob/main/backend/src/services/aiPrompts.js): `backend/src/services/aiPrompts.js`
- [AI lab research](https://github.com/liyander/minerva/blob/main/backend/src/routes/labResearch.routes.js): `backend/src/routes/labResearch.routes.js`
- [Code execution](https://github.com/liyander/minerva/blob/main/backend/src/services/codeExecutor.js): `backend/src/services/codeExecutor.js`

### Other components

- **Learner**
- **Trainer**
- **Administrator**

## Connections

- Learner → React application: uses
- Trainer → React application: uses
- Administrator → React application: uses
- React application → Course experience: routes to (evidence: `src/App.jsx`)
- Course experience → Course content data: loads (evidence: `src/pages/CoursePage.jsx`)
- Course experience → Course enrollment: renders (evidence: `src/pages/CoursePage.jsx`)
- Course experience → API client: requests data (evidence: `src/pages/CoursePage.jsx`)
- Course content data → API client: syncs changes (evidence: `src/data/coursesData.js`)
- Trainer workspace → Training services: uses (evidence: `src/pages/trainer/TrainerWorkspacePage.jsx`)
- Trainer workspace → Course playlists: renders (evidence: `src/pages/trainer/TrainerWorkspacePage.jsx`)
- Course playlists → API client: requests playlist (evidence: `src/components/CoursePlaylistManager.jsx`)
- API client → Express API: sends HTTP requests
- Express API → Course and room API: mounts (evidence: `backend/src/app.js`)
- Express API → Admin AI tools: mounts (evidence: `backend/src/app.js`)
- Course and room API → AI configuration: loads configuration (evidence: `backend/src/routes/rooms.routes.js`)
- Course and room API → AI prompts: uses prompts (evidence: `backend/src/routes/rooms.routes.js`)
- Admin AI tools → AI configuration: loads configuration (evidence: `backend/src/routes/adminAi.routes.js`)
- Admin AI tools → AI prompts: uses prompts (evidence: `backend/src/routes/adminAi.routes.js`)
- AI lab research → AI configuration: loads configuration (evidence: `backend/src/routes/labResearch.routes.js`)
- AI lab research → Code execution: executes submissions (evidence: `backend/src/routes/labResearch.routes.js`)
- Authentication and roles → MySQL database: checks accounts (evidence: `backend/src/middleware/auth.js`)
- Course and room API → MySQL database: reads and writes (evidence: `backend/src/routes/rooms.routes.js`)
- Admin AI tools → MySQL database: queries data (evidence: `backend/src/routes/adminAi.routes.js`)
- Public API → MySQL database: queries data (evidence: `backend/src/api/publicApi.routes.js`)
- Community experience → Community services: uses
- Community services → API client: delegates requests (evidence: `src/services/community.js`)
