# maria-k-paul/skill-track-new-v1 architecture

> Architecture diagram of the GitHub repository maria-k-paul/skill-track-new-v1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maria-k-paul/skill-track-new-v1
- Repository: https://github.com/maria-k-paul/skill-track-new-v1

## Overview

SkillTrack is a role-based skills assessment and credential platform. Students register or sign in, explore domains, take level assessments, and progress toward badges and certificates; owners, invigilators, and admins manage domains, exam operations, and platform users. The React client routes users to role-specific workflows and calls a FastAPI API backed by relational models. The graph preserves the major documented-by-code branches, including AI, scheduling, certificates, and automated no-show handling. The README is empty; unsampled routes are represented only where the file tree and indexed references support them.

Main entry points: [`skilltrack-api/app/models.py`](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/models.py) (Domain records), [`skilltrack-api/app/main.py`](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/main.py) (FastAPI entrypoint), [`skilltrack/src/api.ts`](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/api.ts) (HTTP client), [`skilltrack-api/app/rules.py`](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/rules.py) (Progression rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Role routing<br/>[App.tsx]"]
  node_apiclient["HTTP client<br/>[api.ts]"]
end

subgraph group_identity["Identity"]
  node_authctx["Session state<br/>[AuthContext.tsx]"]
  node_authroutes["Authentication routes<br/>[auth.py]"]
  node_security["Token security<br/>[security.py]"]
  node_deps["Request authorization<br/>[deps.py]"]
end

subgraph group_learning["Learning and exams"]
  node_studentui["Student learning"]
  node_domainsui["Domain catalog<br/>[DomainsPage.tsx]"]
  node_examui["Exam workflow<br/>[ExamDashboard.tsx]"]
  node_studentroutes["Student routes<br/>[student.py]"]
  node_examroutes["Exam routes<br/>[exam.py]"]
  node_airoutes["AI routes<br/>[ai.py]"]
  node_certificateroutes["Certificate routes<br/>[certificates.py]"]
  node_rules["Progression rules<br/>[rules.py]"]
  node_aiengine["AI services<br/>[ai.py]"]
end

subgraph group_operations["Platform operations"]
  node_adminui["Admin console<br/>[AdminDashboard.tsx]"]
  node_slotui["Slot management<br/>[SlotManager.tsx]"]
  node_adminroutes["Admin routes<br/>[admin.py]"]
  node_ownerroutes["Owner routes<br/>[owner.py]"]
  node_slotroutes["Slot routes<br/>[slots.py]"]
  node_noshow["No-show processing<br/>[noshow.py]"]
end

subgraph group_core["API and persistence"]
  node_apiapp["FastAPI entrypoint<br/>[main.py]"]
  node_models["Domain records<br/>[models.py]"]
  node_database[("SQL database<br/>[database.py]")]
end

node_user(("Platform user"))

node_user -->|"uses"| node_app
node_app -->|"checks session"| node_authctx
node_authctx -->|"requests"| node_apiclient
node_app -->|"routes"| node_studentui
node_app -->|"routes"| node_domainsui
node_app -->|"routes"| node_examui
node_app -->|"routes"| node_adminui
node_studentui -->|"loads data"| node_apiclient
node_domainsui -->|"loads data"| node_apiclient
node_examui -->|"loads data"| node_apiclient
node_adminui -->|"manages data"| node_apiclient
node_slotui -->|"manages slots"| node_apiclient
node_apiclient -.->|"HTTP calls"| node_apiapp
node_apiapp -->|"registers"| node_authroutes
node_apiapp -->|"registers"| node_studentroutes
node_apiapp -->|"registers"| node_examroutes
node_apiapp -->|"registers"| node_airoutes
node_apiapp -->|"registers"| node_adminroutes
node_apiapp -->|"registers"| node_ownerroutes
node_apiapp -->|"registers"| node_slotroutes
node_apiapp -->|"registers"| node_certificateroutes
node_authroutes -->|"creates tokens"| node_security
node_authroutes -->|"uses identity"| node_deps
node_authroutes -->|"ensures enrollment"| node_rules
node_authroutes -->|"queries users"| node_models
node_studentroutes -->|"applies progression"| node_rules
node_studentroutes -->|"queries records"| node_models
node_studentroutes -->|"authorizes"| node_deps
node_examroutes -->|"scores attempts"| node_rules
node_examroutes -->|"queries records"| node_models
node_examroutes -->|"authorizes"| node_deps
node_airoutes -->|"invokes"| node_aiengine
node_airoutes -->|"uses rules"| node_rules
node_airoutes -->|"queries records"| node_models
node_adminroutes -->|"uses rules"| node_rules
node_adminroutes -->|"manages records"| node_models
node_ownerroutes -->|"uses rules"| node_rules
node_ownerroutes -->|"manages records"| node_models
node_slotroutes -->|"manages slots"| node_models
node_certificateroutes -->|"queries certificates"| node_models
node_apiapp -->|"schedules job"| node_noshow
node_noshow -->|"updates records"| node_models
node_rules -->|"updates progression"| node_models
node_models -->|"maps tables"| node_database
node_deps -->|"decodes tokens"| node_security
node_deps -->|"loads user"| node_models
node_database -->|"provides base"| node_models

click node_app "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/App.tsx"
click node_authctx "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/context/AuthContext.tsx"
click node_apiclient "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/api.ts"
click node_studentui "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/StudentDashboard.tsx"
click node_domainsui "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/DomainsPage.tsx"
click node_examui "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/ExamDashboard.tsx"
click node_adminui "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/AdminDashboard.tsx"
click node_slotui "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/components/SlotManager.tsx"
click node_apiapp "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/main.py"
click node_authroutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/auth.py"
click node_studentroutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/student.py"
click node_examroutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/exam.py"
click node_airoutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/ai.py"
click node_adminroutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/admin.py"
click node_ownerroutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/owner.py"
click node_slotroutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/slots.py"
click node_certificateroutes "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/certificates.py"
click node_rules "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/rules.py"
click node_aiengine "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/ai.py"
click node_noshow "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/noshow.py"
click node_security "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/security.py"
click node_deps "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/deps.py"
click node_models "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/models.py"
click node_database "https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/database.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_apiclient,node_user toneBlue
class node_authctx,node_authroutes,node_security,node_deps toneAmber
class node_studentui,node_domainsui,node_examui,node_studentroutes,node_examroutes,node_airoutes,node_certificateroutes,node_rules,node_aiengine toneMint
class node_adminui,node_slotui,node_adminroutes,node_ownerroutes,node_slotroutes,node_noshow toneRose
class node_apiapp,node_models,node_database toneIndigo
```

## Components

### Web client

- [Role routing](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/App.tsx): `skilltrack/src/App.tsx`
- [HTTP client](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/api.ts): `skilltrack/src/api.ts`

### Identity

- [Session state](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/context/AuthContext.tsx): `skilltrack/src/context/AuthContext.tsx`
- [Authentication routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/auth.py): `skilltrack-api/app/routers/auth.py`
- [Token security](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/security.py): `skilltrack-api/app/security.py`
- [Request authorization](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/deps.py): `skilltrack-api/app/deps.py`

### Learning and exams

- [Student learning](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/StudentDashboard.tsx): `skilltrack/src/pages/StudentDashboard.tsx`
- [Domain catalog](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/DomainsPage.tsx): `skilltrack/src/pages/DomainsPage.tsx`
- [Exam workflow](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/ExamDashboard.tsx): `skilltrack/src/pages/ExamDashboard.tsx`
- [Student routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/student.py): `skilltrack-api/app/routers/student.py`
- [Exam routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/exam.py): `skilltrack-api/app/routers/exam.py`
- [AI routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/ai.py): `skilltrack-api/app/routers/ai.py`
- [Certificate routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/certificates.py): `skilltrack-api/app/routers/certificates.py`
- [Progression rules](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/rules.py): `skilltrack-api/app/rules.py`
- [AI services](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/ai.py): `skilltrack-api/app/ai.py`

### Platform operations

- [Admin console](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/pages/AdminDashboard.tsx): `skilltrack/src/pages/AdminDashboard.tsx`
- [Slot management](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack/src/components/SlotManager.tsx): `skilltrack/src/components/SlotManager.tsx`
- [Admin routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/admin.py): `skilltrack-api/app/routers/admin.py`
- [Owner routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/owner.py): `skilltrack-api/app/routers/owner.py`
- [Slot routes](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/routers/slots.py): `skilltrack-api/app/routers/slots.py`
- [No-show processing](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/noshow.py): `skilltrack-api/app/noshow.py`

### API and persistence

- [FastAPI entrypoint](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/main.py): `skilltrack-api/app/main.py`
- [Domain records](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/models.py): `skilltrack-api/app/models.py`
- [SQL database](https://github.com/maria-k-paul/skill-track-new-v1/blob/main/skilltrack-api/app/database.py): `skilltrack-api/app/database.py`

### Other components

- **Platform user**

## Connections

- Platform user → Role routing: uses (evidence: `skilltrack/src/App.tsx`)
- Role routing → Session state: checks session (evidence: `skilltrack/src/App.tsx`)
- Session state → HTTP client: requests (evidence: `skilltrack/src/context/AuthContext.tsx`)
- Role routing → Student learning: routes (evidence: `skilltrack/src/App.tsx`)
- Role routing → Domain catalog: routes (evidence: `skilltrack/src/App.tsx`)
- Role routing → Exam workflow: routes (evidence: `skilltrack/src/App.tsx`)
- Role routing → Admin console: routes (evidence: `skilltrack/src/App.tsx`)
- Student learning → HTTP client: loads data (evidence: `skilltrack/src/pages/StudentDashboard.tsx`)
- Domain catalog → HTTP client: loads data (evidence: `skilltrack/src/pages/DomainsPage.tsx`)
- Exam workflow → HTTP client: loads data (evidence: `skilltrack/src/pages/ExamDashboard.tsx`)
- Admin console → HTTP client: manages data (evidence: `skilltrack/src/pages/AdminDashboard.tsx`)
- Slot management → HTTP client: manages slots (evidence: `skilltrack/src/components/SlotManager.tsx`)
- HTTP client → FastAPI entrypoint: HTTP calls
- FastAPI entrypoint → Authentication routes: registers (evidence: `skilltrack-api/app/main.py`)
- FastAPI entrypoint → Student routes: registers (evidence: `skilltrack-api/app/main.py`)
- FastAPI entrypoint → Exam routes: registers (evidence: `skilltrack-api/app/main.py`)
- FastAPI entrypoint → AI routes: registers (evidence: `skilltrack-api/app/main.py`)
- FastAPI entrypoint → Admin routes: registers (evidence: `skilltrack-api/app/main.py`)
- FastAPI entrypoint → Owner routes: registers (evidence: `skilltrack-api/app/main.py`)
- FastAPI entrypoint → Slot routes: registers (evidence: `skilltrack-api/app/main.py`)
- FastAPI entrypoint → Certificate routes: registers (evidence: `skilltrack-api/app/main.py`)
- Authentication routes → Token security: creates tokens (evidence: `skilltrack-api/app/routers/auth.py`)
- Authentication routes → Request authorization: uses identity (evidence: `skilltrack-api/app/routers/auth.py`)
- Authentication routes → Progression rules: ensures enrollment (evidence: `skilltrack-api/app/routers/auth.py`)
- Authentication routes → Domain records: queries users (evidence: `skilltrack-api/app/routers/auth.py`)
- Student routes → Progression rules: applies progression (evidence: `skilltrack-api/app/routers/student.py`)
- Student routes → Domain records: queries records (evidence: `skilltrack-api/app/routers/student.py`)
- Student routes → Request authorization: authorizes (evidence: `skilltrack-api/app/routers/student.py`)
- Exam routes → Progression rules: scores attempts (evidence: `skilltrack-api/app/routers/exam.py`)
- Exam routes → Domain records: queries records (evidence: `skilltrack-api/app/routers/exam.py`)
- Exam routes → Request authorization: authorizes (evidence: `skilltrack-api/app/routers/exam.py`)
- AI routes → AI services: invokes (evidence: `skilltrack-api/app/routers/ai.py`)
- AI routes → Progression rules: uses rules (evidence: `skilltrack-api/app/routers/ai.py`)
- AI routes → Domain records: queries records (evidence: `skilltrack-api/app/routers/ai.py`)
- Admin routes → Progression rules: uses rules (evidence: `skilltrack-api/app/routers/admin.py`)
- Admin routes → Domain records: manages records (evidence: `skilltrack-api/app/routers/admin.py`)
- Owner routes → Progression rules: uses rules (evidence: `skilltrack-api/app/routers/owner.py`)
- Owner routes → Domain records: manages records (evidence: `skilltrack-api/app/routers/owner.py`)
- Slot routes → Domain records: manages slots
- Certificate routes → Domain records: queries certificates (evidence: `skilltrack-api/app/routers/certificates.py`)
- FastAPI entrypoint → No-show processing: schedules job (evidence: `skilltrack-api/app/main.py`)
- No-show processing → Domain records: updates records (evidence: `skilltrack-api/app/noshow.py`)
- Progression rules → Domain records: updates progression (evidence: `skilltrack-api/app/rules.py`)
- Domain records → SQL database: maps tables (evidence: `skilltrack-api/app/models.py`)
- Request authorization → Token security: decodes tokens (evidence: `skilltrack-api/app/deps.py`)
- Request authorization → Domain records: loads user (evidence: `skilltrack-api/app/deps.py`)
- SQL database → Domain records: provides base (evidence: `skilltrack-api/app/models.py`)
