项目重大变更,按时间从新到旧排列。
2026-06-22 — 架构模板与代码生成完善
- 代码生成 CLI — 增加 EF Core 适配器模板和集成事件模板支持,脚手架覆盖 SqlSugar + EF Core 双 ORM 路径。
- 最小可运行模板 — 添加
dotnet new解决方案模板,从零生成完整的项目骨架(BuildingBlocks + Hosts + Platform + Tests)。 - 种子框架 — 引入
ISeedStep/SeedRunner/CsvSeedReader/CsvSeedStepBase种子框架基础设施,支持 CSV 驱动的可复现种子数据。
2026-06-21 — 文档与 ADR 补充
- 架构文档 — 新增目标目录布局 ADR 和迁移规则 ADR,明确 BuildingBlocks / Platform / Hosts 的命名空间约定和跨层引用约束。
- 开发指南 — 新增模块开发指南和适配器开发指南,覆盖 IAppModule 契约、五件套结构和适配器状态矩阵(Default / Production / Optional / Unavailable)。
2026-06-20 — CI 加固与 API 重构
- 质量门禁 — 将 trim publish 从软门禁升级为硬门禁,
verify-all.sh现在强制执行dotnet publish -p:PublishTrimmed=true检查。 - CI 流程 — 优化 GitHub Actions 流水线结构和缓存策略。
- API Host — 重构服务组合注册和端点映射,拆分为按模块注册的扩展方法。将
Caller替换为CurrentUser类型以统一用户上下文。 - 默认适配器 — 添加默认适配器实现保障 DI 闭合,确保 Host 在无业务模块注册时也能成功构建。
- 可观测性 — 添加
BitzOrcasActivitySources命名约定测试,强制所有 ActivitySource 遵循统一命名规范。
2026-06-19 — 持久化统一
- 持久化基类 — 统一持久化实体基类和主键生成方案(雪花 ID),消除 SqlSugar 和 EF Core 适配器之间的主键类型差异。
- 目录管理模块 — 实现目录管理(Catalog)模块及相关契约定义。
2026-06-18 — 平台模块批量落地
首个完整业务模块批次落地,涵盖 7 个平台模块的领域逻辑、持久化适配器和契约接口。
- 审计模块 — 实现审计分表路由和定期保留清理功能(6 类审计分片,Quartz 定时清理)。
- 通知模块 — 实现通知平台核心功能(多渠道通知发送)。
- 文件模块 — 实现文件资产上传、确认、下载授权和删除功能(S3 兼容存储)。
- 平台计费模块 — 初始化平台计费模块基础架构与核心服务。
- 工单模块 — 实现工单平台核心功能与接口。
- 聊天模块 — 实现聊天频道核心功能与相关持久化支持。
- Webhooks — 实现 Webhook 订阅和签名机制。
- 解决方案 — 添加完整 Visual Studio 解决方案文件(
.sln+.slnx)。
2026-06-17 — 项目初始化
BitzOrcas.Modern 项目创建,确立核心架构基线。
- 模块治理底座 — 实现
IAppModule契约、模块依赖图和启动校验功能。 - API Key 认证 — 添加 API Key 认证方案及集成测试覆盖。
- 雪花 ID — 支持雪花 ID 机器位和数据中心位配置,并集成 OpenTelemetry 追踪。
- 租户统一 — 统一租户 ID 类型为字符串,改进时区和审计逻辑。
- 代码风格 — 添加统一代码风格配置和 Git 配置文件。