# 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)。数据库结构没有因本次目录整理变化。

## 本次验证

本地检查与发布后远端安装均已完成，结果如下：

| 检查 | 结果 |
| --- | --- |
| 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 与三组标签 | 原子推送成功，默认分支 main；三组标签均指向发布提交 81e56bd633cfe9f7669b4243dee5d7683e5f6697 |
| 仓库外固定版本安装、构建、HTTP smoke 与校验和 | 空模块缓存、GOWORK=off、无 replace；两个模块精确解析为 v0.1.1，全部退出 0 |

## 版本约定

服务端 `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)。归档继续保留源数据，不承诺源数据删除或其他数据库适配。

## 远端发布证据

发布提交为 `81e56bd633cfe9f7669b4243dee5d7683e5f6697`。通过 `git ls-remote --symref origin` 核对默认分支为 main，平台/SDK/Outbox 三组标签解引用到同一提交。随后仅补充本验证记录，既有标签不移动。远端 main 的根 README 与 examples/README 原文逐字节核对一致。

在仓库外新建 `example.com/orbit-release-consumer`，使用全新 GOPATH/GOMODCACHE、`GOWORK=off`，执行：

```sh
go get git.yuntuo.hk/k2safe/orbit/sdk/go@v0.1.1 git.yuntuo.hk/k2safe/orbit/adapters/outbox/mysql@v0.1.1
go mod tidy
go build ./...
go run .
go mod verify
```

测试程序通过远端 SDK 调用本地 httptest 服务的健康接口，并读取远端 Outbox SchemaSQL 核对表名及零外键；这一步验证远端包安装与可用性，真实数据库事务/HTTP 业务链路由上方全量回归覆盖。实际输出：

```text
remote_sdk_http_smoke=passed outbox_schema_smoke=passed
all modules verified
remote_versions=v0.1.1 no_replace=true checksum_verification=enabled
```

验证进程使用 `GOPROXY=https://goproxy.cn,direct`，仅在该进程沿用主机已有网络代理；`GOSUMDB=sum.golang.org` 保持开启，未关闭校验和、未设置私有模块例外、未修改全局 Go/Git 配置。解析结果：

```text
git.yuntuo.hk/k2safe/orbit/sdk/go v0.1.1 h1:xikN6Frz7HJsHdh4e3iHG9sX4cJNlRjKh0Wn/ApN3XI=
git.yuntuo.hk/k2safe/orbit/sdk/go v0.1.1/go.mod h1:9KlMW7Gy+EGaDoEwr3wHHFY47mnAymSfYeQpMS7h4ag=
git.yuntuo.hk/k2safe/orbit/adapters/outbox/mysql v0.1.1 h1:oqRfqtAq6Q1CWss4RFH1jnGu8S+2xr5e+QmeC5zfMPE=
git.yuntuo.hk/k2safe/orbit/adapters/outbox/mysql v0.1.1/go.mod h1:G+8DIXGFFssSeQ9T1HahnKUyoKNlF2GQDB21ENO3xqk=
```