@shisyamo4131/air-guard-v2-schemas 2.4.2-dev.3 → 2.4.2-dev.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shisyamo4131/air-guard-v2-schemas",
-  "version": "2.4.2-dev.3",
+  "version": "2.4.2-dev.4",
   "description": "Schemas for AirGuard V2",
   "type": "module",
   "main": "index.js",

package/src/Agreement.js

@@ -4,13 +4,13 @@
  * ---------------------------------------------------------------------------
  * A class to manage agreement details based on WorkingResult.
  * ---------------------------------------------------------------------------
- * @prop {number} unitPriceBase - Base unit price (JPY)
- * @prop {number} overtimeUnitPriceBase - Overtime unit price (JPY/hour)
- * @prop {number} unitPriceQualified - Qualified unit price (JPY)
- * @prop {number} overtimeUnitPriceQualified - Qualified overtime unit price (JPY/hour)
- * @prop {string} billingUnitType - Billing unit type
- * @prop {boolean} includeBreakInBilling - Whether to include break time in billing if `billingUnitType` is `PER_HOUR`.
- * @prop {number} cutoffDate - Cutoff date value from CutoffDate.VALUES
+ * @property {number} unitPriceBase - Base unit price (JPY)
+ * @property {number} overtimeUnitPriceBase - Overtime unit price (JPY/hour)
+ * @property {number} unitPriceQualified - Qualified unit price (JPY)
+ * @property {number} overtimeUnitPriceQualified - Qualified overtime unit price (JPY/hour)
+ * @property {string} billingUnitType - Billing unit type
+ * @property {boolean} includeBreakInBilling - Whether to include break time in billing if `billingUnitType` is `PER_HOUR`.
+ * @property {number} cutoffDate - Cutoff date value from CutoffDate.VALUES
  * - The cutoff date for billing, using values defined in the CutoffDate utility class.
  * ---------------------------------------------------------------------------
  * @getter {Object} prices - Object containing price-related properties (read-only)
@@ -20,21 +20,22 @@
  *   unitPriceQualified, overtimeUnitPriceQualified, billingUnitType, includeBreakInBilling
  * ---------------------------------------------------------------------------
  * @inherited - The following properties are inherited from WorkingResult:
- * @prop {Date} dateAt - Applicable start date (trigger property)
- * @prop {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
- * @prop {string} shiftType - Shift type (`DAY`, `NIGHT`)
- * @prop {string} startTime - Start time (HH:MM format)
- * @prop {boolean} isStartNextDay - Next day start flag
+ * @property {Date} dateAt - Applicable start date (trigger property)
+ * @property {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
+ * @property {string} shiftType - Shift type (`DAY`, `NIGHT`)
+ * @property {string} startTime - Start time (HH:MM format)
+ * @property {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
+ * @property {string} endTime - End time (HH:MM format)
+ * @property {number} breakMinutes - Break time (minutes)
+ * @property {number} regulationWorkMinutes - Regulation work minutes
  * - The maximum working time defined by `unitPriceBase` (or `unitPriceQualified`).
  * - Exceeding this time is considered overtime.
  * ---------------------------------------------------------------------------
  * @inherited - The following computed properties are inherited from WorkingResult:
- * @computed {string} key - Unique key combining `date`, `dayType`, and `shiftType` (read-only)
- * - A unique identifier for the working result, combining `date`, `dayType`, and `shiftType`.
+ *
+ * @property {string} key - {@link WorkingResult#key}
+ *
  * @computed {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
  * - Returns a string in the format YYYY-MM-DD based on `dateAt`.
  * @computed {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)

package/src/Operation.js

@@ -11,51 +11,58 @@
  * - `startTime`, `endTime`, and `breakMinutes` are NOT synchronized here.
  *   They should be synchronized at `SiteOperationSchedule` level instead.
  * ---------------------------------------------------------------------------
- * @prop {string} siteId
+ * @property {string} siteId
  * - Site document ID (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {number} requiredPersonnel
+ * @property {number} requiredPersonnel
  * - Required number of personnel
  *
- * @prop {boolean} qualificationRequired
+ * @property {boolean} qualificationRequired
  * - Qualification required flag
  *
- * @prop {string} workDescription
+ * @property {string} workDescription
  * - Work description
  *
- * @prop {string} remarks
+ * @property {string} remarks
  * - Remarks
  *
- * @prop {Array<OperationDetail>} employees
+ * @property {Array<OperationDetail>} employees
  * - Assigned employees
  * - Array of `OperationDetail` instances representing assigned employees
  *
- * @prop {Array<OperationDetail>} outsourcers
+ * @property {Array<OperationDetail>} outsourcers
  * - Assigned outsourcers
  * - Array of `OperationDetail` instances representing assigned outsourcers
  *
- * @prop {Array<string>} employeeIds - Array of employee IDs from `employees` (read-only)
+ * @property {Array<string>} employeeIds - Array of employee IDs from `employees` (read-only)
  * - Array of employee IDs from `employees` (read-only)
  *
- * @prop {Array<string>} outsourcerIds
+ * @property {Array<string>} outsourcerIds
  * - Array of outsourcer IDs from `outsourcers` (read-only)
  *
- * @prop {number} employeesCount
+ * @property {number} employeesCount
  * - Count of assigned employees (read-only)
  *
- * @prop {number} outsourcersCount
+ * @property {number} outsourcersCount
  * - Count of assigned outsourcers (sum of amounts) (read-only)
  *
- * @prop {boolean} isPersonnelShortage
+ * @property {boolean} isPersonnelShortage
  * - Indicates if there is a shortage of personnel (read-only)
  * - `true` if the sum of `employeesCount` and `outsourcersCount` is less than `requiredPersonnel`
  *
- * @prop {Array<OperationDetail>} workers
+ * @property {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
  *
+ * @property {string} key - `siteId`, `date`, `dayType`, `shiftType` を組み合わせたキー。（読み取り専用）
+ * - 2026-01-07 現在使用していないプロパティ。
+ * - `dayType` は請求時の単価情報を取得するために必要な情報であるため含める必要がないと思われる。
+ *
+ * @property {string} orderKey - `siteId`, `shiftType` を組み合わせたキー。（読み取り専用）
+ * - `siteOrder` の `key` プロパティに対応するキー。
+ *
  * @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`
@@ -69,19 +76,18 @@
  * - Workers whose `startTime`, `isStartNextDay`, `endTime`, `breakMinutes`, `isQualified`, or `isOjt` have changed
  * ---------------------------------------------------------------------------
  * @inherited - The following properties are inherited from WorkingResult:
- * @prop {string} key - Unique key combining `siteId`, `date`, `dayType`, and `shiftType` (override/read-only)
- * - A unique identifier for the working result, combining `siteId`, `date`, `dayType`, and `shiftType`.
- * @prop {Date} dateAt - Date of operation (placement date) (trigger property)
+ *
+ * @property {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)
+ * @property {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
+ * @property {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
+ * @property {string} startTime - Start time (HH:MM format)
+ * @property {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)
+ * @property {string} endTime - End time (HH:MM format)
+ * @property {number} breakMinutes - Break time (minutes)
+ * @property {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`.
  * ---------------------------------------------------------------------------
@@ -261,11 +267,13 @@ export default class Operation extends WorkingResult {
   afterInitialize(item = {}) {
     super.afterInitialize(item);
 
-    /**
-     * Override `key` computed property
-     * - `key`: Combines `siteId`, `date`, `dayType`, and `shiftType`.
-     */
     Object.defineProperties(this, {
+      /**
+       * `siteId`, `date`, `dayType`, `shiftType` を組み合わせたキー。（読み取り専用）
+       * - `WorkingResult.key` をオーバーライド。
+       * - 2026-01-07 現在使用していないプロパティ。
+       * - `dayType` は請求時の単価情報を取得するために必要な情報であるため含める必要がないと思われる。
+       */
       key: {
         configurable: true,
         enumberable: true,
@@ -274,6 +282,19 @@ export default class Operation extends WorkingResult {
         },
         set() {},
       },
+
+      /**
+       * `siteId`, `shiftType` を組み合わせたキー。（読み取り専用）
+       * - `siteOrder` の `key` プロパティに対応するキー。
+       */
+      orderKey: {
+        configurable: true,
+        enumberable: true,
+        get() {
+          return `${this.siteId}-${this.shiftType}`;
+        },
+        set() {},
+      },
     });
 
     /***********************************************************

package/src/OperationResult.js

@@ -10,107 +10,108 @@
  * - Automatically updates `billingDateAt` based on `dateAt` and `cutoffDate`.
  * - Introduces a lock mechanism (`isLocked`) to prevent edits when necessary.
  *
- * @prop {string} key - Unique key combining `siteId`, `date`, `dayType`, and `shiftType` (override/read-only)
- * - A unique identifier for the working result, combining `siteId`, `date`, `dayType`, and `shiftType`.
+ * @property { string } key - {@link Operation#key}
  *
- * @prop {string} siteId - Site document ID (trigger property)
+ * @property {string} orderKey - {@link Operation#orderKey}
+ *
+ * @property {string} siteId - Site document ID (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {Date} dateAt - Date of operation (placement date) (trigger property)
+ * @property {Date} dateAt - Date of operation (placement date) (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  * - Used to determine `dayType`.
  * - When `dateAt` changes, `billingDateAt` is also updated based on `agreement.cutoffDate`.
- * @prop {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
- * @prop {string} shiftType - `DAY` or `NIGHT` (trigger property)
+ * @property {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
+ * @property {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
+ * @property {string} startTime - Start time (HH:MM format)
+ * @property {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)
+ * @property {string} endTime - End time (HH:MM format)
+ * @property {number} breakMinutes - Break time (minutes)
+ * @property {number} regulationWorkMinutes - Regulation work minutes (trigger property)
  * - Indicates the maximum working time treated as regular working hours.
  * - 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<OperationResultDetail>} employees - Assigned employees
+ * @property {number} requiredPersonnel - Required number of personnel
+ * @property {boolean} qualificationRequired - Qualification required flag
+ * @property {string} workDescription - Work description
+ * @property {string} remarks - Remarks
+ * @property {Array<OperationResultDetail>} employees - Assigned employees
  * - Array of `OperationResultDetail` instances representing assigned employees
- * @prop {Array<OperationResultDetail>} outsourcers - Assigned outsourcers
+ * @property {Array<OperationResultDetail>} outsourcers - Assigned outsourcers
  * - Array of `OperationResultDetail` instances representing assigned outsourcers
- * @prop {Array<OperationResultDetail>} workers - Combined array of `employees` and `outsourcers`
+ * @property {Array<OperationResultDetail>} 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
- * @prop {string|null} siteOperationScheduleId - Associated SiteOperationSchedule document ID
+ * @property {string|null} siteOperationScheduleId - Associated SiteOperationSchedule document ID
  * - If this OperationResult was created from a SiteOperationSchedule, this property holds that ID.
- * @prop {boolean} useAdjustedQuantity - Flag to indicate if adjusted quantities are used for billing
- * @prop {number} adjustedQuantityBase - Adjusted quantity for base workers
+ * @property {boolean} useAdjustedQuantity - Flag to indicate if adjusted quantities are used for billing
+ * @property {number} adjustedQuantityBase - Adjusted quantity for base workers
  * - Quantity used for billing base workers when `useAdjustedQuantity` is true.
- * @prop {number} adjustedOvertimeBase - Adjusted overtime for base workers
+ * @property {number} adjustedOvertimeBase - Adjusted overtime for base workers
  * - Overtime used for billing base workers when `useAdjustedQuantity` is true.
- * @prop {number} adjustedQuantityQualified - Adjusted quantity for qualified workers
+ * @property {number} adjustedQuantityQualified - Adjusted quantity for qualified workers
  * - Quantity used for billing qualified workers when `useAdjustedQuantity` is true.
- * @prop {number} adjustedOvertimeQualified - Adjusted overtime for qualified workers
+ * @property {number} adjustedOvertimeQualified - Adjusted overtime for qualified workers
  * - Overtime used for billing qualified workers when `useAdjustedQuantity` is true.
- * @prop {Date} billingDateAt - Billing date
+ * @property {Date} billingDateAt - Billing date
  * - The date used for billing purposes.
- * @prop {boolean} isLocked - Lock flag
+ * @property {boolean} isLocked - Lock flag
  * - When set to true, the OperationResult is locked from edits exept for editing as OperationBilling.
- * @prop {Agreement|null} agreement - Associated Agreement object
+ * @property {Agreement|null} agreement - Associated Agreement object
  * - The Agreement instance associated with this OperationResult for pricing and billing information.
  * - When set, it influences billing calculations such as unit prices and billing dates.
- * @prop {boolean} allowEmptyAgreement - Flag to ignore missing Agreement
+ * @property {boolean} allowEmptyAgreement - Flag to ignore missing Agreement
  * - When set to true, allows the OperationResult to be valid even if no Agreement is associated.
  * @readonly
- * @prop {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
+ * @property {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
  * - Returns a string in the format YYYY-MM-DD based on `dateAt`.
- * @prop {Date} startAt - Start date and time (Date object) (read-only)
+ * @property {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.
- * @prop {Date} endAt - End date and time (Date object) (read-only)
+ * @property {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.
- * @prop {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
+ * @property {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
  * - `true` if `startTime` is later than `endTime`
- * @prop {number} totalWorkMinutes - Total working time in minutes (excluding break time) (read-only)
+ * @property {number} totalWorkMinutes - Total working time in minutes (excluding break time) (read-only)
  * - Calculated as the difference between `endAt` and `startAt` minus `breakMinutes`
- * @prop {number} regularTimeWorkMinutes - Regular working time in minutes (read-only)
+ * @property {number} regularTimeWorkMinutes - Regular working time in minutes (read-only)
  * - The portion of `totalWorkMinutes` that is considered within the contract's `regulationWorkMinutes`.
- * @prop {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
+ * @property {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
  * - Calculated as `totalWorkMinutes` minus `regulationWorkMinutes`
- * @prop {boolean} hasAgreement - Indicates if an Agreement is associated (read-only)
+ * @property {boolean} hasAgreement - Indicates if an Agreement is associated (read-only)
  * - `true` if `agreement` is set, otherwise `false`.
- * @prop {string|false} isInvalid - Validation status (read-only)
+ * @property {string|false} isInvalid - Validation status (read-only)
  * - Returns false if valid.
  * - Returns reason code string if invalid:
  *   - `EMPTY_BILLING_DATE`: Billing date is missing.
  *   - `EMPTY_AGREEMENT`: Agreement is missing and `allowEmptyAgreement` is false.
- * @prop {Object} statistics - Statistics of workers (read-only)
+ * @property {Object} statistics - Statistics of workers (read-only)
  * - Contains counts and total work minutes for base and qualified workers, including OJT breakdowns.
  * - Structure: { base: {...}, qualified: {...}, total: {...} }
  * - Each category contains: quantity, regularTimeWorkMinutes, overtimeWorkMinutes, totalWorkMinutes, breakMinutes
  * - Each category also has an 'ojt' subcategory with the same structure.
- * @prop {Object} sales - Sales amounts (read-only)
+ * @property {Object} sales - Sales amounts (read-only)
  * - Contains sales calculations for base and qualified workers, including overtime breakdowns.
  * - Structure: { base: {...}, qualified: {...} }
  * - Each category contains: unitPrice, quantity, regularAmount, overtimeUnitPrice, overtimeMinutes, overtimeAmount, total
  * - Calculations respect `useAdjustedQuantity`, `billingUnitType`, and `includeBreakInBilling` settings.
- * @prop {number} salesAmount - Total sales amount (read-only)
+ * @property {number} salesAmount - Total sales amount (read-only)
  * - Sum of sales amounts for base and qualified workers with rounding applied.
- * @prop {number} tax - Calculated tax amount (read-only)
+ * @property {number} tax - Calculated tax amount (read-only)
  * - Calculated using the `Tax` utility based on `salesAmount` and `date`.
- * @prop {number} billingAmount - Total billing amount including tax (read-only)
+ * @property {number} billingAmount - Total billing amount including tax (read-only)
  * - Sum of `salesAmount` and `tax`.
- * @prop {string|null} billingDate - Billing date in YYYY-MM-DD format (read-only)
+ * @property {string|null} billingDate - Billing date in YYYY-MM-DD format (read-only)
  * - Returns a string in the format YYYY-MM-DD based on `billingDateAt`.
- * @prop {string} billingMonth - Billing month in YYYY-MM format (read-only)
- * @prop {Array<string>} employeeIds - Array of employee IDs from `employees` (read-only)
- * @prop {Array<string>} outsourcerIds - Array of outsourcer IDs from `outsourcers` (read-only)
- * @prop {number} employeesCount - Count of assigned employees (read-only)
- * @prop {number} outsourcersCount - Count of assigned outsourcers (sum of amounts) (read-only)
- * @prop {boolean} isPersonnelShortage - Indicates if there is a shortage of personnel (read-only)
+ * @property {string} billingMonth - Billing month in YYYY-MM format (read-only)
+ * @property {Array<string>} employeeIds - Array of employee IDs from `employees` (read-only)
+ * @property {Array<string>} outsourcerIds - Array of outsourcer IDs from `outsourcers` (read-only)
+ * @property {number} employeesCount - Count of assigned employees (read-only)
+ * @property {number} outsourcersCount - Count of assigned outsourcers (sum of amounts) (read-only)
+ * @property {boolean} isPersonnelShortage - Indicates if there is a shortage of personnel (read-only)
  * - `true` if the sum of `employeesCount` and `outsourcersCount` is less than `requiredPersonnel`
  *
  * @getter {string} groupKey - Combines `siteId`, `shiftType`, and `date` to indicate operation grouping (read-only)

package/src/SiteOperationSchedule.js

@@ -18,16 +18,17 @@
  *   `siteId`, `dateAt`, `shiftType`, and `regulationWorkMinutes` are synchronized
  *   in the parent `Operation` class.
  *
- * @prop {string} key - Unique key combining `siteId`, `date`, `dayType`, and `shiftType` (override/read-only)
- * - A unique identifier for the working result, combining `siteId`, `date`, `dayType`, and `shiftType`.
+ * @property { string } key - {@link Operation#key}
  *
- * @prop {string|null} operationResultId - Associated OperationResult document ID
+ * @property {string} orderKey - {@link Operation#orderKey}
+ *
+ * @property {string|null} operationResultId - Associated OperationResult document ID
  * - If an OperationResult has been created based on this schedule, this property
  *   holds the ID of that OperationResult document.
  * - If this property is set, the schedule cannot be updated or deleted.
  *   Conversely, if the associated OperationResult is deleted, this property can be set to null.
  *
- * @prop {number} displayOrder - Display order
+ * @property {number} displayOrder - Display order
  * - Property to control the display order of schedules on the same date and shift type.
  * - Automatically assigned during creation based on existing documents.
  *
@@ -38,88 +39,88 @@
  * - Returns `true` if all workers in the `workers` array have `hasNotification` set to `true`
  *
  * @inherited - The following properties are inherited from Operation:
- * @prop {string} siteId - Site document ID (trigger property)
+ * @property {string} siteId - Site document ID (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {number} requiredPersonnel - Required number of personnel
+ * @property {number} requiredPersonnel - Required number of personnel
  *
- * @prop {boolean} qualificationRequired - Qualification required flag
+ * @property {boolean} qualificationRequired - Qualification required flag
  *
- * @prop {string} workDescription - Work description
+ * @property {string} workDescription - Work description
  *
- * @prop {string} remarks - Remarks
+ * @property {string} remarks - Remarks
  *
- * @prop {Array<SiteOperationScheduleDetail>} employees - Assigned employees
+ * @property {Array<SiteOperationScheduleDetail>} employees - Assigned employees
  * - Array of `SiteOperationScheduleDetail` instances representing assigned employees
  *
- * @prop {Array<SiteOperationScheduleDetail>} outsourcers - Assigned outsourcers
+ * @property {Array<SiteOperationScheduleDetail>} outsourcers - Assigned outsourcers
  * - Array of `SiteOperationScheduleDetail` instances representing assigned outsourcers
  *
  * @inherited - The following properties are inherited from WorkingResult (via Operation):
- * @prop {Date} dateAt - Date of operation (placement date) (trigger property)
+ * @property {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`)
+ * @property {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
  *
- * @prop {string} shiftType - `DAY` or `NIGHT` (trigger property)
+ * @property {string} shiftType - `DAY` or `NIGHT` (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {string} startTime - Start time (HH:MM format) (trigger property)
+ * @property {string} startTime - Start time (HH:MM format) (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {boolean} isStartNextDay - Next day start flag (trigger property)
+ * @property {boolean} isStartNextDay - Next day start flag (trigger property)
  * - `true` if the actual work starts the day after the placement date `dateAt`
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {string} endTime - End time (HH:MM format) (trigger property)
+ * @property {string} endTime - End time (HH:MM format) (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {number} breakMinutes - Break time (minutes) (trigger property)
+ * @property {number} breakMinutes - Break time (minutes) (trigger property)
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
- * @prop {number} regulationWorkMinutes - Regulation work minutes (trigger property)
+ * @property {number} regulationWorkMinutes - Regulation work minutes (trigger property)
  * - Indicates the maximum working time treated as regular working hours.
  * - Automatically synchronizes to all `employees` and `outsourcers` when changed.
  *
  * @inherited - The following computed properties are inherited from Operation:
- * @prop {Array<string>} employeeIds - Array of employee IDs from `employees` (read-only)
+ * @property {Array<string>} employeeIds - Array of employee IDs from `employees` (read-only)
  *
- * @prop {Array<string>} outsourcerIds - Array of outsourcer IDs from `outsourcers` (read-only)
+ * @property {Array<string>} outsourcerIds - Array of outsourcer IDs from `outsourcers` (read-only)
  *
- * @prop {number} employeesCount - Count of assigned employees (read-only)
+ * @property {number} employeesCount - Count of assigned employees (read-only)
  *
- * @prop {number} outsourcersCount - Count of assigned outsourcers (sum of amounts) (read-only)
+ * @property {number} outsourcersCount - Count of assigned outsourcers (sum of amounts) (read-only)
  *
- * @prop {boolean} isPersonnelShortage - Indicates if there is a shortage of personnel (read-only)
+ * @property {boolean} isPersonnelShortage - Indicates if there is a shortage of personnel (read-only)
  * - `true` if the sum of `employeesCount` and `outsourcersCount` is less than `requiredPersonnel`
  *
- * @prop {Array<SiteOperationScheduleDetail>} workers - Combined array of `employees` and `outsourcers`
+ * @property {Array<SiteOperationScheduleDetail>} 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
  *
  * @inherited - The following computed properties are inherited from WorkingResult (via Operation):
- * @prop {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
+ * @property {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
  * - Returns a string in the format YYYY-MM-DD based on `dateAt`.
  *
- * @prop {Date} startAt - Start date and time (Date object) (read-only)
+ * @property {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.
  *
- * @prop {Date} endAt - End date and time (Date object) (read-only)
+ * @property {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.
  *
- * @prop {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
+ * @property {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
  * - `true` if `startTime` is later than `endTime`
  *
- * @prop {number} totalWorkMinutes - Total working time in minutes (excluding break time) (read-only)
+ * @property {number} totalWorkMinutes - Total working time in minutes (excluding break time) (read-only)
  * - Calculated as the difference between `endAt` and `startAt` minus `breakMinutes`
  *
- * @prop {number} regularTimeWorkMinutes - Regular working time in minutes (read-only)
+ * @property {number} regularTimeWorkMinutes - Regular working time in minutes (read-only)
  * - The portion of `totalWorkMinutes` that is considered within the contract's `regulationWorkMinutes`.
  *
- * @prop {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
+ * @property {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
  * - Calculated as `totalWorkMinutes` minus `regulationWorkMinutes`
  *
  * @inherited - The following getter properties are inherited from Operation:

package/src/WorkingResult.js

@@ -2,46 +2,60 @@
  * WorkingResult ver 1.0.0
  * @author shisyamo4131
  * ---------------------------------------------------------------------------
+ * - `Agreement`, `Operation` クラスの継承元となるクラスです。
  * A class representing the working result for a specific date and shift extending FireModel.
  * - This class is intended to be inherited by other classes so, it cannot be instantiated directly.
  * - `dateAt` is defined as a trigger property. When it is set, `dayType` is automatically updated.
  * - Subclasses can override `setDateAtCallback` to add custom behavior when `dateAt` changes.
  * ---------------------------------------------------------------------------
- * @prop {Date} dateAt - Applicable start date (trigger property)
- * @prop {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
- * @prop {string} shiftType - Shift type (`DAY`, `NIGHT`)
- * @prop {string} startTime - Start time (HH:MM format)
- * @prop {boolean} isStartNextDay - Next day start flag
+ * @property {Date} dateAt - Applicable start date (trigger property)
+ *
+ * @property {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
+ *
+ * @property {string} shiftType - Shift type (`DAY`, `NIGHT`)
+ *
+ * @property {string} startTime - Start time (HH:MM format)
+ *
+ * @property {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
+ *
+ * @property {string} endTime - End time (HH:MM format)
+ *
+ * @property {number} breakMinutes - Break time (minutes)
+ *
+ * @property {number} regulationWorkMinutes - Regulation work minutes
  * - The maximum working time defined by `unitPriceBase` (or `unitPriceQualified`).
  * - Exceeding this time is considered overtime.
  *
- * @computed
- * @prop {string} key - Unique key combining `date`, `dayType`, and `shiftType` (read-only)
- * - A unique identifier for the working result, combining `date`, `dayType`, and `shiftType`.
- * @prop {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
+ * @property {string} key - `date`, `dayType`, `shifType` を組み合わせたユニークキー。（読み取り専用）
+ * - 継承先である `Agreement` でデータを一意に識別するためのキーとして使用されます。
+ *
+ * @property {string} date - Date string in YYYY-MM-DD format based on `dateAt` (read-only)
  * - Returns a string in the format YYYY-MM-DD based on `dateAt`.
- * @prop {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
+ *
+ * @property {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
  * - `true` if `startTime` is later than `endTime`
- * @prop {Date} startAt - Start date and time (Date object) (read-only)
+ *
+ * @property {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.
- * @prop {Date} endAt - End date and time (Date object) (read-only)
+ *
+ * @property {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.
- * @prop {number} totalWorkMinutes - Total working time in minutes (excluding break time) (read-only)
+ *
+ * @property {number} totalWorkMinutes - Total working time in minutes (excluding break time) (read-only)
  * - Calculated as the difference between `endAt` and `startAt` minus `breakMinutes`
  * - If the difference between `endAt` and `startAt` is negative, returns 0.
  * - If `startAt` or `endAt` is not set, returns 0.
- * @prop {number} regularTimeWorkMinutes - Regular working time in minutes (read-only)
+ *
+ * @property {number} regularTimeWorkMinutes - Regular working time in minutes (read-only)
  * - The portion of `totalWorkMinutes` that is considered within the contract's `regulationWorkMinutes`.
  * - If actual working time is less than regulation time (e.g., early leave), it equals `totalWorkMinutes`.
  * - If actual working time exceeds regulation time (overtime), it equals `regulationWorkMinutes`.
- * @prop {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
+ *
+ * @property {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
  * - Calculated as `totalWorkMinutes` minus `regulationWorkMinutes`
  * - Overtime work is not negative; the minimum is 0.
  * ---------------------------------------------------------------------------