docs: close PikaOA audit outbox task

This commit is contained in:
Codex
2026-07-14 06:03:23 +02:00
parent eb6614af11
commit 49e2c0bf26
2 changed files with 34 additions and 1 deletions
@@ -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 单副本。
+1 -1
View File
@@ -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