admin/tradon
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Notes

Browse Source
This commit is contained in:
laurentbarontini
2026-06-02 12:00:51 +02:00
parent 3b9a6ca943
commit 2fecf60295
2 changed files with 76 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
modules/purchase_trade/docs/business/sessions.md
View File

@@ -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>.