# Référentiel associations RNA/SIRENE et WALDEC

Le lot [22403](../work-items/22403-schema-prisma.md) fournit la structure PostgreSQL 18 neuve. Ce dictionnaire décrit les 23 modèles de [l’ADR 0002](../decisions/0002-modele-associations-prisma.md) ; il ne constitue pas un importeur. Le lot [22407](../work-items/22407-waldec.md) réalise séparément la [synchronisation de nomenclature WALDEC](../applications/waldec.md), sans changement de structure. Le [schéma Prisma](../../packages/prisma/prisma/schema.prisma) et la [migration initiale](../../packages/prisma/prisma/migrations/20261103000000_initial_associations/migration.sql) sont versionnés ensemble. La [carte de reprise](../../legacy/migration-map/rna-sirene-waldec.md) qualifie le patrimoine.

## Conventions et cardinalités

Dans les tableaux, `?` indique une colonne nullable ; `[]` est une collection inverse sans colonne SQL. BigInt est bigint, String est text sauf type natif indiqué, Json est JSONB, Decimal est numeric(12,3), Int smallint lorsqu’annoté. DateTime est un horodatage technique timestamptz(6), une date métier `Date`, ou un timestamp source sans zone `Timestamp(6)` selon l’annotation. Les identifiants métier sont des chaînes, jamais des nombres.

Toutes les relations ont ON DELETE RESTRICT et ON UPDATE RESTRICT. Une association stable a 0..N versions, adresses, établissements et contacts ; chaque enfant possède un seul parent stable (les contacts choisissent une association ou un établissement). Un contact d’établissement référence sa version d’établissement, sans déplacement automatique. Une source a 0..N fichiers et tentatives, un fichier 0..N tentatives ; l’exécution peut ne pas encore avoir de fichier avant téléchargement. Une source possède au plus un état appliqué. L’état et les bruts ne peuvent changer de source en traversant leurs clés composites.

`insereLe` et `modifieLe` prennent now() à l’insertion ; `modifieLe` doit ensuite être écrit explicitement par le service appelant, sans trigger ni @updatedAt implicite ; le synchroniseur WALDEC assure cette écriture pour ses lignes publiées. Les autres valeurs par défaut sont affichées ci-dessous.

## Invariants SQL supplémentaires

Les CHECK et index partiels sont écrits dans la migration, sans previewFeatures Prisma. RNA = W suivi de 9 alphanumériques majuscules, SIREN = 9 chiffres, SIRET = 14 chiffres, id_ex non vide <=14. Association exige au moins un identifiant ; la correspondance exige RNA ou id_ex. Les trois clés non nulles de chacune sont uniques. Les snapshots de version ne sont pas uniques et conservent leurs identifiants après correction de l’identité courante.

Périodes de connaissance `[debutValidite, finValidite)` : début explicite obligatoire, fin NULL = courante, fin strictement supérieure au début. Les dates métier inconnues restent NULL. Une seule version courante par association, une adresse par association/type, un établissement par SIRET. Pas de date 1900, ni de booléen actif autonome. Les périodes closes ne sont pas protégées contre tous les chevauchements : le futur service ordonnera les transitions atomiquement.

Contacts : exactement une entité ; deux index uniques courants distincts association/coordonnée et établissement/coordonnée. Une association et un établissement ayant le même id numérique restent distincts. La valeur normalisée est obligatoire non vide et unique avec son type ; normalisation et vérification ne sont pas livrées.

Provenance facultative : source et exécution sont NULL ensemble ou renseignées ensemble. Les couples RNA et SIRENE d’AssociationVersion sont séparés ; codes RNA autorisés rna_import/rna_waldec, code enrichissement sirene_unite_legale. Le fichier se retrouve via l’exécution. Les références composites conservent source/fichier/tentative/transformation/statut cohérents. `EtatReferentiel.statutExecution` vaut obligatoirement reussie ; une tentative échouée n’est jamais appliquée. Absence d’état = jamais appliqué, invalideLe = dernière application connue à recalculer. A → B → A et changement de transformation sont représentables par des tentatives distinctes.

SHA-256 est composé de 64 caractères hexadécimaux minuscules, taille et compteurs sont non négatifs. Fin d’exécution >= début, exécution terminée possède une fin, succès requiert un fichier. Un brut a une ligne positive, une source correspondant à sa table et un motif non vide s’il est rejeté ; son JSONB et sa clé n’ont aucune contrainte métier. `cle` est une projection facultative à fournir par le futur chargeur ; pas de colonne générée ni d’empreinte de ligne calculée. Les index d’attente sont partiels, sans index GIN/BRIN anticipé.

ObjetSocial : parent différent de lui-même et niveau positif si connu. Les parents absents du fichier sont représentables par des lignes au libellé/niveau inconnus. Le synchroniseur WALDEC 22407 rejette les cycles indirects (y compris avec les lignes conservées) et doublons du fichier, ordonne les écritures parent/enfant et conserve les codes retirés. Les parents absents existants sont préservés ; profondeur inconnue reste NULL. Les deux codes objets RNA et la catégorie juridique SIRENE n’imposent aucune FK vers une nomenclature potentiellement incomplète. Les géographies et pays sont facultatifs, avec codes source séparés des FK résolues ; aucune table factice semée.

## Détail des modèles

### Source — `ref.source`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id |
| `libelle` | `libelle` | `String`  |
| `urlDescription` | `url_description` | `String?`  |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |

### FichierSource — `ref.fichier_source`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `sourceCode` | `source_code` | `String`  |
| `empreinteSha256` | `empreinte_sha256` | `String` @db.VarChar(64) |
| `tailleOctets` | `taille_octets` | `BigInt?`  |
| `nomFichier` | `nom_fichier` | `String?`  |
| `urlSource` | `url_source` | `String?`  |
| `dateFraicheurSource` | `date_fraicheur_source` | `DateTime?` @db.Date |
| `metadonnees` | `metadonnees` | `Json?` @db.JsonB |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |

Relations (cible et colonnes) :

- `source Source @relation("FichierSource_source", fields: [sourceCode], references: [code], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@unique([sourceCode, empreinteSha256])`; `@@unique([id, sourceCode])`.

### ExecutionImport — `ref.execution_import`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `sourceCode` | `source_code` | `String`  |
| `fichierId` | `fichier_id` | `BigInt?`  |
| `versionTransformation` | `version_transformation` | `String`  |
| `debut` | `debut` | `DateTime` @db.Timestamptz(6) |
| `fin` | `fin` | `DateTime?` @db.Timestamptz(6) |
| `statut` | `statut` | `StatutExecution` @default(en_cours) |
| `nbLignesFichier` | `nb_lignes_fichier` | `BigInt?`  |
| `nbLignesChargees` | `nb_lignes_chargees` | `BigInt?`  |
| `nbLignesExclues` | `nb_lignes_exclues` | `BigInt?`  |
| `nbLignesRejetees` | `nb_lignes_rejetees` | `BigInt?`  |
| `diagnostic` | `diagnostic` | `String?`  |
| `orchestrationId` | `orchestration_id` | `String?`  |
| `modeChargement` | `mode_chargement` | `ModeChargement?`  |
| `watermarkSource` | `watermark_source` | `DateTime?` @db.Timestamp(6) |
| `colonnesSource` | `colonnes_source` | `Json?` @db.JsonB |
| `metadonneesSource` | `metadonnees_source` | `Json?` @db.JsonB |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |

Relations (cible et colonnes) :

- `source Source @relation("ExecutionImport_source", fields: [sourceCode], references: [code], onDelete: Restrict, onUpdate: Restrict)`
- `fichier FichierSource? @relation("ExecutionImport_fichier", fields: [fichierId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@unique([id, sourceCode])`; `@@unique([id, sourceCode, fichierId])`; `@@unique([id, sourceCode, versionTransformation, statut])`; `@@index([fichierId, sourceCode])`; `@@index([sourceCode, debut])`.

### EtatReferentiel — `ref.etat_referentiel`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `sourceCode` | `source_code` | `String` @id |
| `executionId` | `execution_id` | `BigInt`  |
| `versionTransformation` | `version_transformation` | `String`  |
| `statutExecution` | `statut_execution` | `StatutExecution` @default(reussie) |
| `appliqueLe` | `applique_le` | `DateTime` @db.Timestamptz(6) |
| `invalideLe` | `invalide_le` | `DateTime?` @db.Timestamptz(6) |
| `motifInvalidation` | `motif_invalidation` | `String?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport @relation("EtatReferentiel_execution", fields: [executionId, sourceCode, versionTransformation, statutExecution], references: [id, sourceCode, versionTransformation, statut], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode, versionTransformation, statutExecution])`.

### RnaImportBrut — `raw.rna_import`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `executionId` | `execution_id` | `BigInt`  |
| `sourceCode` | `source_code` | `String`  |
| `fichierId` | `fichier_id` | `BigInt`  |
| `ligneNumero` | `ligne_numero` | `BigInt`  |
| `contenu` | `contenu` | `Json` @db.JsonB |
| `cle` | `cle` | `String?`  |
| `statut` | `statut` | `StatutLigne` @default(en_attente) |
| `motifRejet` | `motif_rejet` | `String?`  |
| `dateRejet` | `date_rejet` | `DateTime?` @db.Timestamptz(6) |
| `dateIntegration` | `date_integration` | `DateTime?` @db.Timestamptz(6) |

Relations (cible et colonnes) :

- `execution ExecutionImport @relation("RnaImportBrut_execution", fields: [executionId, sourceCode, fichierId], references: [id, sourceCode, fichierId], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@unique([executionId, ligneNumero])`; `@@index([executionId, sourceCode, fichierId])`.

### RnaWaldecBrut — `raw.rna_waldec`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `executionId` | `execution_id` | `BigInt`  |
| `sourceCode` | `source_code` | `String`  |
| `fichierId` | `fichier_id` | `BigInt`  |
| `ligneNumero` | `ligne_numero` | `BigInt`  |
| `contenu` | `contenu` | `Json` @db.JsonB |
| `cle` | `cle` | `String?`  |
| `statut` | `statut` | `StatutLigne` @default(en_attente) |
| `motifRejet` | `motif_rejet` | `String?`  |
| `dateRejet` | `date_rejet` | `DateTime?` @db.Timestamptz(6) |
| `dateIntegration` | `date_integration` | `DateTime?` @db.Timestamptz(6) |

Relations (cible et colonnes) :

- `execution ExecutionImport @relation("RnaWaldecBrut_execution", fields: [executionId, sourceCode, fichierId], references: [id, sourceCode, fichierId], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@unique([executionId, ligneNumero])`; `@@index([executionId, sourceCode, fichierId])`.

### SireneUniteLegaleBrute — `raw.sirene_unite_legale`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `executionId` | `execution_id` | `BigInt`  |
| `sourceCode` | `source_code` | `String`  |
| `fichierId` | `fichier_id` | `BigInt`  |
| `ligneNumero` | `ligne_numero` | `BigInt`  |
| `contenu` | `contenu` | `Json` @db.JsonB |
| `cle` | `cle` | `String?`  |
| `statut` | `statut` | `StatutLigne` @default(en_attente) |
| `motifRejet` | `motif_rejet` | `String?`  |
| `dateRejet` | `date_rejet` | `DateTime?` @db.Timestamptz(6) |
| `dateIntegration` | `date_integration` | `DateTime?` @db.Timestamptz(6) |

Relations (cible et colonnes) :

- `execution ExecutionImport @relation("SireneUniteLegaleBrute_execution", fields: [executionId, sourceCode, fichierId], references: [id, sourceCode, fichierId], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@unique([executionId, ligneNumero])`; `@@index([executionId, sourceCode, fichierId])`; `@@unique([id, executionId])`.

### SireneEtablissementBrut — `raw.sirene_etablissement`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `executionId` | `execution_id` | `BigInt`  |
| `sourceCode` | `source_code` | `String`  |
| `fichierId` | `fichier_id` | `BigInt`  |
| `ligneNumero` | `ligne_numero` | `BigInt`  |
| `contenu` | `contenu` | `Json` @db.JsonB |
| `cle` | `cle` | `String?`  |
| `statut` | `statut` | `StatutLigne` @default(en_attente) |
| `motifRejet` | `motif_rejet` | `String?`  |
| `dateRejet` | `date_rejet` | `DateTime?` @db.Timestamptz(6) |
| `dateIntegration` | `date_integration` | `DateTime?` @db.Timestamptz(6) |

Relations (cible et colonnes) :

- `execution ExecutionImport @relation("SireneEtablissementBrut_execution", fields: [executionId, sourceCode, fichierId], references: [id, sourceCode, fichierId], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@unique([executionId, ligneNumero])`; `@@index([executionId, sourceCode, fichierId])`.

### CorrespondanceIdentifiants — `stg.correspondance_identifiants`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `idRna` | `id_rna` | `String?` @unique @db.VarChar(10) |
| `idEx` | `id_ex` | `String?` @unique @db.VarChar(14) |
| `idSiren` | `id_siren` | `String?` @unique @db.VarChar(9) |
| `origine` | `origine` | `String` @default("delta_rna") |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("CorrespondanceIdentifiants_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`.

### UniteLegaleAApparier — `stg.unite_legale_a_apparier`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `siren` | `siren` | `String` @id @db.VarChar(9) |
| `identifiantAssociationRna` | `identifiant_association_rna` | `String?` @db.VarChar(10) |
| `idRnaRapproche` | `id_rna_rapproche` | `String?` @db.VarChar(10) |
| `statutAppariement` | `statut_appariement` | `StatutAppariement` @default(en_attente_de_traitement) |
| `dateAppariement` | `date_appariement` | `DateTime?` @db.Timestamptz(6) |
| `dernierIdLigne` | `dernier_id_ligne` | `BigInt?`  |
| `derniereExecutionId` | `derniere_execution_id` | `BigInt?`  |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("UniteLegaleAApparier_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`
- `derniereLigne SireneUniteLegaleBrute? @relation("UniteLegaleAApparier_derniereLigne", fields: [dernierIdLigne, derniereExecutionId], references: [id, executionId], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`; `@@index([dernierIdLigne, derniereExecutionId])`; `@@index([identifiantAssociationRna])`.

### Association — `ref.association`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `idRna` | `id_rna` | `String?` @unique @db.VarChar(10) |
| `idSiren` | `id_siren` | `String?` @unique @db.VarChar(9) |
| `idEx` | `id_ex` | `String?` @unique @db.VarChar(14) |
| `retireLe` | `retire_le` | `DateTime?` @db.Timestamptz(6) |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |

### AssociationVersion — `ref.association_version`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `associationId` | `association_id` | `BigInt`  |
| `idRna` | `id_rna` | `String?` @db.VarChar(10) |
| `idSiren` | `id_siren` | `String?` @db.VarChar(9) |
| `idEx` | `id_ex` | `String?` @db.VarChar(14) |
| `nom` | `nom` | `String?` @db.VarChar(250) |
| `sigle` | `sigle` | `String?` @db.VarChar(50) |
| `objetSocial1` | `objet_social1` | `String?` @db.VarChar(6) |
| `objetSocial2` | `objet_social2` | `String?` @db.VarChar(6) |
| `rupMi` | `rup_mi` | `String?` @db.VarChar(15) |
| `nomSirene` | `nom_sirene` | `String?` @db.VarChar(250) |
| `statutAssociationSirene` | `statut_association_sirene` | `String?` @db.VarChar(1) |
| `activitePrincipaleSirene` | `activite_principale_sirene` | `String?` @db.VarChar(6) |
| `categorieJuridiqueUniteLegale` | `categorie_juridique_unite_legale` | `String?` @db.VarChar(4) |
| `objet` | `objet` | `String?`  |
| `nature` | `nature` | `String?` @db.Char(1) |
| `groupement` | `groupement` | `String?` @db.Char(1) |
| `caractereEmployeurSirene` | `caractere_employeur_sirene` | `String?`  |
| `dateCreationAssociation` | `date_creation_association` | `DateTime?` @db.Date |
| `datePublicationJo` | `date_publication_jo` | `DateTime?` @db.Date |
| `dateDissolution` | `date_dissolution` | `DateTime?` @db.Date |
| `dateCreationAssociationSirene` | `date_creation_association_sirene` | `DateTime?` @db.Date |
| `statutAssociationRna` | `statut_association_rna` | `Boolean?`  |
| `ess` | `ess` | `Boolean?`  |
| `societeMission` | `societe_mission` | `Boolean?`  |
| `dateDerniereMajSource` | `date_derniere_maj_source` | `DateTime?` @db.Timestamp(6) |
| `dateDernierTraitementSirene` | `date_dernier_traitement_sirene` | `DateTime?` @db.Timestamp(6) |
| `debutValidite` | `debut_validite` | `DateTime` @db.Timestamptz(6) |
| `finValidite` | `fin_validite` | `DateTime?` @db.Timestamptz(6) |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceRnaCode` | `source_rna_code` | `String?`  |
| `executionRnaId` | `execution_rna_id` | `BigInt?`  |
| `sourceSireneCode` | `source_sirene_code` | `String?`  |
| `executionSireneId` | `execution_sirene_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `association Association @relation("AssociationVersion_association", fields: [associationId], references: [id], onDelete: Restrict, onUpdate: Restrict)`
- `executionRna ExecutionImport? @relation("AssociationVersion_executionRna", fields: [executionRnaId, sourceRnaCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`
- `executionSirene ExecutionImport? @relation("AssociationVersion_executionSirene", fields: [executionSireneId, sourceSireneCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([associationId, debutValidite])`; `@@index([idRna])`; `@@index([idSiren])`; `@@index([idEx])`; `@@index([executionRnaId, sourceRnaCode])`; `@@index([executionSireneId, sourceSireneCode])`.

### ObjetSocial — `ref.objet_social`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id @db.VarChar(6) |
| `libelle` | `libelle` | `String?`  |
| `codeParent` | `code_parent` | `String?` @db.VarChar(6) |
| `niveau` | `niveau` | `Int?` @db.SmallInt |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("ObjetSocial_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`
- `parent ObjetSocial? @relation("ObjetSocial_parent", fields: [codeParent], references: [code], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`; `@@index([codeParent])`.

### CategorieJuridique — `ref.categorie_juridique`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id @db.VarChar(4) |
| `libelle` | `libelle` | `String?`  |
| `niveau2` | `niveau2` | `String?` @db.VarChar(2) |
| `estPerimetre` | `est_perimetre` | `Boolean` @default(false) |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("CategorieJuridique_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`.

### TypeVoie — `ref.type_voie`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id @db.VarChar(20) |
| `libelle` | `libelle` | `String?`  |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("TypeVoie_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`.

### Pays — `ref.pays`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id @db.VarChar(5) |
| `libelle` | `libelle` | `String?`  |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("Pays_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`.

### Region — `ref.region`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id @db.VarChar(2) |
| `libelle` | `libelle` | `String?`  |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("Region_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`.

### Departement — `ref.departement`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id @db.VarChar(3) |
| `libelle` | `libelle` | `String?`  |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |
| `codeRegion` | `code_region` | `String?` @db.VarChar(2) |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("Departement_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`
- `region Region? @relation("Departement_region", fields: [codeRegion], references: [code], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`; `@@index([codeRegion])`.

### Commune — `ref.commune`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `code` | `code` | `String` @id @db.VarChar(5) |
| `libelle` | `libelle` | `String?`  |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |
| `codeDepartement` | `code_departement` | `String?` @db.VarChar(3) |
| `typeCom` | `type_com` | `String?` @db.VarChar(4) |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("Commune_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`
- `departement Departement? @relation("Commune_departement", fields: [codeDepartement], references: [code], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`; `@@index([codeDepartement])`.

### AssociationAdresse — `ref.association_adresse`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `associationId` | `association_id` | `BigInt`  |
| `typeAdresse` | `type_adresse` | `TypeAdresse`  |
| `complement` | `complement` | `String?`  |
| `numeroVoie` | `numero_voie` | `String?`  |
| `libelleVoie` | `libelle_voie` | `String?`  |
| `distribution` | `distribution` | `String?`  |
| `libelleCommune` | `libelle_commune` | `String?`  |
| `libellePays` | `libelle_pays` | `String?`  |
| `codeInseeSource` | `code_insee_source` | `String?`  |
| `codePaysSource` | `code_pays_source` | `String?`  |
| `codeTypeVoieSource` | `code_type_voie_source` | `String?`  |
| `indiceRepetition` | `indice_repetition` | `String?` @db.VarChar(2) |
| `codeTypeVoie` | `code_type_voie` | `String?` @db.VarChar(20) |
| `codePostal` | `code_postal` | `String?` @db.VarChar(5) |
| `codeInsee` | `code_insee` | `String?` @db.VarChar(5) |
| `cedex` | `cedex` | `String?` @db.VarChar(5) |
| `codePays` | `code_pays` | `String?` @db.VarChar(5) |
| `debutValidite` | `debut_validite` | `DateTime` @db.Timestamptz(6) |
| `finValidite` | `fin_validite` | `DateTime?` @db.Timestamptz(6) |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `association Association @relation("AssociationAdresse_association", fields: [associationId], references: [id], onDelete: Restrict, onUpdate: Restrict)`
- `typeVoie TypeVoie? @relation("AssociationAdresse_typeVoie", fields: [codeTypeVoie], references: [code], onDelete: Restrict, onUpdate: Restrict)`
- `commune Commune? @relation("AssociationAdresse_commune", fields: [codeInsee], references: [code], onDelete: Restrict, onUpdate: Restrict)`
- `pays Pays? @relation("AssociationAdresse_pays", fields: [codePays], references: [code], onDelete: Restrict, onUpdate: Restrict)`
- `execution ExecutionImport? @relation("AssociationAdresse_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([associationId, debutValidite])`; `@@index([codeTypeVoie])`; `@@index([codeInsee])`; `@@index([codePays])`; `@@index([executionId, sourceCode])`.

### Etablissement — `ref.etablissement`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `associationId` | `association_id` | `BigInt`  |
| `siret` | `siret` | `String` @db.VarChar(14) |
| `estSiege` | `est_siege` | `Boolean?`  |
| `nic` | `nic` | `String?` @db.VarChar(5) |
| `etatAdministratif` | `etat_administratif` | `String?`  |
| `dateCreationEtablissement` | `date_creation_etablissement` | `DateTime?` @db.Date |
| `dateDebutPeriode` | `date_debut_periode` | `DateTime?` @db.Date |
| `activitePrincipale` | `activite_principale` | `String?` @db.VarChar(6) |
| `nomenclatureActivite` | `nomenclature_activite` | `String?`  |
| `caractereEmployeur` | `caractere_employeur` | `String?`  |
| `trancheEffectifs` | `tranche_effectifs` | `String?` @db.VarChar(2) |
| `anneeEffectifs` | `annee_effectifs` | `Int?` @db.SmallInt |
| `denominationUsuelle` | `denomination_usuelle` | `String?` @db.VarChar(100) |
| `enseigne1` | `enseigne1` | `String?` @db.VarChar(50) |
| `enseigne2` | `enseigne2` | `String?` @db.VarChar(50) |
| `enseigne3` | `enseigne3` | `String?` @db.VarChar(50) |
| `complement` | `complement` | `String?`  |
| `numeroVoie` | `numero_voie` | `String?`  |
| `libelleVoie` | `libelle_voie` | `String?`  |
| `distribution` | `distribution` | `String?`  |
| `libelleCommune` | `libelle_commune` | `String?`  |
| `libellePays` | `libelle_pays` | `String?`  |
| `codeInseeSource` | `code_insee_source` | `String?`  |
| `codePaysSource` | `code_pays_source` | `String?`  |
| `codeTypeVoieSource` | `code_type_voie_source` | `String?`  |
| `indiceRepetition` | `indice_repetition` | `String?` @db.VarChar(2) |
| `codeTypeVoie` | `code_type_voie` | `String?` @db.VarChar(20) |
| `codePostal` | `code_postal` | `String?` @db.VarChar(5) |
| `codeInsee` | `code_insee` | `String?` @db.VarChar(5) |
| `cedex` | `cedex` | `String?` @db.VarChar(5) |
| `codePays` | `code_pays` | `String?` @db.VarChar(5) |
| `coordonneeLambertX` | `coordonnee_lambert_x` | `Decimal?` @db.Decimal(12,3) |
| `coordonneeLambertY` | `coordonnee_lambert_y` | `Decimal?` @db.Decimal(12,3) |
| `debutValidite` | `debut_validite` | `DateTime` @db.Timestamptz(6) |
| `finValidite` | `fin_validite` | `DateTime?` @db.Timestamptz(6) |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `association Association @relation("Etablissement_association", fields: [associationId], references: [id], onDelete: Restrict, onUpdate: Restrict)`
- `typeVoie TypeVoie? @relation("Etablissement_typeVoie", fields: [codeTypeVoie], references: [code], onDelete: Restrict, onUpdate: Restrict)`
- `commune Commune? @relation("Etablissement_commune", fields: [codeInsee], references: [code], onDelete: Restrict, onUpdate: Restrict)`
- `pays Pays? @relation("Etablissement_pays", fields: [codePays], references: [code], onDelete: Restrict, onUpdate: Restrict)`
- `execution ExecutionImport? @relation("Etablissement_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([associationId])`; `@@index([siret, debutValidite])`; `@@index([codeTypeVoie])`; `@@index([codeInsee])`; `@@index([codePays])`; `@@index([executionId, sourceCode])`.

### Coordonnee — `ref.coordonnee`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `type` | `type` | `TypeCoordonnee`  |
| `valeurBrute` | `valeur_brute` | `String?`  |
| `valeurNormalisee` | `valeur_normalisee` | `String`  |
| `valide` | `valide` | `Boolean?`  |
| `dateVerif` | `date_verif` | `DateTime?` @db.Date |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("Coordonnee_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@unique([type, valeurNormalisee])`; `@@index([executionId, sourceCode])`.

### EntiteCoordonnee — `ref.entite_coordonnee`

| Champ Prisma | Colonne SQL | Type / nullabilité / défaut / clé |
| --- | --- | --- |
| `id` | `id` | `BigInt` @id @default(autoincrement()) |
| `coordonneeId` | `coordonnee_id` | `BigInt`  |
| `associationId` | `association_id` | `BigInt?`  |
| `etablissementId` | `etablissement_id` | `BigInt?`  |
| `estPrincipal` | `est_principal` | `Boolean?`  |
| `communication` | `communication` | `Boolean?`  |
| `debutValidite` | `debut_validite` | `DateTime` @db.Timestamptz(6) |
| `finValidite` | `fin_validite` | `DateTime?` @db.Timestamptz(6) |
| `insereLe` | `insere_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `modifieLe` | `modifie_le` | `DateTime` @default(now()) @db.Timestamptz(6) |
| `sourceCode` | `source_code` | `String?`  |
| `executionId` | `execution_id` | `BigInt?`  |

Relations (cible et colonnes) :

- `execution ExecutionImport? @relation("EntiteCoordonnee_execution", fields: [executionId, sourceCode], references: [id, sourceCode], onDelete: Restrict, onUpdate: Restrict)`
- `coordonnee Coordonnee @relation("EntiteCoordonnee_coordonnee", fields: [coordonneeId], references: [id], onDelete: Restrict, onUpdate: Restrict)`
- `association Association? @relation("EntiteCoordonnee_association", fields: [associationId], references: [id], onDelete: Restrict, onUpdate: Restrict)`
- `etablissement Etablissement? @relation("EntiteCoordonnee_etablissement", fields: [etablissementId], references: [id], onDelete: Restrict, onUpdate: Restrict)`

Clés et index Prisma : `@@index([executionId, sourceCode])`; `@@index([coordonneeId])`; `@@index([associationId])`; `@@index([etablissementId])`.

## Valeurs de statuts

- `StatutExecution` : `en_cours`, `reussie`, `echec`.
- `StatutLigne` : `en_attente`, `integre`, `rejete`.
- `ModeChargement` : `full`, `delta`.
- `StatutAppariement` : `en_attente_de_traitement`, `echec_du_rapprochement`, `rapprochement_a_valider`, `valider_par_utilisateur`.
- `TypeAdresse` : `siege_rna`, `gestion`.
- `TypeCoordonnee` : `email`, `telephone`, `site_web`.
