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

svc-claims

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

1. Rôle et responsabilités

L'accident, la victime, le dossier sinistre à identifiant unique, le consentement au traitement des données, la recherche de dossiers. Référentiel commun du « dossier » que la prise en charge (PR1) et l'indemnisation (PR2) enrichissent chacune de leur côté.

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

Claim (racine)VictimBeneficiaryAccidentConsent

3. API exposée

/v1/claims/v1/claims/{id}/victims/v1/claims/{id}/beneficiaries/v1/claims/{id}/consents

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

5. Événements consommés

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

6. Dépendances synchrones

7. Flux principal

svc-claims · flux principalréception d'une ouverture(portail · agent)vérifier l'identité de la victimedossier existant ?ouinonrattacher au dossier existantcréer le Claim · n° uniquepublierclaim.openedenregistrer le consentementpublierconsent.recordedmettre à jour le statutpublierclaim.status-changedouivolets PR1 / PR2 actifs ?nonclôturer le dossierpublierclaim.closed

8. Backlog Jira rattaché

44 tickets du backlog Jira se rattachent à ce service, via 14 épics :

ÉpicIntituléEnfants
FSD-11[PEC] Réception de la victime · clôturée en v2 (fusion)
FSD-12[PEC] Enregistrement du dossier de la victime · clôturée en v2 (fusion)
FSD-16[PEC] Recherche d’une victime · clôturée en v2 (fusion)
FSD-46[PC] Réception et enregistrement initial de la victime · clôturée en v2 (fusion)
FSD-47[PC] Création et constitution du dossier numérique de prise en charge · clôturée en v2 (fusion)
FSD-48[PC] Génération d’un identifiant unique de dossier · clôturée en v2 (fusion)
FSD-49[PC] Enregistrement des informations liées à l’accident · clôturée en v2 (fusion)
FSD-50[PC] Transmission électronique des dossiers aux acteurs concernés · clôturée en v2 (fusion)
FSD-51[PC] Enregistrement du consentement au traitement des données · clôturée en v2 (fusion)
FSD-68[PC] Orientation des dossiers vers organismes externes · clôturée en v2 (fusion)
FSD-554[PEC] Réception de la victime au siège5
FSD-560[PEC] Collecte des informations10
FSD-571[PEC] Enregistrement5
FSD-816[PEC] Transmission vers l'organisme compétent10
Les épics d'accueil et d'enregistrement existent en plusieurs générations (FSD-46 à 51 vides, FSD-554/560/571 remplies) : fusionner avant assignation. Le consentement (FSD-51) n'a aucune story.

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

svc-medical-care