### 立项原因
随着人口老龄化加剧和就医流程复杂化,患者尤其是老年患者、异地就医群体面临"挂号难、流程繁、无人陪"的就医困境。本项目旨在打造一站式陪诊服务平台,连接专业陪诊人员与有就医陪伴需求的患者,解决患者就医过程中流程不熟、行动不便、沟通困难等痛点。
### 行业场景与业务背景
项目面向医疗陪诊服务行业,业务场景覆盖患者从预约陪诊到完成就医的全流程。患者通过微信小程序选择医院、科室、疾病,下单陪诊套餐后由陪诊员提供全程陪护服务,平台通过订单管理、分销体系、佣金结算实现商业闭环。
项目采用经典的前后端分离三层架构设计:
**客户端层**:前端采用 uni-app + Vue 3 + TypeScript 技术栈,通过条件编译一套代码同时支持微信小程序和H5双端运行。小程序/H5端使用 uview-plus UI组件库 + Pinia状态管理 + Axios请求封装;管理后台采用 Layui + Blade模板引擎的传统服务端渲染模式。客户端层负责用户交互展示和数据采集,通过HTTP RESTful接口与服务端通信。
**服务端层**:核心采用 Webman(基于Workerman)高性能PHP框架,区别于传统PHP-FPM模式,Webman采用常驻内存机制启动后进程常驻,每个请求无需重新加载框架文件,QPS性能提升5-10倍。服务端按功能域划分为4个API入口:小程序端API(/api/applet)、H5端API(/api/mobile)、管理后台(/admin)、支付回调(/api/payment),以及13个通用业务控制器处理CRUD操作。业务逻辑采用Controller→Service→Model三层架构解耦,Service层封装复杂业务规则,Model层专注数据映射。特色集成包括MCP AI服务(17个工具函数,支持AI助手直接查询数据库、生成代码等)和EasyWeChat微信生态集成(登录、支付V2/V3双版本、模板消息推送)。
- **全栈独立开发**,从数据库设计到前后端实现,覆盖全部业务模块
- 完成 **20+ 数据模型** 设计与实现,涵盖医院、科室、疾病、客户、订单、分销等核心实体
- 实现 **13个业务API控制器** + **13个管理后台控制器**,完整覆盖三端接口
- 集成 **微信支付V2/V3双版本**,支持小程序支付和H5支付场景
- 搭建 **MCP AI服务**,17个AI工具集成,支持AI助手直接操作业务数据
- 实现 **分销佣金系统**,多级分销关系和自动佣金计算
### 难点与解决方案
| 难点 | 解决方案 |
| 微信支付V3证书配置复杂 | 封装统一支付控制器,证书路径配置化管理,支持环境切换 |
| 小程序场景值参数解析 | 开发SceneHandler工具类,统一处理扫码/分享等多入口路由跳转 |
| Webman常驻内存数据一致性 | 手动清理ORM模型缓存 + Redis缓存策略解决查询脏数据问题 |
| 跨端兼容性差异 | 条件编译(#ifdef) + 统一请求封装层屏蔽平台差异 |
| 分销佣金计算精度 | bcmath扩展高精度浮点运算,避免金额精度丢失 |
| 订单状态流转可追溯 | OrderHistory模型记录全生命周期状态变更 |
| MCP与Webman进程集成 |MCP独立进程运行,HTTP/SSE协议通信,避免阻塞主进程 |