shutro-erp 0.3.3 → 0.3.5

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

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 96928facddb91996
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 390fefb5f47e15fa
 // 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';
 
@@ -15,7 +15,9 @@ export interface SchemaView {
   readonly 'auth.session': AuthSession;
   readonly 'auth.user_grant': AuthUserGrant;
   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;
@@ -23,6 +25,10 @@ export interface SchemaView {
   readonly 'mail.follower': MailFollower;
   readonly 'mail.message': MailMessage;
   readonly 'mail.message.reaction': MailMessageReaction;
+  readonly 'oauth.app': OauthApp;
+  readonly 'oauth.code': OauthCode;
+  readonly 'oauth.grant': OauthGrant;
+  readonly 'oauth.token': OauthToken;
   readonly 'product.category': ProductCategory;
   readonly 'product.product': ProductProduct;
   readonly 'purchase.order': PurchaseOrder;
@@ -30,6 +36,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;
@@ -312,6 +319,29 @@ export interface AuthUserGroup {
 export interface AuthUserGroupMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'auth.user_group'> {
 }
 
+/** `kosh.image` (owner: base). */
+export interface KoshImage {
+  readonly name: 'kosh.image';
+  readonly fields: {
+    readonly id: F.Id<'kosh.image'>;
+    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 ownerModel: F.Char<{ readonly required: true }>;
+    readonly ownerId: F.Integer<{ readonly required: true }>;
+    readonly mime: F.Char<{ readonly required: true }>;
+    readonly data: F.Text<{ readonly required: true }>;
+    readonly hash: F.Char<{ readonly required: true }>;
+  };
+  readonly methods: KoshImageMethods;
+}
+
+/** Methods of `kosh.image`: declared ones and transitions. */
+export interface KoshImageMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'kosh.image'> {
+}
+
 /** `kosh.saved_view` (owner: base). */
 export interface KoshSavedView {
   readonly name: 'kosh.saved_view';
@@ -336,6 +366,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';
@@ -514,6 +564,105 @@ export interface MailMessageReaction {
 export interface MailMessageReactionMethods extends F.Methods<typeof import('../../messaging/index.js').messagingShutro, 'mail.message.reaction'> {
 }
 
+/** `oauth.app` (owner: base). */
+export interface OauthApp {
+  readonly name: 'oauth.app';
+  readonly fields: {
+    readonly id: F.Id<'oauth.app'>;
+    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 clientId: F.Char<{ readonly required: true }>;
+    readonly secretHash: F.Char;
+    readonly confidential: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly redirectUris: F.Text<{ readonly required: true }>;
+    readonly scopes: F.Char<{ readonly required: true }>;
+    readonly homepage: F.Char;
+    readonly active: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly owner: F.Many2one<'res.users'>;
+  };
+  readonly methods: OauthAppMethods;
+}
+
+/** Methods of `oauth.app`: declared ones and transitions. */
+export interface OauthAppMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.app'> {
+}
+
+/** `oauth.code` (owner: base). */
+export interface OauthCode {
+  readonly name: 'oauth.code';
+  readonly fields: {
+    readonly id: F.Id<'oauth.code'>;
+    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 codeHash: F.Char<{ readonly required: true }>;
+    readonly grant: F.Many2one<'oauth.grant', { readonly required: true }>;
+    readonly redirectUri: F.Char<{ readonly required: true }>;
+    readonly challenge: F.Char;
+    readonly expiresAt: F.Datetime<{ readonly required: true }>;
+    readonly used: F.Bool<{ readonly required: true; readonly default: true }>;
+  };
+  readonly methods: OauthCodeMethods;
+}
+
+/** Methods of `oauth.code`: declared ones and transitions. */
+export interface OauthCodeMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.code'> {
+}
+
+/** `oauth.grant` (owner: base). */
+export interface OauthGrant {
+  readonly name: 'oauth.grant';
+  readonly fields: {
+    readonly id: F.Id<'oauth.grant'>;
+    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 app: F.Many2one<'oauth.app', { readonly required: true }>;
+    readonly scopes: F.Char<{ readonly required: true }>;
+    readonly revoked: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly lastUsedAt: F.Datetime;
+  };
+  readonly methods: OauthGrantMethods;
+}
+
+/** Methods of `oauth.grant`: declared ones and transitions. */
+export interface OauthGrantMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.grant'> {
+}
+
+/** `oauth.token` (owner: base). */
+export interface OauthToken {
+  readonly name: 'oauth.token';
+  readonly fields: {
+    readonly id: F.Id<'oauth.token'>;
+    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 grant: F.Many2one<'oauth.grant', { readonly required: true }>;
+    readonly accessHash: F.Char<{ readonly required: true }>;
+    readonly refreshHash: F.Char<{ readonly required: true }>;
+    readonly accessExpiresAt: F.Datetime<{ readonly required: true }>;
+    readonly refreshExpiresAt: F.Datetime<{ readonly required: true }>;
+    readonly revoked: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly rotated: F.Bool<{ readonly required: true; readonly default: true }>;
+  };
+  readonly methods: OauthTokenMethods;
+}
+
+/** Methods of `oauth.token`: declared ones and transitions. */
+export interface OauthTokenMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.token'> {
+}
+
 /** `product.category` (owner: product). */
 export interface ProductCategory {
   readonly name: 'product.category';
@@ -551,6 +700,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 }>;
@@ -639,7 +789,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: {
@@ -659,12 +809,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). */
@@ -701,6 +854,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 }>;
@@ -726,6 +883,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';
@@ -771,6 +947,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, {