Senparc.Ncf.Core

定位

Senparc.Ncf.Core 是 NCF 基础运行时核心库，负责承接模块化体系的公共约束与基础能力。NcfPackageSources 中大量基础设施（授权、缓存、事件总线、模块扫描、工作上下文）都从这里起步。

关键能力

1. 模块扫描与启动协作

相关目录：AssembleScan、Areas、Area
相关类型：AssembleScanHelper、IAreaRegister

它与 Senparc.Ncf.XncfBase.Register.StartNcfEngine(...) 配合，完成：

程序集扫描
XNCF 模块识别
AppService 扫描
基础 DI 注入

2. EventBus（高并发事件总线）

相关目录：EventBus
关键文件：InMemoryEventBus.cs、EventBusHostedService.cs、EventBusExtensions.cs

当前版本能力：

可配置并发消费
失败重试（指数退避）
去重处理（事件 ID 窗口）
事件链深度控制
循环引用检测

推荐配置：

services.AddSenparcEventBus(options =>
{
    options.MaxConcurrency = Math.Max(8, Environment.ProcessorCount * 2);
    options.EnableDuplicateDetection = true;
    options.RetryOnFailure = true;
    options.MaxRetryAttempts = 3;
    options.MaxEventChainDepth = 10;
    options.EnableCircularReferenceDetection = true;
}, typeof(YourEventHandler).Assembly);

3. 授权与权限模型

4. 多租户上下文

相关目录：MultiTenant
关键类型：RequestTenantInfo、TenantRule

用于将当前请求租户信息传递到 Service/Repository 层，并支持“忽略多租户”的局部策略接口。

5. AppService 基础模型

相关目录：AppServices、Models/AppServices

提供：

AppServiceBase
FunctionRenderAttribute
标准请求响应模型与辅助工具

这是 XNCF Function 能力的基础承载层。

6. 配置与运行状态

相关目录：Config
关键类型：SiteConfig、NcfCoreState

用于维护运行期关键状态（如模块加载阶段状态、系统开关等）。

典型使用场景

构建跨模块异步协作（EventBus）
在后台管理模块中统一权限验证
搭建多租户业务隔离基础能力
为扩展模块提供统一 AppService 执行模型

使用建议

涉及全局行为（鉴权、事件、配置）优先在 Core 层抽象，不要散落到业务模块。
EventBus 默认无持久化，关键业务应追加 Outbox 或持久化消息方案。
多租户能力上线前，务必验证租户上下文是否在异步流程中正确传递。