feat: 定义 v1alpha1 API 合同

docs/specification.md

@@ -131,6 +131,12 @@ Tenant 的 `spec.instanceRef` 与 `metadata.name` 长度合计不得超过 241
 派生的 ExternalSecret/Secret 默认名称
 `<instanceRef>-<metadata.name>-postgresql` 不超过 Kubernetes 253 字符限制。
 
+固定默认值由 CRD defaulting 写入。依赖 `metadata.name` 或 `instanceRef` 的 database、
+login role、ExternalSecret/Secret 名称属于 controller 语义默认值：省略字段不会被 admission
+回写，controller 必须始终计算同一个 effective value，并通过 status 的 database、
+loginRole、credential reference 以及实际资源展示。
+v1alpha1 不为此引入 mutating webhook。
+
 database 和 role 名称必须作为 PostgreSQL identifier 参数安全引用，禁止通过字符串
 拼接执行。名称校验必须拒绝空字符串、NUL 和超过 PostgreSQL identifier 长度限制的
 值，并统一限制为小写字母、数字和下划线。