# 22403 — Premier schéma Prisma associations RNA/SIRENE et WALDEC

Ticket [22403](https://projets.synaltic.fr/issues/22403), parent 22395, projet data-asso-v3. Solution, 29 fichiers et matrice V1–V6 approuvés le 2026-11-03, puis correction locale de demarrage.md autorisée explicitement (« Oui, corriger cette phrase »), portant le lot à 30 chemins ; branche E-22395, sans staging ni commit dans ce lot.

## Livrables et limites

23 modèles dans raw/stg/ref, identité stable + snapshots historiques, trace contenu/tentative/état séparée, contacts exclusifs, nomenclatures facultatives. [ADR](../decisions/0002-modele-associations-prisma.md), [dictionnaire détaillé](../domains/referentiel-associations.md), [carte de reprise](../../legacy/migration-map/rna-sirene-waldec.md), [runbook](../applications/prisma.md), package et migration évoluent ensemble. Une seule migration neuve ; pas de baseline ni transfert de données historiques.

Portage Python/TypeScript, importeurs, matching, DQ, synchronisation, verrous et publication atomique des données sont différés. Next/jobs/CI, profils Compose applicatifs, seeds et vrais référentiels sont hors lot. Le ticket 22400 reste partiel. Les tests prouvent les capacités de la structure et de la configuration, pas un importeur futur.

## Validation proportionnée

Matrice approuvée : V1 métadonnées/installation puis immutable ; V2 validate/génération/build/typecheck ; V3 configuration hôte/interne et secrets ; V4 PostgreSQL 18 jetable (I1 client/migration, I2 bruts/provenance, I3 identité/périodes, I4 contacts, I5 état A→B→A, I6 seconde application/évolution) ; V5 métadonnées et deux builds des sites ; V6 cohérence, liens et diff du lot. Réexécuter seulement la preuve affectée par un changement ou échec concret. Pas de test de parseur, bibliothèque, recherche Docusaurus, données réelles ou quota de couverture.

Les résultats exécutés et les limites sont consignés ci-dessous ; la réalisation n’implique aucune publication.

## Résultats exécutés le 3 novembre 2026

| Preuve | Résultat constaté |
| --- | --- |
| V1 — versions et installation | Métadonnées du miroir confirmées pour les cinq versions exactes, engines compatibles Node 24 / TS 5.9.3. Installation puis immutable réussies. La plage de l’adaptateur avait d’abord résolu une seconde copie pg/types 8.23.1 ; deux resolutions ciblées ont imposé pg 8.16.3 / types 8.16.0 dans ce chemin aussi, puis résolution et immutable ont réussi. Aucun changement de majeure ou copie d’authentification. |
| V2 — validate, build:prisma, typecheck | Schéma valide, client généré dans le package puis compilé NodeNext, types racine/package/deux sites valides. Typecheck relancé après la modification effective de résolution. |
| V3 — test:prisma:config | 4 tests réussis : configuration Docker/encodage/cibles, commandes et shadow bornées (dont alias loopback), expurgation des diagnostics et propagation d’un vrai sous-processus en échec avec sortie expurgée. Exécution directe Node pour exposer les assertions réelles, sans se contenter du seul passage du fichier rapporté par node --test. |
| V4 — test:prisma:integration | I1–I6 réussis : 7 tests incluant le parent, 0 échec, 0 skip, environ 9,86 s dans la campagne finale avec le pilote approuvé. |
| V5 — check:docs et deux builds | Métadonnées valides : exploitation 5 pages/4 sources, portail 6 pages/6 sources. Les deux compilations statiques ont réussi ; après l’autorisation du 30e fichier, seul le portail a été recompilé avec succès. Aucune image/runtime HTTP rejoué. |
| V6 — contenu, liens et diff | Les 30 chemins correspondent à la liste approuvée et à son extension documentaire explicite, aucun autre changement ; 60 liens locaux du lot résolus sans absence. Diff sans erreur d’espacement, branche E-22395, aucun staging/commit. |

Détail V4 : I1 applique la migration sur base vide, consulte l’état, utilise le client compilé puis ferme son pool et vérifie la connexion interne. I2 conserve quatre JSONB invalides/rejetés et refuse les incohérences de provenance. I3 conserve identité/snapshots/provenances et refuse les doublons courants et périodes incohérentes. I4 prouve XOR/déduplication et collision numérique entre types d’entité sans conflit. I5 conserve quatre tentatives dont un échec et représente A → B → A/v2 avec état cohérent. I6 démontre un second deploy préservant les données, puis une vraie migration temporaire ajoutant un index à Source.libelle, générée avec replay shadow et appliquée sans perte des définitions CHECK/FK/index partiels ni des rejets représentatifs.

Erreurs rencontrées et corrigées : le moteur de diff sans datasource explicite sortait sans SQL ; la génération a été faite avec config et connexion synthétique hors ligne, puis présence du DDL vérifiée. La première campagne PostgreSQL avait deux défauts de setup (authentification psql interne non fournie et séquence établissement non avancée après id explicite), causant des échecs dépendants ; corrections avant succès, sans modification des invariants. La campagne finale a été rejouée uniquement parce que le pilote effectivement résolu a changé.

Les conteneurs, réseaux et tmpdirs de fixture ont été nettoyés ; le contrôle en lecture seule des étiquettes de campagne ne montre aucun conteneur/réseau résiduel. Aucun volume/base préexistant ni vrai .env.docker utilisé. Pas de run métier ni de collecte réelle. Les détails et le journal V4 sont conservés dans les artefacts externes du chantier.

Warnings non bloquants : peers fournisseurs Docusaurus/Algolia et Studio Prisma (Studio non utilisé ici), scripts de build fournisseurs désactivés par la configuration existante, vérification de mise à jour Docusaurus sans accès à son cache utilisateur. Les commandes utiles et builds ci-dessus ont réussi ; aucune modification de configuration globale ou dépendance inutile ajoutée pour masquer ces warnings.

## Correspondance avec les dix critères

1. Dictionnaire complet et carte des tables/colonnes : relus (V6), documents diffusés par les sites (V5).
2. Identité stable, snapshots, id_ex unique et courant unique : I3.
3. Bruts/rejets/provenance, sources distinctes et objets RNA sans FK : I2/I3.
4. Fichier/tentative/état, échecs et A→B→A/transformation : I2/I5.
5. Contacts exclusifs et unicités séparées : I4.
6. Périodes, adresses/SIRET, géographie/Lambert facultatifs : I3/I4.
7. Installation/génération/types, configuration et fermeture : V1–V3/I1 ; connexion réelle effectuée sur fixture reprenant le même contrat de worktree, pas sur une base préexistante.
8. Migration neuve, répétition sans changement de données et évolution préservant le SQL : I1/I6.
9. Fixtures isolées et contrôles propres au projet : V3/V4/V6 ; aucun importeur testé ou prétendu livré.
10. Code, procédures, dictionnaire et carte concordants dans le lot (V6), avec la correction documentaire explicitement autorisée de demarrage.md.

## Limites et dette signalée

La phrase héritée de `app/developer-portal/docs/demarrage.md` annonçant Prisma comme futur a été corrigée après l’accord explicite « Oui, corriger cette phrase ». Cette extension autorisée est le 30e chemin du lot ; les profils applicatifs Compose restent absents. Aucune validation de base ou d’installation n’est répétée pour cette correction de prose.

Aucun transfert de données historiques, importeur, synchronisation, verrou de publication ni suppression automatique de code retiré n’est livré. Les cycles WALDEC indirects, les transitions historiques ordonnées et les politiques métier de fusion/retrait restent au futur service ; les périodes closes ne sont pas toutes protégées contre le chevauchement. Aucune validation de production ou de volumétrie réelle n’est revendiquée.
