From c69323abad34914d42efc0e3d115aeb186efaaa2 Mon Sep 17 00:00:00 2001 From: Codex Date: Tue, 14 Jul 2026 18:01:48 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=81=E8=AE=B8=20PikaOA=20=E5=89=8D?= =?UTF-8?q?=E5=90=8E=E7=AB=AF=E5=B9=B6=E8=A1=8C=E5=BC=80=E5=8F=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/MDTODO/pikaoa-enterprise-platform.md | 4 ++-- .../PJ2026-03/specs/PJ2026-03-pikaoa.md | 16 ++++++++++------ 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/docs/MDTODO/pikaoa-enterprise-platform.md b/docs/MDTODO/pikaoa-enterprise-platform.md index 8084df2f..641f5fb2 100644 --- a/docs/MDTODO/pikaoa-enterprise-platform.md +++ b/docs/MDTODO/pikaoa-enterprise-platform.md @@ -57,9 +57,9 @@ #### R1.3.10 [in_progress] 增加可由 YAML-first 专用测试集群临时 Job 调用的统一 PostgreSQL 后端验证入口，明确披露 DSN presence 和 integration passed/skipped，去掉迁移测试对最新编号的共享硬编码，执行记录见 [pikainc/pikaoa#10](https://github.com/pikainc/pikaoa/issues/10)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.3.10_Task_Report.md)。 -### R1.4 +### R1.4 [in_progress] -在 R1.3 CLI 后端验收通过后实现 HWLAB v0.3 同族 Vue 工作台、响应式页面与同路径业务流，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.4_Task_Report.md)。 +前端与后端并行实现 HWLAB v0.3 同族 Vue 企业工作台、响应式页面、平级 UUIDv7 资源与同路径业务流；最终在 CLI 后端验收通过后，通过同一公开 HTTP API 完成 Web 等价集成验收，执行记录见 [pikainc/pikaoa#11](https://github.com/pikainc/pikaoa/issues/11)，完成任务后将详细报告写入[任务报告](./details/pikaoa-enterprise-platform/R1.4_Task_Report.md)。 ### R1.5 [in_progress] diff --git a/project-management/PJ2026-03/specs/PJ2026-03-pikaoa.md b/project-management/PJ2026-03/specs/PJ2026-03-pikaoa.md index 2858e184..8989bbb2 100644 --- a/project-management/PJ2026-03/specs/PJ2026-03-pikaoa.md +++ b/project-management/PJ2026-03/specs/PJ2026-03-pikaoa.md @@ -7,6 +7,7 @@ | v0.1 | 待本版本提交 | 2026-07-13 | 创建企业办公平台预期终态、模块架构和首批合同与发票能力规格。 | | v0.2 | 待本版本提交 | 2026-07-14 | 统一平级 REST 资源、UUIDv7 全局标识和仅通过 typed ID 建立对象关联的契约。 | | v0.3 | 待本版本提交 | 2026-07-14 | 将审计语义校验收敛为非阻塞 warning 和最小安全归一化，避免开发期复杂审计门禁阻塞业务。 | +| v0.4 | 待本版本提交 | 2026-07-14 | 允许 Web 与后端并行开发，最终以同一公开 HTTP API 和 CLI/Web 等价业务流完成集成验收。 | 修改历史只记录规格语义变更，不记录实现进度、阶段基线或一次性证据。 @@ -63,7 +64,8 @@ PikaOA 终态必须同时具备： - CLI-first 交付： - 每个后端业务用例先提供稳定 CLI 入口； - CLI 与 Web 复用同一 HTTP API、身份、权限和业务语义； - - 后端、数据库、审计和可观测性通过 CLI 原入口验收后，才实现对应前端工作流； + - Web 与后端可以依据已冻结的资源和 API 契约并行开发； + - 最终集成验收先以 CLI 证明后端业务语义，再由 Web 通过同一公开 HTTP API 重复等价业务流； - 自动化和人工排障不依赖浏览器才能完成核心业务闭环。 - 可扩展业务模块： - 每个模块拥有独立领域模型、应用服务、持久化迁移、权限声明、HTTP API 和前端路由； @@ -217,7 +219,8 @@ CLI 是后端业务的第一用户入口： - 默认输出适合人工扫描的紧凑文本，机器调用显式请求 JSON； - 长任务使用提交与短轮询，不保持无界阻塞连接； - 输出包含请求标识和 traceId，但不显示密码、token、完整数据库连接串或附件正文； -- 前端开发必须以对应 CLI 用例已经通过为前置。 +- Web 可以与 CLI 和后端并行开发，尚未完成的后端集成差异集中在 API client 适配层并形成非阻塞 warning； +- 对应业务能力只有在 CLI 后端验收通过，且 Web 通过同一公开 HTTP API 完成等价业务流后，才能完成最终验收。 业务 API 在首期采用模块化单体内核： @@ -443,9 +446,9 @@ Prometheus 必须覆盖： - 健康状态区分应用 ready、数据库 ready、迁移 ready、OTel exporter warning 和 metrics scrape 状态； - OTel export 超时或 trace backend 暂时不可用只输出 `warning=true`、`blocking=false`，不改变成功业务事务终态。 -### 6.11 PIKAOA-L0-REQ-011 CLI-first 业务验收 +### 6.11 PIKAOA-L0-REQ-011 CLI-first 集成验收 -每个后端业务能力必须先通过 `pikaoa` CLI 验收，再实现对应 Web 页面。CLI 必须调用同一公开 HTTP API、使用同一用户身份与权限，并覆盖员工、伙伴、合同版本、发票废弃、审计和模块枚举。 +每个后端业务能力必须通过 `pikaoa` CLI 验收。Web 可以依据已冻结的资源与 API 契约并行开发，但最终必须与 CLI 调用同一公开 HTTP API、使用同一用户身份与权限，并覆盖员工、伙伴、合同版本、发票废弃、审计和模块枚举的等价业务语义。 接受标准包括： @@ -453,7 +456,8 @@ Prometheus 必须覆盖： - 默认文本输出有界且非空，显式 JSON 输出为单一合法 JSON； - 业务失败返回稳定非零退出码和 typed error，不以 traceback 或空输出代替； - CLI 业务成功同时返回资源标识、requestId 和 traceId； -- 后端 CLI 验收未通过时，对应前端任务保持未开始。 +- 前后端开发不互设启动门禁；后端 CLI 尚未通过或 API 尚未收敛时，集成差异只能形成非阻塞 warning，不能宣称对应业务能力已经完成最终验收； +- 最终验收必须先证明 CLI 后端业务语义，再由 Web 通过同一公开 HTTP API 重复等价业务流并比对结果。 ### 6.12 PIKAOA-L0-REQ-012 非阻塞版本告警 @@ -482,7 +486,7 @@ Web、API、Worker 和 CI/CD 必须输出结构化日志、健康状态和 trace - 通过 CLI 创建关联合同 v2 的发票，确认合同、版本和甲方关系正确。 - 通过 CLI 标记发票废弃，确认原因和审计存在，默认有效汇总不包含该发票。 - 使用 CLI 普通员工账号确认允许的业务操作可用、管理员操作不可用。 -- 确认 CLI 后端验收通过后，再用 Web 重复同一业务主路径并比对结果。 +- Web 与后端可以并行实现；最终确认 CLI 后端验收通过后，再用 Web 通过同一公开 HTTP API 重复业务主路径并比对结果。 ### 8.2 扩展性验收