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

svc-statistics

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

1. Rôle et responsabilités

Réception des bordereaux RC Auto transmis par l'ASACI (via asaci-edge), import et validation, consolidation des données statistiques, états et exports vers l'outil BI.

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

RcAutoBatchStatisticalDataset

3. API exposée

/v1/rc-auto-batches/v1/datasets/v1/exports

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

rc-auto-batch.received rc-auto-batch.imported rc-auto-batch.rejected dataset.published

5. Événements consommés

statement.validated violation.recorded

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

6. Dépendances synchrones

asaci-edge

7. Flux principal

8. Backlog Jira rattaché

50 tickets du backlog Jira se rattachent à ce service, via 3 épics :

Épic	Intitulé	Enfants
FSD-81	[PROD] Importation des bordereaux RC Auto	15
FSD-82	[PROD] Traitement des données statistiques	12
FSD-83	[PROD] Diffusion des statistiques	20

Couvert par les épics FSD-81 à 83 (import bordereaux, traitement, diffusion). Le canal technique de réception ASACI (API, SFTP, dépôt) reste à contractualiser : voir asaci-edge.

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