# hameedmulani29/carrerpilot_ai architecture

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

- Interactive diagram: https://gitdiagram.com/hameedmulani29/carrerpilot_ai
- Repository: https://github.com/hameedmulani29/carrerpilot_ai

## Overview

CareerPilot AI guides students from career goals and skills toward structured career guidance, with separate tools for planning, skill-gap review, resume analysis, and job exploration. The backend exposes HTTP routes, proxies several AI workflows to Make.com, and includes SQLite-backed server authentication; the frontend also uses Firebase authentication and Firestore profiles. The README documents Make.com-to-Gemini processing. Some feature pages are present in the tree, but their request wiring was not sampled, so those links are not inferred.

Main entry points: [`Backend/server.js`](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Backend/server.js) (HTTP API server), [`Frontend/main.html`](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/main.html) (App shell), [`Frontend/auth.html`](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/auth.html) (Sign-in and signup), [`Frontend/ttl.html`](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/ttl.html) (Career landing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student_ui["Student experience"]
  node_landing["Career landing<br/>[ttl.html]"]
  node_app_shell["App shell<br/>[main.html]"]
  node_dashboard["Career dashboard<br/>[index.html]"]
  node_auth_ui["Sign-in and signup<br/>[auth.html]"]
end

subgraph group_career_tools["Career guidance tools"]
  node_roadmap["Roadmap planner<br/>[roadmap.html]"]
  node_week_planner["Week-wise planner<br/>[test.html]"]
  node_skill_gap["Skill-gap analysis<br/>[skillGap.html]"]
  node_simulator["Career simulator"]
  node_coach["AI coach<br/>[aiCoach.html]"]
  node_resume["Resume analysis<br/>[resume.html]"]
  node_jobs["Job matching<br/>[jobMatcher.html]"]
end

subgraph group_backend_services["Backend services"]
  node_server["HTTP API server<br/>[server.js]"]
  node_sqlite[("SQLite user store")]
end

subgraph group_identity_ai["Identity and AI services"]
  node_auth_logic["Firebase auth logic<br/>[auth.js]"]
  node_firebase_config["Firebase adapter<br/>[firebase-config.js]"]
  node_firestore[("Firestore profiles")]
  node_make{{"Make.com workflows"}}
  node_gemini{{"Gemini API"}}
end

node_student(("Student"))

node_student -->|"opens"| node_landing
node_student -->|"signs in"| node_auth_ui
node_landing -->|"enters app"| node_app_shell
node_app_shell -->|"loads"| node_dashboard
node_app_shell -->|"loads"| node_roadmap
node_app_shell -->|"loads"| node_week_planner
node_app_shell -->|"loads"| node_skill_gap
node_app_shell -->|"loads"| node_simulator
node_app_shell -->|"loads"| node_jobs
node_auth_ui -->|"uses"| node_auth_logic
node_auth_logic -->|"calls"| node_firebase_config
node_firebase_config -->|"reads/writes"| node_firestore
node_auth_ui -->|"submits credentials"| node_server
node_server -->|"queries"| node_sqlite
node_server -->|"forwards simulation"| node_make
node_server -->|"forwards coach requests"| node_make
node_server -->|"forwards skill-gap files"| node_make
node_server -->|"forwards resume data"| node_make
node_server -->|"requests blueprint"| node_make
node_server -->|"requests weekly plan"| node_make
node_make -.->|"requests AI reasoning"| node_gemini

click node_landing "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/ttl.html"
click node_app_shell "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/main.html"
click node_dashboard "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/index.html"
click node_auth_ui "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/auth.html"
click node_auth_logic "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/js/auth.js"
click node_firebase_config "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/js/firebase-config.js"
click node_server "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Backend/server.js"
click node_roadmap "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/roadmap.html"
click node_week_planner "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/test.html"
click node_skill_gap "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/skillGap.html"
click node_simulator "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/carrerSimulator.html"
click node_coach "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/aiCoach.html"
click node_resume "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/resume.html"
click node_jobs "https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/jobMatcher.html"

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_landing,node_app_shell,node_dashboard,node_auth_ui toneBlue
class node_roadmap,node_week_planner,node_skill_gap,node_simulator,node_coach,node_resume,node_jobs toneAmber
class node_server,node_sqlite toneMint
class node_auth_logic,node_firebase_config,node_firestore,node_make,node_gemini toneRose
class node_student toneIndigo
```

## Components

### Student experience

- [Career landing](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/ttl.html): `Frontend/ttl.html`
- [App shell](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/main.html): `Frontend/main.html`
- [Career dashboard](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/index.html): `Frontend/index.html`
- [Sign-in and signup](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/auth.html): `Frontend/auth.html`

### Career guidance tools

- [Roadmap planner](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/roadmap.html): `Frontend/roadmap.html`
- [Week-wise planner](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/test.html): `Frontend/test.html`
- [Skill-gap analysis](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/skillGap.html): `Frontend/skillGap.html`
- [Career simulator](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/carrerSimulator.html): `Frontend/carrerSimulator.html`
- [AI coach](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/aiCoach.html): `Frontend/aiCoach.html`
- [Resume analysis](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/resume.html): `Frontend/resume.html`
- [Job matching](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/jobMatcher.html): `Frontend/jobMatcher.html`

### Backend services

- [HTTP API server](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Backend/server.js): `Backend/server.js`
- **SQLite user store**

### Identity and AI services

- [Firebase auth logic](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/js/auth.js): `Frontend/js/auth.js`
- [Firebase adapter](https://github.com/hameedmulani29/carrerpilot_ai/blob/main/Frontend/js/firebase-config.js): `Frontend/js/firebase-config.js`
- **Firestore profiles**
- **Make.com workflows**
- **Gemini API**

### Other components

- **Student**

## Connections

- Student → Career landing: opens
- Student → Sign-in and signup: signs in
- Career landing → App shell: enters app
- App shell → Career dashboard: loads
- App shell → Roadmap planner: loads
- App shell → Week-wise planner: loads
- App shell → Skill-gap analysis: loads
- App shell → Career simulator: loads
- App shell → Job matching: loads
- Sign-in and signup → Firebase auth logic: uses
- Firebase auth logic → Firebase adapter: calls
- Firebase adapter → Firestore profiles: reads/writes
- Sign-in and signup → HTTP API server: submits credentials
- HTTP API server → SQLite user store: queries
- HTTP API server → Make.com workflows: forwards simulation
- HTTP API server → Make.com workflows: forwards coach requests
- HTTP API server → Make.com workflows: forwards skill-gap files
- HTTP API server → Make.com workflows: forwards resume data
- HTTP API server → Make.com workflows: requests blueprint
- HTTP API server → Make.com workflows: requests weekly plan
- Make.com workflows → Gemini API: requests AI reasoning