112 lines
2.6 KiB
Markdown
112 lines
2.6 KiB
Markdown
|
# xk-api 通用组件
|
|||
|
|
|
|||
|
|
## 支付组件
|
|||
|
|
|
|||
|
|
### 微信支付 (WechatPayService)
|
|||
|
|
- 统一下单、查询、退款
|
|||
|
|
- 回调签名验证 (WechatMiddleware)
|
|||
|
|
- 回调处理 (WechatCallbackService)
|
|||
|
|
|
|||
|
|
### 易票联支付 (EplPayService)
|
|||
|
|
- 统一下单、查询
|
|||
|
|
- 回调签名验证 (EplpayMiddleware)
|
|||
|
|
- 回调处理 (EplpayCallbackService)
|
|||
|
|
- 银行卡上报状态同步
|
|||
|
|
|
|||
|
|
## 认证组件
|
|||
|
|
|
|||
|
|
### JWT (JWTService / MobileJWTService)
|
|||
|
|
- Admin 端和 Mobile 端分别实现
|
|||
|
|
- Token 生成、验证、刷新
|
|||
|
|
- Sanctum 集成
|
|||
|
|
|
|||
|
|
### 角色认证中间件
|
|||
|
|
- `DoctorWxUnifiedAuthMiddleware` — 统一解析医生端多种角色
|
|||
|
|
- `ClinicAdminWxAuthMiddleware` — 门店管理员认证
|
|||
|
|
- `PlatformAdminWxAuthMiddleware` — 平台管理员认证
|
|||
|
|
- `SalespersonWxAuthMiddleware` — 推广员认证
|
|||
|
|
|
|||
|
|
## 文件组件
|
|||
|
|
|
|||
|
|
### 上传 (UploadService)
|
|||
|
|
- 阿里云 OSS 上传
|
|||
|
|
- 支持图片、聊天文件、二维码、注册文件
|
|||
|
|
- 图片压缩处理
|
|||
|
|
|
|||
|
|
### 文件管理 (FileGalleryService)
|
|||
|
|
- 文件分组 (FileGroup)
|
|||
|
|
- 文件类型 (FileType)
|
|||
|
|
- 文件元数据存储
|
|||
|
|
|
|||
|
|
## 短信组件
|
|||
|
|
|
|||
|
|
### 短信服务 (SmsService)
|
|||
|
|
- 阿里云短信 (AliSmsService)
|
|||
|
|
- 统一接口，支持多供应商切换
|
|||
|
|
|
|||
|
|
## 缓存组件
|
|||
|
|
|
|||
|
|
### Redis 服务 (RedisService)
|
|||
|
|
- 通用缓存操作
|
|||
|
|
- 分布式锁
|
|||
|
|
- 会话管理
|
|||
|
|
|
|||
|
|
## HTTP 客户端
|
|||
|
|
|
|||
|
|
| 客户端 | 目标系统 | 用途 |
|
|||
|
|
|--------|----------|------|
|
|||
|
|
| `OldApiClient` | xk-api-yii | 旧系统 API 调用 |
|
|||
|
|
| `OldShopApiClient` | 旧商城 | 旧商城 API |
|
|||
|
|
| `ErpApiClient` | ERP 系统 | ERP 数据同步 |
|
|||
|
|
| `HyApiClient` | 互医平台 | 互医内部 API |
|
|||
|
|
| `MesFailoverClient` | 和利康 MES | 中药智造（自动降级 SOAP→HTTP） |
|
|||
|
|
| `WebSocketApiClient` | IM 服务 | 即时通讯 |
|
|||
|
|
| `WeChatApiClient` | 微信 API | 微信开放平台 |
|
|||
|
|
| `EasyTicketLinkApiClient` | 易票联 | 支付网关 |
|
|||
|
|
| `IpAddressSearchApiClient` | IP 地理位置 | IP 归属地查询 |
|
|||
|
|
|
|||
|
|
## 内容安全
|
|||
|
|
|
|||
|
|
### WeChatContentSecurityService
|
|||
|
|
- 文本内容安全审核
|
|||
|
|
- 图片内容安全审核
|
|||
|
|
- 微信内容安全接口调用
|
|||
|
|
|
|||
|
|
## 监管组件
|
|||
|
|
|
|||
|
|
### HyTransitCryptoService
|
|||
|
|
- AES-128-ECB 加密/解密
|
|||
|
|
- 请求签名 (SignService)
|
|||
|
|
- 文件认证 (FileAuthService)
|
|||
|
|
|
|||
|
|
### HySupervisePayloadValidator
|
|||
|
|
- 监管数据校验
|
|||
|
|
- 字段标签映射 (HySuperviseFieldLabel)
|
|||
|
|
|
|||
|
|
### HyRecipeHtmlRenderer
|
|||
|
|
- 处方打印 HTML 渲染
|
|||
|
|
- 支持中药、西药、颗粒处方
|
|||
|
|
|
|||
|
|
## Excel 组件
|
|||
|
|
|
|||
|
|
### Maatwebsite/Excel
|
|||
|
|
- 数据导出
|
|||
|
|
- 模板导出
|
|||
|
|
|
|||
|
|
### PHPSpreadsheet
|
|||
|
|
- 复杂报表生成
|
|||
|
|
- 大数据量导出
|
|||
|
|
|
|||
|
|
## 工具组件
|
|||
|
|
|
|||
|
|
### AccountOptionService
|
|||
|
|
- 账户选项逻辑（多账户切换）
|
|||
|
|
|
|||
|
|
### DashboardDataService
|
|||
|
|
- 数据大屏数据聚合
|
|||
|
|
- 统计指标计算
|
|||
|
|
|
|||
|
|
### UtilsService
|
|||
|
|
- 通用工具方法
|
|||
|
|
- 错误处理
|