docs: 更新页面设计文档+需求文档至当前实现状态
- 页面设计文档：新增色彩系统/智能体配色/圆角规范/已实现15个页面详情/交互特性/后端接口表 - 需求文档：新增已实现/待实现功能清单
This commit is contained in:
MingNian
@@ -802,3 +802,40 @@ AI对话了解信息 ──→ 自动填充档案字段
|
|||||||
| 5 | 问诊配额具体次数 | 先按 3 次/月 |
|
| 5 | 问诊配额具体次数 | 先按 3 次/月 |
|
||||||
| 6 | 硬件数据同步 | 留接口，硬件出来后对接 |
|
| 6 | 硬件数据同步 | 留接口，硬件出来后对接 |
|
||||||
| 7 | 智能体面板内具体快捷按钮 | 后续可调整 |
|
| 7 | 智能体面板内具体快捷按钮 | 后续可调整 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# 当前实现状态（2026-06-11）
|
||||||
|
|
||||||
|
## 已实现
|
||||||
|
|
||||||
|
| 模块 | 功能 | 状态 |
|
||||||
|
|---|---|---|
|
||||||
|
| 登录 | 手机号+验证码，登录即注册 | ✅ 完成 |
|
||||||
|
| AI 对话 | 6大智能体（记数据/拍饮食/药管家/问诊/报告分析/运动），SSE 流式输出 | ✅ 完成 |
|
||||||
|
| 健康数据录入 | AI 对话中自然语言录入血压/心率/血糖/血氧/体重，自动生成确认卡片 | ✅ 完成 |
|
||||||
|
| 饮食分析 | 拍照上传→AI 识别食物→生成热量和营养成分→保存记录 | ✅ 完成 |
|
||||||
|
| 用药管理 | 添加/编辑/删除药品，服药打卡，今日健康提醒 | ✅ 完成 |
|
||||||
|
| 运动计划 | 创建/删除运动计划，打卡，AI 对话中自然语言创建 | ✅ 完成 |
|
||||||
|
| 报告管理 | 上传报告（拍照/相册/PDF），AI 预解读（VLM+LLM），删除 | ✅ 完成 |
|
||||||
|
| 报告解读 | 指标分析+综合解读+医生审核意见，三栏布局 | ✅ 完成 |
|
||||||
|
| 医生问诊 | 选择医生→对话→剩余次数显示 | ✅ 完成 |
|
||||||
|
| 侧边栏 | 个人中心+健康仪表盘+功能入口+VIP服务+保险栏 | ✅ 完成 |
|
||||||
|
| 趋势图 | 健康指标折线图 | ✅ 完成 |
|
||||||
|
| 饮食记录 | 列表+删除+详情 | ✅ 完成 |
|
||||||
|
| 蓝牙设备 | 血压计蓝牙扫描连接 | ✅ 完成 |
|
||||||
|
| 个人资料 | 头像/昵称/手机号/健康档案/退出登录 | ✅ 完成 |
|
||||||
|
| 通知偏好 | 提醒设置 | ✅ 完成 |
|
||||||
|
|
||||||
|
## 待实现
|
||||||
|
|
||||||
|
| 模块 | 功能 |
|
||||||
|
|---|---|
|
||||||
|
| 保险 | 前端有入口，后端未开发 |
|
||||||
|
| 医生端 Web | 前端 doctor_web 有页面，后端有接口，待联调 |
|
||||||
|
| 硬件 OMRON | BLE 连接框架已搭，待硬件到位测试 |
|
||||||
|
| 微信/Apple 登录 | 后期加 |
|
||||||
|
| 语音输入 | 系统自带，不需要额外开发 |
|
||||||
|
| 推送通知 | 极光 SDK 已集成的方案，待生产环境配置 |
|
||||||
|
| 健康日历 | 页面入口已有，待完善 |
|
||||||
|
| 复查随访 | 入口已有，待完善 |
|
||||||
|
|||||||
157
健康管家-页面设计文档.md
157
健康管家-页面设计文档.md
@@ -965,3 +965,160 @@ App 设置
|
|||||||
│ "我想每周一三五散步 30 分钟" │
|
│ "我想每周一三五散步 30 分钟" │
|
||||||
└──────────────────────────────────┘
|
└──────────────────────────────────┘
|
||||||
```
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# 当前实现状态（2026-06-11）
|
||||||
|
|
||||||
|
## 色彩系统
|
||||||
|
|
||||||
|
| 用途 | 色值 |
|
||||||
|
|---|---|
|
||||||
|
| 主色（紫） | `#8B5CF6` |
|
||||||
|
| 浅紫 | `#A78BFA` |
|
||||||
|
| 背景渐变 | `#F0ECFF → #EBF4FF`（紫→蓝，左→右） |
|
||||||
|
| 卡片白 | `#FFFFFF` |
|
||||||
|
| 文字主色 | `#1F2937` |
|
||||||
|
| 文字辅色 | `#6B7280` |
|
||||||
|
| 文字提示 | `#9CA3AF` |
|
||||||
|
| 成功绿 | `#10B981` |
|
||||||
|
| 错误红 | `#EF4444` |
|
||||||
|
| 警告橙 | `#F59E0B` |
|
||||||
|
| 蓝色（测量/发送按钮） | `#3B82F6` |
|
||||||
|
|
||||||
|
**智能体专属渐变色：**
|
||||||
|
|
||||||
|
| 智能体 | 主色 | 配色 |
|
||||||
|
|---|---|---|
|
||||||
|
| 记数据 | 绿 `#5FB88D` | `#B8E6CF → #5FB88D` |
|
||||||
|
| 拍饮食 | 橙 `#F0A060` | `#FFD8B8 → #F0A060` |
|
||||||
|
| 药管家 | 青绿 `#68B8AC` | `#B8E0D8 → #68B8AC` |
|
||||||
|
| 问诊 | 蓝 `#7B98E0` | `#C5D5F8 → #7B98E0` |
|
||||||
|
| 报告分析 | 紫 `#A898D8` | `#D8D0F0 → #A898D8` |
|
||||||
|
| 运动 | 青 `#68B4B4` | `#B8E0E0 → #68B4B4` |
|
||||||
|
|
||||||
|
**圆角规范：**
|
||||||
|
- 主卡片 28px，子卡片 20px，按钮 16-20px，胶囊/标签 10-18px
|
||||||
|
|
||||||
|
## 已实现页面
|
||||||
|
|
||||||
|
### 1. 登录页
|
||||||
|
- 手机号+验证码登录（登录即注册）
|
||||||
|
- 白底+紫蓝渐变外框输入框，无 focus 内框
|
||||||
|
- 白底紫字登录按钮
|
||||||
|
- 开发阶段验证码任意6位
|
||||||
|
|
||||||
|
### 2. 首页（对话页）
|
||||||
|
- 顶部：智能体胶囊横排（6个），白底深色字，阴影
|
||||||
|
- 左上：抽屉菜单图标（无背景，融入顶栏）
|
||||||
|
- 右上：消息通知
|
||||||
|
- 对话流：从上到下排列，新消息出现在底部
|
||||||
|
- 底部输入栏：+号附件按钮（拍照/相册/文件），圆角输入框，蓝紫渐变发送按钮
|
||||||
|
- 今日健康卡片：在对话顶部，分3栏（健康指标→运动→用药），健康指标汇总一行（异常提醒/正常显示），用药显示具体药品名+状态
|
||||||
|
- 确认卡片：从下方滑入+淡入动画(600ms)，白色卡片，主数据展示区+字段列表+确认按钮
|
||||||
|
|
||||||
|
### 3. 欢迎卡片（各智能体）
|
||||||
|
- 每个智能体独立配色（图标渐变+装饰条+底部提示）
|
||||||
|
- 功能特性区：有图片显示图片（带渐变外框），无图片显示图标卡片网格
|
||||||
|
- 快捷操作按钮：横向排列
|
||||||
|
- 底部提示：每个智能体专属引导文案
|
||||||
|
- 问诊专属：医生选择卡片（3位医生）
|
||||||
|
|
||||||
|
### 4. 侧边栏（Drawer）
|
||||||
|
- 个人信息+昵称+手机号
|
||||||
|
- 健康仪表盘：5项指标小卡片（血压/心率/血糖/血氧/体重）
|
||||||
|
- 功能：报告管理/健康日历/饮食记录/复查随访
|
||||||
|
- VIP服务：服务包卡片（心血管/心力衰竭两种）
|
||||||
|
- 保险栏：待上线，显示"即将上线"
|
||||||
|
- 退出登录按钮
|
||||||
|
|
||||||
|
### 5. 饮食分析页
|
||||||
|
- 暖橙主题配色（`#FFFBF7` 底，`#F0A060` 强调）
|
||||||
|
- 图片自适应（220px 高）
|
||||||
|
- 餐次选择：emoji+文字横排（早餐/午餐/晚餐/加餐）
|
||||||
|
- 识别结果：白色卡片，橙色装饰条，可编辑食物名/份量/热量
|
||||||
|
- 营养摘要：环形进度条+宏量元素条（碳水/蛋白/脂肪）
|
||||||
|
- AI 点评：淡黄暖底色
|
||||||
|
- 保存按钮：暖橙色
|
||||||
|
|
||||||
|
### 6. 用药管理页
|
||||||
|
- 顶部 TabBar（全部/服用中/已停药）
|
||||||
|
- 药品列表：白底药丸图标+药品名+剂量+时间
|
||||||
|
- 右滑删除
|
||||||
|
- 右下角 FAB ➕ 添加药品
|
||||||
|
- 添加/编辑用药：白底选择器（服药次数+时间），白底紫字保存按钮
|
||||||
|
|
||||||
|
### 7. 服药打卡页
|
||||||
|
- 按药品分组显示
|
||||||
|
- 打卡按钮：对号圆圈形式（灰→绿），与运动计划一致
|
||||||
|
- 支持撤回（点击已打卡取消）
|
||||||
|
|
||||||
|
### 8. 运动计划页
|
||||||
|
- 列表显示运动类型+时长+完成进度
|
||||||
|
- 打卡按钮：对号圆圈（灰→绿）
|
||||||
|
- 右滑删除计划
|
||||||
|
- 右下角 FAB 新建计划
|
||||||
|
|
||||||
|
### 9. 报告管理页
|
||||||
|
- 报告列表：白色卡片，白底紫色图标
|
||||||
|
- 标题：后端 VLM 自动识别类型（抽血化验单/心电图报告等），前端 `_catTitle` 映射
|
||||||
|
- 删除按钮（确认弹窗）
|
||||||
|
- 右下角 FAB 上传（拍照/相册/PDF）
|
||||||
|
- 后端 DELETE 接口
|
||||||
|
|
||||||
|
### 10. 报告解读页（AI 智能解读）
|
||||||
|
- 三栏布局：指标分析 → 综合解读 → 医生审核意见
|
||||||
|
- 统一白色卡片+轻阴影
|
||||||
|
- 指标行：名称+参考值+状态图标（正常/偏高/偏低）
|
||||||
|
- 医生审核：未审核显示"待审核"，已审核显示医生留言
|
||||||
|
- 去掉了五颜六色的背景
|
||||||
|
|
||||||
|
### 11. 个人资料页
|
||||||
|
- 头像+昵称+手机号
|
||||||
|
- 信息卡片（姓名/手机号/健康档案）
|
||||||
|
- 白底图标，去紫色背景
|
||||||
|
- 退出登录按钮（红色描边）
|
||||||
|
- 去掉了蓝牙设备/健康档案/设置快捷入口
|
||||||
|
|
||||||
|
### 12. 设置页
|
||||||
|
- 白色圆角卡片样式菜单项（16px圆角+轻阴影）
|
||||||
|
- 消息通知/字体大小/清除缓存/关于/隐私协议
|
||||||
|
- 退出登录红字按钮
|
||||||
|
|
||||||
|
### 13. 蓝牙设备页
|
||||||
|
- 左上返回按钮
|
||||||
|
- 扫描血压计设备
|
||||||
|
|
||||||
|
### 14. 医生对话页
|
||||||
|
- 输入栏：与主页面一致（圆角容器+蓝紫色发送按钮）
|
||||||
|
- 右上角剩余次数：白底深色字
|
||||||
|
- 对话气泡：用户紫色/AI白底，支持 Markdown
|
||||||
|
|
||||||
|
### 15. 饮食记录列表
|
||||||
|
- 本地列表管理（删除不闪屏）
|
||||||
|
- 左滑删除，点击进详情
|
||||||
|
|
||||||
|
## 交互特性
|
||||||
|
|
||||||
|
- **流式输出**：AI 回复逐字追加（最简实现，无 buffer/Timer/淡入动画）
|
||||||
|
- **卡片入场动画**：欢迎卡片+确认卡片从下方滑入+淡入（600ms, easeOutCubic）
|
||||||
|
- **确认卡片**：字段行横向排列（标签固定80px宽），可编辑字段支持点击修改
|
||||||
|
- **Markdown 渲染**：AI 消息使用 flutter_markdown 渲染，支持粗体/标题
|
||||||
|
- **localhost + adb reverse**：解决 IP 变动问题，手机通过 USB 转发连接电脑后端
|
||||||
|
|
||||||
|
## 后端接口
|
||||||
|
|
||||||
|
| 模块 | 接口 | 说明 |
|
||||||
|
|---|---|---|
|
||||||
|
| 健康数据 | POST /api/health/record | 录入健康指标 |
|
||||||
|
| | GET /api/health/latest | 获取最新指标 |
|
||||||
|
| 用药 | GET/POST/PUT/DELETE /api/medications | 用药 CRUD |
|
||||||
|
| | POST /api/medications/{id}/confirm-dose | 服药打卡 |
|
||||||
|
| 运动 | POST /api/exercise/plans | 创建运动计划 |
|
||||||
|
| | POST /api/exercise/{id}/checkin | 运动打卡 |
|
||||||
|
| 饮食 | POST /api/diet-records | 保存饮食记录 |
|
||||||
|
| | GET /api/diet-records | 获取记录列表 |
|
||||||
|
| 报告 | GET/POST /api/reports | 报告列表/上传 |
|
||||||
|
| | DELETE /api/reports/{id} | 删除报告 |
|
||||||
|
| AI | GET /api/ai/{agent}/chat (SSE) | AI 对话流 |
|
||||||
|
| | POST /api/ai/analyze-food-image | 食物图片识别 |
|
||||||
|
|||||||
Reference in New Issue
Block a user