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