schema-relationnel-et-tables-donnees.md 11 KB

Schéma relationnel simplifié et tables de données

Application : dirCops
Projet : Suivi facturation / échéancier / paiement (EMGI)
Date : 2026-02-09
Référence physique : app/sql/schema.sql


1. Schéma relationnel simplifié

Représentation des tables et des relations (clés primaires et étrangères). Les cardinalités sont indiquées (1:N, 0:1).

                    ┌──────────────────────────┐
                    │        clients           │
                    ├──────────────────────────┤
                    │ id (PK)                  │
                    │ nom                      │
                    │ created_at              │
                    └────────────┬─────────────┘
                                 │ 1
                                 │
                                 │ N
                    ┌────────────▼─────────────┐
                    │       factures           │
                    ├──────────────────────────┤
                    │ id (PK)                  │
                    │ client_id (FK → clients) │
                    │ n_facture, n_vente       │
                    │ date_facture             │
                    │ type_produit, cycle      │
                    │ quantites, qte_livree    │
                    │ montant_ht               │
                    │ created_at               │
                    └────┬──────────────┬──────┘
                         │ 1            │ 1
              ┌──────────┘              └──────────┐
              │ N                                   │ 0..1
              ▼                                     ▼
┌─────────────────────────┐           ┌─────────────────────────┐
│      paiements           │           │      echeanciers       │
├─────────────────────────┤           ├─────────────────────────┤
│ id (PK)                  │           │ id (PK)                 │
│ facture_id (FK→factures) │           │ facture_id (FK→factures)│
│ montant                  │           │ nb_echeances            │
│ date_paiement            │           │ date_debut_echeancier  │
│ created_at               │           │ montant_par_echeance   │
└─────────────────────────┘           │ created_at             │
                                      └─────────────────────────┘

Relations :

  • clients 1 —— N factures (un client a plusieurs factures ; une facture appartient à un client).
  • factures 1 —— N paiements (une facture a plusieurs paiements ; un paiement est rattaché à une facture).
  • factures 1 —— 0..1 echeanciers (une facture a au plus un écheancier ; un écheancier est rattaché à une facture).

Contraintes :

  • Suppression en cascade : suppression d’un client → suppression de ses factures, puis de leurs paiements et écheanciers. Suppression d’une facture → suppression de ses paiements et de son écheancier.

2. Tables – Détail des champs

Format : pour chaque table, description courte puis pour chaque colonne : Nom, Type, Description, Clé.


Table clients

Table des clients (sociétés ou entités facturées). Une facture est toujours liée à un client.

Nom Type Description Clé
id int UNSIGNED Identifiant unique auto incrémenté Primaire
nom varchar(255) Nom du client (raison sociale ou libellé)
created_at datetime Date et heure de création de l’enregistrement

Table factures

Table des factures pour le suivi. La facturation (document, PDF) est gérée dans Pennylane ; ici on enregistre les données de suivi (n° facture, montant, type produit, cycle, quantités, etc.).

Nom Type Description Clé
id int UNSIGNED Identifiant unique auto incrémenté Primaire
client_id int UNSIGNED Référence du client concerné Étrangère (→ clients.id), NOT NULL
n_facture varchar(64) Numéro de facture (ex. FA-001) NOT NULL
n_vente varchar(64) Numéro de vente ou référence vente (optionnel)
date_facture date Date de la facture NOT NULL
type_produit varchar(32) Type de produit : alevins, larves (ou NULL)
cycle varchar(16) Cycle de référence (ex. 24-25, 25-26)
quantites decimal(12,2) Quantité facturée
qte_livree decimal(12,2) Quantité déjà livrée
montant_ht decimal(12,2) Montant HT de la facture (€) NOT NULL
created_at datetime Date et heure de création de l’enregistrement dans l’appli

Index : client_id, type_produit, cycle.


Table paiements

Table des paiements enregistrés pour une facture. L’encours d’une facture est calculé comme (montant_ht − somme des montants des paiements de cette facture).

Nom Type Description Clé
id int UNSIGNED Identifiant unique auto incrémenté Primaire
facture_id int UNSIGNED Référence de la facture concernée Étrangère (→ factures.id), NOT NULL
montant decimal(12,2) Montant du paiement (€) NOT NULL
date_paiement date Date du paiement NOT NULL
created_at datetime Date et heure de création de l’enregistrement

Index : facture_id, date_paiement (idx_paiements_date).

Contraintes de validation : CHECK (montant > 0).


Table echeanciers

Table des écheanciers de paiement associés à une facture. Une facture peut avoir au plus un écheancier. Les dates d’échéance sont dérivées à l’affichage : date_debut_echeancier + 0 mois, +1 mois, +2 mois, etc. (échéances mensuelles). Le champ montant_par_echeance est calculé à la création (encours / nb_echeances) et stocké.

Nom Type Description Clé
id int UNSIGNED Identifiant unique auto incrémenté Primaire
facture_id int UNSIGNED Référence de la facture concernée Étrangère (→ factures.id), NOT NULL, UNIQUE
nb_echeances int UNSIGNED Nombre d’échéances prévues NOT NULL
date_debut_echeancier date Date de début de l’écheancier (1ère échéance) NOT NULL
montant_par_echeance decimal(12,2) Montant par échéance (calculé à la création : encours / nb_echeances) NOT NULL
created_at datetime Date et heure de création de l’enregistrement

Index : facture_id (UNIQUE pour garantir un écheancier par facture).

Contraintes de validation : CHECK (nb_echeances > 0), CHECK (montant_par_echeance > 0).


3. Résumé des clés et contraintes

Table Clé primaire Clés étrangères Contrainte cascade
clients id — —
factures id client_id → clients ON DELETE CASCADE (client supprimé)
paiements id facture_id → factures ON DELETE CASCADE (facture supprimée)
echeanciers id facture_id → factures ON DELETE CASCADE (facture supprimée)

3.1 Contraintes de validation (CHECK)

Table Contrainte Description
paiements chk_paiements_montant montant > 0
echeanciers chk_echeanciers_nb_echeances nb_echeances > 0
echeanciers chk_echeanciers_montant montant_par_echeance > 0

3.2 Index (référence app/sql/schema.sql)

Table Index Colonne(s)
factures idx_factures_client_id client_id
factures idx_factures_type_produit type_produit
factures idx_factures_cycle cycle
paiements idx_paiements_facture_id facture_id
paiements idx_paiements_date date_paiement
echeanciers uk_echeanciers_facture_id (UNIQUE) facture_id
echeanciers idx_echeanciers_facture_id facture_id

Note : Les statuts « payé » / « en attente » ne sont pas stockés ; ils sont calculés (encours facture = montant_ht − somme des paiements ; si encours ≤ 0 alors payé, sinon en attente).