@elf-express/admin-net-mcp 1.0.0

package/README.md

@@ -0,0 +1,72 @@
+# Admin.NET Knowledge MCP Server
+
+為 Admin.NET（Furion + SqlSugar）提供框架知識的 MCP Server，讓 Claude 能直接查詢框架慣例，不需要每次 session 重新說明。
+
+## 提供的工具
+
+| 工具                    | 說明                                            |
+| ----------------------- | ----------------------------------------------- |
+| `get_entity_guide`    | EntityBase 類別階層、各欄位、如何選擇基礎類別   |
+| `get_service_guide`   | IDynamicApiController、BaseService<T>、DTO 命名 |
+| `get_sqlsugar_guide`  | AOP 自動填充、Repository 查詢、交易管理         |
+| `get_config_guide`    | IConfigurableOptions、JSON 設定檔結構           |
+| `get_plugin_guide`    | AppStartup 優先順序、插件結構                   |
+| `get_event_guide`     | EventSubscribe 訂閱者、發布事件                 |
+| `get_attribute_guide` | 所有自訂 Attribute 參考                         |
+| `search_knowledge`    | 跨主題關鍵字搜尋                                |
+| `list_topics`         | 列出所有主題                                    |
+
+## 團隊安裝步驟
+
+### 1. 編譯（第一次或有更新時）
+
+```bash
+cd e:/source/platfrom-admin/.claude/mcp-server
+npm install
+npm run build
+```
+
+### 2. 設定 Claude Code
+
+在 `C:\Users\{你的名字}\.claude\settings.json` 加入：
+
+```json
+{
+  "mcpServers": {
+    "admin-net": {
+      "command": "node",
+      "args": ["e:/source/platfrom-admin/.claude/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+### 3. 驗證
+
+重新啟動 Claude Code 後，執行 `/mcp` 指令，應看到 `admin-net` 伺服器和 9 個工具。
+
+### 4Tree
+
+```
+.claude/mcp-server/
+├── src/
+│   ├── index.ts              — MCP server 主程式（9 個工具）
+│   └── knowledge/
+│       ├── entity.ts         — 實體基礎類別
+│       ├── service.ts        — Service/Controller 模式
+│       ├── sqlsugar.ts       — ORM + AOP
+│       ├── config.ts         — 設定系統
+│       ├── plugin.ts         — 插件系統
+│       ├── event.ts          — 事件匯流排
+│       └── attributes.ts     — 自訂 Attribute
+├── dist/                     — 編譯輸出（已產生）
+├── package.json
+├── tsconfig.json
+└── README.md
+
+```
+
+## 更新知識庫
+
+修改 `src/knowledge/` 中的 `.ts` 檔案後，重新執行 `npm run build` 即可。
+所有人 `git pull` 後重新 build 就能取得最新知識。

package/dist/index.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const entity_js_1 = require("./knowledge/entity.js");
+const service_js_1 = require("./knowledge/service.js");
+const sqlsugar_js_1 = require("./knowledge/sqlsugar.js");
+const config_js_1 = require("./knowledge/config.js");
+const plugin_js_1 = require("./knowledge/plugin.js");
+const event_js_1 = require("./knowledge/event.js");
+const attributes_js_1 = require("./knowledge/attributes.js");
+const vue_typescript_js_1 = require("./knowledge/vue-typescript.js");
+const KNOWLEDGE_MAP = {
+    entity: entity_js_1.entityGuide,
+    service: service_js_1.serviceGuide,
+    sqlsugar: sqlsugar_js_1.sqlsugarGuide,
+    config: config_js_1.configGuide,
+    plugin: plugin_js_1.pluginGuide,
+    event: event_js_1.eventGuide,
+    attributes: attributes_js_1.attributesGuide,
+    "vue-typescript": vue_typescript_js_1.vueTypescriptGuide,
+};
+const TOPIC_DESCRIPTIONS = {
+    entity: "實體基礎類別階層（EntityBase, EntityBaseDel, EntityBaseTenant...）",
+    service: "Service/Controller 模式（IDynamicApiController, BaseService<T>, CRUD）",
+    sqlsugar: "SqlSugar ORM（AOP 自動填充、Repository 查詢、交易管理）",
+    config: "設定系統（IConfigurableOptions、JSON 設定檔、Database.json）",
+    plugin: "插件系統（AppStartup 優先順序、插件結構、插件間通訊）",
+    event: "事件匯流排（[EventSubscribe]、IEventSubscriber、發布事件）",
+    attributes: "自訂 Attribute（[Idempotent]、[DataMask]、[Dict]、[SeedData]...）",
+    "vue-typescript": "Vue 3 + TypeScript 採坑記錄（響應式、Element Plus、Vite、Pinia）",
+};
+const server = new mcp_js_1.McpServer({
+    name: "admin-net-knowledge",
+    version: "1.0.0",
+});
+// 各主題工具（固定回傳對應知識）
+const topicTools = [
+    {
+        name: "get_entity_guide",
+        description: "取得 Admin.NET 實體（Entity）設計指南：EntityBase 類別階層、各屬性說明、如何選擇基礎類別、過濾介面（IDeletedFilter/ITenantIdFilter）",
+        topic: "entity",
+    },
+    {
+        name: "get_service_guide",
+        description: "取得 Admin.NET Service 設計指南：IDynamicApiController 模式、[ApiDescriptionSettings]、BaseService<T> 泛型 CRUD、DTO 命名慣例",
+        topic: "service",
+    },
+    {
+        name: "get_sqlsugar_guide",
+        description: "取得 SqlSugar ORM 指南：AOP 自動填充欄位（CreateTime/UpdateTime/TenantId）、Repository 查詢語法、交易管理（[UnitOfWork]）",
+        topic: "sqlsugar",
+    },
+    {
+        name: "get_config_guide",
+        description: "取得 Admin.NET 設定系統指南：IConfigurableOptions 用法、JSON 設定檔位置（Database.json、App.json）、多租戶策略",
+        topic: "config",
+    },
+    {
+        name: "get_plugin_guide",
+        description: "取得 Admin.NET 插件系統指南：[AppStartup(N)] 優先順序、插件目錄結構、ConfigureServices 範例、現有插件清單",
+        topic: "plugin",
+    },
+    {
+        name: "get_event_guide",
+        description: "取得事件匯流排指南：[EventSubscribe] 訂閱者寫法、IEventSubscriber 必要條件、發布事件語法、系統內建事件常數",
+        topic: "event",
+    },
+    {
+        name: "get_attribute_guide",
+        description: "取得自訂 Attribute 參考表：[Idempotent] 防重複、[DataMask] 遮罩、[Dict] 字典驗證、[SeedData] 種子資料等 20+ 個 Attribute",
+        topic: "attributes",
+    },
+    {
+        name: "get_vue_typescript_guide",
+        description: "取得 Vue 3 + TypeScript 採坑記錄：響應式陷阱、Element Plus 常見問題、Vite 模組系統、Pinia 狀態管理、Snowflake ID 精度問題",
+        topic: "vue-typescript",
+    },
+];
+// 註冊所有主題工具
+for (const { name, description, topic } of topicTools) {
+    server.registerTool(name, { description }, async () => ({
+        content: [{ type: "text", text: KNOWLEDGE_MAP[topic] }],
+    }));
+}
+// 列出所有主題
+server.registerTool("list_topics", { description: "列出所有可用的知識主題及其簡短說明" }, async () => {
+    const lines = Object.entries(TOPIC_DESCRIPTIONS).map(([key, desc]) => `- **${key}**: ${desc}`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `# Admin.NET + Vue 知識庫主題\n\n${lines.join("\n")}\n\n使用對應的 get_*_guide 工具取得詳細說明。`,
+            },
+        ],
+    };
+});
+// 跨主題搜尋
+server.registerTool("search_knowledge", {
+    description: "在所有知識庫中搜尋關鍵字，回傳包含該關鍵字的相關說明段落",
+    inputSchema: { keyword: zod_1.z.string().describe("搜尋關鍵字（中文或英文，例如：TenantId、軟刪除、ref、el-dialog）") },
+}, async ({ keyword }) => {
+    const kw = keyword.toLowerCase();
+    const results = [];
+    for (const [topic, content] of Object.entries(KNOWLEDGE_MAP)) {
+        const lines = content.split("\n");
+        const matchingBlocks = [];
+        let i = 0;
+        while (i < lines.length) {
+            if (lines[i].toLowerCase().includes(kw)) {
+                const start = Math.max(0, i - 2);
+                const end = Math.min(lines.length - 1, i + 4);
+                matchingBlocks.push(lines.slice(start, end + 1).join("\n"));
+                i = end + 1;
+            }
+            else {
+                i++;
+            }
+        }
+        if (matchingBlocks.length > 0) {
+            results.push(`## 來自：${topic}（${TOPIC_DESCRIPTIONS[topic]}）\n\n${matchingBlocks.slice(0, 3).join("\n---\n")}`);
+        }
+    }
+    if (results.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `未找到包含「${keyword}」的內容。\n\n可用主題：${Object.keys(KNOWLEDGE_MAP).join("、")}`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `# 搜尋結果：「${keyword}」\n\n${results.join("\n\n---\n\n")}`,
+            },
+        ],
+    };
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`MCP server error: ${err}\n`);
+    process.exit(1);
+});

package/dist/knowledge/attributes.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributesGuide = void 0;
+exports.attributesGuide = `
+# Admin.NET 自訂 Attribute 參考
+
+## 業務邏輯 Attribute
+
+### [IdempotentAttribute] — 冪等請求防重複
+\`\`\`csharp
+[IdempotentAttribute(IntervalTime = 5, Message = "請勿重複提交", ThrowBah = false)]
+public async Task<Result> CreateOrder(OrderInput input)
+{
+    // 5 秒內重複呼叫會返回第一次的結果（或拋出例外）
+}
+\`\`\`
+| 參數 | 說明 |
+|------|------|
+| IntervalTime | 防重複間隔秒數（預設 5） |
+| Message | 重複時的錯誤訊息 |
+| ThrowBah | true=拋出例外，false=返回快取結果 |
+
+**原理**：組合 路由+UserId+參數 產生 Hash，用分散式快取鎖防重複。
+
+---
+
+### [DataMask] — 資料遮罩
+\`\`\`csharp
+// 手機號碼：134****1234
+[DataMask(3, 4)]  // 從第3位開始，遮罩4個字元
+public string PhoneNumber { get; set; }
+
+// 身分證：110***********1234
+[DataMask(3, 11)]
+public string IdCard { get; set; }
+\`\`\`
+JSON 序列化時自動套用遮罩，不影響資料庫中的原始資料。
+
+---
+
+### [Dict] — 字典值驗證
+\`\`\`csharp
+// 使用 Enum 驗證
+[Dict(SmsProviderEnum.Aliyun)]
+public SmsProviderEnum? Provider { get; set; }
+
+// 使用字典代碼驗證
+[Dict("user_status", AllowNullValue = true)]
+public string Status { get; set; }
+\`\`\`
+| 參數 | 說明 |
+|------|------|
+| AllowNullValue | 是否允許 null（預設 false） |
+| AllowEmptyStrings | 是否允許空字串（預設 false） |
+
+---
+
+### [OwnerUser] — 資料擁有者標記
+\`\`\`csharp
+[OwnerUser]
+public long? CreateUserId { get; set; }
+\`\`\`
+標記此欄位為資料擁有者 ID，用於資料權限過濾。EntityBase 的 CreateUserId 已套用此 Attribute。
+
+---
+
+## 資料表初始化 Attribute
+
+### 資料庫路由 Attribute
+| Attribute | 用途 |
+|-----------|------|
+| \`[SysTableAttribute]\` | 強制使用主資料庫（不受多租戶影響） |
+| \`[TenantAttribute]\` | 路由至租戶專屬資料庫 |
+| \`[LogTableAttribute]\` | 路由至獨立 Log 資料庫 |
+| \`[IgnoreTableAttribute]\` | SqlSugar 不建立此資料表 |
+
+### 初始化行為 Attribute
+| Attribute | 用途 |
+|-----------|------|
+| \`[SeedDataAttribute]\` | 此實體有對應的種子資料類別 |
+| \`[IncreTableAttribute]\` | 允許增量更新資料表結構（新增欄位） |
+| \`[IncreSeedAttribute]\` | 允許增量更新種子資料（新增記錄） |
+| \`[IgnoreUpdateSeedAttribute]\` | 即使有 IncreTableAttribute 也跳過種子更新 |
+| \`[IgnoreUpdateSeedColumnAttribute]\` | 種子更新時忽略此欄位的比對 |
+
+---
+
+## 匯入/匯出 Attribute
+
+### [ImportDictAttribute] — 匯入時字典轉換
+\`\`\`csharp
+[ImportDictAttribute("gender")]  // Excel 匯入時，將"男/女"轉換為對應的字典 Key
+public string Gender { get; set; }
+\`\`\`
+
+### [IgnoreEnumToDictAttribute] — 跳過 Enum 字典轉換
+\`\`\`csharp
+[IgnoreEnumToDictAttribute]
+public SomeEnum InternalStatus { get; set; }  // 不加入字典轉換
+\`\`\`
+
+---
+
+## API/回應 Attribute
+
+### [CustomUnifyResultAttribute] — 自訂回應格式
+\`\`\`csharp
+[CustomUnifyResultAttribute(typeof(MyResultProvider))]
+public class SpecialApiService : IDynamicApiController, ITransient
+{
+    // 此服務使用自訂回應格式（不使用預設的統一回應）
+}
+\`\`\`
+
+### [CustomJsonPropertyAttribute] — 自訂 JSON 屬性名
+\`\`\`csharp
+[CustomJsonPropertyAttribute("order_no")]
+public string OrderNo { get; set; }  // JSON 序列化為 "order_no"
+\`\`\`
+
+---
+
+## 常數分組 Attribute
+
+### [ConstAttribute] — 常數分組
+\`\`\`csharp
+[ConstAttribute("SMS供應商")]
+public class SmsProviderConst
+{
+    public const string Aliyun = "aliyun";
+    public const string Tencent = "tencent";
+}
+\`\`\`
+
+### [EnumAttribute] — Enum 標記
+\`\`\`csharp
+[EnumAttribute]
+public enum OrderStatusEnum
+{
+    [Description("待付款")] Pending = 0,
+    [Description("已付款")] Paid = 1,
+    [Description("已完成")] Completed = 2
+}
+\`\`\`
+
+---
+
+## Attribute 目錄
+所有自訂 Attribute 位於：\`Admin.NET.Core/Attribute/\`
+
+常用 Attribute 快速查找：
+- 防重複提交 → IdempotentAttribute
+- 手機/身分證遮罩 → DataMaskAttribute
+- 欄位字典驗證 → DictAttribute
+- 路由至主DB → SysTableAttribute
+- 有種子資料 → SeedDataAttribute
+- 增量更新表結構 → IncreTableAttribute
+`;

package/dist/knowledge/config.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configGuide = void 0;
+exports.configGuide = `
+# Admin.NET 設定系統指南
+
+## IConfigurableOptions 模式
+
+Furion 自動將 JSON 設定檔綁定到實作 IConfigurableOptions 的類別，無需手動 Configure<T>()。
+
+### 基本模式
+\`\`\`csharp
+// 設定類別（放在 Admin.NET.Core/Option/ 或 Admin.NET.Application/Option/）
+public sealed class SMSOptions : IConfigurableOptions
+{
+    public int VerifyCodeExpireSeconds { get; set; } = 60;  // 預設值
+    public string Provider { get; set; }
+    public AliyunSettings Aliyun { get; set; }
+}
+
+// JSON 檔案名稱需與類別名稱去掉 Options 後綴對應
+// SMSOptions → SMS.json（位於 Admin.NET.Application/Configuration/SMS.json）
+\`\`\`
+
+### 需要後處理的模式（PostConfigure）
+\`\`\`csharp
+public sealed class DbConnectionOptions : IConfigurableOptions<DbConnectionOptions>
+{
+    public List<DbConnectionConfig> ConnectionConfigs { get; set; }
+
+    public void PostConfigure(DbConnectionOptions options, IConfiguration configuration)
+    {
+        // JSON 載入後的自訂處理
+        foreach (var config in options.ConnectionConfigs)
+        {
+            if (config.ConfigId == null)
+                config.ConfigId = SqlSugarConst.MainConfigId;
+        }
+    }
+}
+\`\`\`
+
+### 在 Service 中使用
+\`\`\`csharp
+public class SmsService : IDynamicApiController, ITransient
+{
+    private readonly SMSOptions _smsOptions;
+
+    public SmsService(IOptions<SMSOptions> smsOptions)
+    {
+        _smsOptions = smsOptions.Value;
+    }
+}
+\`\`\`
+
+## 設定檔位置
+
+所有 JSON 設定檔放在 \`Admin.NET.Application/Configuration/\`：
+
+| 檔案 | 說明 | 對應 Options 類別 |
+|------|------|------------------|
+| Database.json | 資料庫連線、DB 類型 | DbConnectionOptions |
+| Cache.json | Redis 或記憶體快取 | CacheOptions |
+| App.json | Swagger、插件、CORS、虛擬路徑 | AppOptions |
+| JWT.json | Token 設定（有效期、金鑰） | JWTSettingsOptions |
+| SMS.json | 簡訊供應商設定 | SMSOptions |
+| Alipay.json | 支付寶設定 | AlipayOptions |
+| Wechat.json | 微信設定 | WechatOptions |
+| Logging.json | Serilog 設定 | — |
+| EventBus.json | 事件匯流排（記憶體/Redis/RabbitMQ） | — |
+
+## Database.json 結構
+
+\`\`\`json
+{
+  "DbConnection": {
+    "EnableConsoleSql": true,
+    "SuperAdminIgnoreIDeletedFilter": false,
+    "ConnectionConfigs": [
+      {
+        "ConfigId": "0",
+        "DbNickName": "主資料庫",
+        "DbType": 0,
+        "ConnectionString": "Server=.;Database=AdminNET;...",
+        "DbSettings": {
+          "EnableInitDb": true,
+          "EnableDiffLog": false,
+          "EnableUnderLine": false
+        },
+        "TableSettings": {
+          "EnableInitTable": true,
+          "EnableIncreTable": true
+        },
+        "SeedSettings": {
+          "EnableInitSeed": true,
+          "EnableIncreSeed": false
+        }
+      }
+    ]
+  }
+}
+\`\`\`
+
+## DbType 對應
+
+| 值 | 資料庫 |
+|----|--------|
+| 0 | MySql |
+| 1 | SqlServer |
+| 2 | Sqlite |
+| 3 | Oracle |
+| 4 | PostgreSQL |
+| 5 | Dm（達夢） |
+| 6 | Kdbndp（人大金倉） |
+
+## TenantType 多租戶策略
+
+| 值 | 策略 | 說明 |
+|----|------|------|
+| Id | 欄位隔離 | 同一資料庫，用 TenantId 欄位區分 |
+| Schema | Schema 隔離 | 同一資料庫，不同 Schema |
+| Database | 資料庫隔離 | 完全獨立的資料庫 |
+
+## App.json 關鍵設定
+
+\`\`\`json
+{
+  "App": {
+    "ExternalAssemblies": ["plugins"],    // 插件目錄
+    "CorsUrls": ["http://localhost:9100"],  // 允許的 CORS 來源
+    "VirtualFileServerOptions": [...],     // 虛擬路徑對應
+    "UnifyResultSettings": {              // 統一回應格式設定
+      "DefaultSuccessCode": 200
+    }
+  }
+}
+\`\`\`
+
+## 讀取任意設定（不透過 Options 類別）
+
+\`\`\`csharp
+// 直接讀取設定值
+var value = App.GetConfig<string>("App:CorsUrls:0");
+
+// 取得設定區段
+var section = App.Configuration.GetSection("Database:ConnectionConfigs");
+\`\`\`
+
+## 檔案位置
+- Options 類別：\`Admin.NET.Core/Option/\`
+- JSON 設定檔：\`Admin.NET.Application/Configuration/\`
+`;

package/dist/knowledge/entity.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entityGuide = void 0;
+exports.entityGuide = `
+# Admin.NET 實體（Entity）設計指南
+
+## 基礎類別階層
+
+所有實體都使用 Snowflake ID 作為主鍵（long 型別，由 YitIdHelper.NextId() 自動產生）。
+
+\`\`\`
+EntityBaseId                     — 只有 Id（long）
+  └─ EntityBase                  — + 審計欄位（CreateTime, UpdateTime, 建立/更新者）
+      ├─ EntityBaseDel           — + 軟刪除（IsDelete, DeleteTime）
+      ├─ EntityBaseOrg           — + 組織（OrgId）
+      ├─ EntityBaseTenant        — + 租戶（TenantId）
+      ├─ EntityBaseTenantId      — TenantId 別名變體
+      ├─ EntityBaseOrgDel        — Org + 軟刪除
+      ├─ EntityBaseTenantDel     — Tenant + 軟刪除
+      ├─ EntityBaseTenantOrg     — Tenant + Org
+      └─ EntityBaseTenantOrgDel  — 所有功能（最完整）
+\`\`\`
+
+## 各基礎類別屬性
+
+### EntityBase（所有實體共有）
+| 屬性 | 型別 | 說明 |
+|------|------|------|
+| Id | long | Snowflake ID，AOP 自動生成 |
+| CreateTime | DateTime | 建立時間，AOP Insert 時填入 DateTime.Now |
+| UpdateTime | DateTime? | 更新時間，AOP Update 時填入 DateTime.Now |
+| CreateUserId | long? | 建立者 ID，從 ClaimConst.UserId 取得 |
+| CreateUserName | string | 建立者姓名，從 ClaimConst.RealName 取得 |
+| UpdateUserId | long? | 更新者 ID，AOP 自動填入 |
+| UpdateUserName | string | 更新者姓名，AOP 自動填入 |
+
+### EntityBaseDel（軟刪除）
+| 屬性 | 型別 | 說明 |
+|------|------|------|
+| IsDelete | bool | 是否刪除，預設 false |
+| DeleteTime | DateTime? | 刪除時間，IsDelete=true 時由 AOP 填入 |
+
+### EntityBaseOrg
+| 屬性 | 型別 | 說明 |
+|------|------|------|
+| OrgId | long | 組織 ID，用於資料權限範圍控管 |
+
+### EntityBaseTenant
+| 屬性 | 型別 | 說明 |
+|------|------|------|
+| TenantId | long? | 租戶 ID，AOP Insert 時從 ClaimConst.TenantId 填入 |
+
+## 如何選擇基礎類別
+
+- **一般業務資料**（有審計需求）：→ \`EntityBase\`
+- **可軟刪除的業務資料**：→ \`EntityBaseDel\`
+- **需要組織隔離**（資料權限）：→ \`EntityBaseOrgDel\` 或 \`EntityBaseOrg\`
+- **多租戶資料**：→ \`EntityBaseTenantDel\` 或 \`EntityBaseTenant\`
+- **完整功能（多租戶 + 組織 + 軟刪除）**：→ \`EntityBaseTenantOrgDel\`
+- **系統配置/日誌（不需審計）**：→ \`EntityBaseId\`
+
+## 自動過濾介面
+
+實體實作以下介面後，SqlSugar AOP 會自動套用 WHERE 條件：
+
+\`\`\`csharp
+public interface IDeletedFilter  { bool IsDelete { get; set; } }     // 自動加 WHERE IsDelete=0
+public interface ITenantIdFilter { long? TenantId { get; set; } }    // 自動加 WHERE TenantId=目前租戶
+public interface IOrgIdFilter    { long OrgId { get; set; } }        // 自動加組織資料權限過濾
+\`\`\`
+
+**注意**：EntityBaseDel 已實作 IDeletedFilter，EntityBaseTenant 已實作 ITenantIdFilter，無需手動實作。
+
+## 實體路由（資料庫選擇）
+
+SqlSugar Repository 會依照以下 Attribute 決定連接哪個資料庫：
+
+| Attribute | 用途 |
+|-----------|------|
+| \`[SysTableAttribute]\` | 強制使用主資料庫連線 |
+| \`[TenantAttribute]\` | 路由至租戶專屬資料庫 |
+| \`[LogTableAttribute]\` | 路由至獨立 Log 資料庫 |
+| \`[IgnoreTableAttribute]\` | 不建立資料表 |
+
+## 初始化相關 Attribute
+
+| Attribute | 說明 |
+|-----------|------|
+| \`[SeedDataAttribute]\` | 標記此實體有種子資料 |
+| \`[IncreTableAttribute]\` | 允許增量更新資料表（新增欄位） |
+| \`[IncreSeedAttribute]\` | 允許增量更新種子資料 |
+| \`[IgnoreUpdateSeedAttribute]\` | 跳過種子資料更新 |
+
+## 範例
+
+\`\`\`csharp
+// 一般業務資料（有軟刪除）
+[SugarTable("sys_order", "訂單表")]
+public class SysOrder : EntityBaseDel
+{
+    [SugarColumn(ColumnDescription = "訂單編號", Length = 32)]
+    public string OrderNo { get; set; }
+
+    [SugarColumn(ColumnDescription = "金額", ColumnDataType = "decimal(18,2)")]
+    public decimal Amount { get; set; }
+}
+
+// 多租戶資料（含組織 + 軟刪除）
+[SugarTable("biz_project", "專案表")]
+public class BizProject : EntityBaseTenantOrgDel
+{
+    [SugarColumn(ColumnDescription = "專案名稱", Length = 100)]
+    public string ProjectName { get; set; }
+}
+\`\`\`
+
+## 檔案位置
+- 基礎類別：\`Admin.NET.Core/Entity/EntityBase.cs\`
+- 過濾介面：\`Admin.NET.Core/Entity/IEntityFilter.cs\`
+`;