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

svc-contributions

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

1. Rôle et responsabilités

Bulletins des compagnies, contrôles automatisés, bordereaux de production et d'encaissement, contribution des non-assurés, contribution de l'État, pénalités compagnies (10 %), compensations entre créances (netting), contrôle d'assiette (détection de sous-déclaration).

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

InsurerStatementProductionSlipCollectionSlipStateContributionUninsuredContributionPenaltyNettingTaxBaseAssessment

3. API exposée

/v1/insurer-statements/v1/slips/v1/penalties/v1/nettings/v1/tax-base-assessments

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

statement.submitted statement.validated statement.rejected statement.correction-requested production-slip.issued collection-slip.issued state-contribution.recorded penalty.applied netting.requested netting.approved contribution.overdue underreporting.detected

5. Événements consommés

insurer.updated payment.reconciled regulatory-parameter.changed

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

6. Dépendances synchrones

svc-reference-data erp-edge

7. Flux principal

8. Backlog Jira rattaché

104 tickets du backlog Jira se rattachent à ce service, via 5 épics :

Épic	Intitulé	Enfants
FSD-72	[PROD] Contribution des assurés	98
FSD-73	[PROD] Contribution des non assurés	3
FSD-74	[PROD] Contribution de l’État (25%)	4
FSD-75	[PROD] Pénalités compagnies	2
FSD-76	[PROD] Gestion des compensations	3

Tickets orphelins à raccrocher : FSD-358 FSD-359 FSD-360 FSD-361 FSD-362 FSD-363 FSD-364 FSD-365 FSD-366 FSD-367 FSD-368 FSD-369 FSD-370 FSD-372 FSD-373 FSD-374 FSD-375

La contribution des assurés est bien couverte (épic FSD-72, 82 tickets) mais les 4 autres sources de financement (FSD-73 à 76 : non-assurés, État, pénalités, compensations) sont des épics vides. Les 17 tickets orphelins FSD-358 à 375 (consolidation, bordereaux mensuels) se rattachent ici.

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