shutro-erp 0.3.3 → 0.3.5

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

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 25d6271e4bd2aa40
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 32f956c99138a8eb
 // Schema view of module `project` (RFC 0002 §7.7): the models it owns or depends on, with the extensions it can see.
 import type { F } from '../../server/orm.js';
 
@@ -11,7 +11,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;
@@ -19,6 +21,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 'project.project': ProjectProject;
   readonly 'project.task': ProjectTask;
   readonly 'project.task.stage': ProjectTaskStage;
@@ -26,6 +32,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;
 }
@@ -199,6 +206,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';
@@ -223,6 +253,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';
@@ -401,6 +451,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'> {
+}
+
 /** `project.project` (owner: project). */
 export interface ProjectProject {
   readonly name: 'project.project';
@@ -511,7 +660,7 @@ export interface ProjectTimesheet {
 export interface ProjectTimesheetMethods extends F.Methods<typeof import('../module.js').projectShutro, 'project.timesheet'> {
 }
 
-/** `res.company` (owner: base). */
+/** `res.company` (owner: base; extended by: contacts, project). */
 export interface ResCompany {
   readonly name: 'res.company';
   readonly fields: {
@@ -531,12 +680,16 @@ 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 projectPlannedHoursDefault: F.Decimal; // project
+    readonly projectTimesheetStep: F.Selection<'none' | 'quarter' | 'half' | 'whole', { readonly default: true }>; // project
   };
   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').projectShutro, 'res.company'> {
 }
 
 /** `res.currency` (owner: base). */
@@ -573,6 +726,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 }>;
@@ -598,6 +755,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';
@@ -643,6 +819,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/project/index.js

@@ -7,7 +7,8 @@
 import { contacts } from '../contacts/index.js';
 import { messaging } from '../messaging/index.js';
 import { defineModule } from '../modules-sdk/index.js';
-import { action, calendar, form, kanban, list, pivot, search } from '../views/index.js';
+import { reporting } from '../reporting/index.js';
+import { action, calendar, form, gantt, kanban, list, pivot, search } from '../views/index.js';
 import { projectDemo, SUPPORT_PROJECT } from './demo.js';
 import { ProjectProject, ProjectTask, ProjectTaskStage, ProjectTimesheet, projectShutro, } from './module.js';
 export { SUPPORT_PROJECT } from './demo.js';
@@ -16,6 +17,30 @@ export const project = defineModule({
     shutro: projectShutro,
     kosh: '^0.1.0',
     hooks: { demo: projectDemo },
+    // Defaults for tasks and timesheets (RFC 0020), per company.
+    settings: {
+        sections: [
+            {
+                key: 'work',
+                label: 'Tasks and timesheets',
+                description: 'What new tasks start with, and the steps timesheets are entered in.',
+                keywords: 'planned hours timesheet rounding step quarter half',
+                scope: 'company',
+                editors: ['project.manager'],
+                fields: [
+                    {
+                        key: 'projectPlannedHoursDefault',
+                        min: 0,
+                        help: 'Filled in on a new task when its project is chosen; each task can still be changed.',
+                    },
+                    {
+                        key: 'projectTimesheetStep',
+                        help: 'Hours that are not a multiple of the step are refused.',
+                    },
+                ],
+            },
+        ],
+    },
     // support@<inbound domain>: a task in the support project (RFC 0006 §7.1), or the first project there is.
     inboundAliases: [
         {
@@ -34,7 +59,7 @@ export const project = defineModule({
             },
         },
     ],
-    depends: [contacts, messaging],
+    depends: [contacts, messaging, reporting],
     app: {
         code: 'projects',
         label: 'Projects',
@@ -51,10 +76,89 @@ export const project = defineModule({
             implies: ['user'],
         },
     },
+    // The Overview (RFC 0022 step 2): what is open, where the hours go, who carries the load.
+    overview: {
+        cards: [
+            {
+                id: 'projects_all',
+                title: 'Projects',
+                kind: 'kpi',
+                model: 'project.project',
+                measure: 'count',
+                w: 3,
+            },
+            {
+                id: 'open_tasks',
+                title: 'Open tasks',
+                kind: 'kpi',
+                model: 'project.task',
+                measure: 'count',
+                filter: { 'stage.done': false },
+                w: 3,
+            },
+            {
+                id: 'hours_month',
+                title: 'Hours this month',
+                kind: 'kpi',
+                model: 'project.timesheet',
+                measure: 'sum:hours',
+                comparison: { field: 'date', mode: 'previous' },
+                w: 3,
+            },
+            {
+                id: 'planned_open',
+                title: 'Planned hours open',
+                kind: 'kpi',
+                model: 'project.task',
+                measure: 'sum:plannedHours',
+                filter: { 'stage.done': false },
+                w: 3,
+            },
+            {
+                id: 'tasks_by_stage',
+                title: 'Tasks by stage',
+                kind: 'chart',
+                model: 'project.task',
+                measure: 'count',
+                groupBy: 'stage',
+                chart: 'bar',
+                w: 6,
+            },
+            {
+                id: 'hours_by_project',
+                title: 'Hours by project',
+                kind: 'chart',
+                model: 'project.timesheet',
+                measure: 'sum:hours',
+                groupBy: 'project',
+                chart: 'pie',
+                w: 6,
+            },
+            {
+                id: 'load_by_person',
+                title: 'Open tasks by person',
+                kind: 'chart',
+                model: 'project.task',
+                measure: 'count',
+                groupBy: 'assignee',
+                filter: { 'stage.done': false },
+                chart: 'bar',
+                w: 6,
+            },
+            {
+                id: 'busiest',
+                title: 'Projects with most hours',
+                kind: 'list',
+                model: 'project.project',
+                measure: 'sum:hours',
+                w: 6,
+            },
+        ],
+    },
     actions: {
         'projects.action_projects': action(ProjectProject, {
             label: 'Projects',
-            views: ['list', 'form'],
+            views: ['list', 'gantt', 'form'],
         }),
         'projects.action_tasks': action(ProjectTask, {
             label: 'Tasks',
@@ -116,6 +220,31 @@ export const project = defineModule({
         'project.project.form': form(ProjectProject, (k) => ({
             header: { buttons: [] },
             sheet: [
+                k.stats('related', [
+                    {
+                        id: 'project_tasks',
+                        label: 'Tasks',
+                        model: ProjectTask,
+                        where: { project: { $record: 'id' } },
+                        action: 'projects.action_tasks',
+                    },
+                    {
+                        id: 'project_open_tasks',
+                        label: 'Open',
+                        model: ProjectTask,
+                        where: { project: { $record: 'id' }, 'stage.done': false },
+                        action: 'projects.action_tasks',
+                        tone: 'warning',
+                    },
+                    {
+                        id: 'project_hours',
+                        label: 'Hours',
+                        model: ProjectTimesheet,
+                        where: { project: { $record: 'id' } },
+                        measure: { sum: 'hours' },
+                        action: 'projects.action_timesheets',
+                    },
+                ]),
                 k.group('main', ['name', 'partner', 'manager', 'sequence']),
                 k.group('dates', ['dateStart', 'dateEnd', 'taskCount', 'hours']),
                 k.group('about', ['description'], { columns: 1 }),
@@ -135,18 +264,29 @@ export const project = defineModule({
             card: {
                 title: 'name',
                 subtitle: 'project',
-                footer: ['assignee', 'deadline'],
-                badges: [{ field: 'priority', widget: 'badge' }],
+                avatar: 'assignee',
+                color: 'project',
+                footer: [
+                    { field: 'deadline', widget: 'daysLeft' },
+                    { field: 'priority', widget: 'priority' },
+                ],
             },
         }),
+        // Projects on a timeline, from their start to their deadline.
+        'project.project.gantt': gantt(ProjectProject, {
+            dateStart: 'dateStart',
+            dateStop: 'dateEnd',
+            title: 'name',
+            scale: 'week',
+        }),
         'project.task.list': list(ProjectTask, {
             columns: [
                 'name',
                 'project',
                 'stage',
                 'assignee',
-                'deadline',
-                { field: 'priority', widget: 'badge' },
+                { field: 'deadline', widget: 'daysLeft' },
+                { field: 'priority', widget: 'priority' },
                 { field: 'plannedHours', sum: true },
                 { field: 'effectiveHours', sum: true },
             ],