02.04.26

modules/purchase_trade/docs/business-rules.md

@@ -199,12 +199,12 @@ Owner technique: `a completer`
   - Le `premium` d'une `purchase.line` ou `sale.line` doit impacter le prix
     total quelle que soit la `price_type`.
   - Cette regle vaut pour:
-    - le `unit_price`
     - les calculs de `amount`
     - la valuation / PnL
 - Resultat attendu:
-  - en `priced`, le prix total = prix de base + premium
-  - en `basis`, le premium s'ajoute aussi au prix total
+  - le `unit_price` reste le prix de base, hors premium
+  - en `priced`, le montant economique = `unit_price + premium`
+  - en `basis`, le premium s'ajoute aussi au prix total economique
   - en valuation `basis`, le premium s'applique a chaque composant valorise
     (ex: meme premium repete sur chaque bloc ICE)
 - Exemple metier:
@@ -221,13 +221,14 @@ Owner technique: `a completer`
 - Description:
   - Quand `enable_linked_currency` est coche, le `premium` est saisi dans la
     devise / unite liee, pas dans la devise / unite native de la ligne.
-  - Le systeme doit convertir ce premium vers le `unit_price` de la ligne pour
-    les calculs internes.
+  - Le systeme doit convertir ce premium vers le repere de la ligne pour les
+    calculs internes de montant et de valuation.
 - Resultat attendu:
   - `premium` est interprete dans le repere `linked_currency` / `linked_unit`
-  - le `unit_price` converti integre ce premium
-  - les `amount` et valuations bases sur `unit_price` reflectent donc ce
-    premium converti
+  - le `unit_price` ne doit pas absorber ce premium
+  - les `amount` et valuations doivent refleter ce premium converti
+  - si `linked currency` est cochee, `linked_price`, `linked_currency` et
+    `linked_unit` sont obligatoires
 - Priorite:
   - `structurante`
 
@@ -238,12 +239,47 @@ Owner technique: `a completer`
   - Quand une ligne est en `basis` et `linked currency`, le bloc
     `linked_price` doit etre recalcule automatiquement.
   - Ce `linked_price` doit representer le prix basis brut, hors premium.
-  - Le `unit_price` final de la ligne est ensuite obtenu en ajoutant le premium
-    converti.
+  - Le `unit_price` de la ligne doit rester ce prix brut converti.
+  - Le premium converti n'est ajoute qu'au niveau du `amount`.
 - Resultat attendu:
   - modification du basis -> mise a jour automatique du `linked_price`
   - `linked_price` = base market / basis
-  - `unit_price` = `linked_price` converti + premium converti
+  - `unit_price` = `linked_price` converti
+  - `amount` = quantite * (`unit_price` + premium converti)
+- Priorite:
+  - `importante`
+
+### BR-PT-011 - Une sale line non matchee avec lot virtuel doit generer une valuation sale-first des la validation
+
+- Intent: ne pas attendre un matching purchase pour afficher le PnL d'une sale
+  ouverte.
+- Description:
+  - Lors de la validation d'une `sale.line`, le systeme peut creer un lot
+    `virtual`.
+  - Si aucun `lot.qt` ne relie ce lot a une `purchase.line`, il faut tout de
+    meme generer la valuation cote sale.
+- Resultat attendu:
+  - apres creation du lot virtuel, si aucun matching purchase n'existe:
+    - appeler `Valuation.generate_from_sale_line(line)`
+    - creer au moins la ligne `sale priced` fallback si la ligne porte un prix
+      economique via le premium
+- Priorite:
+  - `importante`
+
+### BR-PT-012 - Fallback valuation basis sans summary: utiliser le prix economique de la ligne
+
+- Intent: eviter qu'une valuation `basis` ouverte sorte a zero alors que la
+  ligne a bien une valeur economique via le premium.
+- Description:
+  - Une ligne `basis` peut ne pas avoir encore de `price_summary`.
+  - Dans ce cas, la valuation fallback ne doit pas prendre `unit_price` seul si
+    celui-ci est brut et hors premium.
+- Resultat attendu:
+  - le fallback valuation `basis` doit utiliser:
+    - `unit_price + premium converti`
+  - cette regle vaut au minimum pour:
+    - `sale.line` non matchee
+    - `purchase.line` sans summary
 - Priorite:
   - `importante`
 

modules/purchase_trade/docs/template-properties.md

@@ -239,6 +239,7 @@ Source code: `modules/purchase_trade/invoice.py`
 Source code: `modules/purchase_trade/sale.py`
 
 - `report_terms`
+- `report_crop_name`
 - `report_gross`
 - `report_net`
 - `report_qt`