L'électron rare
20aed903ba
- Voice pipeline: ESP32 WebSocket client → voice bridge → LLM → Piper TTS (Tower :8001) - Hints engine: 3 puzzles (LA_440, LEFOU_PIANO, QR_FINALE), anti-cheat, 3 hint levels - MCP hardware server: 6 tools (puzzle, audio, LED, camera, scenario, status), stdio transport - Analytics: ESP32 module + 6 web endpoints + Dashboard UI with chat interface - Security: auth middleware (Bearer NVS), rate limiting, input validation on 30 endpoints - Frontend: code-split (1.1MB → 210KB initial), ErrorBoundary, API timeout, WS reconnect - Tests: 24 Python + 38 TypeScript + 18 MCP = 80 project tests (+ 19 mascarade) - Specs: AI_INTEGRATION_SPEC, MCP_HARDWARE_SERVER_SPEC, QA_TEST_MATRIX_SPEC - Docs: SECURITY, DEPLOYMENT_RUNBOOK, voice pipeline guide, AI architecture map - 6 AI agent definitions (.github/agents/ai_*.md) - TUI orchestration script (tools/dev/zacus_tui.py) - Docker compose TTS for Tower + KXKM-AI - CHANGELOG, README, mkdocs.yml updated - Cycle detection (DFS) in runtime3 validator - Sprint plan: plans/SPRINT_AI_INTEGRATION.md Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1.7 KiB
1.7 KiB
Repository Structure
Canon de refonte
flowchart TD
YAML["game/scenarios/*.yaml"] --> Runtime3["tools/scenario Runtime 3"]
YAML --> Exports["audio / printables / kit MJ"]
Runtime3 --> Studio["frontend-scratch-v2"]
Runtime3 --> Firmware["hardware/firmware"]
Plans["memory + plans + todos"] --> Studio
Plans --> Firmware
Docs["docs/architecture + specs"] --> Plans
Répertoires principaux
.github/: CI et politiques de validation.audio/: manifestes et ressources audio.docs/: quickstart, architecture, benchmark OSS, runbooks.frontend-scratch-v2/: studio auteur React + Blockly et prévisualisation Runtime 3.game/: scénarios YAML canoniques.hardware/: firmware, scripts de test terrain et documentation matériel.kit-maitre-du-jeu/: déroulé MJ, organisation des stations, scripts de partie.memory/: mémoire projet transversale.plans/: plans directeurs et plans d'agents.printables/: manifestes et sources d'indices imprimables.specs/: spécifications canoniques de la refonte.todos/: backlog opérationnel de la refonte.tools/: validateurs, compilateur/simulateur Runtime 3, shells TUI/CLI.
Règles de structure
game/scenarios/*.yamlreste la source de vérité narrative.hardware/firmware/esp32/est en lecture seule.frontend-scratch-v2/est le front canonique; les chemins legacy doivent sortir du flux principal.- Les artefacts d'exécution restent hors git et sont référencés depuis les TODO ou rapports.
Chemins de référence
- Architecture:
docs/architecture/index.md - Runtime:
specs/ZACUS_RUNTIME_3_SPEC.md - Studio:
specs/STORY_DESIGNER_SCRATCH_LIKE_SPEC.md - Pilotage:
plans/master-plan.md,todos/master.md