How nourromeo/xlent_matcher works
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: App.tsx Web application · AppDbContext.cs Entity model · MatchingController.cs Matching API · AdminController.cs Admin API
Components 23
Web experience
- Web application
src/XlentMatch.Web/src/App.tsx - Assignment management
src/XlentMatch.Web/src/pages/ClientAssignments.tsx - Consultant review
src/XlentMatch.Web/src/pages/ConsultantReview.tsx - Matching results
src/XlentMatch.Web/src/pages/Matching.tsx - CV adaptation
src/XlentMatch.Web/src/pages/CvAdaptation.tsx - Administration
src/XlentMatch.Web/src/pages/Admin.tsx
API workflows
- Assignment API
src/XlentMatch.Api/Controllers/AssignmentsController.cs - Consultant API
src/XlentMatch.Api/Controllers/ConsultantsController.cs - Matching API
src/XlentMatch.Api/Controllers/MatchingController.cs - Admin API
src/XlentMatch.Api/Controllers/AdminController.cs - CV upload API
src/XlentMatch.Api/Controllers/CvUploadsController.cs - Extraction API
src/XlentMatch.Api/Controllers/ExtractionController.cs
Matching domain
- Deterministic scoring
src/XlentMatch.Api/Services/MatchingService.cs - Availability checks
src/XlentMatch.Api/Services/ConsultantAvailabilityService.cs - Skill normalization
src/XlentMatch.Api/Services/SkillNormalizationService.cs
AI and CV processing
- PDF text extraction
src/XlentMatch.Api/Services/PdfTextExtractor.cs - AI text analysis
src/XlentMatch.Api/Services/OpenAiTextService.cs - Prompt management
src/XlentMatch.Api/Services/PromptService.cs
Persistence and configuration
- Entity model
src/XlentMatch.Api/Data/AppDbContext.cs - SQL database
- Matching weights
src/XlentMatch.Api/Services/MatchingWeightsStore.cs
Other components
- XLENT user
- Azure OpenAI
Connections 29
- XLENT user → Web application: uses
README.md - Web application → Assignment management: routes to
src/XlentMatch.Web/src/App.tsx - Web application → Consultant review: routes to
src/XlentMatch.Web/src/App.tsx - Web application → Matching results: routes to
src/XlentMatch.Web/src/App.tsx - Web application → CV adaptation: routes to
src/XlentMatch.Web/src/App.tsx - Web application → Administration: routes to
src/XlentMatch.Web/src/App.tsx - Assignment management → Assignment API: calls
src/XlentMatch.Web/src/pages/ClientAssignments.tsx - Consultant review → Consultant API: calls
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
src/XlentMatch.Api/Controllers/AssignmentsController.cs - Consultant API → Entity model: reads and writes
src/XlentMatch.Api/Controllers/ConsultantsController.cs - Matching API → Entity model: loads inputs
src/XlentMatch.Api/Controllers/MatchingController.cs - Matching API → Deterministic scoring: invokes scoring
src/XlentMatch.Api/Controllers/MatchingController.cs - Matching API → Availability checks: checks availability
src/XlentMatch.Api/Controllers/MatchingController.cs - Deterministic scoring → Matching weights: gets weights
src/XlentMatch.Api/Services/MatchingService.cs - Admin API → Entity model: reads and writes
src/XlentMatch.Api/Controllers/AdminController.cs - Admin API → Matching weights: updates weights
src/XlentMatch.Api/Controllers/AdminController.cs - Admin API → Skill normalization: normalizes skills
src/XlentMatch.Api/Controllers/AdminController.cs - Assignment API → Skill normalization: normalizes requirements
src/XlentMatch.Api/Controllers/AssignmentsController.cs - Consultant API → Skill normalization: normalizes profile skills
src/XlentMatch.Api/Controllers/ConsultantsController.cs - CV upload API → Entity model: records uploads
src/XlentMatch.Api/Controllers/CvUploadsController.cs - Extraction API → Skill normalization: normalizes extracted skills
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
README.md - AI text analysis → Prompt management: uses prompts
- Entity model → SQL database: persists entities
README.md