Deep Module

用小接口隐藏大复杂度、提高 leverage 的模块设计目标。

#type / concept #status / growing #tech / dev #resource / software-architecture

[!info] related notes

所属 MOC: Modularization&Architecture MOC, Matt Pocock Skills MOC

前置概念: 项目分层架构

并列概念: Design It Twice

易混淆概念: 事件驱动架构

关系笔记: Matt Pocock Skills 的工程闭环

Deep Module

一句话定义

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

核心机制 / 工作原理

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

最小例子 / 最小场景

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

边界与易混淆点

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