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
2026-06-02: demurrage / charter conditions et clauses de contrat, a promouvoir dans une page thematique avant de devenir canonique.
+charter.condition, avec clauses laytime/NOR/demurrage/despatch, responsabilite, partie concernee et lignes de rates via charter.condition.rate.
+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.
+demurrage; un solde positif peut creer une compensation despatch si un rate despatch est defini.
+contract.clause, contract.template, contract.template.line et contract.clause.selection, visible dans les onglets Sale/Purchase et dans les menus globaux Sales/Purchases.
+STANDARDIZED CONTRACTS - REFERENCE BOOK 2012 (Official version).docx dans contract_clause_reference.xml: 53 clauses, 6 templates Sale et 120 lignes de template.
+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.
+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.
+[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.
+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.
+2026-04-30: PnL fees ouverts et % rate, promue dans fees.md et valuation-pnl-mtm.md.
2026-05-01: solde ouvert apres lots physiques et lots effectifs des fees, promue dans lots-and-quantities.md et fees.md.
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