# deepaksondal/dvt-talent-ai architecture

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

- Interactive diagram: https://gitdiagram.com/deepaksondal/dvt-talent-ai
- Repository: https://github.com/deepaksondal/dvt-talent-ai

## Overview

DVT Talent AI is a dual-sided recruitment platform: recruiters manage jobs and candidates in a workspace, while job seekers use a candidate portal. The recruiter workflow runs through the web app and API into agent-led discovery, sourcing, audit, screening, and outreach, with persistence and optional ATS/mail integrations. The candidate branch supports resume-based matching and privacy controls. The README documents additional billing, compliance, analytics, and real-time capabilities; those branches are represented at their existing route or service directories. Some links are dashed where sampled source does not establish the runtime connection.

Main entry points: [`backend/agents/orchestrator.py`](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/orchestrator.py) (Agent orchestrator), [`backend/db/models.py`](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/db/models.py) (Relational data), [`backend/main.py`](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/main.py) (FastAPI application), [`backend/api/routes`](https://github.com/deepaksondal/dvt-talent-ai/tree/main/backend/api/routes) (Product API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web Workspaces"]
  node_recruiter["Recruiter workspace"]
  node_candidate["Candidate portal"]
  node_web_services["Web API services"]
end

subgraph group_api["API &amp; Identity"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_api_routes["Product API routes"]
  node_agents_api["Agent API<br/>[agents.py]"]
end

subgraph group_talent["Talent Operations"]
  node_orchestrator["Agent orchestrator<br/>[orchestrator.py]"]
  node_discovery["Job discovery"]
  node_sourcing["Candidate sourcing"]
  node_critic["Bias audit<br/>[critic_pydantic.py]"]
  node_screening["Candidate screening"]
  node_outreach["Candidate outreach"]
  node_analytics["Recruiting analytics"]
end

subgraph group_platform["Platform Services"]
  node_tasks["Background tasks<br/>[tasks.py]"]
  node_models[("Relational data<br/>[models.py]")]
  node_vectors[("Semantic search<br/>[vector_store.py]")]
  node_resume["Resume parsing<br/>[resume_parser.py]"]
  node_privacy["Privacy &amp; erasure<br/>[privacy_service.py]"]
  node_guardrails["LLM guardrails"]
  node_redis[("Redis services<br/>[redis_service.py]")]
  node_compliance["Compliance services"]
  node_billing["Billing API<br/>[billing.py]"]
end

subgraph group_integrations["External Integrations"]
  node_email["Email delivery<br/>[email_service.py]"]
  node_ats["ATS integration<br/>[unified_ats.py]"]
  node_ats_tasks["ATS sync tasks<br/>[ats_tasks.py]"]
end

node_recruiter_actor(("Recruiter"))
node_job_seeker(("Job seeker"))
node_llm{{"LLM providers"}}
node_mail_providers{{"Mailbox providers"}}
node_ats_providers{{"ATS providers"}}

node_recruiter_actor -->|"uses"| node_recruiter
node_job_seeker -->|"uses"| node_candidate
node_recruiter -.->|"requests data"| node_web_services
node_candidate -.->|"requests data"| node_web_services
node_web_services -.->|"calls API"| node_api_app
node_api_app -->|"registers routes"| node_auth
node_api_app -->|"registers routes"| node_api_routes
node_api_app -->|"registers route"| node_agents_api
node_agents_api -.->|"dispatches agents"| node_orchestrator
node_orchestrator -->|"runs discovery"| node_discovery
node_orchestrator -->|"runs sourcing"| node_sourcing
node_orchestrator -->|"audits results"| node_critic
node_orchestrator -->|"runs screening"| node_screening
node_orchestrator -->|"runs outreach"| node_outreach
node_orchestrator -->|"runs analytics"| node_analytics
node_orchestrator -->|"uses safeguards"| node_guardrails
node_orchestrator -->|"persists results"| node_models
node_sourcing -->|"parses resumes"| node_resume
node_sourcing -->|"searches candidates"| node_vectors
node_sourcing -->|"reads candidate data"| node_models
node_critic -.->|"uses decision data"| node_models
node_tasks -->|"invokes agent"| node_orchestrator
node_tasks -->|"updates candidates"| node_models
node_privacy -->|"erases records"| node_models
node_privacy -->|"deletes embeddings"| node_vectors
node_privacy -->|"clears cache"| node_redis
node_api_routes -.->|"handles erasure"| node_privacy
node_api_routes -.->|"serves compliance"| node_compliance
node_api_routes -.->|"serves billing"| node_billing
node_email -->|"sends mail"| node_mail_providers
node_orchestrator -.->|"sends outreach"| node_email
node_ats_tasks -->|"runs synchronization"| node_ats
node_ats -->|"connects ATS"| node_ats_providers
node_orchestrator -.->|"runs models"| node_llm

click node_recruiter "https://github.com/deepaksondal/dvt-talent-ai/tree/main/frontend/src/app/dashboard"
click node_candidate "https://github.com/deepaksondal/dvt-talent-ai/tree/main/frontend/src/app/portal"
click node_web_services "https://github.com/deepaksondal/dvt-talent-ai/tree/main/frontend/src/services"
click node_api_app "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/main.py"
click node_auth "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/api/routes/auth.py"
click node_api_routes "https://github.com/deepaksondal/dvt-talent-ai/tree/main/backend/api/routes"
click node_agents_api "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/api/routes/agents.py"
click node_orchestrator "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/orchestrator.py"
click node_discovery "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/discovery_pydantic.py"
click node_sourcing "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/sourcing_pydantic.py"
click node_critic "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/critic_pydantic.py"
click node_screening "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/screening_pydantic.py"
click node_outreach "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/outreach_pydantic.py"
click node_analytics "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/analytics_pydantic.py"
click node_tasks "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/workers/tasks.py"
click node_models "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/db/models.py"
click node_vectors "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/db/vector_store.py"
click node_resume "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/resume_parser.py"
click node_privacy "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/privacy_service.py"
click node_guardrails "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/llm_guardrail_service.py"
click node_redis "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/redis_service.py"
click node_compliance "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/compliance_service.py"
click node_billing "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/api/routes/billing.py"
click node_email "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/email_service.py"
click node_ats "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/integrations/unified_ats.py"
click node_ats_tasks "https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/workers/ats_tasks.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_recruiter,node_candidate,node_web_services toneBlue
class node_api_app,node_auth,node_api_routes,node_agents_api toneAmber
class node_orchestrator,node_discovery,node_sourcing,node_critic,node_screening,node_outreach,node_analytics toneMint
class node_tasks,node_models,node_vectors,node_resume,node_privacy,node_guardrails,node_redis,node_compliance,node_billing toneRose
class node_email,node_ats,node_ats_tasks,node_recruiter_actor,node_job_seeker,node_llm,node_mail_providers,node_ats_providers toneIndigo
```

## Components

### Web Workspaces

- [Recruiter workspace](https://github.com/deepaksondal/dvt-talent-ai/tree/main/frontend/src/app/dashboard): `frontend/src/app/dashboard`
- [Candidate portal](https://github.com/deepaksondal/dvt-talent-ai/tree/main/frontend/src/app/portal): `frontend/src/app/portal`
- [Web API services](https://github.com/deepaksondal/dvt-talent-ai/tree/main/frontend/src/services): `frontend/src/services`

### API & Identity

- [FastAPI application](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/main.py): `backend/main.py`
- [Authentication](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/api/routes/auth.py): `backend/api/routes/auth.py`
- [Product API routes](https://github.com/deepaksondal/dvt-talent-ai/tree/main/backend/api/routes): `backend/api/routes`
- [Agent API](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/api/routes/agents.py): `backend/api/routes/agents.py`

### Talent Operations

- [Agent orchestrator](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/orchestrator.py): `backend/agents/orchestrator.py`
- [Job discovery](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/discovery_pydantic.py): `backend/agents/discovery_pydantic.py`
- [Candidate sourcing](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/sourcing_pydantic.py): `backend/agents/sourcing_pydantic.py`
- [Bias audit](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/critic_pydantic.py): `backend/agents/critic_pydantic.py`
- [Candidate screening](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/screening_pydantic.py): `backend/agents/screening_pydantic.py`
- [Candidate outreach](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/outreach_pydantic.py): `backend/agents/outreach_pydantic.py`
- [Recruiting analytics](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/agents/analytics_pydantic.py): `backend/agents/analytics_pydantic.py`

### Platform Services

- [Background tasks](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/workers/tasks.py): `backend/workers/tasks.py`
- [Relational data](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/db/models.py): `backend/db/models.py`
- [Semantic search](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/db/vector_store.py): `backend/db/vector_store.py`
- [Resume parsing](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/resume_parser.py): `backend/services/resume_parser.py`
- [Privacy & erasure](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/privacy_service.py): `backend/services/privacy_service.py`
- [LLM guardrails](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/llm_guardrail_service.py): `backend/services/llm_guardrail_service.py`
- [Redis services](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/redis_service.py): `backend/services/redis_service.py`
- [Compliance services](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/compliance_service.py): `backend/services/compliance_service.py`
- [Billing API](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/api/routes/billing.py): `backend/api/routes/billing.py`

### External Integrations

- [Email delivery](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/services/email_service.py): `backend/services/email_service.py`
- [ATS integration](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/integrations/unified_ats.py): `backend/integrations/unified_ats.py`
- [ATS sync tasks](https://github.com/deepaksondal/dvt-talent-ai/blob/main/backend/workers/ats_tasks.py): `backend/workers/ats_tasks.py`

### Other components

- **Recruiter**
- **Job seeker**
- **LLM providers**
- **Mailbox providers**
- **ATS providers**

## Connections

- Recruiter → Recruiter workspace: uses
- Job seeker → Candidate portal: uses
- Recruiter workspace → Web API services: requests data
- Candidate portal → Web API services: requests data
- Web API services → FastAPI application: calls API
- FastAPI application → Authentication: registers routes (evidence: `backend/main.py`)
- FastAPI application → Product API routes: registers routes (evidence: `backend/main.py`)
- FastAPI application → Agent API: registers route (evidence: `backend/main.py`)
- Agent API → Agent orchestrator: dispatches agents
- Agent orchestrator → Job discovery: runs discovery (evidence: `backend/agents/orchestrator.py`)
- Agent orchestrator → Candidate sourcing: runs sourcing (evidence: `backend/agents/orchestrator.py`)
- Agent orchestrator → Bias audit: audits results (evidence: `backend/agents/orchestrator.py`)
- Agent orchestrator → Candidate screening: runs screening (evidence: `backend/agents/orchestrator.py`)
- Agent orchestrator → Candidate outreach: runs outreach (evidence: `backend/agents/orchestrator.py`)
- Agent orchestrator → Recruiting analytics: runs analytics (evidence: `backend/agents/orchestrator.py`)
- Agent orchestrator → LLM guardrails: uses safeguards (evidence: `backend/agents/orchestrator.py`)
- Agent orchestrator → Relational data: persists results (evidence: `backend/agents/orchestrator.py`)
- Candidate sourcing → Resume parsing: parses resumes (evidence: `backend/agents/sourcing_pydantic.py`)
- Candidate sourcing → Semantic search: searches candidates (evidence: `backend/agents/sourcing_pydantic.py`)
- Candidate sourcing → Relational data: reads candidate data (evidence: `backend/agents/sourcing_pydantic.py`)
- Bias audit → Relational data: uses decision data
- Background tasks → Agent orchestrator: invokes agent (evidence: `backend/workers/tasks.py`)
- Background tasks → Relational data: updates candidates (evidence: `backend/workers/tasks.py`)
- Privacy & erasure → Relational data: erases records (evidence: `backend/services/privacy_service.py`)
- Privacy & erasure → Semantic search: deletes embeddings (evidence: `backend/services/privacy_service.py`)
- Privacy & erasure → Redis services: clears cache (evidence: `backend/services/privacy_service.py`)
- Product API routes → Privacy & erasure: handles erasure
- Product API routes → Compliance services: serves compliance
- Product API routes → Billing API: serves billing
- Email delivery → Mailbox providers: sends mail (evidence: `backend/services/email_service.py`)
- Agent orchestrator → Email delivery: sends outreach (evidence: `backend/agents/orchestrator.py`)
- ATS sync tasks → ATS integration: runs synchronization (evidence: `backend/workers/ats_tasks.py`)
- ATS integration → ATS providers: connects ATS (evidence: `backend/integrations/unified_ats.py`)
- Agent orchestrator → LLM providers: runs models
