@shisyamo4131/air-guard-v2-schemas 1.0.0

package/src/Operation.js

@@ -0,0 +1,779 @@
+/*****************************************************************************
+ * Operation Model ver 1.0.0
+ * @author shisyamo4131
+ * ---------------------------------------------------------------------------
+ * - Base class of SiteOperationSchedule based on WorkingResult.
+ * - `dateAt` property indicates the date of operation (placement date)
+ *   used for billing purposes.
+ *   Actual working day may differ from this date.
+ * - `siteId`, `dateAt`, `shiftType`, and `regulationWorkMinutes` are
+ *   automatically synchronized to all assigned employees and outsourcers
+ *   when they are changed on the Operation instance.
+ * - `startTime`, `endTime`, and `breakMinutes` are NOT synchronized here.
+ *   They should be synchronized at `SiteOperationSchedule` level instead.
+ * ---------------------------------------------------------------------------
+ * @prop {string} siteId - Site document ID (trigger property)
+ * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
+ * @prop {number} requiredPersonnel - Required number of personnel
+ * @prop {boolean} qualificationRequired - Qualification required flag
+ * @prop {string} workDescription - Work description
+ * @prop {string} remarks - Remarks
+ * @prop {Array<OperationDetail>} employees - Assigned employees
+ * - Array of `OperationDetail` instances representing assigned employees
+ * @prop {Array<OperationDetail>} outsourcers - Assigned outsourcers
+ * - Array of `OperationDetail` instances representing assigned outsourcers
+ * ---------------------------------------------------------------------------
+ * @computed {Array<string>} employeeIds - Array of employee IDs from `employees` (read-only)
+ * @computed {Array<string>} outsourcerIds - Array of outsourcer IDs from `outsourcers` (read-only)
+ * @computed {number} employeesCount - Count of assigned employees (read-only)
+ * @computed {number} outsourcersCount - Count of assigned outsourcers (sum of amounts) (read-only)
+ * @computed {boolean} isPersonnelShortage - Indicates if there is a shortage of personnel (read-only)
+ * - `true` if the sum of `employeesCount` and `outsourcersCount` is less than `requiredPersonnel`
+ * @computed {Array<OperationDetail>} workers - Combined array of `employees` and `outsourcers`
+ * - Getter: Returns concatenated array of employees and outsourcers
+ * - Setter: Splits array into employees and outsourcers based on `isEmployee` property
+ * ---------------------------------------------------------------------------
+ * @getter {string} groupKey - Combines `siteId`, `shiftType`, and `date` to indicate operation grouping (read-only)
+ * @getter {boolean} isEmployeesChanged - Indicates whether the employees have changed (read-only)
+ * - Returns true if the employee IDs have changed compared to `_beforeData`
+ * @getter {boolean} isOutsourcersChanged - Indicates whether the outsourcers have changed (read-only)
+ * - Returns true if the outsourcer IDs have changed compared to `_beforeData`
+ * @getter {Array<OperationDetail>} addedWorkers - An array of workers that have been added (read-only)
+ * - Workers that exist in current data but not in `_beforeData`
+ * @getter {Array<OperationDetail>} removedWorkers - An array of workers that have been removed (read-only)
+ * - Workers that exist in `_beforeData` but not in current data
+ * @getter {Array<OperationDetail>} updatedWorkers - An array of workers that have been updated (read-only)
+ * - Workers whose `startTime`, `isStartNextDay`, `endTime`, `breakMinutes`, `isQualified`, or `isOjt` have changed
+ * ---------------------------------------------------------------------------
+ * @inherited - The following properties are inherited from WorkingResult:
+ * @prop {Date} dateAt - Date of operation (placement date) (trigger property)
+ * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
+ * @prop {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
+ * @prop {string} shiftType - `DAY` or `NIGHT` (trigger property)
+ * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
+ * @prop {string} startTime - Start time (HH:MM format)
+ * @prop {boolean} isStartNextDay - Next day start flag
+ * - `true` if the actual work starts the day after the placement date `dateAt`
+ * @prop {string} endTime - End time (HH:MM format)
+ * @prop {number} breakMinutes - Break time (minutes)
+ * @prop {number} regulationWorkMinutes - Regulation work minutes (trigger property)
+ * - Indicates the maximum working time treated as regular working hours.
+ * - A new value will be synchronized to all `employees` and `outsourcers`.
+ * ---------------------------------------------------------------------------
+ * @inherited - The following computed properties are inherited from WorkingResult:
+ * @computed {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
+ * @computed {Date} startAt - Start date and time (Date object) (read-only)
+ * - Returns a Date object with `startTime` set based on `dateAt`.
+ * - If `isStartNextDay` is true, add 1 day.
+ * @computed {Date} endAt - End date and time (Date object) (read-only)
+ * - Returns a Date object with `endTime` set based on `dateAt`.
+ * - If `isStartNextDay` is true, add 1 day.
+ * - If `isSpansNextDay` is true, add 1 day.
+ * @computed {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
+ * - `true` if `startTime` is later than `endTime`
+ * @computed {number} totalWorkMinutes - Total working time in minutes (excluding break time) (read-only)
+ * - Calculated as the difference between `endAt` and `startAt` minus `breakMinutes`
+ * @computed {number} regularTimeWorkMinutes - Regular working time in minutes (read-only)
+ * - The portion of `totalWorkMinutes` that is considered within the contract's `regulationWorkMinutes`.
+ * @computed {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
+ * - Calculated as `totalWorkMinutes` minus `regulationWorkMinutes`
+ * ---------------------------------------------------------------------------
+ * @inherited - The following getter properties are inherited from WorkingResult:
+ * @getter {number} startHour - Start hour (0-23) (read-only)
+ * - Extracted from `startTime`.
+ * @getter {number} startMinute - Start minute (0-59) (read-only)
+ * - Extracted from `startTime`.
+ * @getter {number} endHour - End hour (0-23) (read-only)
+ * - Extracted from `endTime`.
+ * @getter {number} endMinute - End minute (0-59) (read-only)
+ * - Extracted from `endTime`.
+ * ---------------------------------------------------------------------------
+ * @method {function} addWorker - Adds a new worker (employee or outsourcer)
+ * - @param {Object} options - Options for adding a worker
+ * - @param {string} options.id - The worker ID (employeeId or outsourcerId)
+ * - @param {boolean} [options.isEmployee=true] - Whether the worker is an employee
+ * - @param {number} [index=0] - Insertion position. If -1, adds to the end
+ * @method {function} moveWorker - Moves the position of a worker (employee or outsourcer)
+ * - @param {Object} options - Options for changing worker position
+ * - @param {number} options.oldIndex - The original index
+ * - @param {number} options.newIndex - The new index
+ * - @param {boolean} [options.isEmployee=true] - True for employee, false for outsourcer
+ * @method {function} changeWorker - Changes the details of a worker
+ * - @param {Object} newWorker - New worker object
+ * @method {function} removeWorker - Removes a worker (employee or outsourcer)
+ * - @param {Object} options - Options for removing a worker
+ * - @param {string} options.workerId - The ID of the employee or outsourcer
+ * - @param {boolean} [options.isEmployee=true] - True for employee, false for outsourcer
+ * @method {function} setSiteIdCallback - Callback method called when `siteId` is set
+ * - Override this method in subclasses to add custom behavior when `siteId` changes.
+ * - By default, does nothing.
+ * - @param {string} v - The new `siteId` value
+ * @method {function} setShiftTypeCallback - Callback method called when `shiftType` is set
+ * - Override this method in subclasses to add custom behavior when `shiftType` changes.
+ * - By default, does nothing.
+ * - @param {string} v - The new `shiftType` value
+ * @method {function} setRegulationWorkMinutesCallback - Callback method called when `regulationWorkMinutes` is set
+ * - Override this method in subclasses to add custom behavior when `regulationWorkMinutes` changes.
+ * - By default, does nothing.
+ * - @param {number} v - The new `regulationWorkMinutes` value
+ * ---------------------------------------------------------------------------
+ * @static
+ * @method groupKeyDivider
+ * Returns an array dividing the key into siteId, shiftType, and date.
+ * @param {Object|string} key - The combined key string or object
+ * @returns {Array<string>} - Array containing [siteId, shiftType, date]
+ * @throws {Error} - If the key is invalid.
+ * ---------------------------------------------------------------------------
+ * @inherited - The following method is inherited from WorkingResult:
+ * @method {function} setDateAtCallback - Callback method called when `dateAt` is set
+ * - Override this method in subclasses to add custom behavior when `dateAt` changes.
+ * - By default, updates `dayType` based on the new `dateAt` value and synchronizes to workers.
+ * - @param {Date} v - The new `dateAt` value
+ *****************************************************************************/
+import WorkingResult from "./WorkingResult.js";
+import OperationDetail from "./OperationDetail.js";
+import { defField } from "./parts/fieldDefinitions.js";
+import { DAY_TYPE } from "./constants/day-type.js";
+import { SHIFT_TYPE } from "./constants/shift-type.js";
+
+const classProps = {
+  siteId: defField("siteId", { required: true }),
+  ...WorkingResult.classProps, // Inherited from WorkingResult.js
+  requiredPersonnel: defField("number", {
+    label: "必要人数",
+    required: true,
+  }),
+  qualificationRequired: defField("check", { label: "要資格者" }),
+  workDescription: defField("workDescription"),
+  remarks: defField("multipleLine", { label: "備考" }),
+  employees: defField("array", { customClass: OperationDetail }),
+  outsourcers: defField("array", {
+    customClass: OperationDetail,
+  }),
+};
+
+/**
+ * Wrapper to define computed properties.
+ * @param {*} obj
+ * @param {*} properties
+ */
+function defineComputedProperties(obj, properties) {
+  const descriptors = {};
+  for (const [key, descriptor] of Object.entries(properties)) {
+    descriptors[key] = {
+      configurable: true,
+      enumerable: true,
+      ...descriptor,
+    };
+  }
+  Object.defineProperties(obj, descriptors);
+}
+
+export default class Operation extends WorkingResult {
+  static className = "稼働ベース";
+  static collectionPath = "Operations";
+  static useAutonumber = false;
+  static logicalDelete = false;
+  static classProps = classProps;
+
+  static DAY_TYPE = DAY_TYPE;
+  static DAY_TYPE_DAY = DAY_TYPE.DAY;
+  static DAY_TYPE_NIGHT = DAY_TYPE.NIGHT;
+
+  static SHIFT_TYPE = SHIFT_TYPE;
+  static SHIFT_TYPE_DAY = SHIFT_TYPE.DAY.value;
+  static SHIFT_TYPE_NIGHT = SHIFT_TYPE.NIGHT.value;
+
+  /**
+   * Constructor
+   * @param {*} item
+   */
+  constructor(item = {}) {
+    if (new.target == Operation) {
+      throw new Error(
+        `Operation is an abstract class and cannot be instantiated directly.`
+      );
+    }
+    super(item);
+  }
+
+  /**
+   * setSiteIdCallback
+   * - Callback method called when `siteId` is set.
+   * - Override this method in subclasses to add custom behavior when `siteId` changes.
+   * @param {*} v
+   */
+  setSiteIdCallback(v) {}
+
+  /**
+   * setDateAtCallback
+   * - Callback method called when `dateAt` is set.
+   * - Override this method in subclasses to add custom behavior when `dateAt` changes.
+   * @param {*} v
+   */
+  setDateAtCallback(v) {
+    super.setDateAtCallback(v);
+    this.employees.forEach((emp) => (emp.dateAt = v));
+    this.outsourcers.forEach((out) => (out.dateAt = v));
+  }
+
+  /**
+   * setShiftTypeCallback
+   * - Callback method called when `shiftType` is set.
+   * - Override this method in subclasses to add custom behavior when `shiftType` changes.
+   * @param {*} v
+   */
+  setShiftTypeCallback(v) {}
+
+  /**
+   * setRegulationWorkMinutesCallback
+   * - Callback method called when `regulationWorkMinutes` is set.
+   * - Override this method in subclasses to add custom behavior when `regulationWorkMinutes` changes.
+   * @param {*} v
+   */
+  setRegulationWorkMinutesCallback(v) {}
+
+  /**
+   * afterInitialize
+   */
+  afterInitialize(item = {}) {
+    super.afterInitialize(item);
+
+    /***********************************************************
+     * TRIGGERS FOR SYNCRONIZATION TO EMPLOYEES AND OUTSOURCERS
+     * ---------------------------------------------------------
+     * When `siteId`, `dateAt`, `shiftType`, and `regulationWorkMinutes`
+     * are changed on the Operation instance,
+     * the corresponding properties on all employees and outsourcers
+     * are automatically updated to keep them in sync.
+     * [NOTE]
+     * `startTime`, `endTime`, and `breakMinutes` are NOT synchronized here.
+     * They should be synchronized at `SiteOperationSchedule` level instead.
+     ***********************************************************/
+    let _siteId = this.siteId;
+    let _shiftType = this.shiftType;
+    let _regulationWorkMinutes = this.regulationWorkMinutes;
+    defineComputedProperties(this, {
+      siteId: {
+        get() {
+          return _siteId;
+        },
+        set(v) {
+          if (!!v && typeof v !== "string") {
+            throw new Error(`siteId must be a string. siteId: ${v}`);
+          }
+          if (_siteId === v) return;
+          _siteId = v;
+          this.employees.forEach((emp) => (emp.siteId = v));
+          this.outsourcers.forEach((out) => (out.siteId = v));
+          this.setSiteIdCallback(v);
+        },
+      },
+      shiftType: {
+        get() {
+          return _shiftType;
+        },
+        set(v) {
+          if (typeof v !== "string") {
+            throw new Error(`shiftType must be a string. shiftType: ${v}`);
+          }
+          if (!SHIFT_TYPE[v]) {
+            throw new Error(`Invalid shiftType value. shiftType: ${v}`);
+          }
+          if (_shiftType === v) return;
+          _shiftType = v;
+          this.employees.forEach((emp) => (emp.shiftType = v));
+          this.outsourcers.forEach((out) => (out.shiftType = v));
+          this.setShiftTypeCallback(v);
+        },
+      },
+      regulationWorkMinutes: {
+        get() {
+          return _regulationWorkMinutes;
+        },
+        set(v) {
+          if (typeof v !== "number" || isNaN(v) || v < 0) {
+            throw new Error(
+              `regulationWorkMinutes must be a non-negative number. regulationWorkMinutes: ${v}`
+            );
+          }
+          if (_regulationWorkMinutes === v) return;
+          _regulationWorkMinutes = v;
+          this.employees.forEach((emp) => (emp.regulationWorkMinutes = v));
+          this.outsourcers.forEach((out) => (out.regulationWorkMinutes = v));
+          this.setRegulationWorkMinutesCallback(v);
+        },
+      },
+    });
+
+    /** define computed properies */
+    defineComputedProperties(this, {
+      /** Returns an array of employee IDs */
+      employeeIds: {
+        get() {
+          return this.employees.map((emp) => emp.employeeId);
+        },
+        set(v) {},
+      },
+      /** Returns an array of outsourcer IDs */
+      outsourcerIds: {
+        get() {
+          return this.outsourcers.map((out) => out.outsourcerId);
+        },
+        set(v) {},
+      },
+      /** Returns the count of assigned employees */
+      employeesCount: {
+        get() {
+          return this.employees.length;
+        },
+        set(v) {},
+      },
+      /** Returns the count of assigned outsourcers (sum of amounts) */
+      outsourcersCount: {
+        get() {
+          return this.outsourcers.reduce((sum, i) => sum + i.amount, 0);
+        },
+        set(v) {},
+      },
+      /** Returns whether there is a personnel shortage */
+      isPersonnelShortage: {
+        get() {
+          const totalRequired = this.requiredPersonnel || 0;
+          const totalAssigned = this.employeesCount + this.outsourcersCount;
+          return totalAssigned < totalRequired;
+        },
+        set(v) {},
+      },
+      /** Returns a combined array of employees and outsourcers */
+      workers: {
+        get() {
+          return this.employees.concat(this.outsourcers);
+        },
+        set(v) {
+          const employees = v.filter((emp) => emp.isEmployee);
+          const outsourcers = v.filter((out) => !out.isEmployee);
+          this.employees = employees;
+          this.outsourcers = outsourcers;
+        },
+      },
+    });
+
+    /** Define custom methods for employees and outsourcers */
+    const self = this;
+    Object.defineProperties(this.employees, {
+      /**
+       * Adds a new employee to the `employees` property with the specified ID.
+       * - The element added is as an instance specified by `employees.customClass`.
+       * - Throws an error if the specified employee ID already exists in the `employees` property.
+       * - `startAt`, `endAt`, and `breakMinutes` are taken from the current instance.
+       * - `employeeId` is required.
+       * [Note]
+       * Any options other than `id` and `amount` are accepted and used as initial values
+       * for the new instance.
+       * @param {Object} args - arguments.
+       * @param {string} args.id - The employee's ID.
+       * @param {number} args.amount - amount.
+       * @param {number} [index=0] - Insertion position. If -1, adds to the end.
+       * @returns {Object} - The added employee object.
+       * @throws {Error} - If the employee ID already exists.
+       */
+      add: {
+        value: function (args = {}, index = 0) {
+          const { id } = args;
+          if (!id || typeof id !== "string") {
+            throw new Error(
+              `Employee ID is required and must be a string. id: ${id}`
+            );
+          }
+          if (this.some((emp) => emp.workerId === id)) {
+            throw new Error(`Employee with ID ${id} already exists.`);
+          }
+          const schema = self.constructor.classProps?.employees?.customClass;
+          if (!schema || typeof schema !== "function") {
+            throw new Error("employees.customClass is not defined.");
+          }
+          const newEmployee = new schema({
+            ...self.toObject(),
+            ...args,
+            isEmployee: true, // Force override to true
+          });
+          if (index === -1) {
+            this.push(newEmployee);
+          } else {
+            this.splice(index, 0, newEmployee);
+          }
+          return newEmployee;
+        },
+        writable: false,
+        enumerable: false,
+      },
+      /**
+       * Moves the position of an employee in the employees array.
+       * @param {number} oldIndex - The original index.
+       * @param {number} newIndex - The new index.
+       */
+      move: {
+        value: function (oldIndex, newIndex) {
+          if (newIndex > this.length - 1) {
+            throw new Error(
+              `Employees must be placed before outsourcers. newIndex: ${newIndex}, employees.length: ${this.length}`
+            );
+          }
+          if (newIndex < 0 || newIndex >= this.length) {
+            throw new Error(`Invalid new index: ${newIndex}`);
+          }
+          const employee = this.splice(oldIndex, 1)[0];
+          this.splice(newIndex, 0, employee);
+        },
+        writable: false,
+        enumerable: false,
+      },
+      /**
+       * Changes the details of an existing employee in the employees array.
+       * @param {Object} newEmployee - The updated employee object.
+       * @throws {Error} - If the employee is not found.
+       */
+      change: {
+        value: function (newEmployee) {
+          const index = this.findIndex(
+            (e) => e.workerId === newEmployee.workerId
+          );
+          if (index < 0) {
+            throw new Error("Worker not found in employees.");
+          }
+          this[index] = newEmployee;
+        },
+        writable: false,
+        enumerable: false,
+      },
+      /**
+       * Removes the employee corresponding to `employeeId` from this.employees.
+       * @param {string} employeeId - The employee's ID
+       * @throws {Error} - If the employee ID is not found.
+       */
+      remove: {
+        value: function (employeeId) {
+          const index = this.findIndex((emp) => emp.workerId === employeeId);
+          if (index === -1) {
+            throw new Error(`Employee with ID "${employeeId}" not found.`);
+          }
+          this.splice(index, 1);
+        },
+        writable: false,
+        enumerable: false,
+      },
+    });
+    Object.defineProperties(this.outsourcers, {
+      /**
+       * Adds a new outsourcer to the `outsourcers` property with the specified ID.
+       * - The element added is as an instance specified by `outsourcers.customClass`.
+       * - If the specified outsourcer ID already exists in the `outsourcers` property, increases the amount.
+       * - `startTime`, `endTime`, and `isStartNextDay` are taken from the current instance.
+       * - `outsourcerId` is required.
+       * [Note]
+       * Any options other than `id` and `amount` are accepted and used as initial values
+       * for the new instance.
+       * @param {Object} args - arguments.
+       * @param {string} args.id - The outsourcer's ID.
+       * @param {number} args.amount - amount.
+       * @param {number} [index=0] - Insertion position. If -1, adds to the end.
+       * @return {Object} - The added outsourcer object.
+       * @throws {Error} - If the outsourcer ID is not provided.
+       */
+      add: {
+        value: function (args = {}, index = 0) {
+          const { id } = args;
+          if (!id || typeof id !== "string") {
+            throw new Error(
+              `Outsourcer ID is required and must be a string. id: ${id}`
+            );
+          }
+          const maxIndex = this.reduce((result, out) => {
+            if (out.outsourcerId === id) {
+              return Math.max(result, Number(out.index));
+            }
+            return result;
+          }, 0);
+
+          const schema = self.constructor.classProps.outsourcers.customClass;
+          if (!schema || typeof schema !== "function") {
+            throw new Error("outsourcers.customClass is not defined.");
+          }
+          const newOutsourcer = new schema({
+            ...self.toObject(),
+            ...args,
+            index: maxIndex + 1, // Always set to the next index
+            isEmployee: false, // Force override to false
+          });
+
+          if (index === -1) {
+            this.push(newOutsourcer);
+          } else {
+            this.splice(index, 0, newOutsourcer);
+          }
+          return newOutsourcer;
+        },
+        writable: false,
+        enumerable: false,
+      },
+      /**
+       * Moves the position of an outsourcer in the outsourcers array.
+       * - `oldIndex` and `newIndex` are offset by the number of employees.
+       * @param {number} oldIndex - The original index.
+       * @param {number} newIndex - The new index.
+       */
+      move: {
+        value: function (oldIndex, newIndex) {
+          if (newIndex <= self.employees.length - 1) {
+            throw new Error(
+              `Outsourcers must be placed after employees. newIndex: ${newIndex}, employees.length: ${self.employees.length}`
+            );
+          }
+          const internalOldIndex = Math.max(
+            0,
+            oldIndex - self.employees.length
+          );
+          const internalNewIndex = Math.max(
+            0,
+            newIndex - self.employees.length
+          );
+          if (internalOldIndex < 0 || internalOldIndex >= this.length) {
+            throw new Error(`Invalid old index: ${internalOldIndex}`);
+          }
+          if (internalNewIndex < 0 || internalNewIndex >= this.length) {
+            throw new Error(`Invalid new index: ${internalNewIndex}`);
+          }
+          const outsourcer = this.splice(internalOldIndex, 1)[0];
+          this.splice(internalNewIndex, 0, outsourcer);
+        },
+        writable: false,
+        enumerable: false,
+      },
+      /**
+       * Changes the details of an existing outsourcer in the outsourcers array.
+       * @param {Object} newOutsourcer - The updated outsourcer object.
+       * @throws {Error} - If the outsourcer is not found.
+       */
+      change: {
+        value: function (newOutsourcer) {
+          const index = this.findIndex(
+            (e) => e.workerId === newOutsourcer.workerId
+          );
+          if (index < 0) {
+            throw new Error("Worker not found in outsourcers.");
+          }
+          this[index] = newOutsourcer;
+        },
+        writable: false,
+        enumerable: false,
+      },
+      /**
+       * Removes the outsourcer corresponding to `outsourcerId` from this.outsourcers.
+       * - Throws an error for invalid values or if not found.
+       * @param {string} outsourcerId - The ID of the outsourcer.
+       * @throws {Error} - If the outsourcer ID is not found.
+       */
+      remove: {
+        value: function (outsourcerId) {
+          const index = this.findIndex((out) => out.workerId === outsourcerId);
+          if (index === -1) {
+            throw new Error(`Outsourcer with ID "${outsourcerId}" not found.`);
+          }
+          this.splice(index, 1);
+        },
+        writable: false,
+        enumerable: false,
+      },
+    });
+    /** Remove unnecessary properties */
+    delete this.key; // From workingResult.js
+  }
+
+  /***************************************************************************
+   * STATES
+   ***************************************************************************/
+  /**
+   * Returns a string combining siteId, shiftType, and date.
+   * - Indicates where this operation belongs.
+   * @returns {string} - The group key.
+   */
+  get groupKey() {
+    return `${this.siteId}-${this.shiftType}-${this.date}`;
+  }
+
+  /**
+   * Returns whether the employees have changed.
+   * - Returns true if the employee IDs have changed.
+   * - Returns false if the employee IDs have not changed or
+   *   are the same even if the order has changed.
+   * @returns {boolean} - Whether the employees have changed.
+   */
+  get isEmployeesChanged() {
+    const current = this.employeeIds || [];
+    const before = this._beforeData?.employeeIds || [];
+    return current.sort().join(",") !== before.sort().join(",");
+  }
+
+  /**
+   * Returns whether the outsourcers have changed.
+   * - Returns true if the outsourcer IDs have changed.
+   * - Returns false if the outsourcer IDs have not changed or
+   *   are the same even if the order has changed.
+   * @returns {boolean} - Whether the outsourcers have changed.
+   */
+  get isOutsourcersChanged() {
+    const current = this.outsourcerIds || [];
+    const before = this._beforeData?.outsourcerIds || [];
+    return current.sort().join(",") !== before.sort().join(",");
+  }
+
+  /**
+   * Returns a filtered array of workers that have been added.
+   * @returns {Array<OperationDetail>} - Array of added workers.
+   */
+  get addedWorkers() {
+    const current = this.workers || [];
+    if (current.length === 0) return [];
+    const before = this._beforeData?.workers || [];
+    const isAdded = (emp) => !before.some((e) => e.workerId === emp.workerId);
+    return current.filter(isAdded);
+  }
+
+  /**
+   * Returns a filtered array of workers that have been removed.
+   * Note: The returned elements do not exist in this.workers.
+   * @returns {Array<OperationDetail>} - Array of removed workers.
+   */
+  get removedWorkers() {
+    const before = this._beforeData?.workers || [];
+    if (before.length === 0) return [];
+    const current = this.workers || [];
+    const isRemoved = (emp) =>
+      !current.some((e) => e.workerId === emp.workerId);
+    return before.filter(isRemoved);
+  }
+
+  /**
+   * Returns a filtered array of workers that have been updated.
+   * - Compares `startTime`, `isStartNextDay`, `endTime`, and `breakMinutes` properties.
+   * @returns {Array<OperationDetail>} - Array of updated workers.
+   */
+  get updatedWorkers() {
+    const before = this._beforeData.workers || [];
+    if (before.length === 0) return [];
+    const current = this.workers || [];
+    const keys = [
+      "startTime",
+      "isStartNextDay",
+      "endTime",
+      "breakMinutes",
+      "isQualified",
+      "isOjt",
+    ];
+    const isUpdated = (emp) => {
+      const worker = before.find((e) => e.workerId === emp.workerId);
+      if (!worker) return false;
+      return keys.some((key) => emp[key] !== worker[key]);
+    };
+    return current.filter(isUpdated);
+  }
+
+  /***************************************************************************
+   * METHODS
+   ***************************************************************************/
+  /**
+   * Adds a new worker.
+   * - Calls the appropriate method based on the value of `isEmployee`.
+   * @param {Object} options - Options for adding a worker.
+   * @param {string} options.id - The worker ID (employeeId or outsourcerId)
+   * @param {boolean} [options.isEmployee=true] - Whether the worker is an employee
+   * @param {number} [index=0] - Insertion position. If -1, adds to the end.
+   */
+  addWorker(options = {}, index = 0) {
+    const { isEmployee = true } = options;
+    if (isEmployee) {
+      this.employees.add(options, index);
+    } else {
+      this.outsourcers.add(options, index);
+    }
+  }
+
+  /**
+   * Moves the position of workers.
+   * @param {Object} options - Options for changing worker position.
+   * @param {number} options.oldIndex - The original index.
+   * @param {number} options.newIndex - The new index.
+   * @param {boolean} [options.isEmployee=true] - True for employee, false for outsourcer.
+   */
+  moveWorker(options) {
+    const { oldIndex, newIndex, isEmployee = true } = options;
+    if (typeof oldIndex !== "number" || typeof newIndex !== "number") {
+      throw new Error(
+        "oldIndex and newIndex are required and must be numbers."
+      );
+    }
+    if (isEmployee) {
+      this.employees.move(oldIndex, newIndex);
+    } else {
+      this.outsourcers.move(oldIndex, newIndex);
+    }
+  }
+
+  /**
+   * Changes the details of a worker.
+   * @param {Object} newWorker - New worker object
+   */
+  changeWorker(newWorker) {
+    if (newWorker.isEmployee) {
+      this.employees.change(newWorker);
+    } else {
+      this.outsourcers.change(newWorker);
+    }
+  }
+
+  /**
+   * Removes an employee or outsourcer from the schedule.
+   * @param {Object} options - Options for removing a worker.
+   * @param {string} options.workerId - The ID of the employee or outsourcer.
+   * @param {boolean} [options.isEmployee=true] - True for employee, false for outsourcer.
+   */
+  removeWorker(options) {
+    const { workerId, isEmployee = true } = options;
+    if (isEmployee) {
+      this.employees.remove(workerId);
+    } else {
+      this.outsourcers.remove(workerId);
+    }
+  }
+
+  /**
+   * Returns an array dividing the key into siteId, shiftType, and date.
+   * @param {Object|string} key
+   * @returns {Array<string>} - [siteId, shiftType, date]
+   * @throws {Error} - If the key is invalid.
+   */
+  static groupKeyDivider(key = {}) {
+    if (!key) throw new Error("key is required.");
+
+    switch (typeof key) {
+      case "object":
+        if (!key.siteId || !key.shiftType || !key.date) {
+          throw new Error(
+            "key must contain siteId, shiftType, and date properties."
+          );
+        }
+        return [key.siteId, key.shiftType, key.date];
+      case "string":
+        const [siteId, shiftType, year, month, day] = key.split("-");
+        if (!siteId || !shiftType || !year || !month || !day) {
+          throw new Error(
+            "key must be in the format 'siteId-shiftType-year-month-day'."
+          );
+        }
+        return [siteId, shiftType, `${year}-${month}-${day}`];
+      default:
+        throw new Error("Invalid key type.");
+    }
+  }
+}