本页在构建时读取各页 frontmatter 的 lastUpdated，按日期倒序分组。改文档时只要改日期，不必再维护一份「更新了哪些页」的清单。
能力级、需要说明影响面和证据的变化，仍写入更新日志。本页只回答「最近动过哪些说明书」。
2026年9月23日
- 5 分钟极速起飞：Aspire 编排启动、数据持久化与首个认证请求掌握 BitzOrcas.Modern 开发起飞流程：使用 .NET Aspire AppHost 一键编排拉起全套微服务拓扑、配置数据卷持久化与受控重置、并通过 RSA-OAEP 加密端点完成首个认证登录请求。
- 编写集成测试与行为对齐：Testcontainers 容器化实战使用 Testcontainers 启动真实 SQL Server 2022 与 Redis 容器环境，为民商事案件立案切片编写全链路集成测试，并验证 EF Core 与 SqlSugar 双 ORM 的 100% 行为等价对齐。
- 不可篡改专业工时计费与审计追踪深入解析 BitzOrcas.Platform.Timekeeping 模块：律师与顾问工时记录、阶梯费率核算、开票锁定与防篡改审计链。
- 常见问题与排错手册：环境、端口、编译与运行时诊断汇总 BitzOrcas.Modern 开发与本地部署中最常见的故障场景：精准对齐真实端口矩阵（6881、6880、6800、1433）、SQL Server 连接诊断、Roslyn 生成器缓存清理与 HTTPS 证书修复。
- 从零创建业务模块：像搭积木一样交付高内聚领域遵循 BitzOrcas.Modern 模块化单体标准，从零构建法务合同管理模块（LegalContract）：划分 Contracts/Domain/Application 物理工程边界、实现 IAppModule 治理元数据、继承 TenantAggregateRoot 统一聚合根，并通过 ArchUnitNET 架构测试建立不可逾越的依赖守护红线。
- 代码安装与本地配置：容器基础设施与数据库初始化掌握 BitzOrcas.Modern 本地工程环境初始化：从镜像摘要锁定的 Docker Compose 基础设施拉起，到环境变量分层注入与 --init-schema 幂等建库与种子填充。
- 多 ORM 双引擎架构与选型矩阵深入解析 BitzOrcas.Modern 多持久化引擎架构：SqlSugar、EF Core、Dapper 与 Mongo 的职责边界、选型矩阵与双引擎并存规范。
- 法律专业费率与利息计算引擎深入解析 BitzOrcas.Platform.LegalCalculators 模块：诉讼费分段累退精算、财产保全费、执行加倍利息与 LPR 浮动基准计算引擎。
- 复杂法律文书结构化模板与流式生成深入解析 BitzOrcas.Platform.Documents 模块：合同协议结构化模板定义、变量动态排版替换、PDF 流式生成与防伪水印嵌入。
- 构建第一个垂直切片：律所案件立案与建档实战通过真实的民商事案件立案场景，掌握 BitzOrcas.Modern 垂直切片架构：继承 TenantAggregateRoot 统一聚合根、[BitzTable] 元数据、[GenerateEndpoint] 路由装配、IAuthorizedRequest 声明式鉴权与 ICommandRepository 数据落盘。
- 教程导览：从零到一掌握 BitzOrcas.Modern 企业级实战BitzOrcas.Modern 官方进阶实战通关地图。通过 6 个循序渐进的工业级真实业务场景（案件立案、合同模块、利冲校验、合伙人审批流、实时通知与集成测试），系统掌握 .NET 10 模块化单体开发技能。
- 接入实时通知能力：Server-Sent Events (SSE) 高性能流式推送遵循“持久化优先，推送第二”的架构铁律，使用 Server-Sent Events (SSE) 实现律所立案审批待办、利冲预警的高性能流式长连接推送与前端断线重连。
- 开发环境与前置依赖：跨平台工具链安装与验证跨平台开发环境标准化搭建：.NET 10 SDK、C# 14 与 Native AOT 编译工具链、Node.js 22 LTS、Corepack (Yarn 4)、Docker 容器引擎与 IDE 生产力套件配置。
- 开发指南：从切片开发到生产运维的核心实战手册BitzOrcas.Modern 核心开发指南目录：涵盖垂直切片编写、前端元数据充水、功能与模块新增、六边形适配器扩展、本地 Aspire 基础设施与代客模拟沙箱。
- 快速开始：BitzOrcas.Modern 研发上手指南BitzOrcas.Modern 开发者上手总览：从架构哲学认知、前置依赖审查、Docker 容器基础设施拉起，到执行首个多租户垂直切片业务用例。
- 律所案件立案与利益冲突：多租户四阶动态业务校验实战深度结合法律科技实战，以律所案件立案（Matter Intake）与利益冲突审查（Conflict of Interest Check）为核心用例，带你掌握从基础参数校验、组合级联风控到无代码动态策略的完整落地。
- 律政协同连接器与外部法务云集成深入解析 BitzOrcas.Platform.LegalConnectors 模块：法院司法公文同步、诉讼裁判文书检索、律所业务系统对齐与断路器保护。
- 模块生命周期与 Modularity 引擎深度剖析 BitzOrcas.Modularity 编译期模块装配引擎：模块依赖图拓扑排序、ConfigureServices 与 UseModule 生命周期回调。
- 配置第一条审批工作流：重大案件合伙人联签实战使用 BitzOrcas.Modern 自研轻量级 DAG 状态机工作流引擎，为律所重大案件（标的额 5000 万以上）配置包含条件分支网关、合伙人联签与不可篡改审计时间线的审批流。
- 企业架构十大反模式与避坑宝典资深全栈架构师视角的生产避坑指南：剖析异步死锁、跨模块穿透、租户隔离泄露、分表时钟漂移等 10 大典型违规反模式与防御方案。
- 认识 BitzOrcas.Modern：设计哲学、架构拓扑与执行管道深入解析 BitzOrcas.Modern 企业级架构全景：从单体与微服务的权衡痛点出发，掌握垂直切片、10 级应用执行管道、双 ORM 编译期生成与跨模块契约协作边界。
- 实战：本地基础设施与 .NET Aspire 编排环境深入掌握 BitzOrcas.Modern 本地开发环境编排：使用 .NET Aspire AppHost 一键拉起 SQL Server 2022、Redis 7 与 MinIO 容器、真实端口映射矩阵、数据卷持久化配置与零停机数据库架构重置。
- 实战：编写六边形架构基础设施适配器（Adapter）掌握 BitzOrcas.Modern 六边形端口与适配器模式：在领域层定义依赖倒置窄端口（Port）、在基础设施层编写生产适配器（Adapter）、封装第三方网络异常、配置 Polly 弹性策略与注册 Fallback 安全回退。
- 实战：从零新增一个独立业务模块（Module）掌握在 BitzOrcas.Modern 中新增独立深模块的完整工程规范：规划 Contracts/Domain/Application 物理工程划分、继承 TenantAggregateRoot 领域聚合根、配置 IAppModule 架构治理元数据与编写 ArchUnit 架构守卫防线。
- 实战：框架版本升级指南与变更迁移手册BitzOrcas.Modern 框架版本平滑升级指南：NuGet 包依赖集中版本锁定（CPM）、Roslyn 增量生成器缓存清理、数据库架构平滑迁移、前端 Yarn 依赖对齐与全仓架构门禁验收。
- 实战：平台代客操作模拟（Operator Impersonation）与安全审计掌握 BitzOrcas.Modern 平台运维代客模拟机制：签发短效双身份 JWT 令牌、DelegatedSessionRestrictionPipelineBehavior 敏感操作阻断守卫与不可篡改操作员双身份审计追踪。
- 实战：前后端集成与元数据自动充水（Hydration）深入掌握 BitzOrcas.Modern 前后端集成范式：OpenAPI 零手写 TypeScript SDK 自动生成、IReadModelMetaMapped 页级元数据投影、10 级管道第 10 级字典与关联实体充水与 React 19 最佳实践。
- 实战：如何编写一个写操作切片（Command Slice）遵循“一用例一文件”原则，从零编写一个企业级写操作垂直切片：包含 Minimal API 路由契约、RBAC 动作鉴权、IRequestRule 纯函数校验规则、ICommandRepository 窄端口恢复与领域聚合根状态流转。
- 实战：声明式种子数据填充（Seed Data）与幂等初始化掌握 BitzOrcas.Modern 种子数据初始化规范：实现 ISeedStep 契约、分层环境门禁（Global / Tenant / Demo / ProductionSafe）、依赖 DAG 拓扑解析与基于 --init-schema 的幂等自动化播种。
- 实战：为现有业务模块新增一个完整 Feature掌握在 BitzOrcas.Modern 既有业务模块中新增功能的标准化 5 步流水线：扩展领域聚合根不变量、编写单文件命令切片、声明式配置端点与 RBAC 权限、使用 ICommandRepository 持久化与编写 Testcontainers 集成测试。
- 实战：新增一个后台管理页面（Dashboard Page）掌握在 BitzOrcas.Modern React 19 + TanStack Query 现代前端单体工程中新增管理页面的标准全流程：声明路由与菜单元数据、消费 OpenAPI 自动生成的强类型 TypeScript SDK、实现页级元数据自动充水表格与绑定 RBAC 细粒度权限看门狗。
- 实战：业务模块接入全局搜索与索引治理掌握业务模块接入 BitzOrcas.Modern 全局搜索的完整闭环：同事务发布增量索引事件、编写权威重建源、宿主来源目录配置、权威命中复核器与架构测试锁定，以及治理页全量对账与端到端验证。
- 实战：Bitz CLI 的 NuGet 双轨分发与发版运维手册Bitz CLI 工具链的双轨分发与发布管理实战指南：面向公网 NuGet.org 与企业云效私有制品源的双轨流水线、packageSourceMapping 防投毒隔离、离线本地包验证与自动化发版 CI/CD。
- 微信生态连接器与公众号企业微信集成深入解析 BitzOrcas.Platform.WeChat.Mp 模块：多租户微信公众号/企微配置隔离、带参二维码扫码登录、事件路由分发与模板消息下发。
- 预置演示账号与口令注入契约：零信任种子与多租户隔离深度解构 BitzOrcas.Modern 预置种子账号体系：Fail-Closed 环境变量口令注入契约、RSA-OAEP 传输加密防重放、以及多租户 404 防资源探测隔离机制。
- 智能体多租户安全与治理规范深度剖析 BitzOrcas.Modern 中 MCP 智能体的多租户强隔离、动态可见性过滤、Rate Limiting 限流与高危操作人机审核 (HITL) 治理架构。
- AI 与 MCP 智能体开发深入解析 BitzOrcas.Modern 原生 AI-Native 架构：基于 Model Context Protocol (MCP) 与编译期代码生成，将企业垂直切片无缝转变为智能体工具。
- Cursor 与 Claude Desktop 本地实时接入手把手实操指南：配置 Cursor 与 Claude Desktop 连接 BitzOrcas.Modern 本地 MCP 传输端点，实现智能体对话式调度后端业务切片。
- Dapper 只读连接池与极限查询优化实战指南：在 BitzOrcas.Modern 中使用 Dapper 与只读从库连接池，压榨复杂报表、全文大屏与高并发分页查询的极限吞吐。
- EF Core 同构集成与拦截器实战实战指南：在 BitzOrcas.Modern 中配置与使用 EF Core，深入 Audit 拦截器、PII 数据加密、全局租户过滤与 CAP 事务发件箱集成。
- GDPR 与个保法合规数据治理深入解析 BitzOrcas.Platform.Gdpr 模块：个人隐私数据主体访问请求 (SAR)、被遗忘权物理擦除、假名化脱敏与合规留痕管线。
- MCP 服务端架构与源生成器深入解析 BitzOrcas.Mcp 编译期源生成器机制、[GenerateMcpTool] 属性规范、JSON Schema 自动推导与 /mcp 端点注册。
- Profiles 多租户定制与元包发行机制深入解析 BitzOrcas.Modern 中 Profiles 元包架构：基于 Default.Business、Mini.Api、Portal 的场景化依赖聚合与商业按需交付。
- Sandbox 黄金样例全景拆解深入剖析模板内置 src/Modules/Sandbox 黄金参考样例：三层物理工程划分、CQRS 读写分离、适配器中立聚合根与窄端口读模型。
2026年9月12日
2026年9月8日
- 创建并运行 Consumer Solution以 default-business-multi 为连续案例，安装模板、生成项目、核对组合、恢复商业包、运行 Aspire 并验收业务起步切片。
- 解决方案模板故障排查按安装、生成、Feed、Restore、Build、Schema、运行拓扑、平台模块与 License 阶段诊断 bitzorcas-host。
- 解决方案模板与 Profile 选型解释 bitzorcas-host 的 15 个 coupled Profile、两种 ORM、三类基础拓扑、可选平台模块与行业扩展。
- 模板参数与 Profile 约束参考bitzorcas-host 1.0.0-alpha1 的公开参数、默认值、15 个 Profile、内部推导、输出选择和验证边界。
- 生成结果、Profile 与组合证据解剖原生模板生成的 Consumer Solution、Host 组合根、Business Starter、商业包闭包、manifest、plan 与所有权边界。
- CLI 与受控工具选择 Consumer Solution 模板、代码生成、Schema、Seed、Workflow 与数据库维护入口，并理解每个工具的写入面、权限和证据边界。
2026年9月3日
2026年9月2日
- 敏感操作再认证（Step-Up）登录 MFA 回答不了「还是你本人吗」。Step-Up 再认证为每个敏感操作单独校验身份：全局中间件唯一强制点、三层策略模型、六种因子复用既有验证内核。
- 外部技术规范引用清单平台实现与开发手册显式引用的外部规范总清单：ProblemDetails（RFC 9457）、HTTP QUERY（RFC 10008）、OAuth 令牌族、TOTP、CSV 等逐条给出标准链接、源码落点与采纳方式。
- 再认证灰度与运维AuditOnly 观察期先行再切强制的灰度顺序、阈值调优指引、Runbook 要点与三类典型故障的排查：Redis 不可用、版本键缺失告警、GrantPurposeMismatch 上升。
- 再认证快速接入把一个业务端点接入敏感操作再认证的三条路径：管理页零代码自建策略行、[RequireStepUp] 声明基线、资金类一次性票据；含每步验证点与预期失败修复。
- 再认证契约参考敏感操作再认证全部公开表面：十条端点、挑战与验证 JSON 契约、三类 403 ProblemDetails、18 个错误码、StepUpOptions 配置键与限流配额。逐项对照源码核验。
- 再认证前端接入第一方 SPA 的再认证协议实现：403 拦截重放守卫四条规则、验证对话框状态机、凭据仅内存红线与 SDK 用法。业务代码零感知。
2026年8月27日
- 部署、版本与回滚讲透定义快照、Checksum 幂等、Office/租户绑定、当前 Grayscale 语义、缓存失效、并发风险与发布 Runbook。
- 测试策略从单元测试到商业发布证据，理解 BitzOrcas 的五层测试体系，并按改动选择正确验证集。
- 持久化适配器职责三种适配器共享应用契约，但运行时职责并不相同。
- 持久化适配器组合SqlSugar 或 EF Core 负责写侧，Dapper 补充面向查询的读取。
- 垂直切片架构：以业务用例为核心的高内聚解耦深度剖析 BitzOrcas.Modern 垂直切片架构（Vertical Slice Architecture）：一用例一文件组织形式、10 级管道守门机制、统一聚合根持久化与彻底告别分层架构。
- 代码生成器用 bitz-codegen 的 business-slice 生产入口生成行业中立统一聚合切片，理解原子落位、BOCG 错误码族、manifest 证据字段，以及旧输入审计入口的失败关闭语义。
- 定义与设计工作流以当前 JSON DSL 讲解节点、连线、表达式、业务绑定、表单字段、参与人、多实例、定时器、监听器、校验与模拟边界。
- 独立嵌入 Workflow Engine在非 BitzOrcas Host 中组合工作流引擎，正确实现持久化、查询、权限、参与人、服务任务、通知、Timer、缓存与运维。
- 对象存储与 S3 兼容集成：IFileStorage 安全实操深度剖析 BitzOrcas.Modern 对象存储构建块，揭秘 IFileStorage 抽象、MinIO/AWS S3 生产适配器、客户端直传预签名 URL 与租户防越权隔离。
- 多级缓存与防击穿：FusionCache L1/L2 实战深度剖析 BitzOrcas.Modern 多级缓存体系，揭秘 FusionCache 内存 L1 + Redis L2 双层架构、CacheScope 租户隔离、负缓存防御与提交后精准标签失效。
- 多品牌、暗色与体验 ProfileDesign System 1.2 的 Mode、Brand、Density、Shell、Workspace 正交轴、无障碍覆写及持久化和租户边界。
- 多渠道消息投递构建块：从通知事实到外部扇出掌握 BitzOrcas.Modern 企业级消息投递架构，深入通知事实落盘与异步扇出解耦、邮件/短信/企微连接器与发送状态防丢失。
- 多租户架构深度剖析：8 步解析链、数据隔离与代客模拟沙箱深入解析 BitzOrcas.Modern 企业级多租户底层机制：8 步租户解析优先级链、双 ORM 自动化全局数据过滤（Global Query Filters）、跨租户防越权与操作员代客模拟安全沙箱。
- 分布式锁与租约防死锁：IDistributedLock 深度实操深入解析 BitzOrcas.Modern 分布式锁内核，揭秘 Redis 原子加锁与所有者校验释放、租约自动续期机制以及 Deny/Allow 降级防御策略。
- 告警 runbook具体的告警阈值、逐信号诊断 runbook 与监控系统接入矩阵。模板定义阈值；外部监控系统抓取 OTel 并触发告警。
- 工单（Tracker 工作项）生命周期TrackerItemStatus 六个状态的全部合法迁移，由 TrackerItemTransitionRules 编码。
- 工作流开发说明书从可视化设计器、定义 DSL、部署绑定、实例与任务，到通知、历史、迁移、嵌入和生产运维的源码校验导航。
- 核心构建块全景地图与设计哲学全景梳理 BitzOrcas.Modern 核心构建块武器库，从统一聚合根、QueryShape 列表查询内核、CAP Outbox 到多级缓存与 S3 存储。
- 集成测试区分 API Shell 与 Docker 合同，验证 ORM parity、迁移、消息、租户隔离和真实基础设施语义。
- 架构总览：BitzOrcas.Modern 设计哲学与技术全景全面解析 BitzOrcas.Modern 企业级架构体系：模块化单体物理边界、垂直切片架构、10 级执行管道、编译期零反射双 ORM 与 Native AOT 架构支点。
- 可视化流程设计器说明当前全页流程设计器的服务端 Schema、AOT 业务元数据、草稿修订、表单字段策略、模拟路径、版本作用域和权限边界。
- 框架构建块地图先按六组职责定位关注点，再选择具体项目或包。
- 扩展接入新增模块、适配器、后台作业或端点的产品化接入契约——能力 EXT-1 至 EXT-8、默认语义、强制运维可见性与固定验证块。
- 历史、归档与分析说明审批轨迹、实例与业务 Timeline、归档事务、报表计算、查询端口降级、精度缺口和运营验证。
- 领域实体与持久化例外统一聚合根是默认路径；独立持久化模型必须有明确的非对称理由。
- 命令与查询职责两类消息进入同一条生成式 Mediator 管线，再使用不同的状态端口。
- 模块化单体：物理工程隔离、契约边界与架构守护深入解析 BitzOrcas.Modern 模块化单体体系：Contracts/Domain/Application 物理工程划分、跨模块依赖 5 条铁律、IAppModule 编译期发现机制与 ArchUnit 架构门禁。
- 模块就绪矩阵当前 36 个 Platform 根的 Ready / Out-of-Scope 矩阵、ProductionDepth 口径，以及门禁生产持久化的全仓库闭环状态。
- 模块依赖边界调用方只依赖能力归属方 Contracts，具体适配器由宿主组合。
- 模块依赖分层协议从宿主进入，依赖始终指向领域与公开契约。
- 模块职责地图职责归属限界上下文；团队变化不应改变能力边界。
- 模块治理编译期 AppModule 类型化标记系统、当前 36 个标记与 36 份模块手册的不同口径、中央 legacy 边界，以及治理模块标识与依赖的账本棘轮。
- 配额与限流：Host 令牌桶与计费配额区分 Host 层 Redis 令牌桶限流与 PlatformBilling 计费配额两套机制：429 与超额的归属、QuotaService 检查、用量提交命令与幂等事实。
- 平台契约层@bitz/platform-sdk 是 Web 应用与 .NET 后端之间唯一被允许的桥梁——它独占 request pipeline、auth session、ProblemDetails 映射、权限/特性 gate 与 OpenAPI 生成契约。
- 迁移、指定节点发起与旧实例导入区分 StartAtNode 与 Import，讲解映射、预检、当前非事务/非幂等边界、批次恢复、申请人转交和验收 Runbook。
- 认证与授权凭据头先选择认证方案，再进入统一策略授权。
- 任务、候选人与待办查询深入说明 Assigned/Candidate UNION、DataScope、查询降级、分页性能、详情授权、已读幂等、候选刷新和缓存。
- 色彩与法律主题Design System 1.2 的中性表面、状态色、品牌语义和衡蓝、香槟金、章红、青律、暖橙五套法律主题。
- 审计类别、分表与保留期7 个逻辑类别映射到 6 组基表，并采用不同分表与保留策略。
- 生产就绪清单驱动的生产就绪模型——表面到清单的映射、遗留账本棘轮，以及在 Production/Staging 中失败关闭的适配器就绪守卫。
- 事件抽象层区分领域事件、集成事件与通知端口，并说明事件收集、主题解析和 Null 适配器的运行边界。
- 事件构建块CAP、RabbitMQ、SQL Server Outbox、主题契约、消费者幂等和失败运维的参考说明。
- 事务性事件投递业务状态与 CAP 发件箱同事务提交，再异步投递。
- 数据库初始化与迁移锁安全 --init-schema、/host/schema 审阅脚本与 Host-Admin 漂移通知如何配合。
- 数据库驱动后台作业与调度安全：Quartz 实操指南告别难以运维的外部 Cron！深入解析 BitzOrcas.Modern 数据库驱动后台作业体系，揭秘类型化 IJobExecutor 调度器无关设计、Quartz 持久化集群防并发堆积与 Operations 探针。
- 统一聚合根与持久化内核深度剖析 BitzOrcas.Modern 为什么抛弃传统的 Entity + Mapper + Aggregate 三件套，以及编译期 ORM Fluent Configuration Generator 如何实现零反射双 ORM 适配。
- 系统总览从运行宿主、平台上下文到框架服务与运行资源的全景视图。
- 现代 API 文档与零反射生成：OpenAPI 3.1 + Scalar告别沉重低效的 Swashbuckle 运行时反射！深入解析 BitzOrcas.Modern 编译期 OpenAPI 3.1 元数据提取与 Scalar 交互式现代 API 文档客户端。
- 限界上下文内部公开契约、领域规则、用例、适配器、端点与测试保持物理可见。
- 行业中立表面保持 Framework、通用 Profile 与 Host 无垂直行业属性的所有权规则、模板采纳契约，以及 AssignedLawyerId 到 AssignedOwnerId 的迁移。
- 性能基线与回归判断为构建门禁、API、数据库、消息和后台作业建立可重复的性能证据，正确区分现有耗时报告与待建设的运行时基准。
- 依赖注入与生命周期：编译期装配与服务治理规范详解 BitzOrcas.Modern 依赖注入体系：阶段性装配顺序、服务生命周期划分准则（Scoped / Singleton / Transient）、Roslyn 静态注册与 Native AOT 零反射注入。
- 依赖注入组合生成式注册、失败关闭默认实现与具体适配器组成一棵可审查的树。
- 应用壳层与工作区Design System 1.2 的 Side/Top Shell、导航所有权、磁吸 Local Tabs、全局工具与 Single Route/Managed Tabs 语义。
- 预期失败与非预期异常业务失败保持为 Result 数据，只有真正的意外故障进入异常处理器。
- 运行测试按改动风险选择单元、架构、无 Docker、Docker、模板、包消费和完整验收入口，并保留可复现证据。
- 运行工作流实例深入说明发起、完成、驳回、撤回、重提、交接、控制、多实例、事务、并发、回调和定时器失败语义。
- 运行宿主栈边缘路由、API 组合、任务、编排、服务默认与资源各自成层。
- 治理让一次 BitzOrcas 发布具备可交付性的质量门禁、生产就绪棘轮、扩展接入、模块治理、就绪矩阵与行业中立规则。
- 质量门禁verify-all 流程、CI 矩阵、测试分层、API 状态码契约、数据一致性测试矩阵、AOT/反射/T-SQL 门禁，以及门禁一次 BitzOrcas 合并的模板完成定义。
- 租户解析优先级八个有序步骤解析 TenantId；单租户模式仍然写入租户键。
- API 启动顺序先注册生成式默认实现，再接入具体适配器并执行就绪门禁。
- CAP 发件箱发布时序先提交，再投递，最后在消费边界确认或重试。
- CI/CD 与质量门禁理解 BitzOrcas 当前的 GitHub Actions 流水线、测试分层、Consumer 合同与商业 GA 门禁。
- Commercial GA 门禁准备 BitzOrcas 正式商业发布所需的 Feed、签名、provenance、SBOM、策略证据和外部 Consumer。
- Consumer 合同测试用隔离 Feed 和仓库外项目验证 BitzOrcas 包闭包、模板边界、Generator 资产与 Release 发布。
- GA 切换 runbook把一次 BitzOrcas 发布提升到 GA 的运维 runbook——切换前门禁、配置与密钥、迁移顺序、健康检查、运维验证、Webhook 演练、流量切换、回滚与切换后记录。
- Host 组合与运行拓扑：API、Gateway、JobHost 与 Aspire 编排深入解析 BitzOrcas.Modern 的宿主组合架构：API Host、YARP Gateway、JobHost 物理职责划分、ServiceDefaults 共享基底与 .NET Aspire 本地编排拓扑。
- HTTP 请求生命周期从可信代理信息到端点分派的完整中间件顺序。
- Identity 前端BitzOrcas Web Identity 完整使用与开发参考：登录（RSA 密码密文）、验证码、MFA、密码、邀请准入、用户授权、组织、应用凭据与租户治理。
- Mediator 行为顺序十四个已注册行为严格按组合根中的顺序执行。
- Source Generator 与 Native AOT：零反射编译期代码生成深入解析 BitzOrcas.Modern 编译期代码生成体系：Minimal API 端点生成器、双 ORM Fluent 静态映射器、JSON 序列化生成器与 .NET 10 Native AOT 极致性能实践。
- Web 与 API 基础设施构建块：Minimal API 与管线装配深入解析 BitzOrcas.Modern 的 Web 与 HTTP API 基础设施底座，掌握 [GenerateEndpoint] 编译期 Minimal API 绑定、ASP.NET Core 中间件拓扑与 RFC 9457 Problem Details 规范。
- Workflow 架构与核心概念深入解释工作流内核分层、聚焦端口、执行模型、命令/查询存储、事务并发、缓存、租户和宿主组合。
- Workflow 通知 Pipeline讲解事件分发、接收人、默认模板、偏好、平台通知适配、JobHost 接线、事务性失败语义与外部投递对账。
- Workflow HTTP API 参考按 Definition、Runtime、Task、History、Report、Management 分组说明当前手写与生成路由、授权、限流、超时和错误语义。
2026年8月26日
- 纯函数式入站校验：IRequestRule 与防腐设计告别低效脆弱的业务异常！深入解析 BitzOrcas.Modern 纯函数式前置校验体系，掌握 IRequestRule 规则声明、ValidationPipelineBehavior 管道拦截与结构化错误码映射。
- 多租户与分布式限流：RateLimiter 策略与防刷掌握 BitzOrcas.Modern 企业级高并发限流体系，深入 ASP.NET Core RateLimiter 算法（滑动窗口/令牌桶）、多租户配额动态隔离与 Redis 分布式防护。
- 接口幂等去重与快速重放：Idempotency-Key 实践深入解析 BitzOrcas.Modern 接口幂等性内核，掌握 Idempotency-Key 声明、Redis/DB 双层去重存储、并发请求互斥锁定与历史响应原样重放。
- 领域错误模型与枚举定义：Error 与 Result 规范告别混乱的未捕获异常！深入解析 BitzOrcas.Modern 领域错误定义哲学，掌握 ErrorType 分类、结构化 Error 工厂与 ErrorCatalog 编译期代码生成。
- 全局异常拦截与 RFC 9457 统一错误响应掌握 BitzOrcas.Modern 企业级错误处理体系，深入 Result 业务流控、GlobalExceptionHandler 兜底拦截与 RFC 9457 Problem Details 标准映射。
- 全链路可观测性与结构化审计：OpenTelemetry 与 Activity掌握 BitzOrcas.Modern 企业级可观测性底座，深入 OpenTelemetry 分布式链路追踪（Tracing）、指标监控（Metrics）与结构化业务审计日志落盘。
- 数据脱敏与隐私保护：IDataMasker 与安全合规掌握 BitzOrcas.Modern 企业级数据脱敏体系，深入手机号、身份证、邮箱与银行卡掩码算法、[Masked] 契约特性与审计日志自动防泄密。
- 细粒度资源与动作授权：IAuthorizedRequest 实践告别粗糙混乱的 Role 角色硬编码！深入解析 BitzOrcas.Modern 基于资源与动作（Resource-Action）的细粒度授权引擎，掌握 IAuthorizedRequest 声明与动态决策。
- 现代多租户认证体系：JWT、API Key 与上下文注入深入解析 BitzOrcas.Modern 企业级认证架构，掌握 ClaimsPrincipal 解析、API Key 高速验签、ICurrentUser 与 ICurrentTenant 统一上下文注入。
- Auditing 合规审计模块架构概览：不可篡改事实与多引擎冷热分层深入解析 BitzOrcas.Modern 结构化合规审计体系，掌握 SysAuditRecord 审计实体、异步管道自动采集、SQL/Mongo 冷热分层存储与 GDPR 数据保留治理。
- Billing 模块架构概览：多租户订阅计费与资损防范深入解析 BitzOrcas.Modern 订阅计费与资损控制体系，掌握 Subscription 订阅聚合、原子配额扣减（Quota）、发票生成与支付回调安全防重。
- Catalog 模块架构概览：多租户商品与服务目录体系深入解析 BitzOrcas.Modern Catalog 目录体系，掌握服务规格（OfferingAggregate）、SKU 属性集、阶梯定价与多版本发布管理。
- Chat 即时通讯模块架构概览：WebSocket、Redis 广播与消息持久化深入解析 BitzOrcas.Modern 即时通讯体系，掌握 ChatSession 会话聚合、WebSocket/SignalR 长连接、Redis Pub/Sub 跨节点广播与离线消息同步。
- Identity 模块架构概览：多租户身份中心与统一认证底座深入解析 BitzOrcas.Modern 核心身份体系（Identity Module），掌握统一用户聚合根、多租户隶属关系模型、双因子认证与企业级单点登录（SSO/OIDC）。
- Ticketing 工单模块架构概览：多租户协作、SLA 履约与事件驱动深入解析 BitzOrcas.Modern 企业级工单协作体系，掌握 TicketAggregate 聚合根、SLA 升级告警状态机、工单流转与工单只读投影。
- Webhooks 开放平台架构概览：事件订阅、HMAC 验签与指数退避重试深入解析 BitzOrcas.Modern Webhooks 开放平台体系，掌握 WebhookSubscription 订阅聚合、HMAC-SHA256 签名加密、死信队列（DLQ）与指数退避重试调度。
- Workflow 工作流引擎架构概览：DAG 状态机与分布式任务调度深入解析 BitzOrcas.Modern 自研轻量级工作流引擎内核，掌握流程图（WorkflowDefinition）、运行时实例（WorkflowInstance）、活动节点（Activity）与人工审批流。
窗口之外、仍带日期的页面
- 1Panel Linux 开发预览部署在已安装 1Panel、OpenResty、SQL Server、Redis、RabbitMQ、MinIO 与 AgileConfig 的 Linux 服务器上部署 BitzOrcas 开发预览环境，含打包、发版、数据库初始化模式（schema-only/platform-seed/full-seed）与登录排障。
- 1Panel OpenResty 单机蓝绿在 1Panel OpenResty 反代站点上用 named upstream 做单机蓝绿切流，避免把 upstream 写进 server 上下文或写死 8082 端口。
- 部署形态选择在 systemd 单机、docker-compose 和 Kubernetes 三条发布路径之间做出选择，并理解三 Host 的迁移、启动与回滚顺序。
- 更新日志记录影响开发者、适配器作者和商业交付方的主要能力与文档变化。
- 文档维护与事实校准用源码、测试和交付证据维护中英双语开发说明书，避免路径、模块、能力和发布语义再次漂移。
- 项目治理与版本信息查阅代码提交约定、文档维护方式、版本记录和后续投资方向。
- 在线许可证签发与分发配置厂商许可证控制面、独立签名宿主与 Azure KMS/HSM，通过前端完成四眼审批、异步签发、下载、分发和吊销。
- Aspire 本地编排使用 BitzOrcas.AppHost 编排 SQL Server、RabbitMQ、Redis、MinIO、schema 初始化器、LicenseSigner、API、JobHost 和 Vite 前端。
- BitzSaury 迁移 MCP 服务构建并配置 3 个 BitzSaury 迁移 MCP Server，按需检索底座契约、旧系统代码与迁移 PRD。
- Schema Maintenance检测声明 metadata 与 SQL Server 实际 schema 的漂移，生成或应用分级迁移，并离线校验 owner-local Seed CSV。
维护约定
- 中英文同路径页面一起改，两边的
lastUpdated写成同一天； - 只改错别字或链接也要更新日期，否则读者看不到这次校准；
- 不要把本页写成手写条目；窗口天数由构建逻辑固定为 30 天。
和更新日志怎么分工
漏改日期等于这次校准对读者不可见。能力说明写进更新日志时，仍要给相关页面加日期，两边才会同时出现。