Files
EAP_Interface_html/设置页面UI优化/用户管理/DESIGN_SPEC.md
T
zhy200308 96c82ad25d feat(ui): 完成 [用户管理] (含添加用户/用户表管理) UI重构与全套6件交付物
- 统一采用 Fluid Studio 现代健康工作台设计体系与 #2563EB 核心品牌蓝标准
- 实现主界面、添加/编辑用户表单、用户表管理三视图无缝 SPA 状态机闭环
- 支持真实头像流展示与优质默认 SVG 头像回退
- 精确隔离添加用户(清空)与编辑用户(回填)状态逻辑
- 产出 baseline_ui.html, image.png, DESIGN_SPEC.md, implementation_plan.md, CARD-20260817-UITask-用户管理.md
- 更新 README.md 页面完工状态 (第 7 页已完工)
2026-08-17 18:04:39 +08:00

41 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 用户管理(包含添加/编辑用户与用户表管理)UI 设计规范
## 1. 业务全景与多视图架构
用户管理模块采用 **Fluid Studio 现代健康工作台** 架构,将以下 3 个业务核心视图组织为高内聚的单页应用(SPA)状态机:
1. **用户管理主界面 (`viewMain`)**:
- 顶部控制栏:用户表 Dropdown 切换器(默认 `UserDatabase_CHINA`)、主色渐变 `+ 添加` 按钮、幽灵边框 `导入` 与 `编辑` 按钮;
- 学员卡片流:三区流式卡片(左侧头像与基础名片、中间静息与最大心率生理胶囊、右侧统一 `#2563EB` 状态开关、独立编辑与删除操作)。
2. **添加 / 编辑用户独立表单 (`viewUserForm`)**:
- 支持通过顶部【添加】清空进入(新建空表单),或通过卡片【✏️ 编辑】精确回填对应学员档案数据进入;
- 包含大尺寸圆形头像上传/预览区、学号、用户名、性别下拉、出生日期选择器、身高/体重双列输入、静息/最大心率双列输入(支持基于年龄自动计算最大心率)、全宽主色保存按钮。
3. **用户表管理子视图 (`viewDbManage`)**:
- 顶部提供拖拽调序提示横幅与全量导出按钮;
- 用户表列表项支持拖拽手柄、重命名与删除。
---
## 2. 全局 Design Tokens 标准定义
严格对齐项目主色调 `#2563EB` 与调和语义色规范:
| Token | 值 | 语义说明 |
| :--- | :--- | :--- |
| `--color-primary` | `#2563EB` | 全局核心品牌蓝 |
| `--color-primary-dark` | `#1D4ED8` | 悬浮/深色按下态 |
| `--color-primary-light` | `#EFF6FF` | 主色浅底容器 |
| `--color-primary-border` | `#DBEAFE` | 主色高亮边框 |
| `--color-primary-gradient` | `linear-gradient(135deg, #2563EB 0%, #1D4ED8 100%)` | 主操作按钮渐变 |
| `--color-success` | `#059669` | 调和成功绿 |
| `--color-danger` | `#E11D48` | 调和告警红 |
| `--color-danger-bg` | `#FFF1F2` | 告警浅色背景 |
| `--color-danger-border` | `#FFE4E6` | 告警浅色边框 |
| `--divider` | `#E2E8F0` | 标准分割线 |
---
## 3. 槽位与交互清单
- **AppBar**:`40dp` 圆形触控槽,点击返回;
- **用户表切换**:药丸胶囊下拉框,悬浮主色光晕;
- **头像系统**:支持本地选择图片即时预览,未上传时展示高质感 SVG 默认头像;
- **生理心率**:静息心率与最大心率双胶囊展示,编辑时支持根据出生年份自动推算 `220 - 年龄`;
- **数据状态机隔离**:添加学员与编辑学员表单严格隔离,避免脏数据污染。