32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
## Why
|
||
|
||
通用系统管理脚手架需要一个可复用的「地基」——共享契约（全局规范 / 数据模型 / API 契约），
|
||
作为前后端开发的唯一锚点。当前 `openspec/specs/` 为空，无字段字典、无接口契约，
|
||
前后端无法按同一套字段名与接口 shape 对齐。现在启动 Phase 0，先把地基立起来。
|
||
|
||
## What Changes
|
||
|
||
- 新增 `shared/platform`：全局规范（设计令牌 / 文案 / URL 契约 / 隐私红线）。
|
||
- 新增 `shared/data-model`：数据模型（实体 + 枚举 + 状态机 = 字段字典），含 DB 设计。
|
||
- 新增 `shared/api-contract`：API 契约（endpoint + 请求/响应 shape + 统一封装 / 错误码 / 分页约定）。
|
||
- 落定核心设计决策：多租户 `tenant_id` 隔离、资源表 `RES`（菜单/按钮/接口合一）、
|
||
数据权限 `data_scope`、审计字段、软删策略、`sys_` 表前缀、字段命名与时间约定。
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
- `shared/platform`: 跨前后端全局规范（设计令牌、文案、URL 契约、隐私红线）。
|
||
- `shared/data-model`: 数据模型 / 字段字典（实体、枚举、状态机、公共字段约定、DB 设计）。
|
||
- `shared/api-contract`: API 契约（endpoint、请求/响应 shape、统一封装、错误码、分页、鉴权约定）。
|
||
|
||
### Modified Capabilities
|
||
|
||
（无——本 change 为首次建立 shared 层，不修改既有 capability。）
|
||
|
||
## Impact
|
||
|
||
- 影响范围：`openspec/specs/shared/` 下新增 3 个 capability（platform / data-model / api-contract）。
|
||
- 后续关联：`specs/frontend/`、`specs/backend/` 将引用这些 SH 契约作为字段与接口的唯一锚点。
|
||
- 本 change 仅产出规格（spec），不含源码改动；实现走后续 apply。
|