shutro-erp 0.3.5 → 0.3.7

package/dist/maintenance/i18n/bn.js

@@ -0,0 +1,132 @@
+/** Bangla for the module's labels, keyed by their English text (RFC 0023 §3.1; `pnpm i18n:extract`). */
+export const bn = {
+    'A finished order’s labour hours are costed at this rate.': 'শেষ হওয়া আদেশের শ্রমঘণ্টার খরচ এই হারে ধরা হয়।',
+    'A meter counts up: a reading cannot be below an earlier one.': 'মিটার শুধু বাড়ে: কোনো রিডিং আগের রিডিংয়ের চেয়ে কম হতে পারে না।',
+    'A new order is started when work begins and finished once every checklist item is ticked.': 'কাজ শুরু হলে নতুন আদেশ চালু করা হয় এবং চেকলিস্টের প্রতিটি বিষয়ে টিক দিলে শেষ করা হয়।',
+    'A plan by time gets its order this many days before it is due.': 'সময়ভিত্তিক পরিকল্পনার আদেশ নির্ধারিত তারিখের এত দিন আগে তৈরি হয়।',
+    'A plan by time repeats every so many days; by meter, every so much on one of the equipment’s meters.': 'সময়ভিত্তিক পরিকল্পনা নির্দিষ্ট দিন পরপর পুনরাবৃত্ত হয়; মিটারভিত্তিক পরিকল্পনা যন্ত্রপাতির কোনো একটি মিটারে নির্দিষ্ট পরিমাণ পরপর।',
+    Active: 'সক্রিয়',
+    'Another piece of equipment has this asset tag.': 'অন্য একটি যন্ত্রপাতির এই সম্পদ ট্যাগ আছে।',
+    'Asset Care': 'অ্যাসেট কেয়ার',
+    'Asset Care manager': 'অ্যাসেট কেয়ার ব্যবস্থাপক',
+    'Asset tag': 'সম্পদ ট্যাগ',
+    'Assigned to': 'দায়িত্বপ্রাপ্ত',
+    'Bought on': 'ক্রয়ের তারিখ',
+    Breakdown: 'বিকল',
+    Breakdowns: 'বিকল',
+    'Building and facilities': 'ভবন ও স্থাপনা',
+    Cancel: 'বাতিল করুন',
+    Cancelled: 'বাতিল',
+    Category: 'শ্রেণি',
+    Checklist: 'চেকলিস্ট',
+    'Checklist › Done': 'চেকলিস্ট › সম্পন্ন',
+    'Checklist › Name': 'চেকলিস্ট › নাম',
+    'Checklist item': 'চেকলিস্টের বিষয়',
+    Company: 'প্রতিষ্ঠান',
+    'Cost of an hour of work': 'এক ঘণ্টা কাজের খরচ',
+    'Created At': 'তৈরির সময়',
+    'Created By': 'তৈরি করেছেন',
+    'Days before a plan is due': 'পরিকল্পনার নির্ধারিত তারিখের আগে দিন',
+    'Display Name': 'প্রদর্শিত নাম',
+    Done: 'সম্পন্ন',
+    'Done this month': 'এ মাসে সম্পন্ন',
+    Down: 'বন্ধ',
+    'Down while a breakdown order is open, retired once archived, otherwise operational.': 'বিকলের আদেশ খোলা থাকলে বন্ধ, আর্কাইভ করা হলে অবসরপ্রাপ্ত, নইলে চালু।',
+    'Downtime (hours)': 'বন্ধ থাকার সময় (ঘণ্টা)',
+    'Downtime hours this month': 'এ মাসে বন্ধ থাকার ঘণ্টা',
+    Equipment: 'যন্ত্রপাতি',
+    'Equipment stopped': 'যন্ত্রপাতি বন্ধ',
+    'Equipment, preventive plans by time or meter, maintenance orders, reliability': 'যন্ত্রপাতি, সময় বা মিটারভিত্তিক প্রতিরোধমূলক পরিকল্পনা, রক্ষণাবেক্ষণ আদেশ, নির্ভরযোগ্যতা',
+    'Every (days)': 'প্রতি (দিন)',
+    'Every (on the meter)': 'প্রতি (মিটারে)',
+    'Every so many days': 'নির্দিষ্ট দিন পরপর',
+    'Every so much on a meter': 'মিটারে নির্দিষ্ট পরিমাণ পরপর',
+    Finish: 'শেষ করুন',
+    Finished: 'শেষ হয়েছে',
+    From: 'থেকে',
+    High: 'উচ্চ',
+    'Hours from the report to the finish when the equipment was stopped, counted once the order is finished.': 'যন্ত্রপাতি বন্ধ থাকলে জানানো থেকে শেষ হওয়া পর্যন্ত ঘণ্টা, আদেশ শেষ হলে গোনা হয়।',
+    'How early the orders of preventive plans are made, and what an hour of work costs.': 'প্রতিরোধমূলক পরিকল্পনার আদেশ কত আগে তৈরি হয়, এবং এক ঘণ্টা কাজের খরচ কত।',
+    'How soon the work should be done.': 'কাজটি কত তাড়াতাড়ি করা উচিত।',
+    ID: 'আইডি',
+    'In progress': 'চলমান',
+    'IT equipment': 'আইটি যন্ত্রপাতি',
+    Kind: 'ধরন',
+    'Labour (hours)': 'শ্রম (ঘণ্টা)',
+    'Labour cost': 'শ্রম খরচ',
+    'Last done': 'সর্বশেষ সম্পন্ন',
+    'Last done at (meter)': 'সর্বশেষ সম্পন্ন (মিটার)',
+    Low: 'নিম্ন',
+    Machine: 'মেশিন',
+    'Maintenance done': 'রক্ষণাবেক্ষণ সম্পন্ন',
+    'Maintenance order': 'রক্ষণাবেক্ষণ আদেশ',
+    'Maintenance order {{name}}': 'রক্ষণাবেক্ষণ আদেশ {{name}}',
+    'Maintenance orders': 'রক্ষণাবেক্ষণ আদেশ',
+    'Maintenance started': 'রক্ষণাবেক্ষণ শুরু হয়েছে',
+    'Manager (equipment, plans, everything)': 'ব্যবস্থাপক (যন্ত্রপাতি, পরিকল্পনা, সবকিছু)',
+    Meter: 'মিটার',
+    'Meter reading': 'মিটার রিডিং',
+    'Meter readings': 'মিটার রিডিং',
+    Meters: 'মিটার',
+    'Meters › Name': 'মিটার › নাম',
+    'Meters › Unit': 'মিটার › একক',
+    Mine: 'আমার',
+    'Most downtime': 'সবচেয়ে বেশি বন্ধ',
+    Name: 'নাম',
+    New: 'নতুন',
+    'Next due': 'পরবর্তী নির্ধারিত',
+    Normal: 'সাধারণ',
+    Note: 'নোট',
+    'Open requests': 'খোলা অনুরোধ',
+    'Open requests by equipment': 'যন্ত্রপাতি অনুযায়ী খোলা অনুরোধ',
+    'Open requests by priority': 'অগ্রাধিকার অনুযায়ী খোলা অনুরোধ',
+    Operational: 'চালু',
+    Operations: 'কার্যক্রম',
+    Other: 'অন্যান্য',
+    Overview: 'সারসংক্ষেপ',
+    'Page {{page}} of {{pages}}': 'পৃষ্ঠা {{page}} / {{pages}}',
+    Plan: 'পরিকল্পনা',
+    'Planned for': 'পরিকল্পিত তারিখ',
+    'Planned hours': 'পরিকল্পিত ঘণ্টা',
+    Plans: 'পরিকল্পনা',
+    'Plans and costs': 'পরিকল্পনা ও খরচ',
+    Preventive: 'প্রতিরোধমূলক',
+    'Preventive plan': 'প্রতিরোধমূলক পরিকল্পনা',
+    'Preventive plans': 'প্রতিরোধমূলক পরিকল্পনা',
+    'Preventive work comes from a maintenance plan; a breakdown is a repair after a failure.': 'প্রতিরোধমূলক কাজ আসে রক্ষণাবেক্ষণ পরিকল্পনা থেকে; বিকল হলো নষ্ট হওয়ার পর মেরামত।',
+    Priority: 'অগ্রাধিকার',
+    'Read at': 'রিডিংয়ের সময়',
+    Reading: 'রিডিং',
+    Readings: 'রিডিং',
+    Reference: 'রেফারেন্স',
+    Reported: 'রিপোর্ট করা হয়েছে',
+    Request: 'অনুরোধ',
+    'Requests by state': 'অবস্থা অনুযায়ী অনুরোধ',
+    Responsible: 'দায়িত্বপ্রাপ্ত',
+    Retired: 'অবসরপ্রাপ্ত',
+    Scheduled: 'নির্ধারিত',
+    Start: 'শুরু করুন',
+    Started: 'শুরু হয়েছে',
+    State: 'অবস্থা',
+    Status: 'অবস্থা',
+    Technician: 'টেকনিশিয়ান',
+    'Technician (orders, readings, breakdowns)': 'টেকনিশিয়ান (আদেশ, রিডিং, বিকল)',
+    'The kind of equipment, used to group and filter it.': 'যন্ত্রপাতির ধরন, যা দিয়ে দলবদ্ধ ও ফিল্টার করা হয়।',
+    'The latest reading recorded on this meter.': 'এই মিটারে লিপিবদ্ধ সর্বশেষ রিডিং।',
+    'Tick every item of the checklist first.': 'আগে চেকলিস্টের প্রতিটি আইটেমে টিক দিন।',
+    'To do': 'করণীয়',
+    Tool: 'সরঞ্জাম',
+    Type: 'ধরন',
+    Unit: 'একক',
+    'Updated At': 'হালনাগাদের সময়',
+    'Updated By': 'হালনাগাদ করেছেন',
+    Urgent: 'জরুরি',
+    Value: 'মান',
+    Vehicle: 'যানবাহন',
+    Vendor: 'সরবরাহকারী',
+    'Warranty until': 'ওয়ারেন্টি পর্যন্ত',
+    'What is wrong / what to do': 'কী সমস্যা / কী করতে হবে',
+    When: 'কখন',
+    'Where it is': 'কোথায় আছে',
+    'Whether the plan falls due after a number of days or after a set amount on a meter.': 'পরিকল্পনাটি নির্দিষ্ট দিন পরপর, নাকি মিটারে নির্দিষ্ট পরিমাণ পরপর প্রাপ্য হয়।',
+};

package/dist/maintenance/index.js

@@ -92,6 +92,91 @@ export const maintenance = defineModule({
         category: 'Operations',
         summary: 'Equipment, preventive plans by time or meter, maintenance orders, reliability',
     },
+    documents: [
+        {
+            key: 'maintenance_order',
+            name: 'Maintenance order',
+            model: 'maintenance.request',
+            layout: {
+                paper: 'A4',
+                header: '{{company.name}}',
+                footer: 'Page {{page}} of {{pages}}',
+                blocks: [
+                    { kind: 'heading', id: 'title', text: 'Maintenance order {{name}}', level: 1 },
+                    {
+                        kind: 'fields',
+                        id: 'order',
+                        items: [
+                            { label: 'Equipment', bind: 'equipment.name' },
+                            { label: 'Kind', bind: 'kind' },
+                            { label: 'Priority', bind: 'priority' },
+                            { label: 'Scheduled', bind: 'scheduledDate' },
+                            { label: 'Assigned to', bind: 'assignedTo.name' },
+                            { label: 'Reported', bind: 'reportedAt' },
+                            { label: 'Started', bind: 'startedAt' },
+                            { label: 'Finished', bind: 'finishedAt' },
+                            { label: 'Downtime (hours)', bind: 'downtimeHours' },
+                            { label: 'Labour (hours)', bind: 'labourHours' },
+                            { label: 'Status', bind: 'state' },
+                        ],
+                    },
+                    { kind: 'text', id: 'about', text: '{{description}}' },
+                    { kind: 'text', id: 'note', text: '{{note}}' },
+                    { kind: 'signature', id: 'sign', labels: ['Done by', 'Checked by'] },
+                ],
+            },
+        },
+    ],
+    importTemplates: [
+        {
+            key: 'maintenance_equipment',
+            model: 'maintenance.equipment',
+            label: 'Equipment',
+            columns: [
+                { header: 'Name', field: 'name' },
+                { header: 'Asset tag', field: 'code' },
+                { header: 'Category', field: 'category' },
+                { header: 'Where it is', field: 'location' },
+                { header: 'Vendor', field: 'vendor' },
+                { header: 'Bought on', field: 'purchaseDate' },
+                { header: 'Warranty until', field: 'warrantyUntil' },
+                { header: 'Responsible', field: 'responsible' },
+                { header: 'Note', field: 'note' },
+                { header: 'Meters › Name', field: 'meters.name' },
+                { header: 'Meters › Unit', field: 'meters.unit' },
+            ],
+        },
+        {
+            key: 'maintenance_request',
+            model: 'maintenance.request',
+            label: 'Maintenance order',
+            columns: [
+                { header: 'Equipment', field: 'equipment' },
+                { header: 'Type', field: 'kind' },
+                { header: 'Plan', field: 'plan' },
+                { header: 'What is wrong / what to do', field: 'description' },
+                { header: 'Priority', field: 'priority' },
+                { header: 'Planned for', field: 'scheduledDate' },
+                { header: 'Technician', field: 'assignedTo' },
+                { header: 'Equipment stopped', field: 'downtime' },
+                { header: 'Labour (hours)', field: 'labourHours' },
+                { header: 'Labour cost', field: 'labourCost' },
+                { header: 'Note', field: 'note' },
+                { header: 'Checklist › Name', field: 'tasks.name' },
+                { header: 'Checklist › Done', field: 'tasks.done' },
+            ],
+        },
+    ],
+    events: [
+        {
+            topic: 'maintenance.request.started',
+            model: 'maintenance.request',
+            label: 'Maintenance started',
+        },
+        { topic: 'maintenance.request.done', model: 'maintenance.request', label: 'Maintenance done' },
+    ],
+    // Bangla for the labels it serves (RFC 0023 §3.1; `pnpm i18n:extract`).
+    i18n: { bn: () => import('./i18n/bn.js') },
     accessLevels: {
         user: { label: 'Technician (orders, readings, breakdowns)', groups: ['maintenance.user'] },
         manager: {

package/dist/maintenance/module.d.ts

@@ -1,3 +1,8 @@
+/**
+ * The data layer of Asset Care (RFC 0021): equipment with its meters and warranty, preventive plans by time or by
+ * meter with their checklists, and maintenance orders — preventive or breakdown — whose checklist is ticked before
+ * they are done, with labour hours and the downtime from report to finish.
+ */
 import { type Decimal, type Id } from '../server/orm.js';
 import { type Env } from './.kosh/bindings.js';
 /** A date as `YYYY-MM-DD` (date-only values from PostgreSQL are local midnights: their local parts). */
@@ -3169,6 +3174,16 @@ export declare const maintenanceShutro: import("../server/orm.js").Module<readon
         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;
@@ -3390,6 +3405,16 @@ export declare const maintenanceShutro: import("../server/orm.js").Module<readon
         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/maintenance/module.js

@@ -5,7 +5,7 @@
  */
 import { contactsShutro } from '../contacts/index.js';
 import { messagingShutro } from '../messaging/index.js';
-import { installationSetting } from '../server/index.js';
+import { emitting, installationSetting } from '../server/index.js';
 import { orm } from '../server/orm.js';
 import { check, compute, defineModel, defineModule, f, method, records, } from './.kosh/bindings.js';
 const READ = ['read'];
@@ -63,7 +63,11 @@ export const MaintenanceEquipment = defineModel('maintenance.equipment', {
             building: 'Building and facilities',
             tool: 'Tool',
             other: 'Other',
-        }, { required: true, default: 'machine' }),
+        }, {
+            required: true,
+            default: 'machine',
+            help: 'The kind of equipment, used to group and filter it.',
+        }),
         location: f.char({ label: 'Where it is' }),
         vendor: f.many2one('res.partner', { ondelete: 'set null' }),
         purchaseDate: f.date({ label: 'Bought on' }),
@@ -76,6 +80,7 @@ export const MaintenanceEquipment = defineModel('maintenance.equipment', {
         status: f.selection({ operational: 'Operational', down: 'Down', retired: 'Retired' }, {
             store: true,
             label: 'Status',
+            help: 'Down while a breakdown order is open, retired once archived, otherwise operational.',
             ...compute('maintenance.equipment', 'status', ['active', 'requests.state', 'requests.kind'], (equipment) => {
                 for (const e of equipment)
                     e.status = !e.active
@@ -109,6 +114,7 @@ export const MaintenanceMeter = defineModel('maintenance.meter', {
             scale: 2,
             store: true,
             label: 'Reading',
+            help: 'The latest reading recorded on this meter.',
             ...compute('maintenance.meter', 'value', ['readings.value', 'readings.date'], (meters) => {
                 for (const m of meters) {
                     const latest = [...m.readings].sort((a, b) => b.date.getTime() - a.date.getTime() || b.id - a.id)[0];
@@ -174,7 +180,12 @@ export const MaintenancePlan = defineModel('maintenance.plan', {
     fields: {
         name: f.char({ required: true }),
         equipment: f.many2one('maintenance.equipment', { required: true, ondelete: 'cascade' }),
-        trigger: f.selection({ time: 'Every so many days', meter: 'Every so much on a meter' }, { required: true, default: 'time', label: 'When' }),
+        trigger: f.selection({ time: 'Every so many days', meter: 'Every so much on a meter' }, {
+            required: true,
+            default: 'time',
+            label: 'When',
+            help: 'Whether the plan falls due after a number of days or after a set amount on a meter.',
+        }),
         intervalDays: f.integer({ label: 'Every (days)' }),
         startDate: f.date({ required: true, default: (env) => env.today(), label: 'From' }),
         meter: f.many2one('maintenance.meter', { ondelete: 'restrict' }),
@@ -252,10 +263,15 @@ export const MaintenanceRequest = defineModel('maintenance.request', {
             label: 'Reference',
         }),
         equipment: f.many2one('maintenance.equipment', { required: true, ondelete: 'restrict' }),
-        kind: f.selection({ preventive: 'Preventive', breakdown: 'Breakdown' }, { required: true, default: 'breakdown', label: 'Type' }),
+        kind: f.selection({ preventive: 'Preventive', breakdown: 'Breakdown' }, {
+            required: true,
+            default: 'breakdown',
+            label: 'Type',
+            help: 'Preventive work comes from a maintenance plan; a breakdown is a repair after a failure.',
+        }),
         plan: f.many2one('maintenance.plan', { ondelete: 'set null' }),
         description: f.text({ label: 'What is wrong / what to do' }),
-        priority: f.selection({ low: 'Low', normal: 'Normal', high: 'High', urgent: 'Urgent' }, { required: true, default: 'normal' }),
+        priority: f.selection({ low: 'Low', normal: 'Normal', high: 'High', urgent: 'Urgent' }, { required: true, default: 'normal', help: 'How soon the work should be done.' }),
         scheduledDate: f.date({
             required: true,
             default: (env) => env.today(),
@@ -271,6 +287,7 @@ export const MaintenanceRequest = defineModel('maintenance.request', {
             scale: 2,
             store: true,
             label: 'Downtime (hours)',
+            help: 'Hours from the report to the finish when the equipment was stopped, counted once the order is finished.',
             ...compute('maintenance.request', 'downtimeHours', ['downtime', 'reportedAt', 'finishedAt'], (requests) => {
                 for (const r of requests)
                     r.downtimeHours =
@@ -287,8 +304,9 @@ export const MaintenanceRequest = defineModel('maintenance.request', {
         state: f.state({
             states: { new: 'New', progress: 'In progress', done: 'Done', cancel: 'Cancelled' },
             initial: 'new',
+            help: 'A new order is started when work begins and finished once every checklist item is ticked.',
             transitions: {
-                start: {
+                start: emitting('maintenance.request.started', {
                     from: ['new'],
                     to: 'progress',
                     after: records('maintenance.request', async (requests) => {
@@ -298,8 +316,8 @@ export const MaintenanceRequest = defineModel('maintenance.request', {
                             .browse(requests.ids)
                             .started();
                     }),
-                },
-                finish: {
+                }),
+                finish: emitting('maintenance.request.done', {
                     from: ['progress'],
                     to: 'done',
                     guard: records('maintenance.request', async (requests) => (await requests.load({ tasks: true })).filter((r) => [...r.tasks].some((t) => !t.done))),
@@ -334,7 +352,7 @@ export const MaintenanceRequest = defineModel('maintenance.request', {
                             }
                         });
                     }),
-                },
+                }),
                 cancel: {
                     from: ['new', 'progress'],
                     to: 'cancel',

package/dist/maintenance_stock/.kosh/bindings.js

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