# bansidesai02/hybent architecture

> Architecture diagram of the GitHub repository bansidesai02/hybent, 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/bansidesai02/hybent
- Repository: https://github.com/bansidesai02/hybent

## Overview

Hybent Hiring is a multi-tenant, AI-assisted recruiting platform: recruiters create jobs, ingest resumes, evaluate candidates, and move applications through a hiring pipeline, while interviewers and candidates use role-specific views. The React application calls a FastAPI backend whose routers expose recruiting workflows and whose SQLAlchemy models represent persisted hiring data. Documented capabilities also include interviews, scorecards, offers, analytics, billing, email ingestion, and AI copilot features. Some feature links below are documented rather than verified in sampled call sites; those edges are dashed where wiring is unconfirmed.

Main entry points: [`hybent-hiring-backend/app/services/email_ingestion_service.py`](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/email_ingestion_service.py) (Resume ingestion), [`hybent-hiring-frontend/src/App.tsx`](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/App.tsx) (Hiring frontend), [`hybent-hiring-backend/app/routers/pipeline.py`](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/pipeline.py) (Pipeline endpoints), [`hybent-hiring-frontend/src/app/AppRoutes.tsx`](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/app/AppRoutes.tsx) (Role routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_web_app["Hiring frontend<br/>[App.tsx]"]
  node_web_routes["Role routes<br/>[AppRoutes.tsx]"]
  node_pipeline_view["Pipeline board<br/>[PipelinePage.tsx]"]
  node_pipeline_api["Pipeline client<br/>[pipeline.ts]"]
end

subgraph group_api["API and access"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_api_router["API router registry<br/>[api.py]"]
end

subgraph group_hiring["Hiring workflow"]
  node_pipeline_router["Pipeline endpoints<br/>[pipeline.py]"]
  node_candidate_records[("Candidate records<br/>[candidate.py]")]
  node_application_records[("Application records<br/>[application.py]")]
  node_resume_ingestion["Resume ingestion"]
  node_interviews["Interviews and scorecards<br/>[interviews.py]"]
  node_offers["Offers<br/>[offers.py]"]
  node_analytics["Recruiting analytics<br/>[analytics.py]"]
end

subgraph group_intelligence["AI and integrations"]
  node_resume_ai["Resume parsing<br/>[resume_parser.py]"]
  node_ai_metering["AI usage metering<br/>[ai_metering.py]"]
  node_copilot["Recruiter copilot<br/>[service.py]"]
  node_ai_provider{{"Gemini AI"}}
end

subgraph group_platform["Platform services"]
  node_email_ingestion_task["Email ingestion task<br/>[email_ingestion.py]"]
  node_database[("PostgreSQL<br/>[database.py]")]
  node_realtime["Realtime notifications<br/>[manager.py]"]
end

node_recruiter(("Recruiter"))
node_interviewer(("Interviewer"))
node_candidate(("Candidate"))
node_external_mail{{"Connected mailboxes"}}

node_recruiter -->|"uses"| node_web_app
node_interviewer -->|"uses"| node_web_app
node_candidate -->|"uses"| node_web_app
node_web_app -->|"routes through"| node_web_routes
node_web_routes -.->|"offers workflow"| node_pipeline_view
node_pipeline_view -.->|"loads pipeline"| node_pipeline_api
node_web_app -.->|"calls API"| node_api_app
node_api_app -->|"registers"| node_api_router
node_pipeline_router -->|"reads and updates"| node_application_records
node_pipeline_router -->|"reads candidate"| node_candidate_records
node_resume_ingestion -->|"creates candidate"| node_candidate_records
node_resume_ingestion -->|"parses resume"| node_resume_ai
node_resume_ingestion -.->|"uses metering"| node_ai_metering
node_ai_provider -.->|"parses with"| node_resume_ai
node_recruiter -.->|"asks questions"| node_copilot
node_interviewer -->|"submits feedback"| node_interviews
node_candidate -->|"responds to offer"| node_offers
node_recruiter -->|"reviews metrics"| node_analytics
node_external_mail -.->|"provides resumes"| node_email_ingestion_task
node_email_ingestion_task -->|"runs ingestion"| node_resume_ingestion
node_resume_ingestion -.->|"persists hiring data"| node_database
node_interviewer -.->|"receives updates"| node_realtime

click node_web_app "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/App.tsx"
click node_web_routes "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/app/AppRoutes.tsx"
click node_pipeline_view "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/modules/recruiter/pages/PipelinePage.tsx"
click node_pipeline_api "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/api/pipeline.ts"
click node_api_app "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/main.py"
click node_api_router "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/api.py"
click node_pipeline_router "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/pipeline.py"
click node_candidate_records "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/models/candidate.py"
click node_application_records "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/models/application.py"
click node_resume_ingestion "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/email_ingestion_service.py"
click node_resume_ai "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/ai/resume_parser.py"
click node_ai_metering "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/ai_metering.py"
click node_copilot "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/agents/copilot/service.py"
click node_interviews "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/interviews.py"
click node_offers "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/offers.py"
click node_analytics "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/analytics.py"
click node_email_ingestion_task "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/tasks/email_ingestion.py"
click node_database "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/core/database.py"
click node_realtime "https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/websocket/manager.py"

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_web_app,node_web_routes,node_pipeline_view,node_pipeline_api,node_interviewer toneBlue
class node_api_app,node_api_router toneAmber
class node_pipeline_router,node_candidate_records,node_application_records,node_resume_ingestion,node_interviews,node_offers,node_analytics toneMint
class node_resume_ai,node_ai_metering,node_copilot,node_ai_provider toneRose
class node_email_ingestion_task,node_database,node_realtime,node_recruiter,node_candidate,node_external_mail toneIndigo
```

## Components

### Web application

- [Hiring frontend](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/App.tsx): `hybent-hiring-frontend/src/App.tsx`
- [Role routes](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/app/AppRoutes.tsx): `hybent-hiring-frontend/src/app/AppRoutes.tsx`
- [Pipeline board](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/modules/recruiter/pages/PipelinePage.tsx): `hybent-hiring-frontend/src/modules/recruiter/pages/PipelinePage.tsx`
- [Pipeline client](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-frontend/src/api/pipeline.ts): `hybent-hiring-frontend/src/api/pipeline.ts`

### API and access

- [FastAPI app](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/main.py): `hybent-hiring-backend/app/main.py`
- [API router registry](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/api.py): `hybent-hiring-backend/app/routers/api.py`

### Hiring workflow

- [Pipeline endpoints](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/pipeline.py): `hybent-hiring-backend/app/routers/pipeline.py`
- [Candidate records](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/models/candidate.py): `hybent-hiring-backend/app/models/candidate.py`
- [Application records](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/models/application.py): `hybent-hiring-backend/app/models/application.py`
- [Resume ingestion](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/email_ingestion_service.py): `hybent-hiring-backend/app/services/email_ingestion_service.py`
- [Interviews and scorecards](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/interviews.py): `hybent-hiring-backend/app/routers/interviews.py`
- [Offers](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/offers.py): `hybent-hiring-backend/app/routers/offers.py`
- [Recruiting analytics](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/routers/analytics.py): `hybent-hiring-backend/app/routers/analytics.py`

### AI and integrations

- [Resume parsing](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/ai/resume_parser.py): `hybent-hiring-backend/app/services/ai/resume_parser.py`
- [AI usage metering](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/ai_metering.py): `hybent-hiring-backend/app/services/ai_metering.py`
- [Recruiter copilot](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/services/agents/copilot/service.py): `hybent-hiring-backend/app/services/agents/copilot/service.py`
- **Gemini AI**

### Platform services

- [Email ingestion task](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/tasks/email_ingestion.py): `hybent-hiring-backend/app/tasks/email_ingestion.py`
- [PostgreSQL](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/core/database.py): `hybent-hiring-backend/app/core/database.py`
- [Realtime notifications](https://github.com/bansidesai02/hybent/blob/main/hybent-hiring-backend/app/websocket/manager.py): `hybent-hiring-backend/app/websocket/manager.py`

### Other components

- **Recruiter**
- **Interviewer**
- **Candidate**
- **Connected mailboxes**

## Connections

- Recruiter → Hiring frontend: uses
- Interviewer → Hiring frontend: uses
- Candidate → Hiring frontend: uses
- Hiring frontend → Role routes: routes through
- Role routes → Pipeline board: offers workflow
- Pipeline board → Pipeline client: loads pipeline
- Hiring frontend → FastAPI app: calls API
- FastAPI app → API router registry: registers (evidence: `hybent-hiring-backend/app/main.py`)
- Pipeline endpoints → Application records: reads and updates (evidence: `hybent-hiring-backend/app/routers/pipeline.py`)
- Pipeline endpoints → Candidate records: reads candidate (evidence: `hybent-hiring-backend/app/routers/pipeline.py`)
- Resume ingestion → Candidate records: creates candidate (evidence: `hybent-hiring-backend/app/services/email_ingestion_service.py`)
- Resume ingestion → Resume parsing: parses resume (evidence: `hybent-hiring-backend/app/services/email_ingestion_service.py`)
- Resume ingestion → AI usage metering: uses metering
- Gemini AI → Resume parsing: parses with
- Recruiter → Recruiter copilot: asks questions
- Interviewer → Interviews and scorecards: submits feedback
- Candidate → Offers: responds to offer
- Recruiter → Recruiting analytics: reviews metrics
- Connected mailboxes → Email ingestion task: provides resumes
- Email ingestion task → Resume ingestion: runs ingestion (evidence: `hybent-hiring-backend/app/tasks/email_ingestion.py`)
- Resume ingestion → PostgreSQL: persists hiring data
- Interviewer → Realtime notifications: receives updates
