app.sortie_etape

Description

Sortie typée d’une étape : produit principal, coproduit, sous-produit (chacun un lot), rebut (avec sa destination) ou perte (avec son motif), en ajout seul (AM-12, RG-055).

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.mouvement app.produit app.lot app.etape_realisee	Organisation propriétaire (isolation par ligne).
etape_realisee_id	uuid		false	app.etape_realisee	Étape qui produit la sortie ; elle doit être en cours ou réalisée, pas encore validée.
nature	text		false		produit_principal (au plus un par étape), coproduit, sous_produit, rebut ou perte.
produit_id	uuid		false	app.produit	Produit de la sortie.
quantite_g	bigint		false		Quantité en grammes, strictement positive.
lot_id	uuid		true	app.lot	Lot créé par un mouvement de l’étape, pour la même quantité ; vide pour un rebut ou une perte, qui ne deviennent jamais un lot.
destination	text		true		Destination du rebut (obligatoire pour un rebut).
motif	text		true		Motif de la perte déclarée (obligatoire pour une perte).
cree_par	uuid		false	app.utilisateur	Utilisateur qui a déclaré la sortie.
cree_le	timestamp with time zone	now()	false		Date de la déclaration.
reintegre_flux_bio	boolean	false	false		Vrai si l’opérateur déclare que ce rebut réintègre un flux biologique (EC-120) ; réservé à la nature rebut. Lu par la variable etape.rebut_reintegre_flux_bio des normes.
mouvement_id	uuid		true	app.mouvement	Mouvement de transformation qui a produit la sortie. Une sortie dont le mouvement est contre-passé (étape dévalidée) ne compte plus dans le bilan ; vide pour les sorties antérieures à L2-6 sans mouvement retrouvé.

Constraints

Name	Type	Definition
sortie_etape_check	CHECK	CHECK (((nature = ANY (ARRAY[‘produit_principal’::text, ‘coproduit’::text, ‘sous_produit’::text])) = (lot_id IS NOT NULL)))
sortie_etape_check1	CHECK	CHECK (((nature <> ‘rebut’::text) OR (destination IS NOT NULL)))
sortie_etape_check2	CHECK	CHECK (((nature <> ‘perte’::text) OR (motif IS NOT NULL)))
sortie_etape_destination_check	CHECK	CHECK ((btrim(destination) <> ‘’::text))
sortie_etape_motif_check	CHECK	CHECK ((btrim(motif) <> ‘’::text))
sortie_etape_nature_check	CHECK	CHECK ((nature = ANY (ARRAY[‘produit_principal’::text, ‘coproduit’::text, ‘sous_produit’::text, ‘rebut’::text, ‘perte’::text])))
sortie_etape_quantite_g_check	CHECK	CHECK ((quantite_g > 0))
sortie_etape_reintegration_rebut	CHECK	CHECK (((NOT reintegre_flux_bio) OR (nature = ‘rebut’::text)))
sortie_etape_organisation_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)
sortie_etape_organisation_id_cree_par_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, cree_par) REFERENCES app.utilisateur(organisation_id, id)
sortie_etape_organisation_id_mouvement_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, mouvement_id) REFERENCES app.mouvement(organisation_id, id)
sortie_etape_organisation_id_produit_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, produit_id) REFERENCES app.produit(organisation_id, id)
sortie_etape_organisation_id_lot_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, lot_id) REFERENCES app.lot(organisation_id, id)
sortie_etape_organisation_id_etape_realisee_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, etape_realisee_id) REFERENCES app.etape_realisee(organisation_id, id)
sortie_etape_pkey	PRIMARY KEY	PRIMARY KEY (id)
sortie_etape_organisation_id_id_key	UNIQUE	UNIQUE (organisation_id, id)
sortie_etape_lot_id_key	UNIQUE	UNIQUE (lot_id)

Indexes

Name	Definition
sortie_etape_pkey	CREATE UNIQUE INDEX sortie_etape_pkey ON app.sortie_etape USING btree (id)
sortie_etape_organisation_id_id_key	CREATE UNIQUE INDEX sortie_etape_organisation_id_id_key ON app.sortie_etape USING btree (organisation_id, id)
sortie_etape_lot_id_key	CREATE UNIQUE INDEX sortie_etape_lot_id_key ON app.sortie_etape USING btree (lot_id)
sortie_etape_une_principale	CREATE UNIQUE INDEX sortie_etape_une_principale ON app.sortie_etape USING btree (etape_realisee_id, COALESCE(mouvement_id, ‘00000000-0000-0000-0000-000000000000’::uuid)) WHERE (nature = ‘produit_principal’::text)

Triggers

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

Relations

erDiagram

"app.sortie_etape" }o--|| "app.organisation" : "FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)"
"app.sortie_etape" }o--|| "app.utilisateur" : "FOREIGN KEY (organisation_id, cree_par) REFERENCES app.utilisateur(organisation_id, id)"
"app.sortie_etape" }o--|| "app.mouvement" : "FOREIGN KEY (organisation_id, mouvement_id) REFERENCES app.mouvement(organisation_id, id)"
"app.sortie_etape" }o--|| "app.produit" : "FOREIGN KEY (organisation_id, produit_id) REFERENCES app.produit(organisation_id, id)"
"app.sortie_etape" }o--|| "app.lot" : "FOREIGN KEY (organisation_id, lot_id) REFERENCES app.lot(organisation_id, id)"
"app.sortie_etape" }o--|| "app.etape_realisee" : "FOREIGN KEY (organisation_id, etape_realisee_id) REFERENCES app.etape_realisee(organisation_id, id)"

"app.sortie_etape" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  uuid etape_realisee_id FK "Étape qui produit la sortie ; elle doit être en cours ou réalisée, pas encore validée."
  text nature "produit_principal (au plus un par étape), coproduit, sous_produit, rebut ou perte."
  uuid produit_id FK "Produit de la sortie."
  bigint quantite_g "Quantité en grammes, strictement positive."
  uuid lot_id FK "Lot créé par un mouvement de l'étape, pour la même quantité ; vide pour un rebut ou une perte, qui ne deviennent jamais un lot."
  text destination "Destination du rebut (obligatoire pour un rebut)."
  text motif "Motif de la perte déclarée (obligatoire pour une perte)."
  uuid cree_par FK "Utilisateur qui a déclaré la sortie."
  timestamp_with_time_zone cree_le "Date de la déclaration."
  boolean reintegre_flux_bio "Vrai si l'opérateur déclare que ce rebut réintègre un flux biologique (EC-120) ; réservé à la nature rebut. Lu par la variable etape.rebut_reintegre_flux_bio des normes."
  uuid mouvement_id FK "Mouvement de transformation qui a produit la sortie. Une sortie dont le mouvement est contre-passé (étape dévalidée) ne compte plus dans le bilan ; vide pour les sorties antérieures à L2-6 sans mouvement retrouvé."
}
"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.mouvement" {
  uuid id "Identifiant du mouvement (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."
  text nature "Nature : reception, transfert, transformation, expedition, perte, inventaire ou contrepassation."
  timestamp_with_time_zone date_operation "Date de l'opération sur le terrain ou à la balance."
  uuid contrepasse_mouvement_id FK "Mouvement annulé par cette contre-passation. Un mouvement n'est contre-passé qu'une fois."
  text motif "Motif, obligatoire pour une contre-passation."
  uuid commande_id "Commande de synchronisation à l'origine du mouvement."
  uuid cree_par FK "Utilisateur auteur du mouvement."
  timestamp_with_time_zone cree_le "Date de création de la ligne."
  uuid etape_realisee_id FK "Étape réalisée à laquelle se rattache un mouvement de transformation (AM-12) ; obligatoire pour ce type de mouvement, vide pour les autres."
}
"app.produit" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire. Sert à l'isolation par RLS (EC-032)."
  text code "Code du produit, inséré dans le numéro officiel (segment « produit »). Unique par organisation (EC-063)."
  text nom_fr "Nom en français."
  text nom_en "Nom en anglais."
  text unite_code FK "Unité de saisie et d'affichage."
  boolean est_matiere_premiere "Vrai pour une matière première, faux pour un produit fini."
  uuid matiere_premiere_liee_id FK "Matière première dont le produit fini est issu. Réservé aux produits finis, de la même organisation."
  text code_modele "Code du modèle de produit du pack qui a servi à créer la ligne. Nul pour un produit créé à la main."
  uuid pack_version_id FK "Version de pack d'origine. Nulle pour un produit créé à la main ; nulle exactement quand code_modele l'est."
  boolean actif "Faux quand le produit n'est plus utilisé. Un produit n'est jamais supprimé."
  timestamp_with_time_zone cree_le "Date de création de la ligne."
  timestamp_with_time_zone modifie_le "Date de dernière modification."
}
"app.lot" {
  uuid id "Identifiant du lot (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  uuid campagne_id FK "Campagne du lot."
  text reference_provisoire "Référence provisoire, tant que le lot n'est pas validé (BR-AAAA-MM-JJ-NNNN dans le cahier)."
  bigint numero "Rang du numéro officiel, pris par app.attribuer_numero à la validation, jamais réutilisé (I3). Vide avant la validation."
  text nature "Nature de la séquence de numérotation : MP matière première, REC réception, NET nettoyé, PF produit fini (EC-068)."
  uuid produit_id FK "Produit du lot."
  text qualite "Catégorie d'affichage du lot (EC-090) : saisie à la réception, calculée par le mélange (la plus basse catégorie des entrées et des états du résultat, EC-120). La qualité par référentiel est dans app.lot_qualite."
  text statut "Statut : brouillon, en_attente, valide, rejete, annule, consomme, quarantaine, archive. Transitions contrôlées par app.tg_lot_controle."
  uuid compte_matiere_id FK "Compte de matière du lot (nature lot) : son solde est la quantité du lot."
  uuid mouvement_creation_id FK "Mouvement qui crée le lot (I4) : il crédite le compte du lot et n'est pas une contre-passation."
  timestamp_with_time_zone date_operation "Date de l'opération qui crée le lot, saisie sur le terrain."
  text motif_annulation "Motif de l'annulation ; renseigné si et seulement si le statut est annule."
  uuid annule_par FK "Utilisateur qui a annulé le lot."
  timestamp_with_time_zone date_annulation "Date de l'annulation."
  uuid cree_par FK "Utilisateur qui a créé le lot."
  timestamp_with_time_zone cree_le "Date d'enregistrement du lot."
  timestamp_with_time_zone modifie_le "Date de la dernière modification (statut ou numéro)."
}
"app.etape_realisee" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  uuid ordre_id FK "Ordre de transformation concerné."
  uuid noeud_etape_id FK "Étape du procédé (nœud enfant du procédé). Vide pour la saisie qui couvre tout le procédé en suivi global."
  text statut "a_faire, en_cours, realisee ou validee ; une seule marche à la fois."
  jsonb mesures "Mesures saisies à l'étape (objet JSON) ; modifiables tant que l'étape n'est pas validée."
  timestamp_with_time_zone debut_le "Début de l'étape."
  timestamp_with_time_zone fin_le "Fin de l'étape ; jamais avant le début."
  uuid cree_par FK "Utilisateur qui a ouvert l'étape."
  uuid valide_par FK "Utilisateur qui a validé l'étape ; renseigné si et seulement si elle est validée."
  timestamp_with_time_zone valide_le "Date de validation de l'étape."
  timestamp_with_time_zone cree_le "Date de création de la ligne."
  timestamp_with_time_zone modifie_le "Date de dernière modification."
}

Generated by tbls