# shruthikasuyaraj/skill_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/shruthikasuyaraj/skill_tracker
- Repository: https://github.com/shruthikasuyaraj/skill_tracker

## Overview

Skill Leveling Platform is a student assessment and progression product: students enroll in domain tracks, prepare, book an exam slot, take an assessment, and receive results that inform level progression and skill-gap analysis. The backend also supports AI question generation, account administration, invigilation logistics, and analytics dashboards. The graph combines documented workflow with source-index references; several feature implementations and frontend-to-API calls were not sampled, so those links are omitted rather than inferred.

Main entry points: [`app/main.py`](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/main.py) (API router mounting), [`app/modules/attempts/service.py`](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/attempts/service.py) (Exam attempts), [`frontend/src/pages/student`](https://github.com/shruthikasuyaraj/skill_tracker/tree/main/frontend/src/pages/student) (Student pages), [`app/modules/auth/service.py`](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/auth/service.py) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_web["Web application<br/>[App.tsx]"]
  node_student_pages["Student pages"]
end

subgraph group_assessment["Assessment lifecycle"]
  node_domains["Tracks and levels<br/>[service.py]"]
  node_progress["Enrollment and progression<br/>[service.py]"]
  node_slots["Exam slot booking<br/>[service.py]"]
  node_attempts["Exam attempts<br/>[service.py]"]
  node_ai["AI question engine<br/>[service.py]"]
end

subgraph group_operations["Platform operations"]
  node_users["Accounts and roles<br/>[service.py]"]
  node_allocation["Exam allocation<br/>[service.py]"]
  node_halls["Halls and hall sheets<br/>[service.py]"]
  node_analytics["Analytics summaries<br/>[service.py]"]
  node_analytics_store[("Analytics records<br/>[models.py]")]
  node_scheduled["Nightly refresh<br/>[scheduled_jobs.py]"]
end

subgraph group_foundation["Shared foundation"]
  node_auth["Authentication<br/>[service.py]"]
  node_api["API router mounting<br/>[main.py]"]
  node_database[("Database sessions<br/>[database.py]")]
  node_security["Security and configuration<br/>[security.py]"]
  node_audit["Audit logging<br/>[audit.py]"]
  node_errors["API error handling<br/>[exceptions.py]"]
end

node_student(("Student"))
node_llm(("LLM provider"))

node_student -->|"uses"| node_web
node_web -->|"routes to"| node_student_pages
node_api -->|"mounts routes"| node_auth
node_api -->|"mounts routes"| node_domains
node_api -->|"mounts routes"| node_slots
node_api -->|"mounts routes"| node_attempts
node_api -->|"mounts routes"| node_progress
node_student_pages -.->|"enrolls in tracks"| node_domains
node_student_pages -.->|"books slots"| node_slots
node_student_pages -.->|"takes assessments"| node_attempts
node_attempts -->|"checks booking"| node_slots
node_attempts -->|"uses allocation"| node_allocation
node_attempts -->|"records outcomes"| node_progress
node_attempts -->|"gets questions"| node_ai
node_slots -->|"checks eligibility"| node_progress
node_progress -->|"loads levels"| node_domains
node_ai -.->|"requests generation"| node_llm
node_scheduled -->|"runs refresh"| node_analytics
node_analytics -->|"updates summaries"| node_analytics_store
node_auth -->|"uses token security"| node_security
node_auth -->|"records events"| node_audit
node_users -->|"uses account services"| node_auth
node_database --> node_security
node_api -->|"registers handlers"| node_errors

click node_web "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/frontend/src/App.tsx"
click node_student_pages "https://github.com/shruthikasuyaraj/skill_tracker/tree/main/frontend/src/pages/student"
click node_auth "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/auth/service.py"
click node_users "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/users/service.py"
click node_domains "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/domains/service.py"
click node_progress "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/progress/service.py"
click node_slots "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/slots/service.py"
click node_allocation "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/allocation/service.py"
click node_halls "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/hall_sheets/service.py"
click node_attempts "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/attempts/service.py"
click node_ai "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/ai_engine/service.py"
click node_analytics "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/analytics/service.py"
click node_analytics_store "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/analytics/models.py"
click node_scheduled "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/scheduled_jobs.py"
click node_api "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/main.py"
click node_database "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/database.py"
click node_security "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/security.py"
click node_audit "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/audit.py"
click node_errors "https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/exceptions.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_web,node_student_pages toneBlue
class node_domains,node_progress,node_slots,node_attempts,node_ai toneAmber
class node_users,node_allocation,node_halls,node_analytics,node_analytics_store,node_scheduled toneMint
class node_auth,node_api,node_database,node_security,node_audit,node_errors toneRose
class node_student,node_llm toneIndigo
```

## Components

### Student experience

- [Web application](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Student pages](https://github.com/shruthikasuyaraj/skill_tracker/tree/main/frontend/src/pages/student): `frontend/src/pages/student`

### Assessment lifecycle

- [Tracks and levels](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/domains/service.py): `app/modules/domains/service.py`
- [Enrollment and progression](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/progress/service.py): `app/modules/progress/service.py`
- [Exam slot booking](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/slots/service.py): `app/modules/slots/service.py`
- [Exam attempts](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/attempts/service.py): `app/modules/attempts/service.py`
- [AI question engine](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/ai_engine/service.py): `app/modules/ai_engine/service.py`

### Platform operations

- [Accounts and roles](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/users/service.py): `app/modules/users/service.py`
- [Exam allocation](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/allocation/service.py): `app/modules/allocation/service.py`
- [Halls and hall sheets](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/hall_sheets/service.py): `app/modules/hall_sheets/service.py`
- [Analytics summaries](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/analytics/service.py): `app/modules/analytics/service.py`
- [Analytics records](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/analytics/models.py): `app/modules/analytics/models.py`
- [Nightly refresh](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/scheduled_jobs.py): `app/scheduled_jobs.py`

### Shared foundation

- [Authentication](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/modules/auth/service.py): `app/modules/auth/service.py`
- [API router mounting](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/main.py): `app/main.py`
- [Database sessions](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/database.py): `app/core/database.py`
- [Security and configuration](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/security.py): `app/core/security.py`
- [Audit logging](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/audit.py): `app/core/audit.py`
- [API error handling](https://github.com/shruthikasuyaraj/skill_tracker/blob/main/app/core/exceptions.py): `app/core/exceptions.py`

### Other components

- **Student**
- **LLM provider**

## Connections

- Student → Web application: uses
- Web application → Student pages: routes to (evidence: `frontend/src/App.tsx`)
- API router mounting → Authentication: mounts routes (evidence: `app/main.py`)
- API router mounting → Tracks and levels: mounts routes (evidence: `app/main.py`)
- API router mounting → Exam slot booking: mounts routes (evidence: `app/main.py`)
- API router mounting → Exam attempts: mounts routes (evidence: `app/main.py`)
- API router mounting → Enrollment and progression: mounts routes (evidence: `app/main.py`)
- Student pages → Tracks and levels: enrolls in tracks
- Student pages → Exam slot booking: books slots
- Student pages → Exam attempts: takes assessments
- Exam attempts → Exam slot booking: checks booking (evidence: `app/modules/attempts/service.py`)
- Exam attempts → Exam allocation: uses allocation (evidence: `app/modules/attempts/service.py`)
- Exam attempts → Enrollment and progression: records outcomes (evidence: `app/modules/attempts/service.py`)
- Exam attempts → AI question engine: gets questions (evidence: `app/modules/attempts/service.py`)
- Exam slot booking → Enrollment and progression: checks eligibility (evidence: `app/modules/slots/service.py`)
- Enrollment and progression → Tracks and levels: loads levels (evidence: `app/modules/progress/service.py`)
- AI question engine → LLM provider: requests generation
- Nightly refresh → Analytics summaries: runs refresh (evidence: `app/scheduled_jobs.py`)
- Analytics summaries → Analytics records: updates summaries (evidence: `app/modules/analytics/service.py`)
- Authentication → Security and configuration: uses token security (evidence: `app/modules/auth/service.py`)
- Authentication → Audit logging: records events (evidence: `app/modules/auth/service.py`)
- Accounts and roles → Authentication: uses account services (evidence: `app/modules/users/service.py`)
- Database sessions → Security and configuration
- API router mounting → API error handling: registers handlers (evidence: `app/main.py`)
