# xk-api-yii 设计思路

## 架构决策

### Yii2 Advanced

选择 Yii2 Advanced 作为旧系统框架：
- 成熟的 PHP 框架，适合企业级应用
- 多应用模式（admin/member/platform/service）
- 内置 RBAC 权限体系
- Gii 代码生成器

### 多应用分离

每个应用独立部署，共享 common 代码：
- 减少单应用复杂度
- 各应用可独立扩展
- 共享模型和服务层

### 迁移策略

旧系统向新系统迁移的策略：
1. **共享数据库**：两套系统操作同一个 `z_o_xk` 库
2. **接口桥接**：xk-api 通过 `OldApiClient` 调用旧接口
3. **渐进迁移**：新功能在 xk-api 开发，旧功能逐步迁移
4. **数据同步**：通过 Open API 同步关键数据

## 与 xk-api 的关系

| 维度 | xk-api-yii | xk-api |
|------|------------|--------|
| 框架 | Yii2 | Laravel 12 |
| 数据库 | z_o_xk | z_xk + z_o_xk |
| 状态 | 维护模式 | 活跃开发 |
| 功能 | 旧功能 | 新功能 + 迁移功能 |