docs: close PikaOA module runtime task

2026-07-14 04:34:32 +02:00
parent c239b430a5
commit 9c78309a01
2 changed files with 23 additions and 1 deletions
@@ -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 并行实施。
@@ -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