PlusFramework

PlusFramework 是一个面向企业应用的 .NET 自研模块化单体框架与模板体系。

当前稳定版本是 10.2.4；10.1.0 继续作为 .NET 10 版本线运行时 NuGet Public API 的长期兼容基线。版本事实由 Directory.Packages.props、annotated tag 和 BaGet 包共同证明，架构文档不重复维护 patch 版本历史。

plus-admin 是固定全栈管理后台模板：后端使用 Identity、PermissionManagement、SystemManagement 与 Auditing 模块族，前端采用 source-owned 的 Vue 3 + TypeScript + Vite 应用。模板一次生成同级、独立构建的 Server / Web 单元，两端分别发布和部署，生产默认由反向代理汇聚为同一公网 Origin。

当前状态

当前源码已实现的运行时模块：

1. Plus.Core：模块系统、生命周期、DI 约定和基础异常。
2. Plus.Domain：实体、聚合根、领域服务、仓储抽象和领域异常。
3. Plus.EntityFrameworkCore：DbContext 基类、EF Core 仓储、实体约定、软删除过滤和 UOW 事务集成。
4. Plus.EntityFrameworkCore.PostgreSql、Plus.EntityFrameworkCore.SqlServer、Plus.EntityFrameworkCore.MySql、Plus.EntityFrameworkCore.Sqlite：数据库 provider 薄扩展。
5. Plus.Dapper：轻量 Dapper 基础设施，提供命名连接、provider、connection factory、executor、动态连接描述、本地事务和 timeout 传递。
6. Plus.Uow：工作单元、嵌套 UOW、RequiresNew 和参与者协议。
7. Plus.Application：应用服务标记、运行时基类和应用层异常。
8. Plus.Validation：对象验证、调用参数验证和结构化验证异常。
9. Plus.AspNetCore：ASP.NET Core 宿主桥接、生命周期托管和基础 ProblemDetails。
10. Plus.AspNetCore.Mvc：Controller 装配、MVC conventions、应用/领域异常到 ProblemDetails 的映射。
11. Plus.AspNetCore.Uow：endpoint-aware 请求级 UOW middleware。
12. Plus.AspNetCore.OpenApi：显式 Controller 的 OpenAPI JSON、模块分组和 XML 注释接入。
13. Plus.DataSeeding：面向 DbMigrator / CLI 的显式数据初始化编排。
14. Plus.EventBus：本地事件总线、分布式事件契约和事件名称。
15. Plus.EventBus.EntityFrameworkCore：EF Core Outbox / Inbox、显式 dispatcher 和多实例数据库 claim。
16. Plus.Caching、Plus.Redis、Plus.Caching.Redis：HybridCache、Redis 连接底座和 Redis-backed L2 缓存接入。
17. Plus.DistributedLock、Plus.DistributedLock.Redis：分布式锁抽象和 Redis provider。
18. Plus.EventBus.RabbitMQ：RabbitMQ 分布式事件 transport provider。
19. Plus.BackgroundTasks、Plus.BackgroundTasks.Management、Plus.BackgroundTasks.Hangfire、Plus.BackgroundTasks.Quartz：后台任务抽象、默认 in-process provider、Work 控制面与 Hangfire / Quartz provider。
20. Plus.Security：当前用户上下文和 Claims 访问。
21. Plus.Authorization：权限定义、权限检查、ASP.NET Core authorization policy 接入和授权异常映射。
22. Plus.Auditing、Plus.Auditing.EntityFrameworkCore：安全审计运行时、HTTP 请求级上下文、用户事实、实体变化采集、UOW rollback 结果和独立 EF store；不公开默认审计查询 API。
23. Plus.Serilog：Serilog provider 接入与 PlusFramework Logging 短配置适配，Console 和 File 默认开启。
24. Plus.BlobStoring、Plus.BlobStoring.FileSystem、Plus.BlobStoring.Minio：Blob 存储核心、本地文件系统 provider 和 MinIO / RustFS / S3-compatible provider。
25. Plus.MongoDB：基于官方 MongoDB.Driver 的单包数据访问模块，提供 application-lifetime MongoClient、显式 Context / document 模型、opt-in Repository、可选 ambient UOW transaction 和 forward-only migration。

Plus.Application 统一拥有应用服务基础能力和分页 DTO。业务 Contracts 可以为复用这些稳定 DTO 直接建立编译引用，但保持普通 class library，不继承运行时 IApplicationService，也不因此进入 Module 图。

当前基线明确采用单租户模块化单体：框架不提供租户解析、租户上下文、租户连接路由、租户数据过滤或 TenantManagement。需要 SaaS 多租户的业务项目必须在自身产品边界内单独设计，不能依赖 PlusFramework 的隐含租户语义。

这些已实现模块不等于默认模板第一屏全部启用。固定 plus-admin 后端已启用 Security、Authorization、Auditing 和 PermissionManagement 所需的 Caching；Redis、DistributedLock、Dapper、MongoDB、BlobStoring、RabbitMQ transport 和后台任务 provider 等能力仍按“显式安装、显式配置、显式接入”使用。

当前发布工程：

1. eng/package-manifest.json：唯一发布清单，固定 37 个 Plus.* 运行时包和 1 个 Plus.Templates 包。
2. eng/pack-local.ps1：统一打包可发布的 src/ 项目和模板，并校验 38 包、metadata、README、PackageIcon、repository commit 与内部依赖版本；modules/ 下显式不可打包的源码业务模块不进入清单。
3. eng/verify-templates.ps1：在隔离 custom hive 中安装、卸载和实例化本地模板包，强制生成项目消费本次本地 Plus.* nupkg。
4. eng/verify-ci.ps1：普通 CI 对根解决方案执行 restore、build、dotnet format style 和 test，并生成默认 PostgreSQL Server 执行 restore/build/test；SQLite 选项只生成并校验 provider 结构。SQLite 的 DbMigrator、prune 和 Host health smoke 只在本地 Release 执行。前端由 eng/verify-frontend.ps1 在独立 Linux job 并行验证。
5. eng/verify-release.ps1：只用于显式稳定版本的完整正式门禁，覆盖完整 dotnet format、漏洞、独立样例、模板矩阵、publish、浏览器和包清单。
6. eng/push-baget.ps1：发布前使用同一清单检查本地包和远端同版本，并确认 GitHub 权威 master 精确指向候选 commit；任何正式版本都必须先通过完整门禁和远端冲突检查。

状态必须分开理解：

1. 候选实现：开发工作区中的代码和文档；存在未提交改动时不属于可发布候选。
2. 已提交实现：以干净且可追溯的 Git HEAD 为准，不能用工作区候选替代。
3. 发布包集合：当前 manifest 固定 37 个运行时包和 1 个模板包，共 38 个目标 nupkg。
4. 已发布：BaGet 中的 38 个 10.2.4 主包构成当前完整统一稳定集合；v10.2.4 指向候选 commit 7039f1e613936ee8668d6d869706f0ad678c6b80，10.1.0 继续作为 package compatibility baseline。
5. 验证分层：普通提交运行快速 CI；正式发布只接受干净、已提交且执行期间不变的 HEAD，具体结果由当次 verify-summary.json 和版本化发布证据记录。

当前方向

1. 自研框架。
2. 模块化单体。
3. ASP.NET Core 默认宿主。
4. Microsoft DI 默认容器。
5. EF Core 默认 ORM。
6. 显式 Controller 默认 API 入口。
7. 不考虑微服务路线。
8. 不恢复 Autofac、Castle、DynamicProxy 或方法级 AOP。
9. plus-admin 固定交付一套同源全栈管理后台，不建设模板组合矩阵或多前端技术栈。

文档入口

1. PlusFramework 总纲
2. 模块设计文档索引
3. 代码规范
4. 模块规范
5. 模块分层与契约边界
6. 测试规范
7. 发布与验证
8. 模板规范
9. 前端管理后台规范

发布前必须在干净、已提交、已推送到 GitHub 权威 master 的候选上执行 eng/verify-release.ps1 -Version <major.minor.patch>，审视所有真实外部服务跳过项；push-baget.ps1 会再次校验权威 commit、工作区、包内 RepositoryCommit 和稳定版本格式，之后再由用户显式决定推送和 tag。Gitea 只作为可选镜像，其不可用不阻断正式发布。