From b8fa107d24cd653592e014e6f50f625f43a212e3 Mon Sep 17 00:00:00 2001 From: liuyun Date: Sat, 10 Oct 2026 14:34:13 +0800 Subject: [PATCH] docs: drop mock, integrate with real api Co-Authored-By: Claude Opus 4.8 --- docs/spec-conventions.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/spec-conventions.md b/docs/spec-conventions.md index e74dd43..0ab0728 100644 --- a/docs/spec-conventions.md +++ b/docs/spec-conventions.md @@ -32,7 +32,7 @@ specs/ │ ├── platform/ 全局规范（设计令牌/文案/URL 契约/隐私红线） │ ├── data-model/ 数据模型（实体 + 枚举 + 状态机 = 字段字典） │ └── api-contract/ API 契约（endpoint + 请求/响应 shape） -├── frontend/ ← 前端 spec（Mock 独立验收） +├── frontend/ ← 前端 spec（按 SH-AC 契约验收） │ └── AD/ 管理后台（当前唯一前端端） └── backend/ ← 后端 spec（API 独立验收） └── <域>/ 按 §9 域码清单 @@ -73,7 +73,7 @@ specs/ 1. **单一事实源 = `openspec/specs/`**（无 PRD 权威）；冲突以 `shared/data-model` / `shared/api-contract` 为准。 2. **数据库 schema 是字段一致性的唯一锚点**：`data-model` 字段字典先行，前后端引用同一字段名，禁止各自命名。 -3. **前端先行 + Mock**：前端对 Mock 验收，后端对 `SH-AC` 契约实现。 +3. **契约先行，联调走真实 API**：前后端各自按 `SH-AC` 契约实现，完成后直接联调，不另造 Mock。 4. **字段/接口变更先改 `shared/`，再改对应 spec。** 5. **多租户**：业务实体一律带 `tenant_id`，查询统一按租户过滤（见 §9.2-1）。 6. **资源表统一授权**：菜单/按钮/接口统一为「资源」表，RBAC 授权锚点（见 §9.2-2）。 @@ -81,10 +81,10 @@ specs/ ## 7. 构建顺序（Phase） -- **Phase 0 地基**：`sources/` 脚手架 + `shared/` 三层 spec（含 DB 设计）+ Mock -- **Phase 1 前端**：管理后台按 Mock 驱动实现 +- **Phase 0 地基**：`sources/` 脚手架 + `shared/` 三层 spec（含 DB 设计） +- **Phase 1 前端**：管理后台按 `SH-AC` 契约实现 - **Phase 2 后端**：按 `SH-AC` 契约实现 -- **Phase 3 联调与上线**：切真实 API → 端到端验证 → 上线 +- **Phase 3 联调与上线**：前后端对真实 API 联调 → 端到端验证 → 上线 ## 8. spec 文档结构（四段式，每个 spec 必含）