版本与兼容性政策

Forge Admin 遵循语义化版本号规范，并承诺合理的升级兼容性。

语义化版本号

版本号格式为 主版本.次版本.修订版本（MAJOR.MINOR.PATCH）：

版本段	说明	示例
主版本（MAJOR）	不兼容的 API 变更	1.0.0 → 2.0.0
次版本（MINOR）	向下兼容的功能新增	1.0.0 → 1.1.0
修订版本（PATCH）	向下兼容的缺陷修复	1.0.0 → 1.0.1

LTS 版本策略

Forge Admin 维护以下版本类型：

版本类型	维护周期	安全补丁	说明
当前版本	至下一版本发布	✅	最新稳定版，推荐新项目使用
LTS 版本	发布后 12 个月	✅	长期支持版，推荐企业生产环境使用
历史版本	不维护	❌	仅提供归档下载

💡 v1.0.0 作为首个正式版本，自动获得 LTS 待遇到 2026-08-08。

升级兼容承诺

次版本升级（如 1.0.0 → 1.1.0）

• ✅ 数据库 Schema 向前兼容，无需手动迁移
• ✅ API 接口向下兼容，前端无需改动
• ✅ 配置文件向下兼容，新增配置有默认值
• ⚠️ 可能新增可选依赖，不影响现有功能

修订版本升级（如 1.0.0 → 1.0.1）

• ✅ 完全向下兼容，直接替换 jar 包即可
• ✅ 无数据库变更
• ✅ 无配置文件变更

主版本升级（如 1.x → 2.0.0）

• ⚠️ 可能存在不兼容变更
• ⚠️ 需要按升级指南进行数据迁移
• ⚠️ 可能需要调整前端代码
• 📖 参考 升级索引 获取详细迁移步骤

废弃通知机制

当某个 API 或配置项计划废弃时，按以下流程通知：

1. 标记废弃：在代码中添加 @Deprecated 注解，并在文档中标注
2. 过渡期：至少保留 2 个次版本（约 6 个月）继续可用
3. 日志告警：启动时打印废弃警告日志
4. 正式移除：在下一个主版本中移除

/**
 * @deprecated 请使用 {@link #newMethod()} 替代，将在 2.0.0 移除
 */
@Deprecated
public void oldMethod() { ... }

💡 建议订阅 Gitee Watch 及时获取版本发布通知。