Aller au contenu
BioTrace

app.prime

Description

Section intitulée « Description »

Prime d’une ligne de contrat : bio, équitable ou qualité, en montant par unité de prix ou en taux sur le prix de base. Un type par ligne.

Columns

Section intitulée « Columns »
Name Type Default Nullable Children Parents Comment
id uuid app.uuid_v7() false Identifiant stable (UUID v7).
organisation_id uuid false app.organisation app.contrat app.contrat_ligne Organisation propriétaire. Sert à l’isolation par RLS (EC-032).
contrat_ligne_id uuid false app.contrat_ligne Ligne de contrat concernée (de la même organisation).
type text false bio, equitable ou qualite.
mode text false montant (par unité de prix de la ligne, en devise) ou taux (centièmes de point du prix de base).
montant_unite_mineure bigint true Montant par unité de prix, en unités mineures. Renseigné si et seulement si le mode est montant.
devise text true app.contrat_ligne Devise du montant, égale à celle de la ligne (clé composée). Renseignée si et seulement si le mode est montant : aucun montant sans devise.
taux_cp integer true Taux en centièmes de point du prix de base. Renseigné si et seulement si le mode est taux.
cree_le timestamp with time zone now() false Date de création de la ligne.
modifie_le timestamp with time zone now() false Date de dernière modification.
contrat_id uuid false app.contrat Contrat de la ligne, repris d’elle par la base (jamais une autre valeur). Dénormalisé pour que les règles de synchronisation filtrent les primes d’un contrat sans jointure (protocole §7.3).

Constraints

Section intitulée « Constraints »
Name Type Definition
prime_check CHECK CHECK (((mode = ‘montant’::text) = ((montant_unite_mineure IS NOT NULL) AND (devise IS NOT NULL))))
prime_check1 CHECK CHECK (((mode = ‘taux’::text) = ((taux_cp IS NOT NULL) AND (montant_unite_mineure IS NULL) AND (devise IS NULL))))
prime_mode_check CHECK CHECK ((mode = ANY (ARRAY[‘montant’::text, ‘taux’::text])))
prime_montant_unite_mineure_check CHECK CHECK ((montant_unite_mineure >= 0))
prime_taux_cp_check CHECK CHECK (((taux_cp >= 0) AND (taux_cp <= 10000)))
prime_type_check CHECK CHECK ((type = ANY (ARRAY[‘bio’::text, ‘equitable’::text, ‘qualite’::text])))
prime_organisation_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)
prime_organisation_id_contrat_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id, contrat_id) REFERENCES app.contrat(organisation_id, id)
prime_organisation_id_contrat_ligne_id_fkey FOREIGN KEY FOREIGN KEY (organisation_id, contrat_ligne_id) REFERENCES app.contrat_ligne(organisation_id, id)
prime_organisation_id_contrat_ligne_id_devise_fkey FOREIGN KEY FOREIGN KEY (organisation_id, contrat_ligne_id, devise) REFERENCES app.contrat_ligne(organisation_id, id, devise)
prime_pkey PRIMARY KEY PRIMARY KEY (id)
prime_organisation_id_contrat_ligne_id_type_key UNIQUE UNIQUE (organisation_id, contrat_ligne_id, type)

Indexes

Section intitulée « Indexes »
Name Definition
prime_pkey CREATE UNIQUE INDEX prime_pkey ON app.prime USING btree (id)
prime_organisation_id_contrat_ligne_id_type_key CREATE UNIQUE INDEX prime_organisation_id_contrat_ligne_id_type_key ON app.prime USING btree (organisation_id, contrat_ligne_id, type)
prime_contrat_idx CREATE INDEX prime_contrat_idx ON app.prime USING btree (organisation_id, contrat_id)

Triggers

Section intitulée « Triggers »
Name Definition
journal CREATE TRIGGER journal AFTER INSERT OR DELETE OR UPDATE ON app.prime FOR EACH ROW EXECUTE FUNCTION journal.tg_journaliser()
modifie_le CREATE TRIGGER modifie_le BEFORE UPDATE ON app.prime FOR EACH ROW EXECUTE FUNCTION app.tg_modifie_le()
fige CREATE TRIGGER fige BEFORE INSERT OR UPDATE ON app.prime FOR EACH ROW EXECUTE FUNCTION app.tg_contrat_fige()
contrat_denormalise CREATE TRIGGER contrat_denormalise BEFORE INSERT OR UPDATE OF contrat_ligne_id, contrat_id ON app.prime FOR EACH ROW EXECUTE FUNCTION app.tg_prime_contrat()

Relations

Section intitulée « Relations »
erDiagram

"app.prime" }o--|| "app.organisation" : "FOREIGN KEY (organisation_id) REFERENCES app.organisation(id)"
"app.prime" }o--|| "app.contrat" : "FOREIGN KEY (organisation_id, contrat_id) REFERENCES app.contrat(organisation_id, id)"
"app.prime" }o--|| "app.contrat_ligne" : "FOREIGN KEY (organisation_id, contrat_ligne_id) REFERENCES app.contrat_ligne(organisation_id, id)"
"app.prime" }o--|| "app.contrat_ligne" : "FOREIGN KEY (organisation_id, contrat_ligne_id, devise) REFERENCES app.contrat_ligne(organisation_id, id, devise)"

"app.prime" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire. Sert à l'isolation par RLS (EC-032)."
  uuid contrat_ligne_id FK "Ligne de contrat concernée (de la même organisation)."
  text type "`bio`, `equitable` ou `qualite`."
  text mode "`montant` (par unité de prix de la ligne, en devise) ou `taux` (centièmes de point du prix de base)."
  bigint montant_unite_mineure "Montant par unité de prix, en unités mineures. Renseigné si et seulement si le mode est `montant`."
  text devise FK "Devise du montant, égale à celle de la ligne (clé composée). Renseignée si et seulement si le mode est `montant` : aucun montant sans devise."
  integer taux_cp "Taux en centièmes de point du prix de base. Renseigné si et seulement si le mode est `taux`."
  timestamp_with_time_zone cree_le "Date de création de la ligne."
  timestamp_with_time_zone modifie_le "Date de dernière modification."
  uuid contrat_id FK "Contrat de la ligne, repris d'elle par la base (jamais une autre valeur). Dénormalisé pour que les règles de synchronisation filtrent les primes d'un contrat sans jointure (protocole §7.3)."
}
"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.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.contrat_ligne" {
  uuid id "Identifiant stable (UUID v7)."
  uuid organisation_id FK "Organisation propriétaire. Sert à l'isolation par RLS (EC-032)."
  uuid contrat_id FK "Contrat de la ligne (de la même organisation)."
  uuid produit_id FK "Produit de la ligne (de la même organisation), unique dans le contrat."
  bigint quantite_engagee_g "Quantité engagée en grammes (EC-030), strictement positive."
  bigint prix_unite_mineure "Prix de base en unités mineures de la devise, par unité de prix (par exemple 150 XOF le kilo). Jamais sans devise."
  text devise FK "Devise du prix, code ISO 4217 connu de app.devise (EC-028)."
  text unite_prix FK "Unité du prix (`g`, `kg`, `t`) : le prix vaut par cette unité. Le stock reste en grammes (EC-030)."
  integer tolerance_cp "Tolérance sur la quantité engagée, en centièmes de point. L'alerte de solde au-delà est calculée au Lot 2."
  jsonb formule_refaction "Formule de réfaction en JSON (aucune, excedent_lineaire, lineaire_simple, bilan_de_masse), forme validée par FormuleRefaction (Ajv) ; le mode d'arrondi en fait partie (EC-051). Lue par calculerPesee à la réception."
  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