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

svc-compensation

Catégorie : Métier · Périmètre : PR2 · indemnisation · Module : services/svc-compensation (monorepo fga-services — ADR-0001) · Stack : Java · Quarkus · Gradle · YAML · Architecture : hexagonale

1. Rôle et responsabilités

Demande d'indemnisation, recevabilité, instruction, missions d'expertise médicale (désignation, rapport, taux d'IPP), offre d'indemnisation, acceptation ou refus, PV de transaction, orientation contentieuse.

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

CompensationClaimExpertiseMissionExpertiseReportCompensationOfferSettlementAgreement

3. API exposée

/v1/compensation-claims/v1/expertise-missions/v1/offers/v1/settlements

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

compensation-claim.submitted compensation-claim.admitted compensation-claim.rejected expertise.assigned expertise-report.filed offer.issued offer.accepted offer.declined settlement.signed compensation-case.referred-to-litigation compensation-case.closed

5. Événements consommés

claim.opened award.calculated signature.completed payment.executed

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

6. Dépendances synchrones

svc-compensation-engine svc-claims svc-reference-data svc-signatures svc-payments

7. Flux principal

8. Backlog Jira rattaché

29 tickets du backlog Jira se rattachent à ce service, via 9 épics :

Épic	Intitulé	Enfants
FSD-1	[IND] Réception et ouverture du dossier	20
FSD-2	[IND] Analyse de recevabilité	3
FSD-3	[IND] Instruction du dossier	5
FSD-4	[IND] Évaluation du préjudice	5
FSD-5	[IND] Offre d'indemnisation	3
FSD-6	[IND] Transaction	4
FSD-7	[IND] Paiement de l'indemnisation	3
FSD-8	[IND] Clôture du dossier	3
FSD-9	[IND] Suivi et reporting	4

Le squelette du processus existe (9 épics du 23 juin fidèles au CDC PR2) mais 8 sur 9 sont vides : recevabilité, instruction, expertise, offre, transaction sont à décomposer entièrement. Les 109 tickets IND de juillet appartiennent en réalité à medical-billing et payments. Chantier prioritaire du programme.

MAJ backlog v2 (16/07/2026) — Le cœur PR2 a été décomposé en v2 : les 9 épics ont désormais des enfants actifs (recevabilité, instruction, évaluation, offre, transaction...).

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.

10. Schéma de données