Notes

modules/purchase_trade/docs_source/business/sessions.md

@@ -14,6 +14,48 @@ canonique seulement quand elle est reprise dans une page thematique.
 
 ## Notes deja partiellement promues
 
+- Session `2026-06-02`: demurrage / charter conditions et clauses de contrat,
+  a promouvoir dans une page thematique avant de devenir canonique.
+  - Demurrage / charter conditions:
+    - Les conditions de charter sont portees par `charter.condition`, avec
+      clauses laytime/NOR/demurrage/despatch, responsabilite, partie concernee
+      et lignes de rates via `charter.condition.rate`.
+    - Les contrats Sale et Purchase ont un onglet `Charter Conditions` au
+      niveau entete et ligne. Une ligne sans conditions propres herite des
+      conditions de l'entete; des conditions de ligne remplacent l'heritage.
+    - Les shipments et SOF exposent les conditions Owner, Supplier et Customer
+      retrouvees depuis le charter party et les lots/lignes physiques.
+    - Le calcul SOF privilegie la condition appliquee: laytime allowed,
+      turn time, pumping rate, rate demurrage et rate despatch. A defaut, il
+      garde les anciens champs legacy demurrage/pumping.
+    - Un solde de laytime negatif cree une compensation `demurrage`; un solde
+      positif peut creer une compensation `despatch` si un rate despatch est
+      defini.
+  - Contract clauses:
+    - Structure ajoutee autour de `contract.clause`, `contract.template`,
+      `contract.template.line` et `contract.clause.selection`, visible dans les
+      onglets Sale/Purchase et dans les menus globaux Sales/Purchases.
+    - Les clauses et templates de reference sont generes depuis
+      `STANDARDIZED CONTRACTS - REFERENCE BOOK 2012 (Official version).docx`
+      dans `contract_clause_reference.xml`: 53 clauses, 6 templates Sale et
+      120 lignes de template.
+    - Un script SQL direct PostgreSQL existe dans
+      `docs/sql/import_contract_clause_reference.sql` pour alimenter la base
+      quand les tables existent deja; il ne remplace pas la mise a jour module
+      necessaire pour creer/mettre a jour le schema.
+    - Les templates generes sont `direction = sale`, car le document source
+      parle de Sales Agreement avec Seller/Buyer. Les variantes Purchase
+      doivent etre adaptees avant import si on veut les afficher cote achat.
+    - Les variables reconnues sont rendues depuis le contexte contrat
+      (`[Contract_Number]`, `[reference]`, `[party]`, `[company]`,
+      `[currency]`, `[incoterm]`, `[incoterm_location]`, `[payment_term]`,
+      `[product]`, `[quantity]`, `[unit]`, `[product_origin]`, `[del_from]`,
+      `[del_to]`). Les variables inconnues restent litterales pour override.
+    - Sens metier attendu de `Optional`: une clause optional peut etre retiree
+      sans validation juridique; une clause non optional est obligatoire et ne
+      devrait pouvoir etre que surchargee. Les overrides devront declencher une
+      validation Legal/Juridique dans le workflow; l'utilisation d'un template
+      sans modification ne devrait pas la declencher.
 - Session `2026-04-30`: PnL fees ouverts et `% rate`, promue dans
   [fees.md](fees.md) et [valuation-pnl-mtm.md](valuation-pnl-mtm.md).
 - Session `2026-05-01`: solde ouvert apres lots physiques et lots effectifs