医疗机构的预约挂号通常同时面对患者端体验、院内排班协同、支付退款闭环和多院区运营管理等问题。传统线下窗口或单体系统容易出现号源不透明、科室导诊不清晰、患者重复排队、运营内容分散、权限边界不明确等情况。
本项目面向医院、诊所集团、区域医疗服务公司和第三方医疗 SaaS 服务商，提供一套微信小程序 + SaaS 管理后台 + 多租户 API 的预约挂号解决方案。患者从小程序完成科室导诊、医生选择、就诊人维护、预约下单和支付；医院管理员在后台维护院区、科室、医生、号源、订单、退款、内容和网站配置；平台方统一管理租户、域名、支付、短信和权限。
适用场景包括：
多院区医院统一预约入口
专科医院或连锁门诊快速上线微信预约
医疗 SaaS 服务商托管多个医院租户
医院信息科需要按岗位拆分后台权限
门诊处、医生、运营部协同处理挂号和内容运营
患者小程序
首页展示医院 Banner、服务入口、推荐医生、近期可约号源和医院资讯。
科室预约按主科室和子科室导诊，主科室用于介绍和责任岗位展示，子科室承接真实预约。
医生详情展示医生信息、号源时段、挂号费和预约入口。
就诊人管理支持新增、编辑、删除、默认就诊人，预约时可直接选择。
用户中心支持用户信息维护、手机号绑定、预约记录、退款状态、关于医院和客服反馈。
医院资讯支持列表和详情页，Banner 可跳转资讯、医生、页面或外链提示。
SaaS 后台
平台门户首页提供平台登录、租户登录、医生登录三个独立入口。
平台管理支持租户配置、API 域名绑定、平台网站配置、平台支付配置、短信配置、平台账号和角色。
租户管理支持医院配置、院区、科室、医生、手动排班、自动排班、预约订单、退款记录、用户服务、资讯分类、医院资讯和 Banner。
用户服务以用户为核心展示就诊人、预约订单和退款记录，可处理确认、完成、取消预约。
角色权限支持租户内岗位分工，例如租户管理员、门诊挂号、医生工作台、运营内容。
图片上传支持医生头像、资讯封面、Banner、Logo、登录背景等后台维护。
支付、短信与域名
微信支付参数支持平台统一配置，也支持租户独立配置。
支付回调和退款回调 URL 由系统按 API 域名自动生成，后台只读展示，禁止手工修改。
短信支持阿里云、腾讯云、SMS 宝，平台配置可作为租户默认通道，租户可启用独立配置。
API 域名由平台管理员统一绑定，支持平台提供域名和客户自有域名，客户自有域名提供 CNAME 解析指引。
项目采用 monorepo 组织：
backend：PHP API 服务，包含小程序 API、后台 API、租户解析、权限、支付、短信、上传和业务服务。
admin-web：Vue2 + Ant Design Vue 1.x 的 SaaS 管理后台，使用 Hash 路由提供门户首页和独立功能地址。
miniapp：原生微信小程序，负责患者端预约、支付、就诊人和资讯展示。
infra：Docker Compose、Nginx、MySQL、Redis 和本地 HTTPS 配置。
docs：接口、数据模型、部署、支付、上线和项目介绍文档。
核心实现要点：
多租户采用平台库 + 租户独立业务库模式，平台库保存租户、域名、平台账号和平台配置，租户业务库保存医院业务数据。
租户上下文由登录 token、X-Tenant-Code 或 API Host 域名解析得到，后端强制隔离租户数据。
后台菜单由 GET /admin/v1/auth/me 返回的权限码和菜单树驱动，前端只负责渲染，接口仍由后端校验权限。
医生账号绑定 doctor_id，预约订单和用户服务中的订单查询都会按医生范围过滤。
预约号源由排班和时段号源组成，创建预约时扣减号源，取消待支付预约时恢复号源。
已支付或已确认预约取消时创建退款记录，预约进入退款中，便于退款闭环跟踪。
支付配置保存时忽略回调 URL 字段，实际回调地址由租户 API 域名生成，避免人为配置错误。
评论