# 版本管理服务
版本管理服务 用于统一管理各平台的客户端版本，向客户端提供「检查更新、获取最新版本」的能力，并汇总客户端上报的版本分布情况。
进入方式见 子系统 - 进入方式。
# 菜单总览
| 菜单 | 用途 |
|---|---|
| 版本管理 | 创建版本、提交测试、发布与下线 |
| 用户版本信息 | 查看版本分布统计与用户设备上报明细（只读） |
# 一、版本管理
# 查询与列表
页面顶部提供以下筛选条件，点击 查询 生效，点击 重置 清空条件：
| 条件 | 匹配方式 |
|---|---|
| 平台 | 下拉选择 |
| 版本号 | 模糊匹配 |
| 数字版本号 | 精确匹配 |
| 状态 | 下拉选择 |
| 升级类型 | 下拉选择 |
| 创建时间 | 时间范围 |
列表字段：
| 列 | 说明 |
|---|---|
| 平台 | 版本所属平台 |
| 版本号 | 展示用版本号，如 1.2.0 |
| 数字版本号 | 用于版本大小比较的整数 |
| 状态 | 草稿 / 测试 / 已发布 / 已下线 |
| 升级类型 | 无需升级 / 可选升级 / 强制升级 |
| 最低版本 | 低于该版本时强制升级 |
| 更新说明 | 多条说明以「；」拼接展示，悬停可查看完整内容 |
| 包大小 | 自动格式化为 B / KB / MB |
| 发布时间 | 该版本实际发布的时间 |
| 创建时间 | 该版本的创建时间 |
| 操作 | 编辑、提交测试、发布、下线、删除 |
# 添加 / 编辑版本
点击 添加版本（或行内 编辑）打开表单：
| 字段 | 必填 | 说明 |
|---|---|---|
| 平台 | 是 | 版本所属平台 |
| 版本号 | 是 | 展示用版本号，如 1.0.0 / v2.1.5 |
| 数字版本号 | 是 | 整数，用于版本大小比较，如 1.2.0 = 10200 |
| 升级类型 | 否 | 默认 可选升级 |
| 下载地址 | 否 | 安装包下载地址（https://...） |
| 最低支持版本 | 否 | 低于该版本强制升级，如 1.5.0 |
| 安装包大小(字节) | 否 | 填写字节数，列表自动换算展示 |
| 安装包MD5 | 否 | 客户端下载后校验包完整性 |
| 更新说明 | 否 | 每行填写一条，保存时按行拆分为多条 |
提示：
- 数字版本号 是客户端比较版本大小的依据，必须与版本号语义对应且随版本递增，避免错填导致客户端无法正确判断更新。
- 保存前请仔细核对 下载地址 与 MD5，客户端会据此校验安装包完整性。
# 版本状态与流转
版本状态按以下顺序流转：
草稿(DRAFT) → 提交测试 → 测试(TESTING) → 发布 → 已发布(ONLINE) → 下线 → 已下线(OFFLINE)
| 操作 | 显示条件 | 说明 |
|---|---|---|
| 编辑 | 始终显示 | 修改版本信息 |
| 提交测试 | 状态 非 已发布 且 非 测试 | 将版本提交进入测试状态，需二次确认 |
| 发布 | 状态为 测试 | 将版本正式发布，需二次确认 |
| 下线 | 状态为 已发布 | 将已发布版本下线，需二次确认 |
| 删除 | 始终显示 | 删除该版本记录，需二次确认 |
重要：发布 时，同一平台下其它 已发布 版本会被 自动下线，即每个平台同时只有一个已发布版本。发布前请确认新版本已通过测试。
下线后 客户端将无法再获取该版本，请谨慎操作。
# 二、用户版本信息
该页面为 只读，用于查看客户端上报的版本分布情况，不提供新增或修改。
# 版本分布统计
页面顶部为版本分布统计：
- 以 环形图 按版本维度展示各版本的占比；
- 右上角显示 总用户 X 人 / 总设备 Y 台；
- 可按 平台 筛选后重新统计；
- 若暂无数据，会提示「暂无统计数据，请先在客户端上报版本信息」。
提示：统计数据来源于客户端上报。若统计为空，请先确认客户端已接入并调用了 版本上报 接口。
# 数据列表
查询条件：
| 条件 | 匹配方式 |
|---|---|
| 用户ID | 精确匹配 |
| 平台 | 下拉选择 |
| 版本号 | 模糊匹配 |
| 数字版本号 | 精确匹配 |
| 设备ID | 精确匹配 |
| 设备类型 | 下拉选择 |
| 渠道 | 精确匹配 |
| 上报时间 | 时间范围 |
列表字段：用户ID、平台、版本号、数字版本号、设备ID、设备名称、设备类型、系统版本、渠道、网络类型、最近上报时间。
# 三、枚举参考
| 分类 | 可选值 |
|---|---|
| 平台 | WEB、ANDROID、IOS、WINDOWS、MACOS、LINUX、SDK、PLUGIN |
| 版本状态 | DRAFT（草稿）、TESTING（测试）、ONLINE（已发布）、OFFLINE（已下线） |
| 升级类型 | NONE（无需升级）、OPTIONAL（可选升级）、FORCE（强制升级） |
| 设备类型 | PHONE（手机）、TABLET（平板）、PC（电脑）、WEB（浏览器）、UNKNOWN（未知） |
| 网络类型 | WIFI、4G、5G、UNKNOWN（未知） |
# 常见问题
Q1：发布新版本后，旧版本为什么自动变成「已下线」？
这是预期行为。同一平台下只能存在一个「已发布」版本，发布新版本时其它已发布版本会自动下线，以保证客户端获取到唯一的最新版本。
Q2：「提交测试」按钮为什么不显示？
当版本状态为 已发布 或 测试 时不显示。请确认当前版本状态，已发布版本需先 下线 才能再次提交测试。
Q3：用户版本信息页面为什么没有数据？
该页面数据来自客户端上报，请确认：
Q4：数字版本号如何填写？
按「主版本 ×10000 + 次版本 ×100 + 修订号」的方式换算，例如 1.2.0 对应 10200，1.2.3 对应 10203。它决定了客户端判断「是否有新版本」的结果，需随版本发布递增。
← 用户基础服务