200 lines
5.0 KiB
Markdown
200 lines
5.0 KiB
Markdown
# 系统架构
|
||
|
||
## 整体架构
|
||
|
||
```mermaid
|
||
graph TB
|
||
subgraph 客户端
|
||
U[患者小程序<br/>xk-client-wx]
|
||
D[医生小程序<br/>xk-doctor-wx]
|
||
A[管理后台<br/>xk-admin]
|
||
S[数据大屏<br/>xk-data]
|
||
end
|
||
|
||
subgraph API层
|
||
API[xk-api<br/>Laravel 12]
|
||
YII[xk-api-yii<br/>Yii2 遗留]
|
||
end
|
||
|
||
subgraph 数据层
|
||
DB1[(z_xk<br/>新库)]
|
||
DB2[(z_o_xk<br/>旧库)]
|
||
RD[(Redis)]
|
||
MQ[(RabbitMQ)]
|
||
OSS[(阿里云 OSS)]
|
||
end
|
||
|
||
subgraph 外部集成
|
||
PAY1[微信支付]
|
||
PAY2[易票联支付]
|
||
SMS[短信服务]
|
||
HY[xk-hy-forward-go<br/>Go 转发]
|
||
GOV[浙江省政务云<br/>监管平台]
|
||
MES[和利康 MES<br/>中药智造]
|
||
ERP[ERP 系统]
|
||
KUAI100[快递100]
|
||
end
|
||
|
||
U --> API
|
||
D --> API
|
||
A --> API
|
||
S --> API
|
||
API --> DB1
|
||
API --> DB2
|
||
API --> RD
|
||
API --> MQ
|
||
API --> OSS
|
||
API --> PAY1
|
||
API --> PAY2
|
||
API --> SMS
|
||
API --> HY
|
||
API --> MES
|
||
API --> ERP
|
||
API --> KUAI100
|
||
HY --> GOV
|
||
```
|
||
|
||
## 双数据库策略
|
||
|
||
系统同时连接两个 MySQL 数据库：
|
||
|
||
```mermaid
|
||
graph LR
|
||
subgraph z_xk 新库 67张表
|
||
A1[管理后台 xk_admin]
|
||
A2[财务 xk_account_*]
|
||
A3[销售 xk_salesperson_*]
|
||
A4[处方 xk_special_prescription*]
|
||
A5[监管 xk_hy_transit_*]
|
||
A6[系统配置 xk_system_config]
|
||
end
|
||
|
||
subgraph z_o_xk 旧库 约100张表
|
||
B1[药品 yii_drug]
|
||
B2[订单 yii_product_order]
|
||
B3[处方 yii_prescription]
|
||
B4[用户 yii_user]
|
||
B5[门店 yii_store]
|
||
B6[医生 yii_doctor_info]
|
||
B7[挂号 yii_register]
|
||
end
|
||
|
||
API[xk-api] -->|读写| A1
|
||
API -->|读写| A2
|
||
API -->|读写| A3
|
||
API -->|读写| B1
|
||
API -->|读写| B2
|
||
API -->|读写| B3
|
||
```
|
||
|
||
::: warning 跨库注意事项
|
||
- 新库和旧库之间**不允许 JOIN 查询**
|
||
- 跨库关联需要在应用层做两步查询
|
||
- 定时任务 `app:accrue-salesperson-commission` 需要同时查两个库
|
||
:::
|
||
|
||
## API 路由架构
|
||
|
||
xk-api 通过路由文件划分不同端的接口：
|
||
|
||
| 路由文件 | 前缀 | 用途 | 认证方式 |
|
||
|----------|------|------|----------|
|
||
| `admin.php` | `/api/admin` | 管理后台 API | JWT (AdminAuthMiddleware) |
|
||
| `mobile.php` | `/api/mobile` | 患者小程序 API | JWT (MobileAuthMiddleware) |
|
||
| `doctor.php` | `/api/doctor` | 医生端小程序 API | 多种角色中间件 |
|
||
| `hy.php` | `/api/hy` | 互联网医院监管 API | HyTransitApiMiddleware |
|
||
| `callback.php` | `/api/callback` | 支付回调 | 签名验证 |
|
||
| `open-api.php` | `/api/open` | 开放 API | 无/简单认证 |
|
||
|
||
## 中间件链
|
||
|
||
```mermaid
|
||
graph LR
|
||
REQ[请求] --> CORS[CORS]
|
||
CORS --> THROTTLE[限流]
|
||
THROTTLE --> AUTH{认证中间件}
|
||
AUTH -->|Admin| JWT[JWT验证]
|
||
AUTH -->|Mobile| MJWT[Mobile JWT]
|
||
AUTH -->|Doctor| DROLE[角色验证]
|
||
AUTH -->|Hy| HTOKEN[Hy Transit Token]
|
||
JWT --> LOG[操作日志]
|
||
MJWT --> LOG
|
||
DROLE --> LOG
|
||
HTOKEN --> LOG
|
||
LOG --> CTRL[Controller]
|
||
```
|
||
|
||
## 消息队列架构
|
||
|
||
```mermaid
|
||
graph TB
|
||
subgraph 生产者
|
||
P1[订单支付回调]
|
||
P2[挂号支付回调]
|
||
P3[退款回调]
|
||
P4[定时任务]
|
||
end
|
||
|
||
subgraph RabbitMQ
|
||
Q1[default 队列]
|
||
Q2[failed_jobs]
|
||
end
|
||
|
||
subgraph 消费者 Job
|
||
J1[ProductOrderPaidJob<br/>分账结算]
|
||
J2[RegisterPaidJob<br/>挂号分账]
|
||
J3[ProductOrderRefundJob<br/>退款处理]
|
||
J4[SalespersonCommissionRefundJob<br/>佣金冲销]
|
||
J5[AutoConfirmReceiptOrderJob<br/>自动确认收货]
|
||
J6[AutomaticallyCancelTheOrderJob<br/>自动取消订单]
|
||
J7[AutoExpirePrescriptionHandlerJob<br/>处方过期处理]
|
||
J8[SyncDrugPriceBySubscribeJob<br/>药品价格同步]
|
||
end
|
||
|
||
P1 --> Q1
|
||
P2 --> Q1
|
||
P3 --> Q1
|
||
P4 --> Q1
|
||
Q1 --> J1
|
||
Q1 --> J2
|
||
Q1 --> J3
|
||
Q1 --> J4
|
||
Q1 --> J5
|
||
Q1 --> J6
|
||
Q1 --> J7
|
||
Q1 --> J8
|
||
```
|
||
|
||
## 监管数据流转
|
||
|
||
```mermaid
|
||
sequenceDiagram
|
||
participant API as xk-api
|
||
participant GO as xk-hy-forward-go
|
||
participant GOV as 浙江省政务云
|
||
|
||
Note over API: 定时触发 / 手动拉取
|
||
API->>API: 1. 创建批次 (batch/create)
|
||
API->>API: 2. 拉取数据 (supervise/consult, /recipe, ...)
|
||
API->>API: 3. 加密打包数据
|
||
API->>GO: 4. 转发加密数据
|
||
GO->>GOV: 5. 透传至政务云
|
||
GOV-->>GO: 6. 返回处理结果
|
||
GO-->>API: 7. 回调结果
|
||
API->>API: 8. 更新批次状态
|
||
```
|
||
|
||
## 部署架构
|
||
|
||
| 服务 | 部署方式 | 说明 |
|
||
|------|----------|------|
|
||
| xk-api | 服务器 + LaravelS | PHP-FPM + LaravelS 常驻进程 |
|
||
| xk-admin | CDN / Nginx | 静态资源部署 |
|
||
| xk-client-wx | 微信小程序平台 | HBuilderX 上传 |
|
||
| xk-doctor-wx | 微信小程序平台 | HBuilderX 上传 |
|
||
| xk-data | 服务器 / CDN | 静态页面 |
|
||
| xk-hy-forward-go | 内网服务器 | Windows 部署，run.bat 启动 |
|
||
| MySQL | 服务器 | 双库部署 |
|
||
| Redis | 服务器 | 缓存 / 队列 |
|
||
| RabbitMQ | 服务器 | 消息队列 |
|