create-yss-spec 1.0.0

package/template/docs/design/README.md

@@ -0,0 +1,45 @@
+# 产品设计资产
+
+本目录保存产品页面、用户流、原型、交互说明和状态矩阵等设计资产。
+
+设计系统基线：
+
+- `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件。
+- `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录。
+
+进入 API 影响分析 / 契约草案前，有用户界面的功能建议先沉淀：
+
+- 页面清单和信息架构。
+- 用户主路径和异常路径。
+- 低保真线框图，或 Figma / 即时设计 / Axure 等原型工具链接。
+- Excalidraw 流程图、泳道图、页面地图、状态流或架构辅助图。
+- 表单、表格、弹窗、抽屉、步骤流等交互说明。
+- loading、empty、error、readonly、disabled、no-permission、conflict 等状态矩阵。
+- 页面字段、筛选条件、操作按钮和权限规则。
+
+这些资产用于反推 API 影响、契约草案、OpenAPI 请求 / 响应字段、错误结构、分页筛选、权限状态和前端验收标准。
+
+推荐模板：
+
+- `docs/design/templates/product-overview-design-template.md`：PRD 初稿之后、页面 / 原型 / 交互设计之前，用于团队评审产品总体设计、功能架构、页面/API/数据影响和 PRD 回填项；它是原型设计输入，不是交互说明本身。
+- `docs/design/templates/interaction-spec-template.md`：页面、流程、交互、PRD 回填项和 OpenAPI 反推清单。
+- `docs/design/templates/state-matrix-template.md`：loading、empty、error、readonly、no-permission、conflict 等状态。
+- `docs/design/templates/prototype-review-checklist.md`：进入 PRD 校准 / API 影响分析 / 契约草案前的原型评审门禁。
+
+推荐技能：
+
+- `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。
+- `product-design-prototype`：基于 PRD 初稿和产品总体设计 / 功能架构，产出页面 / 原型 / 交互设计资产。
+- `wireframe-prototype`：低保真线框、Excalidraw、Figma、Penpot、tldraw、Axure 等原型链接沉淀。
+- `component-story-prototype`：Storybook / Histoire 工程态状态原型。
+- `mock-api-prototype`：MSW / mock fixtures 支撑未冻结 API 前的交互验证。
+- `prototype-review`：原型阶段评审门禁；未通过则不要进入 PRD 校准 / API 影响分析 / 契约草案。
+- `excalidraw-diagram-generator`：根据已形成的 Discovery、PRD、OpenAPI Draft、Architecture 或 系统 / 数据架构设计 生成 `.excalidraw` 图；用于说明和审查，不替代文本规格。
+
+推荐目录：
+
+```text
+docs/design/diagrams/
+docs/architecture/diagrams/
+docs/discovery/diagrams/
+```

package/template/docs/design/design.md

@@ -0,0 +1,220 @@
+# 设计系统引入说明
+
+## 来源与定位
+
+本文件基于本地设计系统包 `/Users/zhudaoming/Downloads/Product-Design-System` 首次分析整理。自本文件落地后，项目内设计系统的权威来源为 `docs/design/design.md` 与 `docs/design/tokens/*`，外部 Downloads 目录仅作为历史输入记录，不作为后续执行依赖。
+
+本次分析的关键来源：
+
+| 来源文件 | 作用 | 采用结论 |
+| --- | --- | --- |
+| `assets/design.md` | 完整 Ant Design 设计系统说明，包含颜色、排版、布局、组件、动效和定制规则 | 作为主要设计系统语义来源 |
+| `docs/design/tokens/tokens.default.json` | 默认亮色主题派生 token | 作为实现 token 基线 |
+| `docs/design/tokens/tokens.dark.json` | 暗色主题派生 token | 作为后续暗色模式扩展来源 |
+| `docs/design/tokens/tokens.compact.json` | 紧凑密度主题派生 token | 作为后台密集表格 / 表单场景扩展来源 |
+| `docs/design/tokens/variables.css` | `--brand-*` CSS 变量 | 前端实现时优先转换为项目 token |
+| `docs/design/tokens/theme.json` | Ant Design `ConfigProvider` theme 配置 | React + Ant Design 项目可直接参考 |
+| `DESIGN-HANDOFF.md` | 设计交付约束、响应式验证矩阵和实现顺序 | 作为 UI 实现验收补充 |
+| `DESIGN.md` | 品牌生成器输出的简要索引 | 仅作品牌包索引，不作为完整规范 |
+
+结论：这不是营销型视觉系统，而是面向中后台、数据密集、表单密集、流程密集产品的 Ant Design 风格企业级设计系统。项目内 UI 默认应以“清晰、确定、低装饰、可扫描、高一致性”为目标。
+
+## 设计原则
+
+本项目采用该设计系统时，优先遵循四个原则：
+
+| 原则 | 项目解释 |
+| --- | --- |
+| Natural | 使用用户熟悉的中后台交互模式，不为了新奇牺牲效率 |
+| Certain | 页面状态、操作反馈、校验错误、加载和权限状态必须明确 |
+| Meaningful | 视觉强调只服务于任务、状态和主操作，避免无信息量装饰 |
+| Growing | 支撑从简单表单到复杂表格、详情页、审批流和运营控制台的扩展 |
+
+## Token 基线
+
+### 颜色
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| `colorPrimary` | `#1677ff` | 主按钮、链接、焦点、选中态、激活导航 |
+| `colorPrimaryHover` | `#4096ff` | 主色 hover |
+| `colorPrimaryActive` | `#0958d9` | 主色 active |
+| `colorSuccess` | `#52c41a` | 成功状态 |
+| `colorWarning` | `#faad14` | 警告状态 |
+| `colorError` | `#ff4d4f` | 错误状态 |
+| `colorInfo` | `#1677ff` | 信息提示 |
+| `colorBgLayout` | `#f5f5f5` | 页面背景 |
+| `colorBgContainer` | `#ffffff` | 卡片、表格、表单、面板容器 |
+| `colorBgElevated` | `#ffffff` | 弹窗、下拉、浮层 |
+| `colorText` | `#2e2e2e` | 主文本 |
+| `colorTextSecondary` | `#646464` | 次级文本 |
+| `colorTextTertiary` | `#949494` | 说明 / 弱提示 |
+| `colorTextQuaternary` | `#c4c4c4` | placeholder / disabled |
+| `colorBorder` | `#dbdbdb` | 主边框 |
+| `colorBorderSecondary` | `#f1f1f1` | 次级分割线 |
+
+颜色使用规则：
+
+- 主色只表达全局主操作、链接、选中态和焦点态，不作为大面积背景装饰。
+- `success`、`warning`、`error`、`info` 只用于功能状态，不与品牌强调混用。
+- 预设色板如 `blue`、`purple`、`cyan`、`green`、`magenta`、`red`、`orange`、`yellow`、`volcano`、`geekblue`、`gold`、`lime` 主要用于 Tag、图表和分类可视化。
+- 产品代码中不要硬编码 `#ffffff`、`#fafafa` 等表面色，应引用语义 token。
+
+### 排版
+
+| 层级 | 字号 | 字重 | 行高 | 用途 |
+| --- | --- | --- | --- | --- |
+| `fontSizeHeading1` | 38 | 600 | 1.25 | 大标题，慎用 |
+| `fontSizeHeading2` | 32 | 600 | 1.25 | 页面级标题 |
+| `fontSizeHeading3` | 26 | 600 | 1.25 | 重要分区标题 |
+| `fontSizeHeading4` | 22 | 600 | 1.25 | 分区标题 |
+| `fontSizeHeading5` | 18 | 600 | 1.25 | 卡片 / 面板标题 |
+| `fontSizeLG` | 18 | 400/600 | 1.571 | 强调正文 |
+| `fontSize` | 14 | 400 | 1.571 | 默认正文、控件、表格 |
+| `fontSizeSM` | 12 | 400 | 1.571 | 辅助信息、Tag |
+
+字体栈：
+
+```text
+Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
+```
+
+排版规则：
+
+- 中后台产品默认正文使用 14px，以保证信息密度和可扫描性。
+- UI 字重优先使用 400 和 600，不使用 700+ 的重粗字作为状态强调。
+- 选中 / 激活状态优先通过颜色、边框、下划线和背景表达，不通过突然加粗制造跳动。
+
+### 间距与尺寸
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| `sizeXXS` | 4 | 极小间距 |
+| `sizeXS` | 8 | 控件内小间距 |
+| `sizeSM` | 12 | 紧凑间距 |
+| `size` | 16 | 默认模块间距 |
+| `sizeMD` | 20 | 中等间距 |
+| `sizeLG` | 24 | 卡片内边距 / 分区间距 |
+| `sizeXL` | 32 | 页面大分区间距 |
+| `sizeXXL` | 48 | 大版块间距 |
+| `controlHeight` | 32 | 默认按钮、输入框、选择器高度 |
+| `controlHeightLG` | 40 | 大号控件 |
+| `controlHeightSM` | 24 | 小号控件 |
+
+布局规则：
+
+- 间距整体落在 4px 网格上。
+- 表单、筛选区、工具栏、表格和详情页应优先使用密集但有节奏的布局。
+- 不使用任意 magic number；如确需新增尺寸，应先判断是否要扩展 token。
+
+### 圆角
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| `borderRadiusXS` | 3 | 极小元素 |
+| `borderRadiusSM` | 5 | 小标签、小控件 |
+| `borderRadius` | 8 | 当前品牌包默认圆角 |
+| `borderRadiusLG` | 10 | 大容器 / 浮层 |
+
+注意：`assets/design.md` 中 Ant Design 语义说明以 6px 控件圆角、8px 容器圆角为基准；当前品牌 token 派生结果将 `borderRadius` 设为 8px、`borderRadiusLG` 设为 10px。项目实现时以 `system/tokens.default.json` 为准，但应保持“控件圆角小于或等于容器圆角”的层级关系。
+
+### 动效
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| `motionDurationFast` | `0.1s` | hover、focus、press |
+| `motionDurationMid` | `0.2s` | 折叠、淡入淡出、控件内部状态 |
+| `motionDurationSlow` | `0.3s` | Modal、Drawer 等表层变化 |
+| `motionEaseInOut` | `cubic-bezier(0.645, 0.045, 0.355, 1)` | 默认进出场 |
+| `motionEaseOut` | `cubic-bezier(0.215, 0.61, 0.355, 1)` | 出场 / 展开 |
+
+动效规则：
+
+- 动效只服务于状态反馈、层级变化和空间关系，不做装饰性动效。
+- 不随意新增 cubic-bezier；优先使用既有 motion token。
+
+## 组件采用规则
+
+| 组件 | 基准规则 |
+| --- | --- |
+| Button Primary | 每个决策区域只保留一个主按钮，表达最重要动作 |
+| Button Default | 次级动作默认使用描边 / 默认按钮，不与主操作争夺注意力 |
+| Input / Select | 默认高度 32px，focus 使用主色边框和可见焦点反馈 |
+| Card | 用作真实内容容器，默认白底，容器间距清晰；避免卡片套卡片 |
+| Modal | 用于阻断式决策或关键表单，不承载复杂多页流程 |
+| Menu | 选中态使用淡蓝背景 + 主色文本，保证导航位置明确 |
+| Tabs | 激活态使用主色文本 + 2px 下划线，不使用背景填充 |
+| Table | 表头使用浅表面色和 600 字重；默认不做斑马纹，hover 再强调行 |
+| Tag | 用于分类标签，不用于关键状态或错误提示 |
+| Alert | 用于语义反馈，状态由图标、浅色背景和文案共同表达 |
+| Badge | 可表达紧凑状态点，但不能替代可读文本 |
+| Tooltip | 用于补充解释，黑色反相浮层，位置交给框架处理 |
+| Dropdown | hover 使用浅表面色，不单独改变文本颜色 |
+
+## 页面设计倾向
+
+本项目若采用该设计系统，页面应优先呈现为工作台 / 控制台 / 业务操作界面：
+
+- 首屏直接进入实际业务界面，不先做营销落地页。
+- 页面布局应利于扫描、筛选、对比和连续操作。
+- 表格、筛选区、批量操作、详情面板、抽屉、弹窗和状态提示应保持一致的控件语言。
+- 避免大面积渐变、装饰插画、夸张 hero、过多卡片化包装和单色系视觉堆叠。
+- 权限不足、只读、空数据、加载中、校验失败、冲突、提交成功等状态必须在设计阶段明确。
+
+## 响应式验收矩阵
+
+来源包要求实现时覆盖以下视口。后续 UI 原型、前端实现和截图验收应至少抽取这些尺寸中的核心断点：
+
+| 名称 | 尺寸 |
+| --- | --- |
+| mobile compact | 360 × 800 |
+| mobile standard | 390 × 844 |
+| mobile large | 430 × 932 |
+| foldable / small tablet | 600 × 960 |
+| tablet portrait | 820 × 1180 |
+| tablet landscape | 1024 × 768 |
+| laptop | 1366 × 768 |
+| desktop | 1440 × 900 |
+| wide desktop | 1920 × 1080 |
+
+验收规则：
+
+- 不允许出现横向滚动，除非是明确设计的表格横向滚动容器。
+- 工具栏、筛选区和批量操作区在窄屏下应重排或折叠。
+- 表格密集场景应明确移动端替代形态，如卡片列表、关键列优先或详情抽屉。
+- 文字不得溢出按钮、标签、表头、卡片和弹窗。
+
+## 前端实现建议
+
+如果前端使用 React + Ant Design：
+
+- 使用 `ConfigProvider` 注入 `docs/design/tokens/theme.json` 中的 theme 配置。
+- 组件样式优先通过 Ant Design token、component token、CSS variables 或主题算法表达。
+- 消息、通知、Modal 静态方法应使用 `App`、hook API 或 context holder，避免主题上下文丢失。
+- 暗色模式使用 `darkAlgorithm` 或 `docs/design/tokens/variables.dark.css`，不要手工反转颜色。
+- 紧凑模式使用 `compactAlgorithm` 或 `docs/design/tokens/tokens.compact.json`，不要逐组件压缩高度。
+
+如果前端不是 Ant Design：
+
+- 先把 `docs/design/tokens/tokens.default.json` 转为项目设计 token，再映射到目标 UI 库。
+- 保留组件语义和状态语义，不要只复制颜色。
+- 尽量保持 32px 默认控件高度、14px 默认字号、4px 间距网格和三层表面模型。
+
+## 设计审查清单
+
+进入 PRD 校准、API 影响分析 / 契约草案或前端实现前，带 UI 的需求应检查：
+
+- 是否引用本文件作为设计系统基线。
+- 页面清单、用户主路径、异常路径和权限状态是否明确。
+- loading、empty、error、readonly、disabled、no-permission、conflict、success 状态是否齐全。
+- 表单字段、筛选条件、表格列、批量操作、详情字段是否能反推 API schema。
+- 主操作是否唯一且清楚，次级操作是否降级。
+- 是否存在硬编码颜色、任意间距、重复自造控件或与系统冲突的交互。
+- 是否覆盖关键响应式断点。
+
+## 后续落地 TODO
+
+- 将 `docs/design/tokens/theme.json` 接入前端工程主题配置。
+- 将 `docs/design/tokens/variables.css` 中的 `--brand-*` 变量纳入项目 token 管理。
+- 如果项目启用暗色模式，补充 `docs/design/tokens/tokens.dark.json` 的使用规范和截图验收。
+- 如果项目存在高密度表格 / 审批 / 运营台，补充 `docs/design/tokens/tokens.compact.json` 的适用边界。

package/template/docs/design/diagrams/README.md

@@ -0,0 +1,11 @@
+# 设计图稿目录
+
+本目录用于保存产品设计、交互说明和流程评审中的 Excalidraw 可视化补充材料。
+
+图稿只用于辅助评审和沟通，需求边界仍以 PRD、交互说明、OpenAPI Draft、系统 / 数据架构设计 等文本资产为准。评审中发现的边界、状态或接口缺口，需要回写到对应文本资产，不能只停留在图稿里。
+
+推荐命名：
+
+- `<feature-id>-flow.excalidraw`
+- `<feature-id>-interaction-map.excalidraw`
+- `<feature-id>-state-machine.excalidraw`

package/template/docs/design/templates/interaction-spec-template.md

@@ -0,0 +1,113 @@
+# <功能名称> 交互说明模板
+
+> 适用时机：PRD 初稿之后、PRD 校准 / API 影响分析 / 契约草案之前；仅用于有用户界面影响的功能。
+
+## 1. 输入资产
+
+| 资产 | 路径 / 链接 | 说明 |
+|---|---|---|
+| PRD 初稿 | `docs/requirements/<feature>-prd.md` | 原型评审后需要回填和校准 |
+| 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
+| Discovery | `docs/discovery/<feature>-discovery.md` | 可选 |
+| 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
+| 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选；通常应先完成产品设计和 PRD 校准 |
+
+## 2. 页面地图
+
+| 页面 / 面板 | 入口 | 主要用户 | 目标 | 出口 / 下一步 |
+|---|---|---|---|---|
+| 模型列表 | 主导航 | 数据建模人员 | 查询、筛选、创建和进入模型 | 模型详情 |
+| 模型详情 | 模型列表行 | 数据建模人员 | 查看基础信息、字段、校验和发布状态 | 字段编辑 / 版本历史 |
+| 字段编辑抽屉 | 编辑字段操作 | 数据建模人员 | 新增或更新模型字段 | 模型详情 |
+| 发布确认弹窗 | 发布操作 | 数据建模人员 / 管理员 | 确认校验结果和版本冻结 | 模型详情 |
+| 版本历史 | 模型详情页签 | 管理员 / 下游开发者 | 查看发布版本和变更 | 模型详情 |
+
+## 3. 用户流程
+
+### 主流程
+
+1. 用户打开模型列表。
+2. 用户按状态或关键字筛选。
+3. 用户打开一个草稿模型。
+4. 用户在字段编辑抽屉中维护字段。
+5. 用户执行发布前校验。
+6. 用户确认发布。
+7. 系统冻结发布版本并展示版本信息。
+
+### 异常流程
+
+| 触发条件 | 系统行为 | 用户恢复方式 |
+|---|---|---|
+| 校验失败 | 展示模型级和字段级错误 | 修复字段后重新校验 |
+| 无发布权限 | 隐藏或禁用发布操作；若被调用则返回权限错误 | 联系管理员 |
+| 版本冲突 | 展示最新版本，并提示放弃或刷新 | 刷新详情后重新应用修改 |
+| 存在未保存修改 | 展示离开确认 | 留在当前页或放弃修改 |
+
+## 4. 页面细节
+
+### 模型列表
+
+| 区域 | 内容 / 组件 | 说明 |
+|---|---|---|
+| 查询区 | 关键字、状态、负责人 | YSS 前端实现时优先使用 Formily |
+| 表格 | modelCode、modelName、status、owner、updatedAt、latestPublishedVersion、actions | YSS 前端实现时优先使用 YTable |
+| 操作 | 创建、编辑、校验、发布、查看版本 | 由权限决定隐藏、禁用或可点击 |
+
+### 模型详情
+
+| 区域 | 内容 / 组件 | 说明 |
+|---|---|---|
+| 头部 | modelName、modelCode、status、latestVersion | 已发布版本只读 |
+| 页签 | 基础信息、字段、版本历史 |  |
+| 校验面板 | 模型错误、字段错误、告警数量 | 字段级错误必须能定位 |
+| 底部操作 | 保存草稿、校验、发布 | 发布前必须校验通过 |
+
+### 字段编辑抽屉
+
+| 字段 | 类型 | 必填 | 校验 / 交互说明 |
+|---|---|---|---|
+| fieldCode | string | 是 | 模型内唯一 |
+| fieldName | string | 是 | 展示名称 |
+| dataType | enum | 是 | 从支持的数据类型中选择 |
+| nullable | boolean | 是 |  |
+| primaryKey | boolean | 否 | 是否必须至少一个主键由产品策略决定 |
+| defaultValue | string | 否 | 按 dataType 校验 |
+| businessMeaning | string | 否 | 长文本 |
+
+## 5. 状态矩阵
+
+引用或复制 `docs/design/templates/state-matrix-template.md`。
+
+## 6. OpenAPI 反推清单
+
+| 界面需求 | API 影响 | 说明 |
+|---|---|---|
+| 模型列表分页 | `GET /api/v1/models` 支持 page、size 和筛选条件 | 返回状态和 latestPublishedVersion |
+| 字段编辑保存 | 字段新增 / 更新接口，或模型草稿保存接口 | 包含字段级校验响应 |
+| 发布前校验 | 校验接口返回模型级和字段级错误 | 错误结构必须支持页面定位 |
+| 发布确认 | 发布接口携带草稿版本或版本 token | 需要冲突响应 |
+| 版本历史 | 版本列表接口 | 包含操作人、时间和变更摘要 |
+
+## 7. PRD 校准记录
+
+| 原型发现 | 需要回填 PRD 的内容 | 负责人 / 状态 |
+|---|---|---|
+| 字段级校验需要页面定位 | 增加字段级错误展示验收标准 | 产品 / 待确认 |
+| 已发布版本只读 | 增加发布版本不可修改规则 | 产品 / 已确认 |
+| 发布冲突需要恢复路径 | 增加并发冲突异常流程 | 产品 / 待确认 |
+
+## 8. 前端验收
+
+- loading、empty、error、no-permission、readonly、conflict、dirty-form 状态已展示，或明确不适用。
+- 每个表格列、筛选条件、表单字段、抽屉、弹窗和按钮都有数据来源或 mock fixture。
+- 设计可以拆成独立可演示的垂直切片。
+- 如果需要工程态原型，已规划 Storybook / Histoire 或静态 fixture。
+
+## 9. 决策与未决问题
+
+| 类型 | 内容 | 负责人 | 截止 / 状态 |
+|---|---|---|---|
+| 已确认 | 已发布版本只读 | 产品 | 已确认 |
+| 待确认 | 管理员是否可以废弃已发布版本 | 产品 / 架构 | 待确认 |
+| 非目标 | 审批流 | 产品 | MVP 排除 |
+| 人工审查 | 数据库迁移生成 | 人工 | TODO-HUMAN-REVIEW |

package/template/docs/design/templates/product-overview-design-template.md

@@ -0,0 +1,98 @@
+---
+pipeline: <feature-id>
+stage: product-overview-design
+status: draft
+owner: ai
+---
+
+# <功能名称> 产品总体设计与功能架构
+
+> 适用时机：PRD 初稿之后、页面 / 原型 / 交互设计之前。
+> 本文用于明确功能域、模块边界、MVP 范围、页面清单、状态 / 权限影响、OpenAPI 反推点和 PRD 回填项；它是页面 / 原型 / 交互设计的上游输入，不替代 PRD、交互说明、契约草案 / OpenAPI Draft 或系统概要设计。
+
+## 1. 输入资产
+
+| 资产 | 路径 / 链接 | 状态 | 备注 |
+|------|-------------|------|------|
+| Discovery / 竞品分析 |  |  |  |
+| 业务架构 |  |  |  |
+| PRD 初稿 |  |  |  |
+| CONTEXT 术语 |  |  |  |
+| 其他约束 |  |  |  |
+
+## 2. 设计目标
+
+- 目标用户：
+- 核心场景：
+- MVP 目标：
+- 非目标范围：
+- 成功标准：
+
+## 3. 用户主流程
+
+| 流程 | 触发角色 | 起点 | 关键步骤 | 终点 | 异常 / 分支 |
+|------|----------|------|----------|------|-------------|
+|  |  |  |  |  |  |
+
+## 4. 业务对象与状态
+
+| 业务对象 | 说明 | 关键字段 / 属性 | 状态 | 关系 |
+|----------|------|-----------------|------|------|
+|  |  |  |  |  |
+
+## 5. 功能域与模块边界
+
+| 功能域 | 模块 / 页面 | 主要能力 | 优先级 | 依赖 | 非目标 |
+|--------|-------------|----------|--------|------|--------|
+|  |  |  | P0 / P1 / P2 |  |  |
+
+## 6. Strategic DDD Check（轻量）
+
+> 本节嵌入产品总体设计 / 功能架构，不新增独立阶段。只有当上下文数量多、协作关系复杂或边界争议无法在本节说明时，才升级为 `docs/architecture/<feature>-strategic-design.md`。
+
+| 限界上下文 | 核心职责 | 统一语言 / 关键术语 | 上游 / 下游 / 协作关系 | 对应功能域 / 页面 / API | 非目标 |
+|------------|----------|---------------------|-------------------------|--------------------------|--------|
+|  |  |  |  |  |  |
+
+战略设计就绪检查：
+
+- [ ] 统一语言已与 `CONTEXT.md` 对齐，新增术语已列出回填项。
+- [ ] 核心域、支撑域、通用域或“不适用”的判断已明确。
+- [ ] 每个 P0 能力都能归属到一个限界上下文或明确为跨上下文协作。
+- [ ] 上下文协作关系已说明，不把内部模型直接泄露为跨上下文契约。
+- [ ] 本节足以支撑 PRD 校准和 API 影响分析 / 契约草案；否则列为阻断项。
+
+## 7. 页面 / API / 数据影响
+
+| 能力 | 页面影响 | API 影响 | 数据影响 | 权限 / 审计影响 | 备注 |
+|------|----------|----------|----------|------------------|------|
+|  |  |  |  |  |  |
+
+## 8. PRD 回填项
+
+| 编号 | 回填内容 | 影响章节 | 优先级 | 状态 |
+|------|----------|----------|--------|------|
+|  |  |  |  | 待确认 / 已回填 |
+
+## 9. 开放问题与决策
+
+| 问题 / 决策 | 选项 | 建议 | 负责人 | 截止点 | 状态 |
+|-------------|------|------|--------|--------|------|
+|  |  |  |  | PRD 校准前 / API 影响分析前 | 待确认 |
+
+## 10. 评审清单
+
+- [ ] 用户主流程和异常路径已覆盖 MVP。
+- [ ] 业务对象、状态和关系不会与 `CONTEXT.md` 术语冲突。
+- [ ] 功能域、模块边界和优先级清楚。
+- [ ] Strategic DDD Check 已完成，或明确说明本次变更不影响领域边界。
+- [ ] 页面、API、数据、权限和审计影响已显式标注。
+- [ ] PRD 回填项已列出，并分清阻断项和非阻断项。
+- [ ] 安全红线已标记 `TODO-HUMAN-REVIEW`。
+- [ ] 可进入页面 / 原型 / 交互设计，或明确阻断项。
+
+## 11. 结论
+
+- 评审结论：Approved / Blocked
+- 阻断项：
+- 下一步：

package/template/docs/design/templates/prototype-review-checklist.md

@@ -0,0 +1,63 @@
+# <功能名称> 原型评审清单
+
+> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段，不能进入 PRD 校准或 API 影响分析 / 契约草案。
+
+## 评审输入
+
+| 输入 | 路径 / 链接 | 是否具备 |
+|---|---|---|
+| PRD | `docs/requirements/<feature>-prd.md` |  |
+| 交互说明 | `docs/design/<feature>-interaction-spec.md` |  |
+| 原型 / 线框图 | `<链接或导出图片路径>` |  |
+| 状态矩阵 | `docs/design/<feature>-state-matrix.md` |  |
+| 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选 |
+
+## 门禁清单
+
+| 门禁项 | 是否通过 | 发现的问题 |
+|---|---|---|
+| 页面地图覆盖所有入口、出口和主要页面 |  |  |
+| 主流程从开始到完成是清楚的 |  |  |
+| 异常流程覆盖取消、重试、校验失败、权限失败和并发冲突 |  |  |
+| 状态矩阵覆盖 loading、empty、error、no-permission、readonly、disabled、conflict、dirty-form |  |  |
+| 可见字段、筛选、排序、分页、表单、抽屉、弹窗和操作按钮已列出 |  |  |
+| 权限行为能区分隐藏、禁用和调用后拒绝 |  |  |
+| 校验错误能区分模型级和字段级展示位置 |  |  |
+| 能从界面需求反推出 API 影响和契约草案 |  |  |
+| 前端验收、Storybook / Histoire 或 mock 数据需要已明确 |  |  |
+| 安全红线已标记人工审查 |  |  |
+
+## PRD 校准就绪度
+
+| 范围 | 是否就绪 | 说明 |
+|---|---|---|
+| 原型新增的验收标准 |  |  |
+| 流程 / 状态设计发现的需求缺口 |  |  |
+| 原型证明需要排除的非目标 |  |  |
+| 待确认决策已排除在冻结范围外 |  |  |
+| PRD 中已补充设计资产链接 |  |  |
+
+## API 影响分析 / 契约草案就绪度
+
+| 范围 | 是否就绪 | 说明 |
+|---|---|---|
+| 路径 / 操作 |  |  |
+| 请求字段 |  |  |
+| 响应字段 |  |  |
+| 分页 / 筛选 / 排序 |  |  |
+| 错误包装 |  |  |
+| 字段级校验错误 |  |  |
+| 权限 / 能力标识 |  |  |
+| 冲突 / 版本 token |  |  |
+
+## 评审结论
+
+```text
+结论：通过 / 阻断
+阻断项：
+- 
+非阻断建议：
+- 
+下一步：
+- PRD 校准 / API 影响分析 / 契约草案 / 回到 product-design-prototype / component-story-prototype / mock-api-prototype
+```

package/template/docs/design/templates/state-matrix-template.md

@@ -0,0 +1,40 @@
+# <功能名称> 状态矩阵模板
+
+> 适用时机：配合 `product-design-prototype` 使用，在 PRD 校准和 API 影响分析 / 契约草案之前补齐页面状态。
+
+| 页面 / 组件 | 状态 | 触发条件 | 界面行为 | API / 数据要求 | 验收点 |
+|---|---|---|---|---|---|
+| 模型列表 | 加载中 | 首次进入或筛选条件变化 | 表格展示加载态；查询条件尽量保持可用 | 列表请求进行中 | 用户看到进度且布局不跳动 |
+| 模型列表 | 空数据 | 查询返回 0 条记录 | 展示空态；有权限时展示创建入口 | 空分页结果 | 用户可创建或调整筛选条件 |
+| 模型列表 | 错误 | 列表请求失败 | 展示可重试错误，不清空筛选条件 | 错误码和错误文案 | 重试不会丢失筛选条件 |
+| 模型列表 | 无权限 | 用户无查看权限 | 展示无权限提示；不展示受限数据 | 权限响应或预加载权限状态 | 不泄露受限数据 |
+| 模型详情 | 加载中 | 详情请求进行中 | 展示骨架屏或区域加载态 | 详情请求进行中 | 数据加载完成前禁用关键操作 |
+| 模型详情 | 只读 | 打开已发布版本 | 禁用编辑、保存和发布；允许查看版本 | 模型状态和版本号 | 用户无法修改已发布版本 |
+| 字段编辑抽屉 | 表单已修改 | 用户修改字段值 | 启用保存；关闭或跳转时提醒 | 本地表单状态 | 用户可继续编辑或放弃修改 |
+| 字段编辑抽屉 | 字段错误 | 保存或校验返回字段错误 | 字段附近和校验面板同时展示错误 | 字段级错误列表 | 用户能定位并修复每个错误 |
+| 发布弹窗 | 校验失败 | 发布前检查失败 | 阻断发布并分组展示错误 | 模型级 / 字段级校验错误 | 用户看到明确的阻断原因 |
+| 发布弹窗 | 并发冲突 | 页面加载后草稿已被他人修改 | 展示刷新或重试决策 | 冲突错误码、最新版本或 token | 不会误覆盖他人修改 |
+| 发布弹窗 | 发布成功 | 发布接口成功 | 关闭弹窗，展示已发布状态和版本号 | 发布版本元数据 | 详情页反映冻结版本 |
+
+## 必须确认的状态决策
+
+| 决策项 | 选择的行为 | 负责人 |
+|---|---|---|
+| 无权限操作是隐藏还是禁用 |  | 产品 / 安全 |
+| 校验错误展示到字段级还是页面级 | 可编辑表单必须支持字段级错误 | 产品 |
+| 并发冲突如何恢复 | 刷新到最新版本后再重试 | 产品 / 架构 |
+| 已发布版本是否可修改 | 已发布版本只读 | 产品 |
+| 空态主操作 |  | 产品 |
+
+## OpenAPI 状态影响
+
+| 状态 | 契约影响 |
+|---|---|
+| 加载中 | 存在异步请求；前端需要稳定 pending 状态 |
+| 空数据 | 分页结果必须能表示 0 条记录，不能用错误表达 |
+| 错误 | 需要标准错误包装和用户可读文案 |
+| 无权限 | 需要权限响应或能力标识 |
+| 只读 | 状态和版本字段驱动禁用交互 |
+| 字段错误 | 错误体支持 field path / code / message / severity |
+| 并发冲突 | 需要错误码和最新版本或 token |
+| 发布成功 | 响应包含最新状态、版本、操作人和时间 |

package/template/docs/design/tokens/theme.json

@@ -0,0 +1,24 @@
+{
+  "token": {
+    "colorPrimary": "#1677ff",
+    "colorSuccess": "#52c41a",
+    "colorWarning": "#faad14",
+    "colorError": "#ff4d4f",
+    "colorInfo": "#1677ff",
+    "colorTextBase": "#111111",
+    "colorBgBase": "#ffffff",
+    "fontFamily": "Inter, system-ui, -apple-system, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'",
+    "fontFamilyCode": "'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace",
+    "fontSize": 14,
+    "borderRadius": 8,
+    "sizeUnit": 4,
+    "sizeStep": 4,
+    "controlHeight": 32,
+    "lineWidth": 1,
+    "motionUnit": 0.1,
+    "motionBase": 0,
+    "wireframe": false,
+    "motion": true
+  },
+  "algorithm": "default"
+}