app.vente

Description

Vente : engagement commercial envers un client (analyse critique, « Vente et Expédition », RG-080, RG-156). Sans contrat, la vente est « spot ». Figée dès sa validation ; le stock ne bouge qu’à la validation d’une expédition.

Columns

Name	Type	Default	Nullable	Children	Parents	Comment
id	uuid	app.uuid_v7()	false	app.expedition		Identifiant de la vente (UUID v7).
organisation_id	uuid		false	app.expedition	app.organisation app.utilisateur app.produit app.client app.contrat	Organisation propriétaire (isolation par ligne).
client_id	uuid		false		app.client	Client acheteur.
contrat_id	uuid		true		app.contrat	Contrat de vente actif du même client, facultatif : vide pour une vente « spot ». Sa tolérance s’ajoute à la quantité engagée.
produit_id	uuid		false		app.produit	Produit vendu : celui de tous les lots expédiés.
referentiel_code	text		true		app.referentiel	Référentiel revendiqué sur la vente (RG-156, AV1-03) ; vide si la vente ne revendique aucun référentiel.
quantite_engagee_g	bigint		false			Quantité vendue en grammes. Le total expédié ne la dépasse pas, tolérance du contrat comprise.
prix_unite_mineure	bigint		false			Prix par unité de prix, en unités mineures de la devise.
unite_prix	text		false		app.unite	Unité à laquelle le prix s’applique (kilogramme, tonne…).
devise	text		false		app.devise	Devise du prix.
date_operation	date		false			Date de la vente.
statut	text	‘brouillon’::text	false			Statut : brouillon, validee, soldee ou annulee. Une vente annulée ne peut plus avoir d’expédition validée.
valide_par	uuid		true		app.utilisateur	Utilisateur qui a validé la vente ; vide tant qu’elle est en brouillon.
valide_le	timestamp with time zone		true			Date de validation de la vente.
cree_par	uuid		false		app.utilisateur	Utilisateur qui a saisi la vente.
cree_le	timestamp with time zone	now()	false			Date de saisie de la vente.
modifie_le	timestamp with time zone	now()	false			Date de la dernière modification de la vente.

Constraints

Name	Type	Definition
vente_check	CHECK	CHECK (((valide_par IS NULL) = (valide_le IS NULL)))
vente_check1	CHECK	CHECK (((statut = ANY (ARRAY[‘validee’::text, ‘soldee’::text])) <= (valide_par IS NOT NULL)))
vente_prix_unite_mineure_check	CHECK	CHECK ((prix_unite_mineure >= 0))
vente_quantite_engagee_g_check	CHECK	CHECK ((quantite_engagee_g > 0))
vente_statut_check	CHECK	CHECK ((statut = ANY (ARRAY[‘brouillon’::text, ‘validee’::text, ‘soldee’::text, ‘annulee’::text])))
vente_organisation_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)
vente_organisation_id_cree_par_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, cree_par) REFERENCES app.utilisateur(organisation_id, id)
vente_organisation_id_valide_par_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, valide_par) REFERENCES app.utilisateur(organisation_id, id)
vente_unite_prix_fkey	FOREIGN KEY	FOREIGN KEY (unite_prix) REFERENCES app.unite(code)
vente_organisation_id_produit_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, produit_id) REFERENCES app.produit(organisation_id, id)
vente_organisation_id_client_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, client_id) REFERENCES app.client(organisation_id, id)
vente_devise_fkey	FOREIGN KEY	FOREIGN KEY (devise) REFERENCES app.devise(code)
vente_organisation_id_contrat_id_fkey	FOREIGN KEY	FOREIGN KEY (organisation_id, contrat_id) REFERENCES app.contrat(organisation_id, id)
vente_referentiel_code_fkey	FOREIGN KEY	FOREIGN KEY (referentiel_code) REFERENCES app.referentiel(code)
vente_pkey	PRIMARY KEY	PRIMARY KEY (id)
vente_organisation_id_id_key	UNIQUE	UNIQUE (organisation_id, id)

Indexes

Name	Definition
vente_pkey	CREATE UNIQUE INDEX vente_pkey ON app.vente USING btree (id)
vente_organisation_id_id_key	CREATE UNIQUE INDEX vente_organisation_id_id_key ON app.vente USING btree (organisation_id, id)
vente_client_idx	CREATE INDEX vente_client_idx ON app.vente USING btree (organisation_id, client_id, statut)

Triggers

Name	Definition
journal	CREATE TRIGGER journal AFTER INSERT OR DELETE OR UPDATE ON app.vente FOR EACH ROW EXECUTE FUNCTION journal.tg_journaliser()
modifie_le	CREATE TRIGGER modifie_le BEFORE UPDATE ON app.vente FOR EACH ROW EXECUTE FUNCTION app.tg_modifie_le()
vente_controle	CREATE TRIGGER vente_controle BEFORE INSERT OR UPDATE ON app.vente FOR EACH ROW EXECUTE FUNCTION app.tg_vente_controle()

Relations

erDiagram

"app.expedition" }o--|| "app.vente" : "FOREIGN KEY (organisation_id, vente_id) REFERENCES app.vente(organisation_id, id)"
"app.vente" }o--|| "app.organisation" : "FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)"
"app.vente" }o--|| "app.utilisateur" : "FOREIGN KEY (organisation_id, cree_par) REFERENCES app.utilisateur(organisation_id, id)"
"app.vente" }o--|| "app.utilisateur" : "FOREIGN KEY (organisation_id, valide_par) REFERENCES app.utilisateur(organisation_id, id)"
"app.vente" }o--|| "app.produit" : "FOREIGN KEY (organisation_id, produit_id) REFERENCES app.produit(organisation_id, id)"
"app.vente" }o--|| "app.client" : "FOREIGN KEY (organisation_id, client_id) REFERENCES app.client(organisation_id, id)"
"app.vente" }o--|| "app.contrat" : "FOREIGN KEY (organisation_id, contrat_id) REFERENCES app.contrat(organisation_id, id)"
"app.vente" }o--o| "app.referentiel" : "FOREIGN KEY (referentiel_code) REFERENCES app.referentiel(code)"
"app.vente" }o--|| "app.unite" : "FOREIGN KEY (unite_prix) REFERENCES app.unite(code)"
"app.vente" }o--|| "app.devise" : "FOREIGN KEY (devise) REFERENCES app.devise(code)"

"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."
}
"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.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.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.client" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire. Sert à l'isolation par RLS (EC-032)."
  text code "Code du client, unique par organisation."
  text nom "Nom du client."
  text pays "Pays, code ISO 3166-1 alpha-2."
  text adresse_livraison "Adresse de livraison habituelle."
  text contact "Personne à contacter."
  text telephone "Téléphone du client."
  text email "Adresse électronique du client."
  text incoterm_habituel "Incoterm 2020 habituel du client (EXW, FCA, CPT, CIP, DAP, DPU, DDP, FAS, FOB, CFR, CIF)."
  text devise "Devise de facturation, code ISO 4217 (EC-028)."
  text conditions_reglement "Conditions de règlement habituelles, en texte."
  boolean actif "Faux quand le client n'est plus utilisé. Un client 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.contrat" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire. Sert à l'isolation par RLS (EC-032)."
  text code "Code du contrat, unique par organisation."
  text type "`achat` (producteur, groupement ou fournisseur), `vente` (client) ou `prestation` (client ou fournisseur, EC-052)."
  uuid producteur_id FK "Contrepartie producteur (achat). Exactement une contrepartie entre producteur, groupement, fournisseur et client."
  uuid groupement_id FK "Contrepartie groupement (achat)."
  uuid fournisseur_id FK "Contrepartie fournisseur (achat ou prestation)."
  uuid client_id FK "Contrepartie client (vente ou prestation)."
  uuid campagne_id FK "Campagne du contrat (de la même organisation)."
  date date_debut "Premier jour de la période du contrat."
  date date_fin "Dernier jour de la période du contrat. Jamais avant le début."
  text statut "`brouillon`, `actif`, `solde` ou `resilie`. Pas de retour en arrière ; l'activation exige une ligne."
  text conditions_paiement "Conditions de paiement, en texte, facultatives."
  uuid fichier_id FK "Pièce jointe du contrat (fichier de la même organisation), facultative."
  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.referentiel" {
  uuid id "Identifiant stable (UUID v7)."
  text code "Code du référentiel (UE, NOP, CCPB…), valeur du facteur `referentiel`."
  text nature "Nature : norme publique, organisme de certification, standard privé ; vide tant que le pack n'est pas publié."
  text libelle_fr "Libellé en français."
  text libelle_en "Libellé en anglais."
  uuid pack_id FK "Pack référentiel qui porte les états, les grilles et les tables de décision ; vide tant qu'aucun pack n'est publié."
  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.unite" {
  uuid id "Identifiant stable (UUID v7)."
  text code "Code de l'unité : g, kg, t."
  text libelle_fr "Libellé en français."
  text libelle_en "Libellé en anglais."
  bigint grammes_par_unite "Nombre de grammes dans une unité (entier) : kg 1 000, t 1 000 000."
}
"app.devise" {
  uuid id "Identifiant stable (UUID v7)."
  text code "Code ISO 4217 en majuscules (XOF, EUR, USD), cible des clés étrangères de montants."
  text libelle_fr "Libellé en français."
  text libelle_en "Libellé en anglais."
  smallint decimales "Nombre de décimales de la devise : l'unité mineure vaut 10^-décimales unité majeure (EUR 2, XOF 0)."
}

---

Generated by tbls