Initial commit: HealthManager full-stack health management platform

Backend: .NET 10 + PostgreSQL + EF Core + JWT + SignalR Frontend patient: React 19 + TypeScript + Vite (mobile H5) Frontend doctor: React 19 + TypeScript + Vite (desktop web)
2026-05-20 16:18:56 +08:00
commit 435af55c4a
215 changed files with 18595 additions and 0 deletions
--- a/操作手册.md
+++ b/操作手册.md
@@ -0,0 +1,895 @@
+# HealthManager 健康管理平台 — 操作使用手册
+
+> **适用对象**：患者、医生、系统管理员
+> **文档目标**：知道每一步该点什么、输入什么、会发生什么
+
+---
+
+## 目录
+
+- [第一部分：快速开始](#第一部分快速开始)
+- [第二部分：患者操作指南](#第二部分患者操作指南)
+- [第三部分：医生操作指南](#第三部分医生操作指南)
+- [第四部分：常见使用场景](#第四部分常见使用场景)
+- [第五部分：附录（演示账号信息）](#第五部分附录演示账号信息)
+
+---
+
+## 第一部分：快速开始
+
+### 1.1 启动系统
+
+#### 第一步：启动后端和数据库
+
+找到 `D:\APP\start-dev.bat` 文件，**双击运行**。
+
+```
+D:\APP\start-dev.bat
+```
+
+你会看到一个命令行窗口跳出，依次显示：
+
+```
+==========================================
+  HealthManager 开发环境启动
+==========================================
+
+[1/4] 启动 PostgreSQL...
+  PostgreSQL 已启动
+
+[2/4] 启动 Redis...
+  Redis 已启动
+
+[3/4] 启动 MinIO...
+  MinIO 已启动
+
+[4/4] 启动后端 API...
+  后端 API 启动中 (http://localhost:5000)
+  Swagger: http://localhost:5000/swagger
+
+===========================================
+  启动完成！
+
+  后端 API:  http://localhost:5000
+  Swagger:   http://localhost:5000/swagger
+  MinIO:     http://localhost:9001
+  PostgreSQL: localhost:5432
+  Redis:     localhost:6379
+===========================================
+```
+
+**注意**：第一次启动时，后端会自动创建数据库和表，并插入演示数据。这可能需要 10-20 秒。
+
+#### 第二步：启动患者前端
+
+重新打开一个命令行窗口，输入：
+
+```bash
+cd D:\APP\frontend-patient
+npm run dev
+```
+
+看到类似以下的输出就成功了：
+
+```
+VITE v8.x.x  ready in xxx ms
+➜  Local:   http://localhost:5173/
+```
+
+#### 第三步：启动医生前端（另一个命令行窗口）
+
+```bash
+cd D:\APP\frontend-doctor
+npm run dev
+```
+
+看到类似以下的输出就成功了：
+
+```
+VITE v8.x.x  ready in xxx ms
+➜  Local:   http://localhost:5174/
+```
+
+#### 第四步：打开浏览器
+
+| 角色 | 地址 | 用什么设备 |
+|------|------|-----------|
+| **患者** | http://localhost:5173 | 手机浏览器（或用 Chrome 开发者工具模拟手机） |
+| **医生** | http://localhost:5174 | 电脑浏览器 |
+| **API 文档** | http://localhost:5000/swagger | 电脑浏览器（开发者用） |
+
+**提示**：患者端是为手机设计的。如果你在电脑上打开，**按 F12 → 点击左上角的"切换设备工具栏"图标（手机/平板图标）→ 选择 iPhone 12 Pro**，就能看到手机效果。
+
+---
+
+### 1.2 关闭系统
+
+1. 关闭三个命令行窗口（后端、患者前端、医生前端）
+2. PostgreSQL、Redis、MinIO 会继续在后台运行。如果想关闭它们：
+   - 打开任务管理器（Ctrl+Shift+Esc）
+   - 找到 `postgres.exe`、`redis-server.exe`、`minio.exe` 进程
+   - 分别结束任务
+
+---
+
+## 第二部分：患者操作指南
+
+> 以下以**患者张明**的视角演示所有功能。
+
+### 2.1 登录
+
+**1. 打开患者端**：浏览器访问 `http://localhost:5173`
+
+你会看到登录页面。
+
+**2. 输入手机号**：在手机号输入框中输入 `13800138000`
+
+（这是患者张明的演示账号）
+
+**3. 获取验证码**：点击 **"获取验证码"** 按钮
+
+- 按钮会开始 60 秒倒计时（变为灰色不可点击）
+- 倒计时结束后可以重新获取
+- 因为是演示版，验证码**随便输入即可**（如 `1234`）
+
+**4. 输入验证码**：在验证码输入框中输入 `1234`
+
+**5. 点击登录**：点击 **"登录"** 按钮
+
+**6. 登录成功**：页面会跳转到**首页仪表盘**，你可以看到：
+
+```
+👋 早上好，张明
+
+📊 血压         📊 心率
+120/80 mmHg    72 bpm
+```
+
+底部有 4 个 Tab 导航：**首页** | **健康** | **服务** | **我的**
+
+---
+
+### 2.2 首页仪表盘
+
+**你在首页可以看到**：
+
+| 区域 | 显示内容 | 能做什么 |
+|------|---------|---------|
+| 健康概览卡片 | 最新血压值、心率值 | 点击可进入详情 |
+| 快捷操作 | 6 个图标按钮 | 快速跳转到各个功能 |
+| 健康小贴士 | 随机心血管健康建议 | 阅读 |
+| 右上角铃铛 | 🔔 未读通知数 | 点击进入通知列表 |
+
+**6 个快捷操作按钮**：
+
+| 按钮 | 点击后跳转到 |
+|------|------------|
+| 📝 录入数据 | 手动录入健康数据页面 |
+| 💊 用药打卡 | 药物列表页面 |
+| 💬 在线问诊 | 医生列表页面 |
+| 📋 检查报告 | 报告列表页面 |
+| 🏃 运动饮食 | 运动和饮食记录页面 |
+| 📅 我的随访 | 随访计划列表页面 |
+
+---
+
+### 2.3 记录健康数据
+
+#### 场景：早上测完血压，想记录下来
+
+**第一步：进入录入页面**
+
+- 方式A：在首页点 **"📝 录入数据"**
+- 方式B：点底部 **"健康"** Tab → 点 **"血压"** 卡片 → 点右上角 **"+"** 按钮
+
+**第二步：填写数据**
+
+你会看到一个表单：
+
+| 输入框 | 填入什么 | 示例 |
+|--------|---------|------|
+| 收缩压（高压） | 测量仪上的大数字 | `128` |
+| 舒张压（低压） | 测量仪上的小数字 | `82` |
+| 脉搏 | 测量仪上的脉搏数 | `72` |
+| 日期 | 默认今天 | 不需要改 |
+| 时间 | 默认现在 | 如果早上测的选择早上时间 |
+
+**第三步：保存**
+
+点击 **"保存"** 按钮。页面会提示"保存成功"，并跳回记录列表。
+
+此时你可以在列表中看到刚添加的记录。
+
+---
+
+#### 记录其他类型的数据
+
+| 类型 | 在哪里录 | 输入什么 |
+|------|---------|---------|
+| 心率 | 健康 Tab → 心率 → + | `72`（次/分钟） |
+| 血糖 | 健康 Tab → 血糖 → + | `5.6`（mmol/L） |
+| 血氧 | 健康 Tab → 血氧 → + | `98`（%） |
+| 体重 | 健康 Tab → 体重 → + | `74.5`（公斤） |
+| 步数 | 健康 Tab → 步数 → + | `8500`（步） |
+
+---
+
+### 2.4 查看健康趋势
+
+#### 场景：想看最近血压是升了还是降了
+
+**第一步**：点底部 **"健康"** Tab
+
+**第二步**：点 **"血压"** 卡片
+
+**第三步**：你会看到最近的血压记录列表。点右下角的 **"📈 趋势"** 按钮。
+
+**第四步**：你会看到一张折线图：
+
+- **红色线** = 收缩压（高压）
+- **蓝色线** = 舒张压（低压）
+- **红色虚线** = 140 警戒线（超过这条线意味着血压偏高）
+
+**第五步**：你可以切换时间范围：
+- **7天**：看最近一周
+- **14天**：看最近两周
+- **30天**：看最近一个月
+- **90天**：看最近三个月
+
+---
+
+### 2.5 用药打卡
+
+#### 场景：早上8点该吃阿司匹林了
+
+**第一步**：点底部 **"健康"** Tab → 点 **"💊 用药管理"**
+
+**第二步**：你会看到药物列表：
+
+| 药名 | 剂量 | 频率 | 时间 |
+|------|------|------|------|
+| 阿司匹林肠溶片 | 100mg | 每日1次 | 08:00 |
+| 替格瑞洛 | 90mg | 每日2次 | 08:00, 20:00 |
+| 瑞舒伐他汀钙 | 10mg | 每日1次 | 20:00 |
+| 美托洛尔缓释片 | 47.5mg | 每日1次 | 08:00 |
+
+**第三步**：点击 **"阿司匹林肠溶片"** 进入详情页
+
+**第四步**：你会看到：
+- 药物信息（剂量、频率、时间、注意事项）
+- **依从率饼图**（绿色=已吃，灰色=没吃）
+- 近30天服药日历
+
+**第五步**：点击 **"✅ 标记已服用"** 按钮
+
+- 系统记录你在 08:00 这个时间点吃了药
+- 饼图中的绿色部分会变大
+- 如果所有时间点都已服药，当天显示为"已完成"
+
+---
+
+### 2.6 在线问诊（咨询医生）
+
+#### 场景：血压偏高，想咨询王医生
+
+**第一步**：点底部 **"服务"** Tab
+
+**第二步**：点 **"💬 在线问诊"**
+
+**第三步**：你会看到可接诊的医生列表：
+
+| 医生 | 科室 | 职称 |
+|------|------|------|
+| 王建国 | 心血管内科 | 主任医师 |
+| 陈雪梅 | 心血管内科 | 副主任医师 |
+
+**第四步**：点击 **"王建国"** 医生卡片
+
+**第五步**：看到医生详情页（姓名、科室、职称、擅长领域、简介）
+
+**第六步**：点击底部的 **"开始咨询"** 按钮
+
+**第七步**：进入聊天页面。在底部输入框输入你的问题，例如：
+
+> 王医生您好，我最近血压有点偏高，早上测140/90左右
+
+**第八步**：点击 **"发送"** 按钮
+
+- 你的消息出现在右侧（绿色气泡）
+- 如果医生在线，他会回复，消息出现在左侧（白色气泡）
+
+**第九步（等待医生回复）**：医生的回复会实时显示（通过 SignalR 推送），不需要手动刷新。
+
+---
+
+### 2.7 上传检查报告
+
+#### 场景：刚做完血脂检查，想请医生看看
+
+**第一步**：点底部 **"服务"** Tab → 点 **"📋 检查报告"**
+
+**第二步**：你会看到之前的报告列表。点右下角的 **"+"** 按钮。
+
+**第三步**：在表单中输入：
+
+| 字段 | 填什么 | 示例 |
+|------|--------|------|
+| 报告标题 | 描述这个报告 | `"术后6个月血脂复查"` |
+| 报告类别 | 下拉选择 | `血液检查` |
+| 上传图片 | 点上传区域 | （选择血脂化验单的照片） |
+
+**第四步**：点击 **"提交"** 按钮
+
+**第五步**：报告状态变为 **"待审核"**（黄色），等待医生解读。
+
+---
+
+### 2.8 查看报告结果
+
+#### 场景：医生已经解读了我的报告
+
+**第一步**：点底部 **"服务"** Tab → 点 **"📋 检查报告"**
+
+**第二步**：找到状态为 **"已完成"**（绿色）的报告，点击进入。
+
+**第三步**：你会看到完整的解读结果：
+
+| 区域 | 内容 |
+|------|------|
+| 风险等级 | 正常 / 注意 / 异常（颜色不同） |
+| 检查项目 | 各项指标、结果值、正常范围、是否异常 |
+| 医生总结 | 医生写的总结 |
+| 医生建议 | 医生给的建议 |
+
+例如：
+
+```
+风险等级：⚠️ 注意
+
+检查项目：
+| 项目 | 结果 | 参考范围 | 异常 |
+| 总胆固醇 | 5.8 | <5.2 | ⚠️ |
+| 低密度脂蛋白 | 3.4 | <3.4 | ✓ |
+| 甘油三酯 | 1.6 | <1.7 | ✓ |
+
+医生总结：
+血脂总体控制尚可，总胆固醇轻微偏高，注意饮食控制。
+
+医生建议：
+1. 继续服用瑞舒伐他汀
+2. 减少动物脂肪摄入
+3. 增加蔬菜水果摄入
+4. 3个月后复查
+```
+
+---
+
+### 2.9 管理随访
+
+#### 场景：医生安排了3个月后复查，我想看看有哪些随访
+
+**第一步**：点底部 **"服务"** Tab → 点 **"📅 我的随访"**
+
+**第二步**：你会看到随访计划列表：
+
+| 随访 | 计划时间 | 状态 |
+|------|---------|------|
+| PCI术后3个月复查 | 2025-02-20 09:00 | ⏳ 待随访 |
+| PCI术后1个月复查 | 2024-12-20 | ✅ 已完成 |
+
+**第三步**：点击某个随访可以查看详情
+
+---
+
+#### 自己添加随访提醒
+
+**第一步**：在随访列表页，点右下角 **"+"** 按钮
+
+**第二步**：填写：
+| 字段 | 填什么 |
+|------|--------|
+| 标题 | `"测血糖"` |
+| 描述 | `"早上空腹测"` |
+| 计划时间 | 选择日期和时间 |
+| 开启提醒 | 打开开关 |
+
+**第三步**：点击 **"保存"**
+
+---
+
+### 2.10 查看通知
+
+**第一步**：在任意页面，点击右上角的 **🔔 铃铛图标**（带红点表示有未读）。
+
+**第二步**：进入通知列表页：
+
+| 类型 | 内容示例 |
+|------|---------|
+| 💊 用药提醒 | "阿司匹林肠溶片 - 该服药了" |
+| 📅 复查提醒 | "您已术后6个月，建议近期来院复查" |
+| 💬 医生回复 | "王建国医生回复了您的咨询" |
+| 📢 健康提示 | "本周血压控制良好，请继续保持" |
+
+**第三步**：点击某条通知 → 自动标记为已读。
+
+**全部已读**：点右上角 **"全部已读"** 按钮。
+
+---
+
+### 2.11 个人资料
+
+**第一步**：点底部 **"我的"** Tab
+
+**第二步**：你会看到个人资料：
+- 头像、姓名、手机号
+- 身高、体重
+- 病史列表
+
+**第三步**：点各菜单项可进入对应功能：
+| 菜单 | 点击后 |
+|------|--------|
+| 💊 我的用药 | 药物列表 |
+| 🔔 我的通知 | 通知列表 |
+| 📱 设备绑定 | 设备管理 |
+| ⚙️ 设置 | 通知设置、清除缓存、隐私政策、关于 |
+
+**退出登录**：在"我的"页面底部，点击红色 **"退出登录"** 按钮。
+
+---
+
+## 第三部分：医生操作指南
+
+> 以下以**医生王建国**的视角演示所有功能。
+
+### 3.1 登录
+
+**1. 打开医生端**：浏览器访问 `http://localhost:5174`
+
+**2. 输入手机号**：`13700137000`
+
+（这是医生王建国的演示账号）
+
+**3. 输入验证码**：随便输入（如 `1234`）
+
+**4. 点击登录**
+
+**5. 登录成功**：进入工作台（Dashboard）
+
+---
+
+### 3.2 工作台（Dashboard）
+
+**左侧是固定的侧边栏**，包含：
+
+| 菜单项 | 跳转到 |
+|--------|--------|
+| 📊 工作台 | 工作台首页 |
+| 👥 患者管理 | 患者列表 |
+| 💬 在线问诊 | 咨询列表 |
+| 📋 报告审核 | 报告列表 |
+| 📅 随访管理 | 随访列表 |
+
+**侧边栏底部**显示：
+- 医生姓名：王建国
+- 科室：心血管内科
+- 职称：主任医师
+- **退出登录** 按钮
+
+**主内容区**显示四个统计卡片：
+
+| 卡片 | 数字 | 含义 |
+|------|------|------|
+| 🧑‍🤝‍🧑 患者总数 | 2 | 当前分配给我的患者总数 |
+| 💬 活跃咨询 | 1 | 进行中的在线咨询 |
+| 📋 待审核报告 | 0 | 等待我解读的报告 |
+| 📅 今日随访 | 0 | 今天需要完成的随访 |
+
+**快捷操作**：点击各卡片可快速跳转到对应功能。
+
+---
+
+### 3.3 管理患者
+
+#### 查看患者列表
+
+**第一步**：在左侧菜单点击 **"👥 患者管理"**
+
+**第二步**：你会看到患者表格：
+
+| 姓名 | 手机号 | 性别 | 病史 | 支架日期 | 操作 |
+|------|--------|------|------|---------|------|
+| 张明 | 13800138000 | 男 | 高血压, 冠心病, PCI术后 | 2024-11-20 | 查看详情 |
+| 李芳 | 13900139000 | 女 | 高血脂, 冠心病, PCI术后 | 2025-01-10 | 查看详情 |
+
+**第三步（搜索）**：在顶部搜索框输入 `张`，表格会实时过滤，只显示名字包含"张"的患者。
+
+---
+
+#### 查看患者详情
+
+**第一步**：在患者列表，点击张明的 **"查看详情"**
+
+**第二步**：进入患者详情页，上半部分是基本信息：
+
+```
+基本信息
+姓名：张明
+手机号：13800138000
+性别：男
+出生日期：1965-03-15
+身高：172 cm
+体重：75 kg
+
+病史信息
+病史：高血压、冠心病、PCI术后
+支架日期：2024-11-20
+支架类型：药物洗脱支架(DES)
+```
+
+**第三步**：下半部分是健康数据汇总：
+
+| 指标 | 最新值 | 趋势 |
+|------|--------|------|
+| 血压 | 118/76 mmHg | → 稳定 |
+| 心率 | 70 bpm | → 稳定 |
+| 体重 | 74 kg | → 稳定 |
+
+这些数据来自患者每天记录的测量值，你可以快速了解患者的健康状况。
+
+---
+
+### 3.4 在线问诊（回复患者咨询）
+
+#### 查看咨询列表
+
+**第一步**：在左侧菜单点击 **"💬 在线问诊"**
+
+**第二步**：你会看到咨询列表：
+
+| 患者 | 主题 | 状态 | 时间 |
+|------|------|------|------|
+| 张明 | 术后3个月复查咨询 | 🟢 进行中 | 3天前 |
+
+状态标签颜色：
+- **🟢 进行中**：还没结束的咨询
+- **⚪ 已结束**：已经关闭的咨询
+
+---
+
+#### 回复患者消息
+
+**第一步**：点击 **"张明 - 术后3个月复查咨询"**
+
+**第二步**：进入聊天页面，你可以看到之前的对话：
+
+```
+[左侧白色气泡] 张明：
+王医生您好，我最近血压有点偏高，早上测140/90左右
+
+[右侧蓝色气泡] 你（王建国）：
+您好，最近有按时服药吗？饮食方面有没有特别注意？
+
+[左侧白色气泡] 张明：
+药都按时吃了，饮食也在控制，就是工作压力有点大
+
+[右侧蓝色气泡] 你（王建国）：
+工作压力确实会影响血压。建议您注意休息，每天保证7-8小时睡眠。
+如果血压持续偏高，可以来门诊看看是否需要调整药物。
+```
+
+**第三步**：在底部输入框输入回复，例如：
+
+> 另外建议您每天坚持散步30分钟，有助于降压
+
+**第四步**：点击 **"发送"** 按钮（或按 Enter 键）
+
+- 你的消息出现在右侧（蓝色气泡），标记为你的消息
+- 患者那边会实时收到你的回复
+
+---
+
+### 3.5 审核报告
+
+#### 查看待审核报告
+
+**第一步**：在左侧菜单点击 **"📋 报告审核"**
+
+**第二步**：你会看到所有报告列表：
+
+| 患者 | 标题 | 类别 | 状态 | 日期 | 操作 |
+|------|------|------|------|------|------|
+| 张明 | 术后6个月血脂复查 | 血液检查 | 🟡 待审核 | 2025-05-18 | 查看 |
+
+---
+
+#### 解读报告
+
+**第一步**：点击 **"查看"** 进入报告详情
+
+**第二步**：你会看到：
+
+```
+报告信息
+标题：术后6个月血脂复查
+类别：血液检查
+状态：待审核
+上传时间：2025-05-18 10:30
+```
+
+如果有上传的图片链接，也会显示在这里。
+
+**第三步**：在 **"解读报告"** 区域填写：
+
+| 字段 | 填写什么 | 示例 |
+|------|---------|------|
+| **解读结果** | 对报告的总体评价 | `"血脂总体控制尚可，总胆固醇轻微偏高，建议继续控制饮食并按时服药。"` |
+| **风险等级** | 下拉选择 | ⚠️ `注意` |
+| **建议** | 给患者的建议 | `"1. 继续服用瑞舒伐他汀 2. 减少动物脂肪摄入 3. 增加蔬菜水果摄入 4. 3个月后复查"` |
+
+**第四步**：点击 **"提交解读"** 按钮
+
+**第五步**：报告状态变为 **"✅ 已完成"**（绿色），患者那边可以立即看到你的解读结果。
+
+---
+
+### 3.6 管理随访
+
+#### 查看随访列表
+
+**第一步**：在左侧菜单点击 **"📅 随访管理"**
+
+**第二步**：你会看到所有分配给当前医生的随访：
+
+| 标题 | 患者 | 计划时间 | 状态 | 操作 |
+|------|------|---------|------|------|
+| PCI术后3个月复查 | 张明 | 2025-02-20 | ⏳ 待随访 | 编辑 |
+
+状态标签颜色：
+- **⏳ 待随访**（橙色）：还没完成的随访
+- **✅ 已完成**（绿色）：已经完成的
+- **❌ 已错过**（红色）：过了时间没完成的
+
+---
+
+#### 创建新随访
+
+**第一步**：在随访列表页，点击右上角 **"+ 新建随访"** 按钮
+
+**第二步**：在表单中填写：
+
+| 字段 | 填写什么 | 示例 |
+|------|---------|------|
+| 标题 | 随访目的 | `"术后1年全面复查"` |
+| 患者 | 下拉选择 | `张明` |
+| 计划时间 | 日期和时间 | `2025-11-20 09:00` |
+| 备注 | 补充说明 | `"请患者带齐所有检查报告"` |
+
+**第三步**：点击 **"保存"**
+
+新随访会出现在列表中。患者那边也会同步看到。
+
+---
+
+#### 编辑已有随访
+
+**第一步**：在随访列表中，点击某个随访的 **"编辑"** 按钮
+
+**第二步**：修改需要变更的字段（比如改时间、改状态、加备注）
+
+**第三步**：点击 **"保存"**
+
+---
+
+#### 完成随访
+
+如果随访已经完成：
+
+**第一步**：点击随访的 **"编辑"**
+
+**第二步**：把 **状态** 改为 `已完成`
+
+**第三步**：在 **备注** 中记录随访结果
+
+**第四步**：点击 **"保存"**
+
+---
+
+### 3.7 个人资料设置
+
+**第一步**：在左侧菜单底部，点击 **"个人资料"**（或点击你自己的名字）
+
+**第二步**：你会看到当前信息：
+
+| 字段 | 当前值 |
+|------|--------|
+| 姓名 | 王建国 |
+| 手机号 | 13700137000 |
+| 科室 | 心血管内科 |
+| 职称 | 主任医师 |
+| 简介 | 从事心血管内科临床工作30年... |
+
+**第三步**：修改需要更新的字段（手机号不可修改）
+
+**第四步**：点击 **"保存"**
+
+---
+
+## 第四部分：常见使用场景
+
+### 场景 1：患者从登录到完整使用
+
+```
+📱 患者打开手机浏览器
+  │
+  ├─ [1] 登录（13800138000 / 1234）
+  │     → 进入首页，看到血压 120/80，心率 72
+  │
+  ├─ [2] 早上测完血压，录入数据
+  │     → 健康 Tab → 血压 → + → 输入 128/82/72 → 保存
+  │
+  ├─ [3] 吃阿司匹林，打卡
+  │     → 健康 Tab → 用药管理 → 阿司匹林 → 标记已服用
+  │
+  ├─ [4] 查看血压趋势
+  │     → 健康 Tab → 血压 → 趋势 → 看30天折线图
+  │
+  ├─ [5] 感觉不舒服，问医生
+  │     → 服务 Tab → 在线问诊 → 王建国 → 开始咨询 → 发消息
+  │
+  ├─ [6] 收到医生回复
+  │     → 点击右上角铃铛 → 查看通知 → 进入聊天看回复
+  │
+  ├─ [7] 上传化验单
+  │     → 服务 Tab → 检查报告 → + → 填信息 → 提交
+  │
+  └─ [8] 几天后查看解读结果
+        → 服务 Tab → 检查报告 → 点击已完成的报告 → 看结果和建议
+```
+
+---
+
+### 场景 2：医生从登录到完整工作流
+
+```
+💻 医生打开电脑浏览器
+  │
+  ├─ [1] 登录（13700137000 / 1234）
+  │     → 进入工作台，看到4个统计数字
+  │
+  ├─ [2] 查看患者情况
+  │     → 患者管理 → 看到张明和李芳 → 点张明 → 看他的健康数据
+  │
+  ├─ [3] 回复患者咨询
+  │     → 在线问诊 → 点击"术后3个月复查咨询" → 输入回复 → 发送
+  │
+  ├─ [4] 审核报告
+  │     → 报告审核 → 点待审核的报告 → 填解读结果和建议 → 提交
+  │
+  ├─ [5] 安排随访
+  │     → 随访管理 → + 新建随访 → 填信息 → 保存
+  │
+  ├─ [6] 完成随访后更新状态
+  │     → 随访管理 → 编辑 → 状态改为已完成 → 加备注 → 保存
+  │
+  └─ [7] 更新个人资料
+        → 个人资料 → 修改简介 → 保存
+```
+
+---
+
+### 场景 3：医患完整交互流程
+
+```
+患者端                          后端                  医生端
+  │                              │                      │
+  │ [1] 发起咨询                  │                      │
+  │ ───POST /api/consultations──→ │                      │
+  │                              │ [2] 保存咨询           │
+  │                              │ [3] 推送通知          │
+  │                              │ ────────────────────→ │ [4] 收到通知
+  │                              │                      │
+  │ [5] 发送消息                  │                      │
+  │ ───POST /messages──────────→ │                      │
+  │                              │ [6] 保存消息           │
+  │                              │ [7] SignalR推送       │
+  │                              │ ────────────────────→ │ [8] 实时看到消息
+  │                              │                      │
+  │                              │                      │ [9] 医生回复
+  │                              │ ←──POST /messages──── │
+  │                              │ [10] 保存消息          │
+  │ [11] 实时看到回复             │ ← SignalR推送 ─────── │
+  │                              │                      │
+  │ [12] 上传报告                 │                      │
+  │ ───POST /api/reports───────→ │                      │
+  │                              │                      │ [13] 查看报告
+  │                              │                      │ [14] 提交解读
+  │                              │ ←──POST /interpret─── │
+  │ [15] 看到解读结果             │                      │
+  │                              │                      │
+  │                              │                      │ [16] 安排随访
+  │                              │ ←──POST /follow-ups── │
+  │ [17] 看到新的随访计划          │                      │
+```
+
+---
+
+### 场景 4：药品依从性管理
+
+```
+患者每天的用药流程：
+
+早上 08:00
+  ├─ 收到通知：💊 "阿司匹林肠溶片 - 该服药了"
+  ├─ 打开 APP → 健康 → 用药管理
+  ├─ 点击"阿司匹林肠溶片"
+  └─ 点击"✅ 标记已服用" → 完成！
+
+晚上 20:00
+  ├─ 收到通知：💊 "替格瑞洛 - 该服药了"
+  ├─ 打开 APP → 健康 → 用药管理
+  ├─ 点击"替格瑞洛"
+  └─ 点击"✅ 标记已服用" → 完成！
+
+每月回顾：
+  ├─ 健康 → 用药管理 → 点任意药物
+  └─ 查看依从率饼图
+      ├─ 绿色 > 90% → 🎉 很好！
+      ├─ 绿色 80-90% → ⚠️ 要注意
+      └─ 绿色 < 80% → 🔴 需要改进，医生也会看到
+```
+
+---
+
+## 第五部分：附录（演示账号信息）
+
+### 5.1 演示账号
+
+| 角色 | 姓名 | 手机号 | 密码（验证码） | 说明 |
+|------|------|--------|---------------|------|
+| **患者** | 张明 | `13800138000` | 任意输入（如 `1234`） | 男，60岁，高血压+冠心病+PCI术后 |
+| **患者** | 李芳 | `13900139000` | 任意输入（如 `1234`） | 女，53岁，高血脂+冠心病+PCI术后 |
+| **医生** | 王建国 | `13700137000` | 任意输入（如 `1234`） | 主任医师，心血管内科 |
+| **医生** | 陈雪梅 | `13600136000` | 任意输入（如 `1234`） | 副主任医师，心血管内科 |
+
+### 5.2 接口地址
+
+| 服务 | 地址 |
+|------|------|
+| 后端 API | http://localhost:5000 |
+| Swagger 文档 | http://localhost:5000/swagger |
+| 患者前端 | http://localhost:5173 |
+| 医生前端 | http://localhost:5174 |
+| MinIO 控制台 | http://localhost:9001 |
+| PostgreSQL | localhost:5432 |
+| Redis | localhost:6379 |
+
+### 5.3 常见问题
+
+**Q：登录失败怎么办？**
+
+检查：
+1. 后端是否启动成功（看 `start-dev.bat` 窗口有没有报错）
+2. PostgreSQL 是否在运行
+3. 手机号是否输入正确
+4. 浏览器控制台（F12）有没有报错
+
+**Q：页面没有数据？**
+
+- 确认后端 API 能正常访问：在浏览器直接打开 `http://localhost:5000/swagger`
+- 确认数据库已初始化：后端启动时会自动建表和插入演示数据
+
+**Q：想重置所有数据？**
+
+1. 停止后端
+2. 连接到 PostgreSQL 执行：`DROP DATABASE "HealthManager";`
+3. 重启后端，数据库会自动重建
+
+**Q：能用自己的手机号注册吗？**
+
+可以！在登录页点"去注册"，输入你的手机号 + 昵称即可注册新账号。验证码任意输入（演示版不做真实短信验证）。
+
+---
+
+> 文档版本：v1.0
+> 最后更新：2026-05-20
+> 适用项目：HealthManager 健康管理平台