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

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

@@ -12,8 +12,8 @@ export declare const scheduleState: {
         timeOff: {
             type: "OFF_DAY" | "LEAVE";
             status: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
-            id: string;
             employeeId: string;
+            id: string;
             leaveType: "UNPAID" | "ANNUAL" | "MEDICAL" | "EMERGENCY" | null;
             startDate: string;
             endDate: string;
@@ -56,6 +56,64 @@ export declare const scheduleState: {
             } | null;
             headcount: number;
         }[];
+        assignments: {
+            status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
+            date: string;
+            startTime: string;
+            endTime: string;
+            employeeId: string;
+            id: string;
+            position: {
+                positionId: string;
+                positionName: string;
+            } | null;
+            breaks: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                breakPayType: "PAID" | "UNPAID";
+                startTime: string;
+                endTime: string;
+            })[];
+            updatedAt: string;
+        }[];
+        positions: {
+            id: string;
+            name: string;
+        }[];
+        employees: {
+            minHoursPerDay?: number | null | undefined;
+            overtime?: {
+                maxHoursPerMonth: number | null;
+            } | undefined;
+            workingHours?: {
+                minHoursPerDay: number | null;
+                maxHoursPerDay: number | null;
+                maxHoursPerWeek: number | null;
+            } | undefined;
+            employeeId: string;
+            name: string;
+            employmentType: "FULLTIME" | "PARTTIME";
+            wage: {
+                type: "HOURLY" | "MONTHLY";
+                amount: number;
+            };
+            primaryPosition: {
+                positionId: string;
+                positionName: string;
+            } | null;
+            secondaryPositions: {
+                positionId: string;
+                positionName: string;
+            }[];
+            availability: {
+                dayOfWeek: number;
+                start: string;
+                end: string;
+            }[];
+        }[];
         settings: {
             settingsConfigured?: boolean | undefined;
             overtime: {
@@ -91,70 +149,12 @@ export declare const scheduleState: {
                 closed: boolean;
             }[];
         };
-        positions: {
-            id: string;
-            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";
-            wage: {
-                type: "HOURLY" | "MONTHLY";
-                amount: number;
-            };
-            primaryPosition: {
-                positionId: string;
-                positionName: string;
-            } | null;
-            secondaryPositions: {
-                positionId: string;
-                positionName: string;
-            }[];
-            availability: {
-                dayOfWeek: number;
-                start: string;
-                end: string;
-            }[];
-        }[];
-        assignments: {
-            status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
-            date: string;
-            startTime: string;
-            endTime: string;
-            id: string;
-            employeeId: string;
-            position: {
-                positionId: string;
-                positionName: string;
-            } | null;
-            breaks: ({
-                type: "DURATION";
-                minutes: number;
-                breakPayType: "PAID" | "UNPAID";
-            } | {
-                type: "TIME_RANGE";
-                breakPayType: "PAID" | "UNPAID";
-                startTime: string;
-                endTime: string;
-            })[];
-            updatedAt: string;
-        }[];
     } | null, {
         timeOff: {
             type: "OFF_DAY" | "LEAVE";
             status: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
-            id: string;
             employeeId: string;
+            id: string;
             leaveType: "UNPAID" | "ANNUAL" | "MEDICAL" | "EMERGENCY" | null;
             startDate: string;
             endDate: string;
@@ -197,6 +197,64 @@ export declare const scheduleState: {
             } | null;
             headcount: number;
         }[];
+        assignments: {
+            status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
+            date: string;
+            startTime: string;
+            endTime: string;
+            employeeId: string;
+            id: string;
+            position: {
+                positionId: string;
+                positionName: string;
+            } | null;
+            breaks: ({
+                type: "DURATION";
+                minutes: number;
+                breakPayType: "PAID" | "UNPAID";
+            } | {
+                type: "TIME_RANGE";
+                breakPayType: "PAID" | "UNPAID";
+                startTime: string;
+                endTime: string;
+            })[];
+            updatedAt: string;
+        }[];
+        positions: {
+            id: string;
+            name: string;
+        }[];
+        employees: {
+            minHoursPerDay?: number | null | undefined;
+            overtime?: {
+                maxHoursPerMonth: number | null;
+            } | undefined;
+            workingHours?: {
+                minHoursPerDay: number | null;
+                maxHoursPerDay: number | null;
+                maxHoursPerWeek: number | null;
+            } | undefined;
+            employeeId: string;
+            name: string;
+            employmentType: "FULLTIME" | "PARTTIME";
+            wage: {
+                type: "HOURLY" | "MONTHLY";
+                amount: number;
+            };
+            primaryPosition: {
+                positionId: string;
+                positionName: string;
+            } | null;
+            secondaryPositions: {
+                positionId: string;
+                positionName: string;
+            }[];
+            availability: {
+                dayOfWeek: number;
+                start: string;
+                end: string;
+            }[];
+        }[];
         settings: {
             settingsConfigured?: boolean | undefined;
             overtime: {
@@ -232,64 +290,6 @@ export declare const scheduleState: {
                 closed: boolean;
             }[];
         };
-        positions: {
-            id: string;
-            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";
-            wage: {
-                type: "HOURLY" | "MONTHLY";
-                amount: number;
-            };
-            primaryPosition: {
-                positionId: string;
-                positionName: string;
-            } | null;
-            secondaryPositions: {
-                positionId: string;
-                positionName: string;
-            }[];
-            availability: {
-                dayOfWeek: number;
-                start: string;
-                end: string;
-            }[];
-        }[];
-        assignments: {
-            status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
-            date: string;
-            startTime: string;
-            endTime: string;
-            id: string;
-            employeeId: string;
-            position: {
-                positionId: string;
-                positionName: string;
-            } | null;
-            breaks: ({
-                type: "DURATION";
-                minutes: number;
-                breakPayType: "PAID" | "UNPAID";
-            } | {
-                type: "TIME_RANGE";
-                breakPayType: "PAID" | "UNPAID";
-                startTime: string;
-                endTime: string;
-            })[];
-            updatedAt: string;
-        }[];
     } | null>;
     loading: import("vue").Ref<boolean, boolean>;
     rosterLoading: import("vue").Ref<boolean, boolean>;
@@ -400,8 +400,8 @@ export declare const payload: import("vue").ShallowRef<{
     timeOff: {
         type: "OFF_DAY" | "LEAVE";
         status: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
-        id: string;
         employeeId: string;
+        id: string;
         leaveType: "UNPAID" | "ANNUAL" | "MEDICAL" | "EMERGENCY" | null;
         startDate: string;
         endDate: string;
@@ -444,6 +444,64 @@ export declare const payload: import("vue").ShallowRef<{
         } | null;
         headcount: number;
     }[];
+    assignments: {
+        status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
+        date: string;
+        startTime: string;
+        endTime: string;
+        employeeId: string;
+        id: string;
+        position: {
+            positionId: string;
+            positionName: string;
+        } | null;
+        breaks: ({
+            type: "DURATION";
+            minutes: number;
+            breakPayType: "PAID" | "UNPAID";
+        } | {
+            type: "TIME_RANGE";
+            breakPayType: "PAID" | "UNPAID";
+            startTime: string;
+            endTime: string;
+        })[];
+        updatedAt: string;
+    }[];
+    positions: {
+        id: string;
+        name: string;
+    }[];
+    employees: {
+        minHoursPerDay?: number | null | undefined;
+        overtime?: {
+            maxHoursPerMonth: number | null;
+        } | undefined;
+        workingHours?: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        } | undefined;
+        employeeId: string;
+        name: string;
+        employmentType: "FULLTIME" | "PARTTIME";
+        wage: {
+            type: "HOURLY" | "MONTHLY";
+            amount: number;
+        };
+        primaryPosition: {
+            positionId: string;
+            positionName: string;
+        } | null;
+        secondaryPositions: {
+            positionId: string;
+            positionName: string;
+        }[];
+        availability: {
+            dayOfWeek: number;
+            start: string;
+            end: string;
+        }[];
+    }[];
     settings: {
         settingsConfigured?: boolean | undefined;
         overtime: {
@@ -479,70 +537,12 @@ export declare const payload: import("vue").ShallowRef<{
             closed: boolean;
         }[];
     };
-    positions: {
-        id: string;
-        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";
-        wage: {
-            type: "HOURLY" | "MONTHLY";
-            amount: number;
-        };
-        primaryPosition: {
-            positionId: string;
-            positionName: string;
-        } | null;
-        secondaryPositions: {
-            positionId: string;
-            positionName: string;
-        }[];
-        availability: {
-            dayOfWeek: number;
-            start: string;
-            end: string;
-        }[];
-    }[];
-    assignments: {
-        status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
-        date: string;
-        startTime: string;
-        endTime: string;
-        id: string;
-        employeeId: string;
-        position: {
-            positionId: string;
-            positionName: string;
-        } | null;
-        breaks: ({
-            type: "DURATION";
-            minutes: number;
-            breakPayType: "PAID" | "UNPAID";
-        } | {
-            type: "TIME_RANGE";
-            breakPayType: "PAID" | "UNPAID";
-            startTime: string;
-            endTime: string;
-        })[];
-        updatedAt: string;
-    }[];
 } | null, {
     timeOff: {
         type: "OFF_DAY" | "LEAVE";
         status: "PENDING" | "APPROVED" | "REJECTED" | "CANCELLED";
-        id: string;
         employeeId: string;
+        id: string;
         leaveType: "UNPAID" | "ANNUAL" | "MEDICAL" | "EMERGENCY" | null;
         startDate: string;
         endDate: string;
@@ -585,6 +585,64 @@ export declare const payload: import("vue").ShallowRef<{
         } | null;
         headcount: number;
     }[];
+    assignments: {
+        status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
+        date: string;
+        startTime: string;
+        endTime: string;
+        employeeId: string;
+        id: string;
+        position: {
+            positionId: string;
+            positionName: string;
+        } | null;
+        breaks: ({
+            type: "DURATION";
+            minutes: number;
+            breakPayType: "PAID" | "UNPAID";
+        } | {
+            type: "TIME_RANGE";
+            breakPayType: "PAID" | "UNPAID";
+            startTime: string;
+            endTime: string;
+        })[];
+        updatedAt: string;
+    }[];
+    positions: {
+        id: string;
+        name: string;
+    }[];
+    employees: {
+        minHoursPerDay?: number | null | undefined;
+        overtime?: {
+            maxHoursPerMonth: number | null;
+        } | undefined;
+        workingHours?: {
+            minHoursPerDay: number | null;
+            maxHoursPerDay: number | null;
+            maxHoursPerWeek: number | null;
+        } | undefined;
+        employeeId: string;
+        name: string;
+        employmentType: "FULLTIME" | "PARTTIME";
+        wage: {
+            type: "HOURLY" | "MONTHLY";
+            amount: number;
+        };
+        primaryPosition: {
+            positionId: string;
+            positionName: string;
+        } | null;
+        secondaryPositions: {
+            positionId: string;
+            positionName: string;
+        }[];
+        availability: {
+            dayOfWeek: number;
+            start: string;
+            end: string;
+        }[];
+    }[];
     settings: {
         settingsConfigured?: boolean | undefined;
         overtime: {
@@ -620,64 +678,6 @@ export declare const payload: import("vue").ShallowRef<{
             closed: boolean;
         }[];
     };
-    positions: {
-        id: string;
-        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";
-        wage: {
-            type: "HOURLY" | "MONTHLY";
-            amount: number;
-        };
-        primaryPosition: {
-            positionId: string;
-            positionName: string;
-        } | null;
-        secondaryPositions: {
-            positionId: string;
-            positionName: string;
-        }[];
-        availability: {
-            dayOfWeek: number;
-            start: string;
-            end: string;
-        }[];
-    }[];
-    assignments: {
-        status: "DRAFT" | "PUBLISHED" | "CONFIRMED";
-        date: string;
-        startTime: string;
-        endTime: string;
-        id: string;
-        employeeId: string;
-        position: {
-            positionId: string;
-            positionName: string;
-        } | null;
-        breaks: ({
-            type: "DURATION";
-            minutes: number;
-            breakPayType: "PAID" | "UNPAID";
-        } | {
-            type: "TIME_RANGE";
-            breakPayType: "PAID" | "UNPAID";
-            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;
     name: string;

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

@@ -1,6 +1,6 @@
 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, FdtoScheduleValidatePosAccessReq, FdtoScheduleCreateTimeOffReq, FdtoScheduleTimeOff, FdtoScheduleUpdateTimeOffStatusReq, FdtoScheduleSaveEmployeeConfigsReq, ScheduleReplaceDemandReq } from '@/types/schedule';
+import type { FdtoScheduleAssignment, FdtoScheduleAutoScheduleApplyReq, FdtoScheduleAutoScheduleApplyResult, FdtoScheduleAutoScheduleCapabilities, FdtoScheduleAutoScheduleGenerateReq, FdtoScheduleAutoScheduleResult, FdtoScheduleBulkUpdateAssignmentStatusReq, FdtoScheduleCreateEmployeeProfileReq, FdtoScheduleSaveAssignmentReq, FdtoScheduleSavePositionReq, FdtoScheduleSaveScheduleDayReq, FdtoScheduleSaveSettingsReq, FdtoScheduleSettings, 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
@@ -21,7 +21,11 @@ export declare function setOutlet(restaurantId: string): boolean;
  * headcounts sit nowhere near it. */
 export declare function ensureRestaurantEmployeesLoaded(restaurantId: string): Promise<void>;
 export declare function saveEmployeeConfigs(configs: FdtoScheduleSaveEmployeeConfigsReq['configs']): Promise<void>;
+/** Saves outlet settings and keeps the board payload authoritative for any later cache rebuild. */
+export declare function saveScheduleSettings(req: FdtoScheduleSaveSettingsReq): Promise<FdtoScheduleSettings>;
 export declare function setEmployeeSchedulingEnabled(employeeId: string, enabled: boolean): Promise<void>;
+/** Removes this employee's future shifts before disabling their scheduling row. */
+export declare function deleteEmployeeFutureAssignments(employeeId: string, from?: string): Promise<void>;
 /** Re-reads this outlet's POS roster. The roster is what the board's rows are built from and is
  * otherwise fetched once per outlet, so any write that changes who works here (add, remove)
  * has to call this for the grid to show it. */
@@ -30,7 +34,7 @@ export declare function refreshRestaurantEmployees(): Promise<void>;
 export declare function addEmployeeToOutlet(employeeId: string, roleId: string): Promise<void>;
 /** Adds an employee to several outlets at once. Scheduling does not require a POS role, so the
  * caller may pass an empty role id and assign the POS role later from Employee. */
-export declare function addEmployeeToOutlets(employeeId: string, restaurantIds: string[], roleId?: string): Promise<void>;
+export declare function addEmployeeToOutlets(employeeId: string, restaurantIds: string[], roleId?: string, enableScheduling?: boolean): Promise<void>;
 /** Takes a POS user off the given outlets' rosters; their other outlets are untouched. */
 export declare function removeEmployeeFromOutlets(employeeId: string, restaurantIds: string[]): Promise<void>;
 /** Takes a POS user off this outlet's roster only. */
@@ -43,6 +47,19 @@ 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;
+    }[];
+}, knownEmployee?: IFdtoPosUserSummary): 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[]>;
@@ -99,14 +116,16 @@ export declare function generateAutoSchedule(req: FdtoScheduleAutoScheduleGenera
 export declare function getAutoScheduleCapabilities(): Promise<FdtoScheduleAutoScheduleCapabilities>;
 export declare function applyAutoSchedule(req: FdtoScheduleAutoScheduleApplyReq): Promise<FdtoScheduleAutoScheduleApplyResult>;
 /** A one-off shift assignment — someone working these hours on this date, not answering any
- * Shift requirement. Deliberately does not reload: unlike `createEmployeeProfile` above, there
- * is nothing here a reload could bring back that the caller doesn't already have — `commitShift`
- * writes `assignmentId` onto the slot itself once this resolves, and a reload would only risk
- * discarding some OTHER unsaved shift elsewhere on the board (shifts have no write path of
- * their own to read back from yet). */
+ * Shift requirement. Keep the raw payload in sync without bumping `dataVersion`: the current
+ * board owns the live draft, while a later roster refresh may rebuild the week cache from this
+ * payload. */
 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>>>;
+/** Replaces demand and/or assignments in one backend transaction. */
+export declare function copySchedule(req: Parameters<typeof ScheduleAPI.copySchedule>[1]): Promise<Awaited<ReturnType<typeof ScheduleAPI.copySchedule>>>;
+/** Clears demand and/or assignments in one backend transaction. */
+export declare function clearSchedule(req: Parameters<typeof ScheduleAPI.clearSchedule>[1]): Promise<Awaited<ReturnType<typeof ScheduleAPI.clearSchedule>>>;
 /** 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

@@ -109,6 +109,9 @@ export interface Employee {
     archivedPositions?: string[];
     /** One entry per visible day of the horizon; null = day off. */
     shifts: DaySlot[];
+    /** Dated time-off records are kept beside shifts so an off/leave card remains visible when
+     * a manager adds a shift on the same day. */
+    timeOff?: Array<LeaveSlot | null>;
     remarks: EmployeeRemark[];
     section: string;
     compGroup?: string;
@@ -141,6 +144,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 {
@@ -250,6 +255,7 @@ export interface PendingChange {
     dayIdx: number;
     kind: 'add' | 'change' | 'remove';
     label: string;
+    conflict?: boolean;
 }
 export type NotifyChannel = 'wa' | 'push' | 'email';
 export interface ScheduleVersionSnapshot {
@@ -370,4 +376,6 @@ export interface Proposal {
     weekKey?: string;
     /** Why this person, for the card's tooltip. */
     reason?: string;
+    /** Set when the server already knows applying this row would be refused; it starts rejected. */
+    rejectReason?: string;
 }