@shisyamo4131/air-guard-v2-schemas 2.3.7-dev.21 → 2.3.7-dev.23

package/package.json

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

package/src/Employee.js

@@ -37,6 +37,14 @@ const classProps = {
       },
     },
   }),
+  reasonOfTermination: defField("reasonOfTermination", {
+    component: {
+      attrs: {
+        required: (item) => item.employmentStatus === VALUES.TERMINATED.value,
+        disabled: (item) => item.employmentStatus !== VALUES.TERMINATED.value,
+      },
+    },
+  }),
   isForeigner: defField("isForeigner"),
   foreignName: defField("foreignName", {
     component: {
@@ -94,6 +102,7 @@ const classProps = {
  * @prop {string} employmentStatus - Employment status.
  * @prop {string} title - Job title.
  * @prop {Date} dateOfTermination - Date of termination.
+ * @prop {string} reasonOfTermination - Reason for termination.
  * @prop {boolean} isForeigner - Is the employee a foreigner.
  * @prop {string} foreignName - Foreign name.
  * @prop {string} nationality - Nationality.
@@ -154,30 +163,50 @@ export default class Employee extends FireModel {
 
   /**
    * 生年月日から年齢を計算します。
-   * @returns {number|null} 年齢。dateOfBirthが設定されていない場合はnull。
+   * @returns {{years: number, months: number}|null} 年齢（年数と月数）。dateOfBirthが設定されていない場合はnull。
    */
   get age() {
     if (!this.dateOfBirth) return null;
     const today = new Date();
-    let age = today.getUTCFullYear() - this.dateOfBirth.getUTCFullYear();
-    const m = today.getUTCMonth() - this.dateOfBirth.getUTCMonth();
-    const d = today.getUTCDate() - this.dateOfBirth.getUTCDate();
-    if (m < 0 || (m === 0 && d < 0)) age--;
-    return age;
+
+    let years = today.getUTCFullYear() - this.dateOfBirth.getUTCFullYear();
+    let months = today.getUTCMonth() - this.dateOfBirth.getUTCMonth();
+    const days = today.getUTCDate() - this.dateOfBirth.getUTCDate();
+
+    if (days < 0) {
+      months--;
+    }
+
+    if (months < 0) {
+      years--;
+      months += 12;
+    }
+
+    return { years, months };
   }
 
   /**
    * 入社日からの勤続年数を計算します。
-   * @returns {number|null} 勤続年数。dateOfHireが設定されていない場合はnull。
+   * @returns {{years: number, months: number}|null} 勤続年数（年数と月数）。dateOfHireが設定されていない場合はnull。
    */
   get yearsOfService() {
     if (!this.dateOfHire) return null;
     const today = new Date();
+
     let years = today.getUTCFullYear() - this.dateOfHire.getUTCFullYear();
-    const m = today.getUTCMonth() - this.dateOfHire.getUTCMonth();
-    const d = today.getUTCDate() - this.dateOfHire.getUTCDate();
-    if (m < 0 || (m === 0 && d < 0)) years--;
-    return years;
+    let months = today.getUTCMonth() - this.dateOfHire.getUTCMonth();
+    const days = today.getUTCDate() - this.dateOfHire.getUTCDate();
+
+    if (days < 0) {
+      months--;
+    }
+
+    if (months < 0) {
+      years--;
+      months += 12;
+    }
+
+    return { years, months };
   }
 
   /**
@@ -225,7 +254,10 @@ export default class Employee extends FireModel {
   /**
    * 退職済である場合の必須フィールドを検証します。
    * - エラーがある場合は例外をスローします。
-   * - `employmentStatus` が `active` の場合、`dateOfTermination` を初期化します。
+   * - `employmentStatus` が `terminated` の場合、以下のプロパティを必須とします。
+   *  - `dateOfTermination`
+   *  - `reasonOfTermination`
+   * - `employmentStatus` が `active` の場合、`dateOfTermination`, `reasonOfTermination` を初期化します。
    * @returns {void}
    * @throws {Error} 退職済の場合に必須フィールドが未入力の場合。
    */
@@ -236,8 +268,14 @@ export default class Employee extends FireModel {
           "[Employee.js] dateOfTermination is required when employmentStatus is 'terminated'."
         );
       }
+      if (!this.reasonOfTermination) {
+        throw new Error(
+          "[Employee.js] reasonOfTermination is required when employmentStatus is 'terminated'."
+        );
+      }
     } else {
       this.dateOfTermination = null;
+      this.reasonOfTermination = null;
     }
   }
 
@@ -281,6 +319,7 @@ export default class Employee extends FireModel {
   /**
    * 現在インスタンスに読み込まれている従業員を退職状態に変更します。
    * @param {Date} dateOfTermination - 退職日（Dateオブジェクト）
+   * @param {string} reasonOfTermination - 退職理由
    * @param {Object} options - パラメータオブジェクト
    * @param {Function|null} [options.transaction=null] - Firestore トランザクション関数
    * @param {Function|null} [options.callBack=null] - カスタム処理用コールバック
@@ -288,7 +327,7 @@ export default class Employee extends FireModel {
    * @returns {Promise<DocumentReference>} 更新されたドキュメントの参照
    * @throws {Error} docIdが存在しない場合、または有効なdateOfTerminationが提供されていない場合。
    */
-  async toTerminated(dateOfTermination, options = {}) {
+  async toTerminated(dateOfTermination, reasonOfTermination, options = {}) {
     if (!this.docId) {
       throw new Error(
         "[Employee.js] docId is required to terminate an employee."
@@ -299,14 +338,29 @@ export default class Employee extends FireModel {
         "[Employee.js] A valid dateOfTermination is required to terminate an employee."
       );
     }
+    if (dateOfTermination < this.dateOfHire) {
+      throw new Error(
+        "[Employee.js] dateOfTermination cannot be earlier than dateOfHire."
+      );
+    }
+
+    if (!reasonOfTermination || typeof reasonOfTermination !== "string") {
+      throw new Error(
+        "[Employee.js] A valid reasonOfTermination is required to terminate an employee."
+      );
+    }
 
     this.employmentStatus = Employee.STATUS_TERMINATED;
     this.dateOfTermination = dateOfTermination;
+    this.reasonOfTermination = reasonOfTermination;
 
     this._skipToTerminatedCheck = true;
 
     try {
       return await this.update(options);
+    } catch (error) {
+      this.rollback();
+      throw error;
     } finally {
       this._skipToTerminatedCheck = false;
     }

package/src/parts/fieldDefinitions.js

@@ -357,6 +357,11 @@ export const fieldDefinitions = {
     label: "在留資格",
     length: 10,
   },
+  reasonOfTermination: {
+    ...generalDefinitions.oneLine,
+    label: "退職理由",
+    length: 20,
+  },
   siteId: {
     ...generalDefinitions.oneLine,
     label: "現場",