From 2fecf60295ac36c72efebf9fa39151253a0ac7c7 Mon Sep 17 00:00:00 2001
From: laurentbarontini <l.barontini@open-squared.ch>
Date: Tue, 2 Jun 2026 12:00:51 +0200
Subject: [PATCH] Notes

---
 .../purchase_trade/docs/business/sessions.md  | 34 +++++++++++++++
 .../docs_source/business/sessions.md          | 42 +++++++++++++++++++
 2 files changed, 76 insertions(+)

diff --git a/modules/purchase_trade/docs/business/sessions.md b/modules/purchase_trade/docs/business/sessions.md
index cde9119..bdfe469 100644
--- a/modules/purchase_trade/docs/business/sessions.md
+++ b/modules/purchase_trade/docs/business/sessions.md
@@ -23,6 +23,40 @@ canonique seulement quand elle est reprise dans une page thematique.
 ## Notes deja partiellement promues
 
 <ul style="margin:0.65rem 0 1rem 1.1rem; padding-left:1rem; list-style-type:disc;">
+<li style="margin:0.38rem 0;">Session <code>2026-06-02</code>: demurrage / charter conditions et clauses de contrat, a promouvoir dans une page thematique avant de devenir canonique.
+<ul style="margin:0.65rem 0 1rem 1.35rem; padding-left:1rem; list-style-type:circle;">
+<li style="margin:0.38rem 0;">Demurrage / charter conditions:
+<ul style="margin:0.65rem 0 1rem 1.35rem; padding-left:1rem; list-style-type:circle;">
+<li style="margin:0.38rem 0;">Les conditions de charter sont portees par <code>charter.condition</code>, avec clauses laytime/NOR/demurrage/despatch, responsabilite, partie concernee et lignes de rates via <code>charter.condition.rate</code>.
+</li>
+<li style="margin:0.38rem 0;">Les contrats Sale et Purchase ont un onglet <code>Charter Conditions</code> au niveau entete et ligne. Une ligne sans conditions propres herite des conditions de l&#x27;entete; des conditions de ligne remplacent l&#x27;heritage.
+</li>
+<li style="margin:0.38rem 0;">Les shipments et SOF exposent les conditions Owner, Supplier et Customer retrouvees depuis le charter party et les lots/lignes physiques.
+</li>
+<li style="margin:0.38rem 0;">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.
+</li>
+<li style="margin:0.38rem 0;">Un solde de laytime negatif cree une compensation <code>demurrage</code>; un solde positif peut creer une compensation <code>despatch</code> si un rate despatch est defini.
+</li>
+</ul>
+</li>
+<li style="margin:0.38rem 0;">Contract clauses:
+<ul style="margin:0.65rem 0 1rem 1.35rem; padding-left:1rem; list-style-type:circle;">
+<li style="margin:0.38rem 0;">Structure ajoutee autour de <code>contract.clause</code>, <code>contract.template</code>, <code>contract.template.line</code> et <code>contract.clause.selection</code>, visible dans les onglets Sale/Purchase et dans les menus globaux Sales/Purchases.
+</li>
+<li style="margin:0.38rem 0;">Les clauses et templates de reference sont generes depuis <code>STANDARDIZED CONTRACTS - REFERENCE BOOK 2012 (Official version).docx</code> dans <code>contract_clause_reference.xml</code>: 53 clauses, 6 templates Sale et 120 lignes de template.
+</li>
+<li style="margin:0.38rem 0;">Un script SQL direct PostgreSQL existe dans <code>docs/sql/import_contract_clause_reference.sql</code> 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.
+</li>
+<li style="margin:0.38rem 0;">Les templates generes sont <code>direction = sale</code>, 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.
+</li>
+<li style="margin:0.38rem 0;">Les variables reconnues sont rendues depuis le contexte contrat (<code>[Contract_Number]</code>, <code>[reference]</code>, <code>[party]</code>, <code>[company]</code>, <code>[currency]</code>, <code>[incoterm]</code>, <code>[incoterm_location]</code>, <code>[payment_term]</code>, <code>[product]</code>, <code>[quantity]</code>, <code>[unit]</code>, <code>[product_origin]</code>, <code>[del_from]</code>, <code>[del_to]</code>). Les variables inconnues restent litterales pour override.
+</li>
+<li style="margin:0.38rem 0;">Sens metier attendu de <code>Optional</code>: 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&#x27;utilisation d&#x27;un template sans modification ne devrait pas la declencher.
+</li>
+</ul>
+</li>
+</ul>
+</li>
 <li style="margin:0.38rem 0;">Session <code>2026-04-30</code>: PnL fees ouverts et <code>% rate</code>, promue dans <a href="fees.md">fees.md</a> et <a href="valuation-pnl-mtm.md">valuation-pnl-mtm.md</a>.
 </li>
 <li style="margin:0.38rem 0;">Session <code>2026-05-01</code>: solde ouvert apres lots physiques et lots effectifs des fees, promue dans <a href="lots-and-quantities.md">lots-and-quantities.md</a> et <a href="fees.md">fees.md</a>.
diff --git a/modules/purchase_trade/docs_source/business/sessions.md b/modules/purchase_trade/docs_source/business/sessions.md
index 5cb8e8a..e5882d3 100644
--- a/modules/purchase_trade/docs_source/business/sessions.md
+++ b/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