How vigneshb-dev/career_tracker works
SkillTrace is a longitudinal workforce-outcome platform for trainees, coaches, employers, and institutions. Its main workflow builds an evidence-backed trainee passport, diagnoses competency gaps against job requirements, and tracks verified employment outcomes through follow-ups and analytics. The React application routes users to role-specific views and its API client communicates with FastAPI endpoints; backend services provide the intelligence stages. The graph preserves the README’s documented simulator, digital twin, intervention, resume-analysis, and audit capabilities. Some backend router-to-service wiring is not shown in the sampled source, so those links are omitted.
Main entry points: App.tsx Route application · api.ts API client · skill_gap_service.py Gap analysis engine · TraineeDetail.tsx Trainee passport
Components 27
Web application
- Route application
frontend/src/App.tsx - Trainee passport
frontend/src/pages/TraineeDetail.tsx - Skill gap views
frontend/src/pages/SkillGaps.tsx - Analytics dashboard
frontend/src/pages/Analytics.tsx - Career simulator
frontend/src/pages/CareerSimulator.tsx - Career digital twin
frontend/src/pages/DigitalTwin.tsx - Follow-up views
frontend/src/pages/FollowUps.tsx
Identity and access
- Auth state
frontend/src/context/AuthContext.tsx - Authentication API
backend/app/routers/auth.py
Skills and careers
- Skill gap API
backend/app/routers/skill_gaps.py - Career simulation API
backend/app/routers/career_simulator.py - Digital twin API
backend/app/routers/digital_twin.py - Gap analysis engine
backend/app/services/skill_gap_service.py - Evidence skill scoring
backend/app/services/skill_scoring_service.py - Skill normalization
backend/app/services/normalization_service.py - Job intelligence
backend/app/services/job_intelligence_service.py - Resume analysis
backend/app/services/resume_analyzer_service.py
Outcomes and interventions
- Follow-up API
backend/app/routers/follow_ups.py - Analytics API
backend/app/routers/analytics.py - Outcome risk engine
backend/app/services/outcome_risk_service.py - Intervention engine
backend/app/services/intervention_service.py - Employer verification
backend/app/services/employer_verification_service.py
API and persistence
- API client
frontend/src/services/api.ts - Trainee API
backend/app/routers/trainees.py - Domain records
backend/app/models/entities.py - Relational and vector store
backend/app/core/database.py
Other components
- Workforce users
Connections 31
- Workforce users → Route application: uses
- Route application → Auth state: provides auth
frontend/src/App.tsx - Route application → Trainee passport: routes to
frontend/src/App.tsx - Route application → Skill gap views: routes to
frontend/src/App.tsx - Workforce users → Trainee passport: maintains record
- Trainee passport → API client: requests data
frontend/src/pages/TraineeDetail.tsx - Skill gap views → API client: requests data
frontend/src/pages/SkillGaps.tsx - Auth state → API client: auth calls
frontend/src/context/AuthContext.tsx - API client → Authentication API: sends auth requests
frontend/src/services/api.ts - API client → Trainee API: sends trainee requests
frontend/src/services/api.ts - API client → Follow-up API: sends follow-up requests
frontend/src/services/api.ts - API client → Analytics API: requests metrics
frontend/src/services/api.ts - API client → Skill gap API: requests gap data
- Route application → Career simulator: routes to
frontend/src/App.tsx - Route application → Career digital twin: routes to
frontend/src/App.tsx - Route application → Analytics dashboard: routes to
frontend/src/App.tsx - Route application → Follow-up views: routes to
frontend/src/App.tsx - Career simulator → Career simulation API: simulates career paths
- Career digital twin → Digital twin API: models trajectories
- Analytics dashboard → Analytics API: loads analytics
- Follow-up views → Follow-up API: records follow-ups
- Gap analysis engine → Job intelligence: compares job requirements
backend/app/services/skill_gap_service.py - Gap analysis engine → Skill normalization: matches skills
backend/app/services/skill_gap_service.py - Gap analysis engine → Evidence skill scoring: uses evidence scores
backend/app/services/skill_gap_service.py - Workforce users → Resume analysis: submits resume
- Workforce users → Employer verification: seeks verification
- Outcome risk engine → Intervention engine: guides intervention
- Domain records → Relational and vector store: persists records
backend/app/models/entities.py - Trainee API → Domain records: uses domain records
- Skill gap API → Gap analysis engine: runs diagnostics
- Follow-up API → Domain records: records follow-ups