# nourromeo/xlent_matcher architecture

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

- Interactive diagram: https://gitdiagram.com/nourromeo/xlent_matcher
- Repository: https://github.com/nourromeo/xlent_matcher

## Overview

Xlent Matcher is an internal tool for comparing existing consultants with client assignments; users review an explainable, deterministic ranking rather than an AI-generated score. The main flow is to maintain assignment requirements and consultant profiles, request matching, then inspect matched and missing requirements with evidence. Separate capabilities process CV uploads for human review, use AI to extract requirements or suggest CV adaptation, and let administrators maintain the skill taxonomy and matching weights. Some page and service wiring is not shown; unverified relationships are dashed or omitted.

Main entry points: [`src/XlentMatch.Web/src/App.tsx`](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/App.tsx) (Web application), [`src/XlentMatch.Api/Data/AppDbContext.cs`](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Data/AppDbContext.cs) (Entity model), [`src/XlentMatch.Api/Controllers/MatchingController.cs`](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/MatchingController.cs) (Matching API), [`src/XlentMatch.Api/Controllers/AdminController.cs`](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/AdminController.cs) (Admin API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_assignmentui["Assignment management"]
  node_reviewui["Consultant review"]
  node_matchingui["Matching results<br/>[Matching.tsx]"]
  node_adaptui["CV adaptation<br/>[CvAdaptation.tsx]"]
  node_adminui["Administration<br/>[Admin.tsx]"]
end

subgraph group_api["API workflows"]
  node_assignapi["Assignment API"]
  node_consultapi["Consultant API"]
  node_matchapi["Matching API"]
  node_adminapi["Admin API<br/>[AdminController.cs]"]
  node_uploadapi["CV upload API"]
  node_extractapi["Extraction API"]
end

subgraph group_domain["Matching domain"]
  node_matching["Deterministic scoring<br/>[MatchingService.cs]"]
  node_availability["Availability checks"]
  node_normalization["Skill normalization"]
end

subgraph group_ai["AI and CV processing"]
  node_pdf["PDF text extraction"]
  node_openai["AI text analysis"]
  node_prompts["Prompt management<br/>[PromptService.cs]"]
end

subgraph group_data["Persistence and configuration"]
  node_dbcontext["Entity model<br/>[AppDbContext.cs]"]
  node_database[("SQL database")]
  node_weights["Matching weights"]
end

node_user(("XLENT user"))
node_azure{{"Azure OpenAI"}}

node_user -.->|"uses"| node_webapp
node_webapp -->|"routes to"| node_assignmentui
node_webapp -->|"routes to"| node_reviewui
node_webapp -->|"routes to"| node_matchingui
node_webapp -->|"routes to"| node_adaptui
node_webapp -->|"routes to"| node_adminui
node_assignmentui -->|"calls"| node_assignapi
node_reviewui -->|"calls"| node_consultapi
node_matchingui -.->|"requests matches"| node_matchapi
node_adaptui -.->|"requests adaptation"| node_extractapi
node_adminui -.->|"configures"| node_adminapi
node_assignapi -->|"reads and writes"| node_dbcontext
node_consultapi -->|"reads and writes"| node_dbcontext
node_matchapi -->|"loads inputs"| node_dbcontext
node_matchapi -->|"invokes scoring"| node_matching
node_matchapi -->|"checks availability"| node_availability
node_matching -->|"gets weights"| node_weights
node_adminapi -->|"reads and writes"| node_dbcontext
node_adminapi -->|"updates weights"| node_weights
node_adminapi -->|"normalizes skills"| node_normalization
node_assignapi -->|"normalizes requirements"| node_normalization
node_consultapi -->|"normalizes profile skills"| node_normalization
node_uploadapi -->|"records uploads"| node_dbcontext
node_extractapi -->|"normalizes extracted skills"| node_normalization
node_extractapi -.->|"requests extraction"| node_openai
node_extractapi -.->|"extracts document text"| node_pdf
node_openai -.->|"calls provider"| node_azure
node_openai -.->|"uses prompts"| node_prompts
node_dbcontext -->|"persists entities"| node_database

click node_webapp "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/App.tsx"
click node_assignmentui "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/ClientAssignments.tsx"
click node_reviewui "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/ConsultantReview.tsx"
click node_matchingui "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/Matching.tsx"
click node_adaptui "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/CvAdaptation.tsx"
click node_adminui "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/Admin.tsx"
click node_assignapi "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/AssignmentsController.cs"
click node_consultapi "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/ConsultantsController.cs"
click node_matchapi "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/MatchingController.cs"
click node_adminapi "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/AdminController.cs"
click node_uploadapi "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/CvUploadsController.cs"
click node_extractapi "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/ExtractionController.cs"
click node_matching "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/MatchingService.cs"
click node_availability "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/ConsultantAvailabilityService.cs"
click node_normalization "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/SkillNormalizationService.cs"
click node_pdf "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/PdfTextExtractor.cs"
click node_openai "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/OpenAiTextService.cs"
click node_prompts "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/PromptService.cs"
click node_dbcontext "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Data/AppDbContext.cs"
click node_weights "https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/MatchingWeightsStore.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_webapp,node_assignmentui,node_reviewui,node_matchingui,node_adaptui,node_adminui,node_user toneBlue
class node_assignapi,node_consultapi,node_matchapi,node_adminapi,node_uploadapi,node_extractapi toneAmber
class node_matching,node_availability,node_normalization toneMint
class node_pdf,node_openai,node_prompts toneRose
class node_dbcontext,node_database,node_weights,node_azure toneIndigo
```

## Components

### Web experience

- [Web application](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/App.tsx): `src/XlentMatch.Web/src/App.tsx`
- [Assignment management](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/ClientAssignments.tsx): `src/XlentMatch.Web/src/pages/ClientAssignments.tsx`
- [Consultant review](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/ConsultantReview.tsx): `src/XlentMatch.Web/src/pages/ConsultantReview.tsx`
- [Matching results](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/Matching.tsx): `src/XlentMatch.Web/src/pages/Matching.tsx`
- [CV adaptation](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/CvAdaptation.tsx): `src/XlentMatch.Web/src/pages/CvAdaptation.tsx`
- [Administration](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Web/src/pages/Admin.tsx): `src/XlentMatch.Web/src/pages/Admin.tsx`

### API workflows

- [Assignment API](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/AssignmentsController.cs): `src/XlentMatch.Api/Controllers/AssignmentsController.cs`
- [Consultant API](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/ConsultantsController.cs): `src/XlentMatch.Api/Controllers/ConsultantsController.cs`
- [Matching API](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/MatchingController.cs): `src/XlentMatch.Api/Controllers/MatchingController.cs`
- [Admin API](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/AdminController.cs): `src/XlentMatch.Api/Controllers/AdminController.cs`
- [CV upload API](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/CvUploadsController.cs): `src/XlentMatch.Api/Controllers/CvUploadsController.cs`
- [Extraction API](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Controllers/ExtractionController.cs): `src/XlentMatch.Api/Controllers/ExtractionController.cs`

### Matching domain

- [Deterministic scoring](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/MatchingService.cs): `src/XlentMatch.Api/Services/MatchingService.cs`
- [Availability checks](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/ConsultantAvailabilityService.cs): `src/XlentMatch.Api/Services/ConsultantAvailabilityService.cs`
- [Skill normalization](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/SkillNormalizationService.cs): `src/XlentMatch.Api/Services/SkillNormalizationService.cs`

### AI and CV processing

- [PDF text extraction](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/PdfTextExtractor.cs): `src/XlentMatch.Api/Services/PdfTextExtractor.cs`
- [AI text analysis](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/OpenAiTextService.cs): `src/XlentMatch.Api/Services/OpenAiTextService.cs`
- [Prompt management](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/PromptService.cs): `src/XlentMatch.Api/Services/PromptService.cs`

### Persistence and configuration

- [Entity model](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Data/AppDbContext.cs): `src/XlentMatch.Api/Data/AppDbContext.cs`
- **SQL database**
- [Matching weights](https://github.com/nourromeo/xlent_matcher/blob/main/src/XlentMatch.Api/Services/MatchingWeightsStore.cs): `src/XlentMatch.Api/Services/MatchingWeightsStore.cs`

### Other components

- **XLENT user**
- **Azure OpenAI**

## Connections

- XLENT user → Web application: uses (evidence: `README.md`)
- Web application → Assignment management: routes to (evidence: `src/XlentMatch.Web/src/App.tsx`)
- Web application → Consultant review: routes to (evidence: `src/XlentMatch.Web/src/App.tsx`)
- Web application → Matching results: routes to (evidence: `src/XlentMatch.Web/src/App.tsx`)
- Web application → CV adaptation: routes to (evidence: `src/XlentMatch.Web/src/App.tsx`)
- Web application → Administration: routes to (evidence: `src/XlentMatch.Web/src/App.tsx`)
- Assignment management → Assignment API: calls (evidence: `src/XlentMatch.Web/src/pages/ClientAssignments.tsx`)
- Consultant review → Consultant API: calls (evidence: `src/XlentMatch.Web/src/pages/ConsultantReview.tsx`)
- Matching results → Matching API: requests matches
- CV adaptation → Extraction API: requests adaptation
- Administration → Admin API: configures
- Assignment API → Entity model: reads and writes (evidence: `src/XlentMatch.Api/Controllers/AssignmentsController.cs`)
- Consultant API → Entity model: reads and writes (evidence: `src/XlentMatch.Api/Controllers/ConsultantsController.cs`)
- Matching API → Entity model: loads inputs (evidence: `src/XlentMatch.Api/Controllers/MatchingController.cs`)
- Matching API → Deterministic scoring: invokes scoring (evidence: `src/XlentMatch.Api/Controllers/MatchingController.cs`)
- Matching API → Availability checks: checks availability (evidence: `src/XlentMatch.Api/Controllers/MatchingController.cs`)
- Deterministic scoring → Matching weights: gets weights (evidence: `src/XlentMatch.Api/Services/MatchingService.cs`)
- Admin API → Entity model: reads and writes (evidence: `src/XlentMatch.Api/Controllers/AdminController.cs`)
- Admin API → Matching weights: updates weights (evidence: `src/XlentMatch.Api/Controllers/AdminController.cs`)
- Admin API → Skill normalization: normalizes skills (evidence: `src/XlentMatch.Api/Controllers/AdminController.cs`)
- Assignment API → Skill normalization: normalizes requirements (evidence: `src/XlentMatch.Api/Controllers/AssignmentsController.cs`)
- Consultant API → Skill normalization: normalizes profile skills (evidence: `src/XlentMatch.Api/Controllers/ConsultantsController.cs`)
- CV upload API → Entity model: records uploads (evidence: `src/XlentMatch.Api/Controllers/CvUploadsController.cs`)
- Extraction API → Skill normalization: normalizes extracted skills (evidence: `src/XlentMatch.Api/Controllers/ExtractionController.cs`)
- Extraction API → AI text analysis: requests extraction
- Extraction API → PDF text extraction: extracts document text
- AI text analysis → Azure OpenAI: calls provider (evidence: `README.md`)
- AI text analysis → Prompt management: uses prompts
- Entity model → SQL database: persists entities (evidence: `README.md`)
