@feedmepos/mf-hrm-portal 2.3.0-dev.19 → 2.3.0-dev.20

package/dist/src/views/scheduling/composables/useScheduleAutoSchedule.d.ts

@@ -0,0 +1,297 @@
+import type { FdtoScheduleAutoScheduleObjective, FdtoScheduleAutoSchedulePlanner } from '@/types/schedule';
+import type { Proposal } from '../types';
+import type { ScheduleBoardApi } from './useScheduleBoard';
+import type { ScheduleDemandApi } from './useScheduleDemand';
+export type ScheduleAutoScheduleStep = 'options' | 'summary';
+export interface ScheduleAutoScheduleOptions {
+    fillGaps: boolean;
+    objective: FdtoScheduleAutoScheduleObjective;
+    planner: FdtoScheduleAutoSchedulePlanner;
+    allowOvertime: boolean;
+    /** Shown as preferences in the dialog but not sent: the generator takes no input for them yet
+     * (availability and time off are always respected; patterns and cost ride on the objective). */
+    respectAvailability: boolean;
+    followPatterns: boolean;
+    costEfficient: boolean;
+}
+/** Backend-powered draft generation and local proposal review — the engine lives in hr-backend;
+ * this composable only maps its result onto the board and lets a manager review it. Generation
+ * never writes; accepted proposals use the board's existing assignment persistence path. */
+export declare function useScheduleAutoSchedule(board: ScheduleBoardApi, demand: ScheduleDemandApi): {
+    wizardOpen: import("vue").Ref<boolean, boolean>;
+    step: import("vue").Ref<ScheduleAutoScheduleStep, ScheduleAutoScheduleStep>;
+    options: {
+        fillGaps: boolean;
+        objective: FdtoScheduleAutoScheduleObjective;
+        planner: FdtoScheduleAutoSchedulePlanner;
+        allowOvertime: boolean;
+        respectAvailability: boolean;
+        followPatterns: boolean;
+        costEfficient: boolean;
+    };
+    planners: import("vue").Ref<("GREEDY" | "LLM")[], ("GREEDY" | "LLM")[]>;
+    plannerChoice: import("vue").ComputedRef<boolean>;
+    generating: import("vue").Ref<boolean, boolean>;
+    generateError: import("vue").Ref<string | null, string | null>;
+    result: import("vue").Ref<{
+        objective: "BALANCED" | "SERVICE" | "LOWER_COST" | "STABLE_HOURS";
+        allowOvertime: boolean;
+        proposals: {
+            rejectReason?: string | null | undefined | undefined;
+            date: string;
+            startTime: string;
+            endTime: string;
+            positionId: string | null;
+            employeeId: string;
+            employeeName: string;
+            position: string;
+            reason: string;
+        }[];
+        unfilledCount: number;
+        unfilledNeeds: {
+            date: string;
+            startTime: string;
+            endTime: string;
+            position: string | null;
+            short: number;
+            excluded: {
+                occupied: number;
+                notQualified: number;
+                weeklyCap: number;
+                dailyCap: number;
+                rest: number;
+                dayOff: number;
+            };
+        }[];
+        metrics: {
+            minimumCoveragePercent: number;
+            recommendedCoveragePercent: number;
+            totalHours: number;
+            estimatedLabourCost: number | null;
+            costCoveragePercent: number;
+            overtimeHours: number;
+            targetHoursVariance: number;
+            unfilledIntervals: number;
+        };
+        readiness: {
+            ready: boolean;
+            capabilities: string[];
+            issues: {
+                code: string;
+                message: string;
+                severity: "BLOCKER" | "WARNING" | "INFO";
+            }[];
+            coverage: {
+                wage: number;
+                availability: number;
+                position: number;
+                targetHours: number;
+            };
+        };
+        explanations: string[];
+        solver: string;
+        week: {
+            from: string;
+            to: string;
+        };
+        timing: {
+            totalMs: number;
+            modelMs: number | null;
+        };
+    } | null, {
+        objective: "BALANCED" | "SERVICE" | "LOWER_COST" | "STABLE_HOURS";
+        allowOvertime: boolean;
+        proposals: {
+            rejectReason?: string | null | undefined;
+            date: string;
+            startTime: string;
+            endTime: string;
+            positionId: string | null;
+            employeeId: string;
+            employeeName: string;
+            position: string;
+            reason: string;
+        }[];
+        unfilledCount: number;
+        unfilledNeeds: {
+            date: string;
+            startTime: string;
+            endTime: string;
+            position: string | null;
+            short: number;
+            excluded: {
+                occupied: number;
+                notQualified: number;
+                weeklyCap: number;
+                dailyCap: number;
+                rest: number;
+                dayOff: number;
+            };
+        }[];
+        metrics: {
+            minimumCoveragePercent: number;
+            recommendedCoveragePercent: number;
+            totalHours: number;
+            estimatedLabourCost: number | null;
+            costCoveragePercent: number;
+            overtimeHours: number;
+            targetHoursVariance: number;
+            unfilledIntervals: number;
+        };
+        readiness: {
+            ready: boolean;
+            capabilities: string[];
+            issues: {
+                code: string;
+                message: string;
+                severity: "BLOCKER" | "WARNING" | "INFO";
+            }[];
+            coverage: {
+                wage: number;
+                availability: number;
+                position: number;
+                targetHours: number;
+            };
+        };
+        explanations: string[];
+        solver: string;
+        week: {
+            from: string;
+            to: string;
+        };
+        timing: {
+            totalMs: number;
+            modelMs: number | null;
+        };
+    } | {
+        objective: "BALANCED" | "SERVICE" | "LOWER_COST" | "STABLE_HOURS";
+        allowOvertime: boolean;
+        proposals: {
+            rejectReason?: string | null | undefined | undefined;
+            date: string;
+            startTime: string;
+            endTime: string;
+            positionId: string | null;
+            employeeId: string;
+            employeeName: string;
+            position: string;
+            reason: string;
+        }[];
+        unfilledCount: number;
+        unfilledNeeds: {
+            date: string;
+            startTime: string;
+            endTime: string;
+            position: string | null;
+            short: number;
+            excluded: {
+                occupied: number;
+                notQualified: number;
+                weeklyCap: number;
+                dailyCap: number;
+                rest: number;
+                dayOff: number;
+            };
+        }[];
+        metrics: {
+            minimumCoveragePercent: number;
+            recommendedCoveragePercent: number;
+            totalHours: number;
+            estimatedLabourCost: number | null;
+            costCoveragePercent: number;
+            overtimeHours: number;
+            targetHoursVariance: number;
+            unfilledIntervals: number;
+        };
+        readiness: {
+            ready: boolean;
+            capabilities: string[];
+            issues: {
+                code: string;
+                message: string;
+                severity: "BLOCKER" | "WARNING" | "INFO";
+            }[];
+            coverage: {
+                wage: number;
+                availability: number;
+                position: number;
+                targetHours: number;
+            };
+        };
+        explanations: string[];
+        solver: string;
+        week: {
+            from: string;
+            to: string;
+        };
+        timing: {
+            totalMs: number;
+            modelMs: number | null;
+        };
+    } | null>;
+    gapCount: import("vue").ComputedRef<number>;
+    hasDemand: import("vue").ComputedRef<boolean>;
+    noDemandOpen: import("vue").Ref<boolean, boolean>;
+    rangeLabel: import("vue").ComputedRef<string>;
+    openWizard: () => void;
+    closeWizard: () => void;
+    next: () => void;
+    back: () => void;
+    generate: () => Promise<void>;
+    reviewMode: import("vue").ComputedRef<boolean>;
+    hasPendingChanges: import("vue").ComputedRef<boolean>;
+    proposals: import("vue").ComputedRef<{
+        id: number;
+        empId: number;
+        dayIdx: number;
+        start: string;
+        end: string;
+        role: string;
+        positionId?: string | null | undefined;
+        openId?: number | undefined;
+        status: "pending" | "rejected";
+        weekKey?: string | undefined;
+        reason?: string | undefined;
+        rejectReason?: string | undefined;
+    }[]>;
+    weekHasProposals: import("vue").ComputedRef<boolean>;
+    unmetCount: import("vue").Ref<number, number>;
+    acceptedCount: import("vue").ComputedRef<number>;
+    rejectedCount: import("vue").ComputedRef<number>;
+    removedCount: import("vue").ComputedRef<number>;
+    changedCount: import("vue").ComputedRef<number>;
+    unqualifiedCount: import("vue").ComputedRef<number>;
+    conflictCount: import("vue").ComputedRef<number>;
+    projectedCost: import("vue").ComputedRef<number | null>;
+    proposalAt: (empId: number, dayIdx: number) => Proposal | undefined;
+    draggingId: import("vue").Ref<number | null, number | null>;
+    moveProposal: (id: number, empId: number, dayIdx: number) => string | null;
+    toggleReject: (id: number) => void;
+    rejectAll: () => void;
+    exitReview: () => void;
+    leaveReviewOpen: import("vue").Ref<boolean, boolean>;
+    confirmLeaveReview: () => void;
+    cancelLeaveReview: () => void;
+    apply: () => Promise<number | null>;
+    applying: import("vue").Ref<boolean, boolean>;
+    applyRejections: import("vue").Ref<{
+        employeeName: string;
+        day: string;
+        time: string;
+        message: string;
+    }[], {
+        employeeName: string;
+        day: string;
+        time: string;
+        message: string;
+    }[] | {
+        employeeName: string;
+        day: string;
+        time: string;
+        message: string;
+    }[]>;
+    applyError: import("vue").Ref<string | null, string | null>;
+    detailsOpen: import("vue").Ref<boolean, boolean>;
+    toggleDetails: () => void;
+};
+export type ScheduleAutoScheduleApi = ReturnType<typeof useScheduleAutoSchedule>;