shutro-erp 0.3.5 → 0.3.7

package/dist/permissions/web/ApprovalPanel.js

@@ -1,20 +1,39 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * The approval panel (RFC 0004 §6, RFC 0007): the web contribution of `shutro-erp/permissions`, registered as the node
- * component `approvals.Panel` and placed in a form by a view extension. Shows the record's approval levels and lets
- * the current user decide the requests they may decide now (the server checks order, role, company and separation
- * of duties).
+ * The approval panel (RFC 0004 §6, RFC 0007, RFC 0025 §3.1): the web contribution of `shutro-erp/permissions`, registered as
+ * the node component `approvals.Panel` and placed in a form by a view extension. The record's current round as steps —
+ * each level with its state and votes, who decided and what they said —, earlier rounds behind a disclosure; the
+ * user's decision when it is theirs (approve; reject or send back for changes with a reason) and, for the requester,
+ * withdrawing. The server checks order, approvers, company and separation of duties.
  */
 import { ApiError, Badge, Button, Textarea } from '../../ui/index.js';
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import { useId, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+/** Whole hours between two instants (to now when `to` is null). */
+const hoursBetween = (from, to) => Math.max(0, Math.round(((to === null ? Date.now() : Date.parse(to)) - Date.parse(from)) / 3_600_000));
 const TONE = {
     pending: 'warning',
     approved: 'success',
     rejected: 'danger',
+    sent_back: 'danger',
     cancelled: 'neutral',
 };
+const DOT = {
+    pending: 'border-warning bg-warning/20',
+    approved: 'border-success bg-success',
+    rejected: 'border-danger bg-danger',
+    sent_back: 'border-danger bg-danger/40',
+    cancelled: 'border-muted-foreground bg-muted',
+};
+function Round({ requests, events = [], }) {
+    const { t, i18n } = useTranslation('approvalPanel');
+    return (_jsx("ol", { className: "grid gap-3", children: requests.map((r) => (_jsxs("li", { className: "flex gap-3 text-sm", children: [_jsx("span", { "aria-hidden": "true", className: `mt-1 size-3 shrink-0 rounded-full border-2 ${DOT[r.state]}` }), _jsxs("span", { className: "grid flex-1 gap-0.5", children: [_jsxs("span", { className: "flex flex-wrap items-center gap-2", children: [_jsx("span", { className: "font-medium", children: r.levelName }), _jsx(Badge, { tone: TONE[r.state], children: t(`state.${r.state}`) }), r.required > 1 ? (_jsx("span", { className: "text-xs text-muted-foreground", children: t('votes', { n: r.approvals, of: r.required }) })) : null] }), r.approverRole === '' ? null : (_jsx("span", { className: "text-xs text-muted-foreground", children: r.approverRole })), r.comment === null ? null : _jsxs("span", { className: "text-xs", children: ["\u201C", r.comment, "\u201D"] }), r.state === 'pending' && r.startedAt !== null ? (_jsx("span", { className: "text-xs text-muted-foreground", children: t('since', { hours: hoursBetween(r.startedAt, null) }) })) : null, r.explanation === null && !events.some((e) => e.request === r.id) ? null : (_jsxs("details", { className: "text-xs text-muted-foreground", children: [_jsx("summary", { className: "cursor-pointer", children: t('how') }), r.explanation === null ? null : _jsx("p", { className: "mt-1", children: r.explanation }), _jsx("ul", { className: "mt-1 grid gap-0.5", "aria-label": t('log'), children: events
+                                        .filter((e) => e.request === r.id)
+                                        .map((e) => (_jsxs("li", { children: [_jsx("time", { dateTime: e.at, children: new Date(e.at).toLocaleString(i18n.language) }), ' ', "\u00B7 ", t(`event.${e.kind}`), e.note === null || e.kind === 'created' ? '' : ` — ${e.note}`] }, e.id))) })] }))] })] }, r.id))) }));
+}
 export function ApprovalPanel({ record, model, api, version, reload, }) {
+    const { t } = useTranslation('approvalPanel');
     const queryClient = useQueryClient();
     const id = useId();
     const [comment, setComment] = useState('');
@@ -29,20 +48,65 @@ export function ApprovalPanel({ record, model, api, version, reload, }) {
         queryFn: () => api.call('GET', '/api/v1/approvals/inbox'),
         enabled: recordId !== undefined,
     });
+    const me = useQuery({ queryKey: ['me'], queryFn: () => api.me() });
+    const done = async () => {
+        setComment('');
+        await queryClient.invalidateQueries({ queryKey: ['approvals'] });
+        reload();
+    };
     const decide = useMutation({
-        mutationFn: ({ request, decision }) => api.call('POST', `/api/v1/approvals/requests/${request}/${decision}`, comment.trim() === '' ? {} : { comment: comment.trim() }),
+        mutationFn: ({ request, decision, }) => api.call('POST', `/api/v1/approvals/requests/${request}/${decision}`, comment.trim() === '' ? {} : { comment: comment.trim() }),
+        onSuccess: done,
+    });
+    const [reassigning, setReassigning] = useState(false);
+    const [chosen, setChosen] = useState([]);
+    const [mode, setMode] = useState('replace');
+    const [reason, setReason] = useState('');
+    const people = useQuery({
+        queryKey: ['approvals', 'people'],
+        queryFn: () => api.call('GET', '/api/v1/models/res.users?fields=id,name&limit=200&order=name'),
+        enabled: reassigning,
+    });
+    const reassign = useMutation({
+        mutationFn: (request) => api.call('POST', `/api/v1/approvals/requests/${request}/reassign`, {
+            users: chosen,
+            mode,
+            reason: reason.trim(),
+        }),
         onSuccess: async () => {
-            setComment('');
-            await queryClient.invalidateQueries({ queryKey: ['approvals'] });
-            reload();
+            setReassigning(false);
+            setChosen([]);
+            setReason('');
+            await done();
         },
     });
+    const tell = useMutation({
+        mutationFn: (request) => api.call('POST', `/api/v1/approvals/requests/${request}/notify-backups`, {}),
+        onSuccess: done,
+    });
+    const withdraw = useMutation({
+        mutationFn: () => api.call('POST', `/api/v1/approvals/${model}/${recordId}/withdraw`),
+        onSuccess: done,
+    });
     if (recordId === undefined)
         return null;
-    const current = (requests.data?.requests ?? []).filter((r) => r.state !== 'cancelled');
-    if (current.length === 0)
+    const all = requests.data?.requests ?? [];
+    if (all.length === 0)
         return null;
+    const last = Math.max(...all.map((r) => r.round));
+    const current = all.filter((r) => r.round === last && r.state !== 'cancelled');
+    const earlier = all.filter((r) => r.round < last && r.state !== 'cancelled');
     const mine = new Set((inbox.data?.requests ?? []).map((r) => r.id));
     const actionable = current.find((r) => mine.has(r.id));
-    return (_jsxs("section", { "aria-labelledby": `${id}-title`, className: "rounded-lg border bg-surface p-4", children: [_jsx("h2", { id: `${id}-title`, className: "mb-3 text-sm font-semibold", children: "Approvals" }), _jsx("ol", { className: "grid gap-2", children: current.map((r) => (_jsxs("li", { className: "flex flex-wrap items-center justify-between gap-2 text-sm", children: [_jsxs("span", { children: [_jsx("span", { className: "font-medium", children: r.levelName }), _jsxs("span", { className: "text-muted-foreground", children: [" \u00B7 ", r.approverRole] }), r.comment === null ? null : (_jsxs("span", { className: "block text-xs text-muted-foreground", children: ["\u201C", r.comment, "\u201D"] }))] }), _jsx(Badge, { tone: TONE[r.state], children: r.state })] }, r.id))) }), actionable === undefined ? null : (_jsxs("div", { className: "mt-4 grid gap-2", children: [_jsx("label", { htmlFor: `${id}-comment`, className: "text-sm text-muted-foreground", children: "Comment" }), _jsx(Textarea, { id: `${id}-comment`, value: comment, onChange: (e) => setComment(e.target.value) }), decide.error === null ? null : (_jsx("p", { role: "alert", className: "text-sm text-danger", children: decide.error instanceof ApiError ? decide.error.message : String(decide.error) })), _jsxs("div", { className: "flex gap-2", children: [_jsxs(Button, { variant: "primary", size: "sm", busy: decide.isPending, onClick: () => decide.mutate({ request: actionable.id, decision: 'approve' }), children: ["Approve ", actionable.levelName] }), _jsx(Button, { variant: "danger", size: "sm", busy: decide.isPending, onClick: () => decide.mutate({ request: actionable.id, decision: 'reject' }), children: "Reject" })] })] }))] }));
+    const asked = current.some((r) => r.state === 'pending' && r.requestedBy === me.data?.id);
+    const error = decide.error ?? withdraw.error ?? reassign.error ?? tell.error;
+    const manage = requests.data?.manage === true;
+    // The waiting request whose turn it is (the first, when levels decide side by side).
+    const waiting = current.find((r) => r.state === 'pending' && r.startedAt !== null);
+    const mayTell = waiting !== undefined &&
+        waiting.backups.length > 0 &&
+        (manage || waiting.approvers.includes(me.data?.id ?? -1));
+    return (_jsxs("section", { "aria-labelledby": `${id}-title`, className: "rounded-lg border bg-surface p-4", children: [_jsxs("h2", { id: `${id}-title`, className: "mb-3 flex items-center gap-2 text-sm font-semibold", children: [t('title'), last > 1 ? _jsx(Badge, { tone: "neutral", children: t('round', { n: last }) }) : null] }), current.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('withdrawn') })) : (_jsx(Round, { requests: current, events: requests.data?.events ?? [] })), earlier.length === 0 ? null : (_jsxs("details", { className: "mt-3 text-sm", children: [_jsx("summary", { className: "cursor-pointer text-muted-foreground", children: t('earlier', { count: earlier.length }) }), _jsx("div", { className: "mt-2", children: _jsx(Round, { requests: earlier }) })] })), actionable === undefined ? null : (_jsxs("div", { className: "mt-4 grid gap-2", children: [_jsx("label", { htmlFor: `${id}-comment`, className: "text-sm font-medium", children: t('yourDecision', { level: actionable.levelName }) }), _jsx(Textarea, { id: `${id}-comment`, placeholder: t('commentHint'), value: comment, onChange: (e) => setComment(e.target.value) }), _jsxs("div", { className: "flex flex-wrap gap-2", children: [_jsx(Button, { variant: "primary", disabled: decide.isPending, onClick: () => decide.mutate({ request: actionable.id, decision: 'approve' }), children: t('approve') }), _jsx(Button, { disabled: decide.isPending || comment.trim() === '', onClick: () => decide.mutate({ request: actionable.id, decision: 'send-back' }), children: t('sendBack') }), _jsx(Button, { variant: "danger", disabled: decide.isPending || comment.trim() === '', onClick: () => decide.mutate({ request: actionable.id, decision: 'reject' }), children: t('reject') })] })] })), waiting !== undefined && (manage || mayTell) ? (_jsxs("div", { className: "mt-3 flex flex-wrap gap-2", children: [manage ? (_jsx(Button, { variant: "ghost", onClick: () => setReassigning((v) => !v), children: t('reassign') })) : null, mayTell ? (_jsx(Button, { variant: "ghost", disabled: tell.isPending, onClick: () => tell.mutate(waiting.id), children: t('tellBackups') })) : null] })) : null, reassigning && waiting !== undefined ? (_jsxs("fieldset", { className: "mt-3 grid gap-2 rounded-md border p-3", children: [_jsx("legend", { className: "px-1 text-sm font-medium", children: t('reassignLevel', { level: waiting.levelName }) }), _jsx("label", { htmlFor: `${id}-people`, className: "text-sm", children: t('newApprovers') }), _jsx("select", { id: `${id}-people`, multiple: true, className: "min-h-24 rounded-md border bg-surface p-1 text-sm", value: chosen.map(String), onChange: (e) => setChosen([...e.target.selectedOptions].map((o) => Number(o.value))), children: (people.data?.items ?? [])
+                            .filter((u) => u.id !== waiting.requestedBy)
+                            .map((u) => (_jsx("option", { value: u.id, children: u.name }, u.id))) }), _jsx("div", { className: "flex flex-wrap gap-3 text-sm", children: ['replace', 'add'].map((m) => (_jsxs("label", { className: "flex items-center gap-1", children: [_jsx("input", { type: "radio", name: `${id}-mode`, checked: mode === m, onChange: () => setMode(m) }), t(`mode.${m}`)] }, m))) }), _jsx("label", { htmlFor: `${id}-reason`, className: "text-sm", children: t('reason') }), _jsx(Textarea, { id: `${id}-reason`, value: reason, onChange: (e) => setReason(e.target.value) }), _jsx("div", { children: _jsx(Button, { variant: "primary", disabled: reassign.isPending || chosen.length === 0 || reason.trim() === '', onClick: () => reassign.mutate(waiting.id), children: t('reassignConfirm') }) })] })) : null, asked ? (_jsx("div", { className: "mt-3", children: _jsx(Button, { variant: "ghost", disabled: withdraw.isPending, onClick: () => withdraw.mutate(), children: t('withdraw') }) })) : null, error === null ? null : (_jsx("p", { role: "alert", className: "mt-2 text-sm text-danger", children: error instanceof ApiError ? error.message : String(error) }))] }));
 }

package/dist/permissions/web/index.d.ts

@@ -2,8 +2,10 @@
  * @packageDocumentation
  * The web contribution of `shutro-erp/permissions` (RFC 0007 §5): register it in the app's registry.
  */
-import type { Registry } from '../../ui/index.js';
+import { type Registry } from '../../ui/index.js';
+import type { i18n } from 'i18next';
 import { ApprovalPanel } from './ApprovalPanel.js';
-export { ApprovalPanel };
-/** Registers `approvals.Panel`. */
-export declare function registerPermissionsWeb(registry: Registry): Registry;
+import { messages } from './messages.js';
+export { ApprovalPanel, messages as approvalPanelMessages };
+/** Registers `approvals.Panel` (and its messages in `i18n`, when given). */
+export declare function registerPermissionsWeb(registry: Registry, i18n?: i18n): Registry;

package/dist/permissions/web/index.js

@@ -1,6 +1,15 @@
+/**
+ * @packageDocumentation
+ * The web contribution of `shutro-erp/permissions` (RFC 0007 §5): register it in the app's registry.
+ */
+import { addMessages } from '../../ui/index.js';
 import { ApprovalPanel } from './ApprovalPanel.js';
-export { ApprovalPanel };
-/** Registers `approvals.Panel`. */
-export function registerPermissionsWeb(registry) {
-    return registry.registerComponent('approvals.Panel', ApprovalPanel);
+import { messages } from './messages.js';
+export { ApprovalPanel, messages as approvalPanelMessages };
+/** Registers `approvals.Panel` (and its messages in `i18n`, when given). */
+export function registerPermissionsWeb(registry, i18n) {
+    registry.registerComponent('approvals.Panel', ApprovalPanel);
+    if (i18n !== undefined)
+        addMessages(i18n, 'approvalPanel', messages);
+    return registry;
 }

package/dist/permissions/web/messages.d.ts

@@ -0,0 +1,2 @@
+/** Messages of the approval panel on records (namespace `approvalPanel`), in English and Bangla. */
+export declare const messages: Readonly<Record<string, object>>;

package/dist/permissions/web/messages.js

@@ -0,0 +1,95 @@
+/** Messages of the approval panel on records (namespace `approvalPanel`), in English and Bangla. */
+export const messages = {
+    en: {
+        title: 'Approvals',
+        round: 'Round {{n}}',
+        earlier: 'Earlier rounds ({{count}})',
+        withdrawn: 'The approvals were withdrawn.',
+        votes: '{{n}} of {{of}} approvals',
+        yourDecision: 'Your decision: {{level}}',
+        commentHint: 'A comment (needed to reject or send back)',
+        approve: 'Approve',
+        sendBack: 'Send back for changes',
+        reject: 'Reject',
+        withdraw: 'Withdraw my request',
+        how: 'How the approvers were found',
+        reassign: 'Reassign',
+        reassignLevel: 'Reassign {{level}}',
+        newApprovers: 'Who decides instead',
+        mode: { replace: 'Replace the approvers', add: 'Add to them' },
+        reason: 'Why (required)',
+        reassignConfirm: 'Reassign',
+        tellBackups: 'Tell the backups',
+        log: 'Log',
+        since: 'Its turn for {{hours}} h',
+        event: {
+            created: 'Created',
+            started: 'Its turn',
+            voted: 'Voted',
+            approved: 'Approved',
+            rejected: 'Rejected',
+            sent_back: 'Sent back',
+            cancelled: 'Cancelled',
+            skipped: 'Skipped',
+            reminded: 'Reminded',
+            escalated: 'Escalated',
+            auto: 'Approved already',
+            reassigned: 'Reassigned',
+            synced: 'Synced',
+            notified: 'Backups told',
+        },
+        state: {
+            pending: 'Waiting',
+            approved: 'Approved',
+            rejected: 'Rejected',
+            sent_back: 'Sent back',
+            cancelled: 'Cancelled',
+        },
+    },
+    bn: {
+        title: 'অনুমোদন',
+        round: 'পর্ব {{n}}',
+        earlier: 'আগের পর্ব ({{count}})',
+        withdrawn: 'অনুমোদনের অনুরোধ প্রত্যাহার করা হয়েছে।',
+        votes: '{{of}}টির মধ্যে {{n}}টি অনুমোদন',
+        yourDecision: 'আপনার সিদ্ধান্ত: {{level}}',
+        commentHint: 'একটি মন্তব্য (প্রত্যাখ্যান বা ফেরত পাঠাতে প্রয়োজন)',
+        approve: 'অনুমোদন',
+        sendBack: 'সংশোধনের জন্য ফেরত',
+        reject: 'প্রত্যাখ্যান',
+        withdraw: 'আমার অনুরোধ প্রত্যাহার',
+        how: 'অনুমোদনকারী কীভাবে নির্ধারিত হলেন',
+        reassign: 'অন্যকে দিন',
+        reassignLevel: '{{level}} অন্যকে দিন',
+        newApprovers: 'এর বদলে কে সিদ্ধান্ত নেবেন',
+        mode: { replace: 'অনুমোদনকারী বদলে দিন', add: 'তাঁদের সঙ্গে যোগ করুন' },
+        reason: 'কারণ (আবশ্যক)',
+        reassignConfirm: 'অন্যকে দিন',
+        tellBackups: 'বিকল্পদের জানান',
+        log: 'লগ',
+        since: '{{hours}} ঘণ্টা ধরে এর পালা',
+        event: {
+            created: 'তৈরি',
+            started: 'এর পালা',
+            voted: 'ভোট',
+            approved: 'অনুমোদিত',
+            rejected: 'প্রত্যাখ্যাত',
+            sent_back: 'ফেরত পাঠানো',
+            cancelled: 'বাতিল',
+            skipped: 'বাদ দেওয়া',
+            reminded: 'মনে করানো',
+            escalated: 'ঊর্ধ্বতনে পাঠানো',
+            auto: 'আগেই অনুমোদিত',
+            reassigned: 'অন্যকে দেওয়া',
+            synced: 'মিলিয়ে নেওয়া',
+            notified: 'বিকল্পদের জানানো',
+        },
+        state: {
+            pending: 'অপেক্ষায়',
+            approved: 'অনুমোদিত',
+            rejected: 'প্রত্যাখ্যাত',
+            sent_back: 'ফেরত পাঠানো',
+            cancelled: 'বাতিল',
+        },
+    },
+};

package/dist/portal/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: d1428de5985e3529
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: ebc3fbac95760b14
 // Bindings of module `portal`: 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';

package/dist/portal/.kosh/schema.d.ts

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: d1428de5985e3529
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: ebc3fbac95760b14
 // Schema view of module `portal` (RFC 0002 §7.7): the models it owns or depends on, with the extensions it can see.
 import type { F } from '../../server/orm.js';
 
@@ -508,6 +508,7 @@ export interface ResPartner {
     readonly parent: F.Many2one<'res.partner'>;
     readonly contacts: F.One2many<'res.partner', { readonly required: true }>;
     readonly email: F.Char;
+    readonly lang: F.Selection<'en' | 'bn'>;
     readonly phone: F.Char;
     readonly mobile: F.Char;
     readonly website: F.Char;

package/dist/portal/documents.d.ts

@@ -12,6 +12,9 @@ export interface PortalDocument {
     readonly model: ApiModel;
     /** The lines' model, when the document has lines. */
     readonly lineModel: ApiModel | null;
+    /** The optional items' model and the field that points back at the document, when it has options. */
+    readonly optionModel: ApiModel | null;
+    readonly optionParent: string | null;
 }
 /** The documents of the loaded modules, by key. @throws {ServerConfigError} for a declaration that cannot work */
 export declare function portalDocuments(registry: KoshRegistry): ReadonlyMap<string, PortalDocument>;

package/dist/portal/documents.js

@@ -50,12 +50,32 @@ export function portalDocuments(registry) {
                     if (!lineModel.byKey.has(field))
                         fail(key, `${lines?.target} has no field '${field}'.`, 'Declare existing line fields.');
             }
+            let optionModel = null;
+            let optionParent = null;
+            if (spec.options !== undefined) {
+                const options = m.byKey.get(spec.options.field);
+                if (options?.kind !== 'one2many' || options.target === null)
+                    fail(key, `'${spec.options.field}' is not a one2many.`, 'Name the options field.');
+                optionModel = models.get(options?.target ?? '') ?? null;
+                if (optionModel === null)
+                    fail(key, `the options' model ${options?.target} is not served.`, 'Use a served model.');
+                const om = optionModel;
+                for (const field of spec.options.fields)
+                    if (!om.byKey.has(field))
+                        fail(key, `${om.name} has no field '${field}'.`, 'Declare existing option fields.');
+                if (!om.transitions.includes(spec.options.add))
+                    fail(key, `${om.name} has no transition '${spec.options.add}'.`, 'Name the transition that adds an option.');
+                optionParent =
+                    om.fields.find((f) => f.kind === 'many2one' && f.target === spec.model)?.key ?? null;
+                if (optionParent === null)
+                    fail(key, `${om.name} has no many2one to ${spec.model}.`, 'Options point at their document.');
+            }
             for (const action of spec.actions ?? [])
                 if (!m.transitions.includes(action.transition))
                     fail(key, `${spec.model} has no transition '${action.transition}' (action '${action.key}').`, `Transitions: ${m.transitions.join(', ') || 'none'}.`);
             if (spec.pdf !== undefined && !templates.has(spec.pdf))
                 fail(key, `no document template '${spec.pdf}'.`, 'Name a template a module ships (module.key).');
-            out.set(key, { spec, model: m, lineModel });
+            out.set(key, { spec, model: m, lineModel, optionModel, optionParent });
         }
     return out;
 }

package/dist/portal/i18n/bn.d.ts

@@ -0,0 +1,2 @@
+/** Bangla for the module's labels, keyed by their English text (RFC 0023 §3.1; `pnpm i18n:extract`). */
+export declare const bn: Readonly<Record<string, string>>;

package/dist/portal/i18n/bn.js

@@ -0,0 +1,33 @@
+/** Bangla for the module's labels, keyed by their English text (RFC 0023 §3.1; `pnpm i18n:extract`). */
+export const bn = {
+    'A document is announced once.': 'একটি নথির ঘোষণা একবারই দেওয়া হয়।',
+    Action: 'কার্যক্রম',
+    Company: 'প্রতিষ্ঠান',
+    'Created At': 'তৈরির সময়',
+    'Created By': 'তৈরি করেছেন',
+    'Display Name': 'প্রদর্শিত নাম',
+    Document: 'নথি',
+    'Document Hash': 'নথির হ্যাশ',
+    'Expires At': 'মেয়াদ শেষের সময়',
+    ID: 'আইডি',
+    'Invited By': 'আমন্ত্রণ জানিয়েছেন',
+    Ip: 'আইপি',
+    Model: 'মডেল',
+    Name: 'নাম',
+    'Portal access': 'পোর্টাল প্রবেশাধিকার',
+    'Portal access manager': 'পোর্টাল প্রবেশাধিকার ব্যবস্থাপক',
+    'Portal announcement': 'পোর্টাল ঘোষণা',
+    'Portal contact': 'পোর্টাল যোগাযোগ',
+    'Portal invitation': 'পোর্টাল আমন্ত্রণ',
+    'Portal signature': 'পোর্টাল স্বাক্ষর',
+    'Portal user': 'পোর্টাল ব্যবহারকারী',
+    'Portal users': 'পোর্টাল ব্যবহারকারী',
+    Recipients: 'প্রাপক',
+    Record: 'রেকর্ড',
+    Signature: 'স্বাক্ষর',
+    'Token Hash': 'টোকেন হ্যাশ',
+    'Updated At': 'হালনাগাদের সময়',
+    'Updated By': 'হালনাগাদ করেছেন',
+    'Used At': 'ব্যবহারের সময়',
+    User: 'ব্যবহারকারী',
+};

package/dist/portal/index.js

@@ -31,9 +31,11 @@ export function createPortal(options = {}) {
         shutro: portalShutro,
         kosh: '^0.1.0',
         depends: [base, contacts, messaging, reporting],
+        // Bangla for the labels it serves (RFC 0023 §3.1; `pnpm i18n:extract`).
+        i18n: { bn: () => import('./i18n/bn.js') },
         accessLevels: { manager: { label: 'Portal access', groups: ['portal.manager'] } },
         externalGroups: ['portal.user'],
-        privateModels: ['portal.invitation', 'portal.signature'],
+        privateModels: ['portal.invitation', 'portal.signature', 'portal.announcement'],
         // "Portal access" on the contact form, under the ways to reach them.
         viewExtensions: [
             {

package/dist/portal/module.d.ts

@@ -1172,6 +1172,16 @@ export declare const portalShutro: import("../server/orm.js").Module<readonly [i
         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;
@@ -1393,6 +1403,16 @@ export declare const portalShutro: import("../server/orm.js").Module<readonly [i
         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/portal/routes-documents.js

@@ -112,6 +112,22 @@ export function registerPortalDocumentRoutes(context) {
                 });
         return out;
     };
+    /** The optional items on offer and whether the document takes them now (RFC 0028 §3.5). */
+    const optionsOf = async (su, d, id) => {
+        const spec = d.spec.options;
+        if (spec === undefined || d.optionModel === null || d.optionParent === null)
+            return {};
+        const offered = await ref(su, d.optionModel.name).search({
+            where: { and: [{ [d.optionParent]: id }, spec.offered] },
+        });
+        const open = (await ref(su, d.model.name).search({ where: { and: [{ id }, spec.when] }, limit: 1 }))
+            .length > 0;
+        return {
+            optionFields: meta(d.optionModel, spec.fields),
+            options: await values(su, d.optionModel, offered.ids, spec.fields),
+            optionsOpen: open,
+        };
+    };
     /** The document as the user sees it: what a signature's hash covers. */
     const documentOfRecord = async (su, d, id) => {
         const [record] = await values(su, d.model, [id], d.spec.fields);
@@ -207,6 +223,7 @@ export function registerPortalDocumentRoutes(context) {
                     ? {}
                     : { lineFields: meta(d.lineModel, d.spec.lines.fields), lines }),
                 actions: await available(su, d, id),
+                ...(await optionsOf(su, d, id)),
                 payable: d.spec.payment !== undefined &&
                     (await ref(su, d.model.name).search({
                         where: { and: [{ id }, d.spec.payment.when] },
@@ -328,6 +345,65 @@ export function registerPortalDocumentRoutes(context) {
         }), { write: true });
         return reply.status(outcome.status).send(outcome.body);
     });
+    // `POST /api/portal/v1/documents/:key/:id/options/:option/add`: the user adds an optional item to their document
+    // while it takes them (RFC 0028 §3.5) — checked as the user, added as the system, on the thread and audited.
+    app.post('/api/portal/v1/documents/:key/:id/options/:option/add', async (request, reply) => {
+        const d = documentOf(request.params);
+        const id = idOf(request.params);
+        const option = Number(request.params['option']);
+        const spec = d.spec.options;
+        if (spec === undefined || d.optionModel === null || d.optionParent === null)
+            throw new HttpProblem(404, 'not-found', 'No options', `${d.spec.label} have no options.`);
+        if (!Number.isSafeInteger(option) || option <= 0)
+            throw new HttpProblem(404, 'not-found', 'No such option', 'No such option.');
+        const optionModel = d.optionModel.name;
+        const parent = d.optionParent;
+        const outcome = await request.env((env) => idempotent(request, env, driver, async () => {
+            portalOnly(env);
+            await mine(env, d, id);
+            const who = await env.asSuperuser({ reason: 'portal option' }, async (su) => {
+                const open = (await ref(su, d.model.name).search({
+                    where: { and: [{ id }, spec.when] },
+                    limit: 1,
+                })).length > 0;
+                const onOffer = (await ref(su, optionModel).search({
+                    where: { and: [{ id: option, [parent]: id }, spec.offered] },
+                    limit: 1,
+                })).length > 0;
+                if (!open || !onOffer)
+                    throw new HttpProblem(409, 'not-available', 'Not possible any more', 'This option cannot be added to this document now.');
+                const [user] = (await ref(su, 'res.users').browse([env.uid]).load(['login', 'name'])).read(['login', 'name']);
+                const [item] = (await ref(su, optionModel).browse([option]).load(['displayName'])).read(['displayName']);
+                return {
+                    login: String(user?.['login'] ?? ''),
+                    name: String(user?.['name'] ?? ''),
+                    item: String(item?.['displayName'] ?? `#${option}`),
+                };
+            });
+            await context.shutro.bootstrap({ reason: `portal ${d.spec.key} option by ${who.login}`, company: env.companyId }, async (su) => {
+                const target = ref(su, optionModel).browse([option]);
+                await target[spec.add].call(target);
+                await postExternalMessage(su, chatter, d.model.name, id, {
+                    text: `${who.name} added “${who.item}” in the portal.`,
+                    authorEmail: who.login,
+                    authorName: who.name,
+                });
+                await audit(su, {
+                    kind: 'portal.option',
+                    summary: `${who.name} (${who.login}) added ${who.item} to ${d.model.name} #${id} in the portal.`,
+                    actor: env.uid,
+                    company: env.companyId,
+                    targetModel: d.model.name,
+                    targetId: id,
+                    details: { option },
+                    ip: request.ip,
+                });
+                await su.flush();
+            });
+            return { status: 200, body: { added: option } };
+        }), { write: true });
+        return reply.status(outcome.status).send(outcome.body);
+    });
     app.get('/api/portal/v1/documents/:key/:id/thread', async (request) => {
         const d = documentOf(request.params);
         const id = idOf(request.params);

package/dist/pos/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: b37d814de9d07c51
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: fff35eedcd283a0e
 // Bindings of module `pos`: 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';