📝 update technical documentation

1 files changed, 33 insertions, 6 deletions

diff --git a/docs/fr/source/annexe-tech-3-variables-gen.rst b/docs/fr/source/annexe-tech-3-variables-gen.rst
index d379bb70b..eb8022b6f 100644
--- a/docs/fr/source/annexe-tech-3-variables-gen.rst
+++ b/docs/fr/source/annexe-tech-3-variables-gen.rst
@@ -7,9 +7,9 @@ Annexe technique 3 - Variables
 ==============================
 
 :Auteurs: Étienne Loks, Ishtar team
-:Date: 2024-08-28
+:Date: 2024-09-21
 :Copyright: CC-BY 3.0
-:Ishtar Version: v4.1.22
+:Ishtar Version: v4.1.29
 
 ----------------------------------
 
@@ -78,6 +78,7 @@ Chaque personne dispose des :ref:`champs adresse <valeurs-champs-adresse>`, ains
 - **cira_rapporteur__** : *→ Opérations (rapporteur ctra/cira)*
 - **comment** : *Texte* - Commentaire
 - **contact_type** : *Chaîne de caractères (300)* - Type de contact
+- **context_record_excavation__** : *→ Unité d'Enregistrement (fouilleur)*
 - **file_responsability__** : *→ Dossiers archéologiques (personne responsable)*
 - **gdpr_person__** : *→ RGPD - Personnes (personne)*
 - **general_contractor_files__** : *→ Dossiers archéologiques (aménageur)*
@@ -97,6 +98,7 @@ Chaque personne dispose des :ref:`champs adresse <valeurs-champs-adresse>`, ains
 - **scientist__** : *→ Dossiers archéologiques (responsable d'opération)*
 - **signatory__** : *→ Actes administratifs (signataire)*
 - **site_collaborator__** : *→ Entités archéologiques (collaborateurs)*
+- **site_discovered__** : *→ Entités archéologiques (inventeur)*
 - **surname** : *Chaîne de caractères (50)* - Prénom - Attention, résidu historique et malheureux dans le code d'une erreur de traduction initiale (surname correspond en anglais au nom de famille, pas au prénom).
 - **title__** : *→ Type de titre* (**label** Dénomination, **txt_idx** Identifiant textuel, **grammatical_gender** Genre grammatical - "M": Masculin ; "F": Féminin ; "N": Neutre, **long_title** Titre long) - Titre 
 - **treatmentfile_applicant__** : *→ Demandes de traitement (demandeur)*
@@ -305,6 +307,7 @@ Commune
 - **main_geodata__** : *→ Géographie - Donnée vectorielle* - Élément géographique principal 
 - **main_image__** : *→ Document* - Image principale 
 - **name** : *Chaîne de caractères (100)* - Nom
+- **notice** : *Texte* - Notice
 - **numero_insee** : *Chaîne de caractères (120)* - Code commune (numéro INSEE)
 - **operations__** : *→ Opérations (communes)*
 - **parcels__** : *→ Parcelles (commune)*
@@ -489,21 +492,29 @@ Chaque site/entité archéologique dispose du champ `data__` ainsi que des champ
 - **complete_identifier** : *Texte* - Identifiant complet
 - **context_records__** : *→ Unité d'Enregistrement (entité archéologique)*
 - **cultural_attributions__** : *→ Type d'attribution culturelle* (**label** Dénomination, **txt_idx** Identifiant textuel) - Attribution culturelle 
+- **current_status__** : *→ Type d'état actuel* (**label** Dénomination, **txt_idx** Identifiant textuel) - État actuel 
 - **custom_index** : *Entier positif* - Custom index
+- **description** : *Texte* - Description
+- **discoverer__** : *→ Personne* - Inventeur 
 - **discovery_area** : *Texte* - Zone de découverte
+- **discovery_status__** : *→ Type d'état de découverte* (**label** Dénomination, **txt_idx** Identifiant textuel) - État à la découverte 
 - **documents__** : *→ Document* - Documents 
 - **drassm_number** : *Chaîne de caractères (100)* - Numéro DRASSM
 - **geodata__** : *→ Géographie - Donnée vectorielle* - Élément géographique 
 - **imports_updated__** : *→ Import - Import* - Mis à jour par les imports 
+- **interpretation_level__** : *→ Type de niveau d'interprétation* (**label** Dénomination, **txt_idx** Identifiant textuel) - Niveau d'interprétation 
 - **locality_cadastral** : *Texte* - Lieu-dit cadastre
 - **locality_ngi** : *Texte* - Lieu-dit IGN
 - **main_geodata__** : *→ Géographie - Donnée vectorielle* - Élément géographique principal 
 - **main_image__** : *→ Document* - Image principale 
 - **name** : *Chaîne de caractères (200)* - Nom
+- **nature_of_site__** : *→ Type de nature de site* (**label** Dénomination, **txt_idx** Identifiant textuel) - Nature du site 
 - **oceanographic_service_localisation** : *Texte* - Localisation SHOM
 - **operations__** : *→ Opérations (entités archéologiques)*
 - **other_reference** : *Texte* - Autre référence
 - **periods__** : *→ Type de période* (**label** Dénomination, **txt_idx** Identifiant textuel) - Périodes 
+- **precise_locality** : *Texte* - Adresse
+- **public_description** : *Texte* - Description publique
 - **qrcode** : *Image (255)* - qrcode
 - **reference** : *Chaîne de caractères (200)* - Référence
 - **remains__** : *→ Type de vestige* (**label** Dénomination, **txt_idx** Identifiant textuel) - Vestiges 
@@ -513,6 +524,7 @@ Chaque site/entité archéologique dispose du champ `data__` ainsi que des champ
 - **spatial_reference_system__** : *→ Géographie - Système de référence spatiale* (**label** Dénomination, **txt_idx** Identifiant textuel, **srid** SRID, **auth_name** Registre) - Système de référence spatiale 
 - **top_operations__** : *→ Opérations (sites pour lesquels cette opération est une opération chapeau)*
 - **towns__** : *→ Commune* (**name** Nom, **numero_insee** Code commune (numéro INSEE), **cached_label** Nom en cache) - Communes 
+- **types__** : *→ Type de site* (**label** Dénomination, **txt_idx** Identifiant textuel) - Types 
 
 Dossier archéologique
 *********************
@@ -531,6 +543,7 @@ Chaque dossier archéologique dispose du champ `data__` ainsi que des champs sui
 - **creation_date** : *Date* - Date de création
 - **custom_index** : *Entier positif* - Custom index
 - **departments__** : *→ Département* - Départements 
+- **development_type__** : *→ Nature de l'aménagement* (**label** Dénomination, **txt_idx** Identifiant textuel) - Nature de l'aménagement 
 - **documents__** : *→ Document* - Documents 
 - **end_date** : *Date* - Date de fin
 - **equipment_costs__** : *→ Besoins en équipements (file)*
@@ -556,6 +569,7 @@ Chaque dossier archéologique dispose du champ `data__` ainsi que des champs sui
 - **main_town__** : *→ Commune* (**name** Nom, **numero_insee** Code commune (numéro INSEE), **cached_label** Nom en cache) - Commune principale 
 - **mh_listing** : *Booléen* - Sur Monument Historique inscrit
 - **mh_register** : *Booléen* - Sur Monument Historique classé
+- **monitoring_justification__** : *→ Type de motivation de la prescription* (**label** Dénomination, **txt_idx** Identifiant textuel) - Motivation de la prescription 
 - **name** : *Texte* - Nom
 - **numeric_reference** : *Entier positif* - Identifiant numérique
 - **operation_type_for_royalties__** : *→ Type d'opération pour les redevances - France* (**label** Dénomination, **txt_idx** Identifiant textuel) - Type d'opération pour la redevance 
@@ -582,8 +596,8 @@ Chaque dossier archéologique dispose du champ `data__` ainsi que des champs sui
 - **scientist__** : *→ Personne* - Responsable d'opération 
 - **start_date** : *Date* - Date de début
 - **study_period** : *Chaîne de caractères (200)* - Période d'étude
-- **total_developed_surface** : *Nombre à virgule* - Surface totale aménagée (m2)
-- **total_surface** : *Nombre à virgule* - Surface totale (m2)
+- **total_developed_surface** : *Nombre à virgule* - Surface totale aménagée (m²)
+- **total_surface** : *Nombre à virgule* - Surface totale (m²)
 - **towns__** : *→ Commune* (**name** Nom, **numero_insee** Code commune (numéro INSEE), **cached_label** Nom en cache) - Communes 
 - **type_of_agreement__** : *→ Type de convention - France* (**label** Dénomination, **txt_idx** Identifiant textuel) - Type de convention 
 - **year** : *Entier positif* - Année
@@ -636,6 +650,7 @@ Chaque unité d'enregistrement dispose du champ `data__` ainsi que des champs su
 - **cached_periods** : *Texte* - Nom en cache des périodes - Généré automatiquement - ne pas éditer
 - **cached_related_context_records** : *Texte* - Nom en cache des unités d'enregistrements liées - Généré automatiquement - ne pas éditer
 - **closing_date** : *Date* - Date de clôture
+- **colors__** : *→ Type de couleur* (**label** Dénomination, **txt_idx** Identifiant textuel) - colors 
 - **comment** : *Texte* - Commentaire général
 - **complete_identifier** : *Texte* - Identifiant complet
 - **context_record_tree_child__** : *→ context record trees (unité d'enregistrement parente)*
@@ -648,20 +663,25 @@ Chaque unité d'enregistrement dispose du champ `data__` ainsi que des champs su
 - **depth** : *Nombre à virgule* - Profondeur (m)
 - **depth_of_appearance** : *Nombre à virgule* - Profondeur d'apparition (m)
 - **description** : *Texte* - Description
+- **details_on_color** : *Texte* - Précisions sur les couleurs
 - **diameter** : *Nombre à virgule* - Diamètre (m)
 - **documentations__** : *→ Type de documentation* (**label** Dénomination, **txt_idx** Identifiant textuel) - documentations 
 - **documents__** : *→ Document* - Documents 
+- **excavated_length** : *Nombre à virgule* - Longueur fouillée (m)
+- **excavated_width** : *Nombre à virgule* - Largeur fouillée (m)
 - **excavation_technics__** : *→ Type de méthode de fouille* (**label** Dénomination, **txt_idx** Identifiant textuel) - Méthodes de fouille 
+- **excavator__** : *→ Personne* - Fouilleur 
 - **external_id** : *Texte* - Identifiant
 - **filling** : *Texte* - Remplissage
 - **geodata__** : *→ Géographie - Donnée vectorielle* - Élément géographique 
 - **identifications__** : *→ Type d'identification* (**label** Dénomination, **txt_idx** Identifiant textuel) - Identification 
 - **imports_updated__** : *→ Import - Import* - Mis à jour par les imports 
+- **inclusions__** : *→ Type d'inclusion* (**label** Dénomination, **txt_idx** Identifiant textuel) - inclusions 
 - **interpretation** : *Texte* - Interprétation
 - **ishtarsiteprofile__** : *→ Profils d'instance Ishtar (unité d'enregistrement pour le bouton d'ajout de mobilier sans contexte)*
 - **label** : *Chaîne de caractères (200)* - Identifiant
 - **left_relations__** : *→ Relations entre Unités d'Enregistrement (right record)*
-- **length** : *Nombre à virgule* - Taille (m)
+- **length** : *Nombre à virgule* - Longueur (m)
 - **location** : *Texte* - Localisation - Une courte description de la localisation de l'Unité d'Enregistrement
 - **main_geodata__** : *→ Géographie - Donnée vectorielle* - Élément géographique principal 
 - **main_image__** : *→ Document* - Image principale 
@@ -674,9 +694,11 @@ Chaque unité d'enregistrement dispose du champ `data__` ainsi que des champs su
 - **relation_image** : *Fichier (100)* - Image des relations (SVG généré) - La taille maximale supportée pour le fichier est de 100 Mo.
 - **right_relations__** : *→ Relations entre Unités d'Enregistrement (left record)*
 - **spatial_reference_system__** : *→ Géographie - Système de référence spatiale* (**label** Dénomination, **txt_idx** Identifiant textuel, **srid** SRID, **auth_name** Registre) - Système de référence spatiale 
-- **surface** : *Nombre à virgule* - Surface (m2)
+- **structures__** : *→ Type de structure* (**label** Dénomination, **txt_idx** Identifiant textuel) - structures 
+- **surface** : *Nombre à virgule* - Surface (m²)
 - **taq** : *Entier positif* - TAQ - « Terminus Ante Quem ». L'Unité d'Enregistrement ne peut avoir été créée après cette date
 - **taq_estimated** : *Entier positif* - TAQ estimé - Estimation d'un « Terminus Ante Quem »
+- **textures__** : *→ Type de texture* (**label** Dénomination, **txt_idx** Identifiant textuel) - textures 
 - **thickness** : *Nombre à virgule* - Épaisseur (m)
 - **town__** : *→ Commune* (**name** Nom, **numero_insee** Code commune (numéro INSEE), **cached_label** Nom en cache) - Commune 
 - **tpq** : *Entier positif* - TPQ - « Terminus Post Quem ». L'Unité d'Enregistrement ne peut avoir été créée avant cette date
@@ -710,6 +732,7 @@ Chaque mobilier d'origine dispose du champ `data__` ainsi que des champs suivant
 - **description** : *Texte* - Description
 - **discovery_date** : *Date* - Date de découverte (exacte ou début)
 - **discovery_date_taq** : *Date* - Date de découverte (fin)
+- **discovery_method__** : *→ Type de méthode de découverte* (**label** Dénomination, **txt_idx** Identifiant textuel) - Méthode de découverte 
 - **excavation_id** : *Texte* - Identifiant  fouille
 - **external_id** : *Texte* - Identifiant
 - **find__** : *→ Mobilier (mobilier d'origine)*
@@ -757,7 +780,9 @@ Chaque élément mobilier dispose du champ `data__` ainsi que des champs suivant
 - **conservatory_comment** : *Texte* - Précisions sur la conservation
 - **conservatory_states__** : *→ Type d'état de conservation* (**label** Dénomination, **txt_idx** Identifiant textuel) - États de conservation 
 - **container__** : *→ Contenant* - Contenant 
+- **container_fisrt_full_location** : *Texte* - Contenant - Localisation complète - Mis à jour tant qu'aucun conditionnement n'ai attaché
 - **container_ref__** : *→ Contenant* - Contenant de référence 
+- **container_ref_fisrt_full_location** : *Texte* - Contenant de référence - Localisation complète - Mis à jour tant qu'aucun conditionnement n'ai attaché
 - **context_record_label** : Dénomination des unités d'enregistrement associées - **Champ non disponible pour les imports**
 - **cultural_attributions__** : *→ Type d'attribution culturelle* (**label** Dénomination, **txt_idx** Identifiant textuel) - Attribution culturelle 
 - **custom_index** : *Entier positif* - Custom index
@@ -775,6 +800,7 @@ Chaque élément mobilier dispose du champ `data__` ainsi que des champs suivant
 - **find_number** : *Entier positif* - Nombre de restes (NR)
 - **finddownstreamtreatments_related__** : *→ find downstream treatmentss (mobilier)*
 - **findnonmodiftreatments_related__** : *→ find non modif treatmentss (mobilier)*
+- **findtreatment__** : *→ Mobilier - Traitements (mobilier)*
 - **findtreatments_related__** : *→ find treatmentss (mobilier)*
 - **findupstreamtreatments_related__** : *→ find upstream treatmentss (mobilier)*
 - **functional_areas__** : *→ Type de domaine fonctionnel* (**label** Dénomination, **txt_idx** Identifiant textuel) - Domaines fonctionnels 
@@ -872,6 +898,7 @@ Chaque traitement dispose du champ `data__` ainsi que des champs suivants :
 - **finddownstreamtreatments__** : *→ find downstream treatments (traitement)*
 - **findnonmodiftreatments__** : *→ find non modif treatments (traitement)*
 - **finds__** : *→ Mobilier (traitements)*
+- **findtreatment__** : *→ Mobilier - Traitements (treatment)*
 - **findtreatments__** : *→ find treatments (traitement)*
 - **findupstreamtreatments__** : *→ find upstream treatments (traitement)*
 - **goal** : *Texte* - But