docs: drop mock, integrate with real api

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
liuyun 2026-10-10 14:34:13 +08:00
parent 2b3ae072f2
commit b8fa107d24

View File

@ -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 必含)