代码实现（Code Implementation）

代码实现 = 把 L2 的设计翻译为可编译、可执行、可读的代码。本 group 解决 L3 第一问："设计怎么变成代码？"

本 group 包含

文档	核心问题	V2 节点
Package Structure	代码如何分包/分层？	B3 分解
Convention	命名与代码风格规范？	B7 表达
Error Handling	错误如何处理/传播？	B4 抽象
Application vs Domain Service	应用服务 vs 领域服务？	B3 分解
Use Case Orchestration	用例如何编排？	B3 分解
Finite Automata	状态机在代码里怎么写？	控制论 §3.4
Time Delay	异步与时延在代码里？	控制论 §4.2
Discrete Control	离散事件控制？	控制论 §3.5

代码组织的 3 个原则

代码组织 = 3 个原则
  1. 按 BC 分包（不是按技术层）     → V2 B3 分解
  2. 业务概念优先命名（不是技术词）  → V2 B2 + B7
  3. 错误是值不是异常（Result 类型） → V2 B4 抽象

阅读顺序

package-structure (代码骨架)
    ↓
convention (命名与风格)
    ↓
error-handling (错误处理)
    ↓
application-vs-domain-service (服务分层)
    ↓
use-case-orchestration (用例编排)
    ↓
finite-automata / time-delay / discrete-control (控制论落地)

与其他 group 的关系

• 上游：L2 Architecture（架构 → 代码组织）
• 下游：03-testing（代码 → 测试）、04-deployment（代码 → 构建）

关键洞察

代码组织的核心不是"规范多"——是"让设计意图可见"——

• 看到 domain/ 知道这是 BC 的核心
• 看到 application/ 知道这是用例编排
• 看到 infrastructure/ 知道这是技术细节 代码目录本身就是一张架构图——好的目录结构不需要文档解释。

相关链接

• L2 Clean/Hexagonal——架构风格
• L3 Testing——代码测试
• V2 B3 分解——分包
• V2 B7 表达——命名