beta v0.2 dualcheck

server/internal/store/session_store.go

@@ -17,6 +17,7 @@ type Session struct {
 // ParticipantInfo 参与者在全量快照中的状态
 type ParticipantInfo struct {
 	Nickname  string `json:"nickname"`
+	BrowserID string `json:"browser_id,omitempty"`
 	Submitted bool   `json:"submitted"`
 	Match     *bool  `json:"match,omitempty"`
 }
@@ -26,33 +27,52 @@ type SessionSnapshot struct {
 	SessionID          string            `json:"session_id"`
 	InitiatorHash      string            `json:"-"` // 发起方标准答案哈希，不对外暴露
 	InitiatorNickname  string            `json:"initiator_nickname"`
+	InitiatorBrowserID string            `json:"initiator_browser_id,omitempty"`
 	InitiatorSubmitted bool              `json:"initiator_submitted"`
 	AllowResubmit      bool              `json:"allow_resubmit"`
+	IgnoreWs           bool              `json:"ignore_ws"` // 是否忽略首尾空白
 	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
+	// Create 原子创建会话（SET NX EX），同时记录发起方昵称和 browserId
+	Create(ctx context.Context, id, initiatorNickname, initiatorBrowserID string, ttl time.Duration) error
 
-	// SubmitInitiator 发起方提交标准答案（initiator_hash + initiator_nickname）
+	// SubmitInitiator 发起方提交标准答案（initiator_hash + initiator_nickname + 原始文本）
 	// 同时立即为所有已提交的参与者计算 match
-	SubmitInitiator(ctx context.Context, sessionID, nickname, hashHex string) error
+	SubmitInitiator(ctx context.Context, sessionID, nickname, hashHex, originalText string) error
 
-	// SubmitParticipant 参与者提交自己的文本（按 nickname 唯一标识）
+	// SubmitParticipant 参与者提交自己的文本（按 nickname 唯一标识，同时存原始文本）
 	// 返回：initiatorSubmitted（发起方是否已提交，是则 match 已算出）、match
-	SubmitParticipant(ctx context.Context, sessionID, nickname, hashHex string) (
+	SubmitParticipant(ctx context.Context, sessionID, nickname, hashHex, originalText string) (
 		initiatorSubmitted bool, match *bool, err error)
 
 	// JoinParticipant 参与者加入会话（只登记昵称，不提交文本）
-	// 用于 WS 连接时实时广播 joined 事件
-	JoinParticipant(ctx context.Context, sessionID, nickname string) error
+	// browserId 用于识别"同一个人"，避免跨 tab 昵称冲突
+	JoinParticipant(ctx context.Context, sessionID, nickname, browserID string) error
 
 	// SetResubmit 设置是否允许参与者重复提交
 	SetResubmit(ctx context.Context, sessionID string, allow bool) error
 
+	// SetIgnoreWs 设置比对时是否忽略首尾空白（1=忽略，0=不忽略）
+	SetIgnoreWs(ctx context.Context, sessionID string, ignore bool) error
+
+	// GetIgnoreWs 获取当前会话的 ignore_ws 设置
+	GetIgnoreWs(ctx context.Context, sessionID string) (bool, error)
+
+	// RecalcMatches 按新的 ignoreWs 规则重新 trim + hash 所有已提交文本并重算 match
+	RecalcMatches(ctx context.Context, sessionID string, ignoreWs bool) error
+
+	// UpdateParticipantNickname 原子重命名参与者：将 participant:{old} → participant:{new}
+	// oldBrowserID 用于判断是否与冲突方是同一个浏览器（跳过冲突）
+	// 返回业务错误：ErrSessionNotFound / ErrNicknameConflict
+	UpdateParticipantNickname(ctx context.Context, sessionID, oldNick, newNick, oldBrowserID string) error
+
+	// RemoveParticipant 参与者离开时从 Redis 删除其所有字段（hash/text/match）
+	RemoveParticipant(ctx context.Context, sessionID, nickname string) error
+
 	// Get 获取会话当前状态全量快照
 	Get(ctx context.Context, sessionID string) (*SessionSnapshot, error)