167 lines
6.6 KiB
Markdown
167 lines
6.6 KiB
Markdown
# 苏州肛泰中医院 · 预约挂号系统
|
||
|
||
基于 **Taro 4.x + React + TypeScript** 的微信小程序，配套 **Node.js + Express + MySQL** 后端 API 和运营管理后台。
|
||
|
||
线上地址：`https://y.szgtlive.com`
|
||
|
||
## 功能概览
|
||
|
||
### 小程序端（5 个 TabBar 页 + 2 个二级页）
|
||
|
||
- **首页**：医院名称（后台可配置）、三栏中心入口（独立图标图片 + 名称 + 预约咨询）、轮播 Banner
|
||
- **医院简介**：轮播图 + 医院详细介绍 + 联系方式 + 地址
|
||
- **自助预约**：选择中心 → 填写姓名/电话/年龄/症状 → 选择预约日期 → 提交
|
||
- **在线自测**：7 道问卷题 → 自动评分 → 提交为意向客户
|
||
- **电话咨询**：直接拨打后台配置的咨询电话
|
||
- **中心详情页**：名称 + 简介 → 立即预约/电话咨询按钮 → 配图
|
||
- **预约成功页**：成功提示 + 返回首页
|
||
|
||
### 手机号授权（可开关）
|
||
|
||
- 打开小程序时自动弹出手机号授权（微信官方 `getPhoneNumber`）
|
||
- 通过 Button `openType="getPhoneNumber"` 获取 code，后端调微信 API 解密手机号
|
||
- 管理后台可控制开关、配置 AppID/AppSecret
|
||
- 同一手机号只创建一条意向客户记录，后续操作补充升级来源
|
||
|
||
### 位置采集（可开关）
|
||
|
||
- 授权时可选采集模糊位置（`getFuzzyLocation` 到市级别）
|
||
- 管理后台显示地区名称（如"江苏省苏州市"）
|
||
- 未开通时可关闭，关闭后不调用定位 API
|
||
|
||
### 管理后台（单页应用）
|
||
|
||
- **概览**：预约统计 + 最近预约列表
|
||
- **首页内容**：轮播图管理 + 三中心管理（图标图片/配图/简介等）
|
||
- **医院简介**：简介文字 + 轮播图片管理
|
||
- **系统设置**：医院名称、咨询电话、地址、微信手机号授权开关、AppID/AppSecret、高德 Key、位置采集开关、企业微信通知配置
|
||
- **预约管理**：查看/确认/完成/取消/删除预约，搜索过滤
|
||
- **意向客户**：查看客户列表、问卷详情（中文显示）、来源筛选
|
||
- **账号设置**：修改密码
|
||
|
||
### 企业微信通知
|
||
|
||
- 新预约、新意向客户时自动推送 Markdown 消息到企业微信群
|
||
- 支持多个 Webhook 地址（每行一个）
|
||
- 通知内容包含患者姓名、电话、科室、日期、症状等详情
|
||
- 管理后台可发送测试通知
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
.
|
||
├── src/ # 小程序前端（Taro + React + TypeScript）
|
||
│ ├── pages/ # 页面
|
||
│ │ ├── home/ # 首页
|
||
│ │ ├── hospital/ # 医院简介
|
||
│ │ ├── appointment/ # 自助预约
|
||
│ │ ├── self-test/ # 在线自测
|
||
│ │ ├── center/ # 中心详情
|
||
│ │ ├── success/ # 预约成功
|
||
│ │ ├── mine/ # 我的（保留）
|
||
│ │ └── phone-consult/ # 电话咨询占位
|
||
│ ├── components/ # 通用组件（PhoneAuthModal 等）
|
||
│ ├── custom-tab-bar/ # 自定义 TabBar（第5个直接拨号）
|
||
│ ├── services/ # API 请求封装
|
||
│ ├── types/ # TypeScript 类型定义
|
||
│ ├── styles/ # 全局样式（theme/variables/compat）
|
||
│ └── utils/ # 工具函数
|
||
├── server/ # Node.js 后端 API
|
||
│ └── src/
|
||
│ ├── modules/ # 业务模块
|
||
│ │ ├── adminAuth/ # 管理员认证
|
||
│ │ ├── appointment/ # 预约
|
||
│ │ ├── banner/ # 轮播图
|
||
│ │ ├── center/ # 中心
|
||
│ │ ├── config/ # 站点/首页配置
|
||
│ │ ├── lead/ # 意向客户
|
||
│ │ ├── notification/ # 企业微信通知
|
||
│ │ ├── wechat/ # 微信手机号服务
|
||
│ │ ├── upload/ # 文件上传
|
||
│ │ └── ... # 其他模块
|
||
│ ├── seeds/ # 种子数据
|
||
│ ├── utils/ # 工具函数
|
||
│ ├── schema.sql # 数据库表结构
|
||
│ └── index.js # 入口
|
||
├── admin/ # 运营管理后台（单页应用）
|
||
│ ├── index.html
|
||
│ ├── app.js
|
||
│ └── styles.css
|
||
├── scripts/ # 部署脚本
|
||
├── dist/ # 构建产物（微信小程序）
|
||
└── project.config.json # 微信开发者工具配置
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Node.js 18+
|
||
- MySQL 8.0+
|
||
- 微信开发者工具（最新稳定版）
|
||
|
||
### 1. 后端
|
||
|
||
```bash
|
||
cd server
|
||
npm install
|
||
# 创建数据库并导入 schema
|
||
mysql -u root -p < src/schema.sql
|
||
# 配置环境变量
|
||
cp .env.example .env
|
||
# 编辑 .env 填写数据库连接信息
|
||
npm start
|
||
# 监听 http://localhost:3000
|
||
```
|
||
|
||
### 2. 小程序前端
|
||
|
||
```bash
|
||
npm install
|
||
npm run build:weapp
|
||
# 用微信开发者工具打开 dist/ 目录
|
||
```
|
||
|
||
### 3. 管理后台
|
||
|
||
管理后台为静态文件，通过后端 Express 托管在 `/admin` 路径下，或通过 Nginx 单独部署。
|
||
|
||
访问 `https://y.szgtlive.com/admin/` 即可。
|
||
|
||
## 主要 API
|
||
|
||
| 接口 | 说明 |
|
||
|------|------|
|
||
| `POST /api/v1/appointments` | 创建预约 |
|
||
| `GET /api/v1/appointments` | 预约列表 |
|
||
| `PUT /api/v1/appointments/:id/confirm` | 确认预约 |
|
||
| `PUT /api/v1/appointments/:id/complete` | 标记完成 |
|
||
| `PUT /api/v1/appointments/:id/cancel` | 取消预约 |
|
||
| `POST /api/v1/leads` | 提交意向客户 |
|
||
| `GET /api/v1/leads` | 意向客户列表 |
|
||
| `GET /api/v1/centers` | 中心列表 |
|
||
| `GET /api/v1/config/home` | 首页配置 |
|
||
| `GET /api/v1/config/site` | 站点配置 |
|
||
| `PUT /api/config/site` | 更新站点配置（管理员） |
|
||
| `POST /api/v1/wechat/phone` | 微信手机号解密 |
|
||
| `GET /api/v1/wechat/phone-required` | 手机号授权开关 |
|
||
| `POST /api/v1/notification/test` | 测试通知 |
|
||
| `POST /api/admin/auth/login` | 管理员登录 |
|
||
|
||
## 技术栈
|
||
|
||
- **前端**：Taro 4.x、React 18、TypeScript 5、Sass
|
||
- **后端**：Node.js、Express 4、MySQL（mysql2/promise）
|
||
- **部署**：PM2 进程管理、Nginx 反向代理、HTTPS
|
||
- **通知**：企业微信 Webhook
|
||
|
||
## 数据存储
|
||
|
||
MySQL 持久化存储，主要表：
|
||
- `centers` — 中心（含 icon_image 图标图片 + image 详情配图）
|
||
- `appointments` — 预约记录
|
||
- `leads` — 意向客户（唯一约束 phone+source 去重）
|
||
- `home_config` — 首页配置 + 系统设置（JSON）
|
||
- `banners` / `hospital_images` / `hospital_intro` — 内容管理
|
||
- `admins` — 管理员账号
|