@feedmepos/mf-hrm-portal 2.2.5 → 2.3.0-dev

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

@@ -0,0 +1,97 @@
+import type { Employee, OpenShift, Section } from './types';
+import type { FdtoSchedulePositionSelectorReq } from '@/types/schedule';
+export { COMPGRP_META, COMPGRP_OPTIONS, DEPT_OPTIONS, EXISTING_STAFF, LOCATION_LABEL_BY_ID, LOCATION_OPTIONS, OUTLET, POSITION_RECORDS, POSITIONS, ROLE_POSITIONS, RULES, SHIFT_TEMPLATES, } from './schedule-state';
+export declare const UNASSIGNED = "unassigned";
+export declare const WEEKDAYS: string[];
+export declare const ALL_STATIONS = "All Stations";
+/** Employment seniority is a closed set in the model, not something an outlet configures. */
+export declare const SENIORITY_OPTIONS: Array<'senior' | 'junior'>;
+/** The one section every board has. Scheduling sections are not a Mongo concept yet, so the
+ * whole roster sits in this bucket and its `roles` list stays empty. */
+export declare const SECTIONS: Section[];
+/** The position catalogue, from the Positions collection. Name-only: this is read as plain
+ * strings everywhere on this board (dropdown options, coverage-matrix keys, role lookups), and
+ * changing its shape would touch every one of those. */
+/** The same catalogue, kept with its real backend id — the id-less `POSITIONS` above can't
+ * identify which document to edit or delete. Only the Position management page reads this. */
+/** Resolves a position name (every picker on this board only ever offers a name — see
+ * `POSITIONS` above) to its backend id, for save requests that can now name a position by id
+ * instead. `undefined` when the catalogue hasn't loaded yet or the name no longer matches one —
+ * callers still send the name alongside, so the backend's own by-name lookup is the fallback. */
+export declare function positionIdOf(name: string): string | undefined;
+/** The selector shape every position-carrying save request wants — `undefined` for a blank
+ * name (the field itself has nothing to name), a resolved id alongside the name otherwise. */
+export declare function positionSelectorOf(name: string | undefined): FdtoSchedulePositionSelectorReq | undefined;
+/** Which coverage positions a station label counts toward. Positions ARE the roles in this
+ * model — a shift records the position it is for — so nothing needs translating and this stays
+ * empty, which makes `positionKeyOf()` pass a role through unchanged. */
+/** The outlet this board is scheduling, from the Restaurants document. An object rather than a
+ * bare string so the two components that name it re-render when it arrives. */
+/** Outlets a person may be rostered at. Filled by useScheduleOutlet from the restaurant store
+ * — the board payload only ever describes the one outlet it was asked for. */
+/** Outlet id → name, so a person's POS `restaurantRole` (outlet ids) can be shown as the same
+ * labels LOCATION_OPTIONS offers. Filled alongside it by useScheduleOutlet. */
+/** No Mongo source: departments and compensation groups are not modelled. The Add Employee
+ * form renders these as empty pickers rather than offering choices nobody configured. */
+/** Candidates for "add an employee who already exists elsewhere in the business". No source
+ * yet — EmployeeProfiles is per-outlet, and the business-wide directory lives in CouchDB. */
+/** The venue's shift patterns. No collection holds these yet; consumers already handle an empty
+ * list by falling back to the trading window in RULES. */
+/** Mon → Sun weighting used to spread a weekly sales forecast across days. Flat while there is
+ * no real forecast to shape: a curve invented here would make one day look busier than another
+ * for no reason anybody could point at. */
+export declare const SALES_CURVE: number[];
+/** Scheduling configuration, from two places and no others: `payRate` is the whole content of
+ * the ScheduleSettings document, and the trading window comes from the outlet's own Restaurants
+ * profile (see `restaurantProfile` on the DTO).
+ *
+ * The fields with no Mongo source stay zero rather than being guessed: `coverage` (per-template
+ * headcount matrices), `salesForecast`, `labourTarget`, `budget`, the OT caps and the
+ * notification channels. Nothing on screen derived from them is a figure this file made up.
+ *
+ * `openFrom`/`openTo` are the one pair that must never be blank — they are the axis every
+ * coverage bar, day timeline and shift form is drawn against, and there is no such thing as a
+ * zero-length day to draw. A neutral 00:00–24:00 stands in until a real window lands.
+ *
+ * `payRate` defaults to the same statutory baseline the API does when an outlet hasn't saved its
+ * own rates: 1.5× normal-day OT, 2× off-day OT, 3× public-holiday OT; 1× off-day regular, 2×
+ * public-holiday regular. */
+/** JS `getDay()` (0 = Sunday) → grid column (0 = Monday). */
+export declare function gridDayIdx(dayOfWeek: number): number;
+/** Grid column (0 = Monday) → JS `getDay()` (0 = Sunday). Inverse of gridDayIdx — needed
+ * wherever the board writes a day back to Mongo instead of reading one from it. */
+export declare function jsDayOfWeek(gridIdx: number): number;
+export declare function employeeIdOf(num: number): string | undefined;
+export declare function employeeNumberOf(employeeId: string): number;
+/** The outlets a person is rostered at, by name, from the POS roster's `restaurantRole`. */
+/** The outlet being scheduled goes first in a list of locations; the rest keep their order. */
+export declare function currentLocationFirst(locations: string[]): string[];
+export declare function createScheduleEmployees(dates?: Date[]): Employee[];
+/** Open shifts backed by a persisted Shift requirement never shipped — the backend never
+ * carried that collection, so this always produced an empty list in practice. Kept as a stub,
+ * rather than removed, so the week cache's seed call (`schedule-week-cache.ts`) doesn't need
+ * its own special-casing: every open-shift row on the board today is added ad hoc through the
+ * shift popover instead (`useScheduleShiftPopover`'s `pushOpenShift`), entirely in local state. */
+export declare function createScheduleOpenShifts(): OpenShift[];
+/** Staffing demand for the held window, in the shape useScheduleDemand stores it: dated
+ * overrides keyed by ISO date, standing rules keyed by grid weekday. */
+export declare function scheduleDemand(): {
+    byDate: Record<string, Array<{
+        from: string;
+        to: string;
+        n: number;
+        roles: Array<{
+            position: string;
+            n: number;
+        }>;
+    }>>;
+    byWeekday: Record<number, Array<{
+        from: string;
+        to: string;
+        n: number;
+        roles: Array<{
+            position: string;
+            n: number;
+        }>;
+    }>>;
+};

package/dist/src/views/scheduling/locales/index.d.ts

@@ -0,0 +1,608 @@
+import * as enUS from './en-US.json';
+export type AppMessagesSchema = typeof enUS;
+export declare const i18nMessages: {
+    'en-US': {
+        scheduling: {
+            nav: {
+                section: string;
+                board: string;
+                position: string;
+                general: string;
+            };
+            topbar: {
+                title: string;
+                today: string;
+                autoSchedule: string;
+                actions: string;
+                share: string;
+                publish: string;
+                settings: string;
+                copyFromLastWeek: string;
+                copyToNextWeek: string;
+                demandAndShifts: string;
+                demandOnly: string;
+                clear: string;
+                clearShiftsAndDemand: string;
+                clearShifts: string;
+                clearDemand: string;
+                pdfDescription: string;
+                imageDescription: string;
+                exportSchedule: string;
+                clearAllShifts: string;
+                comingSoon: string;
+            };
+            welcome: {
+                eyebrow: string;
+                outletSetup: string;
+                title: string;
+                subtitle: string;
+                setUp: string;
+                skip: string;
+                previewLabel: string;
+                cap1Label: string;
+                cap1Description: string;
+                cap2Label: string;
+                cap2Description: string;
+                cap3Label: string;
+                cap3Description: string;
+            };
+            status: {
+                draft: string;
+                published: string;
+            };
+            staffRail: {
+                title: string;
+                dragHint: string;
+                searchPlaceholder: string;
+                sortLoad: string;
+                sortName: string;
+                sortHours: string;
+                sortCost: string;
+                addEmployee: string;
+                openShifts: string;
+                allCovered: string;
+                openRemaining: string;
+                noPositionsAdded: string;
+                noPositionTitle: string;
+            };
+            grid: {
+                employeeColumn: string;
+                scrollEarlier: string;
+                scrollLater: string;
+            };
+            costRail: {
+                title: string;
+                weekly: string;
+                monthlyOt: string;
+                used: string;
+            };
+            shiftEditor: {
+                title: string;
+                newTitle: string;
+                start: string;
+                end: string;
+                role: string;
+                headcount: string;
+                repeat: string;
+                splitShift: string;
+                addSplit: string;
+                delete: string;
+                save: string;
+                cancel: string;
+            };
+            assign: {
+                title: string;
+                searchPlaceholder: string;
+                noMatches: string;
+                assign: string;
+            };
+            leave: {
+                title: string;
+                approve: string;
+                reject: string;
+                remove: string;
+                appliedOn: string;
+                balance: string;
+            };
+            clash: {
+                title: string;
+                proceed: string;
+                cancel: string;
+            };
+            clearShifts: {
+                title: string;
+                body: string;
+                confirm: string;
+                cancel: string;
+            };
+            addEmployee: {
+                title: string;
+                stepDetails: string;
+                stepAvailability: string;
+                name: string;
+                role: string;
+                location: string;
+                department: string;
+                compGroup: string;
+                employment: string;
+                fullTime: string;
+                partTime: string;
+                weeklyAvailability: string;
+                timeOffDays: string;
+                selectExisting: string;
+                back: string;
+                next: string;
+                create: string;
+            };
+            selectExisting: {
+                title: string;
+                subtitle: string;
+            };
+            employeeProfile: {
+                weekHours: string;
+                remarks: string;
+                positions: string;
+                rate: string;
+            };
+            dateRange: {
+                today: string;
+                thisWeek: string;
+                nextWeek: string;
+            };
+            comingSoon: string;
+        };
+    };
+    'zh-CN': {
+        scheduling: {
+            nav: {
+                section: string;
+                board: string;
+                position: string;
+                general: string;
+            };
+            topbar: {
+                title: string;
+                today: string;
+                autoSchedule: string;
+                actions: string;
+                share: string;
+                publish: string;
+                settings: string;
+                copyFromLastWeek: string;
+                copyToNextWeek: string;
+                demandAndShifts: string;
+                demandOnly: string;
+                clear: string;
+                clearShiftsAndDemand: string;
+                clearShifts: string;
+                clearDemand: string;
+                pdfDescription: string;
+                imageDescription: string;
+                exportSchedule: string;
+                clearAllShifts: string;
+                comingSoon: string;
+            };
+            welcome: {
+                eyebrow: string;
+                outletSetup: string;
+                title: string;
+                subtitle: string;
+                setUp: string;
+                skip: string;
+                previewLabel: string;
+                cap1Label: string;
+                cap1Description: string;
+                cap2Label: string;
+                cap2Description: string;
+                cap3Label: string;
+                cap3Description: string;
+            };
+            status: {
+                draft: string;
+                published: string;
+            };
+            staffRail: {
+                title: string;
+                dragHint: string;
+                searchPlaceholder: string;
+                sortLoad: string;
+                sortName: string;
+                sortHours: string;
+                sortCost: string;
+                addEmployee: string;
+                openShifts: string;
+                allCovered: string;
+                openRemaining: string;
+                noPositionsAdded: string;
+                noPositionTitle: string;
+            };
+            grid: {
+                employeeColumn: string;
+                scrollEarlier: string;
+                scrollLater: string;
+            };
+            costRail: {
+                title: string;
+                weekly: string;
+                monthlyOt: string;
+                used: string;
+            };
+            shiftEditor: {
+                title: string;
+                newTitle: string;
+                start: string;
+                end: string;
+                role: string;
+                headcount: string;
+                repeat: string;
+                splitShift: string;
+                addSplit: string;
+                delete: string;
+                save: string;
+                cancel: string;
+            };
+            assign: {
+                title: string;
+                searchPlaceholder: string;
+                noMatches: string;
+                assign: string;
+            };
+            leave: {
+                title: string;
+                approve: string;
+                reject: string;
+                remove: string;
+                appliedOn: string;
+                balance: string;
+            };
+            clash: {
+                title: string;
+                proceed: string;
+                cancel: string;
+            };
+            clearShifts: {
+                title: string;
+                body: string;
+                confirm: string;
+                cancel: string;
+            };
+            addEmployee: {
+                title: string;
+                stepDetails: string;
+                stepAvailability: string;
+                name: string;
+                role: string;
+                location: string;
+                department: string;
+                compGroup: string;
+                employment: string;
+                fullTime: string;
+                partTime: string;
+                weeklyAvailability: string;
+                timeOffDays: string;
+                selectExisting: string;
+                back: string;
+                next: string;
+                create: string;
+            };
+            selectExisting: {
+                title: string;
+                subtitle: string;
+            };
+            employeeProfile: {
+                weekHours: string;
+                remarks: string;
+                positions: string;
+                rate: string;
+            };
+            dateRange: {
+                today: string;
+                thisWeek: string;
+                nextWeek: string;
+            };
+            comingSoon: string;
+        };
+    };
+    'th-TH': {
+        scheduling: {
+            nav: {
+                section: string;
+                board: string;
+                position: string;
+                general: string;
+            };
+            topbar: {
+                title: string;
+                today: string;
+                autoSchedule: string;
+                actions: string;
+                share: string;
+                publish: string;
+                settings: string;
+                copyFromLastWeek: string;
+                copyToNextWeek: string;
+                demandAndShifts: string;
+                demandOnly: string;
+                clear: string;
+                clearShiftsAndDemand: string;
+                clearShifts: string;
+                clearDemand: string;
+                pdfDescription: string;
+                imageDescription: string;
+                exportSchedule: string;
+                clearAllShifts: string;
+                comingSoon: string;
+            };
+            welcome: {
+                eyebrow: string;
+                outletSetup: string;
+                title: string;
+                subtitle: string;
+                setUp: string;
+                skip: string;
+                previewLabel: string;
+                cap1Label: string;
+                cap1Description: string;
+                cap2Label: string;
+                cap2Description: string;
+                cap3Label: string;
+                cap3Description: string;
+            };
+            status: {
+                draft: string;
+                published: string;
+            };
+            staffRail: {
+                title: string;
+                dragHint: string;
+                searchPlaceholder: string;
+                sortLoad: string;
+                sortName: string;
+                sortHours: string;
+                sortCost: string;
+                addEmployee: string;
+                openShifts: string;
+                allCovered: string;
+                openRemaining: string;
+                noPositionsAdded: string;
+                noPositionTitle: string;
+            };
+            grid: {
+                employeeColumn: string;
+                scrollEarlier: string;
+                scrollLater: string;
+            };
+            costRail: {
+                title: string;
+                weekly: string;
+                monthlyOt: string;
+                used: string;
+            };
+            shiftEditor: {
+                title: string;
+                newTitle: string;
+                start: string;
+                end: string;
+                role: string;
+                headcount: string;
+                repeat: string;
+                splitShift: string;
+                addSplit: string;
+                delete: string;
+                save: string;
+                cancel: string;
+            };
+            assign: {
+                title: string;
+                searchPlaceholder: string;
+                noMatches: string;
+                assign: string;
+            };
+            leave: {
+                title: string;
+                approve: string;
+                reject: string;
+                remove: string;
+                appliedOn: string;
+                balance: string;
+            };
+            clash: {
+                title: string;
+                proceed: string;
+                cancel: string;
+            };
+            clearShifts: {
+                title: string;
+                body: string;
+                confirm: string;
+                cancel: string;
+            };
+            addEmployee: {
+                title: string;
+                stepDetails: string;
+                stepAvailability: string;
+                name: string;
+                role: string;
+                location: string;
+                department: string;
+                compGroup: string;
+                employment: string;
+                fullTime: string;
+                partTime: string;
+                weeklyAvailability: string;
+                timeOffDays: string;
+                selectExisting: string;
+                back: string;
+                next: string;
+                create: string;
+            };
+            selectExisting: {
+                title: string;
+                subtitle: string;
+            };
+            employeeProfile: {
+                weekHours: string;
+                remarks: string;
+                positions: string;
+                rate: string;
+            };
+            dateRange: {
+                today: string;
+                thisWeek: string;
+                nextWeek: string;
+            };
+            comingSoon: string;
+        };
+    };
+    'zh-Hant': {
+        scheduling: {
+            nav: {
+                section: string;
+                board: string;
+                position: string;
+                general: string;
+            };
+            topbar: {
+                title: string;
+                today: string;
+                autoSchedule: string;
+                actions: string;
+                share: string;
+                publish: string;
+                settings: string;
+                copyFromLastWeek: string;
+                copyToNextWeek: string;
+                demandAndShifts: string;
+                demandOnly: string;
+                clear: string;
+                clearShiftsAndDemand: string;
+                clearShifts: string;
+                clearDemand: string;
+                pdfDescription: string;
+                imageDescription: string;
+                exportSchedule: string;
+                clearAllShifts: string;
+                comingSoon: string;
+            };
+            welcome: {
+                eyebrow: string;
+                outletSetup: string;
+                title: string;
+                subtitle: string;
+                setUp: string;
+                skip: string;
+                previewLabel: string;
+                cap1Label: string;
+                cap1Description: string;
+                cap2Label: string;
+                cap2Description: string;
+                cap3Label: string;
+                cap3Description: string;
+            };
+            status: {
+                draft: string;
+                published: string;
+            };
+            staffRail: {
+                title: string;
+                dragHint: string;
+                searchPlaceholder: string;
+                sortLoad: string;
+                sortName: string;
+                sortHours: string;
+                sortCost: string;
+                addEmployee: string;
+                openShifts: string;
+                allCovered: string;
+                openRemaining: string;
+                noPositionsAdded: string;
+                noPositionTitle: string;
+            };
+            grid: {
+                employeeColumn: string;
+                scrollEarlier: string;
+                scrollLater: string;
+            };
+            costRail: {
+                title: string;
+                weekly: string;
+                monthlyOt: string;
+                used: string;
+            };
+            shiftEditor: {
+                title: string;
+                newTitle: string;
+                start: string;
+                end: string;
+                role: string;
+                headcount: string;
+                repeat: string;
+                splitShift: string;
+                addSplit: string;
+                delete: string;
+                save: string;
+                cancel: string;
+            };
+            assign: {
+                title: string;
+                searchPlaceholder: string;
+                noMatches: string;
+                assign: string;
+            };
+            leave: {
+                title: string;
+                approve: string;
+                reject: string;
+                remove: string;
+                appliedOn: string;
+                balance: string;
+            };
+            clash: {
+                title: string;
+                proceed: string;
+                cancel: string;
+            };
+            clearShifts: {
+                title: string;
+                body: string;
+                confirm: string;
+                cancel: string;
+            };
+            addEmployee: {
+                title: string;
+                stepDetails: string;
+                stepAvailability: string;
+                name: string;
+                role: string;
+                location: string;
+                department: string;
+                compGroup: string;
+                employment: string;
+                fullTime: string;
+                partTime: string;
+                weeklyAvailability: string;
+                timeOffDays: string;
+                selectExisting: string;
+                back: string;
+                next: string;
+                create: string;
+            };
+            selectExisting: {
+                title: string;
+                subtitle: string;
+            };
+            employeeProfile: {
+                weekHours: string;
+                remarks: string;
+                positions: string;
+                rate: string;
+            };
+            dateRange: {
+                today: string;
+                thisWeek: string;
+                nextWeek: string;
+            };
+            comingSoon: string;
+        };
+    };
+};