# Carte de reprise RNA/SIRENE/WALDEC — 22403

Source figée : `6da704473dca2ff0b403f955d3385569c4e5143c`, branche historique `chore/change-venv-to-uv`. Consultation Git uniquement ; aucun checkout, import runtime, Python exécuté ni migration de données. Cette carte décrit la reprise de structure, pas une correspondance numérique pour basculer une base existante. Voir [dictionnaire](../../docs/domains/referentiel-associations.md) et [ADR](../../docs/decisions/0002-modele-associations-prisma.md).

## Adaptations transverses

`raw.fichier_run` est éclaté en `ref.fichier_source` (contenu unique par source/empreinte), `ref.execution_import` (chaque tentative, dont échecs), `ref.etat_referentiel` (application courante) et `ref.source` (catalogue sans seed). Nom/URL/taille/empreinte/fraîcheur/métadonnées du contenu vont dans FichierSource ; début/fin/statut/compteurs/critère de diagnostic/mode/watermark/colonnes/métadonnées d’exécution vont dans ExecutionImport ; dag_run_id devient orchestrationId facultatif. Aucune ancienne tentative n’est réinitialisée par le modèle. Le registre d’état distinct permet A → B → A et invalidation.

`ref.association` devient identité stable + AssociationVersion. Ses attributs et deux provenances sont versionnés ; les identifiants sont uniques dans l’identité courante et copiés comme snapshots non uniques dans chaque version. Les enfants restent attachés à l’identité stable, sans déplacement au changement de nom. L’unicité id_ex, auparavant absente de ref et présente en staging, devient cohérente après séparation des versions. RNA import utilise historiquement le champ id ; waldec gestion + id_ex. Le futur portage qualifiera collisions et normalisation sans perdre les zéros.

Les périodes utilisent des instants de connaissance explicites, sans 1900 ni actif stocké. Les CHECK/FK restrictives et index partiels remplacent les réparations/renommages idempotents historiques. Les doubles unicités de contact remplacent COALESCE. Géographie sans source qualifiée : tables vides, FK facultatives, codes reçus conservables séparément ; anciens seeds de catégories juridiques et source numérotée non copiés. WALDEC reste distinct des fichiers RNA, sans FK des codes objets des associations.

La totalité du contenu RNA/SIRENE reste dans JSONB ; seules les projections retenues sont structurées. Les anciens calculs cle/MD5 sont reportés au futur chargeur, pas importés comme colonnes générées. BRIN/GIN, watermark delta, filtre de périmètre, matching, DQ, publications atomiques, verrous, téléchargement et orchestration sont différés. Les anciens tests de bases fixes persistantes sont remplacés par des fixtures jetables propres à cette campagne.

## Destination des colonnes historiques

### `raw.fichier_run` → contenu, tentative et état

| Colonne historique | Destination |
| --- | --- |
| id_fichier_run | ExecutionImport.id, FichierSource.id distinct ; pas de conservation numérique automatique |
| id_source | Source.code et relations sourceCode |
| nom_fichier, url_source, taille_octets, empreinte_sha256, date_fraicheur_source | FichierSource.nomFichier/urlSource/tailleOctets/empreinteSha256/dateFraicheurSource |
| dag_run_id | ExecutionImport.orchestrationId facultatif |
| date_debut, date_fin, statut | ExecutionImport.debut/fin/statut ; statut actuel appliqué séparé dans EtatReferentiel |
| nb_lignes_fichier, nb_lignes_chargees, nb_lignes_exclues | ExecutionImport.nbLignesFichier/nbLignesChargees/nbLignesExclues |
| critere_filtrage | ExecutionImport.diagnostic ; règle de filtrage à définir dans le futur importeur |
| colonnes_source, mode_chargement, watermark_source, metadonnees_source | ExecutionImport.colonnesSource/modeChargement/watermarkSource/metadonneesSource ; métadonnées du contenu aussi dans FichierSource.metadonnees |

### `raw.rna_import` → `raw.rna_import`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_ligne` | id |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `ligne_numero` | ligneNumero |
| `contenu` | contenu |
| `cle` | cle facultative fournie par futur chargeur ; JSONB conservé |
| `empreinte_ligne` | différé ; aucune empreinte de ligne ni MD5 automatique |
| `statut` | statut |
| `motif_rejet` | motifRejet |
| `date_integration` | dateIntegration |
| `date_rejet` | dateRejet |

### `raw.rna_waldec` → `raw.rna_waldec`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_ligne` | id |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `ligne_numero` | ligneNumero |
| `contenu` | contenu |
| `cle` | cle facultative fournie par futur chargeur ; JSONB conservé |
| `empreinte_ligne` | différé ; aucune empreinte de ligne ni MD5 automatique |
| `statut` | statut |
| `motif_rejet` | motifRejet |
| `date_integration` | dateIntegration |
| `date_rejet` | dateRejet |

### `raw.sirene_unite_legale` → `raw.sirene_unite_legale`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_ligne` | id |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `ligne_numero` | ligneNumero |
| `contenu` | contenu |
| `cle` | cle facultative fournie par futur chargeur ; JSONB conservé |
| `empreinte_ligne` | différé ; aucune empreinte de ligne ni MD5 automatique |
| `statut` | statut |
| `motif_rejet` | motifRejet |
| `date_integration` | dateIntegration |
| `date_rejet` | dateRejet |

### `raw.sirene_etablissement` → `raw.sirene_etablissement`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_ligne` | id |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `ligne_numero` | ligneNumero |
| `contenu` | contenu |
| `cle` | cle facultative fournie par futur chargeur ; JSONB conservé |
| `empreinte_ligne` | différé ; aucune empreinte de ligne ni MD5 automatique |
| `statut` | statut |
| `motif_rejet` | motifRejet |
| `date_integration` | dateIntegration |
| `date_rejet` | dateRejet |

### `ref.source` → `ref.source`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `code` | code |
| `libelle` | libelle |
| `url_description` | urlDescription |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.categorie_juridique` → `ref.categorie_juridique`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `code` | code |
| `libelle` | libelle |
| `est_perimetre` | estPerimetre |
| `niveau2` | niveau2 |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.objet_social` → `ref.objet_social`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `code` | code |
| `libelle` | libelle |
| `code_parent` | codeParent |
| `niveau` | niveau |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.region` → `ref.region`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `code` | code |
| `libelle` | libelle |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.departement` → `ref.departement`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `code` | code |
| `code_region` | codeRegion |
| `libelle` | libelle |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.commune` → `ref.commune`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `code_insee` | codeInsee résolu et codeInseeSource ; Commune.code pour sa PK |
| `code_departement` | codeDepartement |
| `libelle` | libelle |
| `type_com` | typeCom |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.type_voie` → `ref.type_voie`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `code` | code |
| `libelle` | libelle |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.pays` → `ref.pays`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `code` | code |
| `libelle` | libelle |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.association` → `ref.association_version`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_association` | Association.id stable + AssociationVersion.id technique ; aucune conservation automatique des anciens ids |
| `id_rna` | Association.idRna + AssociationVersion.idRna (snapshot) |
| `id_siren` | Association.idSiren + AssociationVersion.idSiren (snapshot) |
| `id_ex` | Association.idEx + AssociationVersion.idEx (snapshot) |
| `nom` | nom |
| `sigle` | sigle |
| `objet` | objet |
| `objet_social1` | objetSocial1 |
| `objet_social2` | objetSocial2 |
| `date_creation_association` | dateCreationAssociation |
| `date_publication_jo` | datePublicationJo |
| `date_dissolution` | dateDissolution |
| `statut_association_rna` | statutAssociationRna |
| `nature` | nature |
| `groupement` | groupement |
| `rup_mi` | rupMi |
| `ess` | ess |
| `societe_mission` | societeMission |
| `date_derniere_maj_source` | dateDerniereMajSource |
| `nom_sirene` | nomSirene |
| `date_creation_association_sirene` | dateCreationAssociationSirene |
| `statut_association_sirene` | statutAssociationSirene |
| `activite_principale_sirene` | activitePrincipaleSirene |
| `categorie_juridique_unite_legale` | categorieJuridiqueUniteLegale |
| `date_dernier_traitement_sirene` | dateDernierTraitementSirene |
| `caractere_employeur_sirene` | caractereEmployeurSirene |
| `archive` | AssociationVersion.finValidite pour clôture ; Association.retireLe pour retrait |
| `id_source` | AssociationVersion.sourceRnaCode (code de provenance RNA, sans numéro fixe) |
| `id_fichier_run` | AssociationVersion.executionRnaId ; fichier retrouvé via la tentative RNA |
| `id_source_sirene` | sourceSireneCode |
| `id_fichier_run_sirene` | executionSireneId |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.association_adresse` → `ref.association_adresse`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_association_adresse` | id |
| `id_association` | associationId (identité stable) |
| `type_adresse` | typeAdresse |
| `complement` | complement |
| `numero_voie` | numeroVoie |
| `indice_repetition` | indiceRepetition |
| `code_type_voie` | codeTypeVoie |
| `libelle_voie` | libelleVoie |
| `distribution` | distribution |
| `code_postal` | codePostal |
| `code_insee` | codeInsee résolu et codeInseeSource ; Commune.code pour sa PK |
| `libelle_commune` | libelleCommune |
| `cedex` | cedex |
| `code_pays` | codePays |
| `libelle_pays` | libellePays |
| `date_debut_validite` | debutValidite (prise en compte technique explicite) |
| `date_fin_validite` | finValidite |
| `actif` | dérivé de finValidite NULL, colonne supprimée |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.etablissement` → `ref.etablissement`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_etablissement` | Etablissement.id technique de version |
| `id_association` | associationId (identité stable) |
| `siret` | siret |
| `est_siege` | estSiege |
| `nic` | nic |
| `etat_administratif` | etatAdministratif |
| `date_creation_etablissement` | dateCreationEtablissement |
| `date_debut_periode` | dateDebutPeriode |
| `activite_principale` | activitePrincipale |
| `nomenclature_activite` | nomenclatureActivite |
| `caractere_employeur` | caractereEmployeur |
| `tranche_effectifs` | trancheEffectifs |
| `annee_effectifs` | anneeEffectifs |
| `enseigne1` | enseigne1 |
| `enseigne2` | enseigne2 |
| `enseigne3` | enseigne3 |
| `denomination_usuelle` | denominationUsuelle |
| `complement` | complement |
| `numero_voie` | numeroVoie |
| `indice_repetition` | indiceRepetition |
| `code_type_voie` | codeTypeVoie |
| `libelle_voie` | libelleVoie |
| `distribution` | distribution |
| `code_postal` | codePostal |
| `code_insee` | codeInsee résolu et codeInseeSource ; Commune.code pour sa PK |
| `libelle_commune` | libelleCommune |
| `cedex` | cedex |
| `code_pays` | codePays |
| `libelle_pays` | libellePays |
| `coordonnee_lambert_x` | coordonneeLambertX |
| `coordonnee_lambert_y` | coordonneeLambertY |
| `date_debut_validite` | debutValidite (prise en compte technique explicite) |
| `date_fin_validite` | finValidite |
| `actif` | dérivé de finValidite NULL, colonne supprimée |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.coordonee` → `ref.coordonnee`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_coordonee` | Coordonnee.id |
| `type_coordonee` | type |
| `valeur_brute` | valeurBrute |
| `valeur_normalisee` | valeurNormalisee |
| `valide` | valide |
| `date_verif` | dateVerif |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `ref.entite_coordonee` → `ref.entite_coordonnee`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_entite_coordonee` | id |
| `id_coordonee` | coordonneeId |
| `id_association` | associationId (identité stable) |
| `id_etablissement` | etablissementId (version) |
| `est_principal` | estPrincipal |
| `communication` | communication |
| `date_debut_validite` | debutValidite (prise en compte technique explicite) |
| `date_fin_validite` | finValidite |
| `actif` | dérivé de finValidite NULL, colonne supprimée |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `stg.correspondance` → `stg.correspondance_identifiants`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `id_correspondance` | id |
| `id_rna` | idRna |
| `id_ex` | idEx |
| `id_siren` | idSiren |
| `origine` | origine |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

### `stg.sirene_unite_legale` → `stg.unite_legale_a_apparier`

| Colonne historique | Destination / adaptation |
| --- | --- |
| `siren` | siren |
| `identifiant_association_rna` | identifiantAssociationRna |
| `statut_appariement` | statutAppariement |
| `id_rna_rapproche` | idRnaRapproche |
| `date_appariement` | dateAppariement |
| `dernier_id_ligne` | dernierIdLigne |
| `dernier_id_fichier_run` | derniereExecutionId |
| `id_source` | Source.code / sourceCode (pas de numéro fixe) |
| `id_fichier_run` | ExecutionImport.id ; FichierSource via tentative |
| `date_insertion` | insereLe |
| `date_maj` | modifieLe |

## Sources comportementales et limites

`Projets/data/docs/modele-donnees.md`, README/code/tests ingestion, appariement, alimentation, data_quality et referentiels à la même révision. `work-items/DATA-ALIM-REF` décrit les provenances et l’historisation ; `DATA-ALIM-RECETTE` la clé import id et l’index id_ex ; `DATA-ALIM-REFERENTIEL` les objets RNA hors nomenclature et les parents inconnus ; `DATA-ALIM-ETAB-ND` le placeholder Lambert. `[ND]` reste admissible en JSONB et correspondra à NULL en projection future, sans conversion implémentée dans 22403.

Ne pas reprendre automatiquement les politiques historiques « première ligne gagne », les listes de périmètre, les suppressions de schéma ou les anciennes autorisations de recette. Aucun seed, chargement géographique, matching, synchronisation ou import réel n’est livré ici. RH, représentants, fédérations, QPV/ZRR, cartographie et autres domaines non qualifiés ne sont pas créés.

## Portage comportemental WALDEC — 22407

Le [lot 22407](../../docs/work-items/22407-waldec.md) porte exclusivement `Projets/data/referentiels/` de la révision figée ci-dessus vers `packages/database` et `app/data-jobs`. Registre sources.py → registry.ts ; acquisition datagouv.py → acquire.ts ; validation/hiérarchie pipeline.py → waldec.ts ; orchestration/UPSERT/trace → sync.ts ; CLI/config → app/data-jobs et scripts/data-jobs.ts. Aucun import runtime depuis legacy et aucun Python exécuté par la cible.

Conservés : codes texte, BOM, parents absents sans valeurs inventées, upserts sans suppression. Corrigés : doublons silencieux, réinitialisation des tentatives, détection par métadonnées/historique de SHA, compteur de parents trompeur, absence de validation/verrou. EtatReferentiel est relu sous advisory transactionnel ; données/succès/état publiés ensemble. Les tests historiques de base fixe ne sont pas repris : fixtures synthétiques, HTTP simulé et PostgreSQL jetable nettoyé.

Le [runbook WALDEC](../../docs/applications/waldec.md) et la provenance du snapshot documentent licence LO 2.0, ressource actuelle vérifiée, identité par SHA plutôt qu'un millésime inventé, commandes, résultats et reprise. Les comportements différés plus haut restent différés pour les autres chaînes RNA/SIRENE et référentiels. Le portage WALDEC ne reprend ni ingestion d'associations, ni Airflow, ni géographie.
