# irfanruddin/northstar-career-portal architecture

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

- Interactive diagram: https://gitdiagram.com/irfanruddin/northstar-career-portal
- Repository: https://github.com/irfanruddin/northstar-career-portal

## Overview

Northstar Career Portal is a job-search and application web portal with candidate accounts and administrative job/application management. Candidates browse jobs, maintain a profile, submit applications with resumes, and review application status; administrators manage job listings and application outcomes. The sampled server entry point mounts separate authentication, jobs, applications, and admin APIs backed by MySQL. The tree and excerpts identify the main UI areas, but most UI-to-API calls and unsampled route behavior cannot be verified, so those links are omitted.

Main entry points: [`server/routes/adminRoutes.js`](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/adminRoutes.js) (Admin jobs and applications), [`server/config/db.js`](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/config/db.js) (MySQL connection pool), [`server/server.js`](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/server.js) (API server), [`server/routes/authRoutes.js`](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/authRoutes.js) (Authentication and profile API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_candidate["Candidate experience"]
  node_home["Home<br/>[home.js]"]
  node_job_browse["Job browsing<br/>[jobs.js]"]
  node_job_detail["Job details<br/>[job-details.js]"]
  node_registration["Registration<br/>[register.js]"]
  node_sign_in["Sign in<br/>[login.js]"]
  node_profile["Candidate profile<br/>[profile.js]"]
  node_application_form["Application submission<br/>[apply.js]"]
  node_my_applications["My applications<br/>[applications.js]"]
  node_dashboard["Candidate dashboard<br/>[dashboard.js]"]
  node_shared_ui["Shared UI and auth<br/>[common.js]"]
end

subgraph group_admin["Administration"]
  node_admin_ui["Admin console<br/>[admin.js]"]
end

subgraph group_api["API and access control"]
  node_api_server["API server<br/>[server.js]"]
  node_auth_api["Authentication and profile API<br/>[authRoutes.js]"]
  node_auth_guard["Token authentication<br/>[authMiddleware.js]"]
  node_admin_guard["Admin authorization<br/>[adminMiddleware.js]"]
  node_jobs_api["Jobs API<br/>[jobsRoutes.js]"]
  node_applications_api["Applications API"]
  node_admin_api["Admin jobs and applications<br/>[adminRoutes.js]"]
end

subgraph group_data["Persistence"]
  node_mysql_pool["MySQL connection pool<br/>[db.js]"]
  node_mysql[("MySQL database")]
end

node_visitor(("Candidate or admin"))

node_visitor -->|"uses"| node_home
node_api_server -->|"mounts"| node_auth_api
node_api_server -->|"mounts"| node_jobs_api
node_api_server -->|"mounts"| node_applications_api
node_api_server -->|"mounts"| node_admin_api
node_shared_ui -->|"requests current user"| node_auth_api
node_my_applications -->|"fetches applications"| node_applications_api
node_admin_ui -->|"requests admin data"| node_admin_api
node_auth_api -->|"queries"| node_mysql_pool
node_jobs_api -->|"queries"| node_mysql_pool
node_applications_api -->|"queries"| node_mysql_pool
node_admin_api -->|"queries"| node_mysql_pool
node_mysql_pool -->|"connects"| node_mysql
node_auth_api -->|"uses on protected routes"| node_auth_guard
node_applications_api -->|"protects routes"| node_auth_guard
node_admin_api -->|"authenticates requests"| node_auth_guard
node_admin_api -->|"checks admin role"| node_admin_guard

click node_home "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/home.js"
click node_job_browse "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/jobs.js"
click node_job_detail "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/job-details.js"
click node_registration "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/register.js"
click node_sign_in "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/login.js"
click node_profile "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/profile.js"
click node_application_form "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/apply.js"
click node_my_applications "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/applications.js"
click node_dashboard "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/dashboard.js"
click node_shared_ui "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/common.js"
click node_admin_ui "https://github.com/irfanruddin/northstar-career-portal/blob/master/js/admin.js"
click node_api_server "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/server.js"
click node_auth_api "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/authRoutes.js"
click node_auth_guard "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/middleware/authMiddleware.js"
click node_admin_guard "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/middleware/adminMiddleware.js"
click node_jobs_api "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/jobsRoutes.js"
click node_applications_api "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/applicationsRoutes.js"
click node_admin_api "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/adminRoutes.js"
click node_mysql_pool "https://github.com/irfanruddin/northstar-career-portal/blob/master/server/config/db.js"

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_home,node_job_browse,node_job_detail,node_registration,node_sign_in,node_profile,node_application_form,node_my_applications,node_dashboard,node_shared_ui toneBlue
class node_admin_ui toneAmber
class node_api_server,node_auth_api,node_auth_guard,node_admin_guard,node_jobs_api,node_applications_api,node_admin_api toneMint
class node_mysql_pool,node_mysql toneRose
class node_visitor toneIndigo
```

## Components

### Candidate experience

- [Home](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/home.js): `js/home.js`
- [Job browsing](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/jobs.js): `js/jobs.js`
- [Job details](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/job-details.js): `js/job-details.js`
- [Registration](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/register.js): `js/register.js`
- [Sign in](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/login.js): `js/login.js`
- [Candidate profile](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/profile.js): `js/profile.js`
- [Application submission](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/apply.js): `js/apply.js`
- [My applications](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/applications.js): `js/applications.js`
- [Candidate dashboard](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/dashboard.js): `js/dashboard.js`
- [Shared UI and auth](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/common.js): `js/common.js`

### Administration

- [Admin console](https://github.com/irfanruddin/northstar-career-portal/blob/master/js/admin.js): `js/admin.js`

### API and access control

- [API server](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/server.js): `server/server.js`
- [Authentication and profile API](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Token authentication](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Admin authorization](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/middleware/adminMiddleware.js): `server/middleware/adminMiddleware.js`
- [Jobs API](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/jobsRoutes.js): `server/routes/jobsRoutes.js`
- [Applications API](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/applicationsRoutes.js): `server/routes/applicationsRoutes.js`
- [Admin jobs and applications](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/routes/adminRoutes.js): `server/routes/adminRoutes.js`

### Persistence

- [MySQL connection pool](https://github.com/irfanruddin/northstar-career-portal/blob/master/server/config/db.js): `server/config/db.js`
- **MySQL database**

### Other components

- **Candidate or admin**

## Connections

- Candidate or admin → Home: uses
- API server → Authentication and profile API: mounts (evidence: `server/server.js`)
- API server → Jobs API: mounts (evidence: `server/server.js`)
- API server → Applications API: mounts (evidence: `server/server.js`)
- API server → Admin jobs and applications: mounts (evidence: `server/server.js`)
- Shared UI and auth → Authentication and profile API: requests current user (evidence: `js/common.js`)
- My applications → Applications API: fetches applications (evidence: `js/applications.js`)
- Admin console → Admin jobs and applications: requests admin data (evidence: `js/admin.js`)
- Authentication and profile API → MySQL connection pool: queries (evidence: `server/routes/authRoutes.js`)
- Jobs API → MySQL connection pool: queries (evidence: `server/routes/jobsRoutes.js`)
- Applications API → MySQL connection pool: queries (evidence: `server/routes/applicationsRoutes.js`)
- Admin jobs and applications → MySQL connection pool: queries (evidence: `server/routes/adminRoutes.js`)
- MySQL connection pool → MySQL database: connects (evidence: `server/config/db.js`)
- Authentication and profile API → Token authentication: uses on protected routes (evidence: `server/routes/authRoutes.js`)
- Applications API → Token authentication: protects routes (evidence: `server/routes/applicationsRoutes.js`)
- Admin jobs and applications → Token authentication: authenticates requests (evidence: `server/routes/adminRoutes.js`)
- Admin jobs and applications → Admin authorization: checks admin role (evidence: `server/routes/adminRoutes.js`)
