Codebase Design

设计 深度模块（deep modules）：一个小接口背后承载大量行为，放置在干净的 seam 处，通过该接口可测试。在设计和重构代码的任何地方，都使用这套语言和原则。目标是：对调用者而言是杠杆效应（leverage），对维护者而言是局部性（locality），对所有人而言是可测试性。

词汇表

精确使用以下术语 —— 不要替换为"组件"、"服务"、"API"或"边界"。使用一致的语言正是关键所在。

Module（模块） —— 任何具有接口和实现的东西。特意与规模无关：一个函数、类、包或跨层级切片。避免使用：单元、组件、服务。

Interface（接口） —— 调用者正确使用该模块所需知道的一切：类型签名，还包括不变性约束、顺序约束、错误模式、所需配置和性能特征。避免使用：API、签名（过于狭隘 —— 它们仅指类型层面的表面）。

Implementation（实现） —— 模块内部的内容，它的代码主体。与 Adapter（适配器） 不同：某个东西可以是一个小型适配器配大型实现（如 Postgres 仓库），也可以是一个大型适配器配小型实现（如内存中的假实现）。当讨论重点是 seam 时使用"adapter"；否则使用"implementation"。

Depth（深度） —— 接口处的杠杆效应：调用者（或测试）每学习一个单位的接口就能调用的行为量。当一个模块在小型接口背后承载了大量行为时，它是 深的（deep）；当接口几乎和实现一样复杂时，它是 浅的（shallow）。

Seam（接缝） （Michael Feathers） —— 可以在不修改某处的情况下改变行为的位置；模块接口所在的位置。seam 放在哪里本身就是一个设计决策，与它背后放什么不同。避免使用：边界（与 DDD 的限界上下文 overloaded）。

Adapter（适配器） —— 在 seam 处满足接口的具体实现。描述的是角色（它填充什么槽位），而非实质（内部是什么）。