# UI设计与交付规范

版本：IB-1.1。玩家端沿用V4/D2设计体系，已对齐首期Web身份与最小权限。后台以V2.1字段和状态规格为依据制作本地交互样稿。

## 本轮设计评审 R01–08（2026-10-27）

- [进入本轮改稿与选座场景](../../ui/review/index.html?screen=redo-review)
- [修改记录与验证](../../ui/review/review-notes.html) · [预览图片](../../ui/review/previews/index.html)

本轮改稿来自“德扑重做01～08”，版本 V3.3，覆盖俱乐部、我的、牌桌选座买入、房间信息、成员与记录账单。真实资金、多人竞抢与对局仍为本地演示。此入口供视觉及交互评审，评审通过前不自动变更下述 IB-1.1 首期范围、数据库和权限裁定；原实施基线玩家原型仍保留作对照。

## 原实施基线原型

- [原实施基线玩家设计工作台](../../ui/player/index.html)：俱乐部、游戏、我的、买入、长短牌、记录、聊天及恢复画板。
- [Web登录与注册](../../ui/player/auth.html)：新增LOCAL入口，包含输入校验、锁定、限流、提交和成功演示。
- [运营后台交互样稿](../../ui/admin/index.html)：16模块导航、表格/详情字段、状态、敏感操作确认与结果未知演示。

原型不访问业务API，不发送真实账户、余额或密码。原型中的操作成功只演示状态；产品验收必须连接真实服务。后台样稿是本次新增的规格表达，不能被称为已经通过生产UI验收。

## 视觉与组件

玩家产品使用暗绿底、荧光绿强调色；优先突出合法主操作、本人底牌、轮到本人和资金结果。界面按逻辑seat_no展示，视觉旋转不得改变规则。设计工作台的网格、状态切换、自动播放不进入正式客户端。

后台样稿使用浅色工作表面、清楚的模块导航、筛选、数据截止、表格和详情抽屉；危险操作不置于行内一键执行。仅超管资金调整，独立TOTP参数确认；默认遮蔽认证标识与敏感数据。

详细规范：[Design Token](../../docs/ui-tokens.html)、[字段与事件](../../docs/ui-contract.html)、[页面状态](../../docs/ui-states.html)、[角色权限](../../docs/ui-permissions.html)、[设计验收](../../docs/ui-acceptance.html)。

## 页面范围

既有P01～P18全部保留。新增P19登录、P20注册、P21会话过期/设备接管/锁定与限流，身份字段来自产品V1.2。S01设计交付页不是正式路由。L01～L03保险、链上核验和真实充提仅作后续档案，不进入本期产品导航。

初始发布仅一套长牌模板。短牌、抓头、Ante和其他买入档位在原型中表达完整本期规则或候选状态，不代表初始化种子已允许开房。生产列表只显示实际已发布、已授权配置。

## UI执行规则

1. 规则与金额由服务端提供，真实0、缺失和未知分别显示。
2. 每个写动作覆盖IDLE/SUBMITTING/UNKNOWN/FAILED/SUCCEEDED；UNKNOWN只查询原操作。
3. 移动端覆盖320/360/390/430宽度、软键盘与安全区，桌面覆盖工作台布局。
4. 无数据、筛选无结果、权限不足、服务失败与记录过期分别呈现。
5. 图标有可访问名称，键盘能操作，焦点可见，弹窗管理焦点；不只依靠颜色表达状态。
6. 审核通过与归属实际生效分开；已结束战绩和进行中暂计分开。

## 证据与来源

[本地截图与关键帧](../../docs/evidence.html)收录已存在的上游截图及抽帧，保留文件指纹。它们是视觉/行为参考，旧Telegram、保险、充提入口不覆盖本期范围。原始视频未纳入静态文档包，规则已通过需求正文和时间定位固化；后续需要重新审片时再取原始资料。
