How maria-k-paul/skill-track-new-v1 works
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: models.py Domain records · main.py FastAPI entrypoint · api.ts HTTP client · rules.py Progression rules
Components 25
Web client
- Role routing
skilltrack/src/App.tsx - HTTP client
skilltrack/src/api.ts
Identity
- Session state
skilltrack/src/context/AuthContext.tsx - Authentication routes
skilltrack-api/app/routers/auth.py - Token security
skilltrack-api/app/security.py - Request authorization
skilltrack-api/app/deps.py
Learning and exams
- Student learning
skilltrack/src/pages/StudentDashboard.tsx - Domain catalog
skilltrack/src/pages/DomainsPage.tsx - Exam workflow
skilltrack/src/pages/ExamDashboard.tsx - Student routes
skilltrack-api/app/routers/student.py - Exam routes
skilltrack-api/app/routers/exam.py - AI routes
skilltrack-api/app/routers/ai.py - Certificate routes
skilltrack-api/app/routers/certificates.py - Progression rules
skilltrack-api/app/rules.py - AI services
skilltrack-api/app/ai.py
Platform operations
- Admin console
skilltrack/src/pages/AdminDashboard.tsx - Slot management
skilltrack/src/components/SlotManager.tsx - Admin routes
skilltrack-api/app/routers/admin.py - Owner routes
skilltrack-api/app/routers/owner.py - Slot routes
skilltrack-api/app/routers/slots.py - No-show processing
skilltrack-api/app/noshow.py
API and persistence
- FastAPI entrypoint
skilltrack-api/app/main.py - Domain records
skilltrack-api/app/models.py - SQL database
skilltrack-api/app/database.py
Other components
- Platform user
Connections 47
- Platform user → Role routing: uses
skilltrack/src/App.tsx - Role routing → Session state: checks session
skilltrack/src/App.tsx - Session state → HTTP client: requests
skilltrack/src/context/AuthContext.tsx - Role routing → Student learning: routes
skilltrack/src/App.tsx - Role routing → Domain catalog: routes
skilltrack/src/App.tsx - Role routing → Exam workflow: routes
skilltrack/src/App.tsx - Role routing → Admin console: routes
skilltrack/src/App.tsx - Student learning → HTTP client: loads data
skilltrack/src/pages/StudentDashboard.tsx - Domain catalog → HTTP client: loads data
skilltrack/src/pages/DomainsPage.tsx - Exam workflow → HTTP client: loads data
skilltrack/src/pages/ExamDashboard.tsx - Admin console → HTTP client: manages data
skilltrack/src/pages/AdminDashboard.tsx - Slot management → HTTP client: manages slots
skilltrack/src/components/SlotManager.tsx - HTTP client → FastAPI entrypoint: HTTP calls
- FastAPI entrypoint → Authentication routes: registers
skilltrack-api/app/main.py - FastAPI entrypoint → Student routes: registers
skilltrack-api/app/main.py - FastAPI entrypoint → Exam routes: registers
skilltrack-api/app/main.py - FastAPI entrypoint → AI routes: registers
skilltrack-api/app/main.py - FastAPI entrypoint → Admin routes: registers
skilltrack-api/app/main.py - FastAPI entrypoint → Owner routes: registers
skilltrack-api/app/main.py - FastAPI entrypoint → Slot routes: registers
skilltrack-api/app/main.py - FastAPI entrypoint → Certificate routes: registers
skilltrack-api/app/main.py - Authentication routes → Token security: creates tokens
skilltrack-api/app/routers/auth.py - Authentication routes → Request authorization: uses identity
skilltrack-api/app/routers/auth.py - Authentication routes → Progression rules: ensures enrollment
skilltrack-api/app/routers/auth.py - Authentication routes → Domain records: queries users
skilltrack-api/app/routers/auth.py - Student routes → Progression rules: applies progression
skilltrack-api/app/routers/student.py - Student routes → Domain records: queries records
skilltrack-api/app/routers/student.py - Student routes → Request authorization: authorizes
skilltrack-api/app/routers/student.py - Exam routes → Progression rules: scores attempts
skilltrack-api/app/routers/exam.py - Exam routes → Domain records: queries records
skilltrack-api/app/routers/exam.py - Exam routes → Request authorization: authorizes
skilltrack-api/app/routers/exam.py - AI routes → AI services: invokes
skilltrack-api/app/routers/ai.py - AI routes → Progression rules: uses rules
skilltrack-api/app/routers/ai.py - AI routes → Domain records: queries records
skilltrack-api/app/routers/ai.py - Admin routes → Progression rules: uses rules
skilltrack-api/app/routers/admin.py - Admin routes → Domain records: manages records
skilltrack-api/app/routers/admin.py - Owner routes → Progression rules: uses rules
skilltrack-api/app/routers/owner.py - Owner routes → Domain records: manages records
skilltrack-api/app/routers/owner.py - Slot routes → Domain records: manages slots
- Certificate routes → Domain records: queries certificates
skilltrack-api/app/routers/certificates.py - FastAPI entrypoint → No-show processing: schedules job
skilltrack-api/app/main.py - No-show processing → Domain records: updates records
skilltrack-api/app/noshow.py - Progression rules → Domain records: updates progression
skilltrack-api/app/rules.py - Domain records → SQL database: maps tables
skilltrack-api/app/models.py - Request authorization → Token security: decodes tokens
skilltrack-api/app/deps.py - Request authorization → Domain records: loads user
skilltrack-api/app/deps.py - SQL database → Domain records: provides base
skilltrack-api/app/models.py