contracts：控制平面 / 租户开通 API 契约（OpenAPI）

[JIAQIA]

背景

控制平面 / 租户开通的接口契约（ICD）。设计见 docs/00-主仓初始化-spec.md §2 与架构 05-多租户与控制平面 §4 开通时序。

任务清单（DoD）

• 控制平面对外 API（OpenAPI）：租户注册 / 审批 / 开通状态 / 生命周期（停用·恢复·注销）/ 配额查询
• 租户目录数据模型 + 状态机：registered → approving → provisioning → active → suspended → deleted
• 与 Keycloak Organizations / Helm 开通的交互边界说明（仅契约，不含实现）
• 承接 governance 供数契约：将 contracts/governance-metadata-icd.md 草案细化为 openapi/ + 事件 schema（供数 API + 元数据变更事件）
• （可选）codegen：由 OpenAPI/proto 生成各语言 client/server stub，支撑子仓独立对接、独立构建
• 占位脱敏（tenant-demo / acme），示例不含任何真实信息

约束

• 🔴 红线见 CLAUDE.md。

DoD

OpenAPI 通过 lint（如 spectral）；作为评审基线，子仓据此对接。