Schichtenplaner/backend/src/models/scheduling.ts

// backend/src/models/scheduling.ts
import { Employee } from './Employee.js';
import { ShiftPlan } from './ShiftPlan.js';

// Availability interface
export interface Availability {
  id: string;
  employeeId: string;
  planId: string;
  shiftId: string;
  preferenceLevel: 1 | 2 | 3;
  notes?: string;
  // Optional convenience fields
  dayOfWeek?: number;
  timeSlotId?: string;
  timeSlotName?: string;
  startTime?: string;
  endTime?: string;
}

export interface Constraint {
  type: string;
  severity: 'hard' | 'soft';
  parameters: {
    maxShiftsPerDay?: number;
    minEmployeesPerShift?: number;
    maxEmployeesPerShift?: number;
    enforceTraineeSupervision?: boolean;
    contractHoursLimit?: boolean;
    maxHoursPerWeek?: number;
    [key: string]: any;
  };
  weight?: number;
}

export interface ScheduleRequest {
  shiftPlan: ShiftPlan;
  employees: Employee[];
  availabilities: Availability[];
  constraints: Constraint[];
}

export interface ScheduleResult {
  assignments: Assignment[];
  violations: Violation[];
  success: boolean;
  resolutionReport: string[];
  processingTime: number;
}

export interface Assignment {
  shiftId: string;
  employeeId: string;
  assignedAt: Date;
  score: number; // Qualität der Zuweisung (1-100)
}

export interface Violation {
  type: string;
  severity: 'critical' | 'warning';
  message: string;
  involvedEmployees?: string[];
  shiftId?: string;
  details?: any;
}

export interface SolverOptions {
  maxTimeInSeconds: number;
  numSearchWorkers: number;
  logSearchProgress: boolean;
}

export interface Solution {
  assignments: Assignment[];
  violations: Violation[];
  success: boolean;
  metadata: {
    solveTime: number;
    constraintsAdded: number;
    variablesCreated: number;
    optimal: boolean;
  };
  variables?: { [key: string]: number };
}

// Additional helper types for the scheduling system
export interface SchedulingConfig {
  maxRepairAttempts: number;
  targetEmployeesPerShift: number;
  enforceNoTraineeAlone: boolean;
  enforceExperiencedWithChef: boolean;
  preferEmployeePreferences: boolean;
}

export interface AssignmentResult {
  assignments: { [shiftId: string]: string[] }; // shiftId -> employeeIds
  violations: string[];
  resolutionReport: string[];
  success: boolean;
  statistics?: {
    totalAssignments: number;
    preferredAssignments: number;
    availableAssignments: number;
    coverageRate: number;
    violationCount: number;
  };
}

export interface EmployeeAvailabilitySummary {
  employeeId: string;
  employeeName: string;
  preferredSlots: number;
  availableSlots: number;
  unavailableSlots: number;
  totalSlots: number;
}

export interface ShiftRequirement {
  shiftId: string;
  timeSlotId: string;
  dayOfWeek: number;
  date?: string;
  requiredEmployees: number;
  minEmployees: number;
  maxEmployees: number;
  assignedEmployees: string[];
  isPriority: boolean;
}

// New types for the updated schema
export interface EmployeeWithRoles extends Employee {
  roles: string[];
}

export interface ShiftWithDetails {
  id: string;
  planId: string;
  timeSlotId: string;
  dayOfWeek: number;
  requiredEmployees: number;
  color?: string;
  timeSlot: {
    id: string;
    name: string;
    startTime: string;
    endTime: string;
    description?: string;
  };
}

export interface AvailabilityWithDetails extends Availability {
  employee?: {
    id: string;
    firstname: string;
    lastname: string;
    employeeType: 'manager' | 'personell' | 'apprentice' | 'guest';
    canWorkAlone: boolean;
    isTrainee: boolean;
  };
  shift?: {
    dayOfWeek: number;
    timeSlotId: string;
    timeSlot?: {
      name: string;
      startTime: string;
      endTime: string;
    };
  };
}

// Types for scheduling algorithm input
export interface SchedulingInput {
  planId: string;
  startDate: string;
  endDate: string;
  constraints: Constraint[];
  options?: SolverOptions;
}

// Types for scheduling results with enhanced information
export interface EnhancedAssignment extends Assignment {
  employeeName: string;
  shiftDetails: {
    date: string;
    dayOfWeek: number;
    timeSlotName: string;
    startTime: string;
    endTime: string;
  };
  preferenceLevel: number;
}

export interface SchedulingStatistics {
  totalShifts: number;
  totalAssignments: number;
  coverageRate: number;
  preferenceSatisfaction: number;
  constraintViolations: number;
  hardConstraintViolations: number;
  softConstraintViolations: number;
  processingTime: number;
}