shutro-erp 0.3.4 → 0.3.6

package/dist/project_purchase/module.js

@@ -0,0 +1,56 @@
+/**
+ * The data layer of the Projects ↔ Purchase bridge (RFC 0026 step 4): the untaxed lines of confirmed purchase orders
+ * on a project's cost centre that are not billed yet are its **committed costs**; once billed and posted they are
+ * booked instead (`project_account`), so nothing counts twice.
+ */
+import { projectShutro } from '../project/index.js';
+import { projectAccountShutro } from '../project_account/index.js';
+import { purchaseAccountShutro } from '../purchase_account/index.js';
+import { orm } from '../server/orm.js';
+import { defineModule, extendModel } from './.kosh/bindings.js';
+const ZERO = orm.toDecimal(0);
+export const ProjectCommitted = extendModel('project.project', {
+    overrides: {
+        moneyOf: async function (next) {
+            // After project_account's: the cost centres exist.
+            const out = await next();
+            const projects = this;
+            const env = projects.env;
+            for (const p of await projects.load({ analytic: true })) {
+                if (p.analytic === null)
+                    continue;
+                const lines = await env
+                    .model('purchase.order.line')
+                    .search({
+                    where: {
+                        analytic: p.analytic.id,
+                        'order.state': { in: ['purchase', 'done'] },
+                        'order.billState': { ne: 'billed' },
+                    },
+                })
+                    .then((r) => r.load(['subtotal']));
+                const committed = [...lines].reduce((s, l) => s.plus(l.subtotal?.amount ?? ZERO), ZERO);
+                const before = out.get(p.id) ?? { booked: '0', committed: '0' };
+                out.set(p.id, {
+                    booked: before.booked,
+                    committed: orm.toDecimal(before.committed).plus(committed).toFixed(2),
+                });
+            }
+            return out;
+        },
+    },
+});
+export const projectPurchaseShutro = defineModule({
+    name: 'project_purchase',
+    version: '0.1.0',
+    depends: [projectShutro, projectAccountShutro, purchaseAccountShutro],
+    groups: [
+        orm.defineGroup({
+            code: 'project_purchase.user',
+            label: 'Projects with their purchases',
+            implies: ['project_account.user', 'purchase.user'],
+        }),
+    ],
+    models: [],
+    extensions: [ProjectCommitted],
+});

package/dist/purchase/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: f0906f628180e9a5
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: ca13902b51545168
 // Bindings of module `purchase`: 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/purchase/.kosh/schema.d.ts

@@ -1,13 +1,16 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: f0906f628180e9a5
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: ca13902b51545168
 // Schema view of module `purchase` (RFC 0002 §7.7): the models it owns or depends on, with the extensions it can see.
 import type { F } from '../../server/orm.js';
 
 /** Model name → model type (RFC 0002 §7.7). */
 export interface SchemaView {
   readonly 'account.tax': AccountTax;
+  readonly 'approval.delegation': ApprovalDelegation;
   readonly 'approval.level': ApprovalLevel;
+  readonly 'approval.link': ApprovalLink;
   readonly 'approval.policy': ApprovalPolicy;
   readonly 'approval.request': ApprovalRequest;
+  readonly 'approval.vote': ApprovalVote;
   readonly 'audit.event': AuditEvent;
   readonly 'auth.api_key': AuthApiKey;
   readonly 'auth.credential': AuthCredential;
@@ -17,6 +20,7 @@ export interface SchemaView {
   readonly 'auth.user_group': AuthUserGroup;
   readonly 'kosh.image': KoshImage;
   readonly 'kosh.saved_view': KoshSavedView;
+  readonly 'kosh.setting': KoshSetting;
   readonly 'mail.activity': MailActivity;
   readonly 'mail.activity.type': MailActivityType;
   readonly 'mail.channel': MailChannel;
@@ -35,6 +39,7 @@ export interface SchemaView {
   readonly 'res.company': ResCompany;
   readonly 'res.currency': ResCurrency;
   readonly 'res.partner': ResPartner;
+  readonly 'res.partner.tag': ResPartnerTag;
   readonly 'res.users': ResUsers;
   readonly 'storage.attachment': StorageAttachment;
   readonly 'uom.uom': UomUom;
@@ -68,6 +73,29 @@ export interface AccountTax {
 export interface AccountTaxMethods extends F.Methods<typeof import('../../product/index.js').productShutro, 'account.tax'> {
 }
 
+/** `approval.delegation` (owner: permissions). */
+export interface ApprovalDelegation {
+  readonly name: 'approval.delegation';
+  readonly fields: {
+    readonly id: F.Id<'approval.delegation'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true; readonly default: true }>;
+    readonly delegate: F.Many2one<'res.users', { readonly required: true }>;
+    readonly dateFrom: F.DateOnly<{ readonly required: true }>;
+    readonly dateTo: F.DateOnly<{ readonly required: true }>;
+    readonly note: F.Char;
+  };
+  readonly methods: ApprovalDelegationMethods;
+}
+
+/** Methods of `approval.delegation`: declared ones and transitions. */
+export interface ApprovalDelegationMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.delegation'> {
+}
+
 /** `approval.level` (owner: permissions). */
 export interface ApprovalLevel {
   readonly name: 'approval.level';
@@ -82,7 +110,14 @@ export interface ApprovalLevel {
     readonly sequence: F.Integer<{ readonly default: true }>;
     readonly name: F.Char<{ readonly required: true }>;
     readonly condition: F.Json;
-    readonly approverRole: F.Char<{ readonly required: true }>;
+    readonly approverKind: F.Selection<'role' | 'users' | 'manager' | 'field', { readonly required: true; readonly default: true }>;
+    readonly approverRole: F.Char;
+    readonly approverUsers: F.Many2many<'res.users', { readonly required: true }>;
+    readonly approverField: F.Char;
+    readonly quorum: F.Selection<'any' | 'all' | 'count', { readonly required: true; readonly default: true }>;
+    readonly quorumCount: F.Integer;
+    readonly deadlineHours: F.Integer;
+    readonly escalateRole: F.Char;
   };
   readonly methods: ApprovalLevelMethods;
 }
@@ -91,6 +126,29 @@ export interface ApprovalLevel {
 export interface ApprovalLevelMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.level'> {
 }
 
+/** `approval.link` (owner: permissions). */
+export interface ApprovalLink {
+  readonly name: 'approval.link';
+  readonly fields: {
+    readonly id: F.Id<'approval.link'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly request: F.Many2one<'approval.request', { readonly required: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true }>;
+    readonly tokenHash: F.Char<{ readonly required: true }>;
+    readonly expiresAt: F.Datetime<{ readonly required: true }>;
+    readonly usedAt: F.Datetime;
+  };
+  readonly methods: ApprovalLinkMethods;
+}
+
+/** Methods of `approval.link`: declared ones and transitions. */
+export interface ApprovalLinkMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.link'> {
+}
+
 /** `approval.policy` (owner: permissions). */
 export interface ApprovalPolicy {
   readonly name: 'approval.policy';
@@ -108,6 +166,9 @@ export interface ApprovalPolicy {
     readonly company: F.Many2one<'res.company'>;
     readonly onApproved: F.Char;
     readonly onRejected: F.Char;
+    readonly onSentBack: F.Char;
+    readonly onWithdrawn: F.Char;
+    readonly reasonRequired: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly levels: F.One2many<'approval.level', { readonly required: true }>;
   };
   readonly methods: ApprovalPolicyMethods;
@@ -134,8 +195,16 @@ export interface ApprovalRequest {
     readonly targetModel: F.Char<{ readonly required: true }>;
     readonly targetId: F.Integer<{ readonly required: true }>;
     readonly company: F.Many2one<'res.company'>;
-    readonly approverRole: F.Char<{ readonly required: true }>;
-    readonly state: F.Selection<'pending' | 'approved' | 'rejected' | 'cancelled', { readonly required: true; readonly default: true }>;
+    readonly approverRole: F.Char;
+    readonly approvers: F.Many2many<'res.users', { readonly required: true }>;
+    readonly required: F.Integer<{ readonly required: true; readonly default: true }>;
+    readonly round: F.Integer<{ readonly required: true; readonly default: true }>;
+    readonly votes: F.One2many<'approval.vote', { readonly required: true }>;
+    readonly dueAt: F.Datetime;
+    readonly remindedAt: F.Datetime;
+    readonly escalatedTo: F.Char;
+    readonly escalatedAt: F.Datetime;
+    readonly state: F.Selection<'pending' | 'approved' | 'rejected' | 'sent_back' | 'cancelled', { readonly required: true; readonly default: true }>;
     readonly requestedBy: F.Many2one<'res.users'>;
     readonly decidedBy: F.Many2one<'res.users'>;
     readonly decidedAt: F.Datetime;
@@ -148,6 +217,31 @@ export interface ApprovalRequest {
 export interface ApprovalRequestMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.request'> {
 }
 
+/** `approval.vote` (owner: permissions). */
+export interface ApprovalVote {
+  readonly name: 'approval.vote';
+  readonly fields: {
+    readonly id: F.Id<'approval.vote'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly request: F.Many2one<'approval.request', { readonly required: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true }>;
+    readonly decision: F.Selection<'approve' | 'reject' | 'send_back', { readonly required: true }>;
+    readonly comment: F.Text;
+    readonly at: F.Datetime<{ readonly required: true }>;
+    readonly onBehalfOf: F.Many2one<'res.users'>;
+    readonly ip: F.Char;
+  };
+  readonly methods: ApprovalVoteMethods;
+}
+
+/** Methods of `approval.vote`: declared ones and transitions. */
+export interface ApprovalVoteMethods extends F.Methods<typeof import('../../permissions/index.js').permissionsShutro, 'approval.vote'> {
+}
+
 /** `audit.event` (owner: base). */
 export interface AuditEvent {
   readonly name: 'audit.event';
@@ -364,6 +458,26 @@ export interface KoshSavedView {
 export interface KoshSavedViewMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'kosh.saved_view'> {
 }
 
+/** `kosh.setting` (owner: base). */
+export interface KoshSetting {
+  readonly name: 'kosh.setting';
+  readonly fields: {
+    readonly id: F.Id<'kosh.setting'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly key: F.Char<{ readonly required: true }>;
+    readonly value: F.Json;
+  };
+  readonly methods: KoshSettingMethods;
+}
+
+/** Methods of `kosh.setting`: declared ones and transitions. */
+export interface KoshSettingMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'kosh.setting'> {
+}
+
 /** `mail.activity` (owner: messaging). */
 export interface MailActivity {
   readonly name: 'mail.activity';
@@ -651,6 +765,7 @@ export interface ProductCategory {
     readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
     readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
     readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly active: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly name: F.Char<{ readonly required: true; readonly translate: true }>;
     readonly parent: F.Many2one<'product.category'>;
   };
@@ -678,6 +793,7 @@ export interface ProductProduct {
     readonly category: F.Many2one<'product.category'>;
     readonly uom: F.Many2one<'uom.uom'>;
     readonly barcode: F.Char;
+    readonly image: F.Many2one<'storage.attachment'>;
     readonly listPrice: F.Decimal<{ readonly required: true; readonly default: true }>;
     readonly standardPrice: F.Decimal<{ readonly required: true; readonly default: true }>;
     readonly saleOk: F.Bool<{ readonly required: true; readonly default: true }>;
@@ -766,7 +882,7 @@ export interface PurchaseOrderLine {
 export interface PurchaseOrderLineMethods extends F.Methods<typeof import('../module.js').purchaseShutro, 'purchase.order.line'> {
 }
 
-/** `res.company` (owner: base). */
+/** `res.company` (owner: base; extended by: contacts, purchase). */
 export interface ResCompany {
   readonly name: 'res.company';
   readonly fields: {
@@ -786,12 +902,15 @@ export interface ResCompany {
     readonly email: F.Char;
     readonly phone: F.Char;
     readonly website: F.Char;
+    readonly contactTaxIdRequired: F.Bool<{ readonly required: true; readonly default: true }>; // contacts
+    readonly contactUniqueEmail: F.Bool<{ readonly required: true; readonly default: true }>; // contacts
+    readonly purchaseTerms: F.Text; // purchase
   };
   readonly methods: ResCompanyMethods;
 }
 
 /** Methods of `res.company`: declared ones and transitions. */
-export interface ResCompanyMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'res.company'> {
+export interface ResCompanyMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'res.company'>, F.Methods<typeof import('../../contacts/index.js').contactsShutro, 'res.company'>, F.Methods<typeof import('../module.js').purchaseShutro, 'res.company'> {
 }
 
 /** `res.currency` (owner: base). */
@@ -828,6 +947,10 @@ export interface ResPartner {
     readonly active: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly company: F.Many2one<'res.company', { readonly default: true }>;
     readonly name: F.Char<{ readonly required: true }>;
+    readonly image: F.Many2one<'storage.attachment'>;
+    readonly tags: F.Many2many<'res.partner.tag', { readonly required: true }>;
+    readonly latitude: F.Decimal;
+    readonly longitude: F.Decimal;
     readonly isCompany: F.Bool<{ readonly required: true; readonly default: true }>;
     readonly parent: F.Many2one<'res.partner'>;
     readonly contacts: F.One2many<'res.partner', { readonly required: true }>;
@@ -853,6 +976,25 @@ export interface ResPartner {
 export interface ResPartnerMethods extends F.Methods<typeof import('../../contacts/index.js').contactsShutro, 'res.partner'> {
 }
 
+/** `res.partner.tag` (owner: contacts). */
+export interface ResPartnerTag {
+  readonly name: 'res.partner.tag';
+  readonly fields: {
+    readonly id: F.Id<'res.partner.tag'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly name: F.Char<{ readonly required: true }>;
+  };
+  readonly methods: ResPartnerTagMethods;
+}
+
+/** Methods of `res.partner.tag`: declared ones and transitions. */
+export interface ResPartnerTagMethods extends F.Methods<typeof import('../../contacts/index.js').contactsShutro, 'res.partner.tag'> {
+}
+
 /** `res.users` (owner: base). */
 export interface ResUsers {
   readonly name: 'res.users';
@@ -898,6 +1040,8 @@ export interface StorageAttachment {
     readonly key: F.Char<{ readonly required: true }>;
     readonly resModel: F.Char<{ readonly required: true }>;
     readonly resId: F.Integer<{ readonly required: true }>;
+    readonly variantOf: F.Many2one<'storage.attachment'>;
+    readonly width: F.Integer;
   };
   readonly methods: StorageAttachmentMethods;
 }

package/dist/purchase/index.js

@@ -9,7 +9,8 @@ import { messaging } from '../messaging/index.js';
 import { defineModule } from '../modules-sdk/index.js';
 import { permissions } from '../permissions/index.js';
 import { product } from '../product/index.js';
-import { action, form, kanban, list, search } from '../views/index.js';
+import { reporting } from '../reporting/index.js';
+import { action, calendar, form, kanban, list, search, stat } from '../views/index.js';
 import { purchaseDemo } from './demo.js';
 import { PurchaseOrder, purchaseShutro } from './module.js';
 export { PurchaseOrder, PurchaseOrderLine, purchaseShutro } from './module.js';
@@ -17,7 +18,14 @@ export const purchase = defineModule({
     shutro: purchaseShutro,
     kosh: '^0.1.0',
     hooks: { demo: purchaseDemo },
-    depends: [contacts, product, messaging, permissions],
+    depends: [contacts, product, messaging, permissions, reporting],
+    events: [
+        {
+            topic: 'purchase.order.confirmed',
+            model: 'purchase.order',
+            label: 'Purchase order confirmed',
+        },
+    ],
     app: {
         code: 'purchase',
         label: 'Purchase',
@@ -31,6 +39,22 @@ export const purchase = defineModule({
         manager: { label: 'Manager (all orders)', groups: ['purchase.manager'], implies: ['user'] },
         director: { label: 'Director', groups: ['purchase.director'], implies: ['manager'] },
     },
+    // Settings › App settings › Purchase (RFC 0020): per company, changed by purchase managers.
+    settings: {
+        sections: [
+            {
+                key: 'orders',
+                label: 'Purchase orders',
+                description: 'The terms new requests for quotation and purchase orders start with.',
+                keywords: 'purchase order rfq terms conditions vendor',
+                scope: 'company',
+                editors: ['purchase.manager'],
+                fields: [
+                    { key: 'purchaseTerms', help: 'Filled in on new orders; each can still be changed.' },
+                ],
+            },
+        ],
+    },
     approvals: [
         {
             name: 'Purchase approvals',
@@ -51,6 +75,134 @@ export const purchase = defineModule({
             ],
         },
     ],
+    // The Overview (RFC 0022 step 2): spend against last month, what waits, who we buy from.
+    overview: {
+        cards: [
+            {
+                id: 'spend_month',
+                title: 'Purchases this month',
+                kind: 'kpi',
+                model: 'purchase.order',
+                measure: 'sum:amountTotal',
+                filter: { state: { in: ['purchase', 'done'] } },
+                comparison: { field: 'dateOrder', mode: 'previous' },
+                w: 3,
+            },
+            {
+                id: 'orders_month',
+                title: 'Orders this month',
+                kind: 'kpi',
+                model: 'purchase.order',
+                measure: 'count',
+                filter: { state: { in: ['purchase', 'done'] } },
+                comparison: { field: 'dateOrder', mode: 'previous' },
+                w: 3,
+            },
+            {
+                id: 'open_rfqs',
+                title: 'Open requests',
+                kind: 'kpi',
+                model: 'purchase.order',
+                measure: 'count',
+                filter: { state: { in: ['draft', 'sent'] } },
+                w: 3,
+            },
+            {
+                id: 'to_approve',
+                title: 'Waiting approval',
+                kind: 'kpi',
+                model: 'purchase.order',
+                measure: 'count',
+                filter: { state: 'to_approve' },
+                w: 3,
+            },
+            {
+                id: 'spend_by_month',
+                title: 'Purchases by month',
+                kind: 'chart',
+                model: 'purchase.order',
+                measure: 'sum:amountTotal',
+                groupBy: 'dateOrder:month',
+                filter: { state: { in: ['purchase', 'done'] } },
+                chart: 'bar',
+                w: 6,
+            },
+            {
+                id: 'top_vendors',
+                title: 'Top vendors',
+                kind: 'pivot',
+                model: 'purchase.order',
+                measure: 'sum:amountTotal',
+                groupBy: 'partner',
+                filter: { state: { in: ['purchase', 'done'] } },
+                w: 6,
+            },
+            {
+                id: 'by_buyer',
+                title: 'By buyer',
+                kind: 'chart',
+                model: 'purchase.order',
+                measure: 'sum:amountTotal',
+                groupBy: 'user',
+                filter: { state: { in: ['purchase', 'done'] } },
+                chart: 'pie',
+                w: 6,
+            },
+            {
+                id: 'biggest_open',
+                title: 'Biggest open requests',
+                kind: 'list',
+                model: 'purchase.order',
+                measure: 'sum:amountTotal',
+                filter: { state: { in: ['draft', 'sent', 'to_approve'] } },
+                w: 6,
+            },
+        ],
+    },
+    viewExtensions: [
+        {
+            view: 'product.product.form',
+            operations: [
+                {
+                    append: 'related',
+                    nodes: [
+                        stat({
+                            id: 'product_bought',
+                            label: 'Bought',
+                            model: 'purchase.order.line',
+                            where: { product: { $record: 'id' }, 'order.state': { in: ['purchase', 'done'] } },
+                            measure: { sum: 'quantity' },
+                        }),
+                    ],
+                },
+            ],
+        },
+        {
+            view: 'res.partner.form',
+            operations: [
+                {
+                    append: 'related',
+                    nodes: [
+                        stat({
+                            id: 'purchase_orders',
+                            label: 'Purchase orders',
+                            model: PurchaseOrder,
+                            where: { partner: { $record: 'id' }, state: { in: ['purchase', 'done'] } },
+                            action: 'purchase.action_orders',
+                        }),
+                        stat({
+                            id: 'purchase_spend',
+                            label: 'Purchases',
+                            model: PurchaseOrder,
+                            where: { partner: { $record: 'id' }, state: { in: ['purchase', 'done'] } },
+                            measure: { sum: 'amountTotal' },
+                            action: 'purchase.action_orders',
+                        }),
+                    ],
+                },
+            ],
+        },
+    ],
     actions: {
         'purchase.action_rfqs': action(PurchaseOrder, {
             label: 'Requests for quotation',
@@ -59,7 +211,7 @@ export const purchase = defineModule({
         }),
         'purchase.action_orders': action(PurchaseOrder, {
             label: 'Purchase orders',
-            views: ['list', 'kanban', 'form'],
+            views: ['list', 'kanban', 'calendar', 'form'],
             defaultFilters: ['orders'],
         }),
         'purchase.action_to_approve': action(PurchaseOrder, {
@@ -138,6 +290,8 @@ export const purchase = defineModule({
                 ],
             },
             sheet: [
+                // Bills and receipts: the bridges append their tiles (RFC 0022 §3.1).
+                k.stats('related', []),
                 k.group('vendor', ['partner', 'partnerReference', 'currency']),
                 k.group('dates', ['name', 'dateOrder', 'datePlanned', 'user', 'origin']),
                 k.lines('lines', [
@@ -157,6 +311,12 @@ export const purchase = defineModule({
             readonlyWhen: { state: { in: ['done', 'cancel'] } },
             chatter: true,
         })),
+        'purchase.order.calendar': calendar(PurchaseOrder, {
+            dateStart: 'datePlanned',
+            title: 'name',
+            color: 'state',
+            mode: 'month',
+        }),
     },
     search: {
         'purchase.order': search(PurchaseOrder, {