Aller au contenu
BioTrace

app.expedition

Description

Section intitulée « Description »

Expédition : mouvement physique d’une vente (analyse critique, « Vente et Expédition »). Sa validation débite les lots expédiés (I1). Figée à l’enregistrement, seule la décision change.

Columns

Section intitulée « Columns »
Name Type Default Nullable Children Parents Comment
id uuid app.uuid_v7() false app.expedition_ligne Identifiant de l’expédition (UUID v7).
organisation_id uuid false app.expedition_ligne app.organisation app.utilisateur app.mouvement app.vehicule app.pv_nettoyage_vehicule app.vente Organisation propriétaire (isolation par ligne).
vente_id uuid false app.vente Vente validée qui donne lieu à l’expédition ; une vente en a une ou plusieurs.
vehicule_id uuid false app.vehicule app.pv_nettoyage_vehicule Véhicule qui charge la matière.
pv_nettoyage_id uuid false app.pv_nettoyage_vehicule PV de nettoyage du véhicule avant chargement ; il doit être valable à la date de l’expédition.
date_operation timestamp with time zone false Date de l’expédition : c’est elle qui sert à apprécier les certificats de la chaîne (AV1-03).
conteneur text true Numéro du conteneur ; vide hors transport conteneurisé.
scelles text[] ‘{}’::text[] false Numéros des scellés posés.
destination text false Destination de l’expédition.
coi_reference text true Référence du certificat d’inspection (COI) ; facultative, donnée seulement tant qu’aucun module documents n’existe.
nop_import_certificate text true Référence du NOP Import Certificate ; facultative.
eudr_reference text true Référence de la déclaration EUDR ; facultative.
statut text ‘brouillon’::text false Statut : brouillon, validee ou annulee. Ne revient jamais en arrière.
mouvement_id uuid true app.mouvement Mouvement de matière (nature expedition) écrit à la validation : débit des lots, crédit du compte technique d’expédition. Vide hors expédition validée.
decide_par uuid true app.utilisateur Utilisateur qui a validé ou annulé l’expédition.
decide_le timestamp with time zone true Date de la décision.
cree_par uuid false app.utilisateur Utilisateur qui a saisi l’expédition.
cree_le timestamp with time zone now() false Date de saisie de l’expédition.
modifie_le timestamp with time zone now() false Date de la dernière modification de l’expédition.

Constraints

Section intitulée « Constraints »
Name Type Definition
expedition_check CHECK CHECK (((statut = ‘validee’::text) = (mouvement_id IS NOT NULL)))
expedition_check1 CHECK CHECK (((statut = ‘brouillon’::text) = ((decide_par IS NULL) AND (decide_le IS NULL))))
expedition_coi_reference_check CHECK CHECK ((btrim(coi_reference) <> ‘’::text))
expedition_conteneur_check CHECK CHECK ((btrim(conteneur) <> ‘’::text))
expedition_destination_check CHECK CHECK ((btrim(destination) <> ‘’::text))
expedition_eudr_reference_check CHECK CHECK ((btrim(eudr_reference) <> ‘’::text))
expedition_nop_import_certificate_check CHECK CHECK ((btrim(nop_import_certificate) <> ‘’::text))
expedition_statut_check CHECK CHECK ((statut = ANY (ARRAY[‘brouillon’::text, ‘validee’::text, ‘annulee’::text])))
expedition_organisation_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)
expedition_organisation_id_cree_par_fkey FOREIGN KEY FOREIGN KEY (organisation_id, cree_par) REFERENCES app.utilisateur(organisation_id, id)
expedition_organisation_id_decide_par_fkey FOREIGN KEY FOREIGN KEY (organisation_id, decide_par) REFERENCES app.utilisateur(organisation_id, id)
expedition_organisation_id_mouvement_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id, mouvement_id) REFERENCES app.mouvement(organisation_id, id)
expedition_organisation_id_vehicule_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id, vehicule_id) REFERENCES app.vehicule(organisation_id, id)
expedition_organisation_id_pv_nettoyage_id_vehicule_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id, pv_nettoyage_id, vehicule_id) REFERENCES app.pv_nettoyage_vehicule(organisation_id, id, vehicule_id)
expedition_organisation_id_vente_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id, vente_id) REFERENCES app.vente(organisation_id, id)
expedition_pkey PRIMARY KEY PRIMARY KEY (id)
expedition_organisation_id_id_key UNIQUE UNIQUE (organisation_id, id)
expedition_mouvement_id_key UNIQUE UNIQUE (mouvement_id)

Indexes

Section intitulée « Indexes »
Name Definition
expedition_pkey CREATE UNIQUE INDEX expedition_pkey ON app.expedition USING btree (id)
expedition_organisation_id_id_key CREATE UNIQUE INDEX expedition_organisation_id_id_key ON app.expedition USING btree (organisation_id, id)
expedition_mouvement_id_key CREATE UNIQUE INDEX expedition_mouvement_id_key ON app.expedition USING btree (mouvement_id)
expedition_vente_idx CREATE INDEX expedition_vente_idx ON app.expedition USING btree (organisation_id, vente_id, statut)

Triggers

Section intitulée « Triggers »
Name Definition
journal CREATE TRIGGER journal AFTER INSERT OR DELETE OR UPDATE ON app.expedition FOR EACH ROW EXECUTE FUNCTION journal.tg_journaliser()
modifie_le CREATE TRIGGER modifie_le BEFORE UPDATE ON app.expedition FOR EACH ROW EXECUTE FUNCTION app.tg_modifie_le()
expedition_controle CREATE TRIGGER expedition_controle BEFORE INSERT OR UPDATE ON app.expedition FOR EACH ROW EXECUTE FUNCTION app.tg_expedition_controle()

Relations

Section intitulée « Relations »
erDiagram

"app.expedition_ligne" }o--|| "app.expedition" : "FOREIGN KEY (organisation_id, expedition_id) REFERENCES app.expedition(organisation_id, id)"
"app.expedition" }o--|| "app.organisation" : "FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)"
"app.expedition" }o--|| "app.utilisateur" : "FOREIGN KEY (organisation_id, cree_par) REFERENCES app.utilisateur(organisation_id, id)"
"app.expedition" }o--|| "app.utilisateur" : "FOREIGN KEY (organisation_id, decide_par) REFERENCES app.utilisateur(organisation_id, id)"
"app.expedition" }o--|| "app.mouvement" : "FOREIGN KEY (organisation_id, mouvement_id) REFERENCES app.mouvement(organisation_id, id)"
"app.expedition" }o--|| "app.vehicule" : "FOREIGN KEY (organisation_id, vehicule_id) REFERENCES app.vehicule(organisation_id, id)"
"app.expedition" }o--|| "app.pv_nettoyage_vehicule" : "FOREIGN KEY (organisation_id, pv_nettoyage_id, vehicule_id) REFERENCES app.pv_nettoyage_vehicule(organisation_id, id, vehicule_id)"
"app.expedition" }o--|| "app.vente" : "FOREIGN KEY (organisation_id, vente_id) REFERENCES app.vente(organisation_id, id)"

"app.expedition" {
  uuid id "Identifiant de l'expédition (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  uuid vente_id FK "Vente validée qui donne lieu à l'expédition ; une vente en a une ou plusieurs."
  uuid vehicule_id FK "Véhicule qui charge la matière."
  uuid pv_nettoyage_id FK "PV de nettoyage du véhicule avant chargement ; il doit être valable à la date de l'expédition."
  timestamp_with_time_zone date_operation "Date de l'expédition : c'est elle qui sert à apprécier les certificats de la chaîne (AV1-03)."
  text conteneur "Numéro du conteneur ; vide hors transport conteneurisé."
  text__ scelles "Numéros des scellés posés."
  text destination "Destination de l'expédition."
  text coi_reference "Référence du certificat d'inspection (COI) ; facultative, donnée seulement tant qu'aucun module documents n'existe."
  text nop_import_certificate "Référence du NOP Import Certificate ; facultative."
  text eudr_reference "Référence de la déclaration EUDR ; facultative."
  text statut "Statut : brouillon, validee ou annulee. Ne revient jamais en arrière."
  uuid mouvement_id FK "Mouvement de matière (nature expedition) écrit à la validation : débit des lots, crédit du compte technique d'expédition. Vide hors expédition validée."
  uuid decide_par FK "Utilisateur qui a validé ou annulé l'expédition."
  timestamp_with_time_zone decide_le "Date de la décision."
  uuid cree_par FK "Utilisateur qui a saisi l'expédition."
  timestamp_with_time_zone cree_le "Date de saisie de l'expédition."
  timestamp_with_time_zone modifie_le "Date de la dernière modification de l'expédition."
}
"app.expedition_ligne" {
  uuid id "Identifiant de la ligne (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  uuid expedition_id FK "Expédition à laquelle la ligne appartient."
  uuid lot_id FK "Lot validé prélevé (RG-081) ; un lot ne figure qu'une fois par expédition."
  bigint quantite_g "Quantité prélevée en grammes, strictement positive, jamais supérieure à ce que contient le lot."
  timestamp_with_time_zone cree_le "Date d'enregistrement de la ligne."
}
"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.vehicule" {
  uuid id "Identifiant du véhicule (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  text immatriculation "Immatriculation du véhicule, unique par organisation."
  text type "Type de véhicule (camion, semi-remorque, conteneur routier…), texte libre : aucune liste n'est donnée par les sources."
  text transporteur "Transporteur qui exploite le véhicule ; vide si le véhicule est celui de l'organisation."
  boolean actif "Faux quand le véhicule ne se charge plus ; une expédition refuse un véhicule inactif."
  timestamp_with_time_zone cree_le "Date d'enregistrement du véhicule."
  timestamp_with_time_zone modifie_le "Date de la dernière modification du véhicule."
}
"app.pv_nettoyage_vehicule" {
  uuid id "Identifiant du PV (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  uuid vehicule_id FK "Véhicule nettoyé."
  date date_nettoyage "Date réelle du nettoyage, saisie par le responsable : elle ne dépasse pas la date de l'expédition qui s'en sert."
  text responsable "Nom de la personne qui a nettoyé le véhicule."
  jsonb points_controle "Points de contrôle du PV : liste d'objets { code, libelle, controle }. Un PV n'est valable pour une expédition que si tous les points sont contrôlés."
  uuid signataire_id FK "Utilisateur qui signe le PV."
  timestamp_with_time_zone cree_le "Date d'enregistrement du PV."
}
"app.vente" {
  uuid id "Identifiant de la vente (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire (isolation par ligne)."
  uuid client_id FK "Client acheteur."
  uuid contrat_id FK "Contrat de vente actif du même client, facultatif : vide pour une vente « spot ». Sa tolérance s'ajoute à la quantité engagée."
  uuid produit_id FK "Produit vendu : celui de tous les lots expédiés."
  text referentiel_code FK "Référentiel revendiqué sur la vente (RG-156, AV1-03) ; vide si la vente ne revendique aucun référentiel."
  bigint quantite_engagee_g "Quantité vendue en grammes. Le total expédié ne la dépasse pas, tolérance du contrat comprise."
  bigint prix_unite_mineure "Prix par unité de prix, en unités mineures de la devise."
  text unite_prix FK "Unité à laquelle le prix s'applique (kilogramme, tonne…)."
  text devise FK "Devise du prix."
  date date_operation "Date de la vente."
  text statut "Statut : brouillon, validee, soldee ou annulee. Une vente annulée ne peut plus avoir d'expédition validée."
  uuid valide_par FK "Utilisateur qui a validé la vente ; vide tant qu'elle est en brouillon."
  timestamp_with_time_zone valide_le "Date de validation de la vente."
  uuid cree_par FK "Utilisateur qui a saisi la vente."
  timestamp_with_time_zone cree_le "Date de saisie de la vente."
  timestamp_with_time_zone modifie_le "Date de la dernière modification de la vente."
}

Generated by tbls