# nizarudeen06/skill-track architecture

> Architecture diagram of the GitHub repository nizarudeen06/skill-track, 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/nizarudeen06/skill-track
- Repository: https://github.com/nizarudeen06/skill-track

## Overview

SkillTrack is a role-based skills assessment and progression platform. Students register, select or receive an assessment track, book a slot where required, take exams, and earn progression credit and certificates; owners and administrators manage domains, questions, slots, and platform settings, while invigilators support exam sessions. The React application routes users to role-specific dashboards and calls a FastAPI service backed by SQLAlchemy models. The README provides no further product detail, and several router implementations were not sampled, so uncertain frontend-to-API links are dashed.

Main entry points: [`skilltrack-api/app/main.py`](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/main.py) (API application), [`skilltrack/src/App.tsx`](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/App.tsx) (Role-based routing), [`skilltrack-api/app/models.py`](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/models.py) (Assessment entities), [`skilltrack-api/app/database.py`](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/database.py) (Database sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Role-based routing<br/>[App.tsx]"]
  node_authui["Auth state<br/>[AuthContext.tsx]"]
  node_transport["HTTP client<br/>[api.ts]"]
  node_studentui["Student experience"]
  node_examui["Exam experience<br/>[ExamDashboard.tsx]"]
  node_adminui["Admin management<br/>[AdminDashboard.tsx]"]
  node_ownerui["Owner management<br/>[OwnerDashboard.tsx]"]
  node_invigilatorui["Invigilator console"]
  node_questions["Question bank<br/>[QuestionBank.tsx]"]
  node_slotsui["Slot manager<br/>[SlotManager.tsx]"]
end

subgraph group_api["API routes"]
  node_apiapp["API application<br/>[main.py]"]
  node_authroutes["Authentication<br/>[auth.py]"]
  node_studentroutes["Student routes<br/>[student.py]"]
  node_examroutes["Exam routes<br/>[exam.py]"]
  node_adminroutes["Admin routes<br/>[admin.py]"]
  node_ownerroutes["Owner routes<br/>[owner.py]"]
  node_slotroutes["Slot routes<br/>[slots.py]"]
  node_airoutes["AI assistance<br/>[ai.py]"]
  node_certificates["Certificates<br/>[certificates.py]"]
end

subgraph group_domain["Assessment domain"]
  node_rules["Progression rules<br/>[rules.py]"]
  node_ai["AI services<br/>[ai.py]"]
end

subgraph group_storage["Persistence and access"]
  node_models["Assessment entities<br/>[models.py]"]
  node_database[("Database sessions<br/>[database.py]")]
  node_deps["Identity and roles<br/>[deps.py]"]
  node_security["Token security<br/>[security.py]"]
end

node_user(("Platform users"))

node_user -->|"uses"| node_app
node_app -->|"checks roles"| node_authui
node_app -->|"routes to"| node_studentui
node_app -->|"routes to"| node_examui
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_ownerui
node_app -->|"routes to"| node_invigilatorui
node_authui -->|"calls"| node_transport
node_studentui -->|"uses"| node_transport
node_examui -->|"uses"| node_transport
node_adminui -->|"renders"| node_questions
node_adminui -->|"renders"| node_slotsui
node_ownerui -->|"renders"| node_questions
node_ownerui -->|"renders"| node_slotsui
node_questions -->|"calls"| node_transport
node_slotsui -->|"calls"| node_transport
node_transport -.->|"HTTP requests"| node_apiapp
node_apiapp -->|"registers"| node_authroutes
node_apiapp -->|"registers"| node_studentroutes
node_apiapp -->|"registers"| node_examroutes
node_apiapp -->|"registers"| node_adminroutes
node_apiapp -->|"registers"| node_ownerroutes
node_apiapp -->|"registers"| node_slotroutes
node_apiapp -->|"registers"| node_airoutes
node_apiapp -->|"registers"| node_certificates
node_authroutes -->|"opens sessions"| node_database
node_authroutes -->|"queries and writes"| node_models
node_authroutes -->|"enrolls user"| node_rules
node_authroutes -->|"creates tokens"| node_security
node_studentroutes -->|"uses sessions"| node_database
node_studentroutes -->|"queries and writes"| node_models
node_studentroutes -->|"applies rules"| node_rules
node_examroutes -->|"uses sessions"| node_database
node_examroutes -->|"queries and writes"| node_models
node_examroutes -->|"applies rules"| node_rules
node_adminroutes -->|"uses sessions"| node_database
node_adminroutes -->|"queries and writes"| node_models
node_adminroutes -->|"uses rules"| node_rules
node_ownerroutes -->|"uses sessions"| node_database
node_ownerroutes -->|"queries and writes"| node_models
node_ownerroutes -->|"uses rules"| node_rules
node_slotroutes -.->|"uses entities"| node_models
node_airoutes -->|"delegates"| node_ai
node_airoutes -->|"uses sessions"| node_database
node_airoutes -->|"queries data"| node_models
node_airoutes -->|"uses rules"| node_rules
node_certificates -->|"uses sessions"| node_database
node_certificates -->|"queries data"| node_models

click node_app "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/App.tsx"
click node_authui "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/context/AuthContext.tsx"
click node_transport "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/api.ts"
click node_studentui "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/StudentDashboard.tsx"
click node_examui "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/ExamDashboard.tsx"
click node_adminui "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/AdminDashboard.tsx"
click node_ownerui "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/OwnerDashboard.tsx"
click node_invigilatorui "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/InvigilatorDashboard.tsx"
click node_questions "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/components/QuestionBank.tsx"
click node_slotsui "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/components/SlotManager.tsx"
click node_apiapp "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/main.py"
click node_authroutes "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/auth.py"
click node_studentroutes "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/student.py"
click node_examroutes "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/exam.py"
click node_adminroutes "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/admin.py"
click node_ownerroutes "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/owner.py"
click node_slotroutes "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/slots.py"
click node_airoutes "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/ai.py"
click node_certificates "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/certificates.py"
click node_rules "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/rules.py"
click node_ai "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/ai.py"
click node_models "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/models.py"
click node_database "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/database.py"
click node_deps "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/deps.py"
click node_security "https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/security.py"

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_authui,node_transport,node_studentui,node_examui,node_adminui,node_ownerui,node_invigilatorui,node_questions,node_slotsui,node_user toneBlue
class node_apiapp,node_authroutes,node_studentroutes,node_examroutes,node_adminroutes,node_ownerroutes,node_slotroutes,node_airoutes,node_certificates toneAmber
class node_rules,node_ai toneMint
class node_models,node_database,node_deps,node_security toneRose
```

## Components

### Web application

- [Role-based routing](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/App.tsx): `skilltrack/src/App.tsx`
- [Auth state](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/context/AuthContext.tsx): `skilltrack/src/context/AuthContext.tsx`
- [HTTP client](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/api.ts): `skilltrack/src/api.ts`
- [Student experience](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/StudentDashboard.tsx): `skilltrack/src/pages/StudentDashboard.tsx`
- [Exam experience](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/ExamDashboard.tsx): `skilltrack/src/pages/ExamDashboard.tsx`
- [Admin management](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/AdminDashboard.tsx): `skilltrack/src/pages/AdminDashboard.tsx`
- [Owner management](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/OwnerDashboard.tsx): `skilltrack/src/pages/OwnerDashboard.tsx`
- [Invigilator console](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/pages/InvigilatorDashboard.tsx): `skilltrack/src/pages/InvigilatorDashboard.tsx`
- [Question bank](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/components/QuestionBank.tsx): `skilltrack/src/components/QuestionBank.tsx`
- [Slot manager](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack/src/components/SlotManager.tsx): `skilltrack/src/components/SlotManager.tsx`

### API routes

- [API application](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/main.py): `skilltrack-api/app/main.py`
- [Authentication](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/auth.py): `skilltrack-api/app/routers/auth.py`
- [Student routes](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/student.py): `skilltrack-api/app/routers/student.py`
- [Exam routes](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/exam.py): `skilltrack-api/app/routers/exam.py`
- [Admin routes](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/admin.py): `skilltrack-api/app/routers/admin.py`
- [Owner routes](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/owner.py): `skilltrack-api/app/routers/owner.py`
- [Slot routes](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/slots.py): `skilltrack-api/app/routers/slots.py`
- [AI assistance](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/ai.py): `skilltrack-api/app/routers/ai.py`
- [Certificates](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/routers/certificates.py): `skilltrack-api/app/routers/certificates.py`

### Assessment domain

- [Progression rules](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/rules.py): `skilltrack-api/app/rules.py`
- [AI services](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/ai.py): `skilltrack-api/app/ai.py`

### Persistence and access

- [Assessment entities](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/models.py): `skilltrack-api/app/models.py`
- [Database sessions](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/database.py): `skilltrack-api/app/database.py`
- [Identity and roles](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/deps.py): `skilltrack-api/app/deps.py`
- [Token security](https://github.com/nizarudeen06/skill-track/blob/main/skilltrack-api/app/security.py): `skilltrack-api/app/security.py`

### Other components

- **Platform users**

## Connections

- Platform users → Role-based routing: uses (evidence: `skilltrack/src/App.tsx`)
- Role-based routing → Auth state: checks roles (evidence: `skilltrack/src/App.tsx`)
- Role-based routing → Student experience: routes to (evidence: `skilltrack/src/App.tsx`)
- Role-based routing → Exam experience: routes to (evidence: `skilltrack/src/App.tsx`)
- Role-based routing → Admin management: routes to (evidence: `skilltrack/src/App.tsx`)
- Role-based routing → Owner management: routes to (evidence: `skilltrack/src/App.tsx`)
- Role-based routing → Invigilator console: routes to (evidence: `skilltrack/src/App.tsx`)
- Auth state → HTTP client: calls (evidence: `skilltrack/src/context/AuthContext.tsx`)
- Student experience → HTTP client: uses (evidence: `skilltrack/src/pages/StudentDashboard.tsx`)
- Exam experience → HTTP client: uses (evidence: `skilltrack/src/pages/ExamDashboard.tsx`)
- Admin management → Question bank: renders (evidence: `skilltrack/src/pages/AdminDashboard.tsx`)
- Admin management → Slot manager: renders (evidence: `skilltrack/src/pages/AdminDashboard.tsx`)
- Owner management → Question bank: renders (evidence: `skilltrack/src/pages/OwnerDashboard.tsx`)
- Owner management → Slot manager: renders (evidence: `skilltrack/src/pages/OwnerDashboard.tsx`)
- Question bank → HTTP client: calls (evidence: `skilltrack/src/components/QuestionBank.tsx`)
- Slot manager → HTTP client: calls (evidence: `skilltrack/src/components/SlotManager.tsx`)
- HTTP client → API application: HTTP requests
- API application → Authentication: registers (evidence: `skilltrack-api/app/main.py`)
- API application → Student routes: registers (evidence: `skilltrack-api/app/main.py`)
- API application → Exam routes: registers (evidence: `skilltrack-api/app/main.py`)
- API application → Admin routes: registers (evidence: `skilltrack-api/app/main.py`)
- API application → Owner routes: registers (evidence: `skilltrack-api/app/main.py`)
- API application → Slot routes: registers (evidence: `skilltrack-api/app/main.py`)
- API application → AI assistance: registers (evidence: `skilltrack-api/app/main.py`)
- API application → Certificates: registers (evidence: `skilltrack-api/app/main.py`)
- Authentication → Database sessions: opens sessions (evidence: `skilltrack-api/app/routers/auth.py`)
- Authentication → Assessment entities: queries and writes (evidence: `skilltrack-api/app/routers/auth.py`)
- Authentication → Progression rules: enrolls user (evidence: `skilltrack-api/app/routers/auth.py`)
- Authentication → Token security: creates tokens (evidence: `skilltrack-api/app/routers/auth.py`)
- Student routes → Database sessions: uses sessions (evidence: `skilltrack-api/app/routers/student.py`)
- Student routes → Assessment entities: queries and writes (evidence: `skilltrack-api/app/routers/student.py`)
- Student routes → Progression rules: applies rules (evidence: `skilltrack-api/app/routers/student.py`)
- Exam routes → Database sessions: uses sessions (evidence: `skilltrack-api/app/routers/exam.py`)
- Exam routes → Assessment entities: queries and writes (evidence: `skilltrack-api/app/routers/exam.py`)
- Exam routes → Progression rules: applies rules (evidence: `skilltrack-api/app/routers/exam.py`)
- Admin routes → Database sessions: uses sessions (evidence: `skilltrack-api/app/routers/admin.py`)
- Admin routes → Assessment entities: queries and writes (evidence: `skilltrack-api/app/routers/admin.py`)
- Admin routes → Progression rules: uses rules (evidence: `skilltrack-api/app/routers/admin.py`)
- Owner routes → Database sessions: uses sessions (evidence: `skilltrack-api/app/routers/owner.py`)
- Owner routes → Assessment entities: queries and writes (evidence: `skilltrack-api/app/routers/owner.py`)
- Owner routes → Progression rules: uses rules (evidence: `skilltrack-api/app/routers/owner.py`)
- Slot routes → Assessment entities: uses entities
- AI assistance → AI services: delegates (evidence: `skilltrack-api/app/routers/ai.py`)
- AI assistance → Database sessions: uses sessions (evidence: `skilltrack-api/app/routers/ai.py`)
- AI assistance → Assessment entities: queries data (evidence: `skilltrack-api/app/routers/ai.py`)
- AI assistance → Progression rules: uses rules (evidence: `skilltrack-api/app/routers/ai.py`)
- Certificates → Database sessions: uses sessions (evidence: `skilltrack-api/app/routers/certificates.py`)
- Certificates → Assessment entities: queries data (evidence: `skilltrack-api/app/routers/certificates.py`)
