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

svc-medical-care

Catégorie : Métier  ·  Périmètre : PR1 · prise en charge  ·  Module : services/svc-medical-care (monorepo fga-services — ADR-0001)  ·  Stack : Java · Quarkus · Gradle · YAML  ·  Architecture : hexagonale

1. Rôle et responsabilités

Demandes de prise en charge, visa médical, bons (hospitalisation, pharmacie, examens), lettres de garantie, suivi médical et prescriptions, alertes de renouvellement de garantie, consolidation médicale.

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

CareRequestCareVoucherGuaranteeLetterFollowUpSheetPrescriptionConsolidation

3. API exposée

/v1/care-requests/v1/care-vouchers/v1/guarantee-letters/v1/follow-up-sheets

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-medical-care · flux principalconsommercare-request.submitteddemander les complémentsnondossier complet ?ouipubliercare-request.rejecteddéfavorablevisa médical ?publiercare-request.approvedémettre les bonspubliercare-voucher.issueddemander la lettre de garantie(documents · signatures)attendresignature.completedpublierguarantee-letter.signedsuivre la consommation des bonspublierguarantee.renewal-dueouiéchéance proche ?ouigarantie active ?nonenregistrer la consolidationpubliercare.consolidatedfavorable

8. Backlog Jira rattaché

192 tickets du backlog Jira se rattachent à ce service, via 32 épics :

ÉpicIntituléEnfants
FSD-10[PEC] Visite des hôpitaux · clôturée en v2 (fusion)
FSD-13[PEC] Vérification de complétude · clôturée en v2 (fusion)
FSD-14[PEC] Analyse du dossier · clôturée en v2 (fusion)
FSD-15[PEC] Validation médicale · clôturée en v2 (fusion)
FSD-17[PEC] Remise fiche sinistre · clôturée en v2 (fusion)
FSD-18[PEC] Transmission et suivi des dossiers sinistres · clôturée en v2 (fusion)
FSD-19[PEC] Notification des assureurs et organismes externes · clôturée en v2 (fusion)
FSD-20[PEC] Gestion des demandes PEC · clôturée en v2 (fusion)
FSD-21[PEC] Génération des bons de prise en charge15
FSD-22[PEC] Préparation et validation des lettres de garantie · clôturée en v2 (fusion)
FSD-23[PEC] Validation des documents sinistres · clôturée en v2 (fusion)
FSD-24[PEC] Envoi des bons aux structures de soins · clôturée en v2 (fusion)
FSD-25[PEC] Suivi des actes médicaux · clôturée en v2 (fusion)
FSD-26[PEC] Contrôle des interventions chirurgicales · clôturée en v2 (fusion)
FSD-30[PEC] Gestion des certificats médicaux · clôturée en v2 (fusion)
FSD-31[PEC] Clôture complète des dossiers sinistres · clôturée en v2 (fusion)
FSD-43[PEC] Clôture administrative du dossier sinistre · clôturée en v2 (fusion)
FSD-45[PEC] Tableau de bord de pilotage des dossiers sinistres · clôturée en v2 (fusion)
FSD-52[PC] Vérification et validation des demandes de prise en charge · clôturée en v2 (fusion)
FSD-53[PC] Génération et suivi des bons de prise en charge · clôturée en v2 (fusion)
FSD-54[PC] Préparation et validation des lettres de garantie · clôturée en v2 (fusion)
FSD-55[PC] Suivi des bons émis et de leur utilisation7
FSD-56[PC] Mise à jour continue du dossier de prise en charge5
FSD-57[PC] Gestion des fiches de suivi de la victime7
FSD-58[PC] Gestion et validation des prescriptions médicales · clôturée en v2 (fusion)
FSD-59[PC] Déclenchement des alertes de renouvellement de garantie · clôturée en v2 (fusion)
FSD-67[PC] Consolidation médicale et clôture du dossier · clôturée en v2 (fusion)
FSD-577[PEC] Validation de la demande de prise en charge4
FSD-628[PEC] Lettre de garantie18
FSD-720[PEC] Clôture de la prise en charge · clôturée en v2 (fusion)
FSD-790[PEC] Consolidation médicale et clôture du dossier25
FSD-901[IND] Clôture de la prise en charge · clôturée en v2 (fusion)
Le service le plus fourni en tickets, mais en trois générations superposées (épics PC et PEC anciennes contre PEC de juillet) : dédoublonner avant de chiffrer. La clôture IND (FSD-901) duplique la clôture PEC (FSD-720) et se rattache ici.

MAJ backlog v2 (16/07/2026) — Dédoublonnage v1 réalisé en v2 : les générations PC/PEC anciennes sont clôturées par fusion — le backlog restant est la génération de référence.

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