# maazkhurshid60/job-site architecture

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

- Interactive diagram: https://gitdiagram.com/maazkhurshid60/job-site
- Repository: https://github.com/maazkhurshid60/job-site

## Overview

JobFolder is an engineering recruiting marketplace and agency workflow: companies post roles, specialist recruiters submit candidates, and staff oversee screening and hiring. Its product surface includes a public job board, recruiter accounts and dashboards, candidate submissions and messaging, recruiter career sites and leads, and a protected operations console. The sampled route and repository excerpts support the submission and enquiry flows; other major areas are retained from the file tree, with uncertain connections omitted.

Main entry points: [`app/api/messages/route.ts`](https://github.com/maazkhurshid60/job-site/blob/main/app/api/messages/route.ts) (Message API), [`app/api/submissions/route.ts`](https://github.com/maazkhurshid60/job-site/blob/main/app/api/submissions/route.ts) (Submission API), [`app/console-4h9k2xqf/page.tsx`](https://github.com/maazkhurshid60/job-site/blob/main/app/console-4h9k2xqf/page.tsx) (Admin console), [`app/dashboard/page.tsx`](https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/page.tsx) (Recruiter dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market["Public Marketplace"]
  node_public_site["Public site<br/>[page.tsx]"]
  node_job_board["Job board<br/>[page.tsx]"]
  node_job_details["Job details<br/>[page.tsx]"]
  node_contact["Contact enquiries<br/>[page.tsx]"]
end

subgraph group_recruiter["Recruiter Workspace"]
  node_recruiter_apply["Recruiter signup<br/>[page.tsx]"]
  node_recruiter_dashboard["Recruiter dashboard<br/>[page.tsx]"]
  node_recruiter_jobs["Recruiter jobs<br/>[page.tsx]"]
  node_submissions_ui["Candidate submissions<br/>[page.tsx]"]
  node_recruiter_sites["Career sites<br/>[page.tsx]"]
  node_site_leads["Site leads<br/>[route.ts]"]
end

subgraph group_operations["Agency Operations"]
  node_admin_console["Admin console<br/>[page.tsx]"]
  node_admin_jobs["Job administration<br/>[route.ts]"]
  node_admin_recruiters["Recruiter administration<br/>[route.ts]"]
  node_admin_submissions["Submission review<br/>[route.ts]"]
  node_admin_messages["Enquiry management<br/>[route.ts]"]
end

subgraph group_backend["Application Services"]
  node_submission_api["Submission API<br/>[route.ts]"]
  node_message_api["Message API<br/>[route.ts]"]
  node_auth["Identity checks<br/>[auth.ts]"]
  node_repository["Domain repository<br/>[repo.ts]"]
  node_database[("Application database<br/>[db.ts]")]
  node_response["API response handling<br/>[respond.ts]"]
  node_job_logic["Job domain<br/>[jobs.ts]"]
  node_submission_logic["Submission domain<br/>[submissions.ts]"]
  node_user_logic["User domain<br/>[users.ts]"]
  node_auth_client["Client authentication<br/>[auth.tsx]"]
  node_notify["Email notifications<br/>[notify.ts]"]
  node_spam["Spam scoring<br/>[spamScore.ts]"]
end

node_visitor(("Job seeker / visitor"))
node_firebase["Firebase identity<br/>[firebase.ts]"]

node_visitor -->|"browses"| node_job_board
node_job_board -->|"uses job data"| node_job_logic
node_visitor -.->|"sends enquiry"| node_contact
node_contact -.->|"submits message"| node_message_api
node_recruiter_dashboard -->|"reads session"| node_auth_client
node_auth_client -->|"uses identity"| node_firebase
node_auth_client -->|"loads user"| node_user_logic
node_recruiter_dashboard -->|"uses job data"| node_job_logic
node_recruiter_dashboard -->|"uses submission data"| node_submission_logic
node_recruiter_jobs -.->|"manages roles"| node_job_logic
node_submissions_ui -.->|"creates submissions"| node_submission_api
node_recruiter_sites -.->|"receives leads"| node_site_leads
node_submission_api -->|"checks identity"| node_auth
node_submission_api -->|"reads and writes"| node_repository
node_submission_api -->|"notifies staff"| node_notify
node_submission_api -->|"formats response"| node_response
node_message_api -->|"checks identity"| node_auth
node_message_api -->|"stores messages"| node_repository
node_message_api -->|"scores sender"| node_spam
node_message_api -->|"notifies staff"| node_notify
node_message_api -->|"formats response"| node_response
node_repository -->|"executes queries"| node_database
node_admin_console -.->|"manages jobs"| node_admin_jobs
node_admin_console -.->|"manages recruiters"| node_admin_recruiters
node_admin_console -.->|"reviews submissions"| node_admin_submissions
node_admin_console -.->|"reviews enquiries"| node_admin_messages

click node_public_site "https://github.com/maazkhurshid60/job-site/blob/main/app/page.tsx"
click node_job_board "https://github.com/maazkhurshid60/job-site/blob/main/app/jobs/page.tsx"
click node_job_details "https://github.com/maazkhurshid60/job-site/blob/main/app/jobs/%5Bid%5D/page.tsx"
click node_contact "https://github.com/maazkhurshid60/job-site/blob/main/app/contact/page.tsx"
click node_recruiter_apply "https://github.com/maazkhurshid60/job-site/blob/main/app/recruiters/apply/page.tsx"
click node_recruiter_dashboard "https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/page.tsx"
click node_recruiter_jobs "https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/jobs/page.tsx"
click node_submissions_ui "https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/submissions/page.tsx"
click node_recruiter_sites "https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/career-site/page.tsx"
click node_site_leads "https://github.com/maazkhurshid60/job-site/blob/main/app/api/sites/%5Bslug%5D/leads/route.ts"
click node_admin_console "https://github.com/maazkhurshid60/job-site/blob/main/app/console-4h9k2xqf/page.tsx"
click node_admin_jobs "https://github.com/maazkhurshid60/job-site/blob/main/app/api/admin/jobs/route.ts"
click node_admin_recruiters "https://github.com/maazkhurshid60/job-site/blob/main/app/api/admin/recruiters/route.ts"
click node_admin_submissions "https://github.com/maazkhurshid60/job-site/blob/main/app/api/admin/submissions/route.ts"
click node_admin_messages "https://github.com/maazkhurshid60/job-site/blob/main/app/api/messages/route.ts"
click node_submission_api "https://github.com/maazkhurshid60/job-site/blob/main/app/api/submissions/route.ts"
click node_message_api "https://github.com/maazkhurshid60/job-site/blob/main/app/api/messages/route.ts"
click node_auth "https://github.com/maazkhurshid60/job-site/blob/main/lib/server/auth.ts"
click node_repository "https://github.com/maazkhurshid60/job-site/blob/main/lib/server/repo.ts"
click node_database "https://github.com/maazkhurshid60/job-site/blob/main/lib/db.ts"
click node_response "https://github.com/maazkhurshid60/job-site/blob/main/lib/server/respond.ts"
click node_job_logic "https://github.com/maazkhurshid60/job-site/blob/main/lib/jobs.ts"
click node_submission_logic "https://github.com/maazkhurshid60/job-site/blob/main/lib/submissions.ts"
click node_user_logic "https://github.com/maazkhurshid60/job-site/blob/main/lib/users.ts"
click node_auth_client "https://github.com/maazkhurshid60/job-site/blob/main/lib/auth.tsx"
click node_firebase "https://github.com/maazkhurshid60/job-site/blob/main/lib/firebase.ts"
click node_notify "https://github.com/maazkhurshid60/job-site/blob/main/lib/server/notify.ts"
click node_spam "https://github.com/maazkhurshid60/job-site/blob/main/lib/server/spamScore.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_public_site,node_job_board,node_job_details,node_contact toneBlue
class node_recruiter_apply,node_recruiter_dashboard,node_recruiter_jobs,node_submissions_ui,node_recruiter_sites,node_site_leads toneAmber
class node_admin_console,node_admin_jobs,node_admin_recruiters,node_admin_submissions,node_admin_messages toneMint
class node_submission_api,node_message_api,node_auth,node_repository,node_database,node_response,node_job_logic,node_submission_logic,node_user_logic,node_auth_client,node_notify,node_spam toneRose
class node_visitor toneIndigo
class node_firebase toneTeal
```

## Components

### Public Marketplace

- [Public site](https://github.com/maazkhurshid60/job-site/blob/main/app/page.tsx): `app/page.tsx`
- [Job board](https://github.com/maazkhurshid60/job-site/blob/main/app/jobs/page.tsx): `app/jobs/page.tsx`
- [Job details](https://github.com/maazkhurshid60/job-site/blob/main/app/jobs/%5Bid%5D/page.tsx): `app/jobs/[id]/page.tsx`
- [Contact enquiries](https://github.com/maazkhurshid60/job-site/blob/main/app/contact/page.tsx): `app/contact/page.tsx`

### Recruiter Workspace

- [Recruiter signup](https://github.com/maazkhurshid60/job-site/blob/main/app/recruiters/apply/page.tsx): `app/recruiters/apply/page.tsx`
- [Recruiter dashboard](https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Recruiter jobs](https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/jobs/page.tsx): `app/dashboard/jobs/page.tsx`
- [Candidate submissions](https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/submissions/page.tsx): `app/dashboard/submissions/page.tsx`
- [Career sites](https://github.com/maazkhurshid60/job-site/blob/main/app/dashboard/career-site/page.tsx): `app/dashboard/career-site/page.tsx`
- [Site leads](https://github.com/maazkhurshid60/job-site/blob/main/app/api/sites/%5Bslug%5D/leads/route.ts): `app/api/sites/[slug]/leads/route.ts`

### Agency Operations

- [Admin console](https://github.com/maazkhurshid60/job-site/blob/main/app/console-4h9k2xqf/page.tsx): `app/console-4h9k2xqf/page.tsx`
- [Job administration](https://github.com/maazkhurshid60/job-site/blob/main/app/api/admin/jobs/route.ts): `app/api/admin/jobs/route.ts`
- [Recruiter administration](https://github.com/maazkhurshid60/job-site/blob/main/app/api/admin/recruiters/route.ts): `app/api/admin/recruiters/route.ts`
- [Submission review](https://github.com/maazkhurshid60/job-site/blob/main/app/api/admin/submissions/route.ts): `app/api/admin/submissions/route.ts`
- [Enquiry management](https://github.com/maazkhurshid60/job-site/blob/main/app/api/messages/route.ts): `app/api/messages/route.ts`

### Application Services

- [Submission API](https://github.com/maazkhurshid60/job-site/blob/main/app/api/submissions/route.ts): `app/api/submissions/route.ts`
- [Message API](https://github.com/maazkhurshid60/job-site/blob/main/app/api/messages/route.ts): `app/api/messages/route.ts`
- [Identity checks](https://github.com/maazkhurshid60/job-site/blob/main/lib/server/auth.ts): `lib/server/auth.ts`
- [Domain repository](https://github.com/maazkhurshid60/job-site/blob/main/lib/server/repo.ts): `lib/server/repo.ts`
- [Application database](https://github.com/maazkhurshid60/job-site/blob/main/lib/db.ts): `lib/db.ts`
- [API response handling](https://github.com/maazkhurshid60/job-site/blob/main/lib/server/respond.ts): `lib/server/respond.ts`
- [Job domain](https://github.com/maazkhurshid60/job-site/blob/main/lib/jobs.ts): `lib/jobs.ts`
- [Submission domain](https://github.com/maazkhurshid60/job-site/blob/main/lib/submissions.ts): `lib/submissions.ts`
- [User domain](https://github.com/maazkhurshid60/job-site/blob/main/lib/users.ts): `lib/users.ts`
- [Client authentication](https://github.com/maazkhurshid60/job-site/blob/main/lib/auth.tsx): `lib/auth.tsx`
- [Email notifications](https://github.com/maazkhurshid60/job-site/blob/main/lib/server/notify.ts): `lib/server/notify.ts`
- [Spam scoring](https://github.com/maazkhurshid60/job-site/blob/main/lib/server/spamScore.ts): `lib/server/spamScore.ts`

### Other components

- **Job seeker / visitor**
- [Firebase identity](https://github.com/maazkhurshid60/job-site/blob/main/lib/firebase.ts): `lib/firebase.ts`

## Connections

- Job seeker / visitor → Job board: browses (evidence: `app/jobs/page.tsx`)
- Job board → Job domain: uses job data (evidence: `app/jobs/page.tsx`)
- Job seeker / visitor → Contact enquiries: sends enquiry
- Contact enquiries → Message API: submits message
- Recruiter dashboard → Client authentication: reads session (evidence: `app/dashboard/page.tsx`)
- Client authentication → Firebase identity: uses identity (evidence: `lib/auth.tsx`)
- Client authentication → User domain: loads user (evidence: `lib/auth.tsx`)
- Recruiter dashboard → Job domain: uses job data (evidence: `app/dashboard/page.tsx`)
- Recruiter dashboard → Submission domain: uses submission data (evidence: `app/dashboard/page.tsx`)
- Recruiter jobs → Job domain: manages roles
- Candidate submissions → Submission API: creates submissions
- Career sites → Site leads: receives leads
- Submission API → Identity checks: checks identity (evidence: `app/api/submissions/route.ts`)
- Submission API → Domain repository: reads and writes (evidence: `app/api/submissions/route.ts`)
- Submission API → Email notifications: notifies staff (evidence: `app/api/submissions/route.ts`)
- Submission API → API response handling: formats response (evidence: `app/api/submissions/route.ts`)
- Message API → Identity checks: checks identity (evidence: `app/api/messages/route.ts`)
- Message API → Domain repository: stores messages (evidence: `app/api/messages/route.ts`)
- Message API → Spam scoring: scores sender (evidence: `app/api/messages/route.ts`)
- Message API → Email notifications: notifies staff (evidence: `app/api/messages/route.ts`)
- Message API → API response handling: formats response (evidence: `app/api/messages/route.ts`)
- Domain repository → Application database: executes queries (evidence: `lib/server/repo.ts`)
- Admin console → Job administration: manages jobs
- Admin console → Recruiter administration: manages recruiters
- Admin console → Submission review: reviews submissions
- Admin console → Enquiry management: reviews enquiries
