docs: drop mock, integrate with real api
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
2b3ae072f2
commit
b8fa107d24
@ -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 必含)
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user