@shisyamo4131/air-guard-v2-schemas 2.4.2-dev.80 → 2.4.2-dev.83

package/package.json

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

package/src/Employee.js

@@ -71,7 +71,7 @@ import Insurance from "./Insurance.js";
  * @static
  * @property {Object} EMPLOYMENT_STATUS - 雇用状況の定数オブジェクト
  * @property {string} STATUS_ACTIVE - 在職中の雇用状況を表す定数
- * @property {string} STATUS_TERMINATED - 退職済みの雇用状況を表す定数
+ * @property {string} STATUS_RESIGNED - 退職済みの雇用状況を表す定数
  *
  * @function toTerminated - 現在の従業員インスタンスを退職済みに変更する関数
  *****************************************************************************/
@@ -103,19 +103,17 @@ export default class Employee extends GeocodableMixin(FireModel) {
 
     /**
      * 退職年月日
-     * - `employmentStatus` が `TERMINATED` の場合、必須フィールド。
+     * - `employmentStatus` が `RESIGNED` の場合、必須フィールド。
      * - `employmentStatus` が `ACTIVE` の場合、入力不可（disabled）。
      * - バリデーションルール:
-     * - `employmentStatus` が `TERMINATED` の場合、必須。
-     * - `employmentStatus` が `TERMINATED` の場合、`dateOfHire` より前の日付は不可。
+     * - `employmentStatus` が `RESIGNED` の場合、必須。
+     * - `employmentStatus` が `RESIGNED` の場合、`dateOfHire` より前の日付は不可。
      * - `employmentStatus` が `ACTIVE` の場合、常に null でなければならない。
      * - フロントエンドのフォームでは、`employmentStatus` の値に応じて入力フィールドの表示/非表示や必須/任意を切り替えることが推奨される。
      */
     dateOfTermination: defField("dateOfTermination", {
       validator: (value, item) => {
-        if (
-          item.employmentStatus === EMPLOYMENT_STATUS_VALUES.TERMINATED.value
-        ) {
+        if (item.employmentStatus === EMPLOYMENT_STATUS_VALUES.RESIGNED.value) {
           if (!value) {
             return VALIDATION_ERRORS.CUSTOM_ERROR(
               "INVALID_DATE_OF_TERMINATION",
@@ -143,15 +141,13 @@ export default class Employee extends GeocodableMixin(FireModel) {
       component: {
         attrs: {
           required: ({ item }) =>
-            item.employmentStatus === EMPLOYMENT_STATUS_VALUES.TERMINATED.value,
+            item.employmentStatus === EMPLOYMENT_STATUS_VALUES.RESIGNED.value,
         },
       },
     }),
     reasonOfTermination: defField("reasonOfTermination", {
       validator: (value, item) => {
-        if (
-          item.employmentStatus === EMPLOYMENT_STATUS_VALUES.TERMINATED.value
-        ) {
+        if (item.employmentStatus === EMPLOYMENT_STATUS_VALUES.RESIGNED.value) {
           if (!value) {
             return VALIDATION_ERRORS.CUSTOM_ERROR(
               "INVALID_REASON_OF_TERMINATION",
@@ -172,7 +168,7 @@ export default class Employee extends GeocodableMixin(FireModel) {
       component: {
         attrs: {
           required: ({ item }) =>
-            item.employmentStatus === EMPLOYMENT_STATUS_VALUES.TERMINATED.value,
+            item.employmentStatus === EMPLOYMENT_STATUS_VALUES.RESIGNED.value,
         },
       },
     }),
@@ -570,7 +566,7 @@ export default class Employee extends GeocodableMixin(FireModel) {
   ];
 
   static STATUS_ACTIVE = EMPLOYMENT_STATUS_VALUES.ACTIVE.value;
-  static STATUS_TERMINATED = EMPLOYMENT_STATUS_VALUES.TERMINATED.value;
+  static STATUS_RESIGNED = EMPLOYMENT_STATUS_VALUES.RESIGNED.value;
 
   /** 2026-03-18 追加 */
   static EMPLOYMENT_STATUS = EMPLOYMENT_STATUS_VALUES;
@@ -682,13 +678,13 @@ export default class Employee extends GeocodableMixin(FireModel) {
 
   /**
    * 退職状態に関連するフィールドを初期化します。
-   * - `employmentStatus` が `TERMINATED` でない場合、以下のプロパティを初期化します。
+   * - `employmentStatus` が `RESIGNED` でない場合、以下のプロパティを初期化します。
    *  - `dateOfTermination`
    *  - `reasonOfTermination`
    * @returns {void}
    */
   _initTerminatedFields() {
-    if (this.employmentStatus !== EMPLOYMENT_STATUS_VALUES.TERMINATED.value) {
+    if (this.employmentStatus !== EMPLOYMENT_STATUS_VALUES.RESIGNED.value) {
       this.dateOfTermination = null;
       this.reasonOfTermination = null;
     }
@@ -785,7 +781,7 @@ export default class Employee extends GeocodableMixin(FireModel) {
     // - 一度退職処理した従業員の復帰処理は現状想定していないが、将来的に必要になった場合は `toActive` メソッド等を追加実装すること。
     if (
       !this._skipToTerminatedCheck &&
-      this.employmentStatus === Employee.STATUS_TERMINATED &&
+      this.employmentStatus === Employee.STATUS_RESIGNED &&
       this._beforeData.employmentStatus === Employee.STATUS_ACTIVE
     ) {
       throw new Error(
@@ -834,7 +830,7 @@ export default class Employee extends GeocodableMixin(FireModel) {
       );
     }
 
-    this.employmentStatus = Employee.STATUS_TERMINATED;
+    this.employmentStatus = Employee.STATUS_RESIGNED;
     this.dateOfTermination = dateOfTermination;
     this.reasonOfTermination = reasonOfTermination;
 

package/src/constants/arrangement-notification-status.js

@@ -1,13 +1,35 @@
-/**
- * @file arrangement-notification-status.js
- */
-
+/*****************************************************************************
+ * @file ./src/constants/arrangement-notification-status.js
+ * @description 配置通知状態定義
+ *
+ * ### 状態
+ * - 配置済（ARRANGED）: 管制により配置が行われた状態で、配置通知の初期状態。作業員はまだ確認していない。
+ * - 確認済（CONFIRMED）: 作業員が配置通知を確認し、了承した状態。
+ * - 上番済（ARRIVED）: 作業員が現場に到着し、作業を開始できる状態。
+ * - 下番済（LEAVED）: 作業員が作業を完了し、現場から離脱した状態。
+ *
+ * ### 状態遷移ルール
+ * - 配置済 (ARRANGED) : 確認済 (CONFIRMED) へ遷移可能。その他の状態への遷移は不可。
+ * - 確認済 (CONFIRMED) : 上番済 (ARRIVED) へ遷移可能。
+ *                       運用上は配置から外す処理によって配置通知ドキュメントそのものが削除されるため、配置済 (ARRANGED) への遷移は発生しない想定。
+ * - 上番済 (ARRIVED) : 確認済 (CONFIRMED) または下番済 (LEAVED) へ遷移可能。（誤って上番してしまった時）
+ *                      誤って上番してしまった場合に「確認済」へ戻すことも可能とする。
+ * - 下番済 (LEAVED) : 上番済 (ARRIVED) または下番済 (LEAVED) へ遷移可能。（誤って下番してしまった時）
+ *****************************************************************************/
 export const VALUES = Object.freeze({
   ARRANGED: {
     value: "ARRANGED",
     title: "配置済",
     order: 1,
     color: "#F57C00", // 🟠 配置通知済み（待機中）
+    /**
+     * 現在の状態に関わらず、常に使用不可。配置通知の初期状態であり、ユーザーが手動で「配置済」に設定することはないため。
+     * @param {*} currentStatus
+     * @returns {boolean}
+     */
+    disabled: (currentStatus) => {
+      return true;
+    },
   },
 
   CONFIRMED: {
@@ -15,6 +37,16 @@ export const VALUES = Object.freeze({
     title: "確認済",
     order: 2,
     color: "#2196F3", // 🔵 作業員が了承済み（準備中）
+    /**
+     * 現在の状態が「配置済」または「上番済」でなければ使用不可。
+     * - 「配置済」-> 「確認済」への遷移は可能。
+     * - 「上番済」-> 「確認済」への遷移は不可。
+     * @param {*} currentStatus
+     * @returns {boolean}
+     */
+    disabled: (currentStatus) => {
+      return !(currentStatus === "ARRANGED" || currentStatus === "ARRIVED");
+    },
   },
 
   ARRIVED: {
@@ -22,6 +54,15 @@ export const VALUES = Object.freeze({
     title: "上番済",
     order: 3,
     color: "#4CAF50", // 🟢 現場到着、作業開始可能
+    /**
+     * 現在の状態が「確認済」または「下番済」でなければ使用不可。
+     * - 「下番済」から「上番済」への遷移は可能（誤って下番してしまった場合に再度上番に戻すことを許容）。
+     * @param {*} currentStatus
+     * @returns {boolean}
+     */
+    disabled: (currentStatus) => {
+      return !(currentStatus === "CONFIRMED" || currentStatus === "LEAVED");
+    },
   },
 
   LEAVED: {
@@ -29,6 +70,16 @@ export const VALUES = Object.freeze({
     title: "下番済",
     order: 4,
     color: "#607D8B", // ⚫ 作業完了、離脱済み
+    /**
+     * 現在の状態が「上番済」または「下番済」でなければ使用不可。
+     * - 「上番済」-> 「下番済」への遷移は可能。
+     * - 「下番済」-> 「下番済」への遷移は可能（誤って下番してしまった場合に再度下番することを許容）。
+     * @param {*} currentStatus
+     * @returns {boolean}
+     */
+    disabled: (currentStatus) => {
+      return !(currentStatus === "ARRIVED" || currentStatus === "LEAVED");
+    },
   },
 
   /**

package/src/constants/employment-status.js

@@ -6,10 +6,10 @@
 
 export const VALUES = Object.freeze({
   ACTIVE: { value: "ACTIVE", title: "在職中" },
-  TERMINATED: { value: "TERMINATED", title: "退職済み" },
+  RESIGNED: { value: "RESIGNED", title: "退職済み" },
 });
 
 export const OPTIONS = [
   { title: VALUES.ACTIVE.title, value: VALUES.ACTIVE.value },
-  { title: VALUES.TERMINATED.title, value: VALUES.TERMINATED.value },
+  { title: VALUES.RESIGNED.title, value: VALUES.RESIGNED.value },
 ];