@shisyamo4131/air-guard-v2-schemas 2.3.7-dev.9 → 2.3.8-dev.0

package/index.js

@@ -1,6 +1,7 @@
 export { default as Agreement } from "./src/Agreement.js";
 export { default as ArrangementNotification } from "./src/ArrangementNotification.js";
 export { default as Billing } from "./src/Billing.js";
+export { default as Certification } from "./src/Certification.js";
 export { default as Company } from "./src/Company.js";
 export { default as Customer, CustomerMinimal } from "./src/Customer.js";
 export { default as CutoffDate } from "./src/utils/CutoffDate.js";
@@ -14,4 +15,5 @@ export { default as Site } from "./src/Site.js";
 export { default as SiteOperationSchedule } from "./src/SiteOperationSchedule.js";
 export { default as SiteOperationScheduleDetail } from "./src/SiteOperationScheduleDetail.js";
 export { default as SiteOrder } from "./src/SiteOrder.js";
+export { default as System } from "./src/System.js";
 export { default as User } from "./src/User.js";

package/package.json

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

package/src/Agreement.js

@@ -76,11 +76,10 @@
  *****************************************************************************/
 import WorkingResult from "./WorkingResult.js";
 import {
-  VALUES as BILLING_UNIT_TYPE,
-  OPTIONS as BILLING_UNIT_TYPE_OPTIONS,
-} from "./constants/billing-unit-type.js";
+  BILLING_UNIT_TYPE_VALUES,
+  BILLING_UNIT_TYPE_OPTIONS,
+} from "./constants/index.js";
 import { defField } from "./parts/fieldDefinitions.js";
-import CutoffDate from "./utils/CutoffDate.js";
 
 const classProps = {
   ...WorkingResult.classProps,
@@ -98,7 +97,7 @@ const classProps = {
     required: true,
   }),
   billingUnitType: defField("select", {
-    default: BILLING_UNIT_TYPE.PER_DAY.value,
+    default: BILLING_UNIT_TYPE_VALUES.PER_DAY.value,
     label: "請求単位",
     required: true,
     component: {
@@ -111,23 +110,14 @@ const classProps = {
     label: "請求に休憩時間を含める",
     default: false,
   }),
-  cutoffDate: defField("select", {
-    label: "締日区分",
-    default: CutoffDate.VALUES.END_OF_MONTH,
-    required: true,
-    component: {
-      attrs: {
-        items: CutoffDate.OPTIONS,
-      },
-    },
-  }),
+  cutoffDate: defField("cutoffDate", { required: true }),
 };
 
 export default class Agreement extends WorkingResult {
   static className = "取極め";
   static classProps = classProps;
 
-  static BILLING_UNIT_TYPE = BILLING_UNIT_TYPE;
+  static BILLING_UNIT_TYPE = BILLING_UNIT_TYPE_VALUES;
 
   /**
    * Returns an object containing price-related properties.

package/src/Certification.js

@@ -0,0 +1,49 @@
+/**
+ * Certification Model
+ * @version 1.0.0
+ * @author shisyamo4131
+ * @description 警備業務資格モデル
+ *
+ * NOTE: 配列で管理されるので key が必要。2025-12-08 現在、資格名が重複することはない想定。
+ * 但し、2バイト文字が key として適切かは要検討。
+ */
+import { BaseClass } from "@shisyamo4131/air-firebase-v2";
+import { defField } from "./parts/fieldDefinitions.js";
+
+const classProps = {
+  name: defField("name", { label: "資格名", required: true }),
+  type: defField("certificationType", { required: true }),
+  issuedBy: defField("name", { label: "発行元" }),
+  issueDateAt: defField("dateAt", { label: "取得日", required: true }),
+  expirationDateAt: defField("dateAt", { label: "有効期限" }),
+  serialNumber: defField("oneLine", { label: "証明書番号" }),
+};
+
+/**
+ * @prop {string} name - 資格名
+ * @prop {string} type - 資格種別 (CERTIFICATION_TYPE_VALUES)
+ * @prop {string} issuedBy - 発行元
+ * @prop {Date} issueDateAt - 取得日
+ * @prop {Date} expirationDateAt - 有効期限
+ * @prop {string} serialNumber - 証明書番号
+ *
+ * @prop {string} key - 資格名 (nameと同じ) (読み取り専用)
+ */
+export default class Certification extends BaseClass {
+  static className = "資格";
+  static classProps = classProps;
+
+  afterInitialize(item = {}) {
+    super.afterInitialize(item);
+    Object.defineProperties(this, {
+      key: {
+        configurable: true,
+        enumerable: true,
+        get() {
+          return this.name;
+        },
+        set() {},
+      },
+    });
+  }
+}

package/src/Company.js

@@ -1,7 +1,8 @@
 /**
  * Company Model
- * @version 1.3.0
+ * @version 1.4.0
  * @author shisyamo4131
+ * @update 2025-12-02 Add maintenance information properties.
  * @update 2025-12-01 Add Stripe integration fields (stripeCustomerId, subscription).
  * @update 2025-11-27 Add bank information fields for billing.
  * @update 2025-11-23 Set `usePrefix` to false.
@@ -111,6 +112,12 @@ const classProps = {
       employeeLimit: 10,
     }),
   }),
+
+  /** メンテナンス情報 */
+  maintenanceMode: defField("check", { default: false, hidden: true }),
+  maintenanceReason: defField("oneLine", { default: null, hidden: true }),
+  maintenanceStartAt: defField("dateAt", { default: null, hidden: true }),
+  maintenanceStartedBy: defField("oneLine", { default: null, hidden: true }),
 };
 
 export default class Company extends FireModel {

package/src/Customer.js

@@ -1,44 +1,19 @@
-/*****************************************************************************
- * Customer ver 1.1.0
- * @author shisyamo4131
- *
- * @description Customer model.
- *
+/**
+ * Customer
+ * @version 1.1.1
+ * @description This module defines the Customer model for managing customer data.
  * @hasMany Sites - related sites associated with the customer
- *
- * @prop {string} code - customer code
- * @prop {string} name - customer name
- * @prop {string} nameKana - customer name in kana
- * @prop {string} zipcode - postal code
- * @prop {string} prefCode - prefecture code
- * @prop {string} city - city name
- * @prop {string} address - address details
- * @prop {string} building - building name
- * @prop {object} location - geographical location
- * @prop {string} tel - telephone number
- * @prop {string} fax - fax number
- * @prop {string} contractStatus - contract status
- * @prop {number} paymentMonth - payment site in months
- * @prop {string} paymentDate - payment site date
- * @prop {string} remarks - additional remarks
- *
- * @readonly
- * @prop {string} fullAddress - full address combining prefecture, city, and address (read-only)
- * @prop {string} prefecture - prefecture name derived from `prefCode` (read-only)
- *
- * @static
- * @prop {string} STATUS_ACTIVE - constant for active contract status
- * @prop {string} STATUS_TERMINATED - constant for terminated contract status
- *
- * @method getPaymentDueDateAt
- * @param {Date} baseDate - base date in UTC (JST - 9 hours)
- * @returns {Date} payment due date in UTC (JST - 9 hours)
- *****************************************************************************/
+ * @author shisyamo4131
+ * @update 2025-12-08 - Changed `paymentMonth` type from direct number to select field.
+ */
 import FireModel from "@shisyamo4131/air-firebase-v2";
 import { defField } from "./parts/fieldDefinitions.js";
 import { defAccessor } from "./parts/accessorDefinitions.js";
-import { VALUES } from "./constants/contract-status.js";
 import CutoffDate from "./utils/CutoffDate.js";
+import {
+  CONTRACT_STATUS_VALUES,
+  PAYMENT_MONTH_OPTIONS,
+} from "./constants/index.js";
 
 const classProps = {
   code: defField("code", { label: "取引先コード" }),
@@ -53,14 +28,20 @@ const classProps = {
   tel: defField("tel", { colsDefinition: { cols: 12, sm: 6 } }),
   fax: defField("fax", { colsDefinition: { cols: 12, sm: 6 } }),
   contractStatus: defField("contractStatus", { required: true }),
-  paymentMonth: defField("number", {
+  cutoffDate: defField("cutoffDate", { required: true }),
+  paymentMonth: defField("select", {
     default: 1,
     label: "入金サイト（月数）",
     required: true,
+    component: {
+      attrs: {
+        items: PAYMENT_MONTH_OPTIONS,
+      },
+    },
   }),
   paymentDate: defField("select", {
     label: "入金サイト（日付）",
-    default: CutoffDate.VALUES.END_OF_MONTH,
+    default: CutoffDate.VALUES[0].value,
     required: true,
     component: {
       attrs: {
@@ -71,6 +52,36 @@ const classProps = {
   remarks: defField("multipleLine", { label: "備考" }),
 };
 
+/*****************************************************************************
+ * @prop {string} code - customer code
+ * @prop {string} name - customer name
+ * @prop {string} nameKana - customer name in kana
+ * @prop {string} zipcode - postal code
+ * @prop {string} prefCode - prefecture code
+ * @prop {string} city - city name
+ * @prop {string} address - address details
+ * @prop {string} building - building name
+ * @prop {object} location - geographical location
+ * @prop {string} tel - telephone number
+ * @prop {string} fax - fax number
+ * @prop {string} contractStatus - contract status
+ * @prop {number} paymentMonth - payment site in months
+ * @prop {string} paymentDate - payment site date
+ * @prop {string} remarks - additional remarks
+ *
+ * @readonly
+ * @prop {string} fullAddress - full address combining prefecture, city, and address (read-only)
+ * @prop {string} prefecture - prefecture name derived from `prefCode` (read-only)
+ *
+ * @static
+ * @prop {object} STATUS - constant mapping for contract statuses
+ * @prop {string} STATUS_ACTIVE - constant for active contract status
+ * @prop {string} STATUS_TERMINATED - constant for terminated contract status
+ *
+ * @method getPaymentDueDateAt
+ * @param {Date} baseDate - base date in UTC (JST - 9 hours)
+ * @returns {Date} payment due date in UTC (JST - 9 hours)
+ *****************************************************************************/
 export default class Customer extends FireModel {
   static className = "取引先";
   static collectionPath = "Customers";
@@ -93,8 +104,9 @@ export default class Customer extends FireModel {
     { key: "fullAddress", title: "所在地" },
   ];
 
-  static STATUS_ACTIVE = VALUES.ACTIVE.value;
-  static STATUS_TERMINATED = VALUES.TERMINATED.value;
+  static STATUS = CONTRACT_STATUS_VALUES;
+  static STATUS_ACTIVE = CONTRACT_STATUS_VALUES.ACTIVE.value;
+  static STATUS_TERMINATED = CONTRACT_STATUS_VALUES.TERMINATED.value;
 
   afterInitialize(item = {}) {
     super.afterInitialize(item);
@@ -123,7 +135,7 @@ export default class Customer extends FireModel {
     const finalMonth = targetMonth % 12;
 
     let dueDate;
-    if (this.paymentDate === CutoffDate.VALUES.END_OF_MONTH) {
+    if (this.paymentDate === CutoffDate.VALUES[0].value) {
       // 月末の場合
       dueDate = new Date(Date.UTC(targetYear, finalMonth + 1, 0));
     } else {