M1 补充 · 契约结构性对齐：TenantView/注册体 ↔ control-plane-v1（需 webui 协同）

[JIAQIA]

M1 补充项（follow-up）· 父 epic #3「入口级交付」已完成，本项为入口级之外的结构性对齐。

背景

WP3/#7 已对齐路由键名（tenantKey→tenantId，请求/响应双侧）与 status 小写（@JsonValue）。但 TenantView/注册体与契约 control-plane-v1 仍存结构性漂移，需与 webui 消费方协同后按「先改契约」对齐（已登记于本仓 CLAUDE.md known-drift）。

待对齐项（impl → 契约 openapi/control-plane-v1）

1. 嵌套结构：契约 Tenant 嵌套 organization{orgId,orgAlias} / dataPlane{namespace,dbSchema,dorisCatalog,helmRelease}；impl 为扁平 keycloakOrgId/namespace/dbSchema。
2. quota 字段名：impl maxDataBytes/maxJobs vs 契约 maxStorageGi/maxConcurrentJobs(+compute)。
3. impl 专有字段：id/deliveryMode/adminEmail/statusReason 不在契约 Tenant。
4. 注册体：impl deliveryMode/quota vs 契约 requestedQuota（且无 deliveryMode）。
5. 另两条 known-drift：审批端点形态（impl /approve+/reject vs 契约单 POST /{id}/approval，action: approve|reject）；/api 前缀约定未写进契约/网关（推定网关 strip /api，需补一条约定）。

铁律 / 范围

• 先改契约（主仓 HashMatrixData/hashmatrix contracts/openapi/control-plane-v1）→ 再改实现；消费方一律 tolerant reader。
• 跨仓：control-plane（impl）+ 主仓 contracts + webui（consumer，需协同）。本 issue 为 control-plane 侧追踪锚点，契约/ webui 侧各自建对应 issue、文本回链。

验收

• 契约先行更新（或确认现契约即目标态）。
• TenantView/RegisterTenantRequest 结构与契约 Tenant/注册体一致（嵌套 + quota 字段名 + 专有字段处置）。
• webui 对接无字段错配。
• 审批端点形态 + /api 前缀两条 known-drift 有结论并落档；CLAUDE.md known-drift 清账。

[JIAQIA]

✅ 已对齐并合入 main（直接提交）

根因：非缺陷，而是契约↔实现的结构性漂移——契约 control-plane-v1 早已是目标态（嵌套结构、requestedQuota、单 /approval、GiB），是实现未追平。按「先改契约、消费方 tolerant reader」铁律把实现追平契约，并补齐契约两处加法/文档缺口。

四项决策均对齐契约：

1. 单租户端点 {id}(UUID) → {tenantId}(路由键)，内部 UUID 不出对外边界。
2. deliveryMode 上收为部署级配置（delivery-mode，默认 PRIVATE），出注册体/视图。
3. 配额 bytes → GiB（maxStorageGi/maxConcurrentJobs+compute），新增 Flyway V2 迁移。
4. 审批合并为单 POST /{tenantId}/approval，reject→deleted（终态、reason 必填；修原 reject→registered 隐性非法流转）。

验收对照：

• 契约先行（control-plane-v1 v1.1.0→v1.2.0，多数项原即目标态，仅加 statusReason + /api 约定 + 同步 approve 注记）。
• TenantView/RegisterTenantRequest 结构与契约 Tenant/注册体一致（嵌套 + quota 字段名 + 专有字段处置）。
• webui 字段对接：cross-ask 协同 hashmatrix-webui#17（列全部 wire diff 待消费方吸收）。
• 审批端点形态 + /api 前缀两条 known-drift 有结论并落档；CLAUDE.md known-drift 三条清账。

质量门：mvn test 62 通过（含 3 Testcontainers PostgreSQL 集成）；code-reviewer 子代理 [APPROVE] 零阻塞，已落地建议 W1（reject web 回归）/W2（专用 InvalidApprovalRequestException→400）/W3（契约同步 approve 注记）。

提交：

• control-plane 2db8621（main）
• 主仓 contracts 15ac6ee（main）

后续（非本 issue）：webui 侧对接 Issue 待 hashmatrix-webui#17 讨论有结论后落单；dorisCatalog/helmRelease 待真实开通编排回写后补全（当前 M1 留 null，tolerant reader 容忍）。