docs: 完成 PikaOA 合同版本验收

2026-07-15 19:14:02 +02:00
parent 7f4d297cf3
commit e9360bd589
2 changed files with 30 additions and 1 deletions
@@ -0,0 +1,29 @@
+# R1.3.7 合同与合同版本任务报告
+
+## 交付
+
+- 实现 Issue：`pikasTech/unidesk#1992`
+- 产品 PR：`pikainc/pikaoa#8`（已合并）
+- 真实验收 Target：`NC01:/root/pikaoa/.worktree/r137-contract-closeout`
+- 验收基线：`a781ca8d446589d69ab1f35c671921c4a112ee3b`
+- 产品入口：`https://oa-dev.hwpod.com`
+
+## CLI 验收
+
+通过产品 `pikaoa` CLI 完成管理员登录、甲方分类与伙伴准备、合同创建、第二版本创建、当前版本、版本列表、版本独立读取和组合筛选。
+
+验证结果：
+
+- 合同与每个合同版本均使用不同的 UUIDv7 全局资源 ID。
+- 第二版本通过 `contractId` 与 `previousVersionId` 关联，合同通过 `currentVersionId` 指向当前版本。
+- 历史版本保持可独立读取，版本号和内容哈希关系一致。
+- JSON 输出是单文档并包含有界 `requestId`、`traceId`；文本输出有界；typed failure 返回非零退出码。
+- Target worktree 保持干净，本轮无需新增产品代码或 PR。
+
+## 衍生问题
+
+公网 `/healthz` 与 `/readyz` 的 CLI 兼容缺口已统一登记为 `pikainc/pikaoa#34`，归属 `R1.3.11`，不阻塞合同 `/api/v1/*` 主路径完成。
+
+## 安全边界
+
+验收未输出密码、token、Secret 或数据库连接串，未直接访问 PK01，未修改 UniDesk/PaC/Tekton/Argo 或任何 CI/CD 基础设施。
@@ -45,7 +45,7 @@

 实现统一附件元数据、对象引用、可替换存储端口、完整性校验、授权 API 和 CLI；附件使用 UUIDv7 平级资源身份，业务对象仅通过 typed ID 关联，执行记录见 [pikasTech/unidesk#1991](https://github.com/pikasTech/unidesk/issues/1991)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.6_Task_Report.md)。

-#### R1.3.7 [in_progress]
+#### R1.3.7 [completed]

 实现合同与合同版本平级 UUIDv7 REST 资源，通过 contractId、previousVersionId、currentVersionId 建立 ID 关系，保证版本不可变、并发序号唯一、附件关联和全量 CLI，执行记录见 [pikasTech/unidesk#1992](https://github.com/pikasTech/unidesk/issues/1992)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.7_Task_Report.md)。
 #### R1.3.8 [completed]