@shisyamo4131/air-guard-v2-schemas 2.4.2-dev.67 → 2.4.2-dev.69

package/package.json

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

package/src/Billing.js

@@ -28,6 +28,7 @@
 
 import FireModel from "@shisyamo4131/air-firebase-v2";
 import { defField } from "./parts/fieldDefinitions.js";
+import { formatJstDate } from "./utils/index.js";
 import OperationResult from "./OperationResult.js";
 
 const STATUS = {
@@ -74,16 +75,7 @@ export default class Billing extends FireModel {
         configurable: true,
         enumerable: true,
         get() {
-          if (!this.billingDateAt) return null;
-          const jstDate = new Date(
-            this.billingDateAt.getTime() + 9 * 60 * 60 * 1000
-          ); /* JST補正 */
-          const year = jstDate.getUTCFullYear();
-          const month = jstDate.getUTCMonth() + 1;
-          const day = jstDate.getUTCDate();
-          return `${year}-${String(month).padStart(2, "0")}-${String(
-            day
-          ).padStart(2, "0")}`;
+          return formatJstDate(this.billingDateAt);
         },
         set(v) {},
       },
@@ -91,13 +83,7 @@ export default class Billing extends FireModel {
         configurable: true,
         enumerable: true,
         get() {
-          if (!this.billingDateAt) return null;
-          const jstDate = new Date(
-            this.billingDateAt.getTime() + 9 * 60 * 60 * 1000
-          ); /* JST補正 */
-          const year = jstDate.getUTCFullYear();
-          const month = jstDate.getUTCMonth() + 1;
-          return `${year}-${String(month).padStart(2, "0")}`;
+          return formatJstDate(this.billingDateAt, "YYYY-MM");
         },
         set(v) {},
       },
@@ -108,16 +94,7 @@ export default class Billing extends FireModel {
         configurable: true,
         enumerable: true,
         get() {
-          if (!this.paymentDueDateAt) return null;
-          const jstDate = new Date(
-            this.paymentDueDateAt.getTime() + 9 * 60 * 60 * 1000
-          ); /* JST補正 */
-          const year = jstDate.getUTCFullYear();
-          const month = jstDate.getUTCMonth() + 1;
-          const day = jstDate.getUTCDate();
-          return `${year}-${String(month).padStart(2, "0")}-${String(
-            day
-          ).padStart(2, "0")}`;
+          return formatJstDate(this.paymentDueDateAt);
         },
         set(v) {},
       },
@@ -125,13 +102,7 @@ export default class Billing extends FireModel {
         configurable: true,
         enumerable: true,
         get() {
-          if (!this.paymentDueDateAt) return null;
-          const jstDate = new Date(
-            this.paymentDueDateAt.getTime() + 9 * 60 * 60 * 1000
-          ); /* JST補正 */
-          const year = jstDate.getUTCFullYear();
-          const month = jstDate.getUTCMonth() + 1;
-          return `${year}-${String(month).padStart(2, "0")}`;
+          return formatJstDate(this.paymentDueDateAt, "YYYY-MM");
         },
         set(v) {},
       },

package/src/Insurance.js

@@ -30,16 +30,17 @@ export const ERROR_MESSAGES = Object.freeze({
  * @property {Date|null} lossDateAt - 喪失日を表す日付オブジェクト。加入していない場合は null になります。
  * @property {string|null} lossReason - 喪失理由を表す文字列。加入していない場合は null になります。
  * @property {boolean} isProcessing - 加入手続き中であるかどうかを表す真偽値。加入手続き中の場合は true、そうでない場合は false になります。
+ * @property {boolean} isRetire - 退職による喪失であるかどうかを表す真偽値。退職による喪失の場合は true、そうでない場合は false になります。
  * @property {Array} history - 状態遷移の履歴を記録するための配列。各要素は状態遷移前の状態を表すオブジェクトです。
  *
  * @note
  * - 各プロパティは `現在の状態` を表すもので、状態の遷移には対応するメソッドを利用します。
- *   - `lossDateAt`（喪失日）と `lossReason`（喪失理由）は、`現在の状態` という意味では不要なプロパティですが、
+ *   - `lossDateAt`（喪失日）、`lossReason`（喪失理由）、`isRetire`（退職フラグ）は、`現在の状態` という意味では不要なプロパティですが、
  *     資格喪失処理の際に必要になる情報であるため、プロパティとして用意しています。
  * - 状態を遷移させるために必要な情報をこのインスタンスに設定（入力）する場合、
  *   必ず複製したインスタンスのプロパティを編集し、複製元インスタンスの
  *   状態遷移用メソッドを呼び出す際に引数として渡す、という形で利用してください。
- * - 各状態遷移メソッドでは、`lossDateAt`（喪失日）と `lossReason`（喪失理由）は必ず null に初期化されます。
+ * - 各状態遷移メソッドでは、`lossDateAt`（喪失日）、`lossReason`（喪失理由）、`isRetire`（退職フラグ）は必ず初期化されます。
  *
  * @method exempt - 現在の状態を `EXEMPT (適用除外)` に更新します。
  * @method enroll - 現在の状態を `ENROLLED (加入)` に更新します。
@@ -58,6 +59,7 @@ export default class Insurance extends BaseClass {
     lossDateAt: defField("lossDateAt"),
     lossReason: defField("lossReason"),
     isProcessing: defField("check", { label: "加入手続き中", default: false }),
+    isRetire: defField("check", { label: "退職", default: false }),
     history: defField("array"), // 状態遷移の履歴を記録するための配列
   };
 
@@ -208,6 +210,7 @@ export default class Insurance extends BaseClass {
     this.number = null;
     this.lossDateAt = null; // 念のため null に更新しておく
     this.lossReason = null; // 念のため null に更新しておく
+    this.isRetire = false; // 念のため false に更新しておく
   }
 
   /**
@@ -252,6 +255,7 @@ export default class Insurance extends BaseClass {
     this.isProcessing = !!isProcessing;
     this.lossDateAt = null; // 念のため null に更新しておく
     this.lossReason = null; // 念のため null に更新しておく
+    this.isRetire = false; // 念のため false に更新しておく
   }
 
   /**
@@ -282,6 +286,7 @@ export default class Insurance extends BaseClass {
     this.isProcessing = false;
     this.lossDateAt = null; // 念のため null に更新しておく
     this.lossReason = null; // 念のため null に更新しておく
+    this.isRetire = false; // 念のため false に更新しておく
   }
 
   /**
@@ -305,6 +310,7 @@ export default class Insurance extends BaseClass {
     this.isProcessing = false;
     this.lossDateAt = null; // 念のため null に更新しておく
     this.lossReason = null; // 念のため null に更新しておく
+    this.isRetire = false; // 念のため false に更新しておく
   }
 
   /**
@@ -323,7 +329,7 @@ export default class Insurance extends BaseClass {
    * @throws {Error} 喪失日が日付オブジェクトでない場合にエラーをスローします。
    * @throws {Error} 喪失理由が指定されていない場合にエラーをスローします。
    */
-  loss({ lossDateAt, lossReason } = {}, isRetire = false) {
+  loss({ lossDateAt, lossReason, isRetire = false } = {}) {
     // validation
     if (!this.isEnrolled()) {
       throw new Error(ERROR_MESSAGES.ENROLLED_ONLY("喪失手続き"));
@@ -348,6 +354,7 @@ export default class Insurance extends BaseClass {
     this.number = null;
     this.lossDateAt = null; // 念のため null に更新しておく
     this.lossReason = null; // 念のため null に更新しておく
+    this.isRetire = false; // 念のため false に更新しておく
   }
 
   /**
@@ -376,5 +383,6 @@ export default class Insurance extends BaseClass {
     this.isProcessing = false; // 念のため false に戻しておく
     this.lossDateAt = null; // 念のため null に戻しておく
     this.lossReason = null; // 念のため null に戻しておく
+    this.isRetire = false; // 念のため false に戻しておく
   }
 }

package/src/OperationResult.js

@@ -147,6 +147,7 @@ import AgreementV2 from "./AgreementV2.js";
 import { ContextualError } from "./utils/ContextualError.js";
 import OperationResultDetail from "./OperationResultDetail.js";
 import { defField } from "./parts/fieldDefinitions.js";
+import { formatJstDate } from "./utils/index.js";
 import Tax from "./Tax.js";
 import { VALUES as BILLING_UNIT_TYPE } from "./constants/billing-unit-type.js";
 import RoundSetting from "./RoundSetting.js";
@@ -452,16 +453,7 @@ export default class OperationResult extends Operation {
         configurable: true,
         enumerable: true,
         get() {
-          if (!this.billingDateAt) return null;
-          const jstDate = new Date(
-            this.billingDateAt.getTime() + 9 * 60 * 60 * 1000,
-          ); /* JST補正 */
-          const year = jstDate.getUTCFullYear();
-          const month = jstDate.getUTCMonth() + 1;
-          const day = jstDate.getUTCDate();
-          return `${year}-${String(month).padStart(2, "0")}-${String(
-            day,
-          ).padStart(2, "0")}`;
+          return formatJstDate(this.billingDateAt);
         },
         set(v) {},
       },
@@ -469,13 +461,7 @@ export default class OperationResult extends Operation {
         configurable: true,
         enumerable: true,
         get() {
-          if (!this.billingDateAt) return null;
-          const jstDate = new Date(
-            this.billingDateAt.getTime() + 9 * 60 * 60 * 1000,
-          ); /* JST補正 */
-          const year = jstDate.getUTCFullYear();
-          const month = jstDate.getUTCMonth() + 1;
-          return `${year}-${String(month).padStart(2, "0")}`;
+          return formatJstDate(this.billingDateAt, "YYYY-MM");
         },
         set(v) {},
       },

package/src/SiteOperationSchedule.js

@@ -116,7 +116,7 @@
  *****************************************************************************/
 import Operation from "./Operation.js";
 import { defField } from "./parts/fieldDefinitions.js";
-import { ContextualError } from "./utils/index.js";
+import { ContextualError, formatJstDate } from "./utils/index.js";
 import ArrangementNotification from "./ArrangementNotification.js";
 import SiteOperationScheduleDetail from "./SiteOperationScheduleDetail.js";
 import OperationResult from "./OperationResult.js";
@@ -499,11 +499,7 @@ export default class SiteOperationSchedule extends Operation {
       const targetDates = dates
         .map((date) => {
           if (date instanceof Date) {
-            const jstDate = new Date(date.getTime() + 9 * 60 * 60 * 1000);
-            const year = jstDate.getUTCFullYear();
-            const month = String(jstDate.getUTCMonth() + 1).padStart(2, "0");
-            const day = String(jstDate.getUTCDate()).padStart(2, "0");
-            return `${year}-${month}-${day}`;
+            return formatJstDate(date);
           }
           return date;
         })

package/src/WorkTimeBase.js

@@ -53,7 +53,7 @@
  *****************************************************************************/
 import FireModel from "@shisyamo4131/air-firebase-v2";
 import { defField } from "./parts/fieldDefinitions.js";
-import { getDateAt } from "./utils/index.js";
+import { getDateAt, formatJstDate } from "./utils/index.js";
 import { VALUES as SHIFT_TYPE } from "./constants/shift-type.js";
 
 const classProps = {
@@ -129,13 +129,7 @@ export default class WorkTimeBase extends FireModel {
         configurable: true,
         enumerable: true,
         get() {
-          if (!this.dateAt) return "";
-          // UTC時刻に9時間(JST)を加算してJST日付を取得
-          const jstDate = new Date(this.dateAt.getTime() + 9 * 60 * 60 * 1000);
-          const year = jstDate.getUTCFullYear();
-          const month = String(jstDate.getUTCMonth() + 1).padStart(2, "0");
-          const day = String(jstDate.getUTCDate()).padStart(2, "0");
-          return `${year}-${month}-${day}`;
+          return formatJstDate(this.dateAt) || "";
         },
         set(v) {},
       },

package/src/parts/fieldDefinitions/array.js

@@ -0,0 +1,8 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+
+/**
+ * ARRAY型のフィールド定義
+ */
+export const arrayFields = {
+  array: generalDefinitions.array,
+};

package/src/parts/fieldDefinitions/check.js

@@ -0,0 +1,20 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+
+/**
+ * CHECK型のフィールド定義
+ */
+export const checkFields = {
+  check: generalDefinitions.check,
+  hasPeriodOfStayLimit: {
+    ...generalDefinitions.check,
+    label: "在留期間制限",
+  },
+  hasWorkRestrictions: {
+    ...generalDefinitions.check,
+    label: "就労制限",
+  },
+  isForeigner: {
+    ...generalDefinitions.check,
+    label: "外国籍",
+  },
+};

package/src/parts/fieldDefinitions/code.js

@@ -0,0 +1,8 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+
+/**
+ * CODE型のフィールド定義
+ */
+export const codeFields = {
+  code: generalDefinitions.code,
+};

package/src/parts/fieldDefinitions/constants.js

@@ -0,0 +1,9 @@
+/**
+ * フィールド定義で使用する定数
+ */
+
+export const DEFAULT_WORKING_MINUTES = 480;
+export const DEFAULT_BREAK_MINUTES = 60;
+export const MINUTES_PER_HOUR = 60;
+export const MINUTES_PER_QUARTER_HOUR = 15;
+export const MAX_SCHEDULED_WORKING_MINUTES = 480; // 8時間 * 60分

package/src/parts/fieldDefinitions/dateAt.js

@@ -0,0 +1,58 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+
+/**
+ * DATE AT型のフィールド定義
+ */
+export const dateAtFields = {
+  dateAt: generalDefinitions.dateAt,
+  dateOfBirth: {
+    ...generalDefinitions.dateAt,
+    label: "生年月日",
+    default: null, // 2025-12-26 Set default to null
+    component: {
+      ...generalDefinitions.dateAt.component,
+      attrs: {
+        viewMode: "year", // 2025-12-26 Added
+      },
+    },
+  },
+  dateOfHire: {
+    ...generalDefinitions.dateAt,
+    label: "入社日",
+  },
+  // 2025-12-26 Added
+  dateOfSecurityGuardRegistration: {
+    ...generalDefinitions.dateAt,
+    label: "警備員登録日",
+    default: null,
+  },
+  dateOfTermination: {
+    ...generalDefinitions.dateAt,
+    label: "退職日",
+    default: null, // 2025-12-26 Set default to null
+  },
+  enrollmentDateAt: {
+    ...generalDefinitions.dateAt,
+    label: "資格取得日",
+    default: null,
+  },
+  // 2025-12-26 Added
+  expirationDateAt: {
+    ...generalDefinitions.dateAt,
+    label: "有効期限",
+    default: null,
+  },
+  issueDateAt: {
+    ...generalDefinitions.dateAt,
+    label: "取得日",
+  },
+  lossDateAt: {
+    ...generalDefinitions.dateAt,
+    label: "資格喪失日",
+    default: null,
+  },
+  periodOfStay: {
+    ...generalDefinitions.dateAt,
+    label: "在留期間満了日",
+  },
+};

package/src/parts/fieldDefinitions/dateTimeAt.js

@@ -0,0 +1,8 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+
+/**
+ * DATE TIME AT型のフィールド定義
+ */
+export const dateTimeAtFields = {
+  dateTimeAt: generalDefinitions.dateTimeAt,
+};

package/src/parts/fieldDefinitions/defaultDefinition.js

@@ -0,0 +1,118 @@
+/**
+ * フィールド定義のデフォルト値
+ * - `air-firebase` が提供する `FireModel (BaseClass)` において、クラスが保有するフィールドの定義および値の検証に使用されます。
+ * - `component` プロパティは `air-vuetify` の入力コンポーネント生成の為の属性として使用されます。
+ *   但し、required, label, hidden, length は入力コンポーネントの属性としても使用されます。
+ * - `validator` の返り値は原則オブジェクトです。文字列を返すこともでき、その文字列がエラーメッセージとして扱われますが多言語対応のためには
+ *   オブジェクトを返すことを推奨します。
+ *   返り値が true/false の場合は、従来通りのバリデーション結果として扱われます。
+ * @key {String|Number|Boolean|Object|Array|Date} type - データの型
+ * @key {any} default - 既定値
+ * @key {String} label - フィールドのラベル
+ * @key {Number} length - 入力可能な最大文字数（文字列型の場合）
+ * @key {Boolean} required - 入力必須かどうか
+ * @key {Boolean} hidden - フィールドをUI上で非表示にするかどうか
+ * @key {Function} validator - フィールドの値を検証する関数。引数に値を取り、エラーメッセージを返すか、true/falseで検証結果を返す。
+ * @key {Object} component - フィールドに対応するUIコンポーネントの定義
+ * @key {String} component.name - 使用するコンポーネントの名前（AirVuetifyコンポーネントのみ指定可能）
+ * @key {Object} component.attrs - コンポーネントに渡す属性の定義
+ */
+export const defaultDefinition = {
+  type: String,
+  default: null,
+  label: undefined,
+  length: undefined,
+  required: undefined,
+  hidden: undefined,
+  validator: undefined,
+  component: {
+    name: undefined,
+    attrs: {},
+  },
+};
+
+/** 汎用パーツ */
+export const generalDefinitions = {
+  array: {
+    ...defaultDefinition,
+    type: Array,
+    default: () => [],
+    component: { name: "air-select", attrs: { multiple: true } },
+  },
+  check: {
+    ...defaultDefinition,
+    type: Boolean,
+    default: false,
+    component: { name: "air-checkbox", attrs: {} },
+  },
+  code: {
+    ...defaultDefinition,
+    length: 10,
+    component: { name: "air-text-field", attrs: { inputType: "alphanumeric" } },
+  },
+  // 日付（00時固定としたDateオブジェクトとして使用する）
+  dateAt: {
+    ...defaultDefinition,
+    type: Object,
+    label: "日付",
+    default: () => {
+      const date = new Date();
+      date.setHours(0, 0, 0, 0);
+      return date;
+    },
+    component: {
+      name: "air-date-input",
+    },
+  },
+  // 日時（時刻までを含んだDateオブジェクト）
+  dateTimeAt: {
+    ...defaultDefinition,
+    type: Object,
+    label: "日時",
+    default: null,
+    component: { name: "air-date-time-picker-input", attrs: {} },
+  },
+  multipleLine: {
+    ...defaultDefinition,
+    length: 200,
+    component: {
+      name: "air-textarea",
+      attrs: { counter: true, maxlength: 200 },
+    },
+  },
+  number: {
+    ...defaultDefinition,
+    type: Number,
+    component: {
+      name: "air-number-input",
+      attrs: {
+        controlVariant: "split",
+      },
+    },
+  },
+  object: {
+    ...defaultDefinition,
+    type: Object,
+    component: { name: "air-select" }, // `AirTextField` that is used as default ui component could not handle object type.
+  },
+  oneLine: {
+    ...defaultDefinition,
+    component: { name: "air-text-field", attrs: {} },
+  },
+  radio: {
+    ...defaultDefinition,
+    component: { name: "air-radio-group", attrs: {} },
+  },
+  select: {
+    ...defaultDefinition,
+    component: { name: "air-select", attrs: {} },
+  },
+  // 時刻文字列
+  time: {
+    ...defaultDefinition,
+    label: "時刻",
+    component: {
+      name: "air-time-picker-input",
+    },
+  },
+};

package/src/parts/fieldDefinitions/multipleLine.js

@@ -0,0 +1,12 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+
+/**
+ * MULTIPLE LINE型のフィールド定義
+ */
+export const multipleLineFields = {
+  multipleLine: generalDefinitions.multipleLine,
+  remarks: {
+    ...generalDefinitions.multipleLine,
+    label: "備考",
+  },
+};

package/src/parts/fieldDefinitions/number.js

@@ -0,0 +1,69 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+import { DEFAULT_BREAK_MINUTES, DEFAULT_WORKING_MINUTES } from "./constants.js";
+import { VALIDATION_ERRORS } from "../../errorDefinitions.js";
+
+/**
+ * NUMBER型のフィールド定義
+ */
+export const numberFields = {
+  number: generalDefinitions.number,
+  breakMinutes: {
+    ...generalDefinitions.number,
+    label: "休憩時間（分）",
+    default: DEFAULT_BREAK_MINUTES,
+    validator: (v) => {
+      if (v < 0) {
+        return VALIDATION_ERRORS.MIN_VALUE_ERROR(0);
+      }
+      return true;
+    },
+    component: {
+      ...generalDefinitions.number.component,
+      attrs: {
+        ...generalDefinitions.number.component.attrs,
+        min: 0,
+      },
+    },
+  },
+  overtimeWorkMinutes: {
+    ...generalDefinitions.number,
+    label: "残業時間（分）",
+    default: 0,
+    validator: (v) => {
+      if (v < 0) {
+        return VALIDATION_ERRORS.MIN_VALUE_ERROR(0);
+      }
+      return true;
+    },
+    component: {
+      ...generalDefinitions.number.component,
+      attrs: {
+        ...generalDefinitions.number.component.attrs,
+        min: 0,
+      },
+    },
+  },
+  regulationWorkMinutes: {
+    ...generalDefinitions.number,
+    label: "規定実働時間（分）",
+    default: DEFAULT_WORKING_MINUTES,
+    validator: (v) => {
+      if (v < 0) {
+        return VALIDATION_ERRORS.MIN_VALUE_ERROR(0);
+      }
+      return true;
+    },
+    component: {
+      ...generalDefinitions.number.component,
+      attrs: {
+        ...generalDefinitions.number.component.attrs,
+        min: 0,
+        persistentHint: true,
+        hint: "この時間を超えると残業扱いになります。",
+      },
+    },
+  },
+  price: {
+    ...generalDefinitions.number,
+  },
+};

package/src/parts/fieldDefinitions/object.js

@@ -0,0 +1,30 @@
+import { generalDefinitions } from "./defaultDefinition.js";
+
+/**
+ * OBJECT型のフィールド定義
+ */
+export const objectFields = {
+  object: generalDefinitions.object,
+  customer: {
+    ...generalDefinitions.object,
+    label: "取引先",
+    component: {
+      name: "air-autocomplete-api",
+      attrs: {
+        cacheItems: true,
+        clearable: true,
+        itemTitle: "name",
+        itemValue: "docId",
+        returnObject: true,
+      },
+    },
+  },
+  employmentInsurance: {
+    ...generalDefinitions.object,
+    label: "雇用保険",
+  },
+  location: {
+    ...generalDefinitions.object,
+    hidden: true,
+  },
+};