# vigneshb-dev/career_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/vigneshb-dev/career_tracker
- Repository: https://github.com/vigneshb-dev/career_tracker

## Overview

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: [`frontend/src/App.tsx`](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/App.tsx) (Route application), [`frontend/src/services/api.ts`](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/services/api.ts) (API client), [`backend/app/services/skill_gap_service.py`](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/skill_gap_service.py) (Gap analysis engine), [`frontend/src/pages/TraineeDetail.tsx`](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/TraineeDetail.tsx) (Trainee passport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["Route application<br/>[App.tsx]"]
  node_passportui["Trainee passport<br/>[TraineeDetail.tsx]"]
  node_gapsui["Skill gap views<br/>[SkillGaps.tsx]"]
  node_analyticsui["Analytics dashboard<br/>[Analytics.tsx]"]
  node_simui["Career simulator"]
  node_twinui["Career digital twin<br/>[DigitalTwin.tsx]"]
  node_followui["Follow-up views<br/>[FollowUps.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_authui["Auth state<br/>[AuthContext.tsx]"]
  node_authapi["Authentication API<br/>[auth.py]"]
end

subgraph group_competency["Skills and careers"]
  node_gapapi["Skill gap API<br/>[skill_gaps.py]"]
  node_careerapi["Career simulation API"]
  node_twinapi["Digital twin API<br/>[digital_twin.py]"]
  node_gapengine["Gap analysis engine"]
  node_skillscore["Evidence skill scoring"]
  node_normalization["Skill normalization"]
  node_jobintel["Job intelligence"]
  node_resume["Resume analysis"]
end

subgraph group_outcomes["Outcomes and interventions"]
  node_followapi["Follow-up API<br/>[follow_ups.py]"]
  node_analyticsapi["Analytics API<br/>[analytics.py]"]
  node_risk["Outcome risk engine"]
  node_intervention["Intervention engine"]
  node_employerverify["Employer verification"]
end

subgraph group_platform["API and persistence"]
  node_api["API client<br/>[api.ts]"]
  node_traineeapi["Trainee API<br/>[trainees.py]"]
  node_entities["Domain records<br/>[entities.py]"]
  node_database[("Relational and vector store<br/>[database.py]")]
end

node_user(("Workforce users"))

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_authui
node_app -->|"routes to"| node_passportui
node_app -->|"routes to"| node_gapsui
node_user -->|"maintains record"| node_passportui
node_passportui -->|"requests data"| node_api
node_gapsui -->|"requests data"| node_api
node_authui -->|"auth calls"| node_api
node_api -->|"sends auth requests"| node_authapi
node_api -->|"sends trainee requests"| node_traineeapi
node_api -->|"sends follow-up requests"| node_followapi
node_api -->|"requests metrics"| node_analyticsapi
node_api -.->|"requests gap data"| node_gapapi
node_app -->|"routes to"| node_simui
node_app -->|"routes to"| node_twinui
node_app -->|"routes to"| node_analyticsui
node_app -.->|"routes to"| node_followui
node_simui -->|"simulates career paths"| node_careerapi
node_twinui -->|"models trajectories"| node_twinapi
node_analyticsui -.->|"loads analytics"| node_analyticsapi
node_followui -.->|"records follow-ups"| node_followapi
node_gapengine -->|"compares job requirements"| node_jobintel
node_gapengine -->|"matches skills"| node_normalization
node_gapengine -->|"uses evidence scores"| node_skillscore
node_user -->|"submits resume"| node_resume
node_user -->|"seeks verification"| node_employerverify
node_risk -->|"guides intervention"| node_intervention
node_entities -->|"persists records"| node_database
node_traineeapi -.->|"uses domain records"| node_entities
node_gapapi -.->|"runs diagnostics"| node_gapengine
node_followapi -.->|"records follow-ups"| node_entities

click node_app "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/context/AuthContext.tsx"
click node_passportui "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/TraineeDetail.tsx"
click node_gapsui "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/SkillGaps.tsx"
click node_analyticsui "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/Analytics.tsx"
click node_simui "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/CareerSimulator.tsx"
click node_twinui "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/DigitalTwin.tsx"
click node_followui "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/FollowUps.tsx"
click node_api "https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/services/api.ts"
click node_authapi "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/auth.py"
click node_traineeapi "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/trainees.py"
click node_gapapi "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/skill_gaps.py"
click node_followapi "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/follow_ups.py"
click node_analyticsapi "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/analytics.py"
click node_careerapi "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/career_simulator.py"
click node_twinapi "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/digital_twin.py"
click node_gapengine "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/skill_gap_service.py"
click node_skillscore "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/skill_scoring_service.py"
click node_normalization "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/normalization_service.py"
click node_jobintel "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/job_intelligence_service.py"
click node_risk "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/outcome_risk_service.py"
click node_intervention "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/intervention_service.py"
click node_employerverify "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/employer_verification_service.py"
click node_resume "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/resume_analyzer_service.py"
click node_entities "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/models/entities.py"
click node_database "https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/core/database.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_app,node_passportui,node_gapsui,node_analyticsui,node_simui,node_twinui,node_followui,node_user toneBlue
class node_authui,node_authapi toneAmber
class node_gapapi,node_careerapi,node_twinapi,node_gapengine,node_skillscore,node_normalization,node_jobintel,node_resume toneMint
class node_followapi,node_analyticsapi,node_risk,node_intervention,node_employerverify toneRose
class node_api,node_traineeapi,node_entities,node_database toneIndigo
```

## Components

### Web application

- [Route application](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Trainee passport](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/TraineeDetail.tsx): `frontend/src/pages/TraineeDetail.tsx`
- [Skill gap views](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/SkillGaps.tsx): `frontend/src/pages/SkillGaps.tsx`
- [Analytics dashboard](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/Analytics.tsx): `frontend/src/pages/Analytics.tsx`
- [Career simulator](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/CareerSimulator.tsx): `frontend/src/pages/CareerSimulator.tsx`
- [Career digital twin](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/DigitalTwin.tsx): `frontend/src/pages/DigitalTwin.tsx`
- [Follow-up views](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/pages/FollowUps.tsx): `frontend/src/pages/FollowUps.tsx`

### Identity and access

- [Auth state](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Authentication API](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`

### Skills and careers

- [Skill gap API](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/skill_gaps.py): `backend/app/routers/skill_gaps.py`
- [Career simulation API](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/career_simulator.py): `backend/app/routers/career_simulator.py`
- [Digital twin API](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/digital_twin.py): `backend/app/routers/digital_twin.py`
- [Gap analysis engine](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/skill_gap_service.py): `backend/app/services/skill_gap_service.py`
- [Evidence skill scoring](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/skill_scoring_service.py): `backend/app/services/skill_scoring_service.py`
- [Skill normalization](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/normalization_service.py): `backend/app/services/normalization_service.py`
- [Job intelligence](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/job_intelligence_service.py): `backend/app/services/job_intelligence_service.py`
- [Resume analysis](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/resume_analyzer_service.py): `backend/app/services/resume_analyzer_service.py`

### Outcomes and interventions

- [Follow-up API](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/follow_ups.py): `backend/app/routers/follow_ups.py`
- [Analytics API](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/analytics.py): `backend/app/routers/analytics.py`
- [Outcome risk engine](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/outcome_risk_service.py): `backend/app/services/outcome_risk_service.py`
- [Intervention engine](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/intervention_service.py): `backend/app/services/intervention_service.py`
- [Employer verification](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/services/employer_verification_service.py): `backend/app/services/employer_verification_service.py`

### API and persistence

- [API client](https://github.com/vigneshb-dev/career_tracker/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Trainee API](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/routers/trainees.py): `backend/app/routers/trainees.py`
- [Domain records](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/models/entities.py): `backend/app/models/entities.py`
- [Relational and vector store](https://github.com/vigneshb-dev/career_tracker/blob/main/backend/app/core/database.py): `backend/app/core/database.py`

### Other components

- **Workforce users**

## Connections

- Workforce users → Route application: uses
- Route application → Auth state: provides auth (evidence: `frontend/src/App.tsx`)
- Route application → Trainee passport: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Skill gap views: routes to (evidence: `frontend/src/App.tsx`)
- Workforce users → Trainee passport: maintains record
- Trainee passport → API client: requests data (evidence: `frontend/src/pages/TraineeDetail.tsx`)
- Skill gap views → API client: requests data (evidence: `frontend/src/pages/SkillGaps.tsx`)
- Auth state → API client: auth calls (evidence: `frontend/src/context/AuthContext.tsx`)
- API client → Authentication API: sends auth requests (evidence: `frontend/src/services/api.ts`)
- API client → Trainee API: sends trainee requests (evidence: `frontend/src/services/api.ts`)
- API client → Follow-up API: sends follow-up requests (evidence: `frontend/src/services/api.ts`)
- API client → Analytics API: requests metrics (evidence: `frontend/src/services/api.ts`)
- API client → Skill gap API: requests gap data
- Route application → Career simulator: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Career digital twin: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Analytics dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Follow-up views: routes to (evidence: `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 (evidence: `backend/app/services/skill_gap_service.py`)
- Gap analysis engine → Skill normalization: matches skills (evidence: `backend/app/services/skill_gap_service.py`)
- Gap analysis engine → Evidence skill scoring: uses evidence scores (evidence: `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 (evidence: `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
