# snehakarn29/pathforgeai architecture

> Architecture diagram of the GitHub repository snehakarn29/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/snehakarn29/pathforgeai
- Repository: https://github.com/snehakarn29/pathforgeai

## Overview

This is a career-intelligence application: users create or import a profile, assess resilience, explore role transitions and skill gaps, then generate a learning roadmap and track progress. The frontend coordinates deterministic analysis and persistence; a separate ML service and training code provide an additional prediction capability. The README is empty, and several pages and integrations were not excerpted, so those connections are omitted or marked unverified rather than inferred.

Main entry points: [`src/App.tsx`](https://github.com/snehakarn29/pathforgeai/blob/main/src/App.tsx) (App Coordinator), [`src/services/storageService.ts`](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/storageService.ts) (Browser Persistence), [`src/services/transitionEngine.ts`](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/transitionEngine.ts) (Transition Analysis), [`src/services/resilienceEngine.ts`](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/resilienceEngine.ts) (Resilience Scoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Career Workspace"]
  node_app["App Coordinator<br/>[App.tsx]"]
  node_onboarding["Profile Onboarding<br/>[OnboardingPage.tsx]"]
  node_profile["Profile Management<br/>[ProfilePage.tsx]"]
  node_workspace["Career Pages"]
  node_progress["Progress Tracking<br/>[ProgressPage.tsx]"]
  node_storage[("Browser Persistence<br/>[storageService.ts]")]
end

subgraph group_analysis["Career Analysis"]
  node_resilience["Resilience Scoring"]
  node_transitions["Transition Analysis"]
  node_normalization["Skill Normalization"]
  node_market["Market Snapshot<br/>[market.ts]"]
end

subgraph group_learning["Learning Planning"]
  node_roadmap["Roadmap Generation<br/>[roadmapService.ts]"]
  node_resources["Learning Resources"]
end

subgraph group_ml["ML Capability"]
  node_mlclient["ML Client<br/>[mlClientService.ts]"]
  node_backend["API Server<br/>[server.ts]"]
  node_mlservice["ML Inference<br/>[service.py]"]
  node_training["Model Training<br/>[train.py]"]
  node_dataset["Dataset Generation"]
end

subgraph group_data["Domain Data"]
  node_taxonomy["Skill Taxonomy<br/>[taxonomy.ts]"]
  node_roles["Target Roles<br/>[targetRoles.ts]"]
end

node_user(("Career Seeker"))

node_user -.->|"creates profile"| node_onboarding
node_app -->|"routes to"| node_onboarding
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_workspace
node_app -->|"routes to"| node_progress
node_onboarding -->|"uses"| node_storage
node_profile -->|"uses"| node_storage
node_app -->|"loads and saves"| node_storage
node_app -->|"calculates"| node_resilience
node_app -->|"calculates"| node_transitions
node_app -->|"generates"| node_roadmap
node_storage -->|"calculates demo score"| node_resilience
node_storage -->|"calculates demo paths"| node_transitions
node_storage -->|"generates demo plan"| node_roadmap
node_transitions -->|"normalizes skills"| node_normalization
node_transitions -->|"scores projections"| node_resilience
node_resilience -->|"normalizes skills"| node_normalization
node_normalization -->|"uses taxonomy"| node_taxonomy
node_transitions -->|"evaluates roles"| node_roles
node_roadmap -->|"uses resources"| node_resources
node_backend -->|"references"| node_mlclient
node_backend -->|"references"| node_taxonomy
node_backend -->|"references"| node_roles
node_mlclient -.->|"requests predictions"| node_mlservice
node_dataset -.->|"feeds training"| node_training
node_training -.->|"supplies model"| node_mlservice

click node_app "https://github.com/snehakarn29/pathforgeai/blob/main/src/App.tsx"
click node_onboarding "https://github.com/snehakarn29/pathforgeai/blob/main/src/pages/OnboardingPage.tsx"
click node_profile "https://github.com/snehakarn29/pathforgeai/blob/main/src/pages/ProfilePage.tsx"
click node_workspace "https://github.com/snehakarn29/pathforgeai/tree/main/src/pages"
click node_progress "https://github.com/snehakarn29/pathforgeai/blob/main/src/pages/ProgressPage.tsx"
click node_storage "https://github.com/snehakarn29/pathforgeai/blob/main/src/services/storageService.ts"
click node_resilience "https://github.com/snehakarn29/pathforgeai/blob/main/src/services/resilienceEngine.ts"
click node_transitions "https://github.com/snehakarn29/pathforgeai/blob/main/src/services/transitionEngine.ts"
click node_normalization "https://github.com/snehakarn29/pathforgeai/blob/main/src/services/skillNormalizationService.ts"
click node_market "https://github.com/snehakarn29/pathforgeai/blob/main/src/types/market.ts"
click node_taxonomy "https://github.com/snehakarn29/pathforgeai/blob/main/src/data/taxonomy.ts"
click node_roles "https://github.com/snehakarn29/pathforgeai/blob/main/src/data/targetRoles.ts"
click node_roadmap "https://github.com/snehakarn29/pathforgeai/blob/main/src/services/roadmapService.ts"
click node_resources "https://github.com/snehakarn29/pathforgeai/blob/main/src/data/verifiedResources.ts"
click node_mlclient "https://github.com/snehakarn29/pathforgeai/blob/main/src/services/mlClientService.ts"
click node_backend "https://github.com/snehakarn29/pathforgeai/blob/main/server.ts"
click node_mlservice "https://github.com/snehakarn29/pathforgeai/blob/main/ml/service.py"
click node_training "https://github.com/snehakarn29/pathforgeai/blob/main/ml/train.py"
click node_dataset "https://github.com/snehakarn29/pathforgeai/blob/main/ml/dataset/generate_dataset.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_workspace,node_progress,node_storage toneBlue
class node_resilience,node_transitions,node_normalization,node_market toneAmber
class node_roadmap,node_resources toneMint
class node_mlclient,node_backend,node_mlservice,node_training,node_dataset toneRose
class node_taxonomy,node_roles,node_user toneIndigo
```

## Components

### Career Workspace

- [App Coordinator](https://github.com/snehakarn29/pathforgeai/blob/main/src/App.tsx): `src/App.tsx`
- [Profile Onboarding](https://github.com/snehakarn29/pathforgeai/blob/main/src/pages/OnboardingPage.tsx): `src/pages/OnboardingPage.tsx`
- [Profile Management](https://github.com/snehakarn29/pathforgeai/blob/main/src/pages/ProfilePage.tsx): `src/pages/ProfilePage.tsx`
- [Career Pages](https://github.com/snehakarn29/pathforgeai/tree/main/src/pages): `src/pages`
- [Progress Tracking](https://github.com/snehakarn29/pathforgeai/blob/main/src/pages/ProgressPage.tsx): `src/pages/ProgressPage.tsx`
- [Browser Persistence](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/storageService.ts): `src/services/storageService.ts`

### Career Analysis

- [Resilience Scoring](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/resilienceEngine.ts): `src/services/resilienceEngine.ts`
- [Transition Analysis](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/transitionEngine.ts): `src/services/transitionEngine.ts`
- [Skill Normalization](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/skillNormalizationService.ts): `src/services/skillNormalizationService.ts`
- [Market Snapshot](https://github.com/snehakarn29/pathforgeai/blob/main/src/types/market.ts): `src/types/market.ts`

### Learning Planning

- [Roadmap Generation](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/roadmapService.ts): `src/services/roadmapService.ts`
- [Learning Resources](https://github.com/snehakarn29/pathforgeai/blob/main/src/data/verifiedResources.ts): `src/data/verifiedResources.ts`

### ML Capability

- [ML Client](https://github.com/snehakarn29/pathforgeai/blob/main/src/services/mlClientService.ts): `src/services/mlClientService.ts`
- [API Server](https://github.com/snehakarn29/pathforgeai/blob/main/server.ts): `server.ts`
- [ML Inference](https://github.com/snehakarn29/pathforgeai/blob/main/ml/service.py): `ml/service.py`
- [Model Training](https://github.com/snehakarn29/pathforgeai/blob/main/ml/train.py): `ml/train.py`
- [Dataset Generation](https://github.com/snehakarn29/pathforgeai/blob/main/ml/dataset/generate_dataset.py): `ml/dataset/generate_dataset.py`

### Domain Data

- [Skill Taxonomy](https://github.com/snehakarn29/pathforgeai/blob/main/src/data/taxonomy.ts): `src/data/taxonomy.ts`
- [Target Roles](https://github.com/snehakarn29/pathforgeai/blob/main/src/data/targetRoles.ts): `src/data/targetRoles.ts`

### Other components

- **Career Seeker**

## Connections

- Career Seeker → Profile Onboarding: creates profile
- App Coordinator → Profile Onboarding: routes to (evidence: `src/App.tsx`)
- App Coordinator → Profile Management: routes to (evidence: `src/App.tsx`)
- App Coordinator → Career Pages: routes to (evidence: `src/App.tsx`)
- App Coordinator → Progress Tracking: routes to (evidence: `src/App.tsx`)
- Profile Onboarding → Browser Persistence: uses (evidence: `src/pages/OnboardingPage.tsx`)
- Profile Management → Browser Persistence: uses (evidence: `src/pages/ProfilePage.tsx`)
- App Coordinator → Browser Persistence: loads and saves (evidence: `src/App.tsx`)
- App Coordinator → Resilience Scoring: calculates (evidence: `src/App.tsx`)
- App Coordinator → Transition Analysis: calculates (evidence: `src/App.tsx`)
- App Coordinator → Roadmap Generation: generates (evidence: `src/App.tsx`)
- Browser Persistence → Resilience Scoring: calculates demo score (evidence: `src/services/storageService.ts`)
- Browser Persistence → Transition Analysis: calculates demo paths (evidence: `src/services/storageService.ts`)
- Browser Persistence → Roadmap Generation: generates demo plan (evidence: `src/services/storageService.ts`)
- Transition Analysis → Skill Normalization: normalizes skills (evidence: `src/services/transitionEngine.ts`)
- Transition Analysis → Resilience Scoring: scores projections (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`)
- Transition Analysis → Target Roles: evaluates roles (evidence: `src/services/transitionEngine.ts`)
- Roadmap Generation → Learning Resources: uses resources (evidence: `src/services/roadmapService.ts`)
- API Server → ML Client: references (evidence: `server.ts`)
- API Server → Skill Taxonomy: references (evidence: `server.ts`)
- API Server → Target Roles: references (evidence: `server.ts`)
- ML Client → ML Inference: requests predictions
- Dataset Generation → Model Training: feeds training
- Model Training → ML Inference: supplies model
