docs: 收口 PikaOA 数据库 CLI 可见性

2026-07-13 22:28:37 +02:00
parent 34f1f93391
commit 42e23345cd
3 changed files with 37 additions and 14 deletions
@@ -0,0 +1,24 @@
+# R1.5.4 任务报告
+
+## 结论
+
+已修复 `platform-db postgres status` 与 `export-secrets` 默认输出截断，并将默认投影改为按配置规模有界的计数、异常/待处理预览与 omitted 摘要。confirmed export 明确区分 `before`、`action`、`after`，不会把写入前 presence 当成写入后事实。
+
+## 交付
+
+- 子 issue：pikasTech/unidesk#1958。
+- PR：pikasTech/unidesk#1960。
+- merge commit：`34f1f9339168b518ca1f706cc7bc44880924171d`。
+- 变更：`scripts/src/platform-db.ts`、`docs/reference/cli.md`。
+
+## 验证
+
+- 真实配置：status 4264 bytes，export dry-run 2679 bytes，plan 9589 bytes，均未截断。
+- 扩展规模：48 个 role/database/Secret、50 个 export 时，status 7589 bytes，export 5624 bytes。
+- confirmed fixture：首次 `before=false/false` 到 `after=true/true`；二次 confirmed 无 actionable 项。
+- 相关测试：8 pass、0 fail。
+- 合并后的原 CLI 复测准确显示 PikaOA role/database/export 缺失，`mutation=false`、`valuesPrinted=false`。
+
+## 边界
+
+未执行 PostgreSQL apply、Secret sync、PaC bootstrap 或运行面修改。Artificer post-task 评论为 issue #1958 comment 4962360252；未发现需要扩展本轮范围的问题。
@@ -2,7 +2,7 @@

 ## 结论

-PikaOA 的 UniDesk 交付基线已完成 YAML-first 声明，并补齐可复用的 PaC bootstrap、PostgreSQL 紧凑 plan 和 NC01 Prometheus 控制面。全部变更仍处于源码与 dry-run 阶段，未执行首次 bootstrap、数据库 apply 或运行面部署。
+PikaOA 的 UniDesk 交付基线已完成 YAML-first 声明，并补齐可复用的 PaC bootstrap、PostgreSQL 紧凑 plan/status/export 和 NC01 Prometheus 控制面。全部变更仍处于源码、只读 plan/status 与 dry-run 阶段，未执行首次 bootstrap、数据库 apply 或运行面部署。

 ## Owning YAML

@@ -14,21 +14,20 @@ PikaOA 的 UniDesk 交付基线已完成 YAML-first 声明，并补齐可复用

 ## CLI 与工具改进

- PaC bootstrap 现在提供 YAML 精确匹配、effective credential、GitHub 上游预检、分阶段 typed 状态和唯一下一步。
- 未执行阶段显示 `skipped`，外部建仓阻塞不再误报内部阶段失败。
- `platform-db postgres plan` 默认输出保持在预算内，并显示 PikaOA role、database 和 redacted Secret/export 摘要。
- `platform-infra observability` 增加 target-scoped Prometheus plan/status/query；指标故障不阻塞业务。
+- PaC bootstrap 提供 YAML 精确匹配、effective credential、GitHub 上游预检、分阶段 typed 状态、skipped 阶段和唯一下一步。
+- `platform-db postgres plan/status/export-secrets` 默认输出按配置规模保持有界，披露 PikaOA role/database、Secret/export presence/fingerprint、mutation、typed failure 和完整下钻。
+- confirmed export 区分写入前、动作与写入后事实。
+- `platform-infra observability` 提供 target-scoped Prometheus plan/status/query；指标故障不阻塞业务。

 ## 验证与交付

- 交付基线：`9b6921ad`。
- PostgreSQL plan：`88eb8fdb`，8 tests 通过，默认输出 9,589 bytes。
- Bootstrap：`697b6933`、`1a04b029`、`e808b298`，19 项定向测试通过。
- Prometheus：`f516691a`、`ef3b5fde`、`c3762b31`，8 tests / 100 assertions 通过。
- 平台分支当前 merge commit：`2ee27b0c`。
- PikaOA bootstrap dry-run 为 `mutation=false`，准确阻塞于 `github-repository-not-found-or-no-access`。
+- PaC bootstrap 定向测试 19 项通过，PikaOA dry-run 为 `mutation=false`，准确阻塞于 GitHub repository 不存在或无权限。
+- Prometheus 8 tests、100 assertions 通过；NC01 enabled，其他 target disabled-for-target。
+- PostgreSQL status 4264 bytes、export dry-run 2679 bytes；扩大到 48 个 role/database/Secret 和 50 个 export 后仍低于预算；相关测试 8 pass。
+- 平台分支当前 merge commit：`34f1f9339168b518ca1f706cc7bc44880924171d`。

 ## 未完成边界

 - `pikaInc/pikaoa` 仍因组织建仓权限缺失而不存在，R1.2 保持阻塞。
- 首次 bootstrap、自动 source PR delivery、NC01 rollout、PK01 PostgreSQL apply、OTel/Prometheus 运行面与公网入口验收属于 R1.6-R1.7。
+- PK01 PostgreSQL role/database 尚未 apply，PikaOA 本地 DATABASE_URL、session secret 与两个初始账号密码尚未 materialize/sync。
+- 首次 bootstrap、正常 source PR 自动交付、NC01 rollout、OTel/Prometheus 运行面与公网入口验收属于 R1.6-R1.7。
@@ -29,7 +29,7 @@

 在 R1.3 CLI 后端验收通过后实现 HWLAB v0.3 同族 Vue 工作台、响应式页面与同路径业务流，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.4_Task_Report.md)。

-### R1.5 [in_progress]
+### R1.5 [completed]

 在 UniDesk 中声明 PK01 PostgreSQL、Secret、NC01 独立 namespace、Gitea/PaC、GitOps、OTel/Prometheus 和 PK01 公网暴露，并改进可复用 bootstrap 工具，依赖 R1.1-R1.2，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.5_Task_Report.md)。

@@ -42,7 +42,7 @@
 #### R1.5.3 [completed]

 修复 `platform-db postgres plan` 默认 30KB JSON 被输出预算截断的可见性缺陷，提供数据库、角色、Secret/export、检查与下一步的紧凑 CLI-first 投影，执行记录沿用 [主 issue](https://github.com/pikasTech/unidesk/issues/1952)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.5.3_Task_Report.md)。
-#### R1.5.4 [in_progress]
+#### R1.5.4 [completed]

 修复 `platform-db postgres status` 与 `export-secrets --dry-run` 默认输出超预算截断，提供与 plan 同族的 Secret/export 有界投影并保持 valuesPrinted=false，执行记录见 [pikasTech/unidesk#1958](https://github.com/pikasTech/unidesk/issues/1958)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.5.4_Task_Report.md)。
 ### R1.6