# cmd-jebi/careerpath-ai-fullstack architecture

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

- Interactive diagram: https://gitdiagram.com/cmd-jebi/careerpath-ai-fullstack
- Repository: https://github.com/cmd-jebi/careerpath-ai-fullstack

## Overview

CareerPath AI is a Philippine senior-high-school guidance tool. A student uses the career-track page to load the O*NET interest checklist, enter grades and interests, and request pathway recommendations; the app returns suggested tracks, clusters, and next steps, which the page displays and can export as a PDF. The backend also serves cluster and institution reference data and uses Gemini for recommendation generation. Evidence is limited to the README (empty) and the supplied source excerpts; the recommendation request’s exact frontend route is not visible, so that link is marked unverified.

Main entry points: [`backend/app.py`](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/app.py) (Recommendation generation), [`frontend/careerTrack.html`](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/careerTrack.html) (Career track page), [`frontend/script.js`](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/script.js) (Recommendation form), [`backend/data.py`](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/data.py) (Track and cluster guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Guidance experience"]
  node_career_page["Career track page<br/>[careerTrack.html]"]
  node_profile_ui["Interest profiling<br/>[script.js]"]
  node_pathway_ui["Recommendation form<br/>[script.js]"]
  node_results_ui["Results and PDF<br/>[script.js]"]
end

subgraph group_service["Recommendation service"]
  node_api["Flask API<br/>[app.py]"]
  node_question_endpoint["Checklist endpoint<br/>[app.py]"]
  node_recommendation_endpoint["Recommendation generation<br/>[app.py]"]
end

subgraph group_catalog["Guidance knowledge"]
  node_onet_questions["O*NET questions<br/>[data.py]"]
  node_pathway_catalog["Track and cluster guidance<br/>[data.py]"]
  node_institution_catalog["Institution suggestions<br/>[data.py]"]
end

node_student(("Student"))
node_gemini{{"Gemini service"}}

node_student -->|"uses"| node_career_page
node_career_page -->|"hosts"| node_profile_ui
node_career_page -->|"hosts"| node_pathway_ui
node_pathway_ui -->|"displays results"| node_results_ui
node_profile_ui -->|"loads checklist"| node_question_endpoint
node_pathway_ui -.->|"requests recommendations"| node_recommendation_endpoint
node_api -->|"routes"| node_question_endpoint
node_api -->|"routes"| node_recommendation_endpoint
node_question_endpoint -->|"returns questions"| node_onet_questions
node_question_endpoint -->|"returns attribution"| node_pathway_catalog
node_recommendation_endpoint -->|"generates content"| node_gemini
node_recommendation_endpoint -->|"imports guidance"| node_pathway_catalog
node_recommendation_endpoint -->|"imports institutions"| node_institution_catalog

click node_career_page "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/careerTrack.html"
click node_profile_ui "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/script.js"
click node_pathway_ui "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/script.js"
click node_results_ui "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/script.js"
click node_api "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/app.py"
click node_question_endpoint "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/app.py"
click node_recommendation_endpoint "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/app.py"
click node_onet_questions "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/data.py"
click node_pathway_catalog "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/data.py"
click node_institution_catalog "https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/data.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_career_page,node_profile_ui,node_pathway_ui,node_results_ui toneBlue
class node_api,node_question_endpoint,node_recommendation_endpoint toneAmber
class node_onet_questions,node_pathway_catalog,node_institution_catalog toneMint
class node_student,node_gemini toneIndigo
```

## Components

### Guidance experience

- [Career track page](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/careerTrack.html): `frontend/careerTrack.html`
- [Interest profiling](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/script.js): `frontend/script.js`
- [Recommendation form](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/script.js): `frontend/script.js`
- [Results and PDF](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/frontend/script.js): `frontend/script.js`

### Recommendation service

- [Flask API](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/app.py): `backend/app.py`
- [Checklist endpoint](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/app.py): `backend/app.py`
- [Recommendation generation](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/app.py): `backend/app.py`

### Guidance knowledge

- [O*NET questions](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/data.py): `backend/data.py`
- [Track and cluster guidance](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/data.py): `backend/data.py`
- [Institution suggestions](https://github.com/cmd-jebi/careerpath-ai-fullstack/blob/main/backend/data.py): `backend/data.py`

### Other components

- **Student**
- **Gemini service**

## Connections

- Student → Career track page: uses
- Career track page → Interest profiling: hosts
- Career track page → Recommendation form: hosts
- Recommendation form → Results and PDF: displays results (evidence: `frontend/script.js`)
- Interest profiling → Checklist endpoint: loads checklist (evidence: `frontend/script.js`)
- Recommendation form → Recommendation generation: requests recommendations
- Flask API → Checklist endpoint: routes (evidence: `backend/app.py`)
- Flask API → Recommendation generation: routes (evidence: `backend/app.py`)
- Checklist endpoint → O*NET questions: returns questions (evidence: `backend/app.py`)
- Checklist endpoint → Track and cluster guidance: returns attribution (evidence: `backend/app.py`)
- Recommendation generation → Gemini service: generates content (evidence: `backend/app.py`)
- Recommendation generation → Track and cluster guidance: imports guidance (evidence: `backend/app.py`)
- Recommendation generation → Institution suggestions: imports institutions (evidence: `backend/app.py`)
