From 9c1bab5224da28a00edd7fc4a001ba86ccf93ccb Mon Sep 17 00:00:00 2001 From: Alberto Balbo Date: Wed, 23 Sep 2026 13:24:30 +0200 Subject: [PATCH] 5.0 Fase 9: documenti, screenshot, risposte D-28/29/36/37, piano concluso MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README con gli screenshot e l'avvio rapido Docker; CLAUDE.md, architettura, runbook, problemi noti, glossario, fonti dei dati e apprendimento riscritti per il container e l'interfaccia web; il post-mortem spiega gli accrediti del demo (uno per ordine ridotto, dal ledger ricevuto); le skill seguono la catena nuova. Lo stato dice che il piano 5.0 è completo e che il rilascio 5.0.0 resta una decisione dell'utente. Co-Authored-By: Claude Fable 5.1 --- .../.claude/skills/encelado-release/SKILL.md | 12 +- Encelado/.claude/skills/encelado-ui/SKILL.md | 24 +-- .../.claude/skills/encelado-verify/SKILL.md | 9 +- Encelado/CHANGELOG.md | 10 + Encelado/CLAUDE.md | 47 +++-- Encelado/README.md | 62 ++++++ Encelado/docs/ARCHITECTURE.md | 187 +++++++---------- Encelado/docs/DATA_SOURCES.md | 9 +- Encelado/docs/GLOSSARY.md | 6 + Encelado/docs/KNOWN_ISSUES.md | 18 +- Encelado/docs/ML_AND_LEARNING.md | 23 ++- Encelado/docs/PIANO_5.0.md | 2 +- Encelado/docs/POSTMORTEM_ordini_pendenti.md | 4 +- Encelado/docs/PROMPT_5.0.md | 188 ++++++++++++++++++ Encelado/docs/QUESTIONS.md | 10 +- Encelado/docs/RUNBOOK.md | 89 +++++---- Encelado/docs/STATE.md | 30 ++- 17 files changed, 497 insertions(+), 233 deletions(-) create mode 100644 Encelado/README.md create mode 100644 Encelado/docs/PROMPT_5.0.md diff --git a/Encelado/.claude/skills/encelado-release/SKILL.md b/Encelado/.claude/skills/encelado-release/SKILL.md index 3271793..c7c8e6d 100644 --- a/Encelado/.claude/skills/encelado-release/SKILL.md +++ b/Encelado/.claude/skills/encelado-release/SKILL.md @@ -1,16 +1,16 @@ --- name: encelado-release -description: Rilascio di Encelado: verifica, tag, installatore Windows, immagine Docker e template Unraid, in quest'ordine e solo dopo il commit e il push del ramo. +description: Rilascio di Encelado: verifica, zip portabile, immagine Docker, tag, push dell'immagine sul registro di Gitea e release con il template Unraid, in quest'ordine e solo dopo il commit e il push del ramo. --- # Rilascio di Encelado -Presupposti: albero pulito, ultima sessione committata e pushata, `/encelado-verify` verde, versione decisa dall'utente (semver; la 5.0.0 è la prima con web UI e Docker). +Presupposti: albero pulito, ultima sessione committata e pushata, `/encelado-verify` verde, Docker in esecuzione, `build/gitea.json` presente (mai committato: vedi `build/gitea.example.json`; il token deve avere anche `package: read and write`), versione decisa dall'utente (semver; la 5.0.0 è la prima con web UI e Docker). 1. `dotnet msbuild build/Release.proj -t:Verifica`. -2. `dotnet msbuild build/Release.proj -t:Rilascia -p:Versione=`: crea il tag git, l'installatore Inno Setup (`bin/installer/Encelado_.exe`), lo zip e la release su Gitea (`build/gitea.json`, mai committato: vedi `build/gitea.example.json`). La versione viene dal tag, non da un file. -3. Docker (dalla Fase 8 della 5.0): `dotnet msbuild build/Release.proj -t:Docker -p:Versione=` costruisce `encelado:` e `encelado:latest`; poi `docker push /encelado:` verso il registry deciso in D-29. -4. Template Unraid: aggiorna `deploy/unraid/encelado.xml` se sono cambiate variabili, porte o volumi; l'`Icon` punta al PNG raw del repository. +2. `dotnet msbuild build/Release.proj -t:Rilascia -p:Versione=` (note in `ENCELADO_NOTE`): pubblica la cartella portabile, costruisce l'immagine `192.168.30.23:3000/alby96/encelado:` e `:latest` (i test girano anche dentro la build), crea il tag, lo spinge e lo verifica sul remoto, fa il push dell'immagine sul registro di Gitea, crea la release con lo zip portabile e il template Unraid allegati. La versione viene dal tag, non da un file. +3. Template Unraid: aggiorna `deploy/unraid/encelado.xml` se sono cambiate variabili, porte o volumi; l'`Icon` è `assets/encelado.png` raw su Gitea (D-29). Il file finisce comunque allegato alla release con la versione nel nome. +4. Su Unraid: *Docker ▸ Controlla aggiornamenti*; il container riparte con SIGTERM pulito e recupero dopo inattività. 5. `CHANGELOG.md` e `docs/STATE.md` riportano la versione rilasciata; il tag e la release hanno lo stesso testo del CHANGELOG. -Non modificare `build/Release.proj` o `build/Encelado.iss` se non richiesto: la catena è condivisa con Mimante e AutoBidder. +Senza Docker: `-p:SaltaDocker=true` produce solo lo zip (non è un rilascio completo, e va detto). Non modificare `build/Release.proj` se non richiesto: la catena è condivisa con Mimante e AutoBidder. diff --git a/Encelado/.claude/skills/encelado-ui/SKILL.md b/Encelado/.claude/skills/encelado-ui/SKILL.md index 1f70437..2b256f1 100644 --- a/Encelado/.claude/skills/encelado-ui/SKILL.md +++ b/Encelado/.claude/skills/encelado-ui/SKILL.md @@ -1,21 +1,21 @@ --- name: encelado-ui -description: Regole per toccare l'interfaccia di Encelado: i token Material 3 e le linee guida di docs/UI_GUIDELINES.md, nessuna libreria, stesse informazioni della dashboard. +description: Regole per toccare l'interfaccia web di Encelado: i token Material 3 e le linee guida di docs/UI_GUIDELINES.md, nessuna libreria, stesse informazioni della dashboard, test dell'HTML e dello stream. --- # Lavorare sull'interfaccia di Encelado -Finché esiste il progetto WPF (`src/Encelado.Bot`, fino alla Fase 7 della 5.0): tema in `Ui/Theme.xaml`, pagine in `Ui/Pages`, nessuna decisione nella UI (legge lo snapshot, manda comandi via `IUiActions`), orari via `UiClock`, test di binding (`UiBindingTests`) e di rendering (`ENCELADO_RENDER_DIR= dotnet test tests/Encelado.Tests --filter UiRenderTests`). +L'interfaccia è servita dal bot (`src/Encelado.Server/Web/wwwroot/`: `index.html`, `login.html`, `app.css`, `app.js`, `icon.svg`, `manifest.webmanifest`, incorporati come `EmbeddedResource`). Le API stanno in `Web/WebHost.cs`, lo snapshot JSON in `Engine/SnapshotJson.cs`, i dati finti in `Engine/SampleSnapshot.cs`. Leggi `docs/UI_GUIDELINES.md` prima di scrivere una riga. In sintesi: -Dalla web UI (Fase 7): leggi `docs/UI_GUIDELINES.md` prima di scrivere una riga. In sintesi: - -- HTML + CSS + JavaScript vanilla incorporati come `EmbeddedResource` nel server; nessun framework, nessun font remoto, nessun `