shutro-erp 0.3.5 → 0.3.7

package/dist/recruitment/module.d.ts

@@ -1,3 +1,9 @@
+/**
+ * The data layer of Hiring (RFC 0021): openings for Workforce positions with their headcount, applicants moving
+ * through stages, and interviewers' scorecards — each interviewer sees only their own, so no opinion steers the next;
+ * the applicant's average rating shows to everyone. One email applies once per opening. Expected salaries are for
+ * hiring managers only.
+ */
 export declare const HiringStage: import("../server/orm.js").Model<"hiring.stage", {
     readonly id: import("../server/orm.js").IdField<"hiring.stage">;
     readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
@@ -40,6 +46,7 @@ export declare const HiringStage: import("../server/orm.js").Model<"hiring.stage
         hasDefault: false;
         sequence: false;
     }>;
+    readonly active: import("../server/orm.js").ActiveField;
     readonly name: import("../server/orm.js").CharField<{
         readonly required: true;
         readonly computed: false;
@@ -875,6 +882,7 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         hasDefault: false;
         sequence: false;
     }>;
+    readonly active: import("../server/orm.js").ActiveField;
     readonly name: import("../server/orm.js").CharField<{
         readonly required: true;
         readonly computed: false;
@@ -1738,6 +1746,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly approvalUsers: import("../server/orm.js").Many2manyField<"res.users", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
 }, {} & import("../server/orm.js").TransitionMethods<{
     readonly name: import("../server/orm.js").CharField<{
         readonly required: true;
@@ -1769,6 +1787,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly approvalUsers: import("../server/orm.js").Many2manyField<"res.users", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
 }>>, import("../server/orm.js").Model<"hr.job", {
     readonly id: import("../server/orm.js").IdField<"hr.job">;
     readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
@@ -1854,6 +1882,214 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+}>>, import("../server/orm.js").Model<"hr.employee.tag", {
+    readonly id: import("../server/orm.js").IdField<"hr.employee.tag">;
+    readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly createdBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly displayName: import("../server/orm.js").CharField<{
+        required: true;
+        readonly: true;
+        computed: true;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly active: import("../server/orm.js").ActiveField;
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly color: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+}, {} & import("../server/orm.js").TransitionMethods<{
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly color: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+}>>, import("../server/orm.js").Model<"hr.contract.type", {
+    readonly id: import("../server/orm.js").IdField<"hr.contract.type">;
+    readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
+        required: true;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly createdBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly updatedBy: import("../server/orm.js").Many2oneField<'res.users', {
+        required: false;
+        readonly: true;
+        computed: false;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly displayName: import("../server/orm.js").CharField<{
+        required: true;
+        readonly: true;
+        computed: true;
+        inverse: false;
+        hasDefault: false;
+        sequence: false;
+    }>;
+    readonly active: import("../server/orm.js").ActiveField;
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly code: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly country: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly sequence: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
+}, {} & import("../server/orm.js").TransitionMethods<{
+    readonly name: import("../server/orm.js").CharField<{
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string | Readonly<Record<string, string>>>;
+    readonly code: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly country: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly sequence: import("../server/orm.js").ScalarField<"integer", number, number, {
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
 }>>, import("../server/orm.js").Model<"hr.employee", {
     readonly id: import("../server/orm.js").IdField<"hr.employee">;
     readonly createdAt: import("../server/orm.js").ScalarField<'datetime', Date, Date, {
@@ -1908,6 +2144,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly jobTitle: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     readonly user: import("../server/orm.js").Many2oneField<"res.users", {
         readonly required: false;
         readonly computed: false;
@@ -1958,6 +2204,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: true;
         readonly readonly: false;
     }>;
+    readonly unitHead: import("../server/orm.js").Many2oneField<"hr.employee", {
+        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 coach: import("../server/orm.js").Many2oneField<"hr.employee", {
+        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 property: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly tags: import("../server/orm.js").Many2manyField<"hr.employee.tag", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
     readonly workEmail: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -1978,6 +2264,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly mobile: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly expenseApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        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 leaveApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        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 timezone: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }, string>;
     readonly hireDate: import("../server/orm.js").ScalarField<"date", string, string, {
         readonly required: false;
         readonly computed: false;
@@ -2039,6 +2365,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly jobTitle: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
     readonly user: import("../server/orm.js").Many2oneField<"res.users", {
         readonly required: false;
         readonly computed: false;
@@ -2089,6 +2425,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: true;
         readonly readonly: false;
     }>;
+    readonly unitHead: import("../server/orm.js").Many2oneField<"hr.employee", {
+        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 coach: import("../server/orm.js").Many2oneField<"hr.employee", {
+        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 property: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly tags: import("../server/orm.js").Many2manyField<"hr.employee.tag", {
+        readonly required: true;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }>;
     readonly workEmail: import("../server/orm.js").CharField<{
         readonly required: false;
         readonly computed: false;
@@ -2109,6 +2485,46 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
+    readonly mobile: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: false;
+        readonly readonly: false;
+    }, string>;
+    readonly expenseApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        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 leaveApprover: import("../server/orm.js").Many2oneField<"res.users", {
+        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 timezone: import("../server/orm.js").CharField<{
+        readonly required: false;
+        readonly computed: false;
+        readonly inverse: false;
+        readonly sequence: false;
+        readonly computeName: undefined;
+        readonly store: true;
+        readonly hasDefault: true;
+        readonly readonly: false;
+    }, string>;
     readonly hireDate: import("../server/orm.js").ScalarField<"date", string, string, {
         readonly required: false;
         readonly computed: false;
@@ -2222,6 +2638,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly employmentType: import("../server/orm.js").Many2oneField<"hr.contract.type", {
+        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 kind: import("../server/orm.js").SelectionField<"fixed" | "intern" | "permanent" | "probation", {
         readonly required: true;
         readonly computed: false;
@@ -2304,6 +2730,16 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly hasDefault: false;
         readonly readonly: false;
     }>;
+    readonly employmentType: import("../server/orm.js").Many2oneField<"hr.contract.type", {
+        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 kind: import("../server/orm.js").SelectionField<"fixed" | "intern" | "permanent" | "probation", {
         readonly required: true;
         readonly computed: false;
@@ -2560,16 +2996,14 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly approve: {
             readonly from: readonly ["submitted"];
             readonly to: "approved";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly refuse: {
             readonly from: readonly ["submitted"];
             readonly to: "refused";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly redraft: {
             readonly from: readonly ["submitted", "refused"];
@@ -2652,16 +3086,14 @@ export declare const recruitmentShutro: import("../server/orm.js").Module<readon
         readonly approve: {
             readonly from: readonly ["submitted"];
             readonly to: "approved";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly refuse: {
             readonly from: readonly ["submitted"];
             readonly to: "refused";
-            readonly requires: "hr.leave_decide";
             readonly guard: (records: never) => unknown;
-            readonly message: "Someone else decides your leave.";
+            readonly message: "Your own leave is decided by someone else; others’ by an HR manager or their leave approver.";
         };
         readonly redraft: {
             readonly from: readonly ["submitted", "refused"];
@@ -2872,6 +3304,16 @@ export declare const recruitmentShutro: 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;
@@ -3093,6 +3535,16 @@ export declare const recruitmentShutro: 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/recruitment/module.js

@@ -5,6 +5,7 @@
  * hiring managers only.
  */
 import { hrShutro } from '../hr/index.js';
+import { emitting } from '../server/index.js';
 import { orm } from '../server/orm.js';
 import { check, compute, defineModel, defineModule, f, record, } from './.kosh/bindings.js';
 const READ = ['read'];
@@ -12,6 +13,7 @@ const ALL = ['read', 'write', 'create', 'unlink'];
 const me = { $env: 'uid' };
 export const HiringStage = defineModel('hiring.stage', {
     label: 'Hiring stage',
+    archivable: true,
     recName: 'name',
     order: ['sequence asc', 'id asc'],
     access: { 'hiring.user': READ, 'hiring.manager': ALL },
@@ -50,10 +52,11 @@ export const HiringOpening = defineModel('hiring.opening', {
         applicants: f.one2many('hiring.applicant', 'opening'),
         description: f.text(),
         state: f.state({
+            help: 'An open opening takes applicants; it closes by hand or once its headcount is hired.',
             states: { open: 'Open', closed: 'Closed' },
             initial: 'open',
             transitions: {
-                close: { from: ['open'], to: 'closed' },
+                close: emitting('hiring.opening.closed', { from: ['open'], to: 'closed' }),
                 reopen: { from: ['closed'], to: 'open' },
             },
         }),
@@ -88,7 +91,7 @@ export const HiringApplicant = defineModel('hiring.applicant', {
             linkedin: 'LinkedIn',
             agency: 'Agency',
             other: 'Other',
-        }, {}),
+        }, { help: 'Where the candidate heard of the opening.' }),
         expectedSalary: f.decimal({ scale: 2, label: 'Expected salary', groups: ['hiring.manager'] }),
         refused: f.boolean({ default: false }),
         refuseReason: f.char({ label: 'Refused because' }),
@@ -98,6 +101,7 @@ export const HiringApplicant = defineModel('hiring.applicant', {
             scale: 1,
             store: true,
             label: 'Rating',
+            help: 'The average score of the interviewers’ scorecards, out of 5.',
             ...compute('hiring.applicant', 'rating', ['scorecards.score'], (applicants) => {
                 for (const a of applicants) {
                     const scores = [...a.scorecards].map((s) => s.score);
@@ -115,6 +119,7 @@ export const HiringApplicant = defineModel('hiring.applicant', {
         employee: f.many2one('hr.employee', { ondelete: 'set null' }),
         status: f.selection({ active: 'In progress', hired: 'Hired', refused: 'Refused' }, {
             store: true,
+            help: 'Hired once the candidate became an employee, refused when turned down, in progress otherwise.',
             ...compute('hiring.applicant', 'status', ['employee', 'refused'], (applicants) => {
                 for (const a of applicants)
                     a.status = a.employee !== null ? 'hired' : a.refused ? 'refused' : 'active';
@@ -167,7 +172,11 @@ export const HiringScorecard = defineModel('hiring.scorecard', {
         applicant: f.many2one('hiring.applicant', { required: true, ondelete: 'cascade' }),
         interviewer: f.many2one('res.users', { required: true, default: (env) => env.userId }),
         score: f.integer({ required: true, default: 3, label: 'Score (1–5)' }),
-        recommendation: f.selection({ strong_yes: 'Strong yes', yes: 'Yes', no: 'No', strong_no: 'Strong no' }, { required: true, default: 'yes' }),
+        recommendation: f.selection({ strong_yes: 'Strong yes', yes: 'Yes', no: 'No', strong_no: 'Strong no' }, {
+            required: true,
+            default: 'yes',
+            help: 'Whether the interviewer recommends hiring the candidate.',
+        }),
         notes: f.text(),
     },
     sqlConstraints: {
@@ -176,7 +185,7 @@ export const HiringScorecard = defineModel('hiring.scorecard', {
 });
 export const recruitmentShutro = defineModule({
     name: 'recruitment',
-    version: '0.1.0',
+    version: '0.2.0',
     depends: [hrShutro],
     groups: [
         orm.defineGroup({ code: 'hiring.user', label: 'Interviewer', implies: ['hr.user'] }),

package/dist/reporting/documents.d.ts

@@ -34,6 +34,11 @@ export interface DocumentData {
     readonly locale?: string;
     readonly tz?: string;
 }
+/**
+ * A template's placeholders filled as plain text (RFC 0029 §3.3: an email's subject and body), formatted as in
+ * documents; nothing escaped.
+ */
+export declare function fillText(data: DocumentData, fields: DocumentFields, template: string): string;
 /**
  * A QR code as SVG (one path of dark modules, a quiet zone of 4), from `qrcode`'s synchronous matrix — rendering
  * stays synchronous. Medium error correction: a printed ticket survives a crease.