diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.4_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.4_Task_Report.md new file mode 100644 index 00000000..35ed0d56 --- /dev/null +++ b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.4_Task_Report.md @@ -0,0 +1,33 @@ +# R1.3.4 任务报告 + +## 交付结果 + +- 产品 PR [pikainc/pikaoa#4](https://github.com/pikainc/pikaoa/pull/4) 已受控合并到 `master@e1b570188cf39c7cf5e1210b0a477aabe7fd5fb3`。 +- 通过共享 `transaction.Executor` 实现业务写入、append-only 审计和 PostgreSQL outbox 同事务提交或回滚。 +- outbox 提供 `SKIP LOCKED` 有界 claim、成功、重试、失败和处理中断恢复;Watermill handler registry 以事件 ID 为稳定幂等键。 +- Worker 暴露纯 liveness `/healthz`、typed readiness `/readyz` 和 Prometheus `/metrics`,处理链写入 OTel span,并保持低基数标签。 +- handler 原始错误不进入 `last_error`、日志、trace、metric 或返回值,仅保留稳定 `FailureCode`;Secret 输出保持 `valuesPrinted=false`。 + +## 主代理审核纠偏 + +- 补齐失败信息脱敏,真实 PostgreSQL 测试覆盖包含 password、token 和 secret 的 handler error,确认不泄漏。 +- 增加 database、migration、outbox 的 typed readiness 投影,保持 liveness 与依赖健康分离。 + +## 验证 + +- `go test -race ./internal/outbox ./internal/worker` +- `go test ./...` +- `go vet ./...` +- `make build` +- 隔离 PostgreSQL 16 集成测试验证事务回滚、提交后 claim、失败恢复、再次 claim 和 processed 终态。 +- PR preflight 为 `MERGEABLE/CLEAN`;仓库当前没有 status checks。 + +## 收口 + +- 原 Artificer 纠偏与 post-task command 均达到权威 `completed`。 +- `feat/r134-audit-outbox` 任务 worktree 和已吸收本地分支已清理。 +- 本任务按 issue 范围未部署、未连接 PK01;部署与公网验收留在后续 YAML-first/CI/CD 阶段。 + +## 残余风险 + +`RecoverProcessing` 会恢复全部 processing 事件,多 Worker 副本可能互相干扰。本阶段不新增租约或围栏,运行面在完成独立水平扩展规格前保持 Worker 单副本。 diff --git a/docs/MDTODO/pikaoa-enterprise-platform.md b/docs/MDTODO/pikaoa-enterprise-platform.md index e106b07d..8e3fc65b 100644 --- a/docs/MDTODO/pikaoa-enterprise-platform.md +++ b/docs/MDTODO/pikaoa-enterprise-platform.md @@ -34,7 +34,7 @@ #### R1.3.3 [in_progress] 实现员工身份、Casbin RBAC、会话与 CLI login/logout/whoami/employees/roles,使用 YAML Secret 投影初始管理员和员工,执行记录见 [pikasTech/unidesk#1984](https://github.com/pikasTech/unidesk/issues/1984),完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.3_Task_Report.md)。 -#### R1.3.4 [in_progress] +#### R1.3.4 [completed] 实现 pgx 同事务审计、PostgreSQL outbox、Watermill handler pipeline、幂等 Worker 与 OTel/Prometheus,执行记录见 [pikasTech/unidesk#1985](https://github.com/pikasTech/unidesk/issues/1985),完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.4_Task_Report.md)。 ### R1.4