# 02 架构设计

## 总体分层

### Android 侧

- `commonsdk-core`：网络、下载、文件、权限、缓存、日志、全局弹窗、时间等基础能力
- `commonsdk-compose`：下拉刷新、折叠面板、左滑操作、WebView、图片等 Compose 组件扩展
- `commonsdk-update`：独立更新 SDK，负责宿主 APK / 插件版本比较、下载编排与安装拉起
- `lib-szyx`：业务登录与会话管理
- `sample-app`：宿主示例
- `plugins/plugin-ui`：插件示例

### 前端侧

- `ops-platform`：运营使用，开放注册、版本上传、发布、灰度圈选
- `admin-platform`：平台治理使用，审核主账户、禁用账户、管理子账户权限

### 服务端

- `version-management-service`：当前主服务
- 后续可继续拆分为账号中心、推送中心、IM 服务、文件服务等独立微服务

## 当前服务端结构

- `controller`：接口层
- `service`：业务编排层
- `persistence/entity`：JPA 实体
- `persistence/repository`：JPA 仓储
- `config`：CORS、Redis、初始化数据等配置

## 演进方向

- 账号体系独立成 `account-service`
- 版本包上传独立成文件存储服务，对接 MinIO 或对象存储
- 灰度用户钩子改为对接真实用户平台 API，而不是初始化数据
- 增加统一鉴权与租户隔离