From 7cb6831ae22b9abf08795636ee711952652733a6 Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 14 Jul 2026 19:45:30 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=20PikaOA=20=E6=B5=8B?= =?UTF-8?q?=E8=AF=95=E8=BF=90=E8=A1=8C=E9=9D=A2=E5=AE=A1=E6=A0=B8=E8=AF=81?= =?UTF-8?q?=E6=8D=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../pikaoa-enterprise-platform/R1.5.8_Task_Report.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5.8_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5.8_Task_Report.md index 8632fed0..fb7afe6f 100644 --- a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5.8_Task_Report.md +++ b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5.8_Task_Report.md @@ -9,6 +9,7 @@ - owning YAML：`config/fixtures/pikaoa-test-target.yaml#testRuntime.targets.TEST01` 声明附件 PVC、迁移镜像、Job 名称、重试和产品 CLI 命令。 - renderer：`scripts/src/pikaoa-test-target.ts` 只读取并校验 YAML 形状，渲染 PVC、迁移 Job、API 挂载和三阶段启动脚本。 - 可见性：`plan` 显示附件与迁移的脱敏摘要；PostgreSQL、迁移 apply/wait 和业务 rollout 分别返回具名失败码。 +- 审核纠偏：迁移命令未显示 `migrate up` 时返回 `migration-command-unrecognized blocking=false`，不再由 parser 阻塞；fixture 的有效命令保持不变。 - 文档：`docs/reference/pikaoa.md` 记录附件存储归属和迁移先于业务 workload 的长期契约。 - 产品静态核对：`/root/pikaoa/internal/config/config.go` 要求附件字段；`/root/pikaoa/internal/cli/root.go` 与 README 确认 `pikaoa migrate up --config ` 入口。 @@ -22,13 +23,15 @@ - `bun --check scripts/src/pikaoa-test-target.ts`：通过。 - `bun scripts/cli.ts check`：11/11 通过。 -- 默认 `pikaoa test-target plan --output json`：`configured=false`、`mutation=false`。 -- fixture `plan` 结构化断言：包含 `PersistentVolumeClaim`、`Job`、API/Worker `Deployment`，迁移阶段为 `after-postgres-before-workloads`，`validationOnly=true`、`mutation=false`、`valuesPrinted=false`，未出现 DSN 或 Secret 派生值。 +- 默认 `pikaoa test-target plan --output json`：`configured=false`、`mutation=false`、`valuesPrinted=false`。 +- fixture `plan` 结构化断言：包含 `PersistentVolumeClaim`、`Job`、API/Worker `Deployment`，迁移阶段为 `after-postgres-before-workloads`，`validationOnly=true`、`mutation=false`、`valuesPrinted=false`，未出现数据库 URL。 - fixture `status`：`remoteQueried=false`、`reason=validation-only-target`。 +- 非标准迁移命令只生成一个 `migration-command-unrecognized blocking=false` warning，命令仍返回 `ok=true`、`mutation=false`。 - `git diff --check`：通过。 ## 风险与边界 - fixture 只声明验证用 `registry.invalid` 镜像；真实专用测试 target 仍需由 owning YAML 指定可用镜像与 StorageClass。 +- 同一 instance 的失败或已完成 Job 不承担原地重跑契约；调试重试应使用新的临时 instance，或先通过受控 `stop` 删除精确归属 namespace。 - 未执行 `start/stop`，未连接集群，未修改产品仓、正式 namespace、CI/CD、GitOps 或公网暴露。 -- 实现 checkpoint：`03ca5ffe`。 +- 实现 checkpoint：`03ca5ffe`；审核纠偏 checkpoint：`0b6ad4ef`。