# 22407 — Nomenclature WALDEC TypeScript

Ticket [22407](https://projets.synaltic.fr/issues/22407), projet data-asso-v3, parent 22395. Solution et matrice V1–V6 approuvées le 2026-11-04 avec implémentation/revue/corrections dans le périmètre, sur E-22395 sans commit. Lot limité à 39 chemins, sans staging/livraison, mutation distante ou base existante.

## Réalisation

Deux workspaces privés stricts : `packages/database` et `app/data-jobs`. CLI hôte avec acquisition explicite sans base et synchronisation locale sans réseau, SHA obligatoire. Le [runbook](../applications/waldec.md) porte les commandes effectives, cible, résultats, limites et reprise. [Dictionnaire](../domains/referentiel-associations.md) et [carte de reprise](../../legacy/migration-map/rna-sirene-waldec.md) distinguent nomenclature et associations RNA WALDEC.

Snapshot public Orléans Métropole, LO 2.0, provenance et attribution dans `packages/database/referentiels/README.md`, 28 951 octets/297 lignes, SHA-256 `cd58f33f78dfa4a000a856c8b01412e9d41c7bbfc676b0ffbc2151223d8448bd` confirmé avant ajout. Version par empreinte ; modification déclarée 2022-06-14 conservée sans millésime métier inventé. csv-parse 6.1.0 (MIT/types ESM) vérifié sur miroir Synaltic et épinglé. Node/TS/Prisma/pg restent aux versions du socle.

BOM et zéros conservés, quatre en-têtes/colonnes stricts, données invalides/doublons/cycles rejetés. Racines normalisées, parents absents créés sans valeurs inventées et entrées existantes préservées. Le graphe fusionné avec codes retirés conservés est contrôlé. Dates d'insertion stables, pas de suppression implicite ou modification d'associations.

Tentative nouvelle avant lecture du fichier, contenu unique source/SHA, état courant relu sous advisory lock sur la même transaction Prisma malgré le pool. ObjetSocial, succès et EtatReferentiel atomiques ; unchanged explicite sans mutation métier/état. A→B→A, transformation et invalidation pris en compte. Rollback puis diagnostic séparé, ancienne tentative conservée, résultat incertain relu sans rejeu aveugle. Les tentatives interrompues restent non confirmées et distinctes des nouvelles.

## Preuves proportionnées

La matrice fermée V1–V6 réutilise les preuves Prisma 22403, sans nouvelle campagne de schéma inchangé. Les logs et le détail des commandes/limitations sont conservés dans le rapport externe du chantier, sans credentials.

| Preuve | Résultat observé / portée |
| --- | --- |
| V1 — dépendances | Installation puis immutable réussies ; csv-parse 6.1.0 compatible avec les builds/types du projet. Warnings peers fournisseurs existants, sans élargissement de dépendances. |
| V2 — build/typecheck | build:data-jobs génère/compile Prisma puis les deux consommateurs ; typecheck strict du socle et workspaces réussi. Pas de génération équivalente indépendante répétée. |
| V3 — test:waldec:unit | 9 tests réussis sans skip : règles WALDEC, HTTP simulé (réessai/timeout/échec/nettoyage/non-écrasement), CLI, configuration/secrets. Le serveur HTTP nécessite un accès loopback autorisé dans ce runtime. |
| V4 — test:waldec:integration | 7 tests incluant le parent, 0 échec/skip ; campagne finale observée environ 4,21 s, hors préparation des dépendances. I1 wrapper racine/CLI sur configuration synthétique et chargement initial ; I2 inchangé/timestamps ; I3 B→A/transformation/invalidation/stabilité ; I4 mauvais SHA/CSV/cycle fusionné et tentative interrompue ; I5 erreur réelle après écriture puis rollback/reprise ; I6 deux attentes advisory réelles, relecture et fermeture. |
| V5 — documentation | Métadonnées et deux compilations séparées sont les contrôles retenus pour les pages et sources SPDD du lot ; commandes `check:docs`, `build:documentation`, `build:developer-portal`. Résultats finaux consignés dans le rapport externe. Aucun test du moteur de recherche, image ou serveur inchangé. |
| V6 — cohérence | Périmètre exact, liens locaux, commandes et diff font l'objet de la vérification finale ; détails dans le rapport externe, aucun staging/commit. |

Les tests utilisent uniquement des octets synthétiques et HTTP simulé. La fixture PostgreSQL 18 a son conteneur/réseau UUID, port loopback aléatoire, tmpfs sans volume et credentials synthétiques. Le wrapper est exécuté depuis un worktree temporaire avec copies des helpers et .env synthétique ; jamais le vrai .env ni une base du développeur. Une association/version préexistante synthétique et toutes les tables hors périmètre restent identiques. Le trigger d'échec et la barrière de concurrence existent seulement dans la fixture et sont nettoyés. Clients/conteneur/réseau/tmpdirs de la campagne sont nettoyés en finally.

Première tentative V4 bloquée avant création de ressource : contexte desktop-linux vers socket absent. Utilisation de DOCKER_CONTEXT=default limitée au processus sur daemon déjà disponible, sans changement global ni démarrage de service. Première tentative V3 dans sandbox arrêtée par assertion native Node avant assertions HTTP ; même preuve avec accès loopback autorisé réussie. Aucun skip vert ni contournement d'une assertion produit.

Réexécuter une preuve seulement après changement pertinent ou cause corrigée : manifests/résolutions V1 ; TS/config V2 ; règles/HTTP/CLI V3 ; persistance/verrou/runtime V4 ; site aux sources changées V5 ; diff/liens V6. Aucun quota, benchmark, test du parseur/Prisma, réseau data.gouv dans les tests ou base de production.

## Limites

Aucune migration : réutilisation intégrale du modèle 22403. Aucune recette sur base existante ou import d'associations, autre référentiel, Next/Airflow/CI/CD, image jobs ou Compose applicatif. Source amont vivante : changement d'octets bloque le SHA attendu et nécessite qualification volontaire. SIGKILL/panne peut laisser en_cours et empêcher le diagnostic ; reprise avec lecture d'état et tentative distincte, jamais réinitialisation. Ce lot ne réalise ni volumétrie ni bascule historique.
