docs

modules/purchase_trade/AGENTS.md

@@ -41,6 +41,10 @@ de negoce physique:
 
 - Regles metier:
   - `modules/purchase_trade/docs/business-rules.md`
+- Documentation business publiee dans le wiki:
+  - `modules/purchase_trade/docs/business/*.md`
+- Sources de verite de la documentation business generee:
+  - `modules/purchase_trade/docs_source/business/*.md`
 - Regles templates:
   - `modules/purchase_trade/docs/template-rules.md`
 - Catalogue des proprietes templates:
@@ -179,6 +183,23 @@ de negoce physique:
 
 ## 5) Conventions de modification
 
+### Documentation business
+
+- Ne pas modifier directement une page generee sous
+  `modules/purchase_trade/docs/business/` si elle contient le commentaire
+  `Generated from docs_source/business`.
+- Toute regle business nouvelle ou modifiee doit etre editee dans
+  `modules/purchase_trade/docs_source/business/`.
+- Apres modification des sources business, regenerer le wiki avec:
+  `python modules/purchase_trade/docs/tools/render_business_docs.py`
+- Avant de rendre une modification documentaire, verifier que le rendu publie
+  est synchronise avec:
+  `python modules/purchase_trade/docs/tools/render_business_docs.py --check`
+- Les pages francaises et anglaises miroir doivent rester synchronisees.
+- Le rendu publie doit rester lisible dans MkDocs meme sans extensions
+  optionnelles: eviter les marqueurs bruts `!!!` et `:material-...:` dans les
+  fichiers publies.
+
 1. Modifier la logique metier dans le fichier pivot le plus proche.
 2. Si un template `.fodt` devient complexe, deplacer la logique dans une
    propriete Python `report_*`.