Add persistence layer: TOTP auth, game history, restore

- db/ package: async SQLAlchemy engine + Player/Game/Guess models
- api/auth.py: passwordless TOTP login (pyotp), session token via socket auth
- api/history.py: record guesses/points, DB-backed standings, restore
  unfinished games on startup, host-only end_game
- api/__init__.py: auth-gated handlers, accounts map, rejoin via account
- frontend: Auth (QR + code) and History pages, resume/end-game in lobby/table
- docker-compose: real PostgreSQL service wired via DATABASE_URL
- tests_history.py for the persistence/auth layer; refresh CLAUDE.md

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

frontend/src/store/gameStore.ts

@@ -1,14 +1,31 @@
 import { create } from 'zustand';
-import type { GameInfo, GameStatusPayload, Hand, MyPlayer } from '../types';
+import type {
+  Account,
+  GameDetail,
+  GameInfo,
+  GameStatusPayload,
+  Hand,
+  HistoryGame,
+  MyPlayer,
+  Registration,
+} from '../types';
 
 interface GameStore {
   games: GameInfo[];
+  account: Account | null;
+  registration: Registration | null;
+  history: HistoryGame[];
+  gameDetail: GameDetail | null;
   myPlayer: MyPlayer | null;
   gameStatus: GameStatusPayload | null;
   hand: Hand;
   error: string | null;
 
   setGames: (games: GameInfo[]) => void;
+  setAccount: (account: Account | null) => void;
+  setRegistration: (registration: Registration | null) => void;
+  setHistory: (history: HistoryGame[]) => void;
+  setGameDetail: (detail: GameDetail | null) => void;
   setMyPlayer: (player: MyPlayer | null) => void;
   setGameStatus: (status: GameStatusPayload) => void;
   setHand: (hand: Hand) => void;
@@ -16,16 +33,25 @@ interface GameStore {
   clearError: () => void;
   updatePlayerConnection: (order: number, connected: boolean) => void;
   reset: () => void;
+  logout: () => void;
 }
 
 export const useGameStore = create<GameStore>((set) => ({
   games: [],
+  account: null,
+  registration: null,
+  history: [],
+  gameDetail: null,
   myPlayer: null,
   gameStatus: null,
   hand: {},
   error: null,
 
   setGames: (games) => set({ games }),
+  setAccount: (account) => set({ account }),
+  setRegistration: (registration) => set({ registration }),
+  setHistory: (history) => set({ history }),
+  setGameDetail: (gameDetail) => set({ gameDetail }),
   setMyPlayer: (myPlayer) => set({ myPlayer }),
   setGameStatus: (gameStatus) => set({ gameStatus }),
   setHand: (hand) => set({ hand }),
@@ -43,4 +69,15 @@ export const useGameStore = create<GameStore>((set) => ({
         : null,
     })),
   reset: () => set({ myPlayer: null, gameStatus: null, hand: {}, error: null }),
+  logout: () =>
+    set({
+      account: null,
+      registration: null,
+      history: [],
+      gameDetail: null,
+      myPlayer: null,
+      gameStatus: null,
+      hand: {},
+      error: null,
+    }),
 }));