# roshaningershalvr/careercrosswalk architecture

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

## Overview

CareerCrosswalk’s primary workflow uploads a resume, extracts its text, matches skills, ranks O*NET occupations, and presents skills, gaps, readiness, and roadmap results. Jobs and labor-market insights are explicitly demo features; AI chat is optional. The README and excerpts establish the main flow, while some frontend result-rendering and backend internals are unsampled, so those connections are omitted rather than inferred.

Main entry points: [`src/pages/CareerDetail.tsx`](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/pages/CareerDetail.tsx) (Career detail view), [`src/services/aiContextService.ts`](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/aiContextService.ts) (Page context builder), [`src/App.tsx`](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/App.tsx) (Application routes), [`backend/server.py`](https://github.com/roshaningershalvr/careercrosswalk/blob/main/backend/server.py) (FastAPI analysis API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Career app"]
  node_routes["Application routes<br/>[App.tsx]"]
  node_resume_page["Resume upload<br/>[ResumeUpload.tsx]"]
  node_landing["Landing page<br/>[Landing.tsx]"]
  node_page_header["Page header<br/>[PageHeader.tsx]"]
  node_evidence_badge["Evidence badge<br/>[EvidenceBadge.tsx]"]
  node_ui_primitives["UI primitives<br/>[primitives.tsx]"]
end

subgraph group_analysis["Resume analysis"]
  node_resume_service["Resume API client<br/>[resumeService.ts]"]
  node_api["FastAPI analysis API<br/>[server.py]"]
  node_extract["Resume extraction"]
  node_onet[("O*NET knowledge base")]
  node_analysis_store[("Analysis session store<br/>[analysisStore.ts]")]
  node_analysis_types["Analysis result types<br/>[analysis.ts]"]
end

subgraph group_matching["Skill matching"]
  node_pipeline["Workforce pipeline"]
  node_matcher["Hybrid skill matcher<br/>[hybrid_matcher.py]"]
  node_knowledge[("Matcher knowledge base<br/>[knowledge_base.py]")]
  node_scorer["Workforce scorer"]
end

subgraph group_guidance["Career guidance"]
  node_career_data["Occupation profiles<br/>[careers.ts]"]
  node_roadmap_data["Gap and roadmap data<br/>[roadmap.ts]"]
  node_career_detail["Career detail view<br/>[CareerDetail.tsx]"]
  node_demo_jobs["Demo jobs data<br/>[jobs.ts]"]
  node_demo_market["Demo market data<br/>[market.ts]"]
end

subgraph group_assistant["AI assistant"]
  node_ai_provider["AI chat provider<br/>[AIProvider.tsx]"]
  node_ai_context["Page context builder"]
  node_ai_service["Chat service<br/>[aiService.ts]"]
end

node_person(("Career seeker"))
node_gemini["Gemini service"]

node_person -->|"opens app"| node_routes
node_routes -->|"routes to"| node_resume_page
node_resume_page -->|"submits resume"| node_resume_service
node_resume_service -->|"posts analysis"| node_api
node_api -->|"extracts text"| node_extract
node_api -->|"loads knowledge"| node_onet
node_api -->|"runs matching"| node_pipeline
node_pipeline -->|"matches skills"| node_matcher
node_pipeline -->|"loads knowledge"| node_knowledge
node_pipeline -->|"scores results"| node_scorer
node_resume_page -->|"stores session"| node_analysis_store
node_analysis_store -->|"uses session type"| node_analysis_types
node_routes -->|"routes to"| node_career_detail
node_career_detail -->|"reads profiles"| node_career_data
node_career_detail -->|"renders"| node_page_header
node_career_detail -->|"renders"| node_evidence_badge
node_career_detail -->|"renders"| node_ui_primitives
node_routes -->|"routes to"| node_landing
node_ai_provider -->|"builds context"| node_ai_context
node_ai_provider -->|"sends chat"| node_ai_service
node_ai_service -.->|"calls optionally"| node_gemini
node_ai_context -->|"reads careers"| node_career_data
node_ai_context -->|"reads roadmap"| node_roadmap_data
node_ai_context -->|"reads jobs"| node_demo_jobs
node_ai_context -->|"reads market data"| node_demo_market

click node_routes "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/App.tsx"
click node_resume_page "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/pages/ResumeUpload.tsx"
click node_resume_service "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/resumeService.ts"
click node_api "https://github.com/roshaningershalvr/careercrosswalk/blob/main/backend/server.py"
click node_extract "https://github.com/roshaningershalvr/careercrosswalk/blob/main/backend/resume_extractor.py"
click node_onet "https://github.com/roshaningershalvr/careercrosswalk/blob/main/backend/onet_knowledge_base.py"
click node_pipeline "https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/workforce_pipeline.py"
click node_matcher "https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/hybrid_matcher.py"
click node_knowledge "https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/knowledge_base.py"
click node_scorer "https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/workforce_scorer.py"
click node_analysis_store "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/analysisStore.ts"
click node_analysis_types "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/types/analysis.ts"
click node_career_data "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/careers.ts"
click node_roadmap_data "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/roadmap.ts"
click node_career_detail "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/pages/CareerDetail.tsx"
click node_landing "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/pages/Landing.tsx"
click node_page_header "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/shared/PageHeader.tsx"
click node_evidence_badge "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/shared/EvidenceBadge.tsx"
click node_ui_primitives "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/ui/primitives.tsx"
click node_ai_provider "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/ai/AIProvider.tsx"
click node_ai_context "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/aiContextService.ts"
click node_ai_service "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/aiService.ts"
click node_demo_jobs "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/jobs.ts"
click node_demo_market "https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/market.ts"

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_routes,node_resume_page,node_landing,node_page_header,node_evidence_badge,node_ui_primitives toneBlue
class node_resume_service,node_api,node_extract,node_onet,node_analysis_store,node_analysis_types toneAmber
class node_pipeline,node_matcher,node_knowledge,node_scorer toneMint
class node_career_data,node_roadmap_data,node_career_detail,node_demo_jobs,node_demo_market toneRose
class node_ai_provider,node_ai_context,node_ai_service,node_person,node_gemini toneIndigo
```

## Components

### Career app

- [Application routes](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/App.tsx): `src/App.tsx`
- [Resume upload](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/pages/ResumeUpload.tsx): `src/pages/ResumeUpload.tsx`
- [Landing page](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/pages/Landing.tsx): `src/pages/Landing.tsx`
- [Page header](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/shared/PageHeader.tsx): `src/components/shared/PageHeader.tsx`
- [Evidence badge](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/shared/EvidenceBadge.tsx): `src/components/shared/EvidenceBadge.tsx`
- [UI primitives](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/ui/primitives.tsx): `src/components/ui/primitives.tsx`

### Resume analysis

- [Resume API client](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/resumeService.ts): `src/services/resumeService.ts`
- [FastAPI analysis API](https://github.com/roshaningershalvr/careercrosswalk/blob/main/backend/server.py): `backend/server.py`
- [Resume extraction](https://github.com/roshaningershalvr/careercrosswalk/blob/main/backend/resume_extractor.py): `backend/resume_extractor.py`
- [O*NET knowledge base](https://github.com/roshaningershalvr/careercrosswalk/blob/main/backend/onet_knowledge_base.py): `backend/onet_knowledge_base.py`
- [Analysis session store](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/analysisStore.ts): `src/services/analysisStore.ts`
- [Analysis result types](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/types/analysis.ts): `src/types/analysis.ts`

### Skill matching

- [Workforce pipeline](https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/workforce_pipeline.py): `WOS/ml/src/workforce_pipeline.py`
- [Hybrid skill matcher](https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/hybrid_matcher.py): `WOS/ml/src/hybrid_matcher.py`
- [Matcher knowledge base](https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/knowledge_base.py): `WOS/ml/src/knowledge_base.py`
- [Workforce scorer](https://github.com/roshaningershalvr/careercrosswalk/blob/main/WOS/ml/src/workforce_scorer.py): `WOS/ml/src/workforce_scorer.py`

### Career guidance

- [Occupation profiles](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/careers.ts): `src/data/careers.ts`
- [Gap and roadmap data](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/roadmap.ts): `src/data/roadmap.ts`
- [Career detail view](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/pages/CareerDetail.tsx): `src/pages/CareerDetail.tsx`
- [Demo jobs data](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/jobs.ts): `src/data/jobs.ts`
- [Demo market data](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/data/market.ts): `src/data/market.ts`

### AI assistant

- [AI chat provider](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/components/ai/AIProvider.tsx): `src/components/ai/AIProvider.tsx`
- [Page context builder](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/aiContextService.ts): `src/services/aiContextService.ts`
- [Chat service](https://github.com/roshaningershalvr/careercrosswalk/blob/main/src/services/aiService.ts): `src/services/aiService.ts`

### Other components

- **Career seeker**
- **Gemini service**

## Connections

- Career seeker → Application routes: opens app (evidence: `src/App.tsx`)
- Application routes → Resume upload: routes to (evidence: `src/App.tsx`)
- Resume upload → Resume API client: submits resume (evidence: `src/pages/ResumeUpload.tsx`)
- Resume API client → FastAPI analysis API: posts analysis (evidence: `src/services/resumeService.ts`)
- FastAPI analysis API → Resume extraction: extracts text (evidence: `backend/server.py`)
- FastAPI analysis API → O*NET knowledge base: loads knowledge (evidence: `backend/server.py`)
- FastAPI analysis API → Workforce pipeline: runs matching (evidence: `backend/server.py`)
- Workforce pipeline → Hybrid skill matcher: matches skills (evidence: `WOS/ml/src/workforce_pipeline.py`)
- Workforce pipeline → Matcher knowledge base: loads knowledge (evidence: `WOS/ml/src/workforce_pipeline.py`)
- Workforce pipeline → Workforce scorer: scores results (evidence: `WOS/ml/src/workforce_pipeline.py`)
- Resume upload → Analysis session store: stores session (evidence: `src/pages/ResumeUpload.tsx`)
- Analysis session store → Analysis result types: uses session type (evidence: `src/services/analysisStore.ts`)
- Application routes → Career detail view: routes to (evidence: `src/App.tsx`)
- Career detail view → Occupation profiles: reads profiles
- Career detail view → Page header: renders (evidence: `src/pages/CareerDetail.tsx`)
- Career detail view → Evidence badge: renders (evidence: `src/pages/CareerDetail.tsx`)
- Career detail view → UI primitives: renders (evidence: `src/pages/CareerDetail.tsx`)
- Application routes → Landing page: routes to (evidence: `src/App.tsx`)
- AI chat provider → Page context builder: builds context (evidence: `src/components/ai/AIProvider.tsx`)
- AI chat provider → Chat service: sends chat (evidence: `src/components/ai/AIProvider.tsx`)
- Chat service → Gemini service: calls optionally
- Page context builder → Occupation profiles: reads careers (evidence: `src/services/aiContextService.ts`)
- Page context builder → Gap and roadmap data: reads roadmap (evidence: `src/services/aiContextService.ts`)
- Page context builder → Demo jobs data: reads jobs (evidence: `src/services/aiContextService.ts`)
- Page context builder → Demo market data: reads market data (evidence: `src/services/aiContextService.ts`)
