first commit

陪诊项目需求文档.txt

@@ -0,0 +1,827 @@
+========================================
+陪诊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系统
+========================================