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 中开发，旧功能逐步迁移
|