# ojas2005/intelligentrecruitmentassistant architecture

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

- Interactive diagram: https://gitdiagram.com/ojas2005/intelligentrecruitmentassistant
- Repository: https://github.com/ojas2005/intelligentrecruitmentassistant

## Overview

IRA is an AI-assisted recruitment platform: recruiters manage job descriptions and upload resumes, which are extracted, parsed and embedded; candidates are evaluated against roles, ranked, and given interview kits with grounded explanations and an audit trail. The MVC web app calls the API, which coordinates application services and specialized agents over persistence, document, storage, and search abstractions. README capabilities cover both recruiter and candidate portals, authentication, RAG, interview generation, ranking, and audit. Several evaluation and UI implementation files are unsampled, so those connections are shown only where README or indexed source supports them.

Main entry points: [`src/IRA.Application/Services/ResumeProcessingService.cs`](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/ResumeProcessingService.cs) (Resume processing), [`src/IRA.Application/Services/RecruitmentOrchestrator.cs`](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/RecruitmentOrchestrator.cs) (Evaluation orchestration), [`src/IRA.Web/Services/RecruitmentApiClient.cs`](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Web/Services/RecruitmentApiClient.cs) (API client), [`src/IRA.Infrastructure/Search/RagRetrievalService.cs`](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Infrastructure/Search/RagRetrievalService.cs) (RAG retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web portals"]
  node_web_portal["Role portals<br/>[Controllers]"]
  node_api_client["API client"]
end

subgraph group_api["API and identity"]
  node_api_host["API host<br/>[Program.cs]"]
  node_auth["JWT identity<br/>[AuthController.cs]"]
  node_resume_api["Resume endpoint"]
  node_job_api["Job and evaluation API<br/>[Controllers]"]
end

subgraph group_app["Recruitment workflows"]
  node_resume_flow["Resume processing"]
  node_orchestrator["Evaluation orchestration"]
  node_job_service["Job descriptions"]
  node_domain["Talent domain<br/>[Candidate.cs]"]
end

subgraph group_ai["AI and grounding"]
  node_parser["Resume parser"]
  node_matching["Matching and ranking agents<br/>[Agents]"]
  node_interview_review["Interview and review agents<br/>[Agents]"]
  node_rag["RAG retrieval"]
  node_generation["Text generation"]
end

subgraph group_data["Persistence and services"]
  node_repository[("Talent repository")]
  node_audit[("Audit trail<br/>[IAuditLogger.cs]")]
  node_blob["Resume storage<br/>[IBlobStorage.cs]"]
  node_documents["Document extraction"]
  node_vectors[("Vector search<br/>[IVectorStore.cs]")]
  node_embeddings["Embedding generation"]
end

node_recruiter(("Recruiter"))
node_candidate(("Candidate"))

node_recruiter -->|"uses"| node_web_portal
node_candidate -->|"uses"| node_web_portal
node_web_portal -->|"requests"| node_api_client
node_api_client -->|"logs in"| node_auth
node_api_client -->|"uploads resume"| node_resume_api
node_api_client -->|"requests"| node_job_api
node_api_host -->|"maps controllers"| node_resume_api
node_api_host -->|"configures auth"| node_auth
node_auth -->|"logs events"| node_audit
node_resume_api -->|"processes upload"| node_resume_flow
node_job_api -.->|"manages jobs"| node_job_service
node_job_api -.->|"starts evaluation"| node_orchestrator
node_resume_flow -->|"stores file"| node_blob
node_resume_flow -->|"saves records"| node_repository
node_resume_flow -->|"extracts text"| node_documents
node_resume_flow -->|"parses text"| node_parser
node_resume_flow -->|"embeds text"| node_embeddings
node_resume_flow -->|"indexes profile"| node_vectors
node_resume_flow -->|"logs outcome"| node_audit
node_parser -->|"generates parse"| node_generation
node_resume_flow -->|"builds candidate"| node_domain
node_orchestrator -.->|"coordinates agents"| node_matching
node_orchestrator -.->|"requests questions and review"| node_interview_review
node_orchestrator -.->|"grounds evaluation"| node_rag
node_matching -.->|"retrieves criteria"| node_rag
node_rag -->|"embeds query"| node_embeddings
node_rag -->|"searches vectors"| node_vectors
node_matching -.->|"generates evaluation"| node_generation
node_orchestrator -.->|"persists results"| node_repository
node_orchestrator -.->|"records actions"| node_audit
node_job_service -.->|"stores job descriptions"| node_repository

click node_web_portal "https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Web/Controllers"
click node_api_client "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Web/Services/RecruitmentApiClient.cs"
click node_api_host "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Api/Program.cs"
click node_auth "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Api/Controllers/AuthController.cs"
click node_resume_api "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Api/Controllers/ResumeController.cs"
click node_job_api "https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Api/Controllers"
click node_resume_flow "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/ResumeProcessingService.cs"
click node_orchestrator "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/RecruitmentOrchestrator.cs"
click node_job_service "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/JobDescriptionService.cs"
click node_domain "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Domain/Entities/Candidate.cs"
click node_parser "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Infrastructure/Agents/ResumeParserAgent.cs"
click node_matching "https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Infrastructure/Agents"
click node_interview_review "https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Infrastructure/Agents"
click node_rag "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Infrastructure/Search/RagRetrievalService.cs"
click node_generation "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Infrastructure/AI/SemanticKernelTextGenerationService.cs"
click node_repository "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Persistence/ITalentRepository.cs"
click node_audit "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Audit/IAuditLogger.cs"
click node_blob "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Storage/IBlobStorage.cs"
click node_documents "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Documents/IDocumentExtractor.cs"
click node_vectors "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Search/IVectorStore.cs"
click node_embeddings "https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/AI/IEmbeddingGenerator.cs"

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_portal,node_api_client toneBlue
class node_api_host,node_auth,node_resume_api,node_job_api toneAmber
class node_resume_flow,node_orchestrator,node_job_service,node_domain toneMint
class node_parser,node_matching,node_interview_review,node_rag,node_generation toneRose
class node_repository,node_audit,node_blob,node_documents,node_vectors,node_embeddings,node_recruiter,node_candidate toneIndigo
```

## Components

### Web portals

- [Role portals](https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Web/Controllers): `src/IRA.Web/Controllers`
- [API client](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Web/Services/RecruitmentApiClient.cs): `src/IRA.Web/Services/RecruitmentApiClient.cs`

### API and identity

- [API host](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Api/Program.cs): `src/IRA.Api/Program.cs`
- [JWT identity](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Api/Controllers/AuthController.cs): `src/IRA.Api/Controllers/AuthController.cs`
- [Resume endpoint](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Api/Controllers/ResumeController.cs): `src/IRA.Api/Controllers/ResumeController.cs`
- [Job and evaluation API](https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Api/Controllers): `src/IRA.Api/Controllers`

### Recruitment workflows

- [Resume processing](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/ResumeProcessingService.cs): `src/IRA.Application/Services/ResumeProcessingService.cs`
- [Evaluation orchestration](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/RecruitmentOrchestrator.cs): `src/IRA.Application/Services/RecruitmentOrchestrator.cs`
- [Job descriptions](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Services/JobDescriptionService.cs): `src/IRA.Application/Services/JobDescriptionService.cs`
- [Talent domain](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Domain/Entities/Candidate.cs): `src/IRA.Domain/Entities/Candidate.cs`

### AI and grounding

- [Resume parser](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Infrastructure/Agents/ResumeParserAgent.cs): `src/IRA.Infrastructure/Agents/ResumeParserAgent.cs`
- [Matching and ranking agents](https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Infrastructure/Agents): `src/IRA.Infrastructure/Agents`
- [Interview and review agents](https://github.com/ojas2005/intelligentrecruitmentassistant/tree/main/src/IRA.Infrastructure/Agents): `src/IRA.Infrastructure/Agents`
- [RAG retrieval](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Infrastructure/Search/RagRetrievalService.cs): `src/IRA.Infrastructure/Search/RagRetrievalService.cs`
- [Text generation](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Infrastructure/AI/SemanticKernelTextGenerationService.cs): `src/IRA.Infrastructure/AI/SemanticKernelTextGenerationService.cs`

### Persistence and services

- [Talent repository](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Persistence/ITalentRepository.cs): `src/IRA.Application/Abstractions/Persistence/ITalentRepository.cs`
- [Audit trail](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Audit/IAuditLogger.cs): `src/IRA.Application/Abstractions/Audit/IAuditLogger.cs`
- [Resume storage](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Storage/IBlobStorage.cs): `src/IRA.Application/Abstractions/Storage/IBlobStorage.cs`
- [Document extraction](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Documents/IDocumentExtractor.cs): `src/IRA.Application/Abstractions/Documents/IDocumentExtractor.cs`
- [Vector search](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/Search/IVectorStore.cs): `src/IRA.Application/Abstractions/Search/IVectorStore.cs`
- [Embedding generation](https://github.com/ojas2005/intelligentrecruitmentassistant/blob/main/src/IRA.Application/Abstractions/AI/IEmbeddingGenerator.cs): `src/IRA.Application/Abstractions/AI/IEmbeddingGenerator.cs`

### Other components

- **Recruiter**
- **Candidate**

## Connections

- Recruiter → Role portals: uses (evidence: `README.md`)
- Candidate → Role portals: uses (evidence: `README.md`)
- Role portals → API client: requests (evidence: `src/IRA.Web/Controllers/ResumeController.cs`)
- API client → JWT identity: logs in (evidence: `src/IRA.Web/Services/RecruitmentApiClient.cs`)
- API client → Resume endpoint: uploads resume (evidence: `src/IRA.Web/Services/RecruitmentApiClient.cs`)
- API client → Job and evaluation API: requests (evidence: `src/IRA.Web/Services/RecruitmentApiClient.cs`)
- API host → Resume endpoint: maps controllers (evidence: `src/IRA.Api/Program.cs`)
- API host → JWT identity: configures auth (evidence: `src/IRA.Api/Program.cs`)
- JWT identity → Audit trail: logs events (evidence: `src/IRA.Api/Controllers/AuthController.cs`)
- Resume endpoint → Resume processing: processes upload (evidence: `src/IRA.Api/Controllers/ResumeController.cs`)
- Job and evaluation API → Job descriptions: manages jobs
- Job and evaluation API → Evaluation orchestration: starts evaluation
- Resume processing → Resume storage: stores file (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Resume processing → Talent repository: saves records (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Resume processing → Document extraction: extracts text (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Resume processing → Resume parser: parses text (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Resume processing → Embedding generation: embeds text (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Resume processing → Vector search: indexes profile (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Resume processing → Audit trail: logs outcome (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Resume parser → Text generation: generates parse (evidence: `src/IRA.Infrastructure/Agents/ResumeParserAgent.cs`)
- Resume processing → Talent domain: builds candidate (evidence: `src/IRA.Application/Services/ResumeProcessingService.cs`)
- Evaluation orchestration → Matching and ranking agents: coordinates agents (evidence: `README.md`)
- Evaluation orchestration → Interview and review agents: requests questions and review (evidence: `README.md`)
- Evaluation orchestration → RAG retrieval: grounds evaluation (evidence: `README.md`)
- Matching and ranking agents → RAG retrieval: retrieves criteria (evidence: `README.md`)
- RAG retrieval → Embedding generation: embeds query (evidence: `src/IRA.Infrastructure/Search/RagRetrievalService.cs`)
- RAG retrieval → Vector search: searches vectors (evidence: `src/IRA.Infrastructure/Search/RagRetrievalService.cs`)
- Matching and ranking agents → Text generation: generates evaluation (evidence: `README.md`)
- Evaluation orchestration → Talent repository: persists results (evidence: `README.md`)
- Evaluation orchestration → Audit trail: records actions (evidence: `README.md`)
- Job descriptions → Talent repository: stores job descriptions
