35 lines
2.4 KiB
Markdown
35 lines
2.4 KiB
Markdown
# v0.1.1：统一示例与正式版本发布
|
||
|
||
日期：2026-09-24。目标：以 `main` 交付代码，使用固定版本安装 SDK/Outbox，将功能说明和接入入口集中到根 README。
|
||
|
||
## 内容
|
||
|
||
- 24 个轻量 SDK 示例迁至根 examples module；与原有三个业务数据库工程一起形成 27 个独立场景目录。
|
||
- 每个目录补充 README，根 README 列出功能、准备条件、初始化管理员、调用方式、预期结果、配置及运维入口。
|
||
- 工作区、7 个模块的构建回归、MySQL/控制台/历史兼容脚本同步调整路径；历史版本 checkout 仍使用其原目录。
|
||
- 公共 SDK 生产代码没有改动；公共 MySQL Outbox 核心沿用[已经验收的实现](outbox-http-integration.md)。数据库结构没有因本次目录整理变化。
|
||
|
||
## 本次验证
|
||
|
||
发布前检查结果如下；远端安装结果在发布后回写 main 的本记录：
|
||
|
||
| 检查 | 结果 |
|
||
| --- | --- |
|
||
| 7 模块 `make test vet build` | 通过，退出 0 |
|
||
| `make sdk-check protocol-check docs-check` | 通过；SDK 5 个包、禁止依赖为 0；193 份 Markdown 本地链接有效 |
|
||
| `make integration` | 通过，退出 0；真实 MySQL、27 个示例场景、事务/HTTP 回执丢失、进程强杀及多节点恢复 |
|
||
| `make console-e2e` | 通过；登录/保护路由、Worker/重试/计划、保留策略/周期归档作业、离线核验和退出登录 |
|
||
| 历史任务 API 双向 smoke | 通过；当前 SDK 对 a50d5fa 服务端、a50d5fa SDK 对当前服务端 |
|
||
| 远端 main 与三组标签 | 待发布 |
|
||
| 仓库外固定版本安装、构建、HTTP smoke 与校验和 | 待发布后验证 |
|
||
|
||
## 版本约定
|
||
|
||
服务端 `v0.1.1`、SDK `sdk/go/v0.1.1`、Outbox `adapters/outbox/mysql/v0.1.1` 对齐同一个发布提交。既有 v0.1.0 标签保留，不强推或覆盖。
|
||
|
||
轻量示例及适配包 go.mod 保留 SDK 最低兼容依赖 v0.1.0；在仓库中通过 go.work 测试本地 SDK，在 GOWORK=off 下验证已发布最低依赖。业务安装当前 v0.1.1，不依赖本地 replace。三个业务示例中的 replace 只用于仓库内开发联调。
|
||
|
||
## 边界
|
||
|
||
上述检查验证示例迁移、当前平台链路和远端发布，不等同于目标生产容量或跨故障域验收。历史 API smoke 不冒充全协议跨标签矩阵，具体矩阵见[兼容说明](../sdk/compatibility.md)。归档继续保留源数据，不承诺源数据删除或其他数据库适配。
|