From 910cf86ee2f52d0ac76dd10c6ca85589e65572ee Mon Sep 17 00:00:00 2001 From: Codex Date: Fri, 17 Jul 2026 06:15:24 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E6=88=90=20PikaOA=20Temporal?= =?UTF-8?q?=20=E8=BF=90=E8=A1=8C=E5=90=88=E5=90=8C=E6=8A=A5=E5=91=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../R6.5_Task_Report.md | 35 +++++++++++++++++++ docs/MDTODO/pikaoa-enterprise-platform.md | 2 +- 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 docs/MDTODO/details/pikaoa-enterprise-platform/R6.5_Task_Report.md diff --git a/docs/MDTODO/details/pikaoa-enterprise-platform/R6.5_Task_Report.md b/docs/MDTODO/details/pikaoa-enterprise-platform/R6.5_Task_Report.md new file mode 100644 index 00000000..d1d7d24d --- /dev/null +++ b/docs/MDTODO/details/pikaoa-enterprise-platform/R6.5_Task_Report.md @@ -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。 diff --git a/docs/MDTODO/pikaoa-enterprise-platform.md b/docs/MDTODO/pikaoa-enterprise-platform.md index b97d7353..8338394c 100644 --- a/docs/MDTODO/pikaoa-enterprise-platform.md +++ b/docs/MDTODO/pikaoa-enterprise-platform.md @@ -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)。