tradon/modules/purchase_trade/docs/business/README.md

Guide de lecture des règles business

Statut: migration partielle Dernière mise à jour: 2026-05-13

Ce dossier devient la source de lecture thématique pour les règles business du module purchase_trade.

Chaque page doit rester lisible par deux publics:

• les consultants, qui ont besoin d'une règle fonctionnelle stable sans détail de code inutile;
• les développeurs, qui ont besoin des champs, modèles, fichiers et tests concernés pour appliquer la règle sans l'interpréter.

Convention de langues

Chaque page thématique durable doit exister en deux versions maintenues ensemble:

• une page française, rédigée en français correct avec accents, typographie et formulations naturelles pour le wiki consultant;
• une page anglaise miroir, portant le même contenu fonctionnel et technique.

Convention de nommage:

• page française principale: theme.md;
• page anglaise miroir: theme.en.md.

Toute modification d'une règle business, d'un statut, d'un champ technique ou d'un point de vigilance doit être reportée dans les deux pages au même moment. Les deux pages doivent indiquer leur page miroir en en-tête.

Convention de rédaction

Pour chaque règle durable, utiliser autant que possible ce format:

### BR-PT-THEME-001 - Titre court

Statut: active
Source: business-rules.md / note de session / décision projet

#### Règle consultant

Texte fonctionnel, sans nom de champ si ce n'est pas nécessaire.

#### Notes développeur

- Modèles/champs:
- Fichiers:
- Tests:
- Points de vigilance:

Convention de validation

Quand une règle business devient structurante pour l'intégrité des données, elle doit être accompagnée autant que possible de deux garde-fous:

• un check applicatif bloquant dans le code Python, appelé à la fin des flux qui modifient les données concernées;
• un diagnostic SQL en lecture seule pour auditer les bases existantes ou les bases de test.

Les diagnostics SQL du module sont rangés dans business/sql/. Ils ne remplacent pas les règles applicatives: ils servent à retrouver et qualifier les écarts déjà présents dans une base.

Sources pendant la migration

Les anciennes pages ne sont pas supprimées à cette étape. Elles restent des sources de vérification jusqu'à ce que chaque décision soit promue dans une page thématique:

• modules/purchase_trade/docs/business-rules.md
• modules/purchase_trade/docs/fees.md
• modules/purchase_trade/docs/padding-invoice-accounting.md
• modules/purchase_trade/docs/template-rules.md
• modules/purchase_trade/docs/template-properties.md
• notes/business_rules.md
• notes/template_business_rules.md