Семейство: DiceAndScore

Кости, таблица очков, треки прогресса.

Игры

kubiki, yatzy, chet_nechet, one_to_twelve, dice_board, shagay_naadan, sunduchki, naidi_chislo, belosnezhka

Use Cases

flowchart LR
    Player((Player)) --> UC_Roll[UC-RollDice]
    Player --> UC_Score[UC-RecordScore]
    Player --> UC_EndTurn[UC-EndTurn]
    System((System)) --> UC_Validate[UC-ValidateCombination]
    UC_Roll --> UC_Validate
    UC_Score --> UC_EndTurn

FSM (обобщённый)

stateDiagram-v2
    [*] --> AwaitRoll: turnStart
    AwaitRoll --> Rolling: rollDice
    Rolling --> AwaitChoice: diceShown
    AwaitChoice --> ScoreEntry: choiceMade
    AwaitChoice --> Reroll: keepDice
    Reroll --> AwaitChoice: rerollDone
    ScoreEntry --> CheckWin: scoreRecorded
    CheckWin --> GameOver: winner
    CheckWin --> NextTurn: continue
    NextTurn --> AwaitRoll: nextPlayer
    GameOver --> [*]

Sequence: типичный ход (Яцзы)

sequenceDiagram
    participant P as Player
    participant API as GameService
    participant D as DiceModule
    participant WS as Realtime

    P->>API: roll_dice
    API->>D: roll(5, d6)
    D-->>API: [3,3,5,2,1]
    API->>WS: state_changed
    P->>API: keep_dice {indices:[0,1]}
    P->>API: score_category {cat: FullHouse}
    API->>API: validate + apply
    API->>WS: state_changed

Shared module: dice.py

# Концепт (Phase 4)
def roll_dice(count: int, sides: int, rng) -> list[int]: ...
def is_valid_yatzy_combo(dice: list[int], category: str) -> bool: ...
def score_yatzy(dice: list[int], category: str) -> int: ...

Per-game вариации

NFR

• NFR-G01: полная серверная валидация
• NFR-G05: reproducible seed в тестах
• FR-035: CSPRNG на сервере