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

package/src/WorkingResult.js

@@ -1,142 +1,92 @@
 /*****************************************************************************
- * WorkingResult ver 1.0.0
+ * @file ./src/WorkingResult.js
  * @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.
- * ---------------------------------------------------------------------------
- * @property {Date} dateAt - Applicable start date (trigger property)
+ * @description 勤務実績クラス
+ * - 勤務実績を表す抽象クラスです。インスタンス化はできません。
  *
- * @property {string} dayType - Day type (e.g., `WEEKDAY`, `WEEKEND`, `HOLIDAY`)
+ * @class
+ * @extends WorkTimeBase
+ * @abstract
+ * @see Operation
+ * @see OperationDetail
  *
- * @property {string} shiftType - Shift type (`DAY`, `NIGHT`)
+ * @property {Date} dateAt - 日付 (変更されると `dayType` が自動的に更新されます)
+ * @property {string} shiftType - 勤務区分
+ * @property {string} startTime - 開始時刻 (HH:MM 形式)
+ * @property {string} endTime - 終了時刻 (HH:MM 形式)
+ * @property {boolean} isStartNextDay - 翌日開始フラグ
+ * - `true` の場合、実際の勤務は `dateAt` の翌日であることを意味します。
+ * @property {number} breakMinutes - 休憩時間 (分)
+ * @property {string} date - `dateAt` に基づく YYYY-MM-DD 形式の日付文字列 (読み取り専用)
+ * - `dateAt` に基づいて YYYY-MM-DD 形式の文字列を返します。
+ * @property {Date} startAt - 開始日時 (Date オブジェクト) (読み取り専用)
+ * - `dateAt` に基づいて `startTime` を設定した Date オブジェクトを返します。
+ * - `isStartNextDay` が true の場合、1日加算します。
+ * @property {Date} endAt - 終了日時 (Date オブジェクト) (読み取り専用)
+ * - `startAt` を起点に、最初に現れる `endTime` の Date オブジェクトを返します。
+ * @property {boolean} isSpansNextDay - 翌日跨ぎフラグ (読み取り専用)
+ * - `true` の場合、`startAt` と `endAt` の日付が異なることを意味します。
+ * @property {number} regulationWorkMinutes - 規定労働時間 (分)
+ * - `startAt` から `endAt` までの時間から `breakMinutes` を差し引いた時間のうち、
+ *   規定内として扱う労働時間（分）です。
+ * - 実際の労働時間から残業時間を算出するための基準となる値です。
+ * - この値があることで、取極めに柔軟な設定を行うことが可能になる他、労働基準法の 1 日の所定労働時間上限が変更された際に
+ *   影響を最小限に抑えることができます。
+ * 例) 8:00 から 17:00 までの勤務で休憩が 60 分の場合
+ * - 規定労働時間を 8 時間 (480 分) とし、実際の勤務が 8 時間 (480 分) を超えた分が残業時間として扱われます。
+ * 例) 8:00 から 16:00 までの勤務で休憩が 60 分の場合
+ * - 規定労働時間を 7 時間 (420 分) とすると、実際の勤務が 7 時間 (420 分) を超えた分が残業時間として扱われます。
+ * - 規定労働時間を 8 時間 (480 分) とすると、実際の勤務が 8 時間 (480 分) を超えた分が残業時間として扱われます。
+ * 例) 7:00 から 翌日 7:00 までの勤務で休憩が 60 分の場合
+ * - 規定労働時間を 8 時間 (480 分) とすると、実際の勤務が 8 時間 (480 分) を超えた分が残業時間として扱われます。
+ *   この場合、最初の 8 時間までは基本単価が適用され、残りの 8 時間は残業単価が適用されるといった設定が可能になります。
+ * - 規定労働時間を 24 時間 (1440 分) とすると、実際の勤務が 24 時間 (1440 分) を超えた分が残業時間として扱われます。
+ *   この場合、全ての勤務時間が基本単価で扱われるといった設定が可能になります。
+ * @property {string} dayType - 曜日区分
+ * @property {number} totalWorkMinutes - 総労働時間 (休憩時間を除く) (分) (読み取り専用)
+ * @property {number} regularTimeWorkMinutes - 所定労働時間 (分) (読み取り専用)
+ * @property {number} overtimeWorkMinutes - 残業時間 (分) (読み取り専用)
  *
- * @property {string} startTime - Start time (HH:MM format)
+ * @method setDateAtCallback - `dateAt` が設定されたときに呼び出されるコールバック関数
  *
- * @property {boolean} isStartNextDay - Next day start flag
- * - `true` if the actual work starts the day after the placement date `dateAt`
+ * @getter {boolean} isInvalid - クラス特有のエラーが存在するかどうかを返すプロパティ
+ * @getter {Array<Object>} invalidReasons - エラーコード、メッセージ、多言語メッセージ、フィールド名を含む詳細情報の配列を返すプロパティ
  *
- * @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.
- *
- * @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`.
- *
- * @property {boolean} isSpansNextDay - Flag indicating whether the date spans from start date to end date (read-only)
- * - `true` if `startTime` is later than `endTime`
- *
- * @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.
- *
- * @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.
- *
- * @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.
- *
- * @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`.
- *
- * @property {number} overtimeWorkMinutes - Overtime work in minutes (read-only)
- * - Calculated as `totalWorkMinutes` minus `regulationWorkMinutes`
- * - Overtime work is not negative; the minimum is 0.
- * ---------------------------------------------------------------------------
- * @getter {number} startHour - Start hour (0-23) (read-only)
- * - Extracted from `startTime`.
- * @getter {number} startMinute - Start minute (0-59) (read-only)
- * - Extracted from `startTime`.
- * @getter {number} endHour - End hour (0-23) (read-only)
- * - Extracted from `endTime`.
- * @getter {number} endMinute - End minute (0-59) (read-only)
- * - Extracted from `endTime`.
- * @getter {boolean} isKeyChanged - Flag indicating whether the key has changed compared to previous data (read-only)
- * - Compares the current `key` with the `key` in `_beforeData`.
- * ---------------------------------------------------------------------------
- * @method {function} setDateAtCallback - Callback method called when `dateAt` is set
- * - Override this method in subclasses to add custom behavior when `dateAt` changes.
- * - By default, updates `dayType` based on the new `dateAt` value.
- * - @param {Date} v - The new `dateAt` value
+ * @static SHIFT_TYPE - 勤務区分を定義する定数オブジェクト
+ * @static INVALID_REASON - クラス特有のエラーコードを定義する定数オブジェクト
+ * - `BREAK_MINUTES_NEGATIVE`: `breakMinutes` が負の値である場合のエラーコード
+ * - `REGULATION_WORK_MINUTES_NEGATIVE`: `regulationWorkMinutes` が負の値である場合のエラーコード
+ * @static DAY_TYPE - 曜日区分を定義する定数オブジェクト
  *****************************************************************************/
-import FireModel from "@shisyamo4131/air-firebase-v2";
 import { defField } from "./parts/fieldDefinitions.js";
-import { getDateAt } from "./utils/index.js";
 import { getDayType } from "./constants/day-type.js";
 import { VALUES as DAY_TYPE } from "./constants/day-type.js";
-import { VALUES as SHIFT_TYPE } from "./constants/shift-type.js";
+import WorkTimeBase from "./WorkTimeBase.js";
 
 const classProps = {
-  dateAt: defField("dateAt", { required: true }),
+  ...WorkTimeBase.classProps,
   dayType: defField("dayType", { required: true }),
-  shiftType: defField("shiftType", { required: true }),
-  startTime: defField("time", {
-    label: "開始時刻",
-    required: true,
-    default: "08:00",
-  }),
-  isStartNextDay: defField("check", { label: "翌日開始" }),
-  endTime: defField("time", {
-    label: "終了時刻",
-    required: true,
-    default: "17:00",
-  }),
-  breakMinutes: defField("breakMinutes", { required: true }),
-  regulationWorkMinutes: defField("regulationWorkMinutes", { required: true }),
 };
 
-/**
- * Wrapper to define computed properties.
- * @param {*} obj
- * @param {*} properties
- */
-function defineComputedProperties(obj, properties) {
-  const descriptors = {};
-  for (const [key, descriptor] of Object.entries(properties)) {
-    descriptors[key] = {
-      configurable: true,
-      enumerable: true,
-      ...descriptor,
-    };
-  }
-  Object.defineProperties(obj, descriptors);
-}
-
-export default class WorkingResult extends FireModel {
+/*****************************************************************************
+ * WorkingResult
+ *****************************************************************************/
+export default class WorkingResult extends WorkTimeBase {
   static className = "WorkingResult";
   static collectionPath = "WorkingResults";
-  static useAutonumber = false;
-  static logicalDelete = false;
   static classProps = classProps;
 
   static DAY_TYPE = DAY_TYPE;
-  static SHIFT_TYPE = SHIFT_TYPE;
 
   /**
    * Constructor
-   * - Prevent direct instantiation of WorkingResult class.
-   * @param {*} item
+   * - 抽象クラスのため、直接のインスタンス化を防止します。
+   * @param {Object} item - 初期化オブジェクト
    */
   constructor(item = {}) {
     if (new.target === WorkingResult) {
       throw new Error(
-        "WorkingResult is an abstract class and cannot be instantiated directly."
+        "WorkingResult is an abstract class and cannot be instantiated directly.",
       );
     }
     super(item);
@@ -144,104 +94,18 @@ export default class WorkingResult extends FireModel {
 
   /**
    * afterInitialize
-   * @param {*} item
+   * @param {Object} item - 初期化オブジェクト
    */
   afterInitialize(item = {}) {
     super.afterInitialize(item);
 
-    /** Define triggers */
-    let _dateAt = this.dateAt;
-    defineComputedProperties(this, {
-      /**
-       * dateAt - Convert `dateAt` property to use getter/setter
-       * - When `dateAt` is set, call `setDateAtCallback` to update dependent properties.
-       */
-      dateAt: {
-        get() {
-          return _dateAt;
-        },
-        set(v) {
-          if (_dateAt && v.getTime() === _dateAt.getTime()) {
-            return;
-          }
-          const newDate = new Date(v);
-          newDate.setHours(0, 0, 0, 0); // 時刻部分をクリア
-          _dateAt = newDate;
-          this.setDateAtCallback(newDate);
-        },
-      },
-    });
-
-    /** Define computed properties */
-    defineComputedProperties(this, {
-      /**
-       * key - Unique key combining date, dayType, and shiftType
-       * - A unique identifier for the working result, combining `date`, `dayType`, and `shiftType`.
-       */
-      key: {
-        get: () => {
-          return `${this.date}-${this.dayType}-${this.shiftType}`;
-        },
-        set: () => {},
-      },
-      /**
-       * date - Date string in YYYY-MM-DD format based on `dateAt`
-       * - Returns a string in the format YYYY-MM-DD based on `dateAt`.
-       * - If `dateAt` is not set, returns an empty string.
-       */
-      date: {
-        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}`;
-        },
-        set: (v) => {},
-      },
+    Object.defineProperties(this, {
       /**
-       * isSpansNextDay - Flag indicating whether the date spans from start date to end date
-       * - `true` if `startTime` is later than `endTime`
-       */
-      isSpansNextDay: {
-        get: () => this.startTime > this.endTime,
-        set: (v) => {},
-      },
-      /**
-       * startAt - Start date and time (Date object)
-       * - Returns a Date object with `startTime` set based on `dateAt`.
-       * - If `isStartNextDay` is true, add 1 day.
-       */
-      startAt: {
-        get() {
-          const dateOffset = this.isStartNextDay ? 1 : 0;
-          return getDateAt(this.dateAt, this.startTime, dateOffset);
-        },
-        set(v) {},
-      },
-      /**
-       * endAt - End date and time (Date object)
-       * - Returns a Date object with `endTime` set based on `dateAt`.
-       * - If `isStartNextDay` is true, add 1 day.
-       * - If `isSpansNextDay` is true, add 1 day.
-       */
-      endAt: {
-        get() {
-          const dateOffset =
-            (this.isSpansNextDay ? 1 : 0) + (this.isStartNextDay ? 1 : 0);
-          return getDateAt(this.dateAt, this.endTime, dateOffset);
-        },
-        set(v) {},
-      },
-      /**
-       * totalWorkMinutes - Total working time in minutes (excluding break time)
-       * - 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.
+       * `startAt`, `endAt`, `breakMinutes` から総労働時間を計算して返します。
        */
       totalWorkMinutes: {
+        configurable: true,
+        enumerable: true,
         get: () => {
           const start = this.startAt;
           const end = this.endAt;
@@ -251,24 +115,29 @@ export default class WorkingResult extends FireModel {
         },
         set: (v) => {},
       },
+
       /**
-       * regularTimeWorkMinutes - Regular working time in minutes
-       * - 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`.
+       * 所定労働時間を返します。
+       * - `totalWorkMinutes` のうち `regulationWorkMinutes` の範囲である部分を返します。
+       * - 実際の労働時間が所定労働時間未満の場合（早退など）は `totalWorkMinutes` と同じ値になります。
+       * - 実際の労働時間が所定労働時間を超える場合（残業など）は `regulationWorkMinutes` と同じ値になります。
        */
       regularTimeWorkMinutes: {
+        configurable: true,
+        enumerable: true,
         get: () => {
           return Math.min(this.totalWorkMinutes, this.regulationWorkMinutes);
         },
         set: (v) => {},
       },
       /**
-       * overtimeWorkMinutes - Overtime working time in minutes
-       * - The value obtained by subtracting `regulationWorkMinutes` from `totalWorkMinutes`.
-       * - Overtime working time is capped at 0 to prevent negative values.
+       * 残業時間を返します。
+       * - `totalWorkMinutes` から `regulationWorkMinutes` を引いた値を返します。
+       * - 残業時間は負の値にならないように、最小値は 0 になります。
        */
       overtimeWorkMinutes: {
+        configurable: true,
+        enumerable: true,
         get: () => {
           const diff = this.totalWorkMinutes - this.regulationWorkMinutes;
           return Math.max(0, diff);
@@ -279,54 +148,13 @@ export default class WorkingResult extends FireModel {
   }
 
   /**
-   * A function called when `dateAt` is set.
-   * - Override this method in subclasses to add custom behavior when `dateAt` changes.
-   * @param {*} v
+   * `WorkTimeBase` クラスの `setDateAtCallback` をオーバライドします。
+   * - `dayType` を更新します。
+   * @param {Date} v - 新しい `dateAt` 値
+   * @returns {void}
    */
   setDateAtCallback(v) {
+    super.setDateAtCallback(v);
     this.dayType = getDayType(v);
   }
-
-  /**
-   * Returns the start hour extracted from `startTime`.
-   * - Returns 0 if `startTime` is not set.
-   */
-  get startHour() {
-    return this.startTime ? Number(this.startTime.split(":")[0]) : 0;
-  }
-
-  /**
-   * Returns the start minute extracted from `startTime`.
-   * - Returns 0 if `startTime` is not set.
-   */
-  get startMinute() {
-    return this.startTime ? Number(this.startTime.split(":")[1]) : 0;
-  }
-
-  /**
-   * Returns the end hour extracted from `endTime`.
-   * - Returns 0 if `endTime` is not set.
-   */
-  get endHour() {
-    return this.endTime ? Number(this.endTime.split(":")[0]) : 0;
-  }
-
-  /**
-   * Returns the end minute extracted from `endTime`.
-   * - Returns 0 if `endTime` is not set.
-   */
-  get endMinute() {
-    return this.endTime ? Number(this.endTime.split(":")[1]) : 0;
-  }
-
-  /**
-   * Returns whether the key has changed compared to the previous data.
-   * - Compares the current `key` with the `key` in `_beforeData`.
-   * - Returns `true` if they are different, otherwise `false`.
-   */
-  get isKeyChanged() {
-    const current = this.key;
-    const before = this._beforeData?.key;
-    return current !== before;
-  }
 }

package/src/constants/day-type.js

@@ -1,11 +1,19 @@
-// prettier-ignore
+/*****************************************************************************
+ * @file ./constants/day-type.js
+ * @description 曜日区分定義
+ * @author shisyamo4131
+ *
+ * @export {Object} VALUES - 曜日区分の定数オブジェクト
+ * @export {Array} OPTIONS - 曜日区分の選択肢配列
+ * @export {Function} getDayType - 日付から曜日区分を取得する関数
+ *****************************************************************************/
 import holiday_jp from "@holiday-jp/holiday_jp";
 
 export const VALUES = Object.freeze({
-  WEEKDAY: { value: "WEEKDAY", title: "平日" },
-  SATURDAY: { value: "SATURDAY", title: "土曜" },
-  SUNDAY: { value: "SUNDAY", title: "日曜" },
-  HOLIDAY: { value: "HOLIDAY", title: "祝日" },
+  WEEKDAY: { value: "WEEKDAY", title: "平日", order: 0 },
+  SATURDAY: { value: "SATURDAY", title: "土曜", order: 1 },
+  SUNDAY: { value: "SUNDAY", title: "日曜", order: 2 },
+  HOLIDAY: { value: "HOLIDAY", title: "祝日", order: 3 },
 });
 
 export const OPTIONS = [
@@ -16,14 +24,14 @@ export const OPTIONS = [
 ];
 
 /**
- * Returns the corresponding day type based on the given date's day of the week.
- * If the date is a holiday, it returns "HOLIDAY".
- * If the date is a Sunday, it returns "SUNDAY".
- * If the date is a Saturday, it returns "SATURDAY".
- * Otherwise, it returns "WEEKDAY".
+ * 引数で与えられた日付の曜日に基づいて、対応する曜日区分を返します。
+ * - 日付が祝日であれば、「HOLIDAY」を返します。
+ * - 日付が日曜日であれば、「SUNDAY」を返します。
+ * - 日付が土曜日であれば、「SATURDAY」を返します。
+ * - それ以外の場合は、「WEEKDAY」を返します。
  * @param {Date} date
- * @returns {string} - The day type corresponding to the date.
- * @throws {TypeError} if date is not a Date object
+ * @returns {string} - 引数の日付に対応する曜日区分
+ * @throws {TypeError} - 引数がDateオブジェクトでない場合
  */
 export const getDayType = (date) => {
   if (!(date instanceof Date)) {

package/src/constants/index.js

@@ -45,6 +45,10 @@ export {
   VALUES as GENDER_VALUES,
   OPTIONS as GENDER_OPTIONS,
 } from "./gender.js";
+export {
+  VALUES as INSURANCE_STATUS_VALUES,
+  OPTIONS as INSURANCE_STATUS_OPTIONS,
+} from "./insurance-status.js";
 export {
   VALUES as PAYMENT_MONTH_VALUES,
   OPTIONS as PAYMENT_MONTH_OPTIONS,

package/src/constants/insurance-status.js

@@ -0,0 +1,15 @@
+/*****************************************************************************
+ * @file ./src/constants/insurance-status.js
+ * @description 保険状態定義
+ *****************************************************************************/
+export const VALUES = Object.freeze({
+  NOT_ENROLLED: { value: "NOT_ENROLLED", title: "未加入" },
+  ENROLLED: { value: "ENROLLED", title: "加入" },
+  EXEMPT: { value: "EXEMPT", title: "適用除外" },
+});
+
+export const OPTIONS = [
+  { title: VALUES.NOT_ENROLLED.title, value: VALUES.NOT_ENROLLED.value },
+  { title: VALUES.ENROLLED.title, value: VALUES.ENROLLED.value },
+  { title: VALUES.EXEMPT.title, value: VALUES.EXEMPT.value },
+];

package/src/constants/shift-type.js

@@ -1,7 +1,10 @@
+/*****************************************************************************
+ * 勤務区分定数定義
+ *****************************************************************************/
 // prettier-ignore
 export const VALUES = Object.freeze({
-  DAY: { value: "DAY", title: "日勤", color: "deep-orange" },
-  NIGHT: { value: "NIGHT", title: "夜勤", color: "indigo" },
+  DAY: { value: "DAY", title: "日勤", color: "deep-orange", order: 0 },
+  NIGHT: { value: "NIGHT", title: "夜勤", color: "indigo", order: 1 },
 });
 
 export const OPTIONS = [

package/src/errorDefinitions.js

@@ -0,0 +1,173 @@
+/**
+ * バリデーションエラー定義
+ * - validator がオブジェクト形式でエラーを返す際に使用します。
+ * - 各エラーは関数として定義され、動的なパラメータを受け取ります。
+ *
+ * 返却値の形式:
+ * {
+ *   code: 'ERROR_CODE',           // エラーコード
+ *   message: 'English message',    // 英語メッセージ（デフォルト言語）
+ *   messages: {                    // その他の言語のメッセージ
+ *     ja: '日本語メッセージ'
+ *   }
+ * }
+ *
+ * 使用例:
+ * ```javascript
+ * import { VALIDATION_ERRORS } from './errorDefinitions.js';
+ *
+ * validator: (v) => {
+ *   const minValue = 0;
+ *   if (v < minValue) {
+ *     return VALIDATION_ERRORS.MIN_VALUE_ERROR(minValue);
+ *   }
+ *   return true;
+ * }
+ * ```
+ */
+
+export const VALIDATION_ERRORS = {
+  /**
+   * 最小値エラー
+   * @param {number} minValue - 最小値
+   * @returns {Object} エラーオブジェクト
+   */
+  MIN_VALUE_ERROR: (minValue) => ({
+    code: "MIN_VALUE_ERROR",
+    message: `Please enter a value of ${minValue} or more.`,
+    messages: {
+      ja: `${minValue}以上の値を入力してください。`,
+    },
+  }),
+
+  /**
+   * 最大値エラー
+   * @param {number} maxValue - 最大値
+   * @returns {Object} エラーオブジェクト
+   */
+  MAX_VALUE_ERROR: (maxValue) => ({
+    code: "MAX_VALUE_ERROR",
+    message: `Please enter a value of ${maxValue} or less.`,
+    messages: {
+      ja: `${maxValue}以下の値を入力してください。`,
+    },
+  }),
+
+  /**
+   * 範囲エラー
+   * @param {number} minValue - 最小値
+   * @param {number} maxValue - 最大値
+   * @returns {Object} エラーオブジェクト
+   */
+  RANGE_ERROR: (minValue, maxValue) => ({
+    code: "RANGE_ERROR",
+    message: `Please enter a value between ${minValue} and ${maxValue}.`,
+    messages: {
+      ja: `${minValue}以上${maxValue}以下の値を入力してください。`,
+    },
+  }),
+
+  /**
+   * 最小文字数エラー
+   * @param {number} minLength - 最小文字数
+   * @returns {Object} エラーオブジェクト
+   */
+  MIN_LENGTH_ERROR: (minLength) => ({
+    code: "MIN_LENGTH_ERROR",
+    message: `Please enter at least ${minLength} characters.`,
+    messages: {
+      ja: `${minLength}文字以上で入力してください。`,
+    },
+  }),
+
+  /**
+   * 最大文字数エラー
+   * @param {number} maxLength - 最大文字数
+   * @returns {Object} エラーオブジェクト
+   */
+  MAX_LENGTH_ERROR: (maxLength) => ({
+    code: "MAX_LENGTH_ERROR",
+    message: `Please enter ${maxLength} characters or less.`,
+    messages: {
+      ja: `${maxLength}文字以内で入力してください。`,
+    },
+  }),
+
+  /**
+   * パターン不一致エラー
+   * @param {string} pattern - パターン名（例: 'email', 'phone'）
+   * @returns {Object} エラーオブジェクト
+   */
+  PATTERN_ERROR: (pattern) => ({
+    code: "PATTERN_ERROR",
+    message: `Please enter a valid ${pattern} format.`,
+    messages: {
+      ja: `正しい${pattern}の形式で入力してください。`,
+    },
+  }),
+
+  /**
+   * 必須エラー（カスタムメッセージ用）
+   * @param {string} fieldName - フィールド名
+   * @returns {Object} エラーオブジェクト
+   */
+  REQUIRED_FIELD_ERROR: (fieldName) => ({
+    code: "REQUIRED_FIELD_ERROR",
+    message: `${fieldName} is required.`,
+    messages: {
+      ja: `${fieldName}は必須です。`,
+    },
+  }),
+
+  /**
+   * 日付範囲エラー
+   * @param {string} startDate - 開始日
+   * @param {string} endDate - 終了日
+   * @returns {Object} エラーオブジェクト
+   */
+  DATE_RANGE_ERROR: (startDate, endDate) => ({
+    code: "DATE_RANGE_ERROR",
+    message: `Please select a date between ${startDate} and ${endDate}.`,
+    messages: {
+      ja: `${startDate}から${endDate}の間の日付を選択してください。`,
+    },
+  }),
+
+  /**
+   * 日付順序エラー
+   * @returns {Object} エラーオブジェクト
+   */
+  DATE_ORDER_ERROR: () => ({
+    code: "DATE_ORDER_ERROR",
+    message: "Start date must be before end date.",
+    messages: {
+      ja: "開始日は終了日より前である必要があります。",
+    },
+  }),
+
+  /**
+   * 重複エラー
+   * @param {string} fieldName - フィールド名
+   * @returns {Object} エラーオブジェクト
+   */
+  DUPLICATE_ERROR: (fieldName) => ({
+    code: "DUPLICATE_ERROR",
+    message: `${fieldName} is already registered.`,
+    messages: {
+      ja: `${fieldName}は既に登録されています。`,
+    },
+  }),
+
+  /**
+   * カスタムエラー（汎用）
+   * @param {string} code - エラーコード
+   * @param {string} message - 英語メッセージ
+   * @param {Object} messages - 多言語メッセージオブジェクト（例: { ja: '日本語メッセージ' }）
+   * @returns {Object} エラーオブジェクト
+   */
+  CUSTOM_ERROR: (code, message, messages) => ({
+    code,
+    message,
+    messages,
+  }),
+};