app.preuve

Description

Pièce justificative : lien entre un fichier déposé, un point de contrôle et, facultativement, l’objet et l’évaluation qu’elle appuie. En ajout seul : une pièce n’est jamais détachée, le fichier lui-même est figé.

Columns

Name	Type	Default	Nullable	Parents	Comment
id	uuid	app.uuid_v7()	false		Identifiant stable (UUID v7).
organisation_id	uuid		false	app.organisation app.utilisateur app.fichier app.evaluation_point	Organisation propriétaire. Sert à l’isolation par RLS (EC-032).
fichier_id	uuid		false	app.fichier	Fichier déposé (de la même organisation).
point_controle_id	uuid		false	app.point_controle	Point de contrôle que la pièce appuie.
objet_type	text		true		Type de l’objet appuyé. Vide : toute l’organisation.
objet_id	uuid		true		Identifiant de l’objet appuyé. Renseigné avec `objet_type`, ou pas du tout.
evaluation_point_id	uuid		true	app.evaluation_point	Évaluation que la pièce a motivée, si elle a été liée à ce moment.
depose_par	uuid		false	app.utilisateur	Utilisateur qui a lié la pièce.
cree_le	timestamp with time zone	clock_timestamp()	false		Date de liaison.

Constraints

Name	Type	Definition
preuve_check	CHECK	CHECK (((objet_type IS NULL) = (objet_id IS NULL)))
preuve_objet_type_check	CHECK	CHECK ((objet_type ~ ‘^[a-z][a-z0-9_]*$’::text))
preuve_organisation_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)
preuve_organisation_id_depose_par_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, depose_par) REFERENCES app.utilisateur(organisation_id, id)
preuve_organisation_id_fichier_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, fichier_id) REFERENCES app.fichier(organisation_id, id)
preuve_point_controle_id_fkey	FOREIGN KEY	FOREIGN KEY (point_controle_id) REFERENCES app.point_controle(id)
preuve_organisation_id_evaluation_point_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, evaluation_point_id) REFERENCES app.evaluation_point(organisation_id, id)
preuve_pkey	PRIMARY KEY	PRIMARY KEY (id)
preuve_organisation_id_id_key	UNIQUE	UNIQUE (organisation_id, id)

Indexes

Name	Definition
preuve_pkey	CREATE UNIQUE INDEX preuve_pkey ON app.preuve USING btree (id)
preuve_organisation_id_id_key	CREATE UNIQUE INDEX preuve_organisation_id_id_key ON app.preuve USING btree (organisation_id, id)
preuve_point_idx	CREATE INDEX preuve_point_idx ON app.preuve USING btree (organisation_id, point_controle_id)

Triggers

Name	Definition
journal	CREATE TRIGGER journal AFTER INSERT OR DELETE OR UPDATE ON app.preuve FOR EACH ROW EXECUTE FUNCTION journal.tg_journaliser()
ajout_seul	CREATE TRIGGER ajout_seul BEFORE DELETE OR UPDATE ON app.preuve FOR EACH ROW EXECUTE FUNCTION app.tg_ajout_seul()

Relations

erDiagram

"app.preuve" }o--|| "app.organisation" : "FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)"
"app.preuve" }o--|| "app.utilisateur" : "FOREIGN KEY (organisation_id, depose_par) REFERENCES app.utilisateur(organisation_id, id)"
"app.preuve" }o--|| "app.fichier" : "FOREIGN KEY (organisation_id, fichier_id) REFERENCES app.fichier(organisation_id, id)"
"app.preuve" }o--|| "app.evaluation_point" : "FOREIGN KEY (organisation_id, evaluation_point_id) REFERENCES app.evaluation_point(organisation_id, id)"
"app.preuve" }o--|| "app.point_controle" : "FOREIGN KEY (point_controle_id) REFERENCES app.point_controle(id)"

"app.preuve" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire. Sert à l'isolation par RLS (EC-032)."
  uuid fichier_id FK "Fichier déposé (de la même organisation)."
  uuid point_controle_id FK "Point de contrôle que la pièce appuie."
  text objet_type "Type de l'objet appuyé. Vide : toute l'organisation."
  uuid objet_id "Identifiant de l'objet appuyé. Renseigné avec `objet_type`, ou pas du tout."
  uuid evaluation_point_id FK "Évaluation que la pièce a motivée, si elle a été liée à ce moment."
  uuid depose_par FK "Utilisateur qui a lié la pièce."
  timestamp_with_time_zone cree_le "Date de liaison."
}
"app.organisation" {
  uuid id "Identifiant de l'organisation (UUID v7)."
  text code "Code court en majuscules. Immuable : il figure dans les identifiants Keycloak (coopa.agent01). « EXT » est réservé."
  text nom "Nom de l'organisation."
  text pays "Pays, code ISO 3166-1 alpha-2."
  text langue "Langue de l'organisation : fr ou en."
  text fuseau_horaire "Fuseau horaire IANA utilisé pour l'affichage des dates."
  text devise_defaut "Devise par défaut des montants, code ISO 4217."
  text keycloak_organisation_id "Identifiant de l'organisation dans Keycloak."
  text organisme_certificateur "Organisme de certification de l'organisation. Aucun contrôle de format (EC-027)."
  text code_operateur "Code d'opérateur attribué par l'organisme certificateur."
  uuid logo_fichier_id FK "Fichier du logo (EC-029)."
  timestamp_with_time_zone cree_le "Date de création de la ligne."
  timestamp_with_time_zone modifie_le "Date de la dernière modification, tenue par un déclencheur."
  text source_conformite "Source des décisions de conformité : `interne` (contrôle interne de BioTrace) ou `externe` (outil tiers). Une seule source active à la fois ; app.statut_conformite.source doit lui être égale."
  text statut "État du compte client : `active` ou `suspendue`. Une organisation suspendue est refusée par la garde d'authentification (`organisation_suspendue`) ; ses données et ses comptes sont conservés. Décidé par l'équipe de l'éditeur (EC-126)."
  timestamp_with_time_zone suspendue_le "Date de la suspension en cours ; nulle tant que l'organisation est active."
}
"app.utilisateur" {
  uuid id "Identifiant de l'utilisateur (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire de la ligne. Sert à l'isolation par RLS (EC-032) et au filtrage de la synchronisation."
  uuid keycloak_sub "Identifiant du compte Keycloak (revendication sub). Identique d'une organisation à l'autre pour un compte externe."
  text identifiant "Identifiant local de connexion, sans le code de l'organisation : 3 à 32 caractères parmi a-z, 0-9, _ et -. Unique dans l'organisation."
  text nom_affiche "Nom affiché dans l'application."
  text telephone "Numéro de téléphone. Attribut du compte, jamais son identifiant."
  text statut "Statut du compte : actif, suspendu ou desactive."
  timestamp_with_time_zone cree_le "Date de création de la ligne."
  timestamp_with_time_zone modifie_le "Date de la dernière modification, tenue par un déclencheur."
}
"app.fichier" {
  uuid id "Identifiant du fichier (UUID v7, généré sur l'appareil ou par l'API)."
  uuid organisation_id FK "Organisation propriétaire de la ligne. Sert à l'isolation par RLS (EC-032) et au filtrage de la synchronisation."
  text cle_objet "Clé de l'objet dans le stockage."
  text type_mime "Type MIME du contenu."
  bigint taille_octets "Taille en octets."
  text sha256 "Empreinte SHA-256 du contenu, en hexadécimal."
  text statut "Statut : attendu, recu ou empreinte_invalide. Un fichier reçu n'est plus modifiable."
  uuid appareil_id FK "Appareil d'origine du dépôt."
  uuid depose_par FK "Utilisateur qui a déposé le fichier."
  timestamp_with_time_zone depose_le "Date de réception du contenu par le stockage."
  timestamp_with_time_zone cree_le "Date de création de la ligne."
  timestamp_with_time_zone modifie_le "Date de la dernière modification, tenue par un déclencheur."
}
"app.evaluation_point" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire. Sert à l'isolation par RLS (EC-032)."
  uuid point_controle_id FK "Point évalué."
  text objet_type "Type de l'objet évalué (lot, site…). Vide : le point est évalué pour toute l'organisation."
  uuid objet_id "Identifiant de l'objet évalué. Renseigné avec `objet_type`, ou pas du tout."
  text statut "`satisfait`, `preuve_manquante`, `ecart_ouvert`, `a_verifier` ou `non_applicable`. Une personne ne déclare jamais « preuve manquante » : il se déduit des pièces."
  text source "`regle` : résultat d'une règle du moteur. `manuelle` : déclaration d'une personne."
  uuid constat_id FK "Constat d'écart ouvert par la règle (AM-15), pour une évaluation issue d'une règle."
  text motif "Justification de la déclaration. Obligatoire pour déclarer un point satisfait ou non applicable."
  uuid evalue_par FK "Utilisateur qui a déclaré. Vide pour un résultat de règle."
  timestamp_with_time_zone evalue_le "Date de l'évaluation."
}
"app.point_controle" {
  uuid id "Identifiant stable (UUID v7)."
  uuid pack_version_id FK "Version du pack référentiel qui publie le point."
  text code "Code du point, unique dans la version du pack (par exemple CER-39)."
  text libelle_fr "Libellé en français."
  text libelle_en "Libellé en anglais."
  text theme "Thème d'affichage du tableau « prêt pour l'audit ». Texte libre fourni par le pack, provisoire (EC-104)."
  text source "Texte, article ou citation courte dont le point est tiré."
  text__ activites "Activités du catalogue `app.activite` auxquelles le point s'applique. Vide : toutes les activités. Le point est « non applicable » si l'organisation n'en exerce aucune."
  text objet "Ce sur quoi porte le point : opération, lot, site, organisation…"
  text preuve_attendue "Type de pièce attendue, en texte. Vide : le point n'exige aucune pièce. Sans pièce liée, un point autrement satisfait est « preuve manquante »."
  text echeance "Échéance ou fréquence, en texte. Stockée, non évaluée avant un besoin avéré (EC-104)."
  text mode "`automatique` : une règle du moteur le juge. `manuel` : une personne le coche, avec pièce."
  text regle_code FK "Ligne de décision de la même version de pack qui juge le point. Obligatoire si le mode est automatique, interdit sinon."
  text module_code FK "Module dont dépend le point. Vide : noyau. Si le module est inactif, le point est « non applicable »."
  date date_effet "Premier jour où le point s'applique (AM-11)."
  date date_fin "Premier jour où le point ne s'applique plus. La date de fin est exclue."
  text date_reference "Date à laquelle le point se juge : opération, récolte, création du lot ou émission du certificat (AM-11)."
  timestamp_with_time_zone cree_le "Date de publication du point."
}

Generated by tbls