fix: 补齐 PikaOA 测试运行面启动链

docs/reference/pikaoa.md

@@ -39,6 +39,15 @@ bun scripts/cli.ts pikaoa test-target stop --target <id> --instance <run-id> --c
   - `delivery.targets.*.ci.namespace`。
 - 测试入口不得渲染或删除保护集合中的任何对象。
 - PostgreSQL 使用 namespace 内的临时存储，namespace 删除后测试数据随之清理。
+- 附件运行参数与 namespace 内的临时 PVC 来自 target YAML：
+  - `runtime.attachment.storageRoot` 和 `runtime.attachment.maxBytes` 直接写入严格 runtime YAML；
+  - PVC 名称、容量、StorageClass 和 access mode 只从同一 target 声明读取；
+  - API 挂载该 PVC，删除临时 namespace 时一并删除 PVC。
+- 空数据库启动固定分为三个受控阶段：
+  - 先渲染基础对象并等待 namespace 内 PostgreSQL 就绪；
+  - 再使用 `source.images.migration` 和 `migration.command` 运行产品内置 `pikaoa migrate up` Job；
+  - 迁移 Job 完成后才创建 API 和 Worker Deployment 并等待 rollout。
+- PostgreSQL、迁移 Job 或业务 Deployment 失败会返回具名失败码，不会静默进入下一阶段。
 - TTL 和清理策略来自 target YAML：
   - TTL 写入 namespace annotation；
   - 当前 `cleanup.mode=delete-namespace`，由显式 `stop` 执行；
@@ -58,7 +67,7 @@ bun scripts/cli.ts pikaoa test-target stop --target <id> --instance <run-id> --c
 
 `config/fixtures/pikaoa-test-target.yaml` 只用于本地验证：
 
-- 证明 namespace、选择器、工作负载和 Secret 引用的渲染结果；
+- 证明 namespace、选择器、附件 PVC、迁移 Job、工作负载和 Secret 引用的渲染结果；
 - 证明 TTL、OTel、Prometheus 和正式 namespace 保护；
 - fixture target 固定为 `validationOnly=true`，不得用于真实集群操作。