# ash1022004/zosper_job architecture

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

- Interactive diagram: https://gitdiagram.com/ash1022004/zosper_job
- Repository: https://github.com/ash1022004/zosper_job

## Overview

This is a job-listing application: job seekers browse and filter postings, inspect details, and apply through listing links; administrators manage listings and settings and view analytics. The frontend also provides login, feedback, and a CSV-based job refresh path. The graph reflects the shown page/store/API relationships and the documented module references; backend behavior and several UI interactions were not sampled, so uncertain links are omitted.

Main entry points: [`src/pages/Index.tsx`](https://github.com/ash1022004/zosper_job/blob/main/src/pages/Index.tsx) (Browse and filter), [`src/App.tsx`](https://github.com/ash1022004/zosper_job/blob/main/src/App.tsx) (App and routing), [`src/lib/api.ts`](https://github.com/ash1022004/zosper_job/blob/main/src/lib/api.ts) (API client), [`src/pages/Admin.tsx`](https://github.com/ash1022004/zosper_job/blob/main/src/pages/Admin.tsx) (Listing administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app_router["App and routing<br/>[App.tsx]"]
  node_ui_primitives["UI primitives"]
end

subgraph group_jobs["Job Listings"]
  node_job_search["Browse and filter<br/>[Index.tsx]"]
  node_job_card["Job cards<br/>[JobCard.tsx]"]
  node_job_filters["Job filters<br/>[JobFilters.tsx]"]
  node_job_detail["Job details<br/>[JobDetailModal.tsx]"]
  node_job_state["Job state<br/>[jobsStore.ts]"]
  node_job_types["Job model<br/>[job.ts]"]
  node_sample_jobs["Sample listings<br/>[mockJobs.ts]"]
  node_csv_sources["CSV refresh<br/>[sources.ts]"]
  node_admin_jobs["Listing administration<br/>[Admin.tsx]"]
end

subgraph group_identity["Identity and Feedback"]
  node_auth_pages["Login pages<br/>[Login.tsx]"]
  node_user_page["User login<br/>[UserLogin.tsx]"]
  node_auth_state["Auth state<br/>[authStore.ts]"]
  node_user_state["User state<br/>[userStore.ts]"]
  node_feedback["Feedback panel<br/>[FeedbackPanel.tsx]"]
end

subgraph group_services["API and Server"]
  node_api_client["API client<br/>[api.ts]"]
  node_api_service{{"Configured API"}}
  node_server["Server routes<br/>[index.cjs]"]
  node_server_store[("Server store<br/>[store.cjs]")]
end

node_visitor(("Job seeker"))
node_admin_user(("Administrator"))

node_visitor -->|"opens"| node_app_router
node_admin_user -->|"opens"| node_app_router
node_app_router -->|"routes to"| node_job_search
node_app_router -->|"routes to"| node_admin_jobs
node_app_router -->|"routes to"| node_auth_pages
node_job_search -->|"loads listings"| node_job_state
node_job_search -->|"refreshes from"| node_csv_sources
node_job_search -->|"renders"| node_job_filters
node_job_search -->|"renders"| node_job_card
node_job_search -->|"opens details"| node_job_detail
node_job_search -->|"uses"| node_job_types
node_job_state -->|"falls back to"| node_sample_jobs
node_job_state -->|"uses"| node_job_types
node_csv_sources -->|"uses"| node_job_state
node_admin_jobs -->|"manages listings"| node_job_state
node_admin_jobs -->|"uses"| node_csv_sources
node_admin_jobs -->|"requests analytics"| node_api_client
node_admin_jobs -->|"uses"| node_auth_state
node_job_detail -->|"uses"| node_api_client
node_job_detail -->|"uses"| node_user_state
node_auth_pages -->|"authenticates via"| node_api_client
node_user_page -->|"authenticates via"| node_api_client
node_user_page -->|"updates"| node_user_state
node_feedback -->|"submits feedback"| node_api_client
node_feedback -->|"reads"| node_user_state
node_api_client -->|"sends requests"| node_api_service
node_api_service -.->|"may be served by"| node_server
node_server -->|"imports"| node_server_store
node_app_router -->|"uses"| node_ui_primitives

click node_app_router "https://github.com/ash1022004/zosper_job/blob/main/src/App.tsx"
click node_job_search "https://github.com/ash1022004/zosper_job/blob/main/src/pages/Index.tsx"
click node_job_card "https://github.com/ash1022004/zosper_job/blob/main/src/components/JobCard.tsx"
click node_job_filters "https://github.com/ash1022004/zosper_job/blob/main/src/components/JobFilters.tsx"
click node_job_detail "https://github.com/ash1022004/zosper_job/blob/main/src/components/JobDetailModal.tsx"
click node_job_state "https://github.com/ash1022004/zosper_job/blob/main/src/store/jobsStore.ts"
click node_job_types "https://github.com/ash1022004/zosper_job/blob/main/src/types/job.ts"
click node_sample_jobs "https://github.com/ash1022004/zosper_job/blob/main/src/data/mockJobs.ts"
click node_csv_sources "https://github.com/ash1022004/zosper_job/blob/main/src/lib/sources.ts"
click node_admin_jobs "https://github.com/ash1022004/zosper_job/blob/main/src/pages/Admin.tsx"
click node_auth_pages "https://github.com/ash1022004/zosper_job/blob/main/src/pages/Login.tsx"
click node_user_page "https://github.com/ash1022004/zosper_job/blob/main/src/pages/UserLogin.tsx"
click node_auth_state "https://github.com/ash1022004/zosper_job/blob/main/src/store/authStore.ts"
click node_user_state "https://github.com/ash1022004/zosper_job/blob/main/src/store/userStore.ts"
click node_feedback "https://github.com/ash1022004/zosper_job/blob/main/src/components/FeedbackPanel.tsx"
click node_api_client "https://github.com/ash1022004/zosper_job/blob/main/src/lib/api.ts"
click node_server "https://github.com/ash1022004/zosper_job/blob/main/server/index.cjs"
click node_server_store "https://github.com/ash1022004/zosper_job/blob/main/server/store.cjs"
click node_ui_primitives "https://github.com/ash1022004/zosper_job/tree/main/src/components/ui"

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_router,node_ui_primitives toneBlue
class node_job_search,node_job_card,node_job_filters,node_job_detail,node_job_state,node_job_types,node_sample_jobs,node_csv_sources,node_admin_jobs toneAmber
class node_auth_pages,node_user_page,node_auth_state,node_user_state,node_feedback toneMint
class node_api_client,node_api_service,node_server,node_server_store toneRose
class node_visitor,node_admin_user toneIndigo
```

## Components

### Application

- [App and routing](https://github.com/ash1022004/zosper_job/blob/main/src/App.tsx): `src/App.tsx`
- [UI primitives](https://github.com/ash1022004/zosper_job/tree/main/src/components/ui): `src/components/ui`

### Job Listings

- [Browse and filter](https://github.com/ash1022004/zosper_job/blob/main/src/pages/Index.tsx): `src/pages/Index.tsx`
- [Job cards](https://github.com/ash1022004/zosper_job/blob/main/src/components/JobCard.tsx): `src/components/JobCard.tsx`
- [Job filters](https://github.com/ash1022004/zosper_job/blob/main/src/components/JobFilters.tsx): `src/components/JobFilters.tsx`
- [Job details](https://github.com/ash1022004/zosper_job/blob/main/src/components/JobDetailModal.tsx): `src/components/JobDetailModal.tsx`
- [Job state](https://github.com/ash1022004/zosper_job/blob/main/src/store/jobsStore.ts): `src/store/jobsStore.ts`
- [Job model](https://github.com/ash1022004/zosper_job/blob/main/src/types/job.ts): `src/types/job.ts`
- [Sample listings](https://github.com/ash1022004/zosper_job/blob/main/src/data/mockJobs.ts): `src/data/mockJobs.ts`
- [CSV refresh](https://github.com/ash1022004/zosper_job/blob/main/src/lib/sources.ts): `src/lib/sources.ts`
- [Listing administration](https://github.com/ash1022004/zosper_job/blob/main/src/pages/Admin.tsx): `src/pages/Admin.tsx`

### Identity and Feedback

- [Login pages](https://github.com/ash1022004/zosper_job/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`
- [User login](https://github.com/ash1022004/zosper_job/blob/main/src/pages/UserLogin.tsx): `src/pages/UserLogin.tsx`
- [Auth state](https://github.com/ash1022004/zosper_job/blob/main/src/store/authStore.ts): `src/store/authStore.ts`
- [User state](https://github.com/ash1022004/zosper_job/blob/main/src/store/userStore.ts): `src/store/userStore.ts`
- [Feedback panel](https://github.com/ash1022004/zosper_job/blob/main/src/components/FeedbackPanel.tsx): `src/components/FeedbackPanel.tsx`

### API and Server

- [API client](https://github.com/ash1022004/zosper_job/blob/main/src/lib/api.ts): `src/lib/api.ts`
- **Configured API**
- [Server routes](https://github.com/ash1022004/zosper_job/blob/main/server/index.cjs): `server/index.cjs`
- [Server store](https://github.com/ash1022004/zosper_job/blob/main/server/store.cjs): `server/store.cjs`

### Other components

- **Job seeker**
- **Administrator**

## Connections

- Job seeker → App and routing: opens (evidence: `src/App.tsx`)
- Administrator → App and routing: opens (evidence: `src/App.tsx`)
- App and routing → Browse and filter: routes to (evidence: `src/App.tsx`)
- App and routing → Listing administration: routes to (evidence: `src/App.tsx`)
- App and routing → Login pages: routes to (evidence: `src/App.tsx`)
- Browse and filter → Job state: loads listings (evidence: `src/pages/Index.tsx`)
- Browse and filter → CSV refresh: refreshes from (evidence: `src/pages/Index.tsx`)
- Browse and filter → Job filters: renders (evidence: `src/pages/Index.tsx`)
- Browse and filter → Job cards: renders (evidence: `src/pages/Index.tsx`)
- Browse and filter → Job details: opens details (evidence: `src/pages/Index.tsx`)
- Browse and filter → Job model: uses (evidence: `src/pages/Index.tsx`)
- Job state → Sample listings: falls back to (evidence: `src/store/jobsStore.ts`)
- Job state → Job model: uses (evidence: `src/store/jobsStore.ts`)
- CSV refresh → Job state: uses (evidence: `src/lib/sources.ts`)
- Listing administration → Job state: manages listings (evidence: `src/pages/Admin.tsx`)
- Listing administration → CSV refresh: uses (evidence: `src/pages/Admin.tsx`)
- Listing administration → API client: requests analytics (evidence: `src/pages/Admin.tsx`)
- Listing administration → Auth state: uses (evidence: `src/pages/Admin.tsx`)
- Job details → API client: uses (evidence: `src/components/JobDetailModal.tsx`)
- Job details → User state: uses (evidence: `src/components/JobDetailModal.tsx`)
- Login pages → API client: authenticates via (evidence: `src/pages/Login.tsx`)
- User login → API client: authenticates via (evidence: `src/pages/UserLogin.tsx`)
- User login → User state: updates (evidence: `src/pages/UserLogin.tsx`)
- Feedback panel → API client: submits feedback (evidence: `src/components/FeedbackPanel.tsx`)
- Feedback panel → User state: reads (evidence: `src/components/FeedbackPanel.tsx`)
- API client → Configured API: sends requests (evidence: `src/lib/api.ts`)
- Configured API → Server routes: may be served by
- Server routes → Server store: imports (evidence: `server/index.cjs`)
- App and routing → UI primitives: uses (evidence: `src/App.tsx`)
