# shruthikasuyaraj/skill-track architecture

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

## Overview

Skill-Track is a role-based college skill-certification platform: students enroll in semester-appropriate domains, book proctored exam slots, sit and submit exams, then track progress, certificates and optional AI study guidance. Admins and domain owners manage assessments and schedules; invigilators issue exam keys. The frontend calls a FastAPI backend backed by relational platform data. README capabilities fill out several unsampled routers; those links are documented, while the AI provider integration is optional. Sampled source establishes routing, auth and core exam/rule behavior; unsampled details are not inferred beyond README.

Main entry points: [`skilltrack-api/app/main.py`](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/main.py) (FastAPI application), [`skilltrack/src/App.tsx`](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/App.tsx) (Role-based routes), [`skilltrack-api/app/models.py`](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/models.py) (Platform database), [`skilltrack/src/api.ts`](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Role-based routes<br/>[App.tsx]"]
  node_authui["Sign-in and registration<br/>[AuthContext.tsx]"]
  node_studentui["Student dashboard"]
  node_examui["Exam interface<br/>[ExamDashboard.tsx]"]
  node_adminui["Admin management<br/>[AdminDashboard.tsx]"]
  node_ownerui["Domain owner<br/>[OwnerDashboard.tsx]"]
  node_invigilatorui["Invigilator console"]
  node_domainsui["Domain enrollment<br/>[DomainsPage.tsx]"]
  node_verifyui["Certificate verification<br/>[Verify.tsx]"]
  node_http["API client<br/>[api.ts]"]
end

subgraph group_access["Identity and access"]
  node_auth["Authentication routes<br/>[auth.py]"]
  node_authguard["Token and role checks<br/>[deps.py]"]
end

subgraph group_assessment["Assessments"]
  node_exam["Exam sessions and grading<br/>[exam.py]"]
  node_slots["Slot scheduling and booking<br/>[slots.py]"]
  node_owner["Domain and question management<br/>[owner.py]"]
  node_admin["Administration and analytics<br/>[admin.py]"]
end

subgraph group_outcomes["Progress and guidance"]
  node_student["Enrollment and student data<br/>[student.py]"]
  node_rules["Progression and awards<br/>[rules.py]"]
  node_certs["Certificate issuance and lookup<br/>[certificates.py]"]
  node_airecs["AI recommendations and advice<br/>[ai.py]"]
  node_aiengine["Skill-gap analysis<br/>[skill_gap.py]"]
end

subgraph group_platform["Platform services"]
  node_database[("Platform database<br/>[models.py]")]
  node_api["FastAPI application<br/>[main.py]"]
  node_storage["Database sessions<br/>[database.py]"]
end

node_people(("Platform users"))
node_gemini["Gemini service"]

node_people -->|"use"| node_app
node_app -->|"loads identity"| node_authui
node_app -->|"routes students"| node_studentui
node_app -->|"routes exams"| node_examui
node_app -->|"routes admins"| node_adminui
node_app -->|"routes owners"| node_ownerui
node_app -->|"routes staff"| node_invigilatorui
node_app -->|"routes enrollment"| node_domainsui
node_app -->|"routes verification"| node_verifyui
node_authui -->|"calls API"| node_http
node_studentui -->|"calls API"| node_http
node_examui -->|"calls API"| node_http
node_adminui -->|"calls API"| node_http
node_domainsui -->|"calls API"| node_http
node_http -.->|"sends requests"| node_api
node_people -->|"authenticate"| node_authui
node_api -->|"mounts routes"| node_auth
node_api -->|"mounts routes"| node_exam
node_api -->|"mounts routes"| node_slots
node_api -->|"mounts routes"| node_student
node_api -->|"mounts routes"| node_admin
node_api -->|"mounts routes"| node_owner
node_api -->|"mounts routes"| node_certs
node_api -->|"mounts routes"| node_airecs
node_auth -->|"checks access"| node_authguard
node_auth -->|"reads and writes"| node_database
node_exam -->|"reads and writes"| node_database
node_exam -->|"records attempt"| node_rules
node_slots -.->|"manages bookings"| node_database
node_student -->|"reads and writes"| node_database
node_admin -->|"manages platform data"| node_database
node_owner -.->|"manages domain data"| node_database
node_rules -->|"updates outcomes"| node_database
node_rules -.->|"issues certificates"| node_certs
node_certs -.->|"reads and writes"| node_database
node_airecs -->|"requests analysis"| node_aiengine
node_airecs -.->|"requests generation"| node_gemini
node_aiengine -.->|"uses model wrapper"| node_gemini
node_api -->|"creates schema"| node_storage
node_storage -->|"persists models"| node_database

click node_app "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/App.tsx"
click node_authui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/context/AuthContext.tsx"
click node_studentui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/StudentDashboard.tsx"
click node_examui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/ExamDashboard.tsx"
click node_adminui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/AdminDashboard.tsx"
click node_ownerui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/OwnerDashboard.tsx"
click node_invigilatorui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/InvigilatorDashboard.tsx"
click node_domainsui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/DomainsPage.tsx"
click node_verifyui "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/Verify.tsx"
click node_http "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/api.ts"
click node_auth "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/auth.py"
click node_authguard "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/deps.py"
click node_exam "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/exam.py"
click node_slots "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/slots.py"
click node_owner "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/owner.py"
click node_admin "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/admin.py"
click node_student "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/student.py"
click node_rules "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/rules.py"
click node_certs "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/certificates.py"
click node_airecs "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/ai.py"
click node_aiengine "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/ai_engine/skill_gap.py"
click node_database "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/models.py"
click node_api "https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/main.py"
click node_storage "https://github.com/shruthikasuyaraj/skill-track/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_authui,node_studentui,node_examui,node_adminui,node_ownerui,node_invigilatorui,node_domainsui,node_verifyui,node_http,node_people toneBlue
class node_auth,node_authguard toneAmber
class node_exam,node_slots,node_owner,node_admin toneMint
class node_student,node_rules,node_certs,node_airecs,node_aiengine toneRose
class node_database,node_api,node_storage,node_gemini toneIndigo
```

## Components

### Web experience

- [Role-based routes](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/App.tsx): `skilltrack/src/App.tsx`
- [Sign-in and registration](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/context/AuthContext.tsx): `skilltrack/src/context/AuthContext.tsx`
- [Student dashboard](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/StudentDashboard.tsx): `skilltrack/src/pages/StudentDashboard.tsx`
- [Exam interface](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/ExamDashboard.tsx): `skilltrack/src/pages/ExamDashboard.tsx`
- [Admin management](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/AdminDashboard.tsx): `skilltrack/src/pages/AdminDashboard.tsx`
- [Domain owner](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/OwnerDashboard.tsx): `skilltrack/src/pages/OwnerDashboard.tsx`
- [Invigilator console](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/InvigilatorDashboard.tsx): `skilltrack/src/pages/InvigilatorDashboard.tsx`
- [Domain enrollment](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/DomainsPage.tsx): `skilltrack/src/pages/DomainsPage.tsx`
- [Certificate verification](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/pages/Verify.tsx): `skilltrack/src/pages/Verify.tsx`
- [API client](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack/src/api.ts): `skilltrack/src/api.ts`

### Identity and access

- [Authentication routes](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/auth.py): `skilltrack-api/app/routers/auth.py`
- [Token and role checks](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/deps.py): `skilltrack-api/app/deps.py`

### Assessments

- [Exam sessions and grading](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/exam.py): `skilltrack-api/app/routers/exam.py`
- [Slot scheduling and booking](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/slots.py): `skilltrack-api/app/routers/slots.py`
- [Domain and question management](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/owner.py): `skilltrack-api/app/routers/owner.py`
- [Administration and analytics](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/admin.py): `skilltrack-api/app/routers/admin.py`

### Progress and guidance

- [Enrollment and student data](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/student.py): `skilltrack-api/app/routers/student.py`
- [Progression and awards](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/rules.py): `skilltrack-api/app/rules.py`
- [Certificate issuance and lookup](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/certificates.py): `skilltrack-api/app/routers/certificates.py`
- [AI recommendations and advice](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/routers/ai.py): `skilltrack-api/app/routers/ai.py`
- [Skill-gap analysis](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/ai_engine/skill_gap.py): `skilltrack-api/app/ai_engine/skill_gap.py`

### Platform services

- [Platform database](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/models.py): `skilltrack-api/app/models.py`
- [FastAPI application](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/main.py): `skilltrack-api/app/main.py`
- [Database sessions](https://github.com/shruthikasuyaraj/skill-track/blob/main/skilltrack-api/app/database.py): `skilltrack-api/app/database.py`

### Other components

- **Platform users**
- **Gemini service**

## Connections

- Platform users → Role-based routes: use (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Sign-in and registration: loads identity (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Student dashboard: routes students (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Exam interface: routes exams (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Admin management: routes admins (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Domain owner: routes owners (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Invigilator console: routes staff (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Domain enrollment: routes enrollment (evidence: `skilltrack/src/App.tsx`)
- Role-based routes → Certificate verification: routes verification (evidence: `skilltrack/src/App.tsx`)
- Sign-in and registration → API client: calls API (evidence: `skilltrack/src/context/AuthContext.tsx`)
- Student dashboard → API client: calls API (evidence: `skilltrack/src/pages/StudentDashboard.tsx`)
- Exam interface → API client: calls API (evidence: `skilltrack/src/pages/ExamDashboard.tsx`)
- Admin management → API client: calls API (evidence: `skilltrack/src/pages/AdminDashboard.tsx`)
- Domain enrollment → API client: calls API (evidence: `skilltrack/src/pages/DomainsPage.tsx`)
- API client → FastAPI application: sends requests
- Platform users → Sign-in and registration: authenticate (evidence: `skilltrack/src/context/AuthContext.tsx`)
- FastAPI application → Authentication routes: mounts routes (evidence: `skilltrack-api/app/main.py`)
- FastAPI application → Exam sessions and grading: mounts routes (evidence: `skilltrack-api/app/main.py`)
- FastAPI application → Slot scheduling and booking: mounts routes (evidence: `skilltrack-api/app/main.py`)
- FastAPI application → Enrollment and student data: mounts routes (evidence: `skilltrack-api/app/main.py`)
- FastAPI application → Administration and analytics: mounts routes (evidence: `skilltrack-api/app/main.py`)
- FastAPI application → Domain and question management: mounts routes (evidence: `skilltrack-api/app/main.py`)
- FastAPI application → Certificate issuance and lookup: mounts routes (evidence: `skilltrack-api/app/main.py`)
- FastAPI application → AI recommendations and advice: mounts routes (evidence: `skilltrack-api/app/main.py`)
- Authentication routes → Token and role checks: checks access (evidence: `skilltrack-api/app/routers/auth.py`)
- Authentication routes → Platform database: reads and writes (evidence: `skilltrack-api/app/routers/auth.py`)
- Exam sessions and grading → Platform database: reads and writes (evidence: `skilltrack-api/app/routers/exam.py`)
- Exam sessions and grading → Progression and awards: records attempt (evidence: `skilltrack-api/app/routers/exam.py`)
- Slot scheduling and booking → Platform database: manages bookings
- Enrollment and student data → Platform database: reads and writes (evidence: `skilltrack-api/app/routers/student.py`)
- Administration and analytics → Platform database: manages platform data (evidence: `skilltrack-api/app/routers/admin.py`)
- Domain and question management → Platform database: manages domain data
- Progression and awards → Platform database: updates outcomes (evidence: `skilltrack-api/app/rules.py`)
- Progression and awards → Certificate issuance and lookup: issues certificates
- Certificate issuance and lookup → Platform database: reads and writes
- AI recommendations and advice → Skill-gap analysis: requests analysis (evidence: `skilltrack-api/app/routers/ai.py`)
- AI recommendations and advice → Gemini service: requests generation
- Skill-gap analysis → Gemini service: uses model wrapper
- FastAPI application → Database sessions: creates schema (evidence: `skilltrack-api/app/main.py`)
- Database sessions → Platform database: persists models (evidence: `skilltrack-api/app/database.py`)
