Initial open source release

internal/store/update_event.go

@@ -0,0 +1,26 @@
+package store
+
+import (
+	"context"
+
+	"telesrv/internal/domain"
+)
+
+// UpdateEventStore 持久化 user 维度的增量事件。
+type UpdateEventStore interface {
+	Append(ctx context.Context, userID int64, event domain.UpdateEvent) error
+	ListAfter(ctx context.Context, userID int64, pts, limit int) ([]domain.UpdateEvent, error)
+	Current(ctx context.Context, userID int64) (int, error)
+	// MaxContiguousPts 返回从 1 起无空洞的最大已提交 pts。
+	// 并发发送在途时（pts 已分配未提交）会暂时小于 Current（最大已提交），空洞提交/补洞后回升。
+	// getState/getDifference 据此只暴露连续 pts，避免客户端跳过在途空洞而丢消息。
+	MaxContiguousPts(ctx context.Context, userID int64) (int, error)
+	// AdvanceContiguousPts 推进并返回账号级连续 pts 水位。实现应在写事件的同一事务内调用。
+	AdvanceContiguousPts(ctx context.Context, userID int64) (int, error)
+}
+
+// EventCursor 精确定位单条账号事件，用于 outbox worker 批量加载已 claim 事件。
+type EventCursor struct {
+	UserID int64
+	Pts    int
+}