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，而不是初始化数据
增加统一鉴权与租户隔离