27.03.26

modules/purchase_trade/docs/business-rules.md

@@ -1,8 +1,8 @@
 # Business Rules - Purchase Trade
 
 Statut: `draft`
-Version: `v0.1`
-Derniere mise a jour: `2026-03-25`
+Version: `v0.2`
+Derniere mise a jour: `2026-03-27`
 Owner metier: `a completer`
 Owner technique: `a completer`
 
@@ -56,6 +56,50 @@ Owner technique: `a completer`
 - Source:
   - `Decision metier documentee dans les commentaires de purchase_trade.purchase.Line.write`
 
+### BR-PT-002 - Le lot physique est le pont metier entre purchase, sale et shipment
+
+- Intent: disposer d'un chemin unique et stable pour retrouver les informations logistiques et de facturation reliees a un contrat d'achat ou de vente.
+- Description:
+  - Le lot physique (`lot_type = physic`) porte simultanement le lien vers:
+    - la `purchase.line` via `lot.line`
+    - la `sale.line` via `lot.sale_line`
+    - le shipment via `lot.lot_shipment_in` / `lot.lot_shipment_internal` / `lot.lot_shipment_out`
+  - Pour toute logique qui doit naviguer entre achat, vente, shipment et facture, il faut privilegier ce lot physique comme source de verite.
+- Resultat attendu:
+  - depuis une facture d'achat:
+    - remonter a la `purchase.line`
+    - puis au lot physique de la ligne
+    - puis au shipment et aux donnees logistiques associees
+  - depuis une facture de vente:
+    - remonter a la `sale.line`
+    - puis au lot physique matchant qui porte aussi la `purchase.line`
+    - puis au shipment et aux donnees logistiques associees
+- Cas d'usage typiques:
+  - recuperer `bl_date`, `bl_number`, `controller`, `from_location`, `to_location`
+  - retrouver une facture provisoire liee au lot
+  - retrouver des fees rattaches au shipment
+- Priorite:
+  - `structurante`
+
+### BR-PT-003 - Le freight amount des templates facture vient du fee de shipment
+
+- Intent: afficher dans les documents facture la vraie valeur de fret maritime rattachee au shipment du lot physique.
+- Description:
+  - Le `FREIGHT VALUE` d'une facture ne doit pas etre pris sur la facture elle-meme.
+  - Il doit etre calcule a partir du `fee.fee` rattache au shipment (`shipment_in`) du lot physique relie a la facture.
+- Regle de navigation:
+  - retrouver le lot physique pertinent depuis la facture
+  - retrouver son shipment
+  - chercher le `fee.fee` avec:
+    - `shipment_in = shipment.id`
+    - `product.name = 'Maritime freight'`
+  - utiliser `fee.get_amount()` comme montant de fret
+- Portee:
+  - s'applique aussi bien aux factures d'achat qu'aux factures de vente
+  - cote vente, la remontee doit passer par le lot physique qui fait le lien entre `purchase.line` et `sale.line`
+- Priorite:
+  - `importante`
+
 ## 4) Exemples concrets
 
 ### Exemple E1 - Augmentation simple