dual check v0.1

server/internal/store/session_store.go

@@ -0,0 +1,61 @@
+// Package store 提供会话存储接口
+// 接口解耦使得可以在测试中用 mock 替换，生产用 Redis
+package store
+
+import (
+	"context"
+	"time"
+)
+
+// Session 存储的会话数据结构（不含敏感字段）
+type Session struct {
+	ID        string    `json:"session_id"`
+	ExpiresAt time.Time `json:"expires_at"`
+	CreatedAt time.Time `json:"created_at"`
+}
+
+// ParticipantInfo 参与者在全量快照中的状态
+type ParticipantInfo struct {
+	Nickname  string `json:"nickname"`
+	Submitted bool   `json:"submitted"`
+	Match     *bool  `json:"match,omitempty"`
+}
+
+// SessionSnapshot Get 返回的全量快照
+type SessionSnapshot struct {
+	SessionID          string            `json:"session_id"`
+	InitiatorHash      string            `json:"-"` // 发起方标准答案哈希，不对外暴露
+	InitiatorNickname  string            `json:"initiator_nickname"`
+	InitiatorSubmitted bool              `json:"initiator_submitted"`
+	AllowResubmit      bool              `json:"allow_resubmit"`
+	Participants       []ParticipantInfo `json:"participants"`
+	ExpiresAt          time.Time         `json:"expires_at"`
+}
+
+// SessionStore 会话存储接口
+type SessionStore interface {
+	// Create 原子创建会话（SET NX EX）
+	Create(ctx context.Context, id string, ttl time.Duration) error
+
+	// SubmitInitiator 发起方提交标准答案（initiator_hash + initiator_nickname）
+	// 同时立即为所有已提交的参与者计算 match
+	SubmitInitiator(ctx context.Context, sessionID, nickname, hashHex string) error
+
+	// SubmitParticipant 参与者提交自己的文本（按 nickname 唯一标识）
+	// 返回：initiatorSubmitted（发起方是否已提交，是则 match 已算出）、match
+	SubmitParticipant(ctx context.Context, sessionID, nickname, hashHex string) (
+		initiatorSubmitted bool, match *bool, err error)
+
+	// JoinParticipant 参与者加入会话（只登记昵称，不提交文本）
+	// 用于 WS 连接时实时广播 joined 事件
+	JoinParticipant(ctx context.Context, sessionID, nickname string) error
+
+	// SetResubmit 设置是否允许参与者重复提交
+	SetResubmit(ctx context.Context, sessionID string, allow bool) error
+
+	// Get 获取会话当前状态全量快照
+	Get(ctx context.Context, sessionID string) (*SessionSnapshot, error)
+
+	// Delete 删除会话
+	Delete(ctx context.Context, sessionID string) error
+}