@youjunhuang/entity-core 1.0.0

package/dist/models/template.d.ts

@@ -0,0 +1,197 @@
+import { EventSubType } from "./event";
+import { InformChannel, InformStrategyConfig } from "./inform";
+import { Base } from "./utils";
+export declare enum EventCategory {
+    Visual = "visual",// 視覺辨識類事件
+    System = "system",// 系統類事件
+    UserBehavior = "userBehavior",// 使用者行為類事件
+    Voice = "voice"
+}
+export declare enum EventType {
+    Violation = "violation",// 違規（規則/法規型）
+    Anomaly = "anomaly",// 異常（統計/偵測異常）
+    Incident = "incident",// 事故/事件（需處置）
+    Maintenance = "maintenance",// 維護/保養
+    Record = "record"
+}
+export declare enum EventTaskStatus {
+    ACTIVE = "ACTIVE",
+    PAUSED = "PAUSED",
+    FAILED = "FAILED",
+    DONE = "DONE"
+}
+export interface EventTemplateName extends Base {
+    /** 唯一代碼（業務鍵），例：PPE_HEADWEAR */
+    code: string;
+    /** 顯示名稱（可做 i18n 多語） */
+    displayName: string | {
+        [lang: string]: string;
+    };
+    /** 是否啟用此名稱 */
+    isActive: boolean;
+}
+/**
+ * **事件模板介面 (IEventTemplate)**
+ *
+ * 用於產生事件的標準模板，繼承自 Base 基礎介面。
+ * 此介面定義了建立事件時所需的基本屬性和配置。
+ *
+ * @interface EventTemplate
+ * @extends Base
+ */
+export interface EventTemplate extends Base {
+    /**
+     * 模板名稱
+     *
+     * 用於識別和區分不同的事件模板，應具有描述性且易於理解
+     *
+     * @type {string}
+     * @example "PPE_NORMAL"
+     * @example "PPE_PLANT"
+     */
+    nameCode: string;
+    /**
+     * 事件分類
+     *
+     * 定義事件所屬的大分類，用於事件的初步歸類和處理路由
+     *
+     * @type {EventCategory}
+     * @example EventCategory.Visual - 視覺辨識類事件
+     * @example EventCategory.System - 系統類事件
+     * @example EventCategory.Voice - 語音辨識類事件
+     */
+    category: EventCategory;
+    /**
+     * 事件類型
+     *
+     * 更細化的事件類型定義，與 category 搭配使用以精確分類事件
+     * 通常與 EventCategory 有對應關係
+     *
+     * @type {EventType}
+     * @example EventType.Visual - 視覺辨識
+     * @example EventType.System - 系統監控
+     * @example EventType.UserBehavior - 使用者行為
+     */
+    type: EventType;
+    /**
+     * 事件嚴重程度
+     *
+     * 數值範圍通常為 1-5，數字越大表示事件越嚴重
+     * 用於決定事件處理的優先順序和通知策略
+     *
+     * @type {number}
+     * @range 1-5
+     * @example 1 - 資訊性事件（低優先度）
+     * @example 3 - 一般事件（中等優先度）
+     * @example 5 - 緊急事件（最高優先度）
+     */
+    severity: number;
+    /**  * 模板描述
+     *
+     * 用於說明此模板的用途和適用場景，幫助使用者理解和選擇合適的模板
+     *
+     * @type {string}
+     * @example "用於偵測未戴安全帽的事件"
+     * @example "用於記錄系統異常狀況"
+     */
+    description?: string;
+    /**
+     * 模板啟用狀態
+     *
+     * 控制此模板是否可用於產生新的事件
+     * false 表示模板已停用，不會用於建立新事件
+     *
+     * @type {boolean}
+     * @default true
+     * @example true - 模板啟用中，可用於產生事件
+     * @example false - 模板已停用，暫停使用
+     */
+    isActive: boolean;
+}
+/**
+ * **事件通知設定 (模板)**
+ *
+ * 用於定義哪些事件應該通知誰，以及適用的通知策略。
+ *
+ * - `eventType`：要監聽的事件類別。
+ * - `subTypes`：要監聽的子類型列表（可選，若未指定則監聽該類別下所有子類型）。
+ * - `recipients`：通知接收者 (可為使用者 ID 或 Webhook URL)。
+ * - `channels`：發送通知的渠道 (Email, SMS, Webhook...)。
+ * - `strategy`：通知策略，包含持續通知與子類型變化通知兩種模式。
+ */
+export interface EventInformTemplate extends Base {
+    /** 監聽的事件類別 */
+    eventType: EventType;
+    /** 監聽的特定事件子類型（若為空則監聽該類別的所有事件） */
+    subTypes?: EventSubType[];
+    /** 接收通知的對象 (使用者 ID 或 Webhook URL) */
+    recipients: string[];
+    /** 發送通知的渠道 (Email, SMS, Webhook...) */
+    channels: InformChannel[];
+    /** 通知策略 */
+    strategy: InformStrategyConfig;
+}
+/**
+ * **任務模板 (TaskTemplate)**
+ *
+ * 用於定義任務執行前的標準作業流程 (SOP)，包含任務的預設資訊，
+ * 當真實事件發生時，根據該模板產生一個 Task 實例。
+ *
+ * - **`name`**：任務模板名稱，作為 SOP 的標題。
+ * - **`description`**：任務模板描述，說明標準流程或要求。
+ * - **`[parentTaskId]`** _(可選)_：上層任務 ID，若為最上層任務則為 `null` 或 `undefined`。
+ * - **`[dependencyId]`**  _(可選)_：依賴的任務 ID ，若其中任務未完成，則本任務可能被阻塞。
+ * - **`[freeTags]`**  _(可選)_：可額外標註任何關鍵字或標籤，讓系統可彈性紀錄任務。
+ * - **`[weight]`** _(可選)_：任務重量 / 工作量 (小時數、點數等)。
+ * - **`[complexity]`** _(可選)_：任務複雜度 (難度指數)。
+ * - **`[priority]`** _(可選)_：任務優先度 (可用數值或自定義枚舉)。
+ * - **`[requiredSkills]`** _(可選)_：任務所需的技能陣列。
+ * - **`[requiredKnowledge]`** _(可選)_：任務所需的知識領域陣列。
+ *
+ * @interface TaskTemplate
+ */
+export interface TaskTemplate extends Base {
+    /**
+     * 任務模板名稱。
+     * @example "撰寫月度報告"
+     */
+    name: string;
+    /**
+     * 任務模板描述，說明該 SOP 的標準流程或要求。
+     * @example "依據公司指示撰寫並提交月度報告。"
+     */
+    description?: string;
+    /** 上層任務 ID (若為最上層則可為 undefined) */
+    parentId?: TaskTemplate['id'];
+    /**
+     * 依賴的任務 ID ：
+     * 若其中任務尚未完成，則本任務可能處於 BLOCKED 狀態
+     */
+    dependencyId?: TaskTemplate['id'];
+    /**
+     * 預設標籤，作為產生任務時的初始標籤。
+     */
+    freeTags?: string[];
+    /**
+     * 預設工作量 (例如小時數或點數)。
+     * @example 8
+     */
+    weight?: number;
+    /**
+     * 預設任務複雜度 (難度指數)。
+     * @example 5
+     */
+    complexity?: number;
+    /** 任務優先度 (可用數值或自定義枚舉/常數) */
+    priority?: number;
+    /** 任務所需的技能陣列。
+     * @example ["React", "Welding"]
+     */
+    requiredSkills?: string[];
+    /** 任務所需的知識領域。
+     * @example  ["ISO 9001", "金融法規"]
+     */
+    requiredKnowledge?: string[];
+}
+export type Template = EventTemplate | EventInformTemplate;
+//# sourceMappingURL=template.d.ts.map

package/dist/models/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../models/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AA2C/B,oBAAY,aAAa;IACvB,MAAM,WAAW,CAAU,UAAU;IACrC,MAAM,WAAW,CAAU,QAAQ;IACnC,YAAY,iBAAiB,CAAE,WAAW;IAC1C,KAAK,UAAU;CAChB;AAGD,oBAAY,SAAS;IACnB,SAAS,cAAc,CAAM,aAAa;IAC1C,OAAO,YAAY,CAAU,cAAc;IAC3C,QAAQ,aAAa,CAAQ,aAAa;IAC1C,WAAW,gBAAgB,CAAE,QAAQ;IACrC,MAAM,WAAW;CAClB;AAGD,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAOD,MAAM,WAAW,iBAAkB,SAAQ,IAAI;IAC7C,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,WAAW,EAAE,MAAM,GAAG;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACjD,cAAc;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI;IACzC;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;OASG;IACH,QAAQ,EAAE,aAAa,CAAC;IAExB;;;;;;;;;;OAUG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,MAAM,CAAC;IAGjB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI;IAC/C,cAAc;IACd,SAAS,EAAE,SAAS,CAAC;IAErB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAE1B,qCAAqC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,uCAAuC;IACvC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAE1B,WAAW;IACX,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI;IACxC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAE9B;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,mBAAmB,CAAC"}

package/dist/models/template.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventTaskStatus = exports.EventType = exports.EventCategory = void 0;
+// /**
+//  * **事件模板 (EventTemplate)**
+//  * 
+//  * 用於產生事件的藍本。與 Event 的主要差異在於：
+//  * - 模板本身沒有具體的觸發時間，僅包含預設的事件屬性。
+//  * - 當排程觸發時，根據此模板生成一個 Event 實例，並補充觸發時間、排程ID等資料。
+//  *
+//  * - **`type`**：事件大分類（視覺辨識 / 系統異常 / 使用者行為）。  
+//  * - **`subType`**：具體事件子類型，例如 `overspeed`、`carAccident` 等。  
+//  * - **`description`**：事件描述文字。  
+//  * - **`freeTags`**：可額外標註任何關鍵字或標籤，讓系統可彈性紀錄事件。  
+//  * @interface EventTemplate
+//  */
+// export interface IEventTemplate extends Base {
+//   /**
+//    * 事件大分類，例如視覺辨識、系統異常、使用者行為。
+//    * @example EventType.Visual
+//    */
+//   type: EventType;
+//   /**
+//    * 具體事件子類型，例如 "carAccident"、"overspeed" 等。
+//    * @example EventSubType.CarAccident
+//    */
+//   subType: EventSubType;
+//   /**
+//    * 預設事件描述，作為事件生成時的初始描述。
+//    * @example "偵測到車禍，等待後續處理。"
+//    */
+//   description?: string;
+//   /**
+//    * 預設標籤，作為產生事件時的初始標籤。
+//    * @example ["highway", "urgent"]
+//    */
+//   freeTags?: string[];
+// }
+// 事件大分類
+var EventCategory;
+(function (EventCategory) {
+    EventCategory["Visual"] = "visual";
+    EventCategory["System"] = "system";
+    EventCategory["UserBehavior"] = "userBehavior";
+    EventCategory["Voice"] = "voice";
+})(EventCategory || (exports.EventCategory = EventCategory = {}));
+// 事件型別
+var EventType;
+(function (EventType) {
+    EventType["Violation"] = "violation";
+    EventType["Anomaly"] = "anomaly";
+    EventType["Incident"] = "incident";
+    EventType["Maintenance"] = "maintenance";
+    EventType["Record"] = "record";
+})(EventType || (exports.EventType = EventType = {}));
+// 任務狀態（排程/規則任務）
+var EventTaskStatus;
+(function (EventTaskStatus) {
+    EventTaskStatus["ACTIVE"] = "ACTIVE";
+    EventTaskStatus["PAUSED"] = "PAUSED";
+    EventTaskStatus["FAILED"] = "FAILED";
+    EventTaskStatus["DONE"] = "DONE";
+})(EventTaskStatus || (exports.EventTaskStatus = EventTaskStatus = {}));
+//# sourceMappingURL=template.js.map

package/dist/models/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../models/template.ts"],"names":[],"mappings":";;;AAIA,MAAM;AACN,8BAA8B;AAC9B,MAAM;AACN,gCAAgC;AAChC,iCAAiC;AACjC,kDAAkD;AAClD,KAAK;AACL,gDAAgD;AAChD,+DAA+D;AAC/D,mCAAmC;AACnC,kDAAkD;AAClD,8BAA8B;AAC9B,MAAM;AACN,iDAAiD;AACjD,QAAQ;AACR,gCAAgC;AAChC,iCAAiC;AACjC,QAAQ;AACR,qBAAqB;AAErB,QAAQ;AACR,+CAA+C;AAC/C,yCAAyC;AACzC,QAAQ;AACR,2BAA2B;AAE3B,QAAQ;AACR,4BAA4B;AAC5B,gCAAgC;AAChC,QAAQ;AACR,0BAA0B;AAE1B,QAAQ;AACR,0BAA0B;AAC1B,sCAAsC;AACtC,QAAQ;AACR,yBAAyB;AACzB,IAAI;AAGJ,QAAQ;AACR,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,8CAA6B,CAAA;IAC7B,gCAAe,CAAA;AACjB,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AAED,OAAO;AACP,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,gCAAmB,CAAA;IACnB,kCAAqB,CAAA;IACrB,wCAA2B,CAAA;IAC3B,8BAAiB,CAAA;AACnB,CAAC,EANW,SAAS,yBAAT,SAAS,QAMpB;AAED,gBAAgB;AAChB,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,gCAAa,CAAA;AACf,CAAC,EALW,eAAe,+BAAf,eAAe,QAK1B"}

package/dist/models/ui-item.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 實體類型枚舉
+ * 定義 UI 項目可以關聯的實體類型
+ */
+export declare enum EntityTypeEnum {
+    Event = "event",// 事件
+    Task = "task",// 任務
+    Camera = "camera",// 攝像頭
+    Map = "map",// 地圖
+    Report = "report",// 報告
+    User = "user"
+}
+/**
+ * UI 項目介面
+ * 用於定義使用者介面中的項目，支援釘選、標籤等功能
+ * 主要用途：個人化使用者體驗，快速存取常用項目
+ */
+export interface UiItem {
+    /** 項目唯一識別碼 (UUID) */
+    id: string;
+    /** 使用者 ID，關聯到 UserProfile.id */
+    userId: string;
+    /** 實體類型，定義此 UI 項目關聯的實體種類 */
+    entityType: EntityTypeEnum;
+    /** 實體 ID，關聯到對應實體的唯一識別碼 */
+    entityId: string;
+    /** 是否釘選，預設為 false。釘選的項目會優先顯示 */
+    pinned?: boolean;
+    /** 自定義標籤，使用者可為項目添加個人化標籤 */
+    label?: string;
+    /** 顯示順序索引，數值越小越靠前 */
+    orderIndex?: number;
+    /** 分類標籤，方便使用者對項目進行分類 */
+    section?: string;
+    /** 顯示圖示，支援 FontAwesome 或自定義圖示名稱 */
+    meta: string;
+    /** 項目過期時間，過期後可自動清除 */
+    expiresAt?: Date;
+}
+//# sourceMappingURL=ui-item.d.ts.map

package/dist/models/ui-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-item.d.ts","sourceRoot":"","sources":["../../models/ui-item.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,oBAAY,cAAc;IACxB,KAAK,UAAU,CAAQ,KAAK;IAC5B,IAAI,SAAS,CAAU,KAAK;IAC5B,MAAM,WAAW,CAAM,MAAM;IAC7B,GAAG,QAAQ,CAAW,KAAK;IAC3B,MAAM,WAAW,CAAM,KAAK;IAC5B,IAAI,SAAS;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IAEf,4BAA4B;IAC5B,UAAU,EAAE,cAAc,CAAC;IAE3B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB"}

package/dist/models/ui-item.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityTypeEnum = void 0;
+/**
+ * 實體類型枚舉
+ * 定義 UI 項目可以關聯的實體類型
+ */
+var EntityTypeEnum;
+(function (EntityTypeEnum) {
+    EntityTypeEnum["Event"] = "event";
+    EntityTypeEnum["Task"] = "task";
+    EntityTypeEnum["Camera"] = "camera";
+    EntityTypeEnum["Map"] = "map";
+    EntityTypeEnum["Report"] = "report";
+    EntityTypeEnum["User"] = "user";
+})(EntityTypeEnum || (exports.EntityTypeEnum = EntityTypeEnum = {}));
+//# sourceMappingURL=ui-item.js.map

package/dist/models/ui-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-item.js","sourceRoot":"","sources":["../../models/ui-item.ts"],"names":[],"mappings":";;;AACA;;;GAGG;AACH,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,+BAAa,CAAA;IACb,mCAAiB,CAAA;IACjB,6BAAW,CAAA;IACX,mCAAiB,CAAA;IACjB,+BAAa,CAAA;AACf,CAAC,EAPW,cAAc,8BAAd,cAAc,QAOzB"}

package/dist/models/user.d.ts

@@ -0,0 +1,125 @@
+import { Permission } from './permission';
+import { Role } from './role';
+import { Base } from './utils';
+/**
+ * **使用者介面**
+ * 負責存儲使用者的基本資訊，並與帳號關聯。
+ *
+ * - **`name`**：使用者姓名。
+ * - **`[roles]`** _(可選)_：使用者所擁有的角色 ID 陣列。
+ * - **`[permissions]`** _(可選)_：使用者擁有的權限列表陣列。
+ *
+ * @interface User
+ */
+export interface User extends Base {
+    /** 使用者姓名。 */
+    name: string;
+    /** 使用者擁有的角色列表。 */
+    roleId_list?: Role['id'][];
+    /** 使用者擁有的權限列表。 */
+    permissionId_list?: Permission['id'][];
+}
+/**
+ * **使用者介面**
+ * 負責存儲使用者的角色列表。
+ *
+ * - **`userId`**：關聯的使用者 ID。
+ * - **`role`**：使用者擁有的角色列表。
+ *
+ * @interface UserRole
+ */
+export interface UserRole extends Base {
+    /** 關聯的使用者 ID。 */
+    userId: User['id'];
+    /** 使用者擁有的角色列表。 */
+    role?: Role['id'];
+}
+/**
+ * **使用者介面**
+ * 負責存儲使用者的權限列表。
+ *
+ * - **`userId`**：關聯的使用者 ID。
+ * - **`permission`**：使用者擁有的權限列表。
+ *
+ * @interface UserPermission
+ */
+export interface UserPermission extends Base {
+    /** 關聯的使用者 ID。 */
+    userId: User['id'];
+    /** 使用者擁有的權限列表。 */
+    permission?: Permission['id'];
+}
+/**
+ * **使用者擴充檔 (UserProfile)**
+ * - 用於儲存 User 其他延伸資訊。
+ *
+ * ### 設計說明
+ *
+ * - 目前只包含最常用的 Email、Phone 欄位。
+ * - 若未來需求可能擴增多個 Email / Phone 或其他聯絡方式，建議進行資料庫 Migration
+ *   或改用獨立的 `ContactInfo` 結構，以更具彈性。
+ *
+ * - **`[email]`** _(可選)_：電子郵件，作為聯絡方式，若無則為 `undefined`。
+ * - **`[phone]`** _(可選)_：手機號碼，若無則為 `undefined`。
+ * - **`[address]`** _(可選)_：地址或其他欄位，若無則為 `undefined`。
+ * - **`[avatarUrl]`** _(可選)_：頭像URL，若無則為 `undefined`。
+ */
+export interface UserProfile extends User {
+    /** 電子郵件，作為聯絡方式，若無則為 `undefined`。 */
+    email?: string;
+    /** 手機號碼，若無則為 `undefined`。 */
+    phone?: string;
+    /**
+     * (若需要) 地址或其他欄位
+     */
+    address?: string;
+    /**
+     * (若需要) 頭像URL
+     */
+    avatarUrl?: string;
+    /** 使用者帳號，用於登入系統 */
+    account: string;
+    department: string;
+    organizationUnit: string;
+    description?: string;
+}
+/**
+ * **聯絡方式類型 (ContactType)**
+ * - **`Email`**：電子郵件
+ * - **`Phone`**：手機/電話
+ * - **`Line`**：Line ID
+ * - **`WeChat`**：微信
+ * - **`Telegram`**：Telegram 用戶名
+ * - (可自行擴充其他通訊方式)
+ */
+export declare enum ContactType {
+    Email = "email",
+    Phone = "phone",
+    Line = "line",
+    WeChat = "wechat",
+    Telegram = "telegram"
+}
+/**
+ * **聯絡資訊 (ContactInfo)**
+ * 表示使用者的一組聯絡管道
+ *
+ * - **`type`**: 聯絡方式類型 (Email, Phone, Line, etc.)
+ * - **`value`**: 實際的聯絡方式字串，例如 Email 地址、Line ID 等
+ * - **`userId`**: 關聯的使用者 ID。
+ * - **[`verified`]** _(可選)_： 代表此聯絡方式是否已驗證 (例如驗證碼驗證過的 Email / Phone)
+ *
+ */
+export interface ContactInfo {
+    /** 聯絡方式類型 (Email, Phone, Line, etc.) */
+    type: ContactType;
+    /** 實際的聯絡方式字串，例如 Email 地址、Line ID 等 */
+    value: string;
+    /** 關聯的使用者 ID。 */
+    userId: User['id'];
+    /**
+     * 代表此聯絡方式是否已驗證 (例如驗證碼驗證過的 Email / Phone)
+     * @default false
+     */
+    verified?: boolean;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/models/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../models/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAG9B;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAK,SAAQ,IAAI;IAChC,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IAEb,kBAAkB;IAClB,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAE3B,kBAAkB;IAClB,iBAAiB,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,iBAAiB;IACjB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnB,kBAAkB;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;CACnB;AAGD;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI;IAC1C,iBAAiB;IACjB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnB,kBAAkB;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;CAE/B;AAGD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI;IAEvC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAIhB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD;;;;;;;;GAQG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;CAEtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,EAAE,WAAW,CAAC;IAElB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IAEd,iBAAiB;IACjB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/models/user.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContactType = void 0;
+/**
+ * **聯絡方式類型 (ContactType)**
+ * - **`Email`**：電子郵件
+ * - **`Phone`**：手機/電話
+ * - **`Line`**：Line ID
+ * - **`WeChat`**：微信
+ * - **`Telegram`**：Telegram 用戶名
+ * - (可自行擴充其他通訊方式)
+ */
+var ContactType;
+(function (ContactType) {
+    ContactType["Email"] = "email";
+    ContactType["Phone"] = "phone";
+    ContactType["Line"] = "line";
+    ContactType["WeChat"] = "wechat";
+    ContactType["Telegram"] = "telegram";
+    // 其他如 Slack, Skype, Discord, etc.
+})(ContactType || (exports.ContactType = ContactType = {}));
+//# sourceMappingURL=user.js.map

package/dist/models/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../models/user.ts"],"names":[],"mappings":";;;AA2GA;;;;;;;;GAQG;AACH,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,8BAAe,CAAA;IACf,4BAAa,CAAA;IACb,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,kCAAkC;AACpC,CAAC,EAPW,WAAW,2BAAX,WAAW,QAOtB"}

package/dist/models/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * **基礎物件介面**
+ * 所有資料模型的基本結構，適用於所有主表。
+ *
+ * - **`id`**：唯一識別碼，用於標識該物件。
+ * - **`createdAt`**：該物件的建立時間，表示該記錄何時創建。
+ * - **`createdBy`**：創建該記錄的使用者 ID。
+ * - **`updatedAt`**：最後更新時間，表示該記錄最後被修改的時間。
+ * - **`updatedBy`** ：最後更新該記錄的使用者 ID。
+ * - **`isDeleted`**：是否已刪除（軟刪除）。
+ *
+ * @interface Base
+ */
+export interface Base {
+    /** 唯一識別碼，用於標識該物件。 */
+    id: string;
+    /** 該物件的建立時間，表示該記錄何時創建。 */
+    createdAt?: Date;
+    /** 創建該記錄的使用者 ID。 */
+    createdBy?: string;
+    /** 最後更新時間，表示該記錄最後被修改的時間。 */
+    updatedAt?: Date;
+    /** 最後更新該記錄的使用者 ID。 */
+    updatedBy?: string;
+    /** 是否已刪除（軟刪除）。 */
+    isDeleted?: boolean;
+}
+//# sourceMappingURL=utils.d.ts.map

package/dist/models/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../models/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,IAAI;IACjB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,0BAA0B;IAC1B,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,oBAAoB;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kBAAkB;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/models/utils.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=utils.js.map

package/dist/models/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../models/utils.ts"],"names":[],"mappings":""}

package/dist/schemas/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mongo';
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mongo"), exports);
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../schemas/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/dist/schemas/mongo/account-mongo.schema.d.ts

@@ -0,0 +1,27 @@
+import { Schema, Document, Types } from 'mongoose';
+import { Account } from '../../models';
+import { UserProfileDocument } from './user-mongo.schema';
+export type AccountMongoose = Omit<Account, 'userId'> & {
+    userId: Types.ObjectId | string | UserProfileDocument;
+    _user?: UserProfileDocument;
+};
+export interface AccountDocument extends Document, AccountMongoose {
+    id: string;
+    userId: Types.ObjectId | string | UserProfileDocument;
+    _user?: UserProfileDocument;
+}
+export declare const AccountSchema: Schema<AccountDocument, import("mongoose").Model<AccountDocument, any, any, any, Document<unknown, any, AccountDocument, any, {}> & AccountDocument & Required<{
+    _id: Types.ObjectId;
+}> & {
+    __v: number;
+}, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, AccountDocument, Document<unknown, {}, import("mongoose").FlatRecord<AccountDocument>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<AccountDocument> & Required<{
+    _id: Types.ObjectId;
+}> & {
+    __v: number;
+}>;
+export declare const AccountModel: import("mongoose").Model<AccountDocument, {}, {}, {}, Document<unknown, {}, AccountDocument, {}, {}> & AccountDocument & Required<{
+    _id: Types.ObjectId;
+}> & {
+    __v: number;
+}, any>;
+//# sourceMappingURL=account-mongo.schema.d.ts.map

package/dist/schemas/mongo/account-mongo.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-mongo.schema.d.ts","sourceRoot":"","sources":["../../../schemas/mongo/account-mongo.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAS,QAAQ,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG;IACtD,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,mBAAmB,CAAC;IACtD,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,eAAgB,SAAQ,QAAQ,EAAE,eAAe;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,GAAG,mBAAmB,CAAC;IACtD,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAGD,eAAO,MAAM,aAAa;;;;;;;;EAUzB,CAAC;AAUF,eAAO,MAAM,YAAY;;;;OAAmD,CAAC"}

package/dist/schemas/mongo/account-mongo.schema.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountModel = exports.AccountSchema = void 0;
+const mongoose_1 = require("mongoose");
+// 定義 Account 的 Schema
+exports.AccountSchema = new mongoose_1.Schema({
+    id: { type: String, required: true, immutable: true }, // 使用 UUID 作為 id
+    userId: { type: String, required: false, index: true }, // 使用者的唯一識別碼
+    username: { type: String, required: true, unique: true },
+    passwordHash: { type: String, required: true },
+    isActive: { type: Boolean, default: true },
+    lastLoginAt: { type: Date, required: false },
+}, { timestamps: true });
+exports.AccountSchema.virtual('_user', {
+    ref: 'UserProfile',
+    localField: 'userId',
+    foreignField: 'id',
+    justOne: true,
+});
+// // 創建 Account 模型
+exports.AccountModel = (0, mongoose_1.model)('Account', exports.AccountSchema);
+//# sourceMappingURL=account-mongo.schema.js.map

package/dist/schemas/mongo/account-mongo.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-mongo.schema.js","sourceRoot":"","sources":["../../../schemas/mongo/account-mongo.schema.ts"],"names":[],"mappings":";;;AAAA,uCAA0D;AAiB1D,sBAAsB;AACT,QAAA,aAAa,GAAG,IAAI,iBAAM,CACrC;IACE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,gBAAgB;IACvE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY;IACpE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IACxD,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9C,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;IAC1C,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC7C,EACD,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;AAEF,qBAAa,CAAC,OAAO,CAAC,OAAO,EAAE;IAC7B,GAAG,EAAE,aAAa;IAClB,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE,IAAI;IAClB,OAAO,EAAE,IAAI;CACd,CAAC,CAAC;AAEH,mBAAmB;AACN,QAAA,YAAY,GAAG,IAAA,gBAAK,EAAkB,SAAS,EAAE,qBAAa,CAAC,CAAC"}