# 版本记录

代码交付主分支为 `main`。采用 `v主版本.次版本.修订号`，已发布标签不可变；补丁按 `v0.1.1`、`v0.1.2` 递增，业务项目固定具体版本。

## v0.1.1 — 2026-09-24

本版汇总 v0.1.0 之后已完成的控制台、运维和业务接入能力，并统一示例和接入文档。

### 新增及完善

- 控制台账号密码登录、页面访问保护、初始化管理员与登录页；前端自动使用同源服务地址。
- Compose 迁移/权限收紧/核验/启动链、域名反向代理示例及两节点部署覆盖配置。
- 可配置的历史保留策略、归档文件作业、周期归档计划及控制台作业管理。
- 跨节点重连、慢消费者、锁等待/死锁、增长与归档的隔离回归，详细范围见各验收报告。
- 独立 MySQL 事务 Outbox 适配包：调用方事务入队、受理确认钩子、持久预算与有界后台发送。
- 现有 HTTP 服务嵌入示例：业务事务 → Outbox → Worker → 可靠结果 → Inbox，含健康检查和有界关闭。
- 根 `examples/` 集中 27 个可运行场景，各有 README；首页按功能、启动、SDK、配置和运维组织。

### 版本与升级

| 发布物 | Git 标签 | 引用方式 |
| --- | --- | --- |
| 平台源码 | `v0.1.1` | 检出该标签构建服务端 |
| Go SDK | `sdk/go/v0.1.1` | `go get git.yuntuo.hk/k2safe/orbit/sdk/go@v0.1.1` |
| MySQL Outbox | `adapters/outbox/mysql/v0.1.1` | `go get git.yuntuo.hk/k2safe/orbit/adapters/outbox/mysql@v0.1.1` |

SDK 公共方法与 v0.1.0 保持一致，示例从 `sdk/go/examples/<name>` 移至 `examples/<name>`；原先 `cd sdk/go && go run ./examples/worker` 改为 `cd examples && go run ./worker`。示例不是业务导入包，核心 SDK 导入路径不变。

服务端数据库基线为 schema v31。已有数据库按[运行手册](docs/20-operations-runbook.md)备份、停旧写节点、执行前向迁移及 `orbit-admin verify`，然后启动新服务；不覆盖旧迁移文件。Outbox 表属于独立业务数据库，由业务迁移管理。

[本版发布核验](docs/reports/v0.1.1-release.md)记录本地回归、远端版本和外部项目安装结果。保留策略及归档不会自动删除源数据；生产跨故障域高可用和容量仍按[交付清单](docs/release-checklist.md)验收。

## v0.1.0

首个 SDK 接入版本，平台和 SDK 已使用不可变标签发布。远端安装与最初门禁证据见[首版发布报告](docs/reports/phase-7-sdk-remote-release.md)。