diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.2_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.2_Task_Report.md new file mode 100644 index 00000000..3a54c2fe --- /dev/null +++ b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.2_Task_Report.md @@ -0,0 +1,22 @@ +# R1.3.2 任务报告 + +## 结果 + +- 已在 `pikainc/pikaoa#2` 建立并合并可插拔模块 HTTP 运行时,产品 `master` 合并提交为 `ebe70a3`。 +- foundation 路由已由模块自身注册;disabled 模块不启动、不挂载 HTTP、不发布导航。 +- 模块挂载路由受 descriptor 的 API BasePath 与 health Path 约束,未声明路由和路由冲突稳定失败。 +- PostgreSQL 使用 `otelpgx` 覆盖 query/transaction,并禁用连接详情、SQL 文本和参数属性。 +- migration readiness 改为只读比较数据库当前 goose version 与本构建嵌入迁移最新版本。 +- Prometheus 已覆盖 HTTP in-flight、Go runtime/process、pgx pool、数据库/迁移 readiness 和 Worker 基线;累计 pool 指标为 Counter,当前状态为 Gauge。 +- 共享 observability 暴露标准 `prometheus.Registerer`,业务模块可在不扩展中央 Metrics 结构体的情况下注册自有 collector。 + +## 验证 + +- NC01 目标 worktree:`go test ./...`、`go vet ./...`、`make build`、`git diff --check` 全部通过。 +- 真实 API 下 CLI `health`、`modules` 的 text/JSON 通过,`/metrics` 类型与 readiness 脱敏通过。 +- 受控 PR preflight:`MERGEABLE/CLEAN`,合并前无 blocker。 + +## 边界与后续 + +- 本任务未连接 PK01、未执行生产 migration、未部署;这些动作保留给 R1.6-R1.7。 +- 身份/RBAC 与审计/outbox 从本合并提交创建独立 worktree,并使用不同 migration version 并行实施。 diff --git a/docs/MDTODO/pikaoa-enterprise-platform.md b/docs/MDTODO/pikaoa-enterprise-platform.md index 6ae35896..76d98830 100644 --- a/docs/MDTODO/pikaoa-enterprise-platform.md +++ b/docs/MDTODO/pikaoa-enterprise-platform.md @@ -28,7 +28,7 @@ #### R1.3.1 [completed] 建立 Go API/Worker/CLI 企业模块共享内核、PostgreSQL 迁移与审计/outbox 端口、OTel/Prometheus 基线和 CLI health/modules 验收,执行记录见 [pikasTech/unidesk#1977](https://github.com/pikasTech/unidesk/issues/1977),完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.1_Task_Report.md)。 -#### R1.3.2 [in_progress] +#### R1.3.2 [completed] 采用 chi 建立可插拔模块 HTTP 运行时、disabled 模块关闭入口、示例模块扩展验收,并补齐 PostgreSQL OTel 与 HTTP/runtime/pool/migration Prometheus 基线,执行记录见 [pikasTech/unidesk#1983](https://github.com/pikasTech/unidesk/issues/1983),完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.2_Task_Report.md)。 #### R1.3.3