← Index des services · SI FGA · spécification de service

svc-reference-data

Catégorie : Métier · Périmètre : Transverse (données maîtres) · Module : services/svc-reference-data (monorepo fga-services — ADR-0001) · Stack : Java · Quarkus · Gradle · YAML · Architecture : hexagonale

1. Rôle et responsabilités

Données maîtres partagées du SI : compagnies d'assurance, structures de santé (hôpitaux, CHU, officines), experts médicaux agréés, acteurs juridiques (avocats, commissaires), paramètres réglementaires (taux de pénalité, délais). Source de vérité consommée en lecture par tous les autres services.

2. Modèle de domaine (agrégats)

InsurerHealthcareFacilityMedicalExpertLegalActorRegulatoryParameter

3. API exposée

/v1/insurers/v1/healthcare-facilities/v1/medical-experts/v1/legal-actors/v1/parameters

API REST versionnée, contrat OpenAPI généré et versionné avec le service. Authentification par jeton Keycloak (JWT RS256) validé par le service (Quarkus OIDC).

4. Événements publiés

insurer.registered insurer.updated healthcare-facility.updated medical-expert.accredited medical-expert.suspended regulatory-parameter.changed

5. Événements consommés

Aucun

Topics sigfga.<service>.<aggregate> · enveloppe CloudEvents 1.0 · publication via outbox pattern · consommateurs idempotents (déduplication par event id).

6. Dépendances synchrones

Aucun

7. Flux principal

8. Backlog Jira rattaché

Backlog v2 (16/07/2026) : toujours aucun ticket rattaché à ce service.

Aucun ticket dans le backlog actuel. Backlog à créer : gestion et cycle de validation de chaque référentiel, historisation des paramètres réglementaires, import initial des données existantes.

MAJ backlog v2 (16/07/2026) — Toujours aucun ticket rattaché — backlog à créer (6 tickets « référentiel » existent ailleurs dans le programme, à raccrocher).

9. Implémentation

Structure hexagonale standard : domain (modèle, événements, services purs, sans dépendance framework), application (use cases, ports in/out, transactions), adapter (in/rest, in/messaging, out/persistence, out/messaging, out/client). Dépendances verrouillées par test ArchUnit. Base de données dédiée (schéma PostgreSQL propre), migrations Liquibase (changesets exclusivement en SQL formaté — ADR-0002). Code intégralement en anglais ; textes utilisateur en fichiers i18n français.