# azizseddik/smartrecruiter architecture

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

- Interactive diagram: https://gitdiagram.com/azizseddik/smartrecruiter
- Repository: https://github.com/azizseddik/smartrecruiter

## Overview

SmartRecruiter is a recruiting application for managing job offers, candidates, CV imports, applications, and candidate-to-offer matching. The visible UI workflow routes recruiters to candidate and offer views; candidate management loads candidates and offers, requests application rankings, and can submit a PDF CV for an offer. The repository also contains Java API, persistence, and workflow modules and a separate Python CV-analysis service. Their internal wiring is not shown in the excerpts, so those links are omitted; API ownership and integration details are consequently incomplete.

Main entry points: [`smart-recruiter-front/src/app/app.routes.ts`](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/app.routes.ts) (Page routing), [`smart-recruiter-front/src/app/pages/candidats/candidats.component.ts`](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/candidats/candidats.component.ts) (Candidate workflow), [`SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/SmartRecture/Controller`](https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/SmartRecture/Controller) (REST controllers), [`SmartRecruiter-AI/main.py`](https://github.com/azizseddik/smartrecruiter/blob/main/SmartRecruiter-AI/main.py) (CV analysis API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Recruiter interface"]
  node_app["Angular shell<br/>[app.component.ts]"]
  node_routes["Page routing<br/>[app.routes.ts]"]
  node_candidate_ui["Candidate workflow"]
  node_offer_ui["Offer management"]
  node_offer_create["Offer creation"]
  node_dashboard["Dashboard"]
  node_matching_ui["Matching view"]
  node_candidate_client["Candidate client"]
  node_cv_client["CV client<br/>[cv.service.ts]"]
  node_matching_client["Matching client"]
  node_offer_client["Offer client<br/>[offre.service.ts]"]
end

subgraph group_api["Recruiting API"]
  node_controllers["REST controllers"]
  node_workflow_services["Recruiting workflows"]
end

subgraph group_data["Recruiting data"]
  node_repositories["Repositories"]
  node_entities["Recruiting entities"]
end

subgraph group_ai["CV analysis"]
  node_ai_api["CV analysis API<br/>[main.py]"]
  node_cv_parser["CV extraction<br/>[cv_analyzer.py]"]
  node_analysis_schema["Analysis schema<br/>[cv_schemas.py]"]
end

node_recruiter(("Recruiter"))

node_recruiter -.->|"uses"| node_app
node_app -.->|"hosts routes"| node_routes
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_candidate_ui
node_routes -->|"routes to"| node_offer_ui
node_routes -->|"routes to"| node_offer_create
node_routes -->|"routes to"| node_matching_ui
node_candidate_ui -->|"calls"| node_candidate_client
node_candidate_ui -->|"calls"| node_offer_client
node_candidate_ui -->|"calls"| node_cv_client
node_candidate_ui -->|"calls"| node_matching_client
node_candidate_client -.->|"HTTP requests"| node_controllers
node_offer_client -.->|"HTTP requests"| node_controllers
node_cv_client -.->|"HTTP requests"| node_controllers
node_matching_client -.->|"HTTP requests"| node_controllers
node_ai_api -->|"analyzes text"| node_cv_parser
node_ai_api -->|"shapes response"| node_analysis_schema

click node_app "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/app.component.ts"
click node_routes "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/app.routes.ts"
click node_candidate_ui "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/candidats/candidats.component.ts"
click node_offer_ui "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/offres/offres.component.ts"
click node_offer_create "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/ajouter-offre/ajouter-offre.component.ts"
click node_dashboard "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/dashboard/dashboard.component.ts"
click node_matching_ui "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/matching-component/matching-component.component.ts"
click node_candidate_client "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/candidat.service.ts"
click node_cv_client "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/cv.service.ts"
click node_matching_client "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/matching.service.ts"
click node_offer_client "https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/offre.service.ts"
click node_controllers "https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/SmartRecture/Controller"
click node_workflow_services "https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/service"
click node_repositories "https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/Repostitory"
click node_entities "https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/Entity"
click node_ai_api "https://github.com/azizseddik/smartrecruiter/blob/main/SmartRecruiter-AI/main.py"
click node_cv_parser "https://github.com/azizseddik/smartrecruiter/blob/main/SmartRecruiter-AI/cv_analyzer.py"
click node_analysis_schema "https://github.com/azizseddik/smartrecruiter/blob/main/SmartRecruiter-AI/cv_schemas.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_app,node_routes,node_candidate_ui,node_offer_ui,node_offer_create,node_dashboard,node_matching_ui,node_candidate_client,node_cv_client,node_matching_client,node_offer_client toneBlue
class node_controllers,node_workflow_services toneAmber
class node_repositories,node_entities toneMint
class node_ai_api,node_cv_parser,node_analysis_schema toneRose
class node_recruiter toneIndigo
```

## Components

### Recruiter interface

- [Angular shell](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/app.component.ts): `smart-recruiter-front/src/app/app.component.ts`
- [Page routing](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/app.routes.ts): `smart-recruiter-front/src/app/app.routes.ts`
- [Candidate workflow](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/candidats/candidats.component.ts): `smart-recruiter-front/src/app/pages/candidats/candidats.component.ts`
- [Offer management](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/offres/offres.component.ts): `smart-recruiter-front/src/app/pages/offres/offres.component.ts`
- [Offer creation](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/ajouter-offre/ajouter-offre.component.ts): `smart-recruiter-front/src/app/pages/ajouter-offre/ajouter-offre.component.ts`
- [Dashboard](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/dashboard/dashboard.component.ts): `smart-recruiter-front/src/app/pages/dashboard/dashboard.component.ts`
- [Matching view](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/pages/matching-component/matching-component.component.ts): `smart-recruiter-front/src/app/pages/matching-component/matching-component.component.ts`
- [Candidate client](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/candidat.service.ts): `smart-recruiter-front/src/app/services/candidat.service.ts`
- [CV client](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/cv.service.ts): `smart-recruiter-front/src/app/services/cv.service.ts`
- [Matching client](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/matching.service.ts): `smart-recruiter-front/src/app/services/matching.service.ts`
- [Offer client](https://github.com/azizseddik/smartrecruiter/blob/main/smart-recruiter-front/src/app/services/offre.service.ts): `smart-recruiter-front/src/app/services/offre.service.ts`

### Recruiting API

- [REST controllers](https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/SmartRecture/Controller): `SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/SmartRecture/Controller`
- [Recruiting workflows](https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/service): `SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/service`

### Recruiting data

- [Repositories](https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/Repostitory): `SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/Repostitory`
- [Recruiting entities](https://github.com/azizseddik/smartrecruiter/tree/main/SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/Entity): `SmartRecruiter/src/main/java/SmartRecruiter/example/SmartRecruiter/Entity`

### CV analysis

- [CV analysis API](https://github.com/azizseddik/smartrecruiter/blob/main/SmartRecruiter-AI/main.py): `SmartRecruiter-AI/main.py`
- [CV extraction](https://github.com/azizseddik/smartrecruiter/blob/main/SmartRecruiter-AI/cv_analyzer.py): `SmartRecruiter-AI/cv_analyzer.py`
- [Analysis schema](https://github.com/azizseddik/smartrecruiter/blob/main/SmartRecruiter-AI/cv_schemas.py): `SmartRecruiter-AI/cv_schemas.py`

### Other components

- **Recruiter**

## Connections

- Recruiter → Angular shell: uses
- Angular shell → Page routing: hosts routes
- Page routing → Dashboard: routes to (evidence: `smart-recruiter-front/src/app/app.routes.ts`)
- Page routing → Candidate workflow: routes to (evidence: `smart-recruiter-front/src/app/app.routes.ts`)
- Page routing → Offer management: routes to (evidence: `smart-recruiter-front/src/app/app.routes.ts`)
- Page routing → Offer creation: routes to (evidence: `smart-recruiter-front/src/app/app.routes.ts`)
- Page routing → Matching view: routes to (evidence: `smart-recruiter-front/src/app/app.routes.ts`)
- Candidate workflow → Candidate client: calls (evidence: `smart-recruiter-front/src/app/pages/candidats/candidats.component.ts`)
- Candidate workflow → Offer client: calls (evidence: `smart-recruiter-front/src/app/pages/candidats/candidats.component.ts`)
- Candidate workflow → CV client: calls (evidence: `smart-recruiter-front/src/app/pages/candidats/candidats.component.ts`)
- Candidate workflow → Matching client: calls (evidence: `smart-recruiter-front/src/app/pages/candidats/candidats.component.ts`)
- Candidate client → REST controllers: HTTP requests
- Offer client → REST controllers: HTTP requests
- CV client → REST controllers: HTTP requests
- Matching client → REST controllers: HTTP requests
- CV analysis API → CV extraction: analyzes text (evidence: `SmartRecruiter-AI/main.py`)
- CV analysis API → Analysis schema: shapes response (evidence: `SmartRecruiter-AI/main.py`)
