@feedmepos/mf-hrm-portal 2.3.0-dev → 2.3.0-dev.11

package/dist/src/views/scheduling/schedule-state.d.ts

@@ -38,6 +38,7 @@ export declare const scheduleState: {
         days: {
             date: string;
             id: string;
+            updatedAt: string;
             isPublicHoliday: boolean;
             title: string;
             description: string;
@@ -56,6 +57,10 @@ export declare const scheduleState: {
             headcount: number;
         }[];
         settings: {
+            settingsConfigured?: boolean | undefined;
+            overtime: {
+                maxHoursPerMonth: number | null;
+            };
             payRate: {
                 NORMAL: {
                     overtime: number;
@@ -70,15 +75,20 @@ export declare const scheduleState: {
                 };
             };
             setupCompleted: boolean;
+            workingHours: {
+                minHoursPerDay: number | null;
+                maxHoursPerDay: number | null;
+                maxHoursPerWeek: number | null;
+            };
         };
         restaurantProfile: {
             operatingHours: {
-                dayOfWeek: number;
-                closed: boolean;
                 hours: {
                     start: string;
                     end: string;
                 }[];
+                dayOfWeek: number;
+                closed: boolean;
             }[];
         };
         positions: {
@@ -86,10 +96,18 @@ export declare const scheduleState: {
             name: string;
         }[];
         employees: {
+            overtime?: {
+                maxHoursPerMonth: number | null;
+            } | undefined;
+            minHoursPerDay?: number | null | undefined;
+            workingHours?: {
+                minHoursPerDay: number | null;
+                maxHoursPerDay: number | null;
+                maxHoursPerWeek: number | null;
+            } | undefined;
             name: string;
             employeeId: string;
             employmentType: "FULLTIME" | "PARTTIME";
-            workingHour: number;
             wage: {
                 type: "HOURLY" | "MONTHLY";
                 amount: number;
@@ -129,6 +147,7 @@ export declare const scheduleState: {
                 startTime: string;
                 endTime: string;
             })[];
+            updatedAt: string;
         }[];
     } | null, {
         timeOff: {
@@ -160,6 +179,7 @@ export declare const scheduleState: {
         days: {
             date: string;
             id: string;
+            updatedAt: string;
             isPublicHoliday: boolean;
             title: string;
             description: string;
@@ -178,6 +198,10 @@ export declare const scheduleState: {
             headcount: number;
         }[];
         settings: {
+            settingsConfigured?: boolean | undefined;
+            overtime: {
+                maxHoursPerMonth: number | null;
+            };
             payRate: {
                 NORMAL: {
                     overtime: number;
@@ -192,15 +216,20 @@ export declare const scheduleState: {
                 };
             };
             setupCompleted: boolean;
+            workingHours: {
+                minHoursPerDay: number | null;
+                maxHoursPerDay: number | null;
+                maxHoursPerWeek: number | null;
+            };
         };
         restaurantProfile: {
             operatingHours: {
-                dayOfWeek: number;
-                closed: boolean;
                 hours: {
                     start: string;
                     end: string;
                 }[];
+                dayOfWeek: number;
+                closed: boolean;
             }[];
         };
         positions: {
@@ -208,10 +237,18 @@ export declare const scheduleState: {
             name: string;
         }[];
         employees: {
+            overtime?: {
+                maxHoursPerMonth: number | null;
+            } | undefined;
+            minHoursPerDay?: number | null | undefined;
+            workingHours?: {
+                minHoursPerDay: number | null;
+                maxHoursPerDay: number | null;
+                maxHoursPerWeek: number | null;
+            } | undefined;
             name: string;
             employeeId: string;
             employmentType: "FULLTIME" | "PARTTIME";
-            workingHour: number;
             wage: {
                 type: "HOURLY" | "MONTHLY";
                 amount: number;
@@ -251,6 +288,7 @@ export declare const scheduleState: {
                 startTime: string;
                 endTime: string;
             })[];
+            updatedAt: string;
         }[];
     } | null>;
     loading: import("vue").Ref<boolean, boolean>;
@@ -334,13 +372,17 @@ export declare const scheduleState: {
                 overtime: number;
             };
         };
-        otAfterDaily: number;
         salesForecast: number;
         closedWeekdays: number[];
         labourTarget: number;
         budgetFromSales: boolean;
         budget: number;
-        otCapHours: number;
+        otCapHours: number | null;
+        workingHours: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        };
         otBudget: number;
         notify: {
             waConnected: boolean;
@@ -384,6 +426,7 @@ export declare const payload: import("vue").ShallowRef<{
     days: {
         date: string;
         id: string;
+        updatedAt: string;
         isPublicHoliday: boolean;
         title: string;
         description: string;
@@ -402,6 +445,10 @@ export declare const payload: import("vue").ShallowRef<{
         headcount: number;
     }[];
     settings: {
+        settingsConfigured?: boolean | undefined;
+        overtime: {
+            maxHoursPerMonth: number | null;
+        };
         payRate: {
             NORMAL: {
                 overtime: number;
@@ -416,15 +463,20 @@ export declare const payload: import("vue").ShallowRef<{
             };
         };
         setupCompleted: boolean;
+        workingHours: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        };
     };
     restaurantProfile: {
         operatingHours: {
-            dayOfWeek: number;
-            closed: boolean;
             hours: {
                 start: string;
                 end: string;
             }[];
+            dayOfWeek: number;
+            closed: boolean;
         }[];
     };
     positions: {
@@ -432,10 +484,18 @@ export declare const payload: import("vue").ShallowRef<{
         name: string;
     }[];
     employees: {
+        overtime?: {
+            maxHoursPerMonth: number | null;
+        } | undefined;
+        minHoursPerDay?: number | null | undefined;
+        workingHours?: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        } | undefined;
         name: string;
         employeeId: string;
         employmentType: "FULLTIME" | "PARTTIME";
-        workingHour: number;
         wage: {
             type: "HOURLY" | "MONTHLY";
             amount: number;
@@ -475,6 +535,7 @@ export declare const payload: import("vue").ShallowRef<{
             startTime: string;
             endTime: string;
         })[];
+        updatedAt: string;
     }[];
 } | null, {
     timeOff: {
@@ -506,6 +567,7 @@ export declare const payload: import("vue").ShallowRef<{
     days: {
         date: string;
         id: string;
+        updatedAt: string;
         isPublicHoliday: boolean;
         title: string;
         description: string;
@@ -524,6 +586,10 @@ export declare const payload: import("vue").ShallowRef<{
         headcount: number;
     }[];
     settings: {
+        settingsConfigured?: boolean | undefined;
+        overtime: {
+            maxHoursPerMonth: number | null;
+        };
         payRate: {
             NORMAL: {
                 overtime: number;
@@ -538,15 +604,20 @@ export declare const payload: import("vue").ShallowRef<{
             };
         };
         setupCompleted: boolean;
+        workingHours: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        };
     };
     restaurantProfile: {
         operatingHours: {
-            dayOfWeek: number;
-            closed: boolean;
             hours: {
                 start: string;
                 end: string;
             }[];
+            dayOfWeek: number;
+            closed: boolean;
         }[];
     };
     positions: {
@@ -554,10 +625,18 @@ export declare const payload: import("vue").ShallowRef<{
         name: string;
     }[];
     employees: {
+        overtime?: {
+            maxHoursPerMonth: number | null;
+        } | undefined;
+        minHoursPerDay?: number | null | undefined;
+        workingHours?: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        } | undefined;
         name: string;
         employeeId: string;
         employmentType: "FULLTIME" | "PARTTIME";
-        workingHour: number;
         wage: {
             type: "HOURLY" | "MONTHLY";
             amount: number;
@@ -597,6 +676,7 @@ export declare const payload: import("vue").ShallowRef<{
             startTime: string;
             endTime: string;
         })[];
+        updatedAt: string;
     }[];
 } | null>, loading: import("vue").Ref<boolean, boolean>, rosterLoading: import("vue").Ref<boolean, boolean>, loadError: import("vue").Ref<string | null, string | null>, scheduleSetupCompleted: import("vue").Ref<boolean, boolean>, dataVersion: import("vue").Ref<number, number>, outletId: import("vue").Ref<string, string>, restaurantEmployees: import("vue").Ref<{
     _id: string;
@@ -658,13 +738,17 @@ export declare const payload: import("vue").ShallowRef<{
             overtime: number;
         };
     };
-    otAfterDaily: number;
     salesForecast: number;
     closedWeekdays: number[];
     labourTarget: number;
     budgetFromSales: boolean;
     budget: number;
-    otCapHours: number;
+    otCapHours: number | null;
+    workingHours: {
+        minHoursPerDay: number | null;
+        maxHoursPerDay: number | null;
+        maxHoursPerWeek: number | null;
+    };
     otBudget: number;
     notify: {
         waConnected: boolean;
@@ -677,3 +761,7 @@ export declare const payload: import("vue").ShallowRef<{
         };
     };
 };
+/** Restore all outlet-scoped rules before another outlet is allowed to populate them. Keeping
+ * the reactive object and its nested containers alive matters because many board composables
+ * hold references to RULES members rather than reading the store object afresh. */
+export declare function resetRules(): void;

package/dist/src/views/scheduling/schedule-store.d.ts

@@ -1,10 +1,12 @@
+import ScheduleAPI from '@/api/schedule';
 import type { IFdtoPosUserSummary } from '@/types/employee';
-import type { FdtoScheduleAssignment, FdtoScheduleAutoScheduleApplyReq, FdtoScheduleAutoScheduleApplyResult, FdtoScheduleAutoScheduleCapabilities, FdtoScheduleAutoScheduleGenerateReq, FdtoScheduleAutoScheduleResult, FdtoScheduleBulkUpdateAssignmentStatusReq, FdtoScheduleCreateEmployeeProfileReq, FdtoScheduleSaveAssignmentReq, FdtoScheduleSavePositionReq, FdtoScheduleSaveScheduleDayReq, FdtoScheduleUpdateEmployeeProfileReq, FdtoScheduleCreateTimeOffReq, FdtoScheduleTimeOff, FdtoScheduleUpdateTimeOffStatusReq, FdtoScheduleSaveEmployeeConfigsReq, ScheduleReplaceDemandReq } from '@/types/schedule';
+import type { FdtoScheduleAssignment, FdtoScheduleAutoScheduleApplyReq, FdtoScheduleAutoScheduleApplyResult, FdtoScheduleAutoScheduleCapabilities, FdtoScheduleAutoScheduleGenerateReq, FdtoScheduleAutoScheduleResult, FdtoScheduleBulkUpdateAssignmentStatusReq, FdtoScheduleCreateEmployeeProfileReq, FdtoScheduleSaveAssignmentReq, FdtoScheduleSavePositionReq, FdtoScheduleSaveScheduleDayReq, FdtoScheduleUpdateEmployeeProfileReq, FdtoScheduleValidatePosAccessReq, FdtoScheduleCreateTimeOffReq, FdtoScheduleTimeOff, FdtoScheduleUpdateTimeOffStatusReq, FdtoScheduleSaveEmployeeConfigsReq, ScheduleReplaceDemandReq } from '@/types/schedule';
+import { isoDateKey } from './composables/schedule-calendar';
 export { businessEmployees, dataVersion, employeeOutletIds, loadError, loading, outletId, payload, restaurantEmployees, employeeConfigs, rosterLoading, scheduleSetupCompleted, } from './schedule-state';
 /** dayjs-free local-date key — the board's own isoDateKey, repeated here so the store does not
  * have to import a composable. Local Y/M/D, never UTC: a BSON-free 'YYYY-MM-DD' that survives
  * a timezone west of Greenwich. */
-export declare function isoDate(d: Date): string;
+export declare const isoDate: typeof isoDateKey;
 /** Points the board at an outlet. Switching throws the held window away rather than widening
  * it — two outlets' rosters are not one dataset, and half of each is not a schedule.
  *
@@ -33,6 +35,27 @@ export declare function addEmployeeToOutlets(employeeId: string, restaurantIds:
 export declare function removeEmployeeFromOutlets(employeeId: string, restaurantIds: string[]): Promise<void>;
 /** Takes a POS user off this outlet's roster only. */
 export declare function removeEmployeeFromOutlet(employeeId: string): Promise<void>;
+/** Sets the POS role each of these outlets grants a user — every other outlet on their roster
+ * is untouched. An empty roleId means "linked to this outlet, no role assigned" (the same thing
+ * `addEmployeeToOutlets`' default gives), not "remove them from it" — use
+ * `removeEmployeeFromOutlets` for that. A duplicate restaurantId keeps only the last entry. */
+export declare function setEmployeePosRoles(employeeId: string, assignments: {
+    restaurantId: string;
+    roleId: string;
+}[]): Promise<void>;
+/** Saves the POS-owned part of an existing scheduling employee. The scheduling profile and the
+ * POS user are separate records, so passcode/master-user changes must use the POS user API too.
+ * A normalized comparison avoids rewriting the POS user when the employee form was unchanged. */
+export declare function saveEmployeePosAccess(employeeId: string, request: {
+    name: string;
+    passcode: string;
+    masterUser: boolean;
+    masterCode: string;
+    roles: {
+        restaurantId: string;
+        roleId: string;
+    }[];
+}): Promise<void>;
 /** The cached business roster, fetched on first use. `force` re-reads it (after a write, or to
  * refresh a list that is already on screen). Concurrent callers share one request. */
 export declare function ensureBusinessEmployees(force?: boolean): Promise<IFdtoPosUserSummary[]>;
@@ -52,6 +75,7 @@ export declare function reload(): Promise<void>;
  * Throws on failure (a duplicate profile, a network error) — the caller decides how to show
  * that, this just doesn't pretend it succeeded. */
 export declare function createEmployeeProfile(req: FdtoScheduleCreateEmployeeProfileReq): Promise<void>;
+export declare function validateSchedulePosAccess(req: FdtoScheduleValidatePosAccessReq): Promise<void>;
 /** Edits a profile already on this outlet's schedule. The caller (useScheduleAddEmployee's
  * `updateExisting`) applies the form to the live `Employee` object itself for instant feedback,
  * so this does not bump `dataVersion` — nothing needs a board cache rebuild. The raw payload is
@@ -75,15 +99,14 @@ export declare function deletePosition(id: string): Promise<void>;
  * to land there for that seed to stay correct — without a `dataVersion` bump, which would
  * invalidate the per-week employee cache and risk reverting an unsaved shift. */
 export declare function saveScheduleDay(date: string, req: FdtoScheduleSaveScheduleDayReq): Promise<void>;
-/** Replaces one date/weekday's UI demand by expanding every period into flat ShiftDemand rows.
+/** Replaces one date's UI demand by expanding every period into flat ShiftDemand rows.
  * Position-specific headcount becomes its own row; any remaining headcount becomes an
  * unpositioned row for the same time range. */
 export declare function saveDemand(req: ScheduleReplaceDemandReq): Promise<void>;
+export declare function saveDemandsBulk(requests: ScheduleReplaceDemandReq[]): Promise<void>;
 /** Copies one date's own demand rows onto another date, as that date's own rows. A date that
  * already has demand of its own is left alone (nothing is overwritten), and a source date with
- * none has nothing to copy: the standing weekday rule already covers the same weekday in every
- * week, so repeating it per date would only shadow later edits to the rule. Returns how many rows
- * were written. */
+ * no explicit rows has nothing to copy. Returns how many rows were written. */
 export declare function copyDateDemand(fromDate: string, toDate: string): Promise<number>;
 export declare function generateAutoSchedule(req: FdtoScheduleAutoScheduleGenerateReq): Promise<FdtoScheduleAutoScheduleResult>;
 export declare function getAutoScheduleCapabilities(): Promise<FdtoScheduleAutoScheduleCapabilities>;
@@ -96,6 +119,7 @@ export declare function applyAutoSchedule(req: FdtoScheduleAutoScheduleApplyReq)
  * their own to read back from yet). */
 export declare function createAssignment(req: FdtoScheduleSaveAssignmentReq): Promise<FdtoScheduleAssignment>;
 export declare function updateAssignment(id: string, req: FdtoScheduleSaveAssignmentReq): Promise<FdtoScheduleAssignment | null>;
+export declare function bulkSaveAssignments(req: Parameters<typeof ScheduleAPI.bulkSaveAssignments>[1]): Promise<Awaited<ReturnType<typeof ScheduleAPI.bulkSaveAssignments>>>;
 /** Deletes a batch of existing assignments in a single request — see
  * `ScheduleAPI.deleteAssignments`. Deleting one is just this with a single-id array. */
 export declare function deleteAssignments(ids: string[]): Promise<void>;

package/dist/src/views/scheduling/types.d.ts

@@ -8,6 +8,8 @@ export interface WorkSlot {
     start: string;
     end: string;
     role: string;
+    /** The persisted position identity, retained even when the position is soft-deleted. */
+    positionId?: string;
     status: ShiftStatus;
     clock?: ShiftClock;
     conflict?: boolean;
@@ -35,6 +37,8 @@ export interface WorkSlot {
      * round-tripped to the backend yet, or it's an OpenShift fill (see openId), which has its
      * own record shape and no write path of its own yet. */
     assignmentId?: string;
+    /** Server timestamp used to reject stale background saves. */
+    updatedAt?: string;
     /** Client-only — never sent to the backend (there's no linking field in
      * FdtoScheduleAssignment to persist it against). Shared by every period of ONE shift
      * authored through the popover's "+ Split", set there and nowhere else. Two workslots on
@@ -85,6 +89,8 @@ export interface EmployeeAvailHours {
 }
 export interface Employee {
     id: number;
+    /** Stable backend identity. The numeric id is only a board/view-model id. */
+    sourceId: string;
     name: string;
     employmentType: 'FULLTIME' | 'PARTTIME';
     role: string;
@@ -94,11 +100,13 @@ export interface Employee {
     /** Full-time-equivalent percentage, e.g. 100 for a full-timer, 60 for 0.6 FTE. */
     pct: number;
     /** Hours per week this person is contracted to, as agreed with them. Per-person rather than
-     * a venue default: ScheduleSettings holds pay rates only, and EmployeeProfiles.workingHour
+     * a venue default: ScheduleSettings holds pay rates and employee-hour defaults, and EmployeeProfiles.workingHours
      * is where the figure is actually stated. Undefined means nobody has agreed one. */
     contractHours?: number;
     rate: number;
     positions: string[];
+    /** Position references that remain on the employee profile but are no longer active in the catalogue. */
+    archivedPositions?: string[];
     /** One entry per visible day of the horizon; null = day off. */
     shifts: DaySlot[];
     remarks: EmployeeRemark[];
@@ -113,11 +121,18 @@ export interface Employee {
      * hourly figure derived from this and is what the grid actually costs shifts with. */
     payAmount?: number;
     maxHours?: number;
-    maxOtHours?: number;
     /** Shortest shift, in hours, this person will come in for. Asking for less is allowed but
      * warned about in the shift popover. */
     minHours?: number;
-    otAfterDaily?: number;
+    minHoursPerDay?: number;
+    workingHours?: {
+        minHoursPerDay: number | null;
+        maxHoursPerDay: number | null;
+        maxHoursPerWeek: number | null;
+    };
+    overtime?: {
+        maxHoursPerMonth: number | null;
+    };
     preferences?: string[];
     seniority?: 'senior' | 'junior' | '';
     /** Recurring days off (full-timer) or days available (part-timer) — see
@@ -126,6 +141,8 @@ export interface Employee {
     availHours?: EmployeeAvailHours[];
     /** POS sign-in code. Optional: rostering, costing and publishing never depend on it. */
     passcode?: string;
+    /** POS master-user code, when this employee is a master user. */
+    code?: string;
     masterUser?: boolean;
 }
 export interface Section {
@@ -196,7 +213,6 @@ export interface ScheduleRules {
         end: string;
     }>[];
     payRate: PayRate;
-    otAfterDaily: number;
     /** Weekly sales forecast (RM) — the stats row's editable input and the figure the
      * per-day forecast curve distributes across the week. */
     salesForecast: number;
@@ -211,7 +227,12 @@ export interface ScheduleRules {
     /** Weekly labour cap (RM), editable directly when budgetFromSales is false. */
     budget: number;
     /** Monthly OT cap (hours) — Settings page "Overtime" tab. */
-    otCapHours: number;
+    otCapHours: number | null;
+    workingHours: {
+        minHoursPerDay: number | null;
+        maxHoursPerDay: number | null;
+        maxHoursPerWeek: number | null;
+    };
     /** Monthly OT budget (RM), advisory only. */
     otBudget: number;
     notify: {
@@ -227,6 +248,7 @@ export interface ScheduleRules {
 }
 export interface PendingChange {
     empId: number;
+    employeeKey: string;
     dayIdx: number;
     kind: 'add' | 'change' | 'remove';
     label: string;
@@ -285,6 +307,8 @@ export interface ScheduleDayNote {
  * "any position" remainder, which is derived and never stored. */
 export interface DemandRole {
     position: string;
+    /** Persisted position identity; the name is only the display label. */
+    positionId?: string;
     n: number;
 }
 /** A stretch of a day and how many people the floor needs across it. Deliberately not a shift: