Files

40 lines
3.3 KiB
Markdown
Raw Permalink 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.
# 游泳训练计划 - 交互工作台规范文档
## 1. 业务概述与架构
游泳训练计划模块为教练员与科研人员提供全流程的游泳训练计划制定、档案匹配、AI 负荷处方智能生成以及规则校验调整日志审计能力。
### 视图三位一体架构
1. **计划主列表视图 (`viewList`)**:
- 展现所有已制定的运动员游泳训练方案;
- 字段维度包含:创建时间、姓名、性别、年龄、运动员ID、训练等级(竞技级/初学者)、训练阶段(比赛期/GPP)、主要目标(恢复/耐力)、主要项目(长距离/50米)、计划类型(单次训练)及删除入口;
- **交互增强**:卡片在鼠标悬浮 (`:hover`) 或手指点击 (`:active` / `.selected`) 时自动高亮显现左侧品牌主色蓝(`#2563EB`)强调线,点击卡片直接进入该运动员的更新页面并真实回显数据;
- 底部悬浮图标按钮 (FABs):左下角圆形白底【时钟图标(调整日志)】、右下角圆形渐变蓝【加号图标(新建训练计划)】。
2. **新建/更新训练计划与 AI 处方中枢 (`viewEditor`)**:
- 双栏并排工作台(左侧 380px 档案表单,右侧 AI 分析与处方中枢);
- 左栏包含三大核心区块:
- **运动员信息**:用户名、性别、年龄、最大心率、运动员ID、教育阶段;
- **训练档案**:系统性训练时间 (年)、训练水平 (竞技级/专业级/初学者);
- **计划参数**:主要项目、训练阶段、主要目标、计划类型;
- 右栏中枢提供【更新训练计划】按钮,点击后触发 AI 计算模拟并生成个性化目标心率靶区(如 `138 ~ 156 bpm`)、单次总负荷量(如 `3,200 米 / 单次`)及分段结构化处方。
3. **调整日志视图 (`viewLogs`)**:
- 表头包含:时间、规则 (如 `R011`)、类型、运动员 (如 `108203`)、字段 (`primaryGoal`)、变更 (`Threshold` → `Recovery`)、原因 (`-`);
- 【自动调整】类型标签严格采用规定的琥珀黄色规范 (`#D97706` / `#FFFBEB` / `#FDE68A`)。
## 2. 核心设计规范 Tokens
| Token 类别 | 变量名 | 规范值 | 用途说明 |
| :--- | :--- | :--- | :--- |
| **品牌主色** | `--color-primary` | `#2563EB` | 激活卡片左侧边框、主按钮、高亮目标字段 |
| **主色暗调** | `--color-primary-dark` | `#1D4ED8` | 悬停态、主操作渐变深端 |
| **主色容器** | `--color-primary-light` | `#EFF6FF` | 高亮底色、悬浮卡片背景 |
| **主色边框** | `--color-primary-border` | `#DBEAFE` | 激活卡片外边框 |
| **告警黄色** | `--color-warning` | `#D97706` | 调整日志「自动调整」类型标签文字 |
| **黄色背景** | `--color-warning-bg` | `#FFFBEB` | 调整日志类型标签背景色 |
| **黄色边框** | `--color-warning-border` | `#FDE68A` | 调整日志类型标签外边框 |
| **危险红色** | `--color-danger` | `#E11D48` | 卡片「删除」按钮文字与悬停态 |
## 3. 文件构成清单
1. `baseline_ui.html`:三视图一体化结构模板与 DOM 槽位映射;
2. `baseline_ui.css`:工控响应式流式布局样式表与微交互动效;
3. `baseline_ui.js`:动态路由切换、数据回显、AI 处方计算与删除交互;
4. `image.png`:1200x800 高清交付截图。