From d8e9a6b366a4a17810c2b9d5ac03869652d5c48e Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 14 Jul 2026 18:19:19 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=94=B6=E5=8F=A3=20PikaOA=20=E4=BC=99?= =?UTF-8?q?=E4=BC=B4=E4=B8=8E=E9=99=84=E4=BB=B6=E6=A8=A1=E5=9D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../R1.3.5_Task_Report.md | 19 +++++++++++++++++++ .../R1.3.6_Task_Report.md | 19 +++++++++++++++++++ docs/MDTODO/pikaoa-enterprise-platform.md | 4 ++-- 3 files changed, 40 insertions(+), 2 deletions(-) create mode 100644 docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.5_Task_Report.md create mode 100644 docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.6_Task_Report.md diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.5_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.5_Task_Report.md new file mode 100644 index 00000000..b47e4123 --- /dev/null +++ b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.5_Task_Report.md @@ -0,0 +1,19 @@ +# R1.3.5 任务报告 + +## 结果 + +统一业务伙伴与甲方分类主数据已合并到 `pikainc/pikaoa master`。伙伴、分类和联系人使用服务端 UUIDv7；伙伴与分类通过 typed ID 关联，合同、发票及后续模块只引用伙伴 ID。空业务伙伴 PATCH 返回 typed `invalid_argument`，不会刷新 `updatedAt` 或写入 store、audit、outbox。 + +## 交付 + +- Issue: [pikasTech/unidesk#1990](https://github.com/pikasTech/unidesk/issues/1990) +- PR: [pikainc/pikaoa#5](https://github.com/pikainc/pikaoa/pull/5) +- 合并方式: merge，未 squash + +## 验证 + +子代理在 NC01 完成伙伴/category PATCH 专项、一次性 PostgreSQL 全仓测试、`go vet ./...` 和 `make build`。主代理审核了 UUIDv7、平级关系、分类筛选、同事务审计/outbox 与空 PATCH 行为，未发现阻塞问题。 + +## 边界 + +未连接 PK01、未部署正式 namespace；真实专用测试集群集成验收由 R1.3.10 与 R1.5.7 接续。 diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.6_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.6_Task_Report.md new file mode 100644 index 00000000..9a06fcfe --- /dev/null +++ b/docs/MDTODO/details/pikaoa-enterprise-platform/R1.3.6_Task_Report.md @@ -0,0 +1,19 @@ +# R1.3.6 任务报告 + +## 结果 + +统一附件元数据、对象引用和可替换文件存储端口已合并到 `pikainc/pikaoa master`。附件和引用分别使用独立 UUIDv7，引用仅保存 `attachmentId`、`objectType` 与 `objectId`；元数据通过平级 `/api/v1/attachments/{id}` 读取，下载前重新校验字节数与 SHA-256。 + +## 交付 + +- Issue: [pikasTech/unidesk#1991](https://github.com/pikasTech/unidesk/issues/1991) +- PR: [pikainc/pikaoa#6](https://github.com/pikainc/pikaoa/pull/6) +- 合并方式: 在吸收伙伴 head 后使用 merge，未 squash + +## 验证 + +子代理在 NC01 完成附件、伙伴和 CLI 联合专项、一次性 PostgreSQL 全仓测试、`go vet ./...`、`make build` 与 `git diff --check`。主代理审核了平级资源、完整性、路径约束、授权入口以及事务内审计/outbox，未发现阻塞问题。 + +## 边界 + +未连接 PK01、未部署正式 namespace；对象存在性与跨模块一致性不作为首版阻塞门禁，专用测试集群集成验收由 R1.3.10 与 R1.5.7 接续。 diff --git a/docs/MDTODO/pikaoa-enterprise-platform.md b/docs/MDTODO/pikaoa-enterprise-platform.md index 641f5fb2..5915849c 100644 --- a/docs/MDTODO/pikaoa-enterprise-platform.md +++ b/docs/MDTODO/pikaoa-enterprise-platform.md @@ -37,11 +37,11 @@ #### 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.3.5 [in_progress] +#### R1.3.5 [completed] 实现统一业务伙伴、甲方分类、角色、联系人、标签、归档、筛选和 CLI；持久化 REST 资源使用 UUIDv7，伙伴与分类只通过 typed ID 关联，并将业务、审计、outbox 保持同事务，执行记录见 [pikasTech/unidesk#1990](https://github.com/pikasTech/unidesk/issues/1990)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.5_Task_Report.md)。 -#### R1.3.6 [in_progress] +#### R1.3.6 [completed] 实现统一附件元数据、对象引用、可替换存储端口、完整性校验、授权 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)。