How shruthikasuyaraj/skill-track works
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: main.py FastAPI application · App.tsx Role-based routes · models.py Platform database · api.ts API client
Components 26
Web experience
- Role-based routes
skilltrack/src/App.tsx - Sign-in and registration
skilltrack/src/context/AuthContext.tsx - Student dashboard
skilltrack/src/pages/StudentDashboard.tsx - Exam interface
skilltrack/src/pages/ExamDashboard.tsx - Admin management
skilltrack/src/pages/AdminDashboard.tsx - Domain owner
skilltrack/src/pages/OwnerDashboard.tsx - Invigilator console
skilltrack/src/pages/InvigilatorDashboard.tsx - Domain enrollment
skilltrack/src/pages/DomainsPage.tsx - Certificate verification
skilltrack/src/pages/Verify.tsx - API client
skilltrack/src/api.ts
Identity and access
- Authentication routes
skilltrack-api/app/routers/auth.py - Token and role checks
skilltrack-api/app/deps.py
Assessments
- Exam sessions and grading
skilltrack-api/app/routers/exam.py - Slot scheduling and booking
skilltrack-api/app/routers/slots.py - Domain and question management
skilltrack-api/app/routers/owner.py - Administration and analytics
skilltrack-api/app/routers/admin.py
Progress and guidance
- Enrollment and student data
skilltrack-api/app/routers/student.py - Progression and awards
skilltrack-api/app/rules.py - Certificate issuance and lookup
skilltrack-api/app/routers/certificates.py - AI recommendations and advice
skilltrack-api/app/routers/ai.py - Skill-gap analysis
skilltrack-api/app/ai_engine/skill_gap.py
Platform services
- Platform database
skilltrack-api/app/models.py - FastAPI application
skilltrack-api/app/main.py - Database sessions
skilltrack-api/app/database.py
Other components
- Platform users
- Gemini service
Connections 40
- Platform users → Role-based routes: use
skilltrack/src/App.tsx - Role-based routes → Sign-in and registration: loads identity
skilltrack/src/App.tsx - Role-based routes → Student dashboard: routes students
skilltrack/src/App.tsx - Role-based routes → Exam interface: routes exams
skilltrack/src/App.tsx - Role-based routes → Admin management: routes admins
skilltrack/src/App.tsx - Role-based routes → Domain owner: routes owners
skilltrack/src/App.tsx - Role-based routes → Invigilator console: routes staff
skilltrack/src/App.tsx - Role-based routes → Domain enrollment: routes enrollment
skilltrack/src/App.tsx - Role-based routes → Certificate verification: routes verification
skilltrack/src/App.tsx - Sign-in and registration → API client: calls API
skilltrack/src/context/AuthContext.tsx - Student dashboard → API client: calls API
skilltrack/src/pages/StudentDashboard.tsx - Exam interface → API client: calls API
skilltrack/src/pages/ExamDashboard.tsx - Admin management → API client: calls API
skilltrack/src/pages/AdminDashboard.tsx - Domain enrollment → API client: calls API
skilltrack/src/pages/DomainsPage.tsx - API client → FastAPI application: sends requests
- Platform users → Sign-in and registration: authenticate
skilltrack/src/context/AuthContext.tsx - FastAPI application → Authentication routes: mounts routes
skilltrack-api/app/main.py - FastAPI application → Exam sessions and grading: mounts routes
skilltrack-api/app/main.py - FastAPI application → Slot scheduling and booking: mounts routes
skilltrack-api/app/main.py - FastAPI application → Enrollment and student data: mounts routes
skilltrack-api/app/main.py - FastAPI application → Administration and analytics: mounts routes
skilltrack-api/app/main.py - FastAPI application → Domain and question management: mounts routes
skilltrack-api/app/main.py - FastAPI application → Certificate issuance and lookup: mounts routes
skilltrack-api/app/main.py - FastAPI application → AI recommendations and advice: mounts routes
skilltrack-api/app/main.py - Authentication routes → Token and role checks: checks access
skilltrack-api/app/routers/auth.py - Authentication routes → Platform database: reads and writes
skilltrack-api/app/routers/auth.py - Exam sessions and grading → Platform database: reads and writes
skilltrack-api/app/routers/exam.py - Exam sessions and grading → Progression and awards: records attempt
skilltrack-api/app/routers/exam.py - Slot scheduling and booking → Platform database: manages bookings
- Enrollment and student data → Platform database: reads and writes
skilltrack-api/app/routers/student.py - Administration and analytics → Platform database: manages platform data
skilltrack-api/app/routers/admin.py - Domain and question management → Platform database: manages domain data
- Progression and awards → Platform database: updates outcomes
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
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
skilltrack-api/app/main.py - Database sessions → Platform database: persists models
skilltrack-api/app/database.py