rlz/陪诊项目需求文档.txt

========================================
陪诊SAAS系统 - 项目需求文档
========================================

一、项目概述
-----------

1.1 项目背景
随着医疗服务的不断发展和人口老龄化趋势，患者就医过程中需要专业陪诊服务的需求日益增长。陪诊SAAS系统旨在为患者提供便捷、专业的陪诊服务，同时为陪护人员提供工作平台，实现患者与陪护人员的精准匹配。

1.2 项目定位
陪诊SAAS系统是一个多端协同的医疗陪诊服务平台，通过互联网技术连接患者、陪护人员和医院，提供线上预约、线下服务的O2O医疗陪诊服务。

1.3 系统架构
系统采用前后端分离架构，包含以下三个端：
- 后台管理系统（Java + Spring Boot + Vue）
- 客户端微信小程序（患者端）
- 陪护端Android应用（陪护人员端）

1.4 核心价值
- 为患者提供便捷的陪诊服务预约渠道
- 为陪护人员提供稳定的工作机会和收入来源
- 优化医疗资源配置，提升就医体验
- 建立标准化的陪诊服务流程

二、用户角色定义
---------------

2.1 患者（客户端用户）
- 角色描述：需要陪诊服务的患者或患者家属
- 使用终端：微信小程序
- 核心需求：
  * 浏览和选择陪诊服务类型
  * 选择医院和陪护人员
  * 下单并支付
  * 查看订单状态和服务进度
  * 评价服务
  * 申请退款

2.2 陪护人员（服务提供者）
- 角色描述：提供陪诊服务的专业人员
- 使用终端：Android应用
- 核心需求：
  * 查看待接单订单
  * 接单/拒单
  * 查看已接订单详情
  * 开始服务、完成服务
  * 查看收入明细
  * 个人信息管理

2.3 系统管理员
- 角色描述：平台运营管理人员
- 使用终端：Web后台管理系统
- 核心需求：
  * 用户管理（患者、陪护人员）
  * 订单管理（审核、分配、处理退款）
  * 医院信息管理
  * 服务类型和价格配置
  * 数据统计和报表
  * 系统参数配置

三、功能需求详述
---------------

【3.1 客户端微信小程序功能需求】

3.1.1 用户注册与登录
- 微信授权登录
  * 支持微信小程序一键登录
  * 获取用户微信信息（openid、手机号等）
  * 自动创建用户账号
- 手机号登录
  * 短信验证码登录
  * 支持手机号快速注册
- 用户信息完善
  * 绑定手机号
  * 设置昵称、头像
  * 实名认证（可选）

3.1.2 首页功能
- 服务类型展示
  * 全程陪诊：200元/次
    - 服务内容：排队、预约、挂号、缴费、取药、记录医嘱
  * 诊前约号：20元/次
    - 服务内容：协助办理完成挂号
  * 取送结果：50元/次
    - 服务内容：包括给病人或者家属取检查报告化验单等
  * 代办问诊：100元/次
    - 服务内容：使用病人或者家属取检查报告化验单向医生问明情况
- 医院列表展示
  * 显示合作医院信息
  * 支持按医院筛选服务
- Banner轮播
  * 展示活动、公告等信息

3.1.3 陪诊服务下单
- 服务类型选择
  * 选择陪诊服务类型（全程陪诊/诊前约号/取送结果/代办问诊）
  * 查看服务详情和价格
- 医院选择
  * 从医院列表中选择目标医院
  * 支持搜索医院
- 填写订单信息
  * 就诊人姓名
  * 就诊人联系电话（必填，格式验证）
  * 服务开始日期（必填）
  * 服务开始时间
  * 送达地址（取送结果服务需要）
  * 特殊要求/备注
  * 患者身份证号（可选）
- 订单提交
  * 创建订单
  * 生成订单号
  * 跳转支付页面

3.1.4 订单管理
- 订单列表
  * 全部订单
  * 待付款订单（status=1）
  * 待服务订单（status=2）
  * 服务中订单（status=3）
  * 已完成订单（status=4）
  * 已取消订单（status=-2）
  * 支持下拉刷新和上拉加载更多
- 订单详情
  * 订单基本信息
    - 订单号
    - 服务类型
    - 医院名称
    - 服务时间
    - 订单金额
    - 订单状态
  * 就诊人信息
    - 姓名
    - 联系电话
    - 送达地址
  * 陪护人员信息（已接单后显示）
    - 姓名
    - 联系电话
    - 头像
  * 订单操作
    - 待付款：去支付、取消订单
    - 待服务：联系陪护、取消订单
    - 服务中：联系陪护、查看服务进度
    - 已完成：评价、申请退款
    - 已取消：删除订单

3.1.5 支付功能
- 微信支付
  * 调用微信支付接口
  * 支持订单支付
  * 支付成功后更新订单状态
- 支付结果
  * 支付成功页面
  * 支付失败提示
  * 支付取消处理

3.1.6 退款功能
- 申请退款
  * 选择退款原因
    - 不喜欢/不想要
    - 商品信息与描述不符
    - 买多/买错/计划有变
    - 更换其他项目、购买了其他项目
    - 没有时间/个人原因
    - 其他原因
  * 上传退款凭证（图片）
  * 填写退款说明
  * 提交退款申请
- 退款进度查询
  * 查看退款状态（申请退款/退款中/已退款/退款失败）
  * 查看退款金额
  * 查看退款原因

3.1.7 个人中心
- 个人信息
  * 查看个人资料
  * 修改昵称、头像
  * 绑定/解绑手机号
- 我的订单
  * 快速入口到订单列表
- 我的钱包
  * 查看余额
  * 查看累计收益
  * 提现功能（如适用）
- 设置
  * 关于我们
  * 隐私政策
  * 退出登录

3.1.8 其他功能
- 消息通知
  * 订单状态变更通知
  * 系统公告
- 客服功能
  * 在线客服（如配置）
  * 客服电话

【3.2 陪护端Android应用功能需求】

3.2.1 登录功能
- 手机号登录
  * 验证码登录
  * 密码登录
- 忘记密码
  * 通过手机号重置密码
- 自动登录
  * 记住登录状态

3.2.2 首页功能
- 待接订单列表
  * 显示待接单订单（status=0）
  * 订单基本信息展示
    - 服务类型
    - 医院名称
    - 服务时间
    - 订单金额
    - 就诊人联系电话
  * 接单/拒单操作
- 已接订单列表
  * 显示已接单订单（status=1,2,3）
  * 订单状态筛选
  * 订单详情查看

3.2.3 订单管理
- 订单详情
  * 订单基本信息
  * 患者信息
    - 姓名
    - 联系电话
    - 送达地址
  * 服务要求
    - 服务时间
    - 特殊要求/备注
  * 订单操作
    - 待接单：接单、拒单
    - 已接单：开始服务
    - 服务中：完成服务、联系患者
    - 已完成：查看详情

3.2.4 服务操作
- 开始服务
  * 确认到达医院
  * 开始计时
  * 更新订单状态为"服务中"（status=3）
- 服务进行中
  * 记录服务过程
  * 上传服务照片（可选）
  * 联系患者
- 完成服务
  * 确认服务完成
  * 上传服务凭证
  * 更新订单状态为"已完成"（status=4）
  * 等待患者确认

3.2.5 收入管理
- 收入明细
  * 查看历史收入记录
  * 按时间筛选
  * 收入统计（日/月/年）
- 提现功能
  * 申请提现
  * 提现记录查询
  * 提现状态跟踪

3.2.6 个人中心
- 个人信息
  * 查看个人资料
  * 修改个人信息
  * 上传头像
- 实名认证
  * 上传身份证
  * 实名认证审核
- 我的订单
  * 全部订单
  * 待接单
  * 服务中
  * 已完成
- 设置
  * 修改密码
  * 消息通知设置
  * 关于我们
  * 退出登录

3.2.7 其他功能
- 消息通知
  * 新订单提醒
  * 订单状态变更通知
  * 系统消息
- 定位功能
  * 获取当前位置
  * 导航到医院（集成地图）

【3.3 后台管理系统功能需求】

3.3.1 用户管理
- 患者管理
  * 患者列表查询
  * 患者信息查看/编辑
  * 患者订单统计
  * 患者状态管理（启用/禁用）
- 陪护人员管理
  * 陪护人员列表查询
  * 陪护人员信息查看/编辑
  * 陪护人员认证审核
  * 陪护人员服务统计
  * 陪护人员状态管理（启用/禁用）
  * 陪护人员等级管理

3.3.2 订单管理
- 订单列表
  * 全部订单查询
  * 按订单状态筛选
  * 按服务类型筛选
  * 按时间范围筛选
  * 按医院筛选
  * 订单搜索（订单号、患者姓名、手机号）
- 订单详情
  * 查看订单完整信息
  * 订单状态修改
  * 订单金额调整
  * 订单备注
- 订单操作
  * 手动分配订单
  * 取消订单
  * 退款审核
  * 订单结算
- 订单统计
  * 订单数量统计
  * 订单金额统计
  * 订单状态分布
  * 服务类型统计

3.3.3 医院管理
- 医院信息管理
  * 添加医院
  * 编辑医院信息
  * 删除医院
  * 医院状态管理
- 医院信息字段
  * 医院名称
  * 医院地址
  * 联系电话
  * 医院等级
  * 医院简介
  * 医院图片

3.3.4 服务类型管理
- 服务类型配置
  * 服务类型列表
  * 添加服务类型
  * 编辑服务类型
  * 删除服务类型
- 价格管理
  * 服务价格设置
  * 价格调整
  * 价格历史记录

3.3.5 财务管理
- 收入统计
  * 平台收入统计
  * 按时间统计
  * 按服务类型统计
- 退款管理
  * 退款申请列表
  * 退款审核
  * 退款处理
  * 退款统计
- 结算管理
  * 陪护人员结算
  * 结算记录
  * 结算统计

3.3.6 数据统计
- 用户统计
  * 用户数量统计
  * 用户增长趋势
  * 用户活跃度
- 订单统计
  * 订单量统计
  * 订单金额统计
  * 订单完成率
- 服务统计
  * 服务类型分布
  * 医院服务量统计
  * 陪护人员服务量统计

3.3.7 系统配置
- 参数配置
  * 系统参数设置
  * 业务参数配置
- 字典管理
  * 数据字典维护
- 通知公告
  * 发布系统公告
  * 公告管理

3.3.8 权限管理
- 角色管理
  * 角色创建
  * 角色权限分配
- 管理员管理
  * 管理员账号管理
  * 权限分配

四、业务流程
-----------

4.1 陪诊服务完整流程

【流程1：患者下单流程】
1. 患者打开微信小程序
2. 选择服务类型（全程陪诊/诊前约号/取送结果/代办问诊）
3. 选择目标医院
4. 填写订单信息（就诊人信息、服务时间、特殊要求等）
5. 提交订单，生成订单号
6. 订单状态：待接单（status=0）
7. 跳转支付页面
8. 选择支付方式（微信支付）
9. 完成支付
10. 订单状态：已支付/待服务（status=2）

【流程2：陪护人员接单流程】
1. 陪护人员打开Android应用
2. 查看待接订单列表
3. 查看订单详情（服务类型、医院、时间、患者信息）
4. 选择接单或拒单
5. 如果接单：
   - 订单状态：已接单（status=1）
   - 患者端收到接单通知
6. 如果拒单：
   - 订单状态：拒绝接单（status=-1）
   - 订单重新进入待接单状态，等待其他陪护接单

【流程3：服务执行流程】
1. 陪护人员到达医院
2. 在应用中点击"开始服务"
3. 订单状态：服务中（status=3）
4. 患者端显示服务中状态
5. 陪护人员执行服务内容
6. 服务过程中可上传照片、联系患者
7. 服务完成后，陪护人员点击"完成服务"
8. 订单状态：已完成（status=4）
9. 患者确认服务完成
10. 患者可对服务进行评价

【流程4：退款流程】
1. 患者申请退款
2. 选择退款原因
3. 上传退款凭证（如需要）
4. 提交退款申请
5. 订单状态：申请退款（status=5）
6. 后台管理员审核退款申请
7. 审核通过：
   - 订单状态：退款中（status=6）
   - 执行退款操作
   - 订单状态：已退款（status=7）
8. 审核不通过：
   - 订单状态恢复原状态
   - 通知患者审核结果

【流程5：订单结算流程】
1. 订单完成后，系统自动或手动结算
2. 计算陪护人员收入（扣除平台服务费）
3. 订单状态：已结算（status=8）
4. 陪护人员可申请提现

4.2 订单状态流转图

待接单(0) 
  ↓ [陪护接单]
已接单(1) 
  ↓ [患者支付]
已支付/待服务(2) 
  ↓ [陪护开始服务]
服务中(3) 
  ↓ [陪护完成服务]
已完成(4) 
  ↓ [系统结算]
已结算(8)

异常流程：
- 待接单(0) → [陪护拒单] → 拒绝接单(-1) → [重新分配] → 待接单(0)
- 待接单(0) → [患者取消] → 已取消(-2)
- 已支付(2) → [患者申请退款] → 申请退款(5) → [审核通过] → 退款中(6) → 已退款(7)
- 服务中(3) → [患者申请退款] → 申请退款(5) → [审核通过] → 退款中(6) → 已退款(7)

五、非功能性需求
---------------

5.1 性能需求
- 系统响应时间
  * 页面加载时间 < 3秒
  * API接口响应时间 < 1秒
  * 支付接口响应时间 < 2秒
- 并发处理
  * 支持1000+并发用户
  * 订单处理能力 > 100单/分钟
- 数据容量
  * 支持10万+用户数据
  * 支持100万+订单数据

5.2 安全需求
- 数据安全
  * 用户敏感信息加密存储
  * 支付信息加密传输
  * 数据库定期备份
- 接口安全
  * JWT Token认证
  * API接口权限控制
  * 防SQL注入、XSS攻击
- 支付安全
  * 微信支付官方SDK
  * 支付回调验证
  * 订单金额校验

5.3 可用性需求
- 系统可用性
  * 系统可用率 > 99.5%
  * 7×24小时服务
- 容错处理
  * 异常情况友好提示
  * 自动重试机制
  * 降级方案

5.4 兼容性需求
- 微信小程序
  * 支持微信7.0+版本
  * 适配iOS和Android系统
- Android应用
  * 支持Android 8.0+（API 26+）
  * 适配主流Android手机品牌
- 后台管理系统
  * 支持Chrome、Firefox、Safari、Edge等主流浏览器
  * 响应式设计，支持PC和移动端

5.5 可维护性需求
- 代码规范
  * 遵循Java、JavaScript代码规范
  * 代码注释完整
- 日志记录
  * 关键操作日志记录
  * 错误日志记录和告警
- 文档完善
  * API接口文档
  * 数据库设计文档
  * 部署运维文档

六、技术架构
-----------

6.1 后端技术栈
- 框架：Spring Boot 2.5.14
- 安全：Spring Security + JWT
- 数据库：MySQL 5.7+
- 缓存：Redis
- 持久层：MyBatis
- API文档：Swagger 3.0
- 定时任务：Quartz
- 构建工具：Maven

6.2 前端技术栈（后台管理）
- 框架：Vue 2.6.12
- UI组件：Element UI 2.15.8
- 状态管理：Vuex 3.6.0
- 路由：Vue Router 3.4.9
- HTTP客户端：Axios 0.24.0

6.3 客户端技术栈（微信小程序）
- 开发框架：微信小程序原生框架
- UI组件：Vant Weapp 1.10.0
- 网络请求：wx.request
- 支付：微信支付SDK

6.4 陪护端技术栈（Android）
- 开发语言：Java
- 最低SDK：Android 8.0 (API 26)
- 目标SDK：Android 14 (API 34)
- 网络框架：Retrofit 2.4.0 + OkHttp 3.5.0
- 响应式编程：RxJava 2.2.6
- 图片加载：Glide 4.9.0
- 数据库：OrmLite 5.1
- 架构模式：MVP

6.5 数据库设计
- 用户表（sys_user）
  * 患者和陪护人员共用
  * 通过userType区分（C=患者，B=陪护）
- 订单表（rlz_order）
  * 订单基本信息
  * 订单状态
  * 金额信息
- 医院表（sys_hospital）
  * 医院基本信息
- 服务类型配置表
  * 服务类型和价格配置

6.6 第三方服务集成
- 微信服务
  * 微信登录
  * 微信支付
  * 微信小程序
- 短信服务
  * 验证码发送
- 地图服务（可选）
  * 高德地图定位
  * 导航功能

七、数据模型
-----------

7.1 核心实体

【用户实体（SysUser）】
- userId: 用户ID（主键）
- userName: 用户名
- nickName: 昵称
- phonenumber: 手机号
- email: 邮箱
- sex: 性别（0男 1女 2未知）
- avatar: 头像
- userType: 用户类型（00系统用户 C患者 B陪护）
- openid: 微信openid
- status: 状态（0正常 1停用）
- createTime: 创建时间

【订单实体（RlzOrder）】
- orderId: 订单ID（主键）
- orderNumber: 订单号
- bId: 陪护人员ID
- cId: 患者ID
- hospitalId: 医院ID
- startTime: 服务开始时间
- endTime: 服务结束时间
- status: 订单状态
  * -2: 已取消
  * -1: 拒绝接单
  * 0: 待接单
  * 1: 已接单
  * 2: 已支付（待服务）
  * 3: 服务中
  * 4: 已完成
  * 5: 申请退款
  * 6: 退款中
  * 7: 已退款
  * 8: 已结算
- yuguMoney: 预估金额
- jiesuanMoney: 结算金额
- kouchuMoney: 扣费金额
- fanxianMoney: 返现给陪护金额
- tuihuiMoney: 退回给患者金额
- yuliu9: 订单大类（1-陪护 2-陪诊）
- yuliu10: 订单类型（1-全程陪诊 2-诊前约号 3-取送结果 4-代办问诊）
- yuliu11: 患者电话
- yuliu12: 特殊要求/备注
- yuliu13: 送达地址
- yuliu14: 患者身份证号
- createTime: 创建时间
- updateTime: 更新时间

【医院实体（SysHospital）】
- hospitalId: 医院ID（主键）
- hospitalName: 医院名称
- hospitalAddress: 医院地址
- hospitalPhone: 联系电话
- hospitalLevel: 医院等级
- hospitalDesc: 医院简介
- status: 状态（0正常 1停用）

7.2 数据关系
- 一个患者可以创建多个订单（1:N）
- 一个陪护人员可以接多个订单（1:N）
- 一个订单对应一个医院（N:1）
- 一个订单对应一个服务类型（N:1）

八、接口设计
-----------

8.1 客户端接口（微信小程序）

【用户相关】
- POST /weixinLogin - 微信登录
- GET /getUserToken - 获取用户Token
- GET /getInfo - 获取用户信息

【订单相关】
- POST /system/order/insertOrderPz - 创建陪诊订单
- GET /system/view/list - 获取订单列表
- GET /system/view/getInfo - 获取订单详情
- GET /system/order/weixinPay/{orderId} - 微信支付
- POST /system/order/refundOrder/{orderId} - 申请退款
- GET /system/order/concelOrder/{orderId} - 取消订单

【医院相关】
- GET /system/hospital/list - 获取医院列表

【配置相关】
- GET /system/config/configKey/price - 获取价格配置
- GET /system/config/configKey/priceType - 获取价格类型配置

8.2 陪护端接口（Android）

【登录相关】
- POST /appLogin - APP登录
- POST /smsLogin - 短信登录

【订单相关】
- GET /system/view/list - 获取订单列表（陪护端）
- GET /system/view/getInfo - 获取订单详情
- POST /system/view/startServiceWithOrder - 开始服务
- POST /system/view/completeOrder - 完成服务

【收入相关】
- GET /system/user/getAppIndexInfo - 获取首页信息（收入统计）

8.3 后台管理接口

【用户管理】
- GET /system/user/list - 用户列表
- POST /system/user - 新增用户
- PUT /system/user - 修改用户
- DELETE /system/user/{userIds} - 删除用户

【订单管理】
- GET /system/order/list - 订单列表
- GET /system/order/{orderId} - 订单详情
- PUT /system/order - 修改订单
- POST /system/order/refundOrder/{orderId} - 处理退款

九、部署要求
-----------

9.1 服务器要求
- 操作系统：Linux（CentOS 7+ / Ubuntu 18.04+）
- CPU：4核+
- 内存：8GB+
- 硬盘：100GB+
- 网络：带宽10Mbps+

9.2 软件环境
- JDK：1.8+
- MySQL：5.7+
- Redis：3.0+
- Nginx：1.18+（反向代理）

9.3 域名和证书
- 后台API域名：api.ruilaizi.com（示例）
- 小程序服务器域名：需在微信公众平台配置
- SSL证书：HTTPS访问

9.4 数据库要求
- 字符集：utf8mb4
- 支持事务
- 定期备份

十、项目里程碑
-------------

10.1 第一阶段：基础功能开发（2个月）
- 用户注册登录
- 订单创建和支付
- 陪护接单功能
- 基础订单管理

10.2 第二阶段：核心功能完善（1.5个月）
- 服务执行流程
- 退款功能
- 收入结算
- 后台管理基础功能

10.3 第三阶段：功能优化和扩展（1个月）
- 消息通知
- 评价系统
- 数据统计
- 性能优化

10.4 第四阶段：测试和上线（0.5个月）
- 功能测试
- 性能测试
- 安全测试
- 上线部署

十一、风险评估
-------------

11.1 技术风险
- 微信支付集成复杂度
- 高并发订单处理
- 数据一致性保证

11.2 业务风险
- 陪护人员服务质量控制
- 退款纠纷处理
- 医疗责任界定

11.3 运营风险
- 用户获取成本
- 陪护人员招募
- 医院合作拓展

十二、后续规划
-------------

12.1 功能扩展
- 在线客服系统
- 服务评价和评分系统
- 会员等级和优惠券
- 推荐陪护人员算法
- 服务轨迹跟踪

12.2 技术优化
- 微服务架构改造
- 消息队列引入
- 分布式缓存
- 大数据分析

12.3 业务拓展
- 多城市覆盖
- 更多服务类型
- 企业客户服务
- 保险合作

========================================
文档版本：v1.0
文档生成时间：2024年
项目名称：陪诊SAAS系统
========================================