## 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。