62 lines
2.3 KiB
Go
62 lines
2.3 KiB
Go
// 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
|
||
}
|