# gurungsh/job-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/gurungsh/job-tracker
- Repository: https://github.com/gurungsh/job-tracker

## Overview

Job-tracker is a personal job-application management web app. Users create and track applications in a stage-based board or searchable, filterable table, then manage an application's details, timeline, requirements, and company contacts. The React client calls an Express API; shared schemas and types align the two sides, and the server persists data in SQLite. The README documents themes, archiving, and the built-in guide. Some subsystem links rely on README architecture descriptions and source-index references rather than sampled implementations.

Main entry points: [`apps/server/src/app.ts`](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/app.ts) (Express app), [`apps/client/src/App.tsx`](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/App.tsx) (Routes and provider), [`apps/client/src/components/ApplicationDetailPage.tsx`](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationDetailPage.tsx) (Application detail), [`apps/client/src/components/ApplicationsPage.tsx`](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationsPage.tsx) (Application views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Routes and provider<br/>[App.tsx]"]
  node_shell["App shell<br/>[AppShell.tsx]"]
  node_applications["Application views"]
  node_board["Stage board<br/>[Board.tsx]"]
  node_table["Search and table<br/>[TableView.tsx]"]
  node_guide["User guide<br/>[UserGuidePage.tsx]"]
  node_state["Application state"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_server["API and persistence"]
  node_server["Express app<br/>[app.ts]"]
  node_application_routes["Application routes<br/>[router.ts]"]
  node_application_store["Application storage<br/>[store.ts]"]
  node_activity_routes["Activity routes<br/>[router.ts]"]
  node_activity_store["Activity storage<br/>[store.ts]"]
  node_contact_routes["Contact routes<br/>[router.ts]"]
  node_contact_store["Contact storage<br/>[store.ts]"]
  node_requirement_routes["Requirement routes<br/>[router.ts]"]
  node_requirement_store["Requirement storage<br/>[store.ts]"]
  node_db[("SQLite database<br/>[db.ts]")]
  node_logger["Request and event logs<br/>[logger.ts]"]
end

subgraph group_domain["Application domain"]
  node_detail["Application detail"]
  node_dialog["Application editor"]
  node_timeline["Activity timeline<br/>[Timeline.tsx]"]
  node_requirements["Requirements checklist<br/>[Requirements.tsx]"]
  node_contacts["Company contacts<br/>[Contacts.tsx]"]
end

subgraph group_shared["Shared contracts"]
  node_shared_types["Types and validation<br/>[applications.ts]"]
end

node_user(("Job seeker"))

node_user -->|"uses"| node_app
node_app -->|"wraps routes"| node_shell
node_app -->|"routes to"| node_applications
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_guide
node_applications -->|"renders"| node_board
node_applications -->|"renders"| node_table
node_applications -->|"reads"| node_state
node_board -->|"reads"| node_state
node_detail -->|"renders"| node_timeline
node_detail -->|"renders"| node_requirements
node_detail -.->|"renders"| node_contacts
node_detail -->|"opens editor"| node_dialog
node_state -->|"loads data"| node_api_client
node_timeline -->|"manages entries"| node_api_client
node_api_client -->|"JSON over API"| node_server
node_shared_types -->|"types requests"| node_api_client
node_shared_types -->|"validates input"| node_application_routes
node_server -->|"mounts routes"| node_application_routes
node_server -->|"mounts routes"| node_activity_routes
node_server -->|"mounts routes"| node_contact_routes
node_server -->|"mounts routes"| node_requirement_routes
node_application_routes -->|"calls"| node_application_store
node_activity_routes -->|"calls"| node_activity_store
node_activity_routes -->|"checks contact"| node_contact_store
node_contact_routes -->|"calls"| node_contact_store
node_requirement_routes -->|"calls"| node_requirement_store
node_application_store -->|"records stage changes"| node_activity_store
node_application_store -->|"reads and writes"| node_db
node_activity_store -->|"reads and writes"| node_db
node_contact_store -->|"reads and writes"| node_db
node_requirement_store -->|"reads and writes"| node_db
node_server -->|"logs requests"| node_logger
node_user -->|"opens guide"| node_guide

click node_app "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/App.tsx"
click node_shell "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/AppShell.tsx"
click node_applications "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationsPage.tsx"
click node_board "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Board.tsx"
click node_table "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/TableView.tsx"
click node_detail "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationDetailPage.tsx"
click node_dialog "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationDialog.tsx"
click node_timeline "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Timeline.tsx"
click node_requirements "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Requirements.tsx"
click node_contacts "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Contacts.tsx"
click node_guide "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/UserGuidePage.tsx"
click node_state "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/lib/useApplications.tsx"
click node_api_client "https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/lib/api.ts"
click node_shared_types "https://github.com/gurungsh/job-tracker/blob/main/packages/shared/src/applications.ts"
click node_server "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/app.ts"
click node_application_routes "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/applications/router.ts"
click node_application_store "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/applications/store.ts"
click node_activity_routes "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/activities/router.ts"
click node_activity_store "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/activities/store.ts"
click node_contact_routes "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/contacts/router.ts"
click node_contact_store "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/contacts/store.ts"
click node_requirement_routes "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/requirements/router.ts"
click node_requirement_store "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/requirements/store.ts"
click node_db "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/db.ts"
click node_logger "https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/logger.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_shell,node_applications,node_board,node_table,node_guide,node_state,node_api_client toneBlue
class node_server,node_application_routes,node_application_store,node_activity_routes,node_activity_store,node_contact_routes,node_contact_store,node_requirement_routes,node_requirement_store,node_db,node_logger toneAmber
class node_detail,node_dialog,node_timeline,node_requirements,node_contacts toneMint
class node_shared_types toneRose
class node_user toneIndigo
```

## Components

### Web client

- [Routes and provider](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/App.tsx): `apps/client/src/App.tsx`
- [App shell](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/AppShell.tsx): `apps/client/src/components/AppShell.tsx`
- [Application views](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationsPage.tsx): `apps/client/src/components/ApplicationsPage.tsx`
- [Stage board](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Board.tsx): `apps/client/src/components/Board.tsx`
- [Search and table](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/TableView.tsx): `apps/client/src/components/TableView.tsx`
- [User guide](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/UserGuidePage.tsx): `apps/client/src/components/UserGuidePage.tsx`
- [Application state](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/lib/useApplications.tsx): `apps/client/src/lib/useApplications.tsx`
- [API client](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/lib/api.ts): `apps/client/src/lib/api.ts`

### API and persistence

- [Express app](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/app.ts): `apps/server/src/app.ts`
- [Application routes](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/applications/router.ts): `apps/server/src/applications/router.ts`
- [Application storage](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/applications/store.ts): `apps/server/src/applications/store.ts`
- [Activity routes](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/activities/router.ts): `apps/server/src/activities/router.ts`
- [Activity storage](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/activities/store.ts): `apps/server/src/activities/store.ts`
- [Contact routes](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/contacts/router.ts): `apps/server/src/contacts/router.ts`
- [Contact storage](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/contacts/store.ts): `apps/server/src/contacts/store.ts`
- [Requirement routes](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/requirements/router.ts): `apps/server/src/requirements/router.ts`
- [Requirement storage](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/requirements/store.ts): `apps/server/src/requirements/store.ts`
- [SQLite database](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/db.ts): `apps/server/src/db.ts`
- [Request and event logs](https://github.com/gurungsh/job-tracker/blob/main/apps/server/src/logger.ts): `apps/server/src/logger.ts`

### Application domain

- [Application detail](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationDetailPage.tsx): `apps/client/src/components/ApplicationDetailPage.tsx`
- [Application editor](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/ApplicationDialog.tsx): `apps/client/src/components/ApplicationDialog.tsx`
- [Activity timeline](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Timeline.tsx): `apps/client/src/components/Timeline.tsx`
- [Requirements checklist](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Requirements.tsx): `apps/client/src/components/Requirements.tsx`
- [Company contacts](https://github.com/gurungsh/job-tracker/blob/main/apps/client/src/components/Contacts.tsx): `apps/client/src/components/Contacts.tsx`

### Shared contracts

- [Types and validation](https://github.com/gurungsh/job-tracker/blob/main/packages/shared/src/applications.ts): `packages/shared/src/applications.ts`

### Other components

- **Job seeker**

## Connections

- Job seeker → Routes and provider: uses
- Routes and provider → App shell: wraps routes (evidence: `apps/client/src/App.tsx`)
- Routes and provider → Application views: routes to (evidence: `apps/client/src/App.tsx`)
- Routes and provider → Application detail: routes to (evidence: `apps/client/src/App.tsx`)
- Routes and provider → User guide: routes to (evidence: `apps/client/src/App.tsx`)
- Application views → Stage board: renders (evidence: `apps/client/src/components/ApplicationsPage.tsx`)
- Application views → Search and table: renders (evidence: `apps/client/src/components/ApplicationsPage.tsx`)
- Application views → Application state: reads (evidence: `apps/client/src/components/ApplicationsPage.tsx`)
- Stage board → Application state: reads (evidence: `apps/client/src/components/Board.tsx`)
- Application detail → Activity timeline: renders (evidence: `apps/client/src/components/ApplicationDetailPage.tsx`)
- Application detail → Requirements checklist: renders (evidence: `apps/client/src/components/ApplicationDetailPage.tsx`)
- Application detail → Company contacts: renders (evidence: `apps/client/src/components/ApplicationDetailPage.tsx`)
- Application detail → Application editor: opens editor (evidence: `apps/client/src/components/ApplicationDetailPage.tsx`)
- Application state → API client: loads data (evidence: `apps/client/src/lib/useApplications.tsx`)
- Activity timeline → API client: manages entries (evidence: `apps/client/src/components/Timeline.tsx`)
- API client → Express app: JSON over API
- Types and validation → API client: types requests (evidence: `apps/client/src/lib/api.ts`)
- Types and validation → Application routes: validates input (evidence: `apps/server/src/applications/router.ts`)
- Express app → Application routes: mounts routes (evidence: `apps/server/src/app.ts`)
- Express app → Activity routes: mounts routes (evidence: `apps/server/src/app.ts`)
- Express app → Contact routes: mounts routes (evidence: `apps/server/src/app.ts`)
- Express app → Requirement routes: mounts routes (evidence: `apps/server/src/app.ts`)
- Application routes → Application storage: calls (evidence: `apps/server/src/applications/router.ts`)
- Activity routes → Activity storage: calls (evidence: `apps/server/src/activities/router.ts`)
- Activity routes → Contact storage: checks contact (evidence: `apps/server/src/activities/router.ts`)
- Contact routes → Contact storage: calls (evidence: `apps/server/src/contacts/router.ts`)
- Requirement routes → Requirement storage: calls (evidence: `apps/server/src/requirements/router.ts`)
- Application storage → Activity storage: records stage changes (evidence: `apps/server/src/applications/store.ts`)
- Application storage → SQLite database: reads and writes
- Activity storage → SQLite database: reads and writes
- Contact storage → SQLite database: reads and writes
- Requirement storage → SQLite database: reads and writes
- Express app → Request and event logs: logs requests (evidence: `apps/server/src/app.ts`)
- Job seeker → User guide: opens guide
