docs: 更新页面设计文档+需求文档至当前实现状态

- 页面设计文档:新增色彩系统/智能体配色/圆角规范/已实现15个页面详情/交互特性/后端接口表
- 需求文档:新增已实现/待实现功能清单
This commit is contained in:
MingNian
2026-06-11 11:29:09 +08:00
parent 7baf0d513f
commit 66168e3261
2 changed files with 194 additions and 0 deletions

View File

@@ -802,3 +802,40 @@ AI对话了解信息 ──→ 自动填充档案字段
| 5 | 问诊配额具体次数 | 先按 3 / |
| 6 | 硬件数据同步 | 留接口硬件出来后对接 |
| 7 | 智能体面板内具体快捷按钮 | 后续可调整 |
---
# 当前实现状态2026-06-11
## 已实现
| 模块 | 功能 | 状态 |
|---|---|---|
| 登录 | 手机号+验证码登录即注册 | 完成 |
| AI 对话 | 6大智能体记数据/拍饮食/药管家/问诊/报告分析/运动SSE 流式输出 | 完成 |
| 健康数据录入 | AI 对话中自然语言录入血压/心率/血糖/血氧/体重自动生成确认卡片 | 完成 |
| 饮食分析 | 拍照上传AI 识别食物生成热量和营养成分保存记录 | 完成 |
| 用药管理 | 添加/编辑/删除药品服药打卡今日健康提醒 | 完成 |
| 运动计划 | 创建/删除运动计划打卡AI 对话中自然语言创建 | 完成 |
| 报告管理 | 上传报告拍照/相册/PDFAI 预解读VLM+LLM删除 | 完成 |
| 报告解读 | 指标分析+综合解读+医生审核意见三栏布局 | 完成 |
| 医生问诊 | 选择医生对话剩余次数显示 | 完成 |
| 侧边栏 | 个人中心+健康仪表盘+功能入口+VIP服务+保险栏 | 完成 |
| 趋势图 | 健康指标折线图 | 完成 |
| 饮食记录 | 列表+删除+详情 | 完成 |
| 蓝牙设备 | 血压计蓝牙扫描连接 | 完成 |
| 个人资料 | 头像/昵称/手机号/健康档案/退出登录 | 完成 |
| 通知偏好 | 提醒设置 | 完成 |
## 待实现
| 模块 | 功能 |
|---|---|
| 保险 | 前端有入口后端未开发 |
| 医生端 Web | 前端 doctor_web 有页面后端有接口待联调 |
| 硬件 OMRON | BLE 连接框架已搭待硬件到位测试 |
| 微信/Apple 登录 | 后期加 |
| 语音输入 | 系统自带不需要额外开发 |
| 推送通知 | 极光 SDK 已集成的方案待生产环境配置 |
| 健康日历 | 页面入口已有待完善 |
| 复查随访 | 入口已有待完善 |

View File

@@ -965,3 +965,160 @@ App 设置
│ "我想每周一三五散步 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 | 食物图片识别 |