# mchekini-check-consulting/formation-ba-assurance-iard architecture

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

- Interactive diagram: https://gitdiagram.com/mchekini-check-consulting/formation-ba-assurance-iard
- Repository: https://github.com/mchekini-check-consulting/formation-ba-assurance-iard

## Overview

Assur’Easy is an IARD insurance-quote and subscription product: a browser-based Angular app uses the gateway to reach a Spring API, with a separate tariff engine represented in the repository. The main user journey covers quote entry, pricing, saved quotes, account/session management and contract signing; related account and profile capabilities are also present. The excerpts show tariff calculation and persistence, session handling, and contract operations, but do not show the API-to-engine wiring or most frontend service calls, so those links are omitted or marked unverified.

Main entry points: [`moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java`](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java) (Tariff calculation), [`assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/resource`](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/resource) (API resources), [`assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisEnregistreService.java`](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisEnregistreService.java) (Quote management), [`assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/ContratService.java`](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/ContratService.java) (Contract signing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web journey"]
  node_frontend["Quote and account UI"]
  node_webservices["Frontend API services"]
end

subgraph group_api["Insurance API"]
  node_apiresources["API resources"]
  node_quote["Quote management"]
  node_quotepricing["Quote tariff handling"]
  node_contract["Contract signing"]
  node_session["Session management"]
  node_engineclient["Tariff engine client"]
  node_pdf["Quote PDF generation"]
end

subgraph group_pricing["Pricing engine"]
  node_tariffresource["Tariff endpoint"]
  node_tariffcalc["Tariff calculation<br/>[TarifService.java]"]
  node_eligibility["Eligibility checks"]
  node_recommend["Formula recommendation"]
  node_grids["Rate grid loading"]
  node_trace["Calculation trace"]
end

subgraph group_state["Persistent state"]
  node_api_db[("Insurance data")]
  node_engine_db[("Pricing data")]
end

node_browser(("Customer browser"))
node_gateway{{"API gateway"}}

node_browser -->|"uses"| node_frontend
node_browser -->|"calls API through"| node_gateway
node_gateway -->|"routes requests"| node_apiresources
node_frontend -.->|"uses"| node_webservices
node_webservices -->|"calls"| node_gateway
node_apiresources -.->|"dispatches"| node_quote
node_apiresources -.->|"dispatches"| node_quotepricing
node_apiresources -.->|"dispatches"| node_contract
node_contract -->|"checks session"| node_session
node_quote -->|"generates PDF"| node_pdf
node_quotepricing -->|"requests pricing"| node_engineclient
node_engineclient -.->|"calls"| node_tariffresource
node_tariffresource -.->|"dispatches"| node_tariffcalc
node_tariffcalc -->|"loads applicable grid"| node_grids
node_tariffcalc -->|"checks eligibility"| node_eligibility
node_tariffcalc -->|"requests recommendation"| node_recommend
node_tariffcalc -->|"records calculation"| node_trace
node_grids -->|"reads grid data"| node_engine_db
node_trace -->|"stores and reads traces"| node_engine_db
node_session -->|"reads and writes sessions"| node_api_db
node_quote -.->|"stores quotes"| node_api_db
node_contract -.->|"stores contracts"| node_api_db

click node_frontend "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/frontend/src/app/feature"
click node_webservices "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/frontend/src/app/core/service"
click node_apiresources "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/resource"
click node_quote "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisEnregistreService.java"
click node_quotepricing "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/TarifDevisService.java"
click node_contract "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/ContratService.java"
click node_session "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/SessionService.java"
click node_engineclient "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/client/MoteurTarifaireClient.java"
click node_tariffresource "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/resource/TarifHabitationResource.java"
click node_tariffcalc "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java"
click node_eligibility "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/EligibiliteService.java"
click node_recommend "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/RecommandationService.java"
click node_grids "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/GrilleTarifaireService.java"
click node_trace "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TraceCalculService.java"
click node_api_db "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/repository"
click node_engine_db "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/repository"
click node_pdf "https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisPdfService.java"

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_frontend,node_webservices,node_browser toneBlue
class node_apiresources,node_quote,node_quotepricing,node_contract,node_session,node_engineclient,node_pdf toneAmber
class node_tariffresource,node_tariffcalc,node_eligibility,node_recommend,node_grids,node_trace,node_gateway toneMint
class node_api_db,node_engine_db toneRose
```

## Components

### Web journey

- [Quote and account UI](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/frontend/src/app/feature): `frontend/src/app/feature`
- [Frontend API services](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/frontend/src/app/core/service): `frontend/src/app/core/service`

### Insurance API

- [API resources](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/resource): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/resource`
- [Quote management](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisEnregistreService.java): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisEnregistreService.java`
- [Quote tariff handling](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/TarifDevisService.java): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/TarifDevisService.java`
- [Contract signing](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/ContratService.java): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/ContratService.java`
- [Session management](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/SessionService.java): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/SessionService.java`
- [Tariff engine client](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/client/MoteurTarifaireClient.java): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/client/MoteurTarifaireClient.java`
- [Quote PDF generation](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisPdfService.java): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisPdfService.java`

### Pricing engine

- [Tariff endpoint](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/resource/TarifHabitationResource.java): `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/resource/TarifHabitationResource.java`
- [Tariff calculation](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java): `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java`
- [Eligibility checks](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/EligibiliteService.java): `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/EligibiliteService.java`
- [Formula recommendation](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/RecommandationService.java): `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/RecommandationService.java`
- [Rate grid loading](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/GrilleTarifaireService.java): `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/GrilleTarifaireService.java`
- [Calculation trace](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/blob/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TraceCalculService.java): `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TraceCalculService.java`

### Persistent state

- [Insurance data](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/repository): `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/repository`
- [Pricing data](https://github.com/mchekini-check-consulting/formation-ba-assurance-iard/tree/main/moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/repository): `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/repository`

### Other components

- **Customer browser**
- **API gateway**

## Connections

- Customer browser → Quote and account UI: uses (evidence: `README.md`)
- Customer browser → API gateway: calls API through (evidence: `README.md`)
- API gateway → API resources: routes requests (evidence: `README.md`)
- Quote and account UI → Frontend API services: uses (evidence: `frontend/src/app/feature/espace-client/espace-client.ts`)
- Frontend API services → API gateway: calls (evidence: `README.md`)
- API resources → Quote management: dispatches
- API resources → Quote tariff handling: dispatches
- API resources → Contract signing: dispatches
- Contract signing → Session management: checks session (evidence: `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/ContratService.java`)
- Quote management → Quote PDF generation: generates PDF (evidence: `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisEnregistreService.java`)
- Quote tariff handling → Tariff engine client: requests pricing (evidence: `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/TarifDevisService.java`)
- Tariff engine client → Tariff endpoint: calls
- Tariff endpoint → Tariff calculation: dispatches
- Tariff calculation → Rate grid loading: loads applicable grid (evidence: `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java`)
- Tariff calculation → Eligibility checks: checks eligibility (evidence: `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java`)
- Tariff calculation → Formula recommendation: requests recommendation (evidence: `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java`)
- Tariff calculation → Calculation trace: records calculation (evidence: `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TarifService.java`)
- Rate grid loading → Pricing data: reads grid data (evidence: `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/GrilleTarifaireService.java`)
- Calculation trace → Pricing data: stores and reads traces (evidence: `moteurtarifaire/src/main/java/net/checkconsulting/moteurtarifaire/api/service/TraceCalculService.java`)
- Session management → Insurance data: reads and writes sessions (evidence: `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/SessionService.java`)
- Quote management → Insurance data: stores quotes (evidence: `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/DevisEnregistreService.java`)
- Contract signing → Insurance data: stores contracts (evidence: `assurance-iard-api/src/main/java/net/checkconsulting/assuranceiard/api/service/ContratService.java`)
