shutro-erp 0.3.6 → 0.3.7

package/dist/trade_finance/i18n/bn.js

@@ -0,0 +1,162 @@
+/** Bangla for the module's labels, keyed by their English text (RFC 0023 §3.1; `pnpm i18n:extract`). */
+export const bn = {
+    'A requested amendment changes the LC only once accepted; a refused one changes nothing.': 'অনুরোধ করা সংশোধনী কেবল গৃহীত হলেই এলসি বদলায়; নামঞ্জুর সংশোধনী কিছুই বদলায় না।',
+    'A shipment is under an issued LC, on or before its latest shipment date, within what it allows — and the only one unless partial shipments are allowed.': 'শিপমেন্ট একটি ইস্যুকৃত এলসির অধীনে, তার সর্বশেষ শিপমেন্ট তারিখে বা তার আগে, অনুমোদিত সীমার মধ্যে হয় — আর আংশিক শিপমেন্ট অনুমোদিত না হলে একটিই।',
+    'A usance LC says after how many days it is paid.': 'ইউজেন্স এলসিতে কত দিন পরে পরিশোধ হবে তা উল্লেখ থাকে।',
+    Accept: 'গ্রহণ করুন',
+    Accepted: 'গৃহীত',
+    'Accepted on': 'গ্রহণের তারিখ',
+    'Accepted, not paid': 'গৃহীত, অপরিশোধিত',
+    Alerts: 'সতর্কবার্তা',
+    Amendments: 'সংশোধনী',
+    'Amendments › Date': 'সংশোধনী › তারিখ',
+    'Amendments › New amount': 'সংশোধনী › নতুন অঙ্ক',
+    'Amendments › New expiry': 'সংশোধনী › নতুন মেয়াদোত্তীর্ণের তারিখ',
+    'Amendments › New latest shipment': 'সংশোধনী › নতুন সর্বশেষ শিপমেন্ট',
+    'Amendments › What changes': 'সংশোধনী › যা বদলাচ্ছে',
+    Amount: 'অঙ্ক',
+    'An LC is for a positive amount.': 'এলসির অঙ্ক ধনাত্মক হতে হবে।',
+    'Applicant / beneficiary': 'আবেদনকারী / সুবিধাভোগী',
+    Applied: 'আবেদনকৃত',
+    'Applied on': 'আবেদনের তারিখ',
+    'Applied, not issued': 'আবেদনকৃত, ইস্যু হয়নি',
+    Apply: 'আবেদন করুন',
+    'Arrives on': 'পৌঁছানোর তারিখ',
+    'At sight': 'অ্যাট সাইট',
+    'At sight: paid when compliant documents are accepted; usance: paid the set number of days after acceptance.': 'অ্যাট সাইট: যথাযথ নথি গৃহীত হলে পরিশোধ; ইউজেন্স: গ্রহণের নির্ধারিত দিন পরে পরিশোধ।',
+    'Back to draft': 'খসড়ায় ফেরত নিন',
+    Bank: 'ব্যাংক',
+    'Bank limits': 'ব্যাংক সীমা',
+    'Bank reference': 'ব্যাংক রেফারেন্স',
+    'Biggest open LCs': 'সবচেয়ে বড় খোলা এলসি',
+    'Bill of lading / airway bill': 'বিল অব লেডিং / এয়ারওয়ে বিল',
+    'Can be drawn': 'উত্তোলনযোগ্য',
+    Cancel: 'বাতিল করুন',
+    Cancelled: 'বাতিল',
+    'CFR — Cost and freight': 'CFR — খরচ ও ভাড়া',
+    'CIF — Cost, insurance and freight': 'CIF — খরচ, বিমা ও ভাড়া',
+    'CIP — Carriage and insurance paid to': 'CIP — পরিবহন ও বিমা পরিশোধিত পর্যন্ত',
+    Close: 'বন্ধ করুন',
+    Company: 'প্রতিষ্ঠান',
+    Counterparty: 'প্রতিপক্ষ',
+    'CPT — Carriage paid to': 'CPT — পরিবহন পরিশোধিত পর্যন্ত',
+    'Created At': 'তৈরির সময়',
+    'Created By': 'তৈরি করেছেন',
+    Currency: 'মুদ্রা',
+    'DAP — Delivered at place': 'DAP — নির্দিষ্ট স্থানে সরবরাহকৃত',
+    Date: 'তারিখ',
+    'Days ahead': 'আগাম দিন',
+    'DDP — Delivered duty paid': 'DDP — শুল্ক পরিশোধিত সরবরাহ',
+    Direction: 'দিক',
+    Discrepancies: 'অসঙ্গতি',
+    'Discrepancies waived': 'অসঙ্গতি মওকুফ',
+    'Display Name': 'প্রদর্শিত নাম',
+    'Documents are presented under an issued LC, before it expires, for no more than it allows (its amount and tolerance).': 'দলিল ইস্যুকৃত এলসির অধীনে, মেয়াদ শেষ হওয়ার আগে, অনুমোদিত সীমার (অঙ্ক ও সহনশীলতা) বেশি নয় এমনভাবে উপস্থাপন করা হয়।',
+    'Documents presented': 'উপস্থাপিত দলিল',
+    'Documents required': 'প্রয়োজনীয় দলিল',
+    'Documents required: {{documents}}': 'প্রয়োজনীয় দলিল: {{documents}}',
+    Draft: 'খসড়া',
+    'Drafted, applied for at the bank, issued within the bank’s limit, then settled once paid, or cancelled.': 'খসড়া, ব্যাংকে আবেদন করা, ব্যাংকের সীমার মধ্যে ইস্যু করা, তারপর পরিশোধ হলে নিষ্পন্ন, অথবা বাতিল।',
+    Drawn: 'উত্তোলিত',
+    'Due on': 'নির্ধারিত তারিখ',
+    Expires: 'মেয়াদ শেষ',
+    'Expires at': 'মেয়াদ শেষ হওয়ার সময়',
+    'Expires on': 'মেয়াদ শেষের তারিখ',
+    'Expiring by month': 'মাস অনুযায়ী মেয়াদোত্তীর্ণ',
+    'Expiry place': 'মেয়াদোত্তীর্ণের স্থান',
+    Export: 'রপ্তানি',
+    'Export (opened for us)': 'রপ্তানি (আমাদের জন্য খোলা)',
+    'EXW — Ex works': 'EXW — কারখানা থেকে',
+    'FCA — Free carrier': 'FCA — ফ্রি ক্যারিয়ার',
+    Finance: 'অর্থ',
+    'FOB — Free on board': 'FOB — ফ্রি অন বোর্ড',
+    'Goods ship on or before the LC expires, and it expires after it is applied for.': 'পণ্য এলসির মেয়াদ শেষের দিন বা তার আগে পাঠাতে হবে, আর এলসির মেয়াদ আবেদনের পরে শেষ হবে।',
+    'How far ahead shipment and expiry dates are flagged.': 'শিপমেন্ট ও মেয়াদ শেষের তারিখ কত আগে চিহ্নিত হবে।',
+    ID: 'আইডি',
+    Import: 'আমদানি',
+    'Import (we apply)': 'আমদানি (আমরা আবেদন করি)',
+    'Import and export': 'আমদানি ও রপ্তানি',
+    'Import: our bank opens the LC for our vendor; export: a customer’s bank opens it for us.': 'আমদানি: আমাদের ব্যাংক সরবরাহকারীর জন্য এলসি খোলে; রপ্তানি: গ্রাহকের ব্যাংক আমাদের জন্য তা খোলে।',
+    Incoterm: 'ইনকোটার্ম',
+    Issued: 'ইস্যুকৃত',
+    'Issued by the bank': 'ব্যাংক কর্তৃক ইস্যুকৃত',
+    'Issued LCs whose latest shipment or expiry is this close are flagged.': 'যেসব ইস্যুকৃত এলসির সর্বশেষ শিপমেন্ট বা মেয়াদ শেষ এতটা কাছে, সেগুলো চিহ্নিত হয়।',
+    'Issued on': 'ইস্যুর তারিখ',
+    'Issuing bank': 'ইস্যুকারী ব্যাংক',
+    'Latest shipment': 'সর্বশেষ শিপমেন্ট',
+    LC: 'এলসি',
+    'LC amendment': 'এলসি সংশোধনী',
+    'LC limit': 'এলসি সীমা',
+    'LC number': 'এলসি নম্বর',
+    'LCs issued': 'ইস্যুকৃত এলসি',
+    'Letter of credit': 'ঋণপত্র (এলসি)',
+    'Letter of credit {{name}}': 'ঋণপত্র (এলসি) {{name}}',
+    'Letter of credit issued': 'ঋণপত্র (এলসি) ইস্যু হয়েছে',
+    'Letter of credit settled': 'ঋণপত্র (এলসি) নিষ্পত্তি হয়েছে',
+    'Letters of credit': 'ঋণপত্র (এলসি)',
+    'Letters of credit: amendments, presentations and discrepancies, bank limits, alerts': 'ঋণপত্র (এলসি): সংশোধনী, উপস্থাপন ও অসঙ্গতি, ব্যাংক সীমা, সতর্কবার্তা',
+    Limit: 'সীমা',
+    'Manager (limits, issuing, amendments, everything)': 'ব্যবস্থাপক (সীমা, ইস্যু, সংশোধনী, সবকিছু)',
+    'Margin (%)': 'মার্জিন (%)',
+    'Margin %': 'মার্জিন %',
+    'New amount': 'নতুন অঙ্ক',
+    'New expiry': 'নতুন মেয়াদোত্তীর্ণের তারিখ',
+    'New latest shipment': 'নতুন সর্বশেষ শিপমেন্ট',
+    Note: 'নোট',
+    'Only an issued LC is amended.': 'শুধু ইস্যুকৃত এলসি সংশোধন করা যায়।',
+    Open: 'খোলা',
+    Outstanding: 'বকেয়া',
+    'Outstanding by bank': 'ব্যাংক অনুযায়ী বকেয়া',
+    Overview: 'সারসংক্ষেপ',
+    'Page {{page}} of {{pages}}': 'পৃষ্ঠা {{page}} / {{pages}}',
+    Paid: 'পরিশোধিত',
+    'Paid on': 'পরিশোধের তারিখ',
+    'Partial shipment': 'আংশিক শিপমেন্ট',
+    'Partial shipments allowed': 'আংশিক শিপমেন্ট অনুমোদিত',
+    Payment: 'পেমেন্ট',
+    'Port of discharge': 'খালাসের বন্দর',
+    'Port of loading': 'বোঝাইয়ের বন্দর',
+    Presentation: 'উপস্থাপন',
+    Presentations: 'উপস্থাপন',
+    Presented: 'উপস্থাপিত',
+    'Presented documents are accepted when they comply or their discrepancies are waived, then paid at maturity, or refused.': 'উপস্থাপিত নথি যথাযথ হলে বা অসঙ্গতি মওকুফ হলে গৃহীত হয়, তারপর মেয়াদপূর্তিতে পরিশোধ হয়, অথবা নামঞ্জুর হয়।',
+    'Presented on': 'উপস্থাপনের তারিখ',
+    Reference: 'রেফারেন্স',
+    Refuse: 'নামঞ্জুর করুন',
+    Refused: 'নামঞ্জুর',
+    Requested: 'অনুরোধকৃত',
+    Settled: 'নিষ্পত্তিকৃত',
+    'Settled this month': 'এই মাসে নিষ্পত্তিকৃত',
+    Shipment: 'চালান (শিপমেন্ট)',
+    Shipments: 'চালান (শিপমেন্ট)',
+    Shipped: 'পাঠানো হয়েছে',
+    'Shipped on': 'পাঠানোর তারিখ',
+    'Source document': 'উৎস নথি',
+    State: 'অবস্থা',
+    Status: 'অবস্থা',
+    'The bank’s limit would be passed: settle other LCs, or have the limit raised.': 'ব্যাংকের সীমা অতিক্রম করবে: অন্য এলসি নিষ্পত্তি করুন, অথবা সীমা বাড়িয়ে নিন।',
+    'The documents are discrepant: waive the discrepancies, or refuse them.': 'দলিলে অসঙ্গতি আছে: অসঙ্গতি মওকুফ করুন, অথবা নামঞ্জুর করুন।',
+    'The LC amount plus its tolerance: the most that can be drawn.': 'এলসির অঙ্ক যোগ সহনশীলতা: সর্বোচ্চ যা উত্তোলন করা যায়।',
+    'The total of the documents presented under the LC, except refused presentations.': 'নামঞ্জুর উপস্থাপন বাদে এলসির অধীনে উপস্থাপিত নথির মোট অঙ্ক।',
+    'The total of the presentations the bank has paid.': 'ব্যাংক যে উপস্থাপনগুলো পরিশোধ করেছে তার মোট অঙ্ক।',
+    'The total value of the shipments made against the LC.': 'এলসির বিপরীতে পাঠানো চালানের (শিপমেন্ট) মোট মূল্য।',
+    'The trade term that says where the seller’s costs and risks end and the buyer’s begin.': 'যে বাণিজ্য শর্ত বলে দেয় বিক্রেতার খরচ ও ঝুঁকি কোথায় শেষ এবং ক্রেতার কোথায় শুরু।',
+    'This bank already has a limit in this currency.': 'এই ব্যাংকের এই মুদ্রায় ইতিমধ্যে একটি সীমা আছে।',
+    'Tolerance (± %)': 'সহনশীলতা (± %)',
+    'Tolerance %': 'সহনশীলতা %',
+    'Tolerance and margin are percents between 0 and 100.': 'সহনশীলতা ও মার্জিন ০ থেকে ১০০-এর মধ্যে শতাংশ।',
+    'Trade Finance': 'ট্রেড ফাইন্যান্স',
+    'Trade Finance manager': 'ট্রেড ফাইন্যান্স ব্যবস্থাপক',
+    'Trade Finance user': 'ট্রেড ফাইন্যান্স ব্যবহারকারী',
+    Transshipment: 'ট্রান্সশিপমেন্ট',
+    'Transshipment allowed': 'ট্রান্সশিপমেন্ট অনুমোদিত',
+    'Updated At': 'হালনাগাদের সময়',
+    'Updated By': 'হালনাগাদ করেছেন',
+    'Usance (days after acceptance)': 'ইউজেন্স (গ্রহণের পর দিন)',
+    'Usance (days)': 'ইউজেন্স (দিন)',
+    'User (LCs, presentations)': 'ব্যবহারকারী (এলসি, উপস্থাপন)',
+    'Value shipped': 'পাঠানো পণ্যের মূল্য',
+    'Vessel / flight': 'জাহাজ / ফ্লাইট',
+    'What changes': 'যা বদলাচ্ছে',
+    'What the issued LC still commits the bank to: its amount less what has been paid.': 'ইস্যু করা এলসিতে ব্যাংক এখনো যতটুকুর জন্য দায়বদ্ধ: এর অঙ্ক থেকে পরিশোধিত অংশ বাদে।',
+};

package/dist/trade_finance/index.js

@@ -59,6 +59,99 @@ export const tradeFinance = defineModule({
         category: 'Finance',
         summary: 'Letters of credit: amendments, presentations and discrepancies, bank limits, alerts',
     },
+    documents: [
+        {
+            key: 'letter_of_credit',
+            name: 'Letter of credit',
+            model: 'trade.lc',
+            layout: {
+                paper: 'A4',
+                header: '{{company.name}}',
+                footer: 'Page {{page}} of {{pages}}',
+                blocks: [
+                    { kind: 'heading', id: 'title', text: 'Letter of credit {{name}}', level: 1 },
+                    {
+                        kind: 'fields',
+                        id: 'lc',
+                        items: [
+                            { label: 'Direction', bind: 'direction' },
+                            { label: 'Bank', bind: 'bank.name' },
+                            { label: 'Bank reference', bind: 'bankReference' },
+                            { label: 'Applicant / beneficiary', bind: 'partner.name' },
+                            { label: 'Amount', bind: 'amount' },
+                            { label: 'Currency', bind: 'currency.name' },
+                            { label: 'Tolerance %', bind: 'tolerance' },
+                            { label: 'Payment', bind: 'payment' },
+                            { label: 'Usance (days)', bind: 'usanceDays' },
+                            { label: 'Incoterm', bind: 'incoterm' },
+                        ],
+                    },
+                    {
+                        kind: 'fields',
+                        id: 'dates',
+                        items: [
+                            { label: 'Applied', bind: 'applicationDate' },
+                            { label: 'Issued', bind: 'issueDate' },
+                            { label: 'Latest shipment', bind: 'latestShipmentDate' },
+                            { label: 'Expires', bind: 'expiryDate' },
+                            { label: 'Expiry place', bind: 'expiryPlace' },
+                            { label: 'Partial shipment', bind: 'partialShipment' },
+                            { label: 'Transshipment', bind: 'transshipment' },
+                            { label: 'Status', bind: 'state' },
+                        ],
+                    },
+                    {
+                        kind: 'fields',
+                        id: 'figures',
+                        items: [
+                            { label: 'Shipped', bind: 'shipped' },
+                            { label: 'Drawn', bind: 'drawn' },
+                            { label: 'Paid', bind: 'paid' },
+                            { label: 'Outstanding', bind: 'outstanding' },
+                            { label: 'Margin %', bind: 'marginPercent' },
+                        ],
+                    },
+                    { kind: 'text', id: 'documents', text: 'Documents required: {{documents}}' },
+                    { kind: 'text', id: 'note', text: '{{note}}' },
+                    { kind: 'signature', id: 'sign', labels: ['Prepared by', 'Authorised by'] },
+                ],
+            },
+        },
+    ],
+    importTemplates: [
+        {
+            key: 'trade_lc',
+            model: 'trade.lc',
+            label: 'Letter of credit',
+            columns: [
+                { header: 'LC number', field: 'bankReference' },
+                { header: 'Direction', field: 'direction' },
+                { header: 'Issuing bank', field: 'bank' },
+                { header: 'Counterparty', field: 'partner' },
+                { header: 'Currency', field: 'currency' },
+                { header: 'Amount', field: 'amount' },
+                { header: 'Tolerance (± %)', field: 'tolerance' },
+                { header: 'Payment', field: 'payment' },
+                { header: 'Usance (days)', field: 'usanceDays' },
+                { header: 'Incoterm', field: 'incoterm' },
+                { header: 'Applied on', field: 'applicationDate' },
+                { header: 'Issued on', field: 'issueDate' },
+                { header: 'Latest shipment', field: 'latestShipmentDate' },
+                { header: 'Expires on', field: 'expiryDate' },
+                { header: 'Amendments › Date', field: 'amendments.date' },
+                { header: 'Amendments › New amount', field: 'amendments.newAmount' },
+                { header: 'Amendments › New expiry', field: 'amendments.newExpiryDate' },
+                { header: 'Amendments › New latest shipment', field: 'amendments.newShipmentDate' },
+                { header: 'Amendments › What changes', field: 'amendments.note' },
+            ],
+        },
+    ],
+    events: [
+        { topic: 'trade.lc.issued', model: 'trade.lc', label: 'Letter of credit issued' },
+        { topic: 'trade.lc.settled', model: 'trade.lc', label: 'Letter of credit settled' },
+    ],
+    // Bangla for the labels it serves (RFC 0023 §3.1; `pnpm i18n:extract`).
+    i18n: { bn: () => import('./i18n/bn.js') },
     accessLevels: {
         user: { label: 'User (LCs, presentations)', groups: ['trade_finance.user'] },
         manager: {

package/dist/trade_finance/module.d.ts

@@ -1,3 +1,9 @@
+/**
+ * The data layer of Trade Finance (RFC 0021): import and export letters of credit under UCP 600 — the amount with its
+ * tolerance, at sight or usance, the shipment and expiry dates —, amendments applied only once accepted,
+ * presentations of documents with their discrepancies, accepted (with their maturity) and paid, and the limits each
+ * bank gives, which issuing an LC never passes.
+ */
 import { type Env } from './.kosh/bindings.js';
 /** A date as `YYYY-MM-DD` (date-only values from PostgreSQL are local midnights: their local parts). */
 export declare const iso: (v: unknown) => string;
@@ -3404,6 +3410,16 @@ export declare const tradeFinanceShutro: import("../server/orm.js").Module<reado
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly lang: import("../server/orm.js").SelectionField<"bn" | "en", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
     readonly phone: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -3625,6 +3641,16 @@ export declare const tradeFinanceShutro: import("../server/orm.js").Module<reado
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly lang: import("../server/orm.js").SelectionField<"bn" | "en", {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }>;
     readonly phone: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;

package/dist/trade_finance/module.js

@@ -6,7 +6,7 @@
  */
 import { contactsShutro } from '../contacts/index.js';
 import { messagingShutro } from '../messaging/index.js';
-import { installationSetting } from '../server/index.js';
+import { emitting, installationSetting } from '../server/index.js';
 import { orm } from '../server/orm.js';
 import { check, compute, defineModel, defineModule, f, method, records, } from './.kosh/bindings.js';
 const ALL = ['read', 'write', 'create', 'unlink'];
@@ -85,7 +85,11 @@ export const TradeLc = defineModel('trade.lc', {
         }),
         /** The LC number the bank gives when it issues it. */
         bankReference: f.char({ label: 'LC number' }),
-        direction: f.selection({ import: 'Import (we apply)', export: 'Export (opened for us)' }, { required: true, default: 'import' }),
+        direction: f.selection({ import: 'Import (we apply)', export: 'Export (opened for us)' }, {
+            required: true,
+            default: 'import',
+            help: 'Import: our bank opens the LC for our vendor; export: a customer’s bank opens it for us.',
+        }),
         bank: f.many2one('res.partner', {
             required: true,
             ondelete: 'restrict',
@@ -101,9 +105,16 @@ export const TradeLc = defineModel('trade.lc', {
         amount: f.monetary({ currency: 'currency', required: true }),
         /** ± percent drawn beyond or short of the amount (UCP 600 art. 30). */
         tolerance: f.decimal({ scale: 2, required: true, default: '0', label: 'Tolerance (± %)' }),
-        payment: f.selection({ sight: 'At sight', usance: 'Usance (days after acceptance)' }, { required: true, default: 'sight' }),
+        payment: f.selection({ sight: 'At sight', usance: 'Usance (days after acceptance)' }, {
+            required: true,
+            default: 'sight',
+            help: 'At sight: paid when compliant documents are accepted; usance: paid the set number of days after acceptance.',
+        }),
         usanceDays: f.integer({ label: 'Usance (days)' }),
-        incoterm: f.selection(INCOTERMS, { label: 'Incoterm' }),
+        incoterm: f.selection(INCOTERMS, {
+            label: 'Incoterm',
+            help: 'The trade term that says where the seller’s costs and risks end and the buyer’s begin.',
+        }),
         applicationDate: f.date({
             required: true,
             default: (env) => env.today(),
@@ -126,6 +137,7 @@ export const TradeLc = defineModel('trade.lc', {
             scale: 2,
             store: true,
             label: 'Shipped',
+            help: 'The total value of the shipments made against the LC.',
             ...compute('trade.lc', 'shipped', ['shipments.value'], (lcs) => {
                 for (const lc of lcs)
                     lc.shipped = [...lc.shipments].reduce((s, x) => s.plus(amountOf(x.value)), zero);
@@ -136,6 +148,7 @@ export const TradeLc = defineModel('trade.lc', {
             scale: 2,
             store: true,
             label: 'Can be drawn',
+            help: 'The LC amount plus its tolerance: the most that can be drawn.',
             ...compute('trade.lc', 'maxDrawable', ['amount', 'tolerance'], (lcs) => {
                 for (const lc of lcs)
                     lc.maxDrawable = amountOf(lc.amount)
@@ -148,6 +161,7 @@ export const TradeLc = defineModel('trade.lc', {
             scale: 2,
             store: true,
             label: 'Drawn',
+            help: 'The total of the documents presented under the LC, except refused presentations.',
             ...compute('trade.lc', 'drawn', ['presentations.amount', 'presentations.state'], (lcs) => {
                 for (const lc of lcs)
                     lc.drawn = [...lc.presentations]
@@ -159,6 +173,7 @@ export const TradeLc = defineModel('trade.lc', {
             scale: 2,
             store: true,
             label: 'Paid',
+            help: 'The total of the presentations the bank has paid.',
             ...compute('trade.lc', 'paid', ['presentations.amount', 'presentations.state'], (lcs) => {
                 for (const lc of lcs)
                     lc.paid = [...lc.presentations]
@@ -171,6 +186,7 @@ export const TradeLc = defineModel('trade.lc', {
             scale: 2,
             store: true,
             label: 'Outstanding',
+            help: 'What the issued LC still commits the bank to: its amount less what has been paid.',
             ...compute('trade.lc', 'outstanding', ['amount', 'paid', 'state'], (lcs) => {
                 for (const lc of lcs) {
                     const left = amountOf(lc.amount).minus(amountOf(lc.paid));
@@ -188,9 +204,10 @@ export const TradeLc = defineModel('trade.lc', {
                 cancel: 'Cancelled',
             },
             initial: 'draft',
+            help: 'Drafted, applied for at the bank, issued within the bank’s limit, then settled once paid, or cancelled.',
             transitions: {
                 apply: { from: ['draft'], to: 'applied' },
-                issue: {
+                issue: emitting('trade.lc.issued', {
                     from: ['applied'],
                     to: 'issued',
                     requires: 'trade_finance.issue',
@@ -227,14 +244,14 @@ export const TradeLc = defineModel('trade.lc', {
                                 await lc.write({ issueDate: lcs.env.today() });
                         await lcs.env.model('trade.lc').browse(lcs.ids).issued();
                     }),
-                },
-                settle: {
+                }),
+                settle: emitting('trade.lc.settled', {
                     from: ['issued'],
                     to: 'settled',
                     after: records('trade.lc', async (lcs) => {
                         await lcs.env.model('trade.lc').browse(lcs.ids).closed();
                     }),
-                },
+                }),
                 cancel: {
                     from: ['draft', 'applied', 'issued'],
                     to: 'cancel',
@@ -296,6 +313,7 @@ export const TradeAmendment = defineModel('trade.lc.amendment', {
         state: f.state({
             states: { draft: 'Requested', accepted: 'Accepted', refused: 'Refused' },
             initial: 'draft',
+            help: 'A requested amendment changes the LC only once accepted; a refused one changes nothing.',
             transitions: {
                 // Binding once accepted (UCP 600 art. 10): only then does the LC change.
                 accept: {
@@ -364,6 +382,7 @@ export const TradePresentation = defineModel('trade.lc.presentation', {
         state: f.state({
             states: { presented: 'Presented', accepted: 'Accepted', paid: 'Paid', refused: 'Refused' },
             initial: 'presented',
+            help: 'Presented documents are accepted when they comply or their discrepancies are waived, then paid at maturity, or refused.',
             transitions: {
                 accept: {
                     from: ['presented'],

package/dist/trade_finance_account/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 604ed0a44ec94837
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 253ef8464281fe66
 // Bindings of module `trade_finance_account`: import the definition API from here to get types scoped to what it can see.
 export { defineModel, defineModule, extendModel, f, replace } from '../../server/orm.js';
 import { definitions } from '../../server/orm.js';