codebase-design
codebase-design 是一套用于设计「深模块」的共享词汇与原则集合,强调用小型接口封装大量行为,并将接缝放在干净的位置、通过接口进行测试。它适用于用户需要设计或改进模块接口、寻找加深模块的机会、决定接缝位置等场景,目标是为调用方带来杠杆效应、为维护者带来局部性,并让所有人获得可测试性。它提供术语表(module、interface、implementation、depth、seam、adapter、leverage、locality)、深模块与浅模块的对比、设计接口时的自问清单、删除测试、接口即测试面、适配器与接缝的判断原则、面向可测试性的设计建议,以及模块与接口、接缝、适配器之间的关系说明,并明确拒绝以实现行数与接口行数之比衡量深度等框架。