变更日志

变更日志只记录对使用者有意义的版本变化。完整版本目标和验收边界请看 版本发布。

0.9.0

已发布：

• Money 统一资产编码、账本门面和常用资产目录，完善法币 / Web3 充值提现、商家余额结算、调账审计和资金幂等边界。
• AI Gateway 完善 OpenAI / Claude 协议兼容、Provider 路由、商家供给与定价、Key 用量、计费结算、错误契约和资源上限。
• App / PC / Admin 补齐会话、好友搜索、AI 助手、商城、个人中心和运营管理入口，并收口三端路由、权限、i18n 与类型契约。
• 生命周期加入 ready / shutdown 阶段，异步业务优先通过 Queue 推进、Scheduler 兜底，统一任务注册、补偿和容器资源释放语义。
• 数据库迁移按模块基线、schema / seed 分离和兼容字段类型治理；应用时区、临时资源、备份超时和运行期能力边界进一步加固。
• AI Provider 密文、Gateway Key 策略、幂等键和商家模型发布名的最终类型已折叠进模块建表基线，移除开发期 modifyDataType 迁移。
• 卡券、权益、分销、Outbox、异步任务和广告结算补齐多实例并发守卫；协议值、状态与业务标识固定使用 Locale.ROOT 归一化，不受宿主语言环境影响。
• Queue 轻量 Provider 补齐失败重试，支付回调改用常量时间验签，内容安全和通知 Webhook 复用 HttpClient，避免高频请求泄漏 selector 线程。
• 全仓测试升级 Testcontainers 2.x API 并清理源码编译告警，发布前全量 Maven、前端、Docs 和仓库检查形成统一门禁。

开发基线：V0.9 仍处于 V1.0 前开发期，Money 资产和 Liquibase 只维护当前 contract；部署时使用与当前版本一致的代码、前端、配置和干净数据库。

0.8.0

已发布：

• 全栈联调和生产化复验进入主线，Admin / App / PC 继续补齐真实业务入口、移动端文案和后端 contract 对齐。
• Money、Cashier、Payment Platform、Web3、Mall B2B2C、会员积分和内容付费链路继续强化账本、充值提现、跨链桥、自动确认、商家控制台和结算边界。
• AI、Knowledge、Open Platform、Observability、Feature Flag、Search、WeChat、Live、Reading、Video、Advertising、Distribution、Marketplace 等模块完成本地 contract、Admin 运维入口、mock / smoke 或真实验收 runbook 收口。
• Provider、ServiceProvider、ConfigResolver、Gate / Policy、FormRequest、API Resource、Observer 等 Laravel 式框架层能力继续增强，提升 Spring Boot 之上的应用开发体验。
• 发布工程补齐 release dry-run、当前 contract 门禁、迁移 freeze、安装 smoke、外部 Provider / Web3 / AI B2B2C 验收 runbook 与证据 gate。
• 真实外部链路仍按 外部 Provider 验收清单 单独记录，不把本地 mock / contract smoke 伪装成真实厂商验收。

0.7.0

已发布：

• Admin / App / PC / Install / Docs 五类视图进入主线，覆盖后台运营、移动端、PC 用户端、安装向导和文档站。
• 默认装配、Docker / IDEA 本地启动、TraceId 排障、Liquibase 初始化基线、会员积分运营闭环和全量预发布验证完成收口。
• API Contract 治理、部署更新指南、正式文档入口和 V0.7 发布说明补齐。
• 安装、配置、前端入口、常用环境变量和发布检查文档统一到当前 APP_SECRET / spring.application.secret 与五端静态入口口径。

0.6.0

• 检查并完善已有模块和文档。
• 用户体系、后台管理、动态菜单和权限种子进入上线收口。
• Docker / Nginx / 安装体验继续接近生产部署流程。

0.5.0

• Knowledge、RAG 规划、AI Task 和 AI Agent 友好接口进入框架能力。
• 开放平台补签名、防重放、scope、调用日志和计量基础。

0.4.0

• Payment、Web3、Open Platform、OAuth、Observability 等生态能力进入主线。
• 支付和 Web3 均采用项目抽象边界隐藏第三方 SDK。

0.3.0

• Mail、SMS、Notification、WebSocket、Rate Limit 等常规应用能力收口。
• 通知、短信和邮件开始走 Provider / Channel 抽象。

0.2.0

• Queue、Scheduler、Event、Storage、Logging 等运行时能力收口。
• 文件存储、任务调度和队列开始按 Provider / Connection 扩展。

0.1.0

• Maven 多模块、核心 starter、统一响应、异常、多语言、配置、数据库和基础文档入口完成。

维护规则

• 每次发布正式版本时新增一个版本小节。
• 发布说明草稿可以用 ./scripts/release dry-run --version <version> --since <previous-tag> 从 Git log 生成。
• 变更日志小节模板可以用 ./scripts/release changelog --version <version> --since <previous-tag> 生成，再由维护者人工整理成面向使用者的 3-8 条版本摘要。
• 只写使用者需要知道的变化，不写开发流水。
• Contract 变更必须同步后端、前端、OpenAPI、数据库和 API Contract 治理。
• 模块使用方法继续放在对应模块文档中。