Files
xk-docs/docs/projects/xk-api-yii/architecture.md
2026-07-08 15:04:42 +08:00

1.6 KiB
Raw Blame History

xk-api-yii 基类架构

多应用结构

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_xkYii2 风格表名(yii_* 前缀)。

与 xk-api 的关系

xk-api-yii 是旧系统xk-api 是新系统。两套系统通过以下方式共存:

  • 共享同一个 z_o_xk 数据库
  • xk-api 通过 OldApiClient 调用 xk-api-yii 的接口
  • 新功能在 xk-api 中开发,旧功能逐步迁移