Merge pull request #2049 from pikasTech/docs/pikaoa-frontend-parallel
docs: 允许 PikaOA 前后端并行开发
This commit is contained in:
Lyon
@@ -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]
|
||||
|
||||
|
||||
@@ -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 扩展性验收
|
||||
|
||||
|
||||
Reference in New Issue
Block a user