Skip to content

Flows

This section documents how data and actions flow through the system — from the user's perspective, through the backend, and into storage.

Categories

User flows

Interactive workflows visible to the player.

  • Training session — PWA quiz loop with spaced repetition
  • Game review — Chess.com-style game review with eval bar, score chart, move classifications
  • Analyze selected games — Fetch games, select for analysis, generate training positions
  • Setup wizard — CLI interactive configuration
  • Config management — CLI setup + PWA unified settings

Data flows

How data moves through the system.

  • Data lifecycle — From chess platforms to practice sessions
  • SRS algorithm — SM-2 spaced repetition scheduling

System flows

Infrastructure and runtime internals.

  • CI/CD pipeline — Test, build, deploy on push
  • PWA mode detection — Demo vs application mode
  • Service worker & caching — Offline access and updates
  • Stockfish lifecycle — Detection, crash recovery, WASM fallback
  • Bug reporting and autocorrection — Crash reporter → GitHub issues → /fix-issues command

Meta flows

How this documentation stays up to date.

  • Auto-documentation hooks — Claude hooks + CI image generation

Image generation

Mermaid diagrams in these pages have corresponding SVG images in the images/ directory, generated automatically by CI on every push to main or dev. See Meta flows for details.