# mohamed6seddiki/algo-nova architecture

> Architecture diagram of the GitHub repository mohamed6seddiki/algo-nova, 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/mohamed6seddiki/algo-nova
- Repository: https://github.com/mohamed6seddiki/algo-nova

## Overview

AlgoNova is an algorithm-learning platform: students browse lessons and exercises, practice MyAlgo programs, and review learning metrics; administrators manage learning content and users. The React app routes users into these experiences, while the ASP.NET API handles authentication and domain operations backed by Supabase. Code execution is a distinct path from the editor through the API to the MyAlgo compiler/runtime. The graph preserves these documented product branches; unsampled controller, frontend API, and service implementations limit some finer-grained links.

Main entry points: [`backend/Controllers`](https://github.com/mohamed6seddiki/algo-nova/tree/main/backend/Controllers) (API Controllers), [`frontend/src/App.tsx`](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/App.tsx) (Route App), [`myalgo-engine/src/main.cpp`](https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/main.cpp) (Engine CLI), [`frontend/src/pages/student/LessonsBrowser.tsx`](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/LessonsBrowser.tsx) (Lessons UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student and Admin App"]
  node_app["Route App<br/>[App.tsx]"]
  node_lessons_ui["Lessons UI<br/>[LessonsBrowser.tsx]"]
  node_lesson_detail_ui["Lesson Detail<br/>[LessonDetail.tsx]"]
  node_exercise_ui["Exercises UI<br/>[ExercisesPage.tsx]"]
  node_editor_ui["Code Workspace"]
  node_dashboard_ui["Student Dashboard<br/>[Dashboard.tsx]"]
  node_progress_ui["Progress and Rankings<br/>[Progress.tsx]"]
  node_assistant_ui["Study Assistant<br/>[AIAssistant.tsx]"]
  node_admin_ui["Admin Screens<br/>[ManageLessons.tsx]"]
  node_auth_ui["Auth Context<br/>[AuthContext.jsx]"]
end

subgraph group_api["Backend API"]
  node_controllers["API Controllers"]
  node_auth_service["Authentication<br/>[AuthService.cs]"]
  node_lesson_service["Lesson Services<br/>[LessonService.cs]"]
  node_exercise_service["Exercise Services<br/>[ExerciseService.cs]"]
  node_dashboard_service["Dashboard Metrics"]
  node_progress_service["Progress and Leaderboard<br/>[ProgressService.cs]"]
  node_admin_services["Admin Services"]
  node_execution_service["Code Execution"]
end

subgraph group_engine["MyAlgo Engine"]
  node_engine_main["Engine CLI<br/>[main.cpp]"]
  node_lexer["Lexer<br/>[lexer.cpp]"]
  node_parser["Parser<br/>[parser.cpp]"]
  node_semantic["Semantic Analysis"]
  node_codegen["Code Generation<br/>[CodeGenerator.hpp]"]
  node_generated_runtime["Generated Program Runtime<br/>[main.cpp]"]
end

subgraph group_external["External Services"]
  node_supabase[("Supabase Data and Auth")]
  node_ai_service["AI-Style Assistant"]
end

node_student(("Student"))
node_admin(("Administrator"))

node_student -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes"| node_lessons_ui
node_app -->|"routes"| node_lesson_detail_ui
node_app -->|"routes"| node_exercise_ui
node_app -->|"routes"| node_editor_ui
node_app -->|"routes"| node_dashboard_ui
node_app -->|"routes"| node_progress_ui
node_app -->|"routes"| node_assistant_ui
node_app -->|"routes"| node_admin_ui
node_app -->|"uses"| node_auth_ui
node_lessons_ui -.->|"requests lessons"| node_controllers
node_lesson_detail_ui -.->|"requests detail"| node_controllers
node_exercise_ui -.->|"requests exercises"| node_controllers
node_editor_ui -.->|"submits code"| node_controllers
node_dashboard_ui -.->|"requests metrics"| node_controllers
node_progress_ui -.->|"requests progress"| node_controllers
node_admin_ui -.->|"admin requests"| node_controllers
node_controllers -->|"delegates auth"| node_auth_service
node_controllers -->|"delegates lessons"| node_lesson_service
node_controllers -->|"delegates exercises"| node_exercise_service
node_controllers -.->|"delegates metrics"| node_dashboard_service
node_controllers -.->|"delegates progress"| node_progress_service
node_controllers -->|"delegates admin"| node_admin_services
node_controllers -.->|"delegates execution"| node_execution_service
node_auth_service -->|"auth and profiles"| node_supabase
node_lesson_service -.->|"reads lessons"| node_supabase
node_exercise_service -->|"reads and submits"| node_supabase
node_dashboard_service -->|"reads activity"| node_supabase
node_progress_service -.->|"reads progress"| node_supabase
node_admin_services -->|"manages content"| node_supabase
node_execution_service -->|"runs CLI"| node_engine_main
node_engine_main -->|"tokenizes"| node_lexer
node_engine_main -->|"parses"| node_parser
node_engine_main -->|"analyzes"| node_semantic
node_engine_main -->|"generates code"| node_codegen
node_engine_main -->|"compiles and runs"| node_generated_runtime
node_assistant_ui -.->|"assistant interaction"| node_ai_service

click node_app "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/App.tsx"
click node_lessons_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/LessonsBrowser.tsx"
click node_lesson_detail_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/LessonDetail.tsx"
click node_exercise_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/ExercisesPage.tsx"
click node_editor_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/CodeEditorWorkspace.tsx"
click node_dashboard_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/Dashboard.tsx"
click node_progress_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/Progress.tsx"
click node_assistant_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/AIAssistant.tsx"
click node_admin_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/admin/ManageLessons.tsx"
click node_auth_ui "https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/context/AuthContext.jsx"
click node_controllers "https://github.com/mohamed6seddiki/algo-nova/tree/main/backend/Controllers"
click node_auth_service "https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/AuthService.cs"
click node_lesson_service "https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/LessonService.cs"
click node_exercise_service "https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/ExerciseService.cs"
click node_dashboard_service "https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/StudentDashboardService.cs"
click node_progress_service "https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/ProgressService.cs"
click node_admin_services "https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/AdminLessonService.cs"
click node_execution_service "https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/CodeExecutionService.cs"
click node_engine_main "https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/main.cpp"
click node_lexer "https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/lexer/lexer.cpp"
click node_parser "https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/parser/parser.cpp"
click node_semantic "https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/semantic/SemanticAnalyzer.hpp"
click node_codegen "https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/codegen/CodeGenerator.hpp"
click node_generated_runtime "https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/main.cpp"

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_lessons_ui,node_lesson_detail_ui,node_exercise_ui,node_editor_ui,node_dashboard_ui,node_progress_ui,node_assistant_ui,node_admin_ui,node_auth_ui toneBlue
class node_controllers,node_auth_service,node_lesson_service,node_exercise_service,node_dashboard_service,node_progress_service,node_admin_services,node_execution_service toneAmber
class node_engine_main,node_lexer,node_parser,node_semantic,node_codegen,node_generated_runtime toneMint
class node_supabase,node_ai_service toneRose
class node_student,node_admin toneIndigo
```

## Components

### Student and Admin App

- [Route App](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Lessons UI](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/LessonsBrowser.tsx): `frontend/src/pages/student/LessonsBrowser.tsx`
- [Lesson Detail](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/LessonDetail.tsx): `frontend/src/pages/student/LessonDetail.tsx`
- [Exercises UI](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/ExercisesPage.tsx): `frontend/src/pages/student/ExercisesPage.tsx`
- [Code Workspace](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/CodeEditorWorkspace.tsx): `frontend/src/pages/student/CodeEditorWorkspace.tsx`
- [Student Dashboard](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/Dashboard.tsx): `frontend/src/pages/student/Dashboard.tsx`
- [Progress and Rankings](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/Progress.tsx): `frontend/src/pages/student/Progress.tsx`
- [Study Assistant](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/student/AIAssistant.tsx): `frontend/src/pages/student/AIAssistant.tsx`
- [Admin Screens](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/pages/admin/ManageLessons.tsx): `frontend/src/pages/admin/ManageLessons.tsx`
- [Auth Context](https://github.com/mohamed6seddiki/algo-nova/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`

### Backend API

- [API Controllers](https://github.com/mohamed6seddiki/algo-nova/tree/main/backend/Controllers): `backend/Controllers`
- [Authentication](https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/AuthService.cs): `backend/Services/AuthService.cs`
- [Lesson Services](https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/LessonService.cs): `backend/Services/LessonService.cs`
- [Exercise Services](https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/ExerciseService.cs): `backend/Services/ExerciseService.cs`
- [Dashboard Metrics](https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/StudentDashboardService.cs): `backend/Services/StudentDashboardService.cs`
- [Progress and Leaderboard](https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/ProgressService.cs): `backend/Services/ProgressService.cs`
- [Admin Services](https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/AdminLessonService.cs): `backend/Services/AdminLessonService.cs`
- [Code Execution](https://github.com/mohamed6seddiki/algo-nova/blob/main/backend/Services/CodeExecutionService.cs): `backend/Services/CodeExecutionService.cs`

### MyAlgo Engine

- [Engine CLI](https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/main.cpp): `myalgo-engine/src/main.cpp`
- [Lexer](https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/lexer/lexer.cpp): `myalgo-engine/src/lexer/lexer.cpp`
- [Parser](https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/parser/parser.cpp): `myalgo-engine/src/parser/parser.cpp`
- [Semantic Analysis](https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/semantic/SemanticAnalyzer.hpp): `myalgo-engine/src/semantic/SemanticAnalyzer.hpp`
- [Code Generation](https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/codegen/CodeGenerator.hpp): `myalgo-engine/src/codegen/CodeGenerator.hpp`
- [Generated Program Runtime](https://github.com/mohamed6seddiki/algo-nova/blob/main/myalgo-engine/src/main.cpp): `myalgo-engine/src/main.cpp`

### External Services

- **Supabase Data and Auth**
- **AI-Style Assistant**

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Route App: uses (evidence: `README.md`)
- Administrator → Route App: uses (evidence: `README.md`)
- Route App → Lessons UI: routes (evidence: `frontend/src/App.tsx`)
- Route App → Lesson Detail: routes (evidence: `frontend/src/App.tsx`)
- Route App → Exercises UI: routes (evidence: `frontend/src/App.tsx`)
- Route App → Code Workspace: routes (evidence: `frontend/src/App.tsx`)
- Route App → Student Dashboard: routes (evidence: `frontend/src/App.tsx`)
- Route App → Progress and Rankings: routes (evidence: `frontend/src/App.tsx`)
- Route App → Study Assistant: routes (evidence: `frontend/src/App.tsx`)
- Route App → Admin Screens: routes (evidence: `frontend/src/App.tsx`)
- Route App → Auth Context: uses (evidence: `frontend/src/App.tsx`)
- Lessons UI → API Controllers: requests lessons
- Lesson Detail → API Controllers: requests detail
- Exercises UI → API Controllers: requests exercises
- Code Workspace → API Controllers: submits code
- Student Dashboard → API Controllers: requests metrics
- Progress and Rankings → API Controllers: requests progress
- Admin Screens → API Controllers: admin requests
- API Controllers → Authentication: delegates auth (evidence: `backend/Controllers/AuthController.cs`)
- API Controllers → Lesson Services: delegates lessons
- API Controllers → Exercise Services: delegates exercises (evidence: `backend/Controllers/ExercisesController.cs`)
- API Controllers → Dashboard Metrics: delegates metrics
- API Controllers → Progress and Leaderboard: delegates progress
- API Controllers → Admin Services: delegates admin (evidence: `backend/Controllers/AdminLessonsController.cs`)
- API Controllers → Code Execution: delegates execution
- Authentication → Supabase Data and Auth: auth and profiles (evidence: `backend/Services/AuthService.cs`)
- Lesson Services → Supabase Data and Auth: reads lessons
- Exercise Services → Supabase Data and Auth: reads and submits (evidence: `backend/Services/ExerciseService.cs`)
- Dashboard Metrics → Supabase Data and Auth: reads activity (evidence: `backend/Services/StudentDashboardService.cs`)
- Progress and Leaderboard → Supabase Data and Auth: reads progress
- Admin Services → Supabase Data and Auth: manages content (evidence: `backend/Services/AdminLessonService.cs`)
- Code Execution → Engine CLI: runs CLI (evidence: `README.md`)
- Engine CLI → Lexer: tokenizes (evidence: `myalgo-engine/src/main.cpp`)
- Engine CLI → Parser: parses (evidence: `myalgo-engine/src/main.cpp`)
- Engine CLI → Semantic Analysis: analyzes (evidence: `myalgo-engine/src/main.cpp`)
- Engine CLI → Code Generation: generates code (evidence: `myalgo-engine/src/main.cpp`)
- Engine CLI → Generated Program Runtime: compiles and runs (evidence: `README.md`)
- Study Assistant → AI-Style Assistant: assistant interaction
