# kabirchugh82/pathforgeai architecture

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

- Interactive diagram: https://gitdiagram.com/kabirchugh82/pathforgeai
- Repository: https://github.com/kabirchugh82/pathforgeai

## Overview

PathForge is a career-transition planning application. Users enter or import a profile, analyze skills and resilience, compare target-role transitions, and generate a learning roadmap; the UI also exposes progress, simulation, evaluation, settings, and command-center views. The frontend coordinates deterministic analysis and browser-local persistence, while a separate ML service supports readiness predictions. Edges reflect shown App orchestration, service calls, and indexed imports; unsampled pages and server internals are included only where their role is supported, with uncertain links omitted.

Main entry points: [`src/App.tsx`](https://github.com/kabirchugh82/pathforgeai/blob/main/src/App.tsx) (Application coordinator), [`src/services/transitionEngine.ts`](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/transitionEngine.ts) (Transition analysis), [`ml/service.py`](https://github.com/kabirchugh82/pathforgeai/blob/main/ml/service.py) (ML prediction service), [`src/services/resilienceEngine.ts`](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/resilienceEngine.ts) (Resilience scoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Career Workspace"]
  node_app["Application coordinator<br/>[App.tsx]"]
  node_onboarding["Profile onboarding<br/>[OnboardingPage.tsx]"]
  node_profile["Profile editor<br/>[ProfilePage.tsx]"]
  node_command["Command center"]
  node_skills["Skills workspace<br/>[SkillsPage.tsx]"]
  node_progress["Progress tracking<br/>[ProgressPage.tsx]"]
  node_simulator["Career simulator<br/>[SimulatorPage.tsx]"]
  node_evaluation["System evaluation<br/>[EvaluationPage.tsx]"]
end

subgraph group_analysis["Career Analysis"]
  node_resilience_page["Resilience view<br/>[ResiliencePage.tsx]"]
  node_resilience["Resilience scoring"]
  node_taxonomy["Skill taxonomy<br/>[taxonomy.ts]"]
  node_normalization["Skill normalization"]
end

subgraph group_planning["Transition Planning"]
  node_career_paths["Career paths"]
  node_transitions["Transition analysis"]
  node_target_roles["Target roles<br/>[targetRoles.ts]"]
  node_roadmap_page["Learning roadmap<br/>[RoadmapPage.tsx]"]
  node_roadmap_service["Roadmap generation<br/>[roadmapService.ts]"]
  node_resources["Verified learning resources"]
end

subgraph group_platform["Data and ML"]
  node_storage[("Browser persistence<br/>[storageService.ts]")]
  node_market["Market API server<br/>[server.ts]"]
  node_ml_client["ML client<br/>[mlClientService.ts]"]
  node_ml_service["ML prediction service<br/>[service.py]"]
  node_ml_data["Training data generation"]
  node_ml_training["Model training<br/>[train.py]"]
end

node_user(("Career user"))
node_market_provider(("Market data provider"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_onboarding
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_command
node_app -->|"routes to"| node_skills
node_app -->|"routes to"| node_progress
node_app -->|"routes to"| node_simulator
node_app -->|"routes to"| node_evaluation
node_app -->|"routes to"| node_resilience_page
node_app -->|"routes to"| node_career_paths
node_app -->|"routes to"| node_roadmap_page
node_app -->|"loads and saves"| node_storage
node_app -->|"calculates"| node_resilience
node_app -->|"calculates"| node_transitions
node_app -->|"generates"| node_roadmap_service
node_transitions -->|"scores projections"| node_resilience
node_transitions -->|"normalizes skills"| node_normalization
node_transitions -->|"evaluates roles"| node_target_roles
node_resilience -->|"normalizes skills"| node_normalization
node_normalization -->|"uses taxonomy"| node_taxonomy
node_roadmap_service -->|"selects resources"| node_resources
node_career_paths -.->|"requests readiness"| node_ml_client
node_ml_client -.->|"requests predictions"| node_ml_service
node_ml_service -.->|"uses generated data"| node_ml_data
node_ml_service -.->|"uses trained model"| node_ml_training
node_market_provider -.->|"supplies listings"| node_market
node_app -->|"checks status"| node_market

click node_app "https://github.com/kabirchugh82/pathforgeai/blob/main/src/App.tsx"
click node_onboarding "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/OnboardingPage.tsx"
click node_profile "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/ProfilePage.tsx"
click node_command "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/CommandCenterPage.tsx"
click node_skills "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/SkillsPage.tsx"
click node_progress "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/ProgressPage.tsx"
click node_simulator "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/SimulatorPage.tsx"
click node_evaluation "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/EvaluationPage.tsx"
click node_resilience_page "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/ResiliencePage.tsx"
click node_resilience "https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/resilienceEngine.ts"
click node_taxonomy "https://github.com/kabirchugh82/pathforgeai/blob/main/src/data/taxonomy.ts"
click node_normalization "https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/skillNormalizationService.ts"
click node_career_paths "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/CareerPathsPage.tsx"
click node_transitions "https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/transitionEngine.ts"
click node_target_roles "https://github.com/kabirchugh82/pathforgeai/blob/main/src/data/targetRoles.ts"
click node_roadmap_page "https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/RoadmapPage.tsx"
click node_roadmap_service "https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/roadmapService.ts"
click node_resources "https://github.com/kabirchugh82/pathforgeai/blob/main/src/data/verifiedResources.ts"
click node_storage "https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/storageService.ts"
click node_market "https://github.com/kabirchugh82/pathforgeai/blob/main/server.ts"
click node_ml_client "https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/mlClientService.ts"
click node_ml_service "https://github.com/kabirchugh82/pathforgeai/blob/main/ml/service.py"
click node_ml_data "https://github.com/kabirchugh82/pathforgeai/blob/main/ml/dataset/generate_dataset.py"
click node_ml_training "https://github.com/kabirchugh82/pathforgeai/blob/main/ml/train.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_onboarding,node_profile,node_command,node_skills,node_progress,node_simulator,node_evaluation,node_user toneBlue
class node_resilience_page,node_resilience,node_taxonomy,node_normalization toneAmber
class node_career_paths,node_transitions,node_target_roles,node_roadmap_page,node_roadmap_service,node_resources toneMint
class node_storage,node_market,node_ml_client,node_ml_service,node_ml_data,node_ml_training toneRose
class node_market_provider toneIndigo
```

## Components

### Career Workspace

- [Application coordinator](https://github.com/kabirchugh82/pathforgeai/blob/main/src/App.tsx): `src/App.tsx`
- [Profile onboarding](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/OnboardingPage.tsx): `src/pages/OnboardingPage.tsx`
- [Profile editor](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/ProfilePage.tsx): `src/pages/ProfilePage.tsx`
- [Command center](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/CommandCenterPage.tsx): `src/pages/CommandCenterPage.tsx`
- [Skills workspace](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/SkillsPage.tsx): `src/pages/SkillsPage.tsx`
- [Progress tracking](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/ProgressPage.tsx): `src/pages/ProgressPage.tsx`
- [Career simulator](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/SimulatorPage.tsx): `src/pages/SimulatorPage.tsx`
- [System evaluation](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/EvaluationPage.tsx): `src/pages/EvaluationPage.tsx`

### Career Analysis

- [Resilience view](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/ResiliencePage.tsx): `src/pages/ResiliencePage.tsx`
- [Resilience scoring](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/resilienceEngine.ts): `src/services/resilienceEngine.ts`
- [Skill taxonomy](https://github.com/kabirchugh82/pathforgeai/blob/main/src/data/taxonomy.ts): `src/data/taxonomy.ts`
- [Skill normalization](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/skillNormalizationService.ts): `src/services/skillNormalizationService.ts`

### Transition Planning

- [Career paths](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/CareerPathsPage.tsx): `src/pages/CareerPathsPage.tsx`
- [Transition analysis](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/transitionEngine.ts): `src/services/transitionEngine.ts`
- [Target roles](https://github.com/kabirchugh82/pathforgeai/blob/main/src/data/targetRoles.ts): `src/data/targetRoles.ts`
- [Learning roadmap](https://github.com/kabirchugh82/pathforgeai/blob/main/src/pages/RoadmapPage.tsx): `src/pages/RoadmapPage.tsx`
- [Roadmap generation](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/roadmapService.ts): `src/services/roadmapService.ts`
- [Verified learning resources](https://github.com/kabirchugh82/pathforgeai/blob/main/src/data/verifiedResources.ts): `src/data/verifiedResources.ts`

### Data and ML

- [Browser persistence](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/storageService.ts): `src/services/storageService.ts`
- [Market API server](https://github.com/kabirchugh82/pathforgeai/blob/main/server.ts): `server.ts`
- [ML client](https://github.com/kabirchugh82/pathforgeai/blob/main/src/services/mlClientService.ts): `src/services/mlClientService.ts`
- [ML prediction service](https://github.com/kabirchugh82/pathforgeai/blob/main/ml/service.py): `ml/service.py`
- [Training data generation](https://github.com/kabirchugh82/pathforgeai/blob/main/ml/dataset/generate_dataset.py): `ml/dataset/generate_dataset.py`
- [Model training](https://github.com/kabirchugh82/pathforgeai/blob/main/ml/train.py): `ml/train.py`

### Other components

- **Career user**
- **Market data provider**

## Connections

- Career user → Application coordinator: uses
- Application coordinator → Profile onboarding: routes to (evidence: `src/App.tsx`)
- Application coordinator → Profile editor: routes to (evidence: `src/App.tsx`)
- Application coordinator → Command center: routes to (evidence: `src/App.tsx`)
- Application coordinator → Skills workspace: routes to (evidence: `src/App.tsx`)
- Application coordinator → Progress tracking: routes to (evidence: `src/App.tsx`)
- Application coordinator → Career simulator: routes to (evidence: `src/App.tsx`)
- Application coordinator → System evaluation: routes to (evidence: `src/App.tsx`)
- Application coordinator → Resilience view: routes to (evidence: `src/App.tsx`)
- Application coordinator → Career paths: routes to (evidence: `src/App.tsx`)
- Application coordinator → Learning roadmap: routes to (evidence: `src/App.tsx`)
- Application coordinator → Browser persistence: loads and saves (evidence: `src/App.tsx`)
- Application coordinator → Resilience scoring: calculates (evidence: `src/App.tsx`)
- Application coordinator → Transition analysis: calculates (evidence: `src/App.tsx`)
- Application coordinator → Roadmap generation: generates (evidence: `src/App.tsx`)
- Transition analysis → Resilience scoring: scores projections (evidence: `src/services/transitionEngine.ts`)
- Transition analysis → Skill normalization: normalizes skills (evidence: `src/services/transitionEngine.ts`)
- Transition analysis → Target roles: evaluates roles (evidence: `src/services/transitionEngine.ts`)
- Resilience scoring → Skill normalization: normalizes skills (evidence: `src/services/resilienceEngine.ts`)
- Skill normalization → Skill taxonomy: uses taxonomy (evidence: `src/services/skillNormalizationService.ts`)
- Roadmap generation → Verified learning resources: selects resources (evidence: `src/services/roadmapService.ts`)
- Career paths → ML client: requests readiness
- ML client → ML prediction service: requests predictions
- ML prediction service → Training data generation: uses generated data
- ML prediction service → Model training: uses trained model
- Market data provider → Market API server: supplies listings
- Application coordinator → Market API server: checks status (evidence: `src/App.tsx`)
