diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5.2_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5.2_Task_Report.md new file mode 100644 index 00000000..d0938854 --- /dev/null +++ b/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。 diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.5_Task_Report.md new file mode 100644 index 00000000..c5d2f5ec --- /dev/null +++ b/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。 diff --git a/docs/MDTODO/pikaoa-enterprise-platform.md b/docs/MDTODO/pikaoa-enterprise-platform.md index ff0bb631..3bfeb400 100644 --- a/docs/MDTODO/pikaoa-enterprise-platform.md +++ b/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]