01.04.26

modules/purchase_trade/AGENTS.md

@@ -49,6 +49,8 @@ de negoce physique:
 ## 4) Invariants metier a preserver
 
 - Un lot `virtual` est la reference d'ouverture de quantite pour une `purchase.line`.
+- Une `sale.line` doit aussi avoir au minimum un lot `virtual`; une valuation
+  cote sale ne doit donc pas disparaitre juste parce que le lot est `open`.
 - Le lot physique est le pont principal entre:
   - `purchase.line`
   - `sale.line`
@@ -59,6 +61,33 @@ de negoce physique:
   - ne pas multiplier des chemins d'acces concurrents
 - Le `FREIGHT VALUE` d'un template facture vient du `fee.fee` du shipment
   dont le produit est `Maritime freight`.
+- En valuation / PnL:
+  - la valeur stockee dans `type` est la cle technique (`pur. priced`,
+    `sale priced`, `pur. fee`, etc.), pas le label affiche dans l'UI
+  - les references doivent rester coherentes avec le type de lot:
+    `Purchase/Open`, `Purchase/Physic`, `Sale/Open`, `Sale/Physic`
+  - pour une sale matchee, les lignes de valuation purchase generees sur un lot
+    physique doivent aussi renseigner `sale` et `sale_line` afin de remonter
+    dans l'onglet PnL de la sale
+  - une sale non matchee doit etre valorisable "sale-first" et alimenter
+    `valuation.valuation` / `valuation.valuation.line`
+  - si une `sale.line` `basis` n'a ni `price_summary` ni `lot_price_sale`,
+    creer quand meme une ligne `sale priced` avec `price = 0` et `amount = 0`
+    plutot que de ne rien generer
+  - le MTM ne doit etre renseigne que pour `pur. priced`, `sale priced` et
+    `derivative`; jamais pour les fees
+  - `mtm_price` doit afficher le prix brut de valorisation (sans ratio), alors
+    que `mtm` reste le montant calcule selon la logique de strategie
+- En pricing:
+  - le `premium` doit impacter le prix total et donc le `amount`, aussi bien
+    en `priced` qu'en `basis`
+  - si `linked currency` est active, le `premium` est saisi dans la devise /
+    unite liee (ex: `USC/LB`) puis converti vers le `unit_price` de la ligne
+  - en `basis + linked currency`, le `linked_price` doit representer le prix
+    basis brut (hors premium) dans la devise liee; le `unit_price` final
+    ajoute ensuite le premium converti
+  - en valuation `basis`, le premium s'applique a chaque composant, pas
+    uniquement a une ligne de resume
 
 ## 5) Conventions de modification
 
@@ -83,6 +112,13 @@ de negoce physique:
 - Pour les donnees achat/vente partagees, ne pas supposer qu'une facture de
   vente doit lire directement sur la `sale.line`: souvent, la verite metier
   passe par le lot physique et/ou la `account.invoice.line`.
+- Dans les ecrans PnL, le label `Sale price` correspond au type stocke
+  `sale priced`; idem pour `Pur. price` / `pur. priced`.
+- Une ligne `basis` sans resume de pricing peut sinon disparaitre de la
+  valuation si aucun fallback explicite a `0` n'est prevu.
+- Le calcul du prix peut diverger entre `unit_price`, `linked_price`,
+  `lot_price` et valuation si le premium n'est pas traite explicitement dans
+  chaque maillon.
 
 ## 7) Definition of done (module `purchase_trade`)