# Map · 客户域 H2 测试 schema 收敛（customer-h2-schema）

- **来源:** /improve-codebase-architecture 2026-09-06 报告候选 #2（`.scratch/architecture-review-20260906-102629.html`），经 grilling 六决策拍板后单票实施。

## Notes

- 缺陷事实：12 个 H2 集成测试类各自手搓同构自举 + 内联 DDL（16 表并集）；`CustomerWorkspaceSavedViewIntegrationTest` 的 customer 表是 30 列精简旧版（缺 22 列，含 D-05 的 `is_biz_negotiated`），靠 MyBatis-Plus NOT_NULL insert 策略静默假绿。
- 实施收口：新增 `CustomerH2Schema`（16 表单一事实源，340 行）+ `CustomerH2Harness`（组合式静态工厂，96 行）+ `CustomerH2SchemaConsistencyTest`（实体↔DDL 双向对账，73 行）；12 类迁移净 -1484 行；`mvn -pl crm-customer -am test` 15 类 165 跑全绿；BOM 719 文件 clean。
- SavedView 类迁到 52 列全量 schema 后无任何用例转红——历史假绿定性为「测不到」（列不在场），非「测错」（无语义依赖）。
- 环境注记：跑 crm-customer 测试必须带 `-am`（本地仓库 crm-rule 快照过旧；候选 #1 已记录）。

## Decisions-so-far

1. **一次票全清**（不分批）：12 处改动同构机械、零语义变化，164 跑回归网现成。→ [issues/01](issues/01-consolidate-h2-schema.md)
2. **载体 = Java 常量类**（拒 `schema.sql`）：全工程零 `src/test/resources` / 零 `.sql` 先例；历史物理形态即 `List<String>` 常量，收敛零新机制；`schema.sql` 要手写语句分割器（新浅模块）。→ [issues/01](issues/01-consolidate-h2-schema.md)
3. **harness 形态 = 组合式静态工厂**（拒基类 / 自定义 Extension）：JUnit 5 static `@BeforeAll` 无多态，`@TestInstance(PER_CLASS)` 与自定义 Extension 全工程零先例。interface = `bootstrap(dbName, mappers...)` 一方法 + `dataSourceOf(factory)` 便捷方法。→ [issues/01](issues/01-consolidate-h2-schema.md)
4. **跨域表全收 16 张**（含 opportunity / opportunity_customer / user_saved_view 投影）：生产 SQL 已跨域 join，DDL 收敛是事实投影非新耦合；同步警示挂在 schema 常量跨域段。→ [issues/01](issues/01-consolidate-h2-schema.md)
5. **对账看守**：`CustomerH2SchemaConsistencyTest` 对 customer 主表做实体（含 BaseEntity）↔ DDL 严格双向列集断言——「实体加列漏改 schema」从半夜 Unknown column 变成对账红。先只对主表（D-05 教训所在地），子表 15 张暂不做。→ [issues/01](issues/01-consolidate-h2-schema.md)
6. **收尾载体**：CONTEXT.md 补「H2 测试 schema」词条 + 六决策理由写进 `CustomerH2Schema` / `CustomerH2Harness` 类 javadoc，不新开 ADR（模块内部实现纪律）。→ [issues/01](issues/01-consolidate-h2-schema.md)

## Fog

无未决问题。报告候选 #3（crm-rule 6 同构 Initializer，`@Order` 撞号 14×2、12×2）/ #4（crm-preference 三同构偏好栈）仍为开放候选，未出票。opportunity 侧 `OpportunityBoardIntegrationTest` 有 1 份内联 DDL（单份无重复，rule of three 未触发）——若未来 opportunity 测试增多可参照本 effort 的 harness 形态。