Welcome to Dice Chess Lab

Welcome to the Dice Chess Lab technical documentation!

Dice Chess Lab is an analysis and training platform for Dice Chess, a variant where dice determine which pieces can move each turn. This repository contains the backend API and frontend PWA used to ingest tournament games, inspect move history, and train in Guess the Move workflows.

This documentation serves as the central knowledge base for the project. For deeper technical reference, explore the sidebar on the left.

Project Goals

1. Training & Practice: Provide an interactive environment to practice Dice Chess situations (Guess the Move) based on real tournament games.
2. Analysis & Exploration: Ingest and parse complex move histories, making game metadata accessible for statistical analysis.
3. Performance on Edge Devices: Ensure the platform remains lightweight, responsive, and capable of running smoothly on constrained hardware like older mobile phones and Raspberry Pi servers.
4. Offline Capabilities: Utilize PWA architecture to offer seamless interactions even under unstable network conditions.

Roadmap

• v0.1 - Foundation: Basic PWA, DB schema, Auth, Game Browser, Core Docs
• v0.2 - Training Simulator: Interactive training, board auto-flip, favorites
• v0.3 - Data Pipeline & ETL: Automated data fetching, CLI limits, SQLite WAL writes
• v0.4 - Probability Engine & Analytics: Algorithmic probability calculator, UI integration
• v0.5 - Big Data & Opening Explorer: Move tree generation, Win Rates, DB performance
• v1.0 - Cloud Migration: Serverless, PostgreSQL

Getting Started

To get started with development, explore the System Architecture overview, or check out the Local Development & Mock Auth guide.