Ilia Denisov
35 lines
1.5 KiB
Go
35 lines
1.5 KiB
Go
package ports
|
|
|
|
import (
|
|
"context"
|
|
|
|
"galaxy/lobby/internal/domain/common"
|
|
)
|
|
|
|
// EvaluationGuardStore stores the per-game «already evaluated» marker used
|
|
// by capability evaluation to make replayed `game_finished` events
|
|
// idempotent. reads the marker before any RND mutation: a marker
|
|
// observed before mutation means the prior pass committed in full and the
|
|
// current pass can return without side effects. A marker absent before
|
|
// mutation means either a first attempt or a retry of an interrupted prior
|
|
// attempt; in both cases the evaluator re-runs the idempotent mutations
|
|
// and writes the marker only after every mutation, the stats cleanup, and
|
|
// the post-commit work succeed.
|
|
//
|
|
// The two methods exist to express that read-then-write order: IsEvaluated
|
|
// is a non-mutating check used early in the pass, and MarkEvaluated commits
|
|
// the marker once the pass is fully complete. Implementations must persist
|
|
// the marker durably; an in-process implementation is acceptable only for
|
|
// tests because process restarts must observe the same marker state.
|
|
type EvaluationGuardStore interface {
|
|
// IsEvaluated reports whether gameID is already marked. The method
|
|
// must not mutate state and must distinguish a missing marker from a
|
|
// transport error.
|
|
IsEvaluated(ctx context.Context, gameID common.GameID) (bool, error)
|
|
|
|
// MarkEvaluated records gameID as evaluated. Calling MarkEvaluated
|
|
// twice for the same gameID is safe; the second call leaves the
|
|
// marker untouched.
|
|
MarkEvaluated(ctx context.Context, gameID common.GameID) error
|
|
}
|