# imganpat/apply-hub architecture

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

- Interactive diagram: https://gitdiagram.com/imganpat/apply-hub
- Repository: https://github.com/imganpat/apply-hub

## Overview

ApplySphere is a job-application tracking product: job seekers register or sign in, manage application records and their statuses, and review progress analytics. The backend exposes account, application, and analytics APIs; application records include status-transition history and notes. The frontend provides public entry pages and dashboard views for applications, profile, settings, and analytics. Backend routing and model behavior are visible in the excerpts; frontend-to-API wiring and several dashboard implementations were not, so those connections are marked unverified or omitted.

Main entry points: [`frontend/src/app/(dashboard)/dashboard/page.jsx`](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/page.jsx) (Dashboard Home), [`backend/applications/models.py`](https://github.com/imganpat/apply-hub/blob/main/backend/applications/models.py) (Application Records), [`frontend/src/app/page.js`](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/page.js) (Landing Page), [`frontend/src/app/(dashboard)/dashboard/applications/page.jsx`](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/applications/page.jsx) (Applications View)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Accounts"]
  node_landing["Landing Page<br/>[page.js]"]
  node_login["Login Page<br/>[page.jsx]"]
  node_register["Registration Page<br/>[page.jsx]"]
  node_account_api["Account Endpoints<br/>[urls.py]"]
  node_account_views["Account Views<br/>[views.py]"]
  node_account_serializers["Account Serializers<br/>[serializers.py]"]
  node_user_store[("User Records<br/>[models.py]")]
end

subgraph group_frontend["Job Seeker Dashboard"]
  node_dashboard["Dashboard Home<br/>[page.jsx]"]
  node_applications_page["Applications View<br/>[page.jsx]"]
  node_application_table["Application Table<br/>[DataTable.jsx]"]
  node_application_modal["Application Editor"]
  node_profile_page["Profile View<br/>[page.jsx]"]
  node_settings_page["Settings View<br/>[page.jsx]"]
end

subgraph group_backend["Application Services"]
  node_application_api["Application Endpoints<br/>[urls.py]"]
  node_application_views["Application Operations<br/>[views.py]"]
  node_application_serializers["Application Serializer<br/>[serializers.py]"]
  node_application_store[("Application Records<br/>[models.py]")]
end

subgraph group_insights["Progress Analytics"]
  node_analytics_page["Analytics View<br/>[page.jsx]"]
  node_analytics_charts["Analytics Charts"]
  node_analytics_api["Analytics Endpoints<br/>[urls.py]"]
  node_analytics_views["Analytics Queries<br/>[views.py]"]
end

node_seeker(("Job Seeker"))

node_seeker -->|"opens"| node_landing
node_landing -->|"links to"| node_login
node_landing -->|"links to"| node_register
node_seeker -.->|"authenticates"| node_account_api
node_account_api -->|"routes to"| node_account_views
node_account_views -->|"uses"| node_account_serializers
node_account_serializers -.->|"creates user"| node_user_store
node_seeker -.->|"uses"| node_dashboard
node_dashboard -.->|"navigates to"| node_applications_page
node_applications_page -.->|"renders"| node_application_table
node_applications_page -.->|"opens"| node_application_modal
node_dashboard -.->|"navigates to"| node_profile_page
node_dashboard -.->|"navigates to"| node_settings_page
node_application_table -.->|"requests data"| node_application_api
node_application_modal -.->|"submits changes"| node_application_api
node_application_api -->|"routes to"| node_application_views
node_application_views -->|"serializes"| node_application_serializers
node_application_views -->|"queries and saves"| node_application_store
node_application_serializers -->|"serializes model"| node_application_store
node_application_store -->|"records status history"| node_application_store
node_dashboard -.->|"navigates to"| node_analytics_page
node_analytics_page -.->|"renders"| node_analytics_charts
node_analytics_page -.->|"requests metrics"| node_analytics_api
node_analytics_api -->|"routes to"| node_analytics_views
node_analytics_views -->|"aggregates records"| node_application_store

click node_landing "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/page.js"
click node_login "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(auth)/login/page.jsx"
click node_register "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(auth)/register/page.jsx"
click node_account_api "https://github.com/imganpat/apply-hub/blob/main/backend/accounts/urls.py"
click node_account_views "https://github.com/imganpat/apply-hub/blob/main/backend/accounts/views.py"
click node_account_serializers "https://github.com/imganpat/apply-hub/blob/main/backend/accounts/serializers.py"
click node_user_store "https://github.com/imganpat/apply-hub/blob/main/backend/accounts/models.py"
click node_dashboard "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/page.jsx"
click node_applications_page "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/applications/page.jsx"
click node_application_table "https://github.com/imganpat/apply-hub/blob/main/frontend/src/components/DataTable.jsx"
click node_application_modal "https://github.com/imganpat/apply-hub/blob/main/frontend/src/components/ApplicationModal.jsx"
click node_profile_page "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/profile/page.jsx"
click node_settings_page "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/settings/page.jsx"
click node_application_api "https://github.com/imganpat/apply-hub/blob/main/backend/applysphere/urls.py"
click node_application_views "https://github.com/imganpat/apply-hub/blob/main/backend/applications/views.py"
click node_application_serializers "https://github.com/imganpat/apply-hub/blob/main/backend/applications/serializers.py"
click node_application_store "https://github.com/imganpat/apply-hub/blob/main/backend/applications/models.py"
click node_analytics_page "https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/analytics/page.jsx"
click node_analytics_charts "https://github.com/imganpat/apply-hub/blob/main/frontend/src/components/StatusDistributionChart.jsx"
click node_analytics_api "https://github.com/imganpat/apply-hub/blob/main/backend/analytics/urls.py"
click node_analytics_views "https://github.com/imganpat/apply-hub/blob/main/backend/analytics/views.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_landing,node_login,node_register,node_account_api,node_account_views,node_account_serializers,node_user_store toneBlue
class node_dashboard,node_applications_page,node_application_table,node_application_modal,node_profile_page,node_settings_page toneAmber
class node_application_api,node_application_views,node_application_serializers,node_application_store toneMint
class node_analytics_page,node_analytics_charts,node_analytics_api,node_analytics_views toneRose
class node_seeker toneIndigo
```

## Components

### Entry and Accounts

- [Landing Page](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/page.js): `frontend/src/app/page.js`
- [Login Page](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(auth)/login/page.jsx): `frontend/src/app/(auth)/login/page.jsx`
- [Registration Page](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(auth)/register/page.jsx): `frontend/src/app/(auth)/register/page.jsx`
- [Account Endpoints](https://github.com/imganpat/apply-hub/blob/main/backend/accounts/urls.py): `backend/accounts/urls.py`
- [Account Views](https://github.com/imganpat/apply-hub/blob/main/backend/accounts/views.py): `backend/accounts/views.py`
- [Account Serializers](https://github.com/imganpat/apply-hub/blob/main/backend/accounts/serializers.py): `backend/accounts/serializers.py`
- [User Records](https://github.com/imganpat/apply-hub/blob/main/backend/accounts/models.py): `backend/accounts/models.py`

### Job Seeker Dashboard

- [Dashboard Home](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/page.jsx): `frontend/src/app/(dashboard)/dashboard/page.jsx`
- [Applications View](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/applications/page.jsx): `frontend/src/app/(dashboard)/dashboard/applications/page.jsx`
- [Application Table](https://github.com/imganpat/apply-hub/blob/main/frontend/src/components/DataTable.jsx): `frontend/src/components/DataTable.jsx`
- [Application Editor](https://github.com/imganpat/apply-hub/blob/main/frontend/src/components/ApplicationModal.jsx): `frontend/src/components/ApplicationModal.jsx`
- [Profile View](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/profile/page.jsx): `frontend/src/app/(dashboard)/dashboard/profile/page.jsx`
- [Settings View](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/settings/page.jsx): `frontend/src/app/(dashboard)/dashboard/settings/page.jsx`

### Application Services

- [Application Endpoints](https://github.com/imganpat/apply-hub/blob/main/backend/applysphere/urls.py): `backend/applysphere/urls.py`
- [Application Operations](https://github.com/imganpat/apply-hub/blob/main/backend/applications/views.py): `backend/applications/views.py`
- [Application Serializer](https://github.com/imganpat/apply-hub/blob/main/backend/applications/serializers.py): `backend/applications/serializers.py`
- [Application Records](https://github.com/imganpat/apply-hub/blob/main/backend/applications/models.py): `backend/applications/models.py`

### Progress Analytics

- [Analytics View](https://github.com/imganpat/apply-hub/blob/main/frontend/src/app/(dashboard)/dashboard/analytics/page.jsx): `frontend/src/app/(dashboard)/dashboard/analytics/page.jsx`
- [Analytics Charts](https://github.com/imganpat/apply-hub/blob/main/frontend/src/components/StatusDistributionChart.jsx): `frontend/src/components/StatusDistributionChart.jsx`
- [Analytics Endpoints](https://github.com/imganpat/apply-hub/blob/main/backend/analytics/urls.py): `backend/analytics/urls.py`
- [Analytics Queries](https://github.com/imganpat/apply-hub/blob/main/backend/analytics/views.py): `backend/analytics/views.py`

### Other components

- **Job Seeker**

## Connections

- Job Seeker → Landing Page: opens (evidence: `frontend/src/app/page.js`)
- Landing Page → Login Page: links to (evidence: `frontend/src/app/page.js`)
- Landing Page → Registration Page: links to (evidence: `frontend/src/app/page.js`)
- Job Seeker → Account Endpoints: authenticates
- Account Endpoints → Account Views: routes to (evidence: `backend/accounts/urls.py`)
- Account Views → Account Serializers: uses (evidence: `backend/accounts/views.py`)
- Account Serializers → User Records: creates user
- Job Seeker → Dashboard Home: uses
- Dashboard Home → Applications View: navigates to
- Applications View → Application Table: renders
- Applications View → Application Editor: opens
- Dashboard Home → Profile View: navigates to
- Dashboard Home → Settings View: navigates to
- Application Table → Application Endpoints: requests data
- Application Editor → Application Endpoints: submits changes
- Application Endpoints → Application Operations: routes to (evidence: `backend/applysphere/urls.py`)
- Application Operations → Application Serializer: serializes (evidence: `backend/applications/views.py`)
- Application Operations → Application Records: queries and saves (evidence: `backend/applications/views.py`)
- Application Serializer → Application Records: serializes model (evidence: `backend/applications/serializers.py`)
- Application Records → Application Records: records status history (evidence: `backend/applications/models.py`)
- Dashboard Home → Analytics View: navigates to
- Analytics View → Analytics Charts: renders
- Analytics View → Analytics Endpoints: requests metrics
- Analytics Endpoints → Analytics Queries: routes to (evidence: `backend/analytics/urls.py`)
- Analytics Queries → Application Records: aggregates records (evidence: `backend/analytics/views.py`)
