@elf-express/admin-net-mcp 1.0.0 → 1.1.0

package/knowledge/config.md

@@ -0,0 +1,147 @@
+# 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/knowledge/entity.md

@@ -0,0 +1,115 @@
+# 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`

package/knowledge/event.md

@@ -0,0 +1,124 @@
+# Admin.NET 事件匯流排指南
+
+## 基本概念
+
+Admin.NET 使用 Furion 的事件匯流排，透過 [EventSubscribe] 屬性訂閱事件，解耦業務邏輯。
+
+## 訂閱者模式
+
+```csharp
+public class OrderEventSubscriber : IEventSubscriber, ISingleton, IDisposable
+{
+    private readonly IServiceScopeFactory _scopeFactory;
+
+    public OrderEventSubscriber(IServiceScopeFactory scopeFactory)
+    {
+        _scopeFactory = scopeFactory;
+    }
+
+    [EventSubscribe("Order:Created")]
+    public async Task OnOrderCreated(EventHandlerExecutingContext context)
+    {
+        // context.Source.EventId — 事件名稱
+        // context.Source.Payload — 事件資料（object）
+        var order = context.Source.Payload as Order;
+
+        using var scope = _scopeFactory.CreateScope();
+        var emailService = scope.ServiceProvider.GetRequiredService<IEmailService>();
+        await emailService.SendOrderConfirmation(order);
+    }
+
+    [EventSubscribe("Order:Cancelled")]
+    public async Task OnOrderCancelled(EventHandlerExecutingContext context)
+    {
+        var payload = (OrderCancelledPayload)context.Source.Payload;
+        // 處理取消邏輯
+    }
+
+    public void Dispose() { }
+}
+```
+
+## 必要條件
+
+| 項目 | 說明 |
+|------|------|
+| `IEventSubscriber` | 必須實作此介面 |
+| `ISingleton` | 通常使用 Singleton（也可 ITransient） |
+| `IDisposable` | 建議實作，釋放資源 |
+| `IServiceScopeFactory` | 訂閱者是 Singleton，需透過 Scope 使用 Scoped 服務 |
+
+## 發布事件
+
+### 方式一：非同步發布（推薦）
+```csharp
+await App.GetRequiredService<IEventPublisher>().PublishAsync(
+    new ChannelEventSource("Order:Created", order));
+```
+
+### 方式二：在 AOP / Filter 中發布
+```csharp
+await App.PublishAsync(new EventSource
+{
+    EventId = CommonConst.AddExLog,
+    Payload = logEntity
+});
+```
+
+### 方式三：透過注入的 IEventPublisher
+```csharp
+public class OrderService : IDynamicApiController, ITransient
+{
+    private readonly IEventPublisher _eventPublisher;
+
+    public OrderService(IEventPublisher eventPublisher)
+    {
+        _eventPublisher = eventPublisher;
+    }
+
+    public async Task CreateOrder(CreateOrderInput input)
+    {
+        var order = await SaveOrder(input);
+        await _eventPublisher.PublishAsync("Order:Created", order);
+    }
+}
+```
+
+## 系統內建事件
+
+### CommonConst 定義的事件
+| 事件名稱 | 說明 |
+|----------|------|
+| `CommonConst.AddExLog` ("Add:ExLog") | 記錄例外 Log |
+| `CommonConst.SendErrorMail` ("Send:ErrorMail") | 發送錯誤通知郵件 |
+
+### 使用者事件（SysUserEventTypeEnum）
+| 事件 | 說明 |
+|------|------|
+| SysUserEventTypeEnum.Add | 使用者建立 |
+| SysUserEventTypeEnum.Register | 使用者自行注冊 |
+| SysUserEventTypeEnum.Update | 使用者更新 |
+| SysUserEventTypeEnum.Delete | 使用者刪除 |
+| SysUserEventTypeEnum.SetStatus | 狀態變更 |
+| SysUserEventTypeEnum.UpdateRole | 角色指派 |
+| SysUserEventTypeEnum.UnlockLogin | 解鎖登入 |
+
+## 事件儲存設定（EventBus.json）
+
+| 設定 | 說明 |
+|------|------|
+| InMemory | 記憶體（預設，不持久化） |
+| Redis | Redis 佇列（需要 RedisEventSourceStorer） |
+| RabbitMQ | RabbitMQ 訊息佇列 |
+
+## 最佳實踐
+
+1. **在訂閱者中取得 Scoped 服務**：使用 IServiceScopeFactory.CreateScope()（因訂閱者是 Singleton）
+2. **Payload 型別**：發布和訂閱要使用相同型別，或用 JSON 字串中轉
+3. **例外處理**：訂閱者的例外不會傳播到發布者，需要在訂閱者中自行 try/catch
+4. **避免循環事件**：A 事件觸發 B 事件觸發 A 事件會造成無限循環
+
+## 檔案位置
+- 核心事件訂閱：`Admin.NET.Core/EventBus/AppEventSubscriber.cs`
+- 應用層事件：`Admin.NET.Application/EventBus/`
+- 常數定義：`Admin.NET.Core/Const/CommonConst.cs`

package/knowledge/plugin.md

@@ -0,0 +1,136 @@
+# Admin.NET 插件系統指南
+
+## 插件載入機制
+
+插件是獨立的 .NET 專案，透過 App.json 中的 ExternalAssemblies 設定自動載入：
+
+```json
+// Admin.NET.Application/Configuration/App.json
+{
+  "App": {
+    "ExternalAssemblies": ["plugins"]
+  }
+}
+```
+
+Furion 掃描 plugins 目錄中的所有組件，自動發現並載入 [AppStartup] 類別。
+
+## Startup 類別模式
+
+每個插件必須有一個 Startup 類別：
+
+```csharp
+namespace Admin.NET.Plugin.MyFeature;
+
+[AppStartup(200)]  // 數字越小，越早執行
+public class Startup : AppStartup
+{
+    public void ConfigureServices(IServiceCollection services)
+    {
+        // 註冊插件的 DI 服務
+        services.AddSingleton<IMyService, MyService>();
+
+        // 設定插件選項
+        services.AddConfigurableOptions<MyFeatureOptions>();
+    }
+
+    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
+    {
+        // 中介軟體設定
+        app.UseMyFeatureMiddleware();
+    }
+}
+```
+
+## 執行優先順序
+
+| Startup 類別 | 優先順序 | 說明 |
+|-------------|----------|------|
+| Admin.NET.Web.Core/Startup | int.MaxValue | 最先執行（框架核心） |
+| Admin.NET.Application/Startup | 100 | 應用層設定 |
+| 各插件 Startup | 自訂（1~99） | 數字越大越晚執行 |
+
+**規則**：數字越大的 [AppStartup(N)] 越晚執行（與直覺相反）。
+框架核心用 MaxValue 確保最先執行，應用層用 100，插件通常用 1-99。
+
+## 插件目錄結構
+
+```
+Plugins/
+└── Admin.NET.Plugin.MyFeature/
+    ├── Admin.NET.Plugin.MyFeature.csproj
+    ├── Startup.cs
+    ├── Entity/
+    │   └── MyEntity.cs
+    ├── Service/
+    │   └── MyService.cs
+    └── Option/
+        └── MyFeatureOptions.cs
+```
+
+## .csproj 設定
+
+```xml
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+  </PropertyGroup>
+  <ItemGroup>
+    <!-- 只需引用 Admin.NET.Core -->
+    <ProjectReference Include="..\\..\\Admin.NET.Core\\Admin.NET.Core.csproj" />
+  </ItemGroup>
+</Project>
+```
+
+## 現有插件清單
+
+| 插件 | 說明 |
+|------|------|
+| Admin.NET.Plugin.GoView | 低代碼視覺化大屏 |
+| Admin.NET.Plugin.DingTalk | 釘釘整合 |
+| Admin.NET.Plugin.ReZero | 介面零程式碼配置 |
+| Admin.NET.Plugin.ApprovalFlow | 審批流程 |
+| Admin.NET.Plugin.K3Cloud | 金蝶 K3 Cloud 整合 |
+| Admin.NET.Plugin.WorkWeixin | 企業微信整合 |
+
+## 插件間通訊
+
+插件之間透過 DI 介面通訊（不直接引用）：
+
+```csharp
+// 定義介面（放在共用的 Core 層或介面插件）
+public interface IApprovalService
+{
+    Task<bool> SubmitForApproval(long entityId, string entityType);
+}
+
+// 在其他插件/服務中使用
+public class OrderService : IDynamicApiController, ITransient
+{
+    private readonly IApprovalService _approvalService;
+
+    public OrderService(IApprovalService approvalService)
+    {
+        _approvalService = approvalService;
+    }
+}
+```
+
+## 開發新插件步驟
+
+1. 在 `Plugins/` 建立新專案 `Admin.NET.Plugin.{FeatureName}`
+2. `.csproj` 引用 `Admin.NET.Core`
+3. 建立 `Startup.cs`（繼承 AppStartup，加上 [AppStartup(N)]）
+4. 在 `ConfigureServices` 中註冊所需服務
+5. 建立 Entity、Service、Option 等類別
+6. 確認輸出目錄在 `Admin.NET.Web.Entry/plugins/` 中（或設定 post-build copy）
+
+## 注意事項
+
+- 插件不可相互直接引用（防止循環依賴）
+- 業務邏輯變更應放插件，不要修改 Admin.NET.Core（方便升級核心）
+- 插件的實體會自動被 SqlSugar 掃描並建立資料表（依 SeedData 設定）
+
+## 檔案位置
+- 插件目錄：`Admin.NET/Plugins/`
+- App.json：`Admin.NET.Application/Configuration/App.json`

package/knowledge/service.md

@@ -0,0 +1,146 @@
+# Admin.NET 服務（Service）設計指南
+
+## IDynamicApiController 模式
+
+Admin.NET 使用 Furion 的動態 API Controller，Service 同時作為業務邏輯層和 API 端點。
+
+```csharp
+[ApiDescriptionSettings(ApplicationConst.GroupName, Order = 100)]
+public class OrderService : IDynamicApiController, ITransient
+{
+    private readonly SqlSugarRepository<Order> _orderRep;
+
+    public OrderService(SqlSugarRepository<Order> orderRep)
+    {
+        _orderRep = orderRep;
+    }
+
+    [DisplayName("分頁查詢訂單")]
+    [ApiDescriptionSettings(Name = "Page"), HttpPost]
+    public async Task<SqlSugarPagedList<OrderOutput>> Page(PageOrderInput input)
+    {
+        // ...
+    }
+}
+```
+
+## DI 生命週期
+
+| 介面 | 生命週期 | 說明 |
+|------|----------|------|
+| `ITransient` | Scoped（每次請求新實例） | 最常用，業務服務預設使用 |
+| `ISingleton` | Singleton（應用程式存活期間唯一） | 快取、設定等無狀態服務 |
+
+## 關鍵 Attribute
+
+### [ApiDescriptionSettings]
+控制路由和 Swagger 分組：
+```csharp
+[ApiDescriptionSettings(
+    GroupName,        // API 分組（通常用 ApplicationConst.GroupName）
+    Name = "Page",    // 自訂路由片段（預設為方法名稱）
+    Order = 100       // Swagger 排序
+)]
+```
+**路由格式**：`/api/{ClassName去掉Service}/{Name}`
+例：OrderService + Name="Page" → `POST /api/order/page`
+
+### [DisplayName]
+Swagger 操作說明（必填，用於中文描述）：
+```csharp
+[DisplayName("新增訂單")]
+```
+
+### [UnitOfWork]
+自動開啟/提交/回滾交易：
+```csharp
+[UnitOfWork]
+public async Task CreateOrderWithItems(CreateOrderInput input)
+{
+    // 多個 DB 操作，任何例外都會自動回滾
+    await _orderRep.InsertAsync(order);
+    await _itemRep.InsertRangeAsync(items);
+}
+```
+
+### HTTP 方法
+```csharp
+[HttpGet]   // GET 請求
+[HttpPost]  // POST 請求（預設）
+```
+
+## BaseService<TEntity> 泛型 CRUD
+
+繼承 BaseService<T> 可直接獲得標準 CRUD，無需自行實作：
+
+```csharp
+public class OrderService : BaseService<Order>, IDynamicApiController, ITransient
+{
+    // 自動繼承以下方法：
+    // GET  /api/order/detail?id=xxx   → GetDetail(long id)
+    // GET  /api/order/list            → GetList()
+    // POST /api/order/add             → Add(Order entity)
+    // POST /api/order/update          → Update(Order entity)
+    // POST /api/order/delete          → Delete(long id)
+}
+```
+
+BaseService<T> 方法：
+| 方法 | HTTP | 路由 | 說明 |
+|------|------|------|------|
+| GetDetail(long id) | GET | /detail | 取得單筆 |
+| GetList() | GET | /list | 取得全部 |
+| Add(T entity) | POST | /add | 新增 |
+| Update(T entity) | POST | /update | 更新 |
+| Delete(long id) | POST | /delete | 刪除 |
+
+## DTO 命名慣例
+
+```
+Add{Entity}Input   — 新增用 DTO（繼承 Base{Entity}Input）
+Update{Entity}Input — 更新用 DTO（繼承 Base{Entity}Input）
+{Entity}Output     — 查詢回傳 DTO
+Page{Entity}Input  — 分頁查詢輸入（含 Page、PageSize、Keyword）
+Query{Entity}Input — 單一查詢（含 Id）
+```
+
+## Mapster 物件映射
+
+```csharp
+// DTO → Entity
+var entity = input.Adapt<Order>();
+
+// 更新現有實體
+input.Adapt(existingOrder);
+
+// Entity → Output DTO
+var output = entity.Adapt<OrderOutput>();
+```
+
+## 分頁查詢範例
+
+```csharp
+[DisplayName("分頁查詢")]
+[ApiDescriptionSettings(Name = "Page"), HttpPost]
+public async Task<SqlSugarPagedList<OrderOutput>> Page(PageOrderInput input)
+{
+    return await _orderRep.AsQueryable()
+        .WhereIF(!string.IsNullOrWhiteSpace(input.Keyword),
+            u => u.OrderNo.Contains(input.Keyword))
+        .Select<OrderOutput>()
+        .ToPagedListAsync(input.Page, input.PageSize);
+}
+```
+
+## 取得目前使用者資訊
+
+```csharp
+// 從 JWT Claims 取得
+var userId = App.User?.FindFirst(ClaimConst.UserId)?.Value;
+var tenantId = App.User?.FindFirst(ClaimConst.TenantId)?.Value;
+var realName = App.User?.FindFirst(ClaimConst.RealName)?.Value;
+```
+
+## 檔案位置
+- BaseService：`Admin.NET.Core/Service/BaseService.cs`
+- 業務服務範例：`Admin.NET.Application/Service/`