1.7 KiB
1.7 KiB
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。