shutro-erp 0.3.4 → 0.3.6

package/dist/accounting/index.js

@@ -18,15 +18,15 @@ import { permissions } from '../permissions/index.js';
 import { product } from '../product/index.js';
 import { reporting } from '../reporting/index.js';
 import { HttpProblem } from '../server/index.js';
-import { action, field, form, list, pivot, search } from '../views/index.js';
+import { action, field, form, hierarchy, list, pivot, search, stat } from '../views/index.js';
 import { ChartInstalledError, chartsOf, installChart, installedChart, installImmutability, installLocalization, localizationsOf, } from './chart.js';
 import { agingReport, closeFiscalYear, readSettings, reopenFiscalYear, updateSettings, } from './closing.js';
 import { accountingDemo } from './demo.js';
-import { AccountAccount, AccountFiscalYear, AccountJournal, AccountMove, AccountMoveLine, AccountPayment, AccountPaymentTerm, AccountWithholding, accountingShutro, REVERSED_KIND, ResBankAccount, ResCurrencyRate, } from './module.js';
+import { AccountAccount, AccountAnalytic, AccountFiscalYear, AccountJournal, AccountMove, AccountMoveLine, AccountPayment, AccountPaymentTerm, AccountWithholding, accountingShutro, REVERSED_KIND, ResBankAccount, ResCurrencyRate, } from './module.js';
 import { openLines, proposeWithholdings, reconcile, registerPayment, unreconcile, } from './payments.js';
 export { CHARTS, ChartInstalledError, COMMON_ACCOUNTS, chartsOf, DEFAULT_ACCOUNTS, installChart, installedChart, installImmutability, installLocalization, localizationsOf, } from './chart.js';
 export { agingReport, closeFiscalYear, readSettings, reopenFiscalYear, updateSettings, } from './closing.js';
-export { ACCOUNT_TYPES, AccountAccount, AccountFiscalYear, AccountFullReconcile, AccountJournal, AccountMove, AccountMoveLine, AccountPartialReconcile, AccountPayment, AccountPaymentTerm, AccountPaymentTermLine, AccountPaymentWithholding, AccountTaxComponent, AccountWithholding, accountingShutro, addDays, CompanyAccounting, fiscalYearOf, isRefund, JOURNAL_TYPES, MOVE_KINDS, NUMBER_FIELD, owedToUs, PartnerWithholdings, REVERSED_KIND, ResBankAccount, ResCurrencyRate, supplyScope, TaxAccounts, } from './module.js';
+export { ACCOUNT_TYPES, AccountAccount, AccountAnalytic, AccountFiscalYear, AccountFullReconcile, AccountJournal, AccountMove, AccountMoveLine, AccountPartialReconcile, AccountPayment, AccountPaymentTerm, AccountPaymentTermLine, AccountPaymentWithholding, AccountTaxComponent, AccountWithholding, accountingShutro, addDays, CompanyAccounting, fiscalYearOf, isRefund, JOURNAL_TYPES, MOVE_KINDS, NUMBER_FIELD, owedToUs, PartnerWithholdings, REVERSED_KIND, ResBankAccount, ResCurrencyRate, supplyScope, TaxAccounts, } from './module.js';
 export { openLines, proposeWithholdings, reconcile, registerPayment, unreconcile, } from './payments.js';
 /**
  * Reverses a posted entry: a new entry in the same journal with every line negated, linked both ways, posted when
@@ -106,6 +106,26 @@ export async function reverseMove(env, id, options = {}) {
 export const accounting = defineModule({
     shutro: accountingShutro,
     kosh: '^0.1.0',
+    // Exceptions to the module standard (RFC 0023), each with its reason.
+    standard: {
+        waive: [
+            {
+                rule: 'M3',
+                model: 'account.full.reconcile',
+                reason: 'Made by reconciling; undone by unreconciling, never archived.',
+            },
+            {
+                rule: 'V1',
+                model: 'account.partial.reconcile',
+                reason: 'Reconciliation records, seen from the lines they match.',
+            },
+            {
+                rule: 'V1',
+                model: 'account.full.reconcile',
+                reason: 'Reconciliation records, seen from the lines they match.',
+            },
+        ],
+    },
     depends: [contacts, product, messaging, permissions, reporting],
     app: {
         code: 'accounting',
@@ -128,6 +148,148 @@ export const accounting = defineModule({
             implies: ['user'],
         },
     },
+    // Settings › App settings › Accounting (RFC 0020): per company, changed by accounting managers.
+    settings: {
+        sections: [
+            {
+                key: 'periods',
+                label: 'Fiscal year and lock dates',
+                description: 'When the fiscal year starts, and the dates before which nothing may change.',
+                keywords: 'fiscal year lock date period closing tax return',
+                scope: 'company',
+                editors: ['account.manager'],
+                fields: [
+                    {
+                        key: 'fiscalYearStart',
+                        min: 1,
+                        max: 12,
+                        help: 'The month it starts: 7 for July–June.',
+                    },
+                    { key: 'lockDate', help: 'Nothing is posted, reversed or reconciled on or before it.' },
+                    {
+                        key: 'taxLockDate',
+                        help: 'Tax returns are filed up to it: tax lines cannot change on or before it.',
+                    },
+                ],
+            },
+        ],
+    },
+    // The Overview (RFC 0022 step 2): what is owed to us and by us, the month's invoicing, who owes most.
+    overview: {
+        cards: [
+            {
+                id: 'receivable',
+                title: 'Receivable',
+                kind: 'kpi',
+                model: 'account.move',
+                measure: 'sum:amountResidual',
+                filter: {
+                    kind: { in: ['out_invoice', 'out_debit'] },
+                    state: 'posted',
+                    paymentState: { in: ['not_paid', 'partial'] },
+                },
+                w: 3,
+            },
+            {
+                id: 'payable',
+                title: 'Payable',
+                kind: 'kpi',
+                model: 'account.move',
+                measure: 'sum:amountResidual',
+                filter: {
+                    kind: { in: ['in_invoice', 'in_debit'] },
+                    state: 'posted',
+                    paymentState: { in: ['not_paid', 'partial'] },
+                },
+                w: 3,
+            },
+            {
+                id: 'invoiced_month',
+                title: 'Invoiced this month',
+                kind: 'kpi',
+                model: 'account.move',
+                measure: 'sum:amountTotal',
+                filter: { kind: 'out_invoice', state: 'posted' },
+                comparison: { field: 'date', mode: 'previous' },
+                w: 3,
+            },
+            {
+                id: 'billed_month',
+                title: 'Bills this month',
+                kind: 'kpi',
+                model: 'account.move',
+                measure: 'sum:amountTotal',
+                filter: { kind: 'in_invoice', state: 'posted' },
+                comparison: { field: 'date', mode: 'previous' },
+                w: 3,
+            },
+            {
+                id: 'revenue_by_month',
+                title: 'Invoiced by month',
+                kind: 'chart',
+                model: 'account.move',
+                measure: 'sum:amountTotal',
+                groupBy: 'date:month',
+                filter: { kind: 'out_invoice', state: 'posted' },
+                chart: 'bar',
+                w: 6,
+            },
+            {
+                id: 'top_debtors',
+                title: 'Who owes most',
+                kind: 'pivot',
+                model: 'account.move',
+                measure: 'sum:amountResidual',
+                groupBy: 'partner',
+                filter: {
+                    kind: { in: ['out_invoice', 'out_debit'] },
+                    state: 'posted',
+                    paymentState: { in: ['not_paid', 'partial'] },
+                },
+                w: 6,
+            },
+            {
+                id: 'payments_month',
+                title: 'Payments this month',
+                kind: 'kpi',
+                model: 'account.payment',
+                measure: 'sum:amount',
+                comparison: { field: 'date', mode: 'previous' },
+                w: 3,
+            },
+            {
+                id: 'drafts',
+                title: 'Draft invoices and bills',
+                kind: 'kpi',
+                model: 'account.move',
+                measure: 'count',
+                filter: { kind: { ne: 'entry' }, state: 'draft' },
+                w: 3,
+            },
+            {
+                id: 'to_approve',
+                title: 'Waiting approval',
+                kind: 'kpi',
+                model: 'account.move',
+                measure: 'count',
+                filter: { state: 'to_approve' },
+                w: 3,
+            },
+            {
+                id: 'biggest_open',
+                title: 'Biggest open invoices',
+                kind: 'list',
+                model: 'account.move',
+                measure: 'sum:amountResidual',
+                filter: {
+                    kind: { in: ['out_invoice', 'out_debit'] },
+                    state: 'posted',
+                    paymentState: { in: ['not_paid', 'partial'] },
+                },
+                w: 3,
+            },
+        ],
+    },
     actions: {
         'accounting.action_customer_invoices': action(AccountMove, {
             label: 'Customer invoices',
@@ -233,6 +395,16 @@ export const accounting = defineModule({
             label: 'Chart of accounts',
             views: ['list', 'form'],
         }),
+        'accounting.action_analytics': action(AccountAnalytic, {
+            label: 'Cost centres',
+            views: ['list', 'form', 'hierarchy'],
+        }),
+        'accounting.action_by_analytic': action(AccountMoveLine, {
+            label: 'By cost centre',
+            views: ['pivot', 'list'],
+            viewIds: { pivot: 'account.move.line.by_analytic' },
+            domain: { posted: true },
+        }),
         'accounting.action_journals': action(AccountJournal, {
             label: 'Journals',
             views: ['list', 'form'],
@@ -306,6 +478,13 @@ export const accounting = defineModule({
             action: 'accounting.action_general_ledger',
             sequence: 2,
         },
+        {
+            id: 'accounting.by_analytic',
+            parent: 'accounting.reporting',
+            label: 'By cost centre',
+            action: 'accounting.action_by_analytic',
+            sequence: 2.5,
+        },
         {
             id: 'accounting.partner_ledger',
             parent: 'accounting.reporting',
@@ -361,6 +540,13 @@ export const accounting = defineModule({
             action: 'accounting.action_accounts',
             sequence: 1,
         },
+        {
+            id: 'accounting.analytics',
+            parent: 'accounting.configuration',
+            label: 'Cost centres',
+            action: 'accounting.action_analytics',
+            sequence: 2,
+        },
         {
             id: 'accounting.journals',
             parent: 'accounting.configuration',
@@ -408,6 +594,18 @@ export const accounting = defineModule({
     events: [
         { topic: 'account.move.posted', model: 'account.move', label: 'Entry, invoice or bill posted' },
     ],
+    importTemplates: [
+        {
+            key: 'cost_centres',
+            model: 'account.analytic',
+            label: 'Cost centres',
+            columns: [
+                { header: 'Code', field: 'code' },
+                { header: 'Name', field: 'name' },
+                { header: 'Part of', field: 'parent' },
+            ],
+        },
+    ],
     approvals: [
         {
             name: 'Vendor bill approvals',
@@ -425,6 +623,53 @@ export const accounting = defineModule({
     ],
     // Which withholdings apply to a contact (VDS, TDS), next to their roles (RFC 0016).
     viewExtensions: [
+        // The contact's invoices, what they still owe, and their bills (RFC 0022 §3.1).
+        {
+            view: 'res.partner.form',
+            operations: [
+                {
+                    append: 'related',
+                    nodes: [
+                        stat({
+                            id: 'customer_invoices',
+                            label: 'Invoices',
+                            model: AccountMove,
+                            where: {
+                                partner: { $record: 'id' },
+                                kind: { in: ['out_invoice', 'out_refund', 'out_debit'] },
+                                state: 'posted',
+                            },
+                            action: 'accounting.action_customer_invoices',
+                        }),
+                        stat({
+                            id: 'customer_due',
+                            label: 'Due from them',
+                            model: AccountMove,
+                            where: {
+                                partner: { $record: 'id' },
+                                kind: { in: ['out_invoice', 'out_debit'] },
+                                state: 'posted',
+                                paymentState: { ne: 'paid' },
+                            },
+                            measure: { sum: 'amountResidual' },
+                            action: 'accounting.action_customer_invoices',
+                            tone: 'warning',
+                        }),
+                        stat({
+                            id: 'vendor_bills',
+                            label: 'Bills',
+                            model: AccountMove,
+                            where: {
+                                partner: { $record: 'id' },
+                                kind: { in: ['in_invoice', 'in_refund', 'in_debit'] },
+                                state: 'posted',
+                            },
+                            action: 'accounting.action_vendor_bills',
+                        }),
+                    ],
+                },
+            ],
+        },
         // A tax's accounts, reverse charge's payable account, and its components (CGST / SGST / IGST).
         {
             view: 'account.tax.form',
@@ -575,7 +820,7 @@ export const accounting = defineModule({
                 'name',
                 'partner',
                 'date',
-                'dateDue',
+                { field: 'dateDue', widget: 'daysLeft' },
                 'invoiceOrigin',
                 { field: 'amountTotal', sum: true },
                 { field: 'amountResidual', sum: true },
@@ -583,6 +828,11 @@ export const accounting = defineModule({
                 { field: 'paymentState', widget: 'badge' },
             ],
             defaultOrder: ['date desc', 'name desc'],
+            decorations: {
+                success: { paymentState: 'paid' },
+                warning: { paymentState: 'partial' },
+                neutral: { state: 'cancel' },
+            },
         }),
         'account.move.invoice.form': form(AccountMove, (k) => ({
             header: {
@@ -596,12 +846,31 @@ export const accounting = defineModule({
                 ],
             },
             sheet: [
+                k.stats('related', [
+                    {
+                        id: 'invoice_payments',
+                        label: 'Payments',
+                        model: AccountPayment,
+                        where: { documents: { any: { id: { $record: 'id' } } }, state: 'posted' },
+                        action: 'accounting.action_payments',
+                    },
+                    {
+                        id: 'invoice_paid',
+                        label: 'Paid',
+                        model: AccountPayment,
+                        where: { documents: { any: { id: { $record: 'id' } } }, state: 'posted' },
+                        measure: { sum: 'amount' },
+                        action: 'accounting.action_payments',
+                        tone: 'success',
+                    },
+                ]),
                 k.group('party', ['partner', 'kind', 'invoiceOrigin', 'ref', 'debitOf', 'placeOfSupply']),
                 k.group('dates', ['date', 'dateDue', 'paymentTerm', 'journal']),
                 k.lines('lines', [
                     'product',
                     { field: 'name', id: 'line_name' },
                     { field: 'account', id: 'line_account' },
+                    { field: 'analytic', id: 'line_analytic' },
                     'quantity',
                     'priceUnit',
                     'discount',
@@ -634,6 +903,7 @@ export const accounting = defineModule({
                 'account',
                 'partner',
                 'name',
+                'analytic',
                 { field: 'debit', sum: true },
                 { field: 'credit', sum: true },
                 { field: 'balance', sum: true },
@@ -767,6 +1037,37 @@ export const accounting = defineModule({
             readonlyWhen: { state: { ne: 'draft' } },
             chatter: true,
         })),
+        'account.analytic.list': list(AccountAnalytic, {
+            columns: ['code', 'name', 'parent'],
+            defaultOrder: ['code asc'],
+            inlineEdit: ['name'],
+        }),
+        'account.analytic.form': form(AccountAnalytic, (k) => ({
+            header: { buttons: [] },
+            sheet: [
+                k.stats('related', [
+                    stat({
+                        id: 'analytic_lines',
+                        label: 'Journal lines',
+                        model: AccountMoveLine,
+                        where: { analytic: { $record: 'id' } },
+                        action: 'accounting.action_general_ledger',
+                    }),
+                ]),
+                k.group('main', ['code', 'name', 'parent', 'note']),
+            ],
+        })),
+        'account.analytic.hierarchy': hierarchy(AccountAnalytic, {
+            parent: 'parent',
+            title: 'name',
+            subtitle: 'code',
+        }),
+        'account.move.line.by_analytic': pivot(AccountMoveLine, {
+            rows: ['analytic'],
+            cols: ['accountType'],
+            measures: [{ sum: 'balance' }],
+            comparison: { field: 'date', mode: 'previous' },
+        }),
         'account.account.list': list(AccountAccount, {
             columns: ['code', 'name', 'type', 'reconcile', 'currency'],
             defaultOrder: ['code asc'],
@@ -790,6 +1091,7 @@ export const accounting = defineModule({
             columns: ['name', 'dateFrom', 'dateTo', { field: 'state', widget: 'badge' }, 'lockDate'],
         }),
         'account.fiscal.year.form': form(AccountFiscalYear, (k) => ({
+            chatter: true,
             header: { buttons: [] },
             sheet: [k.group('main', ['name', 'dateFrom', 'dateTo', 'state', 'lockDate'])],
         })),
@@ -822,6 +1124,40 @@ export const accounting = defineModule({
         })),
     },
     search: {
+        'account.payment.term': search(AccountPaymentTerm, { fields: ['name'] }),
+        'account.journal': search(AccountJournal, { fields: ['name', 'code'], groupBy: ['type'] }),
+        'account.fiscal.year': search(AccountFiscalYear, {
+            fields: ['name'],
+            filters: {
+                open: { label: 'Open', domain: { state: 'open' }, group: 'state' },
+                closed: { label: 'Closed', domain: { state: 'closed' }, group: 'state' },
+            },
+            groupBy: ['state'],
+        }),
+        'account.withholding': search(AccountWithholding, {
+            fields: ['name'],
+            filters: {
+                vendor: {
+                    label: 'When paying vendors',
+                    domain: { direction: 'vendor' },
+                    group: 'direction',
+                },
+                customer: {
+                    label: 'Withheld by customers',
+                    domain: { direction: 'customer' },
+                    group: 'direction',
+                },
+            },
+            groupBy: ['direction', 'base'],
+        }),
+        'res.bank.account': search(ResBankAccount, {
+            fields: ['bank', 'branch', 'number', 'holder'],
+            groupBy: ['currency'],
+        }),
+        'res.currency.rate': search(ResCurrencyRate, {
+            fields: ['currency.name'],
+            groupBy: ['currency', 'date:month'],
+        }),
         'account.move': search(AccountMove, {
             fields: ['name', 'ref', 'partner.name'],
             filters: {
@@ -876,6 +1212,10 @@ export const accounting = defineModule({
             },
             groupBy: ['journal', 'partner', 'state', 'date:month'],
         }),
+        'account.analytic': search(AccountAnalytic, {
+            fields: ['code', 'name'],
+            groupBy: ['parent'],
+        }),
         'account.account': search(AccountAccount, {
             fields: ['code', 'name'],
             filters: {