用途:Elegant Architecture 用于指导整洁架构设计,核心约束是任何文件不得超过 200 行代码,适用于启动新功能、重构超大文件或规划模块结构。
主要能力:提供一套从需求分析到测试的完整流程。先分析需求、估算各模块代码量、识别共享组件并梳理依赖;当估算行数超过 200 时,将文件转为带 index 的文件夹,按子功能拆分并抽取共享工具。要求先定义接口契约再实现,逐模块完成类型定义、核心逻辑、错误处理、测试,并核对行数。
设计模式:文档给出模块化目录结构、依赖注入(构造函数注入并在组合根装配)、工厂模式(按类型创建通知对象)、策略模式(可替换的定价算法)等示例。
文件拆分准则:文件超过 200 行立即拆分,超过 150 行规划拆分,出现 3 个以上职责按职责拆分,共享类型增多时抽到 types.ts,工具函数累积时抽到 utils.ts。命名约定包括 index.ts(公共导出)、types.ts、constants.ts、utils.ts、service.ts、repository.ts、validation.ts、errors.ts。
测试要求:只写真实测试,核心逻辑不使用 mock,优先使用真实实现(如真实测试数据库)验证实际行为。
检查清单:涵盖实现前(需求分析、代码量估算、结构设计、接口定义、依赖梳理)、实现中(每文件小于 200 行、单一职责、依赖注入、错误处理、无硬编码)、测试(真实实现、核心逻辑无 mock、覆盖边界、集成测试)与评审(架构文档、公共 API 清晰、无循环依赖、易扩展)。
需避免的反模式:上帝文件、测试全 mock、先编码后规划、模块紧耦合、硬编码配置、循环依赖、模块边界不清。
限制:资料未提供安装命令、平台支持、收费方式或具体工具集成信息,暂未提供。