[!info] related notes

• 所属 MOC: Modularization&Architecture MOC, Matt Pocock Skills MOC
• 前置概念: 项目分层架构
• 并列概念: Design It Twice
• 易混淆概念: 事件驱动架构
• 关系笔记: Matt Pocock Skills 的工程闭环

Deep Module

一句话定义

接口保持小而稳定，但内部可以吸收大量复杂度的模块。

核心机制 / 工作原理

模块深度来自“隐藏了多少复杂度”与“对外暴露多少复杂度”的差值。接口越薄、内部封装越强，调用者负担越小。

最小例子 / 最小场景

一个 uploadFile() 接口把分片、重试、校验和状态追踪都藏在内部，比暴露十几个协调函数更深。

边界与易混淆点

• 深模块不是大模块；它追求的是高 leverage，不是文件行数
• 过度暴露配置、状态和流程，模块就会变浅