Kalidoku
Daily multi-domain puzzle game (Connections-style) with a real leaderboard. Rust (Axum + SeaORM) backend, Astro 4 + Svelte 5 frontend, mobile-first PWA, Capacitor-ready. AGPL-3.0.
kalidoku
Puzzle quotidien type Connections : remplis une grille 3×3 avec des entités qui satisfont à la fois le critère de leur ligne et celui de leur colonne. Mode lancement : stations du métro parisien. Architecture multi-domaine : ajout de RER, Transilien, SNCF, aéroports internationaux, et au-delà (Pokémon, films, NBA, etc.) sans toucher au moteur.
Stack
| Couche | Tech |
|---|---|
| Moteur (lib) | Rust pur, serde, thiserror |
| Backend HTTP | Rust, Axum, SeaORM, Tokio |
| Worker génération | Rust (binaire séparé partageant core/) |
| Base de données | PostgreSQL 16 |
| Cache / queue | Valkey (fork OSS Redis) |
| Frontend | Astro 4 + Svelte 5 + Tailwind 4 + shadcn-svelte |
| i18n | paraglide-js (FR/EN) |
| Auth | Keycloak (auth.calixteair.fr), realm kalidoku, OIDC PKCE, Google + Discord + email/password |
| Secrets | OpenBao (secrets.calixteair.fr), bao-agent systemd Option B |
| Mobile | PWA + Capacitor-ready (web réutilisé tel quel pour iOS/Android plus tard) |
| Logging | tracing JSON → Docker stdout → agent Wazuh host (wazuh.calixteair.fr) |
| Reverse proxy | Nginx Proxy Manager (npm.calixteair.fr) |
| CI/CD | GitHub Actions → Docker Hub → SSH ci-kalidoku → bao-deploy.sh |
Modes de jeu
MVP
- Daily : grille du jour, 1 partie par device, leaderboard public.
- Solo aléatoire : 3 grilles/jour gratuites, génération à la demande.
Phase 2 (gating prêt dans le code, pas activé)
- Solo illimité + Duels entre amis illimités → premium ~3-5 €/mois (Stripe).
- Score d'originalité (rareté pondérée live).
Modules / dossiers
.
├── core/ Rust lib pure (Entity, Predicate, Solver, Validator)
├── server/ Backend Axum (API REST OpenAPI)
├── worker/ Cron + génération à la demande
├── web/ Astro + Svelte (front responsive mobile-first)
├── domains/
│ └── paris-metro/ Domain pack #1 (entities.json + predicates.json)
├── contracts/
│ ├── entity-schema.json JSON Schema des entités/prédicats
│ └── openapi.yaml Contrat HTTP backend ↔ front
├── infra/
│ ├── docker/ Dockerfiles
│ ├── bao/ Policy + agent.hcl + scripts setup OpenBao
│ └── scripts/ Scripts ops (snapshot DB, etc.)
├── docs/ Architecture, sécurité, runbooks
└── .github/ Workflows CI/CD + templates
Setup dev (local)
Prérequis
- Rust stable +
cargo,rustfmt,clippy - Node 22+, pnpm 9+
- Docker + Docker Compose plugin
sqlx-cli(cargo install sqlx-cli --no-default-features --features postgres)sea-orm-cli(cargo install sea-orm-cli)gitleaks(brew install gitleaksou équivalent)
Premier démarrage
# 1. Cloner et installer
git clone [email protected]:Calixteair/kalidoku.git
cd kalidoku
pnpm --dir web install
# 2. Lancer Postgres + Valkey en local
docker compose -f infra/docker/compose.dev.yaml up -d
# 3. Setup DB
cd server
cp .env.example .env # contient des creds dev locaux uniquement
sea-orm-cli migrate up
# 4. Lancer le backend en watch
cargo watch -x 'run -p kalidoku-server'
# 5. Dans un autre terminal, lancer le front
cd web && pnpm dev
L'API tourne sur http://localhost:8080, le front sur http://localhost:4321.
Tests
# Rust
cargo test --workspace
# Front
cd web && pnpm test
# E2E (Playwright)
cd web && pnpm exec playwright test
Lint avant commit
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cd web && pnpm lint && pnpm typecheck
gitleaks protect --staged
Déploiement
Auto via GitHub Actions sur merge dans main. Voir .github/workflows/ et docs/deploy.md.
Contribuer
- Issues bienvenues, voir
.github/ISSUE_TEMPLATE/. - PRs : respecter
CLAUDE.md(conventions, sécurité, mobile-first). - Pas de mention d'IA dans commits/PR (cf.
CLAUDE.md§2).
Licence
AGPL-3.0. Tout fork hébergé doit publier ses modifications.
Crédits / inspiration
Concept inspiré de métrodoku.fr (jeu solo non lié, code propriétaire). kalidoku est une réécriture from-scratch, multi-domaine, open source.
