electron-rare/le-mystere-professeur-zacus

Files

T

L'électron rare 20aed903ba feat: AI integration — voice pipeline, hints engine, MCP server, analytics, security

- 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>

2026-03-22 13:52:45 +01:00

2.1 KiB

Raw Blame History

Zacus Story Designer — React 19 + Blockly

Studio auteur visuel pour concevoir des scenarios Zacus avec des blocs type Scratch. Genere du YAML canonique et communique avec le firmware ESP32 via l'API Story V2.

Setup

cd frontend-scratch-v2
npm install
npm run dev

Connexion API (optionnel) :

VITE_STORY_API_BASE=http://<esp_ip>:8080 npm run dev

Scripts disponibles

Commande	Description
`npm run dev`	Serveur de dev Vite (HMR)
`npm run build`	Build production (`dist/`)
`npm test`	Tests Vitest (18 tests)
`npm run lint`	ESLint

Architecture

L'interface s'organise en 4 onglets :

Onglet	Composant	Role
Designer	`BlocklyDesigner.tsx`	Editeur blocs + generation YAML live
Dashboard	`Dashboard.tsx`	Vue d'ensemble scenario
Media	`MediaManager.tsx`	Gestion assets audio/image
Network	`NetworkPanel.tsx`	Monitoring devices terrain

Autres fichiers cles :

src/components/RuntimeControls.tsx — actions HTTP Story V2 (list, status, validate, deploy)
src/lib/scenario.ts — mapping blocs → document scenario → YAML
src/types.ts — types TypeScript du document scenario

Stack OSS

Brique	Version	Licence	Role
blockly	12.4.1	Apache-2.0	editeur blocs
yaml	2.8.2	ISC	serialisation YAML
zod	4.3.6	MIT	validation locale
ajv	8.18.0	MIT	JSON schema
@monaco-editor/react	4.7.0	MIT	vue YAML

Note : scratch-gui / scratch-vm sont AGPL-3.0, non retenus pour garder un front permissif.

API Story V2

Methode	Endpoint	Description
GET	`/api/story/list`	Liste des scenarios
GET	`/api/story/status`	Statut runtime
POST	`/api/story/validate`	Validation YAML
POST	`/api/story/deploy`	Deploiement sur device

Variable d'environnement : VITE_STORY_API_BASE (defaut : pas de proxy).

Tests

18 tests passing (Vitest). Lancer avec npm test.

Prochaines etapes

Mapping complet steps + transitions (FSM) avec validation croisee
Import/export Blockly JSON
Tests E2E avec API mock

2.1 KiB Raw Blame History