# laykimhoung/careerlens architecture

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

- Interactive diagram: https://gitdiagram.com/laykimhoung/careerlens
- Repository: https://github.com/laykimhoung/careerlens

## Overview

CareerLens is an applicant-tracking system: candidates discover jobs and submit applications; employers publish openings and manage applicants through status changes, interviews, and offers, while administrators oversee platform records and verification. The React client provides role-specific workspaces and calls a Django REST API backed by PostgreSQL. The sampled application API confirms role-aware application, interview, and offer operations; the README documents the broader ATS purpose. Many client pages and backend endpoints are unsampled, so those capabilities are shown as documented subsystem scope without speculative call-level links.

Main entry points: [`backend/config/urls.py`](https://github.com/laykimhoung/careerlens/blob/main/backend/config/urls.py) (API routing), [`frontend/src/routes/AppRoutes.jsx`](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/routes/AppRoutes.jsx) (Role-based routes), [`frontend/src/services/api.js`](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/services/api.js) (HTTP API client), [`backend/apps/applications/views.py`](https://github.com/laykimhoung/careerlens/blob/main/backend/apps/applications/views.py) (Application operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_frontend["React application<br/>[App.jsx]"]
  node_routing["Role-based routes<br/>[AppRoutes.jsx]"]
  node_auth_ui["Sign-in and registration<br/>[AuthPage.jsx]"]
  node_auth_state["Session state<br/>[AuthContext.jsx]"]
  node_auth_hook["Auth consumer<br/>[useAuth.js]"]
  node_candidate_workspace["Candidate workspace"]
  node_company_workspace["Company workspace"]
  node_admin_workspace["Admin workspace"]
  node_admin_apps["Application oversight<br/>[Applications.jsx]"]
  node_storage[("Browser session storage<br/>[storage.js]")]
  node_auth_service["Auth API client<br/>[authService.js]"]
  node_api["HTTP API client<br/>[api.js]"]
end

subgraph group_identity["Accounts and profiles"]
  node_backend_routes["API routing<br/>[urls.py]"]
  node_accounts[("Users and profiles<br/>[models.py]")]
end

subgraph group_recruitment["Recruitment workflow"]
  node_jobs[("Jobs and saved jobs<br/>[models.py]")]
  node_applications[("Applications and interviews<br/>[models.py]")]
  node_application_api["Application operations<br/>[views.py]"]
  node_messaging["Recruitment messaging"]
end

subgraph group_oversight["Platform administration"]
  node_admin_api["Admin operations"]
end

node_candidates(("Candidates"))
node_employers(("Employers"))
node_administrators(("Administrators"))
node_database[("PostgreSQL")]

node_frontend -->|"renders routes"| node_routing
node_routing -->|"routes to"| node_auth_ui
node_routing -->|"routes to"| node_candidate_workspace
node_routing -->|"routes to"| node_company_workspace
node_routing -->|"routes to"| node_admin_workspace
node_auth_ui -->|"uses auth"| node_auth_hook
node_auth_hook -->|"consumes context"| node_auth_state
node_auth_state -->|"persists session"| node_storage
node_auth_state -->|"calls auth API"| node_auth_service
node_auth_service -->|"uses client"| node_api
node_candidates -.->|"signs in"| node_auth_ui
node_employers -.->|"manages hiring"| node_company_workspace
node_administrators -.->|"oversees platform"| node_admin_workspace
node_admin_workspace -->|"includes applications"| node_admin_apps
node_admin_apps -.->|"persists demo data"| node_database
node_candidate_workspace -.->|"calls endpoints"| node_api
node_company_workspace -.->|"calls endpoints"| node_api
node_admin_workspace -.->|"calls endpoints"| node_api
node_api -.->|"sends requests"| node_backend_routes
node_backend_routes -.->|"routes requests"| node_application_api
node_application_api -->|"reads and writes"| node_applications
node_application_api -->|"checks published job"| node_jobs
node_application_api -->|"checks user role"| node_accounts
node_accounts -.->|"stores profiles"| node_database
node_jobs -.->|"stores job data"| node_database
node_applications -.->|"stores workflow"| node_database
node_backend_routes -.->|"routes job API"| node_jobs
node_backend_routes -.->|"routes account API"| node_accounts
node_backend_routes -.->|"routes messaging API"| node_messaging
node_backend_routes -.->|"routes admin API"| node_admin_api

click node_frontend "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/App.jsx"
click node_routing "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_auth_ui "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/pages/auth/AuthPage/AuthPage.jsx"
click node_auth_state "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/context/AuthContext.jsx"
click node_auth_hook "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/hooks/useAuth.js"
click node_candidate_workspace "https://github.com/laykimhoung/careerlens/tree/main/frontend/src/pages/candidate"
click node_company_workspace "https://github.com/laykimhoung/careerlens/tree/main/frontend/src/pages/company"
click node_admin_workspace "https://github.com/laykimhoung/careerlens/tree/main/frontend/src/pages/admin"
click node_admin_apps "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/pages/admin/Applications/Applications.jsx"
click node_storage "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/utils/storage.js"
click node_auth_service "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/services/authService.js"
click node_api "https://github.com/laykimhoung/careerlens/blob/main/frontend/src/services/api.js"
click node_backend_routes "https://github.com/laykimhoung/careerlens/blob/main/backend/config/urls.py"
click node_accounts "https://github.com/laykimhoung/careerlens/blob/main/backend/apps/accounts/models.py"
click node_jobs "https://github.com/laykimhoung/careerlens/blob/main/backend/apps/jobs/models.py"
click node_applications "https://github.com/laykimhoung/careerlens/blob/main/backend/apps/applications/models.py"
click node_application_api "https://github.com/laykimhoung/careerlens/blob/main/backend/apps/applications/views.py"
click node_messaging "https://github.com/laykimhoung/careerlens/tree/main/backend/apps/messaging"
click node_admin_api "https://github.com/laykimhoung/careerlens/tree/main/backend/apps"

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_frontend,node_routing,node_auth_ui,node_auth_state,node_auth_hook,node_candidate_workspace,node_company_workspace,node_admin_workspace,node_admin_apps,node_storage,node_auth_service,node_api toneBlue
class node_backend_routes,node_accounts,node_database toneAmber
class node_jobs,node_applications,node_application_api,node_messaging toneMint
class node_admin_api toneRose
class node_candidates,node_employers,node_administrators toneIndigo
```

## Components

### Web client

- [React application](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Role-based routes](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Sign-in and registration](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/pages/auth/AuthPage/AuthPage.jsx): `frontend/src/pages/auth/AuthPage/AuthPage.jsx`
- [Session state](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Auth consumer](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/hooks/useAuth.js): `frontend/src/hooks/useAuth.js`
- [Candidate workspace](https://github.com/laykimhoung/careerlens/tree/main/frontend/src/pages/candidate): `frontend/src/pages/candidate`
- [Company workspace](https://github.com/laykimhoung/careerlens/tree/main/frontend/src/pages/company): `frontend/src/pages/company`
- [Admin workspace](https://github.com/laykimhoung/careerlens/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Application oversight](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/pages/admin/Applications/Applications.jsx): `frontend/src/pages/admin/Applications/Applications.jsx`
- [Browser session storage](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/utils/storage.js): `frontend/src/utils/storage.js`
- [Auth API client](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [HTTP API client](https://github.com/laykimhoung/careerlens/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Accounts and profiles

- [API routing](https://github.com/laykimhoung/careerlens/blob/main/backend/config/urls.py): `backend/config/urls.py`
- [Users and profiles](https://github.com/laykimhoung/careerlens/blob/main/backend/apps/accounts/models.py): `backend/apps/accounts/models.py`

### Recruitment workflow

- [Jobs and saved jobs](https://github.com/laykimhoung/careerlens/blob/main/backend/apps/jobs/models.py): `backend/apps/jobs/models.py`
- [Applications and interviews](https://github.com/laykimhoung/careerlens/blob/main/backend/apps/applications/models.py): `backend/apps/applications/models.py`
- [Application operations](https://github.com/laykimhoung/careerlens/blob/main/backend/apps/applications/views.py): `backend/apps/applications/views.py`
- [Recruitment messaging](https://github.com/laykimhoung/careerlens/tree/main/backend/apps/messaging): `backend/apps/messaging`

### Platform administration

- [Admin operations](https://github.com/laykimhoung/careerlens/tree/main/backend/apps): `backend/apps`

### Other components

- **Candidates**
- **Employers**
- **Administrators**
- **PostgreSQL**

## Connections

- React application → Role-based routes: renders routes (evidence: `frontend/src/App.jsx`)
- Role-based routes → Sign-in and registration: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routes → Candidate workspace: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routes → Company workspace: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routes → Admin workspace: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Sign-in and registration → Auth consumer: uses auth (evidence: `frontend/src/pages/auth/AuthPage/AuthPage.jsx`)
- Auth consumer → Session state: consumes context (evidence: `frontend/src/hooks/useAuth.js`)
- Session state → Browser session storage: persists session (evidence: `frontend/src/context/AuthContext.jsx`)
- Session state → Auth API client: calls auth API (evidence: `frontend/src/context/AuthContext.jsx`)
- Auth API client → HTTP API client: uses client (evidence: `frontend/src/services/authService.js`)
- Candidates → Sign-in and registration: signs in
- Employers → Company workspace: manages hiring
- Administrators → Admin workspace: oversees platform
- Admin workspace → Application oversight: includes applications (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Application oversight → PostgreSQL: persists demo data
- Candidate workspace → HTTP API client: calls endpoints
- Company workspace → HTTP API client: calls endpoints
- Admin workspace → HTTP API client: calls endpoints
- HTTP API client → API routing: sends requests
- API routing → Application operations: routes requests
- Application operations → Applications and interviews: reads and writes (evidence: `backend/apps/applications/views.py`)
- Application operations → Jobs and saved jobs: checks published job (evidence: `backend/apps/applications/views.py`)
- Application operations → Users and profiles: checks user role (evidence: `backend/apps/applications/views.py`)
- Users and profiles → PostgreSQL: stores profiles
- Jobs and saved jobs → PostgreSQL: stores job data
- Applications and interviews → PostgreSQL: stores workflow
- API routing → Jobs and saved jobs: routes job API
- API routing → Users and profiles: routes account API
- API routing → Recruitment messaging: routes messaging API
- API routing → Admin operations: routes admin API
