Merge pull request #2328 from pikasTech/docs/57-pikaoa-closeout

docs: 收口 PikaOA development 恢复验收
2026-07-16 19:08:57 +08:00
parent 5634ad4110 9921065e2c
commit ffacdd67ef
7 changed files with 70 additions and 3 deletions
@@ -0,0 +1,9 @@
+# R4.1 任务报告
+
+PikaOA development initializer 原先作为 Argo `PreSync` Job 先于普通 Sync ConfigMap 执行，导致 Pod 因 `pikaoa-runtime-config` 不存在而 `FailedMount`。UniDesk PR #2290（merge commit `6cb1deba`）把该 consumer 私有 ConfigMap 调整为 initializer 之前的 PreSync wave，并保留可重复更新及 API/Worker 后续挂载语义。
+
+验证结果：
+
+- issue #2289 已关闭，renderer 定向测试和 `git diff --check` 通过。
+- 未修改共享 PaC、Tekton、Argo、public-edge，也未人工触发 PipelineRun、mirror 或 Argo 同步。
+- 后续 PikaOA development 自动链成功，Argo `Synced/Healthy`、runtime `1/1`，证明正式声明已在真实运行面生效。
@@ -0,0 +1,9 @@
+# R4.2 任务报告
+
+在 UniDesk #2289 合并后，PikaOA issue #53 使用受管 `source-artifact write` 从最新 owning YAML 与 renderer 重新生成 development `.tekton/pikaoa-dev-nc01-pac.yaml`，没有手工编辑生成内容，也没有触碰业务源码或公共 CI/CD。
+
+验证结果：
+
+- issue #53 已关闭，source-artifact consistency check 与 `git diff --check` 通过。
+- 后续产品 PR merge 成为唯一交付触发；最新 PipelineRun `pikaoa-dev-nc01-0ce3224c43a757b81d2389f41322ed59885d562d-9jhwd` 成功，耗时 194 秒。
+- GitOps revision `8ce80e300549...`、Argo `Synced/Healthy`、runtime `1/1`，受管制品已完成端到端自动交付。
@@ -0,0 +1,9 @@
+# R4.3 任务报告
+
+11.4 MB 合同 PDF 超过 PikaOA Web Nginx 默认 10 MB 上限，虽然后端 YAML 已允许 100 MB，公网入口仍返回 HTTP 413。UniDesk PR #2316（merge commit `62c0a91f`）从 `config/pikaoa.yaml#developmentRuntime.targets.NC01.runtime.attachment.maxBytes` 注入 `PIKAOA_MAX_UPLOAD_BYTES=104857600`；PikaOA PR #58（merge commit `0ce3224c43a757b81d2389f41322ed59885d562d`）让 Nginx 模板消费该值。
+
+验证结果：
+
+- UniDesk renderer 测试 3/3 通过，PikaOA `go test ./internal/verifyweb` 通过。
+- 自动 PipelineRun 成功，source artifact、provenance、runtime commit 与 digest 对齐。
+- 合同 PDF CLI import-preview 成功返回 30 页和非阻塞 `manual_review_required`；原 PDF 已作为附件按 typed ID 关联合同版本，HTTP 413 不再出现。
@@ -0,0 +1,5 @@
+# R4.4 任务报告
+
+PikaOA readiness 原先未限定 Goose 版本表 schema，NC01 host PostgreSQL 使用 `pikaoa.goose_db_version` 时会错误报告迁移未就绪。PikaOA PR #56 将查询限定到业务 schema，并由 development 自动链交付。
+
+验证结果：NC01 定向与全仓 Go 测试通过；撤销临时兼容 view 后，CLI `health --ready`、`metrics` 仍通过，`pikaoa_database_ready=1`、`pikaoa_migration_ready=1`，证明运行面已使用正式修复。
@@ -0,0 +1,10 @@
+# R4.5 任务报告
+
+UniDesk PR #2323（merge commit `5634ad4110a86527fd27728123ec522e1a8b3d01`）为受控 `web-probe product-smoke` 增加 YAML-first 的 PikaOA `admin-mvp` profile。认证使用同一 page 的 `ui-form-memory` 表单登录，保留 PikaOA 内存 Bearer 会话，不要求 cookie、不改变身份模型，也不新增第二认证路径；SelfMedia 继续使用既有 cookie 模式。
+
+验证结果：
+
+- 定向测试 10/10 通过，runner 生成脚本通过 Node ESM 语法检查。
+- NC01 公网 `oa-dev.hwpod.com` 以 1920x1080 视口完成登录、合同、发票和附件三页 SPA 导航，三页均通过，final URL 为 `/attachments`。
+- report SHA 为 `sha256:f2cf02ff38ec7d7f96b5b55a5131b84cd5e47985775255c66a9939e71b44837b`；screenshot SHA 为 `sha256:be3f6c427f6a51d2461ee8c4a11f0bba4fbdc4cac22311b875727a9919529c28`。
+- `cookiePresent=null`、`secretValuesPrinted=false`；未使用裸 Playwright，未修改公共 CI/CD。
@@ -0,0 +1,13 @@
+# R4 任务报告
+
+PikaOA development 自动交付与 `oa-dev.hwpod.com` 已恢复并完成 CLI-first、WebProbe、OTel 和 Prometheus 验收。修复范围覆盖 initializer PreSync 配置顺序、受管 source artifact、PDF 上传上限、PostgreSQL readiness schema 和 PikaOA 同页内存会话 Web smoke。
+
+最终证据：
+
+- 自动 PipelineRun `pikaoa-dev-nc01-0ce3224c43a757b81d2389f41322ed59885d562d-9jhwd` 成功，Argo `Synced/Healthy`，runtime `1/1`。
+- 公网 CLI `health --ready`、管理员 `whoami`、合同版本链、废弃发票和 typed ID 附件关联均通过。
+- 11.4 MB 合同 PDF 与电子发票 PDF 均完成 CLI preview 和附件关联；合同保留非阻塞人工校对 warning，发票字段自动提取成功。
+- WebProbe 在 1920x1080 下完成登录、合同、发票和附件三页验收，报告与截图 SHA 已记录在 R4.5。
+- OTel validation 通过；PikaOA 发票 preview trace 为 8 spans、0 errors；`pikaoa_database_ready` 与 `pikaoa_migration_ready` 均为 1。
+
+公共 PaC status 仍误报 `pac-registry-missing`，metrics CLI 仍有文本解析 warning；二者均不影响 PipelineRun、Argo、runtime、CLI 或 Web 用户入口，按要求保持 `blocking=false`，未修改公共 CI/CD。
@@ -214,14 +214,26 @@

 完成双仓审核合并、受控 Secret 同步与发布、CLI-first 覆盖报告、issue/MDTODO/post-task 和 worktree 清理，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R3.4_Task_Report.md)。

-## R4 [in_progress]
+## R4 [completed]

 收敛 PikaOA development 自动交付并恢复 `oa-dev.hwpod.com`，完成后继续 CLI-first、web-probe、OTel 与 Prometheus 验收，执行记录见 [pikasTech/unidesk#2274](https://github.com/pikasTech/unidesk/issues/2274)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R4_Task_Report.md)。

-### R4.1 [in_progress]
+### R4.1 [completed]

 修复 PikaOA initializer 的 PreSync ConfigMap 顺序，使配置在 initializer Job 前创建并可重复更新，保持 Secret 由 YAML-first 独立分发，执行记录见 [pikasTech/unidesk#2289](https://github.com/pikasTech/unidesk/issues/2289)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R4.1_Task_Report.md)。

-### R4.2 [in_progress]
+### R4.2 [completed]

 在 UniDesk #2289 合并后使用受管 source-artifact renderer 更新 PikaOA development `.tekton` 制品并通过一致性检查，执行记录见 [pikainc/pikaoa#53](https://github.com/pikainc/pikaoa/issues/53)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R4.2_Task_Report.md)。
+
+### R4.3 [completed]
+
+让 PikaOA Web PDF 上传上限由 YAML-first `attachment.maxBytes` 注入，修复 11.4 MB 合同 PDF 的 HTTP 413，执行记录见 [pikainc/pikaoa#57](https://github.com/pikainc/pikaoa/issues/57)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R4.3_Task_Report.md)。
+
+### R4.4 [completed]
+
+修复 PostgreSQL readiness 对 `pikaoa.goose_db_version` 的 schema 查询并由 [pikainc/pikaoa#56](https://github.com/pikainc/pikaoa/pull/56) 自动交付，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R4.4_Task_Report.md)。
+
+### R4.5 [completed]
+
+让 `web-probe product-smoke` 支持 PikaOA 同页内存会话登录并完成公网 Web 验收，执行记录见 [pikasTech/unidesk#2319](https://github.com/pikasTech/unidesk/issues/2319)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R4.5_Task_Report.md)。