CAD World 测试约定
分层策略
- 单元测试放在源码旁的
__tests__,只验证单模块规则。 - 集成测试统一放在
tests/integration,验证真实模块协作。 - E2E 放在
tests/e2e,只覆盖高价值用户闭环。 - 当前阶段不做组件测试,避免把业务规则重复写成高维护成本的 UI 断言。
命名规范
- 单元测试:
*.unit.spec.ts - 集成测试:
*.integration.spec.ts - E2E:
*.e2e.spec.ts - 依赖 DOM 的 Vitest 文件使用
*.dom.spec.ts
目录约定
tests/factories/:构造合法业务对象,避免手写复杂字面量。tests/fakes/:端口替身与轻量可运行实现。tests/helpers/:断言、fixture 读取、语义归一化工具。tests/fixtures/:导入导出样例、golden 文本、稳定测试数据。
编写原则
- 优先断言业务行为和不变量,不断言私有实现细节。
- 优先用真实 domain/application 代码,少用
vi.mock()。 - 复杂对象必须优先使用 factory,不要在测试里拼大型 JSON/对象图。
- 导入导出优先使用语义比较;只有 canonical 文本才允许 golden 比较。
- 新增测试必须回答一个明确风险问题,例如“命令是否可对称 undo/redo”。
Review Checklist
- 测试是否放在正确层级,而不是跨层重复覆盖。
- 是否使用了已有 factory / fake / helper,而不是手写对象。
- 是否断言外部行为,而不是耦合内部实现。
- 是否避免了随机时间、随机 ID、真实网络、真实浏览器副作用。
- 若更新 golden/fixture,是否说明了语义变化而非仅刷新输出。