一、项目级 UI 约定
来源：prototype/*.html 实测 + docs/01 REQ 卡片 UI 描述 + docs/06 已有布局。经用户确认。
| 约定项 |
锁定值 |
依据 |
| 整体布局骨架 |
{{LAYOUT_SKELETON}} |
{{LAYOUT_SOURCE}} |
| 最小支持视口 / 响应式策略 |
{{VIEWPORT_POLICY}} |
{{VIEWPORT_SOURCE}} |
| 列表页交互范式 |
{{LIST_PATTERN}} |
{{LIST_SOURCE}} |
| 表单展现规则（Modal / Drawer / 独立页阈值） |
{{FORM_PATTERN}} |
{{FORM_SOURCE}} |
| 操作反馈范式（成功 / 失败 / 二次确认） |
{{FEEDBACK_PATTERN}} |
{{FEEDBACK_SOURCE}} |
| 数据展示约定（状态 / 日期 / 金额 / 空值 / 操作列） |
{{DISPLAY_PATTERN}} |
{{DISPLAY_SOURCE}} |
| 前端权限控制方式 |
{{AUTH_PATTERN}} |
{{AUTH_SOURCE}} |
二、Design Tokens
单元格写 token 名（--color-xxx），不写裸 hex；色值默认值落地于 src/styles/tokens.css。命名规范见 docs/04 § 2.5。
2.1 全局调色板
| 语义 |
变量名 |
默认值 |
用途 |
| {{TOKEN_SEMANTIC}} |
{{TOKEN_VAR}} |
{{TOKEN_VALUE}} |
{{TOKEN_USAGE}} |
2.2 组件级状态色
| 序号 |
组件 |
编辑 bg |
只读 bg |
悬浮 bg |
编辑 fg |
只读 fg |
悬浮 fg |
备注 |
| {{COMP_NO}} |
{{COMP_NAME}} |
{{COMP_BG_EDIT}} |
{{COMP_BG_READONLY}} |
{{COMP_BG_HOVER}} |
{{COMP_FG_EDIT}} |
{{COMP_FG_READONLY}} |
{{COMP_FG_HOVER}} |
{{COMP_NOTE}} |
三、组件库选型
| 项 |
锁定值 |
依据 / 备注 |
| 前端 UI 组件库 |
{{UI_LIB}} |
{{UI_LIB_SOURCE}} |
| 版本 |
{{UI_LIB_VERSION}} |
与 docs/04 § 零 一致 |
| 主题接入方式 |
{{UI_LIB_THEME}} |
如 ConfigProvider.theme.token 引用 § 二全局调色板 |
| 图标库 |
{{ICON_LIB}} |
{{ICON_LIB_SOURCE}} |
| 表格 / 表单封装策略 |
{{WRAP_STRATEGY}} |
是否二次封装、统一 props 约定 |
四、前端栈摘要（同步 docs/04 § 二）
| 分层 |
技术 |
版本 |
说明 |
| {{FE_LAYER}} |
{{FE_TECH}} |
{{FE_VERSION}} |
{{FE_NOTE}} |
五、各 FE 设计决策表
一 FE 一行，FE 清单来自 docs/08 § 三。每行锁定该 FE 的页面骨架来源、页面类型、组件库选型与状态机要点，供 Coding 阶段前端循环直接消费（不再二次问人）。
| FE-NN |
功能名 |
关联 REQ |
关联原型 |
页面类型 |
核心组件树要点 |
关键状态机（loading/empty/error/正常/提交中） |
引用 Design Tokens |
| {{FE_ID}} |
{{FE_NAME}} |
{{FE_REQS}} |
{{FE_PROTOTYPES}} |
{{FE_PAGE_TYPE}} |
{{FE_COMPONENT_TREE}} |
{{FE_STATE_MACHINE}} |
{{FE_TOKENS}} |
