Clément SAILLANT
121 lines
2.9 KiB
Markdown
121 lines
2.9 KiB
Markdown
---
|
||
# Zacus WebUI (Story V2)
|
||
// TODO NO DEV FINISH (need KILL_LIFE ?)
|
||
|
||
Frontend Mission Control pour les devices Zacus.
|
||
|
||
---
|
||
|
||
## 📝 Description
|
||
|
||
Interface web de pilotage, design et diagnostic pour les firmwares Zacus (Story V2 et legacy).
|
||
|
||
---
|
||
|
||
## 📦 Fonctionnalités principales
|
||
|
||
- Sélecteur de scénario avancé (recherche, tri, mode legacy, CTA adaptés)
|
||
- Orchestrateur live (statut runtime, recovery, filtres, contrôles réseau)
|
||
- Story Designer nodal (Cytoscape.js, import/export YAML, édition guidée, auto-layout)
|
||
- UI harmonisée (glass modern, labels FR, accessibilité)
|
||
|
||
---
|
||
|
||
## 🚀 Installation & démarrage rapide
|
||
|
||
```bash
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
Accès local : http://localhost:5173
|
||
Accès LAN : http://<ip-machine>:5173
|
||
|
||
Preset ESP :
|
||
```bash
|
||
npm run dev:esp
|
||
```
|
||
|
||
---
|
||
|
||
## 🛠️ Usage
|
||
|
||
Détection automatique du firmware connecté :
|
||
- `story_v2` : endpoints `/api/story/*` + WebSocket
|
||
- `freenove_legacy` : endpoints `/api/status`, `/api/scenario/*`, `/api/stream` (SSE)
|
||
|
||
Diagnostics firmware :
|
||
- Version, OTA, reboot détectés automatiquement
|
||
- État affiché dans le panneau "Firmware"
|
||
|
||
Variables d'environnement :
|
||
- `VITE_API_BASE` (ex: `http://192.168.0.91`)
|
||
- `VITE_API_PROBE_PORTS` (défaut: `80,8080`)
|
||
- `VITE_API_FLAVOR` (`auto|story_v2|freenove_legacy`, défaut `auto`)
|
||
- `VITE_API_ACCESS_MODE` (`hybrid|direct|proxy`, défaut `hybrid`)
|
||
- `VITE_ZACUS_STUDIO_AI_URL` (ex: `http://127.0.0.1:8787/story_generate`) pour activer la génération IA locale des scénarios et du manifeste imprimables.
|
||
|
||
Intégration IA locale (Docker) :
|
||
|
||
```bash
|
||
cd tools/dev/docker-studio-ai
|
||
cp .env.example .env
|
||
docker compose up -d --build
|
||
docker exec -it zacus-ollama ollama pull qwen2.5-coder:14b
|
||
```
|
||
|
||
Puis lancer le frontend avec `fronted dev web UI/.env.local` :
|
||
|
||
```bash
|
||
VITE_ZACUS_STUDIO_AI_URL=http://127.0.0.1:8787/story_generate
|
||
```
|
||
|
||
---
|
||
|
||
## 🤝 Contribuer
|
||
|
||
Les contributions sont bienvenues !
|
||
Merci de lire [../../CONTRIBUTING.md](../../CONTRIBUTING.md) avant toute PR.
|
||
|
||
---
|
||
|
||
## 🧑🎓 Licence
|
||
|
||
- **Code** : MIT (`../../LICENSE`)
|
||
|
||
---
|
||
|
||
## 👤 Contact
|
||
|
||
Pour toute question ou suggestion, ouvre une issue GitHub ou contacte l’auteur principal :
|
||
- Clément SAILLANT — [github.com/electron-rare](https://github.com/electron-rare)
|
||
|
||
- Preview local: `http://localhost:4173`
|
||
- Preview LAN: `http://<ip-machine>:4173`
|
||
|
||
Build + preview:
|
||
|
||
```bash
|
||
npm run preview:esp:build
|
||
```
|
||
|
||
## Tests / gates frontend
|
||
|
||
```bash
|
||
npm run lint
|
||
npm run build
|
||
npm run test:unit
|
||
npm run test:e2e
|
||
npm run test:e2e:live
|
||
```
|
||
|
||
- `test:unit`: validation parser/generation YAML Story Designer.
|
||
- `playwright @mock`: detection Story V2/legacy, UX et regressions principales.
|
||
- `playwright @live`: tests live sur `192.168.0.91` (actions mutantes autorisees).
|
||
|
||
## Notes live
|
||
|
||
- La suite `@live` execute des actions de controle (`unlock`, `next`, `wifi reconnect`, `espnow off/on`).
|
||
- Un finalizer force `espnow on` en fin de run.
|
||
- A lancer sur une fenetre de test dediee (pas pendant une partie active).
|