# hirego1ai-design/hariom- architecture

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

- Interactive diagram: https://gitdiagram.com/hirego1ai-design/hariom-
- Repository: https://github.com/hirego1ai-design/hariom-

## Overview

HireGo AI is a two-sided hiring platform: candidates build profiles, find jobs, apply, and complete assessments; employers publish roles, evaluate applicants, interview, and make offers. The application route shows candidate submissions can create or resume validation gates, assign assessments, and send confirmation. Employer hiring also includes matching and managed-hiring workflows, while payments and administration support the marketplace. The graph uses documented capabilities and sampled call ownership; unsampled routes and integrations are grouped cautiously rather than assigned speculative wiring.

Main entry points: [`src/app/employer/dashboard/page.tsx`](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/employer/dashboard/page.tsx) (Employer workspace), [`src/app/api/applications/route.ts`](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/applications/route.ts) (Applications), [`src/app/jobs/page.tsx`](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/jobs/page.tsx) (Job discovery), [`src/app/api/assessment/mcq/start/route.ts`](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/assessment/mcq/start/route.ts) (Candidate assessments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_candidate["Candidate journey"]
  node_candidate_ui["Candidate workspace<br/>[page.tsx]"]
  node_profile["Profile and onboarding<br/>[page.tsx]"]
  node_job_search["Job discovery<br/>[page.tsx]"]
  node_application_api["Applications<br/>[route.ts]"]
  node_assessments["Candidate assessments<br/>[route.ts]"]
end

subgraph group_employer["Employer hiring"]
  node_employer_ui["Employer workspace<br/>[page.tsx]"]
  node_jobs_api["Job publishing<br/>[route.ts]"]
  node_matching["Candidate matching"]
  node_pipeline["Hiring pipeline<br/>[HiringPipeline.ts]"]
  node_interviews["Interviews and offers<br/>[route.ts]"]
  node_managed_hiring["Managed hiring<br/>[page.tsx]"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication<br/>[route.ts]"]
  node_payments["Payment routing"]
  node_files["Private file storage<br/>[storage.ts]"]
  node_ai_governance["AI budget controls<br/>[BudgetManager.ts]"]
  node_workflow_engine["Workflow engine<br/>[WorkflowEngine.ts]"]
end

subgraph group_operations["Administration"]
  node_admin_ui["Admin console<br/>[page.tsx]"]
  node_admin_api["Administration APIs<br/>[route.ts]"]
  node_proctoring["Assessment integrity"]
end

node_candidate(("Candidate"))
node_employer(("Employer"))
node_admin(("Administrator"))

node_candidate -->|"builds profile"| node_profile
node_candidate -->|"finds roles"| node_job_search
node_candidate -->|"submits application"| node_application_api
node_job_search -->|"applies to job"| node_application_api
node_application_api -->|"assigns assessment"| node_assessments
node_employer -->|"manages hiring"| node_employer_ui
node_employer_ui -->|"publishes roles"| node_jobs_api
node_employer_ui -->|"reviews matches"| node_matching
node_employer_ui -->|"starts workflow"| node_pipeline
node_pipeline -->|"executes steps"| node_workflow_engine
node_employer_ui -->|"coordinates interviews"| node_interviews
node_employer_ui -->|"requests service"| node_managed_hiring
node_candidate -->|"authenticates"| node_auth
node_employer -->|"authenticates"| node_auth
node_employer_ui -->|"initiates billing"| node_payments
node_application_api -.->|"uses file services"| node_files
node_workflow_engine -.->|"governed AI spending"| node_ai_governance
node_admin -->|"configures platform"| node_admin_ui
node_admin_ui -->|"manages records"| node_admin_api
node_assessments -.->|"monitors sessions"| node_proctoring

click node_candidate_ui "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/candidate/dashboard/page.tsx"
click node_profile "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/onboarding/page.tsx"
click node_job_search "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/jobs/page.tsx"
click node_application_api "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/applications/route.ts"
click node_assessments "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/assessment/mcq/start/route.ts"
click node_employer_ui "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/employer/dashboard/page.tsx"
click node_jobs_api "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/employer/jobs/route.ts"
click node_matching "https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/matching/JobMatchingEngine.ts"
click node_pipeline "https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/workflows/HiringPipeline.ts"
click node_interviews "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/employer/interviews/route.ts"
click node_managed_hiring "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/employer/managed-hiring/page.tsx"
click node_auth "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/auth/login/route.ts"
click node_payments "https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/payments/PaymentGatewayController.ts"
click node_files "https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/storage.ts"
click node_ai_governance "https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/governance/BudgetManager.ts"
click node_workflow_engine "https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/workflows/WorkflowEngine.ts"
click node_admin_ui "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/admin/dashboard/page.tsx"
click node_admin_api "https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/admin/jobs/route.ts"
click node_proctoring "https://github.com/hirego1ai-design/hariom-/blob/main/src/components/proctoring/ProctoringEngine.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_candidate_ui,node_profile,node_job_search,node_application_api,node_assessments toneBlue
class node_employer_ui,node_jobs_api,node_matching,node_pipeline,node_interviews,node_managed_hiring toneAmber
class node_auth,node_payments,node_files,node_ai_governance,node_workflow_engine toneMint
class node_admin_ui,node_admin_api,node_proctoring toneRose
class node_candidate,node_employer,node_admin toneIndigo
```

## Components

### Candidate journey

- [Candidate workspace](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/candidate/dashboard/page.tsx): `src/app/candidate/dashboard/page.tsx`
- [Profile and onboarding](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/onboarding/page.tsx): `src/app/onboarding/page.tsx`
- [Job discovery](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/jobs/page.tsx): `src/app/jobs/page.tsx`
- [Applications](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/applications/route.ts): `src/app/api/applications/route.ts`
- [Candidate assessments](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/assessment/mcq/start/route.ts): `src/app/api/assessment/mcq/start/route.ts`

### Employer hiring

- [Employer workspace](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/employer/dashboard/page.tsx): `src/app/employer/dashboard/page.tsx`
- [Job publishing](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/employer/jobs/route.ts): `src/app/api/employer/jobs/route.ts`
- [Candidate matching](https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/matching/JobMatchingEngine.ts): `src/lib/matching/JobMatchingEngine.ts`
- [Hiring pipeline](https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/workflows/HiringPipeline.ts): `src/lib/workflows/HiringPipeline.ts`
- [Interviews and offers](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/employer/interviews/route.ts): `src/app/api/employer/interviews/route.ts`
- [Managed hiring](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/employer/managed-hiring/page.tsx): `src/app/employer/managed-hiring/page.tsx`

### Platform services

- [Authentication](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/auth/login/route.ts): `src/app/api/auth/login/route.ts`
- [Payment routing](https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/payments/PaymentGatewayController.ts): `src/lib/payments/PaymentGatewayController.ts`
- [Private file storage](https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [AI budget controls](https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/governance/BudgetManager.ts): `src/lib/governance/BudgetManager.ts`
- [Workflow engine](https://github.com/hirego1ai-design/hariom-/blob/main/src/lib/workflows/WorkflowEngine.ts): `src/lib/workflows/WorkflowEngine.ts`

### Administration

- [Admin console](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/admin/dashboard/page.tsx): `src/app/admin/dashboard/page.tsx`
- [Administration APIs](https://github.com/hirego1ai-design/hariom-/blob/main/src/app/api/admin/jobs/route.ts): `src/app/api/admin/jobs/route.ts`
- [Assessment integrity](https://github.com/hirego1ai-design/hariom-/blob/main/src/components/proctoring/ProctoringEngine.tsx): `src/components/proctoring/ProctoringEngine.tsx`

### Other components

- **Candidate**
- **Employer**
- **Administrator**

## Connections

- Candidate → Profile and onboarding: builds profile
- Candidate → Job discovery: finds roles
- Candidate → Applications: submits application
- Job discovery → Applications: applies to job
- Applications → Candidate assessments: assigns assessment
- Employer → Employer workspace: manages hiring
- Employer workspace → Job publishing: publishes roles
- Employer workspace → Candidate matching: reviews matches
- Employer workspace → Hiring pipeline: starts workflow
- Hiring pipeline → Workflow engine: executes steps
- Employer workspace → Interviews and offers: coordinates interviews
- Employer workspace → Managed hiring: requests service
- Candidate → Authentication: authenticates
- Employer → Authentication: authenticates
- Employer workspace → Payment routing: initiates billing
- Applications → Private file storage: uses file services
- Workflow engine → AI budget controls: governed AI spending
- Administrator → Admin console: configures platform
- Admin console → Administration APIs: manages records
- Candidate assessments → Assessment integrity: monitors sessions