实现案例（Implementation Cases）

实现案例目录 = 把代码组织 / 测试策略 / 部署流程 / 可观测性落到真实业务场景。 案例让"最佳实践"从抽象建议变成可学习的样板。

本目录包含什么

本目录收录端到端贯通的实现案例，按典型技术栈 / 业务场景分类：

1. Java + Spring Boot 实现 DDD 聚合——包结构 + Repository + 事务边界
2. Python + FastAPI 实现 Saga 编排——Outbox + 补偿 + 测试策略
3. Go 实现 CQRS + Event Sourcing——投影 + 状态机 + 集成测试
4. TypeScript + NestJS 实现六边形架构——Adapter + Port + 静态分析
5. 多语言多服务的契约测试——Pact + Consumer-Driven + CI 集成

案例的标准结构

每个案例按统一模板：

1. 技术栈背景（5 行）—— 语言/框架/数据库
2. 包结构（核心图）—— 为什么这样组织？
3. 关键代码（5-10 个片段）—— 聚合 / Saga / Repository
4. 测试策略（金字塔）—— 单元/集成/E2E 比例
5. CI/CD 流水线（核心步骤）—— 构建 / 测试 / 部署
6. 踩坑教训（3 条）—— 团队一开始会犯什么错？

与其他 group 的关系

• 上游：02-code / 03-testing / 04-deployment / 05-observability（案例是这些概念的真实演绎）
• 横向：L2 06-cases（设计案例）——实现案例接续设计案例
• 下游：L4-operation（实现 → 运营）

关键洞察

实现案例的价值不是"复制代码"——是"暴露每个决策的工程代价"—— "我们用了 Outbox 保证事件发布"——但增加了一致性复杂度 "我们用了六边形架构解耦"——但包结构变深，新人理解成本上升 看案例 = 看每个实现决策的得失。

相关链接

• L3 Code——代码组织
• L3 Testing——测试策略
• L2 设计案例——设计端
• V2 B4 抽象——抽象的代价