fix: 更新体重管理PRD文档

2026-07-08 19:26:22 +08:00
parent 281e756a78
commit 42af90e39f
1 changed files with 46 additions and 107 deletions
@@ -648,8 +648,8 @@ stateDiagram-v2

 **主要UI元素：**
 - 月历导航（上一月/下一月箭头、月份标签）
- 月历网格（7列）：有数据的日期显示双同心圆环图（蓝色外环=摄入、黄色内环=消耗）和净热量差文字
- 柱状趋势图区域："本月吃动趋势"标题，双色堆叠柱状图（蓝色=摄入、黄色=消耗），每天一组柱子
+- 月历网格（7列）：有数据的日期显示双同心圆环图（摄入、消耗）和净热量差文字
+- 柱状趋势图区域："本月吃动趋势"标题，双色堆叠柱状图（摄入、消耗），每天一组柱子
 - 柱状图悬浮提示弹窗：显示日期、摄入详情（热量/碳水/脂肪/蛋白质）、消耗详情（基础代谢/运动消耗/步行消耗）

 **交互说明：**
@@ -666,41 +666,33 @@ stateDiagram-v2

 ![页面截图](screenshots/diet-advice.jpg)

-**功能说明：** 为员工提供个性化膳食指导方案，首次进入需完成偏好问卷，之后展示每日热量目标、膳食注意事项、三餐推荐食谱和本周食谱计划。
+**功能说明：** 为员工提供个性化膳食指导方案，首次进入需跳转到膳食偏好设置页面，提交完偏好设置后才可进行膳食推荐。膳食建议页面展示每日热量目标、膳食注意事项、三餐推荐食谱和本周食谱计划。

 **页面状态：**
- **引导态（首次进入）：** 覆盖全屏的紫色引导问卷
- **内容态（完成引导后）：** 完整膳食建议内容
+- **首次进入：** 膳食偏好设置页面
+- **完成设置后：** 膳食建议页面

-**引导态主要UI元素：**
- Q1：所在地区（必填，省市联动选择器弹窗）
- Q2：口味偏好（必填，单选：清淡/辛辣/咸鲜/酸甜）
- Q3：上班时间（必填：正常白班/早班/晚班/倒班）
- Q4：规避食材（可选，多选：羊肉/海鲜/动物内脏/花生/鸡蛋/牛奶/香菜/辣椒/大蒜/菌菇/其他）
- 提交按钮（必填项未完成时禁用，显示"请先填写必选项"；全部完成显示"开始推荐"）

-**内容态主要UI元素：**
+**主要UI元素：**
 - 导航栏右侧"修改偏好"按钮
- 每日热量目标卡片（绿色渐变）：目标总热量、营养素进度条（蛋白质/碳水/脂肪）
+- 每日热量目标卡片：目标总热量、营养素进度条（蛋白质/碳水/脂肪）
 - 膳食注意事项卡片（可折叠）：低钠、低嘌呤、少食多餐、多饮水等提示
- 今日三餐推荐（4个Tab：早餐/午餐/晚餐/加餐）：每餐菜品卡片（图标、名称、份量、热量、标签如"低钠/低嘌呤/当地"、烹饪提示）
+- 今日三餐推荐（4个Tab：早餐/午餐/晚餐/加餐）：每餐菜品（名称、份量、热量、标签如"低钠/低嘌呤/食堂餐品"）
 - 本周食谱计划（7天Tab切换）：每天展示3道推荐菜品
 - "保存至本地"按钮

 **交互说明：**
- 引导态：完成所有必填项后点击"开始推荐"关闭引导、展示内容
- 点击"修改偏好"重新打开引导问卷，回填已有选择
+- 点击"修改偏好"跳转到膳食偏好设置页面，回填内容
 - 点击菜品卡片打开详情弹窗（含"不喜欢"按钮）
- 点击"不喜欢"弹出二级确认弹窗（含原因快捷选择）
+- 点击"不喜欢"弹出二级确认弹窗（含原因填写）
 - 点击"膳食注意事项"标题折叠/展开
 - 点击三餐Tab切换餐次
 - 点击周几Tab切换食谱计划日
- 点击"保存至本地"保存当前膳食方案
+- 点击"保存至本地"以pdf/word文件保存当前膳食方案至本地
 - 点击返回按钮返回体重管理主页

 **业务规则：**
- 首次进入必须完成偏好问卷才能查看膳食建议
- 偏好数据保存在 localStorage
+- 首次进入必须完成偏好问卷才能进去膳食建议页面
 - 修改偏好后膳食建议方案重新生成

 ---
@@ -709,22 +701,20 @@ stateDiagram-v2

 ![页面截图](screenshots/diet-questionnaire.jpg)

-**功能说明：** 独立的膳食偏好设置页面，供修改偏好时使用（也可从膳食建议页的"修改偏好"入口进入）。
+**功能说明：** 膳食偏好设置页面

 **主要UI元素：**
 - 顶部引导语（"定制你的专属膳食方案"）
 - Q1：所在地区（必填，省-市联动选择器弹窗，预置陕西/甘肃/宁夏/内蒙古等长庆油田覆盖区域）
 - Q2：口味偏好（必填，多选标签：清淡·原味/鲜香/咸鲜/微辣/麻辣/酸辣/酸甜/酱香·红烧/蒜香·葱香）
- Q3：饮食禁忌（可选）：预设标签行（猪肉/牛肉/羊肉等）+ "自定义添加"按钮，打开底部弹窗含快捷选择标签和自由文本输入
+- Q3：饮食禁忌（可选）： "自定义添加"按钮，打开底部弹窗含快捷选择标签和自由文本输入
 - 提交按钮（"请先填写必选项"禁用态→"开始推荐"可用态）

 **交互说明：**
 - 点击地区行打开省市联动底部弹窗
 - 点击口味偏好标签切换选中/取消
 - 点击"自定义添加"打开饮食禁忌添加弹窗
- 点击提交按钮保存到 localStorage 并跳转到膳食建议页面
- 点击返回按钮返回上一页
- 页面初始化时从 localStorage 读取已有偏好回填
+- 点击提交按钮保存后跳转到膳食建议页面

 ---

@@ -736,9 +726,9 @@ stateDiagram-v2

 **主要UI元素：**
 - 每日消耗目标卡片（橙色渐变）：目标总消耗热量，分解条（基础消耗/运动消耗/步行消耗各占比进度）
- 运动注意事项卡片（可折叠）：高血压、高尿酸、热身、补水、循序渐进等8条提示
- 四类运动推荐卡片：有氧运动（30-45分钟/天）、力量训练（20-30分钟/次）、柔韧拉伸（10-15分钟/天）、日常活动（全天累计）
- 每周运动计划（7天Tab栏切换）：每天展示3项计划运动（含图标、描述、时长、消耗热量）
+- 运动注意事项卡片（可折叠）：高血压、高尿酸、热身、补水、循序渐进等提示
+- 四类运动推荐卡片：有氧运动、力量训练、柔韧拉伸、日常活动
+- 每周运动计划（7天Tab栏切换）：每天展示3项计划运动（含名称、描述、时长、消耗热量）
 - "保存至本地"按钮

 **交互说明：**
@@ -785,90 +775,39 @@ stateDiagram-v2

 **功能说明：** 展示体重管理活动的排行榜，支持按减重量/减重率/综合分/行动积分四个维度排名。

-**页面状态：** 通过 URL 参数 `?type=hasact|personal|none` 控制。
+**页面状态：**

-**主要UI元素：**
- 活动头部（青绿色渐变横幅）：活动名称、参与人数
- 排名Tab：减重量/减重率/综合分/行动积分
- 我的排名卡片（hasact模式）：个人排名编号、姓名、部门、积分值
- 排名列表表头：排名/用户/当前Tab对应列名
- 排名列表（15行）：前三名金银铜奖牌、当前用户行高亮
- 缺省提示（none模式）："单位暂未组织活动"
+| UI 区域 | `hasact`（已参加活动）   | `personal`（已设置个人目标） | `none`（未参加未设置未组织） |
+|---------|-------------------|---------------------|---------------------------|
+| 顶部提示条 | ❌ 隐藏              | ❌ 隐藏                | ✅ 显示黄色提示条"单位暂未组织活动" |
+| 活动头部（名称+参与人数） | ✅ 显示              | ✅ 显示                | ❌ 隐藏 |
+| 排名Tab栏 | ✅ 可切换4个维度         | ✅ 可切换4个维度           | ❌ 隐藏 |
+| 我的排名卡片 | ✅ 显示（含排名、姓名、部门、数值） | ❌ 隐藏                | ❌ 隐藏 |
+| 排行列表 | ✅ 显示（含"我"的高亮行）   | ✅ 显示（不含"我"的高亮行）     | ❌ 空列表 |
+
+**通用UI元素（hasact / personal 模式）：**
+- 活动头部（青绿色渐变横幅）：活动名称"2026年二季度体重管理活动"、副标题"排行榜（共8626人参加）"
+- 排名Tab栏（4个Tab）：减重量 / 减重率 / 综合分 / 行动积分，切换时列表头文字、个人排名卡数值、排行列表数据同步更新
+- 排行列表表头：排名 / 用户 / 当前维度列名（随Tab变化）
+- 排行列表行：排名序号（前3名金银铜奖牌图标，其余数字序号）、用户（姓名脱敏显示如"张·**"）、部门（单位·部门格式）、数值（含单位）+ 变化趋势箭头（↑/↓/→）；当前用户所在行高亮显示（浅绿色背景）
+- 每个维度独立数据集，切换Tab时"我的排名卡片"的排名和数值同步变化
+
+**各维度排行榜数据特征：**
+
+| 维度 | 列表头 |  单位 | 说明 |
+|------|--------|------|------|
+| 减重量 | 减重量 |  kg | 共减重 |
+| 减重率 | 减重率 |  % | 减重率 |
+| 综合分 | 综合分 | 分 | 综合分 |
+| 行动积分 | 行动积分 | 分 | 行动积分 |

 **交互说明：**
- 点击排名Tab切换排名维度
+- 点击排名Tab切换四个排名维度，列表头、个人排名卡、排行列表同步刷新
+- hasact 模式：活动头部、排名Tab、个人排名卡、排行列表全部显示
+- personal 模式：活动头部和排行列表正常显示，但个人排名卡片隐藏
+- none 模式：仅显示黄色提示条"单位暂未组织活动"，活动头部、排名Tab、个人排名卡均隐藏，排行列表为空
 - 点击返回按钮返回体重管理主页
- 个人模式下隐藏"我的排名卡片"
-
-**业务规则：**
- 综合分 = 减重量分×35% + 减重率分×20% + ...（详见活动详情页规则）
- 未参加活动（none模式）显示"单位暂未组织活动"，列表为空

 ---


-## 表单字段表
-
-### 膳食偏好设置
-
-| 字段名 | 类型 | 必填 | 校验规则 |
-|--------|------|------|----------|
-| 所在地区 | 省-市联动选择 | 是 | 必选省份和城市 |
-| 口味偏好 | 多选标签 | 是 | 至少选1项 |
-| 上班时间 | 单选 | 是 | 必选1项 |
-| 规避食材 | 多选+自定义输入 | 否 | 可多选或自定义 |
-
-### 基本信息编辑字段
-
-| 字段名 | 类型 | 必填 | 校验规则 |
-|--------|------|------|----------|
-| 身高 | 标尺选择（100-250cm） | 是 | 步进0.1cm |
-| 体力活动 | 单选 | 是 | 五选一 |
-
-### 指标慢病 - 测量录入
-
-| 字段名 | 类型 | 必填 | 校验规则 |
-|--------|------|------|----------|
-| 体重 | 标尺选择（30-200kg） | 否 | 步进0.1kg，范围30-200 |
-| 收缩压 | 标尺选择（60-260mmHg） | 否 | 步进1mmHg |
-| 舒张压 | 标尺选择（30-160mmHg） | 否 | 步进1mmHg |
-| 空腹血糖 | 标尺选择（1.0-33.3mmol/L） | 否 | 步进0.01mmol/L |
-| 尿酸 | 标尺选择（50-1200mmol/L） | 否 | 步进1mmol/L |
-| 总胆固醇 | 标尺选择 | 否 | - |
-| 甘油三脂 | 标尺选择 | 否 | - |
-| 高密度脂蛋白 | 标尺选择 | 否 | - |
-| 低密度脂蛋白 | 标尺选择 | 否 | - |
-| 慢性疾病确诊信息 | 单选+文本+日期 | 否 | 已确诊时医院名称和年月必填 |
-
-### 目标管理 - 目标设定
-
-| 字段名 | 类型 | 必填 | 校验规则 |
-|--------|------|------|----------|
-| 活动选择 | 底部弹窗单选 | 否（个人模式） | 单位活动模式下必选 |
-| 计划名称 | 文本输入 | 否（个人模式） | 可自动生成 |
-| 目标体重 | 标尺选择 | 是 | 步进0.1kg |
-| 目标体脂率 | 标尺选择 | 是 | 步进0.1% |
-| 目标腰围 | 标尺选择 | 是 | 步进0.1cm |
-
-### 体重打卡 - 自记测量
-
-| 字段名 | 类型 | 必填 | 校验规则 |
-|--------|------|------|----------|
-| 体重 | 数值输入+步进 | 否 | 一位小数，范围20-300kg |
-| 体脂率 | 数值输入+步进 | 否 | 范围0-60% |
-| 腰围 | 数值输入+步进 | 否 | 范围30-200cm |
-
-### 吃打卡 - 菜品录入
-
-| 字段名 | 类型 | 必填 | 校验规则 |
-|--------|------|------|----------|
-| 餐次 | 选择 | 是 | 早餐/午餐/晚餐/加餐 |
-| 菜品 | 搜索+分类选择 | 是 | - |
-| 份量 | 数值输入 | 是 | 单位：克 |
-
-### 动打卡 - 运动录入
-
-| 字段名 | 类型 | 必填 | 校验规则 |
-|--------|------|------|----------|
-| 运动项目 | 搜索+分类选择 | 是 | - |
-| 时长 | 数值输入 | 是 | 单位：分钟 |