欢迎来到 BitzOrcas.Modern 开发者实战教程!无论你是刚加入团队的新人,还是负责核心架构演进的技术专家,本系列教程都将通过真实的法律科技(LegalTech)业务用例,带你从“环境启动”逐步演进到“生产级模块交付”。
开发者渐进式成长通关流水线
核心通关任务矩阵
下表梳理了 6 大实战章节的业务背景、预期耗时与核心技术交付物:
| 关卡与章节 | 真实业务场景 | 核心技能与交付产物 | 预期耗时 | 推荐难度 |
|---|---|---|---|---|
| 第 1 关:构建第一个垂直切片 | 民商事案件立案 (CreateMatterIntakeCommand) | 掌握“一用例一文件”、10 级管道流水线、统一聚合根与编译期双 ORM 映射 | 15 分钟 | 入门 |
| 第 2 关:从零创建业务模块 | 法务合同管理模块 (BitzOrcas.Modules.LegalContract) | 拆解 Contracts、Domain、Application 物理边界,编写 ArchUnit 架构门禁 | 25 分钟 | 进阶 |
| 第 3 关:增加租户级验证规则 | 律所案件立案与利益冲突筛查 | 落地一阶基础规则、二阶组合级联策略与三阶统一信用代码无代码规则引擎 | 20 分钟 | 进阶 |
| 第 4 关:配置第一条审批工作流 | 5000 万以上重大案件合伙人联签 | 编写声明式工作流 DSL、配置条件分流网关、处理审批任务与审计时间线 | 20 分钟 | 进阶 |
| 第 5 关:接入实时通知能力 | 案件立案成功与审批待办推送 | 恪守“持久化优先,推送第二”铁律,实现 Server-Sent Events (SSE) 高并发端点 | 15 分钟 | 实用 |
| 第 6 关:为垂直切片编写集成测试 | 真实容器环境立案全链路回归 | 使用 Testcontainers 启动真实 SQL Server/Redis,验证 EF Core 与 SqlSugar 双 ORM 行为一致 | 20 分钟 | 生产必修 |
开始前的准备工作
在正式开始第一个垂直切片之前,请确保你已经完成了以下前置步骤:
- 前置环境就绪:已安装 .NET 10 SDK、Node.js 22 LTS 与 Docker,参见开发环境与前置依赖;
- 启动 AppHost 编排:通过
dotnet run --project src/Hosts/BitzOrcas.AppHost确认本地基础设施与 API Host 正常运行,参见5 分钟极速起飞; - 理解架构边界:了解 BitzOrcas 的模块单向依赖与 10 级管道机制,参见认识 BitzOrcas。
准备好了吗?点击下方链接,开始构建你的第一个垂直切片!
本章核心导航
- 01/06
构建第一个垂直切片:律所案件立案与建档实战
通过真实的民商事案件立案场景,掌握 BitzOrcas.Modern 垂直切片架构:继承 TenantAggregateRoot 统一聚合根、[BitzTable] 元数据、[GenerateEndpoint] 路由装配、IAuthorizedRequest 声明式鉴权与 ICommandRepository 数据落盘。
- 02/06
从零创建业务模块:像搭积木一样交付高内聚领域
遵循 BitzOrcas.Modern 模块化单体标准,从零构建法务合同管理模块(LegalContract):划分 Contracts/Domain/Application 物理工程边界、实现 IAppModule 治理元数据、继承 TenantAggregateRoot 统一聚合根,并通过 ArchUnitNET 架构测试建立不可逾越的依赖守护红线。
- 03/06
律所案件立案与利益冲突:多租户四阶动态业务校验实战
深度结合法律科技实战,以律所案件立案(Matter Intake)与利益冲突审查(Conflict of Interest Check)为核心用例,带你掌握从基础参数校验、组合级联风控到无代码动态策略的完整落地。
- 04/06
配置第一条审批工作流:重大案件合伙人联签实战
使用 BitzOrcas.Modern 自研轻量级 DAG 状态机工作流引擎,为律所重大案件(标的额 5000 万以上)配置包含条件分支网关、合伙人联签与不可篡改审计时间线的审批流。
- 05/06
接入实时通知能力:Server-Sent Events (SSE) 高性能流式推送
遵循“持久化优先,推送第二”的架构铁律,使用 Server-Sent Events (SSE) 实现律所立案审批待办、利冲预警的高性能流式长连接推送与前端断线重连。
- 06/06
编写集成测试与行为对齐:Testcontainers 容器化实战
使用 Testcontainers 启动真实 SQL Server 2022 与 Redis 容器环境,为民商事案件立案切片编写全链路集成测试,并验证 EF Core 与 SqlSugar 双 ORM 的 100% 行为等价对齐。