docs: 完成 PikaOA Temporal 运行合同报告

2026-07-17 06:15:24 +02:00
parent b843c1ed52
commit 910cf86ee2
2 changed files with 36 additions and 1 deletions
@@ -0,0 +1,35 @@
+# R6.5 任务报告
+
+## 结论
+
+PikaOA development/release owning YAML、Temporal 运行合同、独立 API/Worker/Web renderer 与 native 受控入口已完成。UniDesk PR #2436 只修改当前 consumer 的配置、renderer 和 typed probe，不部署、不触发 PipelineRun/Argo，也不修改公共 CI/CD 或 Temporal 基础设施。产品 `master` PR merge 仍是 development 自动交付的唯一触发。
+
+## 配置与运行合同
+
+- development/release 分别声明 Temporal serviceRef、逻辑 namespace、task queue、workflow ID、activity timeout、retry 和 continue-as-new。
+- 删除 `worker.interval` / ticker authority，Worker 只由 Temporal workflow/activity 驱动。
+- API、Worker、Web 分别声明 replicas、resources、ports、probe 与 metrics；Worker 无公网入口。
+- native API、Worker、Web HMR 分别声明 stateDir、logDir、command、pidFile、logFile 和 endpoint。
+- CLI `--over-api` endpoint 与 Web HMR proxy 由 owning YAML/产品 config 解析，不增加第二业务实现。
+- OTel endpoint 与 Prometheus API/Worker scrape path 保持 YAML-first；exporter 失败继续是 `blocking=false` warning。
+
+## 交付
+
+- Issue：[UniDesk #2421](https://github.com/pikasTech/unidesk/issues/2421)。
+- PR：[UniDesk #2436](https://github.com/pikasTech/unidesk/pull/2436)。
+- 主实现 commit：`02e70382b51cb265fc6a047832a78c9c137bdfa7`。
+- PDF typed probe 修正：`9abd86ff7b756371d03032843aa0ccd58f9a2e4b`。
+- native smoke / MDTODO 证据：`b843c1ed`。
+
+## 验证
+
+- renderer 与 product-smoke 定向测试：17 pass，0 fail。
+- PDF probe 返工定向测试：14 pass，0 fail。
+- `git diff --check`：通过。
+- 完整 native admin-mvp：`status=pass`、`ok=true`。
+- report SHA：`sha256:3249fc88f037ca790e0e19649e2ef08a8b7820b079dedf01a0e4dfc83c919bf3`。
+- 主截图 SHA：`sha256:843241c2a1105c66ca3f4fd61ad2d5f01c67d4187c62093643594f78c8b0e052`。
+
+## 边界与下一步
+
+`rollout=not-applicable`。R6.6 将产品 R6.2/R6.3 组合分支收敛为单一 PR；只有该产品 `master` PR merge 触发 PaC/GitOps 自动链，然后验收 development API/Worker/Web、部署态 CLI、Web、OTel 与 Prometheus。
@@ -285,7 +285,7 @@

 在 NC01 真实 host PostgreSQL/Temporal 上完成 local CLI、worker、native API `--over-api` 与 Web HMR smoke，执行 [PikaOA #81](https://github.com/pikainc/pikaoa/issues/81)，依赖 R6.2-R6.3，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R6.4_Task_Report.md)。

-### R6.5 [in_progress]
+### R6.5 [completed]

 更新 PikaOA owning YAML、API/worker 独立部署与 CI/CD 合同，只由产品 master PR merge 自动交付 development，执行 [UniDesk #2421](https://github.com/pikasTech/unidesk/issues/2421)，父 Issue [#2417](https://github.com/pikasTech/unidesk/issues/2417)，依赖 R6.4，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R6.5_Task_Report.md)。