57 lines
1.6 KiB
Markdown
57 lines
1.6 KiB
Markdown
|
# xk-api-yii 基类架构
|
|||
|
|
|
|||
|
|
## 多应用结构
|
|||
|
|
|
|||
|
|
```mermaid
|
|||
|
|
graph TB
|
|||
|
|
subgraph 应用层
|
|||
|
|
ADMIN[admin/<br/>管理后台]
|
|||
|
|
MEMBER[member/<br/>会员端]
|
|||
|
|
PLATFORM[platform/<br/>平台端]
|
|||
|
|
SERVICE[service/<br/>服务端]
|
|||
|
|
CONSOLE[console/<br/>控制台]
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
subgraph 共享层 common/
|
|||
|
|
MODELS[models/<br/>共享模型]
|
|||
|
|
SERVICES[services/<br/>业务服务]
|
|||
|
|
COMPONENTS[components/<br/>共享组件]
|
|||
|
|
JOBS[jobs/<br/>队列任务]
|
|||
|
|
EVENTS[events/<br/>事件]
|
|||
|
|
HANDLERS[handlers/<br/>事件处理器]
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
ADMIN --> MODELS
|
|||
|
|
MEMBER --> MODELS
|
|||
|
|
PLATFORM --> MODELS
|
|||
|
|
SERVICE --> MODELS
|
|||
|
|
CONSOLE --> MODELS
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 目录说明
|
|||
|
|
|
|||
|
|
| 目录 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| `common/models/` | 共享数据模型（对应 z_o_xk 库表） |
|
|||
|
|
| `common/modelsgii/` | Gii 自动生成的模型 |
|
|||
|
|
| `common/services/` | 业务服务层 |
|
|||
|
|
| `common/components/` | 共享组件（支付、短信等） |
|
|||
|
|
| `common/jobs/` | 队列任务 |
|
|||
|
|
| `common/events/` | 事件定义 |
|
|||
|
|
| `common/handlers/` | 事件处理器 |
|
|||
|
|
| `common/validators/` | 自定义验证器 |
|
|||
|
|
| `common/enums/` | 枚举定义 |
|
|||
|
|
| `common/foundation/` | 基础类 |
|
|||
|
|
| `console/` | 定时任务、控制台命令 |
|
|||
|
|
|
|||
|
|
## 数据库
|
|||
|
|
|
|||
|
|
使用 `z_o_xk` 库，Yii2 风格表名（`yii_*` 前缀）。
|
|||
|
|
|
|||
|
|
## 与 xk-api 的关系
|
|||
|
|
|
|||
|
|
xk-api-yii 是旧系统，xk-api 是新系统。两套系统通过以下方式共存：
|
|||
|
|
- 共享同一个 `z_o_xk` 数据库
|
|||
|
|
- xk-api 通过 `OldApiClient` 调用 xk-api-yii 的接口
|
|||
|
|
- 新功能在 xk-api 中开发，旧功能逐步迁移
|