跳到正文

开源 · Go 1.24+ · MIT

给 Go 支付 / 账本用的
CQRS + Event Sourcing 库

go-sequent 帮你把「改余额」做成可审计的事件流:一次数据库事务、挂在 context 上的 UnitOfWork,以及 SyncInTxn(在写事务里同步更新余额等读模型)。 概念参考 Sequent(Ruby),API 与数据模型是 Go 独立实现。

go get github.com/go-sequent/go-sequent@latest

什么时候用它

余额必须跟写入同一事务;多个商户共用一张表(Tenant);需要完整的 Command / Event 审计记录。

余额跟得上写入

Command、Aggregate、事件追加,以及更新余额表的 Projector,都在同一个数据库事务里完成。提交返回后,立刻能读到自己刚写的数据。

可核对、可并发

每个聚合一条 hash chain,用来发现事件是否被改过;OCC 用版本号挡住并发写冲突;Unique keys 按 Tenant 限定业务唯一性。

金融场景默认带上

金额用 decimal(types.Money)、命令带审计 Meta、Idempotency(同一业务键重复提交只生效一次)、AuthZ,以及共享 schema 的多 Tenant。

纯库,嵌进你的服务

不内置 HTTP。把 go-sequent 接进现有进程,选 PostgreSQL 或内存存储;迁移与 Outbox 轮询用 CLI。

核心闭环

01

Command

用类型化 Command 和 Meta 表达「要做什么」。

02

Aggregate

校验规则后 Apply 事件;状态只在 applier 里改。

03

EventStore

追加事件:OCC、Unique keys、按聚合的 hash chain。

04

Projector

同一写事务里更新余额等查询用读模型。

写进库的默认约定

这些选择已经定死,运维和审计不用猜。

  • 余额等账本读模型:SyncInTxn(写事务内更新)
  • 金额:decimal(types.Money),禁止 float64
  • 完整性:hash chain,不做事件签名
  • 多租户:共享 schema + tenant_id
  • GDPR:Tombstone(追加标记事件,读模型不再暴露个人数据)
  • Outbox:Postgres 表 + 轮询投递
demo, err := bank.NewDemoApp(bank.DemoOptions{
  StoreFactory: memoryFactory,
  Idempotency:  idempotency.NewMemory,
  Authorizer:   bank.AllowBankCommands,
  EnableTenancyMW: true,
})
ctx = tenancy.WithTenant(ctx, tenantID)
err = demo.App.Service.Execute(ctx, &bank.OpenAccount{ /* … */ })
bal, _ := demo.Projector.Balance(accountID)

从 Bank 示例开始

内存版随时可跑集成测试;Postgres 版演示生产形态的余额表。