@shisyamo4131/air-guard-v2-schemas 2.4.2-dev.0 → 2.4.2-dev.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shisyamo4131/air-guard-v2-schemas",
-  "version": "2.4.2-dev.0",
+  "version": "2.4.2-dev.10",
   "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/Company.js

@@ -2,6 +2,7 @@
  * Company Model
  * @version 1.0.0
  * @author shisyamo4131
+ * @update 2026-01-06 - Add `firstDayOfWeek` property.
  * @update 2025-12-29 - Add `isCompleteRequiredFields` computed property.
  * @update 2025-12-02 - Add maintenance information properties.
  * @update 2025-12-01 - Add Stripe integration fields (stripeCustomerId, subscription).
@@ -15,6 +16,7 @@ import Agreement from "./Agreement.js";
 import SiteOrder from "./SiteOrder.js";
 import RoundSetting from "./RoundSetting.js";
 import { GeocodableMixin } from "./mixins/GeocodableMixin.js";
+import { DAY_OF_WEEK_OPTIONS, DAY_OF_WEEK_VALUES } from "./constants/index.js";
 
 const classProps = {
   companyName: defField("name", { label: "会社名", required: true }),
@@ -42,12 +44,7 @@ const classProps = {
   accountType: defField("select", {
     label: "口座種別",
     default: "普通",
-    component: {
-      name: "air-select",
-      attrs: {
-        items: ["普通", "当座"],
-      },
-    },
+    component: { name: "air-select", attrs: { items: ["普通", "当座"] } },
   }),
   accountNumber: defField("oneLine", { label: "口座番号", length: 7 }),
   accountHolder: defField("oneLine", { label: "口座名義", length: 50 }),
@@ -97,6 +94,19 @@ const classProps = {
     },
   }),
 
+  firstDayOfWeek: defField("select", {
+    label: "週の始まり",
+    default: DAY_OF_WEEK_VALUES[0].value,
+    component: {
+      name: "air-select",
+      attrs: {
+        items: DAY_OF_WEEK_OPTIONS,
+        hint: "勤怠管理などで週の始まりとする曜日を設定します。",
+        persistentHint: true,
+      },
+    },
+  }),
+
   /** Stripe連携フィールド */
   stripeCustomerId: defField("oneLine", {
     label: "Stripe顧客ID",

package/src/Operation.js

@@ -11,51 +11,60 @@
  * - `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` を組み合わせたキー。（読み取り専用）
+ * - `WorkingResult.key` をオーバーライドして `siteId` を含めるように定義されているが、未使用。
+ *
+ * @property {string} agreementKey - `siteId`, `date`, `dayType`, `shiftType` を組み合わせたキー。（読み取り専用）
+ * - 適用する取極めを特定するためのキーとして使用される。
+ *
+ * @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 +78,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 +269,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 +284,32 @@ export default class Operation extends WorkingResult {
         },
         set() {},
       },
+
+      /**
+       * `siteId`, `date`, `dayType`, `shiftType` を組み合わせたキー。（読み取り専用）
+       * - 適用する取極めを特定するためのキーとして使用される。
+       */
+      agreementKey: {
+        configurable: true,
+        enumberable: true,
+        get() {
+          return `${this.siteId}-${this.date}-${this.dayType}-${this.shiftType}`;
+        },
+        set() {},
+      },
+
+      /**
+       * `siteId`, `shiftType` を組み合わせたキー。（読み取り専用）
+       * - `siteOrder` の `key` プロパティに対応するキー。
+       */
+      orderKey: {
+        configurable: true,
+        enumberable: true,
+        get() {
+          return `${this.siteId}-${this.shiftType}`;
+        },
+        set() {},
+      },
     });
 
     /***********************************************************

package/src/OperationResult.js

@@ -1,6 +1,5 @@
 /*****************************************************************************
  * OperationResult Model
- * @version 1.2.0 - 2025-11-19 Add `agreement`, `hasAgreement`, `isValid` properties.
  * @author shisyamo4131
  *
  * - Extends Operation class to represent the result of an operation.
@@ -10,107 +9,110 @@
  * - 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} agreementKey - {@link Operation#agreementKey}
+ *
+ * @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)
@@ -543,7 +545,6 @@ export default class OperationResult extends Operation {
   /**
    * Synchronize customerId and apply (re-apply) agreement from siteId
    * @param {Object} [args.transaction] - Firestore transaction.
-   * @param {Function} [args.callBack] - Callback function.
    * @param {string} [args.prefix] - Path prefix.
    * @returns {Promise<void>}
    * @throws {Error} If the specified siteId does not exist
@@ -600,7 +601,11 @@ export default class OperationResult extends Operation {
     }
 
     // Sync customerId and apply agreement if key changed
-    if (this.key === this._beforeData.key) return;
+    /**
+     * 2026-01-08 `agreementKey` を実装したため、`key` の使用を避ける。
+     */
+    // if (this.key === this._beforeData.key) return;
+    if (this.agreementKey === this._beforeData.agreementKey) return;
     await this._syncCustomerIdAndApplyAgreement();
   }
 

package/src/Site.js

@@ -1,16 +1,17 @@
 /**
  * @file src/Site.js
  * @author shisyamo4131
- * @version 1.1.0
- * @update 2025-11-20 version 0.2.0-bata
- *                    - Prevent changing customer reference on update.
- *                    - Move `customer` property to the top of classProps for better visibility.
- *
- * NOTE: `customer` プロパティについて
- * 自身の従属先データを持たせる場合に `XxxxxMinimal` クラスを使用するが、アプリ側でオブジェクト選択を行う場合に
- * `Xxxxx` クラスにするのか `XxxxxMinimal` クラスにするのかを判断できないため、docId を持たせて
- * `beforeCreate` フックでオブジェクトを取得するようにする。
- * 尚、取引先は変更できない仕様。
+ *
+ * NOTE: `customerId`, `customer` プロパティについて
+ * - 仮登録
+ *   - 取引先未定での現場登録のシチュエーションを考慮して現場情報は仮登録を可能とする。
+ *   - 仮登録状態の現場は `isTemporary` プロパティが `true` となる。
+ *   - 但し、一度取引先を設定した後に未設定に戻すことはできない。
+ *   - 取引先未設定の場合に、`Site` インスタンスから取引先名を参照する必要があるケースに備えて
+ *     `customerName` プロパティを設ける。
+ * - 自身の従属先データを持たせる場合に `XxxxxMinimal` クラスを使用するが、アプリ側でオブジェクト選択を行う場合に
+ *   `Xxxxx` クラスにするのか `XxxxxMinimal` クラスにするのかを判断できないため、docId を持たせて
+ *   `beforeCreate` フックでオブジェクトを取得するようにする。
  */
 import { default as FireModel } from "@shisyamo4131/air-firebase-v2";
 import { defField } from "./parts/fieldDefinitions.js";
@@ -22,16 +23,24 @@ import { GeocodableMixin } from "./mixins/GeocodableMixin.js";
 
 const classProps = {
   customerId: defField("customerId", {
-    required: true,
     component: {
       attrs: {
-        disabled: ({ editMode }) => {
-          return editMode !== "CREATE";
+        /** `_beforeData.customerId` が存在する場合（本登録後の編集時を表す）には `customerId` を必須とする。 */
+        required: ({ item }) => {
+          return !!item._beforeData.customerId;
         },
       },
     },
   }),
   customer: defField("customer", { hidden: true, customClass: Customer }),
+
+  /**
+   * 取引先名
+   * - `customerId` が未設定の場合に必須（仮登録状態で取引先の名前だけ登録したい場合を想定）
+   */
+  customerName: defField("customerName", {
+    required: ({ item }) => !item.customerId,
+  }),
   code: defField("code", { label: "現場コード" }),
   name: defField("name", {
     label: "現場名",
@@ -55,24 +64,40 @@ const classProps = {
 };
 
 /*****************************************************************************
- * @props {string} code - Site code.
- * @props {string} name - Site name.
- * @props {string} nameKana - Site name in Kana.
- * @props {string} zipcode - Postal code.
- * @props {string} prefCode - Prefecture code.
- * @props {string} city - City name.
- * @props {string} address - Address details.
- * @props {string} building - Building name.
- * @props {object} location - Geographical location.
- * @props {object} customer - Associated customer (CustomerMinimal).
- * @props {string} remarks - Additional remarks.
- * @props {array} agreements - List of agreements (Agreement).
+ * @property {string} customerId - 取引先ドキュメントID
+ *
+ * @property {object} customer - 取引先オブジェクト
+ * - `beforeCreate`, `beforeUpdate` で `customerId` に該当する `Customer` オブジェクトと自動的に同期されます。
+ * - `Customer` が更新された場合は Cloud Functions で同期される必要があります。
+ *
+ * @property {string} customerName - 取引先名
+ * - `customerId` が未設定の場合に必須（仮登録状態で取引先の名前だけ登録したい場合を想定）
+ *
+ * @property {string} code - 現場コード
+ *
+ * @property {string} name - 現場名
+ *
+ * @property {string} nameKana - 現場名カナ
+ *
+ * @property {string} zipcode - Postal code.
+ * @property {string} prefCode - Prefecture code.
+ *
+ * @property {string} prefecture - Prefecture name derived from `prefCode` (read-only)
+ *
+ * @property {string} city - City name.
+ * @property {string} address - Address details.
+ * @property {string} building - Building name.
+ *
+ * @property {string} fullAddress - Full address combining prefecture, city, and address (read-only)
+ *
+ * @property {object} location - Geographical location.
+ * @property {string} remarks - Additional remarks.
+ * @property {array} agreements - List of agreements (Agreement).
  * - Enhanced with custom methods: `add()`, `change()`, `remove()`
- * @props {string} status - Site status.
  *
- * @computed {string} customerId - ID of the associated customer (read-only)
- * @computed {string} fullAddress - Full address combining prefecture, city, and address (read-only)
- * @computed {string} prefecture - Prefecture name derived from `prefCode` (read-only)
+ * @property {string} status - Site status.
+ *
+ * @property {boolean} isTemporary - 仮登録状態かどうかを表すフラグ
  *
  * @function getAgreement
  * Gets applicable agreement based on date, dayType, and shiftType.
@@ -127,31 +152,39 @@ export default class Site extends GeocodableMixin(FireModel) {
   static STATUS_TERMINATED = VALUES.TERMINATED.value;
 
   /**
-   * Overrides to fetch and set the customer object before creation.
-   * @param {Object} args - Creation options.
-   * @param {string} [args.docId] - Document ID to use (optional).
-   * @param {boolean} [args.useAutonumber=true] - Whether to use auto-numbering.
-   * @param {Object} [args.transaction] - Firestore transaction.
-   * @param {Function} [args.callBack] - Callback function.
-   * @param {string} [args.prefix] - Path prefix.
+   * `customerId` に該当する `Customer` インスタンスを取得して `customer` プロパティにセットします。
+   * - `customerId` が未設定の場合は何もしません。
    * @returns {Promise<void>}
+   * @throws {Error} `Customer` が存在しない場合にスローされます。
    */
-  async beforeCreate(args = {}) {
-    await super.beforeCreate(args);
+  async _setCustomer() {
     if (!this.customerId) return;
     const customerInstance = new Customer();
     const isExist = await customerInstance.fetch({
-      ...args,
       docId: this.customerId,
     });
     if (!isExist) {
-      return Promise.reject(
-        new Error("Invalid customerId: Customer does not exist.")
-      );
+      throw new Error("Customer does not exist.");
     }
     this.customer = customerInstance;
   }
 
+  /**
+   * ドキュメント作成直前の処理です。
+   * - `customerId` に該当する `Customer` インスタンスを取得して `customer` プロパティにセットします。
+   * @param {Object} args - Creation options.
+   * @param {string} [args.docId] - Document ID to use (optional).
+   * @param {boolean} [args.useAutonumber=true] - Whether to use auto-numbering.
+   * @param {Object} [args.transaction] - Firestore transaction.
+   * @param {Function} [args.callBack] - Callback function.
+   * @param {string} [args.prefix] - Path prefix.
+   * @returns {Promise<void>}
+   */
+  async beforeCreate(args = {}) {
+    await super.beforeCreate(args);
+    await this._setCustomer();
+  }
+
   /**
    * Override beforeUpdate to prevent changing customer reference.
    * @param {Object} args - Creation options.
@@ -162,22 +195,48 @@ export default class Site extends GeocodableMixin(FireModel) {
    */
   async beforeUpdate(args = {}) {
     await super.beforeUpdate(args);
-    if (this.customer.docId !== this._beforeData.customer.docId) {
-      return Promise.reject(
-        new Error("Not allowed to change customer reference.")
-      );
+
+    // 一度設定した取引先を未設定に戻すことはできない。
+    if (this._beforeData.customerId && !this.customerId) {
+      throw new Error("Cannot unset customerId once it is set.");
+    }
+
+    // 取引先が変更されていた場合は `customer` プロパティを更新する。
+    if (this.customerId !== this._beforeData.customerId) {
+      await this._setCustomer();
     }
   }
 
+  /**
+   * Override `afterInitialize` to define custom accessors and methods.
+   * - Defines `fullAddress`, `prefecture`, and `isTemporary` accessors.
+   * - Enhances `agreements` array with `add`, `change`, and `remove` methods.
+   * @param {Object} item - Initial data item.
+   * @return {void}
+   */
   afterInitialize(item = {}) {
     super.afterInitialize(item);
 
+    /** Define `fullAddress`, `prefecture`, and `isTemporary` accessors. */
     Object.defineProperties(this, {
-      // customerId: defAccessor("customerId"),
       fullAddress: defAccessor("fullAddress"),
       prefecture: defAccessor("prefecture"),
+      isTemporary: {
+        configurable: true,
+        enumerable: true,
+        get() {
+          return !this.customerId;
+        },
+        set() {},
+      },
     });
 
+    /**
+     * `Agreement` プロパティに対するカスタムメソッドを定義します。
+     * - add(agreement): `Agreement` インスタンスを追加します。
+     * - change(newAgreement): `key` プロパティを基に既存の `Agreement` を置き換えます。
+     * - remove(agreement): `key` プロパティを基に `Agreement` を削除します。
+     */
     const self = this;
     Object.defineProperties(this.agreements, {
       add: {

package/src/SiteOperationSchedule.js

@@ -18,16 +18,19 @@
  *   `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} agreementKey - {@link Operation#agreementKey}
+ *
+ * @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 +41,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:
@@ -218,6 +221,7 @@ import { ContextualError } from "./utils/index.js";
 import ArrangementNotification from "./ArrangementNotification.js";
 import SiteOperationScheduleDetail from "./SiteOperationScheduleDetail.js";
 import OperationResult from "./OperationResult.js";
+import Site from "./Site.js";
 
 const classProps = {
   ...Operation.classProps,
@@ -709,15 +713,29 @@ export default class SiteOperationSchedule extends Operation {
    * @update 2025-11-28 - Removed the `agreement` parameter.
    */
   async syncToOperationResult(notifications = {}) {
+    // ドキュメントIDがない（現場稼働予定ドキュメントとして未作成）場合はエラー
     if (!this.docId) {
       throw new Error(
         "不正な処理です。作成前の現場稼働予定から稼働実績を作成することはできません。"
       );
     }
 
-    if (!notifications) {
-      throw new Error("配置通知の指定が必要です。");
+    // 現場データの存在確認と登録状態の確認
+    // - 存在しない、または仮登録状態の場合はエラー
+    const siteInstance = new Site();
+    const siteIsExist = await siteInstance.fetch({ docId: this.siteId });
+    if (!siteIsExist) {
+      throw new Error(
+        `不正な処理です。現場ID: ${this.siteId} の現場データが存在しません。`
+      );
+    }
+    if (siteInstance.isTemporary) {
+      throw new Error(
+        `不正な処理です。現場ID: ${this.siteId} の現場データは仮登録状態です。`
+      );
     }
+
+    // 配置通知データをもとに、従業員・外注先の稼働実績詳細データを生成する関数
     const converter = (prop) => {
       return this[prop].map((w) => {
         const notification = notifications[w.notificationKey];
@@ -731,8 +749,11 @@ export default class SiteOperationSchedule extends Operation {
         });
       });
     };
+
+    // 従業員・外注先の稼働実績詳細データを生成
     const employees = converter("employees");
     const outsourcers = converter("outsourcers");
+
     try {
       // Create OperationResult instance based on the current SiteOperationSchedule
       const operationResult = new OperationResult({
@@ -753,7 +774,7 @@ export default class SiteOperationSchedule extends Operation {
       throw new ContextualError(error.message, {
         method: "syncToOperationResult()",
         className: "SiteOperationSchedule",
-        arguments: { agreement },
+        arguments: {},
         state: this.toObject(),
       });
     }

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`, `shiftType` を組み合わせたユニークキー。（読み取り専用）
+ * - 継承先である `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.
  * ---------------------------------------------------------------------------

package/src/constants/day-of-week.js

@@ -0,0 +1,20 @@
+// prettier-ignore
+export const VALUES = Object.freeze({
+  0: { value: 0, title: "日曜日" },
+  1: { value: 1, title: "月曜日" },
+  2: { value: 2, title: "火曜日" },
+  3: { value: 3, title: "水曜日" },
+  4: { value: 4, title: "木曜日" },
+  5: { value: 5, title: "金曜日" },
+  6: { value: 6, title: "土曜日" },
+});
+
+export const OPTIONS = [
+  { title: VALUES[0].title, value: VALUES[0].value },
+  { title: VALUES[1].title, value: VALUES[1].value },
+  { title: VALUES[2].title, value: VALUES[2].value },
+  { title: VALUES[3].title, value: VALUES[3].value },
+  { title: VALUES[4].title, value: VALUES[4].value },
+  { title: VALUES[5].title, value: VALUES[5].value },
+  { title: VALUES[6].title, value: VALUES[6].value },
+];

package/src/constants/index.js

@@ -18,6 +18,16 @@ export {
   VALUES as CONTRACT_STATUS_VALUES,
   OPTIONS as CONTRACT_STATUS_OPTIONS,
 } from "./contract-status.js";
+
+/**
+ * Day of Week Constants
+ * @see src/constants/day-of-week.js
+ */
+export {
+  VALUES as DAY_OF_WEEK_VALUES,
+  OPTIONS as DAY_OF_WEEK_OPTIONS,
+} from "./day-of-week.js";
+
 export {
   VALUES as DAY_TYPE_VALUES,
   OPTIONS as DAY_TYPE_OPTIONS,

package/src/parts/fieldDefinitions.js

@@ -287,6 +287,21 @@ export const fieldDefinitions = {
       },
     },
   },
+
+  /**
+   * 取引先名
+   * - 2文字以上最大20文字
+   */
+  customerName: {
+    ...generalDefinitions.oneLine,
+    label: "取引先名",
+    length: 20,
+    component: {
+      name: generalDefinitions.oneLine.component.name,
+      attrs: { minLength: 2 },
+    },
+  },
+
   displayName: {
     ...generalDefinitions.oneLine,
     label: "表示名",