# manmeet-bhi/inaquired-supa architecture

> Architecture diagram of the GitHub repository manmeet-bhi/inaquired-supa, 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/manmeet-bhi/inaquired-supa
- Repository: https://github.com/manmeet-bhi/inaquired-supa

## Overview

inaquired is a serverless public job-discovery portal with an administrator console. Candidates browse and filter opportunities, open job details, and apply directly without registration; administrators manage listings and platform settings. Supabase provides the database and documented realtime backbone, while server endpoints handle public job data, SEO, account recovery, and two-factor authentication. The README also documents Supabase Storage for assets and attachments. Some subsystem connections below rely on SOURCE INDEX references or README statements; unsampled implementation details are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/App.tsx) (App routing), [`src/services/jobService.ts`](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/jobService.ts) (Job service), [`src/lib/supabase.ts`](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/lib/supabase.ts) (Supabase), [`netlify/functions/api.ts`](https://github.com/manmeet-bhi/inaquired-supa/blob/main/netlify/functions/api.ts) (Serverless API router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Candidate discovery"]
  node_app["App routing<br/>[App.tsx]"]
  node_home["Job discovery<br/>[HomePage.tsx]"]
  node_detail["Job details<br/>[JobDetailPage.tsx]"]
  node_jobicon["Job icon<br/>[JobIcon.tsx]"]
end

subgraph group_admin["Administration"]
  node_adminpage["Admin console<br/>[AdminPage.tsx]"]
  node_adminlogin["Admin sign-in<br/>[AdminLoginPage.tsx]"]
  node_seo["SEO settings<br/>[SeoPanel.tsx]"]
end

subgraph group_services["Application services"]
  node_jobservice["Job service<br/>[jobService.ts]"]
  node_categoryservice["Category service<br/>[categoryService.ts]"]
  node_supabase[("Supabase<br/>[supabase.ts]")]
  node_storage["Asset storage<br/>[storageService.ts]"]
  node_auth["Admin auth"]
  node_twofactor["Two-factor service"]
  node_seoservice["SEO service<br/>[seoService.ts]"]
  node_seoengine["SEO engine<br/>[seoEngine.ts]"]
end

subgraph group_server["Server and integrations"]
  node_publicapi["Public jobs API"]
  node_recovery["Account recovery API"]
  node_twofactorapi["Two-factor API"]
  node_email["Email delivery"]
  node_api["Serverless API router<br/>[api.ts]"]
end

node_candidate(("Candidate"))

node_candidate -->|"browses"| node_app
node_app -->|"routes to"| node_home
node_home -->|"loads jobs"| node_jobservice
node_home -->|"loads categories"| node_categoryservice
node_app -->|"subscribes to jobs"| node_jobservice
node_app -->|"subscribes to categories"| node_categoryservice
node_app -->|"routes to"| node_detail
node_jobservice -->|"queries and syncs"| node_supabase
node_jobservice -->|"fetches public jobs"| node_publicapi
node_api -->|"dispatches"| node_publicapi
node_api -->|"dispatches"| node_recovery
node_api -->|"dispatches"| node_twofactorapi
node_api -->|"dispatches SEO"| node_seoengine
node_adminpage -->|"manages listings"| node_jobservice
node_adminlogin -->|"authenticates"| node_auth
node_adminlogin -->|"uses verification"| node_twofactor
node_auth -->|"uses auth and RPC"| node_supabase
node_twofactor -->|"uses client"| node_supabase
node_adminpage -->|"opens SEO settings"| node_seo
node_seo -->|"manages settings"| node_seoservice
node_seoengine -->|"loads SEO settings"| node_seoservice
node_seoengine -->|"reads job data"| node_supabase
node_recovery -->|"sends reset email"| node_email
node_twofactorapi -->|"sends 2FA email"| node_email
node_twofactorapi -->|"uses auth helpers"| node_recovery
node_storage -.->|"uploads assets"| node_supabase
node_home -->|"renders"| node_jobicon

click node_app "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/App.tsx"
click node_home "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/HomePage.tsx"
click node_detail "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/JobDetailPage.tsx"
click node_jobservice "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/jobService.ts"
click node_categoryservice "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/categoryService.ts"
click node_supabase "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/lib/supabase.ts"
click node_storage "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/storageService.ts"
click node_adminpage "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/admin/AdminPage.tsx"
click node_adminlogin "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/admin/AdminLoginPage.tsx"
click node_auth "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/adminAuthService.ts"
click node_twofactor "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/twoFactorService.ts"
click node_seo "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/components/admin/SeoPanel.tsx"
click node_seoservice "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/seoService.ts"
click node_seoengine "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/lib/seo/seoEngine.ts"
click node_publicapi "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/publicJobsHandler.ts"
click node_recovery "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/recoveryApiHandlers.ts"
click node_twofactorapi "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/twoFactorApiHandlers.ts"
click node_email "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/resendEmailService.ts"
click node_api "https://github.com/manmeet-bhi/inaquired-supa/blob/main/netlify/functions/api.ts"
click node_jobicon "https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/components/icons/JobIcon.tsx"

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_home,node_detail,node_jobicon toneBlue
class node_adminpage,node_adminlogin,node_seo toneAmber
class node_jobservice,node_categoryservice,node_supabase,node_storage,node_auth,node_twofactor,node_seoservice,node_seoengine toneMint
class node_publicapi,node_recovery,node_twofactorapi,node_email,node_api toneRose
class node_candidate toneIndigo
```

## Components

### Candidate discovery

- [App routing](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/App.tsx): `src/App.tsx`
- [Job discovery](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/HomePage.tsx): `src/pages/HomePage.tsx`
- [Job details](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/JobDetailPage.tsx): `src/pages/JobDetailPage.tsx`
- [Job icon](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/components/icons/JobIcon.tsx): `src/components/icons/JobIcon.tsx`

### Administration

- [Admin console](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/admin/AdminPage.tsx): `src/pages/admin/AdminPage.tsx`
- [Admin sign-in](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/pages/admin/AdminLoginPage.tsx): `src/pages/admin/AdminLoginPage.tsx`
- [SEO settings](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/components/admin/SeoPanel.tsx): `src/components/admin/SeoPanel.tsx`

### Application services

- [Job service](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/jobService.ts): `src/services/jobService.ts`
- [Category service](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/categoryService.ts): `src/services/categoryService.ts`
- [Supabase](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Asset storage](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/storageService.ts): `src/services/storageService.ts`
- [Admin auth](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/adminAuthService.ts): `src/services/adminAuthService.ts`
- [Two-factor service](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/twoFactorService.ts): `src/services/twoFactorService.ts`
- [SEO service](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/services/seoService.ts): `src/services/seoService.ts`
- [SEO engine](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/lib/seo/seoEngine.ts): `src/lib/seo/seoEngine.ts`

### Server and integrations

- [Public jobs API](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/publicJobsHandler.ts): `src/server/publicJobsHandler.ts`
- [Account recovery API](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/recoveryApiHandlers.ts): `src/server/recoveryApiHandlers.ts`
- [Two-factor API](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/twoFactorApiHandlers.ts): `src/server/twoFactorApiHandlers.ts`
- [Email delivery](https://github.com/manmeet-bhi/inaquired-supa/blob/main/src/server/resendEmailService.ts): `src/server/resendEmailService.ts`
- [Serverless API router](https://github.com/manmeet-bhi/inaquired-supa/blob/main/netlify/functions/api.ts): `netlify/functions/api.ts`

### Other components

- **Candidate**

## Connections

- Candidate → App routing: browses (evidence: `README.md`)
- App routing → Job discovery: routes to (evidence: `src/App.tsx`)
- Job discovery → Job service: loads jobs (evidence: `src/pages/HomePage.tsx`)
- Job discovery → Category service: loads categories (evidence: `src/pages/HomePage.tsx`)
- App routing → Job service: subscribes to jobs (evidence: `src/App.tsx`)
- App routing → Category service: subscribes to categories (evidence: `src/App.tsx`)
- App routing → Job details: routes to (evidence: `src/App.tsx`)
- Job service → Supabase: queries and syncs (evidence: `src/services/jobService.ts`)
- Job service → Public jobs API: fetches public jobs (evidence: `src/services/jobService.ts`)
- Serverless API router → Public jobs API: dispatches (evidence: `netlify/functions/api.ts`)
- Serverless API router → Account recovery API: dispatches (evidence: `netlify/functions/api.ts`)
- Serverless API router → Two-factor API: dispatches (evidence: `netlify/functions/api.ts`)
- Serverless API router → SEO engine: dispatches SEO (evidence: `netlify/functions/api.ts`)
- Admin console → Job service: manages listings (evidence: `src/pages/admin/AdminPage.tsx`)
- Admin sign-in → Admin auth: authenticates (evidence: `src/pages/admin/AdminLoginPage.tsx`)
- Admin sign-in → Two-factor service: uses verification (evidence: `src/pages/admin/AdminLoginPage.tsx`)
- Admin auth → Supabase: uses auth and RPC (evidence: `src/services/adminAuthService.ts`)
- Two-factor service → Supabase: uses client (evidence: `src/services/twoFactorService.ts`)
- Admin console → SEO settings: opens SEO settings (evidence: `src/pages/admin/AdminPage.tsx`)
- SEO settings → SEO service: manages settings (evidence: `src/components/admin/SeoPanel.tsx`)
- SEO engine → SEO service: loads SEO settings (evidence: `src/lib/seo/seoEngine.ts`)
- SEO engine → Supabase: reads job data (evidence: `src/lib/seo/seoEngine.ts`)
- Account recovery API → Email delivery: sends reset email (evidence: `src/server/recoveryApiHandlers.ts`)
- Two-factor API → Email delivery: sends 2FA email (evidence: `src/server/twoFactorApiHandlers.ts`)
- Two-factor API → Account recovery API: uses auth helpers (evidence: `src/server/twoFactorApiHandlers.ts`)
- Asset storage → Supabase: uploads assets (evidence: `README.md`)
- Job discovery → Job icon: renders (evidence: `src/pages/HomePage.tsx`)
