docs: 完成 PikaOA 平台交付基线收口

docs/MDTODO/details/pikaoa-enterprise-platform/R1.5.2_Task_Report.md

@@ -0,0 +1,31 @@
+# R1.5.2 任务报告
+
+## 结论
+
+共享 observability 控制面已在同一 YAML-first 架构中加入 Prometheus。Prometheus 只作用于 `metricsBackend.targetIds` 选中的 target，OTel Collector 与 Tempo 继续承担 trace authority；指标故障和版本漂移只形成非阻塞 warning。
+
+## 变更
+
+- `config/platform-infra/observability.yaml` 拥有 Prometheus image、目标、存储、保留、端口、服务发现和查询预算。
+- NC01 渲染 ServiceAccount、RBAC、ConfigMap、PVC、Deployment 与 ClusterIP Service；D518/JD01 不渲染或访问 Prometheus。
+- `metrics-query` 提供受 YAML timeout、series 和 response bytes 预算约束的有界 PromQL 查询。
+- selector 使用严格 Kubernetes qualified name/value，渲染为锚定且转义的 RE2 字面量；label/annotation meta-label 统一规范化。
+- 显式 metrics path 优先，仅在 annotation 缺失时回退到 YAML `defaultPath`。
+- 未部署、未执行 confirm；真实 StorageClass、镜像拉取和 scrape target 留给 R1.6 受控 rollout 验证。
+
+## 验证
+
+- `bun test scripts/src/platform-infra-observability.test.ts`：8 pass，0 fail，100 assertions。
+- `platform-infra observability --help` 暴露 scoped `metrics-query`。
+- NC01 plan：`prometheus=enabled`，15 个对象。
+- D518/JD01 plan：`prometheus=disabled-for-target`，各 8 个对象，无 Prometheus manifest、status capture/probe 或远端 query。
+- 模块导入与 `git diff --check` 通过。
+
+## 交付
+
+- 实现 commit：`f516691a`。
+- target 隔离与发现规则纠偏：`ef3b5fde`。
+- selector 严格渲染纠偏：`c3762b31`。
+- 目标分支 merge commit：`2ee27b0c`。
+- 子 issue：[pikasTech/unidesk#1956](https://github.com/pikasTech/unidesk/issues/1956)。
+- Post-task 未建议新增 FEATURE/BUG issue。

docs/MDTODO/details/pikaoa-enterprise-platform/R1.5_Task_Report.md

@@ -0,0 +1,34 @@
+# R1.5 任务报告
+
+## 结论
+
+PikaOA 的 UniDesk 交付基线已完成 YAML-first 声明，并补齐可复用的 PaC bootstrap、PostgreSQL 紧凑 plan 和 NC01 Prometheus 控制面。全部变更仍处于源码与 dry-run 阶段，未执行首次 bootstrap、数据库 apply 或运行面部署。
+
+## Owning YAML
+
+- `config/pikaoa.yaml`：NC01 独立 namespace、Web/API/Worker、Secret、资源、探针、OTel/metrics 标注和 `https://oa.pikapython.com` PK01 公网暴露。
+- `config/platform-db/postgres-pk01.yaml`：host PostgreSQL 的 PikaOA role、database 与 Secret export。
+- `config/secrets-distribution.yaml`：管理员、普通员工和数据库连接的 `sourceRef`/`targetKey`。
+- `config/platform-infra/gitea.yaml` 与 `config/platform-infra/pipelines-as-code.yaml`：Gitea repository、PaC consumer、Tekton/GitOps/Argo 首发基线。
+- `config/platform-infra/observability.yaml`：共享 OTel/Tempo/Prometheus 与 NC01 target 隔离。
+
+## 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；指标故障不阻塞业务。
+
+## 验证与交付
+
+- 交付基线：`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`。
+
+## 未完成边界
+
+- `pikaInc/pikaoa` 仍因组织建仓权限缺失而不存在，R1.2 保持阻塞。
+- 首次 bootstrap、自动 source PR delivery、NC01 rollout、PK01 PostgreSQL apply、OTel/Prometheus 运行面与公网入口验收属于 R1.6-R1.7。

docs/MDTODO/pikaoa-enterprise-platform.md

@@ -29,14 +29,14 @@
 
 在 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)。
 
 #### R1.5.1 [completed]
 
 改进 PaC bootstrap 的新服务首发预检、分阶段紧凑输出、typed failure 与中文说明，保持 PR merge 唯一交付 authority，执行记录见 [pikasTech/unidesk#1955](https://github.com/pikasTech/unidesk/issues/1955)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.5.1_Task_Report.md)。
-#### R1.5.2 [in_progress]
+#### R1.5.2 [completed]
 
 扩展 NC01 共享 observability，使 OTel/Tempo 与 Prometheus 由同一 YAML-first 控制面管理并提供跨 namespace 指标抓取和有界查询，执行记录见 [pikasTech/unidesk#1956](https://github.com/pikasTech/unidesk/issues/1956)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.5.2_Task_Report.md)。
 #### R1.5.3 [completed]