# pratham-mishra225/northstar architecture

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

- Interactive diagram: https://gitdiagram.com/pratham-mishra225/northstar
- Repository: https://github.com/pratham-mishra225/northstar

## Overview

AI Career Advisor is a browser-based career-readiness platform. A candidate uploads a resume, the browser extracts its text, and the career API evaluates skills, role readiness, ATS criteria, and hybrid job matches; the results and opportunity activity are persisted in MongoDB. The graph includes the documented dashboard, reports, job browsing, and tracking capabilities. Several page and service implementations were not sampled, so documented connections are labeled with README evidence; unsampled implementation details are not inferred.

Main entry points: [`artifacts/api-server/src/app.ts`](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/app.ts) (Express API), [`artifacts/career-advisor/src/App.tsx`](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/App.tsx) (SPA routing), [`artifacts/api-server/src/services/career-analysis.ts`](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/career-analysis.ts) (Career analysis), [`artifacts/api-server/src/routes/index.ts`](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/index.ts) (API router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Career Advisor Client"]
  node_app["SPA routing<br/>[App.tsx]"]
  node_analyze["Resume analysis<br/>[Analyze.tsx]"]
  node_browser_extract["Browser extraction<br/>[Analyze.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_job_browse["Job browsing<br/>[Jobs.tsx]"]
  node_job_detail["Job detail<br/>[JobDetail.tsx]"]
  node_reports_ui["Reports view<br/>[Reports.tsx]"]
  node_activity_local["Activity storage<br/>[activityStorage.ts]"]
end

subgraph group_api["HTTP API"]
  node_api_server["Express API<br/>[app.ts]"]
  node_api_routes["API router<br/>[index.ts]"]
  node_career_routes["Career routes<br/>[career.ts]"]
  node_jobs_routes["Jobs routes<br/>[jobs.ts]"]
  node_activity_routes["Activity routes<br/>[activity.ts]"]
end

subgraph group_domain["Career Evaluation"]
  node_analysis["Career analysis<br/>[career-analysis.ts]"]
  node_taxonomy["Skill and role data<br/>[career-data.ts]"]
  node_interaction_service["Interaction service"]
  node_reports_service["Reports service<br/>[reports.ts]"]
  node_user_service["Demo user service<br/>[userService.ts]"]
end

subgraph group_data["Persistent Data"]
  node_repositories["Mongo repositories"]
  node_mongodb["MongoDB connection<br/>[mongodb.ts]"]
end

node_candidate(("Candidate"))
node_atlas[("MongoDB Atlas")]

node_candidate -->|"uses"| node_app
node_app -->|"routes to"| node_analyze
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_job_browse
node_app -->|"routes to"| node_job_detail
node_app -->|"routes to"| node_reports_ui
node_analyze -->|"extracts text"| node_browser_extract
node_analyze -->|"sends analysis"| node_api_server
node_dashboard -.->|"requests data"| node_api_server
node_job_browse -.->|"requests listings"| node_api_server
node_job_detail -.->|"requests job data"| node_api_server
node_job_detail -.->|"records activity"| node_activity_local
node_reports_ui -.->|"requests reports"| node_api_server
node_api_server -->|"mounts at /api"| node_api_routes
node_api_routes -->|"registers"| node_career_routes
node_api_routes -->|"registers"| node_jobs_routes
node_api_routes -->|"registers"| node_activity_routes
node_career_routes -->|"calls"| node_analysis
node_jobs_routes -->|"calls"| node_analysis
node_analysis -->|"matches skills"| node_taxonomy
node_analysis -->|"reads and saves"| node_repositories
node_analysis -->|"gets user"| node_user_service
node_jobs_routes -->|"reads jobs and roles"| node_repositories
node_activity_routes -.->|"dispatches activity"| node_interaction_service
node_interaction_service -->|"records interactions"| node_repositories
node_interaction_service -->|"gets user"| node_user_service
node_reports_ui -.->|"requests report data"| node_reports_service
node_repositories -->|"gets database"| node_mongodb
node_mongodb -->|"connects"| node_atlas
node_activity_local -.->|"persists tracking"| node_api_server

click node_app "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/App.tsx"
click node_analyze "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Analyze.tsx"
click node_browser_extract "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Analyze.tsx"
click node_dashboard "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Dashboard.tsx"
click node_job_browse "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Jobs.tsx"
click node_job_detail "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/JobDetail.tsx"
click node_reports_ui "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Reports.tsx"
click node_activity_local "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/services/activityStorage.ts"
click node_api_server "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/app.ts"
click node_api_routes "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/index.ts"
click node_career_routes "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/career.ts"
click node_jobs_routes "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/jobs.ts"
click node_activity_routes "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/activity.ts"
click node_analysis "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/career-analysis.ts"
click node_taxonomy "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/data/career-data.ts"
click node_interaction_service "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/interactionService.ts"
click node_reports_service "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/reports.ts"
click node_user_service "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/userService.ts"
click node_repositories "https://github.com/pratham-mishra225/northstar/tree/main/artifacts/api-server/src/repositories"
click node_mongodb "https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/db/mongodb.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_app,node_analyze,node_browser_extract,node_dashboard,node_job_browse,node_job_detail,node_reports_ui,node_activity_local toneBlue
class node_api_server,node_api_routes,node_career_routes,node_jobs_routes,node_activity_routes,node_atlas toneAmber
class node_analysis,node_taxonomy,node_interaction_service,node_reports_service,node_user_service toneMint
class node_repositories,node_mongodb toneRose
class node_candidate toneIndigo
```

## Components

### Career Advisor Client

- [SPA routing](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/App.tsx): `artifacts/career-advisor/src/App.tsx`
- [Resume analysis](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Analyze.tsx): `artifacts/career-advisor/src/pages/Analyze.tsx`
- [Browser extraction](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Analyze.tsx): `artifacts/career-advisor/src/pages/Analyze.tsx`
- [Dashboard](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Dashboard.tsx): `artifacts/career-advisor/src/pages/Dashboard.tsx`
- [Job browsing](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Jobs.tsx): `artifacts/career-advisor/src/pages/Jobs.tsx`
- [Job detail](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/JobDetail.tsx): `artifacts/career-advisor/src/pages/JobDetail.tsx`
- [Reports view](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/pages/Reports.tsx): `artifacts/career-advisor/src/pages/Reports.tsx`
- [Activity storage](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/career-advisor/src/services/activityStorage.ts): `artifacts/career-advisor/src/services/activityStorage.ts`

### HTTP API

- [Express API](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [API router](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Career routes](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/career.ts): `artifacts/api-server/src/routes/career.ts`
- [Jobs routes](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/jobs.ts): `artifacts/api-server/src/routes/jobs.ts`
- [Activity routes](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/routes/activity.ts): `artifacts/api-server/src/routes/activity.ts`

### Career Evaluation

- [Career analysis](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/career-analysis.ts): `artifacts/api-server/src/services/career-analysis.ts`
- [Skill and role data](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/data/career-data.ts): `artifacts/api-server/src/data/career-data.ts`
- [Interaction service](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/interactionService.ts): `artifacts/api-server/src/services/interactionService.ts`
- [Reports service](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/reports.ts): `artifacts/api-server/src/services/reports.ts`
- [Demo user service](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/services/userService.ts): `artifacts/api-server/src/services/userService.ts`

### Persistent Data

- [Mongo repositories](https://github.com/pratham-mishra225/northstar/tree/main/artifacts/api-server/src/repositories): `artifacts/api-server/src/repositories`
- [MongoDB connection](https://github.com/pratham-mishra225/northstar/blob/main/artifacts/api-server/src/db/mongodb.ts): `artifacts/api-server/src/db/mongodb.ts`

### Other components

- **Candidate**
- **MongoDB Atlas**

## Connections

- Candidate → SPA routing: uses
- SPA routing → Resume analysis: routes to (evidence: `artifacts/career-advisor/src/App.tsx`)
- SPA routing → Dashboard: routes to (evidence: `artifacts/career-advisor/src/App.tsx`)
- SPA routing → Job browsing: routes to (evidence: `artifacts/career-advisor/src/App.tsx`)
- SPA routing → Job detail: routes to (evidence: `artifacts/career-advisor/src/App.tsx`)
- SPA routing → Reports view: routes to (evidence: `artifacts/career-advisor/src/App.tsx`)
- Resume analysis → Browser extraction: extracts text
- Resume analysis → Express API: sends analysis
- Dashboard → Express API: requests data
- Job browsing → Express API: requests listings
- Job detail → Express API: requests job data
- Job detail → Activity storage: records activity
- Reports view → Express API: requests reports
- Express API → API router: mounts at /api (evidence: `artifacts/api-server/src/app.ts`)
- API router → Career routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- API router → Jobs routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- API router → Activity routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Career routes → Career analysis: calls (evidence: `artifacts/api-server/src/routes/career.ts`)
- Jobs routes → Career analysis: calls (evidence: `artifacts/api-server/src/routes/jobs.ts`)
- Career analysis → Skill and role data: matches skills (evidence: `artifacts/api-server/src/services/career-analysis.ts`)
- Career analysis → Mongo repositories: reads and saves (evidence: `artifacts/api-server/src/services/career-analysis.ts`)
- Career analysis → Demo user service: gets user (evidence: `artifacts/api-server/src/services/career-analysis.ts`)
- Jobs routes → Mongo repositories: reads jobs and roles (evidence: `artifacts/api-server/src/routes/jobs.ts`)
- Activity routes → Interaction service: dispatches activity
- Interaction service → Mongo repositories: records interactions (evidence: `artifacts/api-server/src/services/interactionService.ts`)
- Interaction service → Demo user service: gets user (evidence: `artifacts/api-server/src/services/interactionService.ts`)
- Reports view → Reports service: requests report data
- Mongo repositories → MongoDB connection: gets database (evidence: `artifacts/api-server/src/repositories/jobRepository.ts`)
- MongoDB connection → MongoDB Atlas: connects (evidence: `artifacts/api-server/src/db/mongodb.ts`)
- Activity storage → Express API: persists tracking
