How jolin181/skill_tracker works
Skill Leveling Platform lets students enroll in skill tracks, prepare for AI-generated assessments, book exam slots, take timed exams, and use results to guide level progression and skill-gap analysis. Its FastAPI backend also supports account administration, invigilation logistics, and analytics; the React frontend exposes student and staff workflows. The graph emphasizes domain stages and the attempt/progression layer. Some feature modules are represented at directory level because their implementation was not excerpted; those links are shown only where documented or indexed.
Main entry points: main.py API router host · attempts/service.py Exam attempts · slots/service.py Slot booking · auth/service.py Accounts and auth
Components 19
Web application
- Role-based pages
frontend/src/App.tsx
Identity and tracks
- Accounts and auth
app/modules/auth/service.py - User administration
app/modules/users/service.py - Tracks and levels
app/modules/domains/service.py
Assessment lifecycle
- Question generation
app/modules/ai_engine - Exam definitions
app/modules/exams/service.py - Exam attempts
app/modules/attempts/service.py
Exam operations
- Slot booking
app/modules/slots/service.py - Halls and allocation
app/modules/allocation/service.py - Hall sheets
app/modules/hall_sheets/service.py
Progress and insights
- Eligibility and progression
app/modules/progress/service.py - Analytics summaries
app/modules/analytics/service.py - Notifications
app/modules/notifications
Backend foundation
- API router host
app/main.py - PostgreSQL data
app/core/database.py - JWT and security
app/core/security.py - Audit logging
app/core/audit.py - Nightly refresh
app/scheduled_jobs.py
Other components
- Student
Connections 24
- Student → Role-based pages: uses
README.md - Role-based pages → API router host: calls API
- API router host → Accounts and auth: mounts routes
app/main.py - API router host → User administration: mounts routes
app/main.py - API router host → Tracks and levels: mounts routes
app/main.py - API router host → Exam definitions: mounts routes
app/main.py - API router host → Slot booking: mounts routes
app/main.py - API router host → Exam attempts: mounts routes
app/main.py - API router host → Eligibility and progression: mounts routes
app/main.py - Student → Tracks and levels: enrolls in tracks
README.md - Student → Slot booking: books exams
README.md - Slot booking → Eligibility and progression: checks eligibility
app/modules/progress/service.py - Exam attempts → Slot booking: reads booking context
app/modules/attempts/service.py - Exam attempts → Eligibility and progression: records results
app/modules/progress/service.py - Exam attempts → Question generation: uses question service
app/modules/attempts/service.py - Exam attempts → Exam definitions: uses exam service
app/modules/attempts/service.py - Halls and allocation → Slot booking: uses slot models
app/modules/allocation/service.py - Hall sheets → Halls and allocation: uses hall models
app/modules/hall_sheets/service.py - Nightly refresh → Analytics summaries: runs refresh
app/scheduled_jobs.py - Analytics summaries → PostgreSQL data: stores summaries
app/modules/analytics/service.py - Accounts and auth → JWT and security: issues tokens
app/modules/auth/service.py - Accounts and auth → Audit logging: records events
app/modules/auth/service.py - User administration → Audit logging: records changes
app/modules/users/service.py - API router host → PostgreSQL data: uses sessions
app/main.py