From 4eddbdf8e7b3a96ef758a940b50a8ec219cb61fe Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 13 Oct 2026 22:05:35 +0000 Subject: [PATCH] Flusso di rilascio (installatore Windows, immagine Docker, release) e decisioni dell'ondata 5 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA --- .gitea/workflows/rilascio.yml | 134 ++++++++++++++++++++++++++++++++++ docs/decisioni.md | 33 +++++++++ 2 files changed, 167 insertions(+) create mode 100644 .gitea/workflows/rilascio.yml diff --git a/.gitea/workflows/rilascio.yml b/.gitea/workflows/rilascio.yml new file mode 100644 index 0000000..0b9e911 --- /dev/null +++ b/.gitea/workflows/rilascio.yml @@ -0,0 +1,134 @@ +# Rilascio a ogni tag vX.Y.Z (anche vX.Y.Z-qualcosa per un'anteprima): +# 1. controlla che il tag coincida con di Directory.Build.props; +# 2. Windows: pubblica Febe.exe in un file solo e costruisce il programma di installazione NSIS e lo zip portabile +# (installer/costruisci.sh, gira su Linux); +# 3. Docker: costruisce l'immagine (le prove girano dentro la build) e la pubblica sul registro dei container di +# Gitea come //febe:X.Y.Z e :latest (solo per le versioni senza trattino); +# 4. crea la release (o la completa, se esiste già) con installatore, zip portabile, modello Unraid e compose. +# +# Segreto del repository (Impostazioni ▸ Actions ▸ Segreti): REGISTRY_TOKEN, un token dell'utente con i permessi +# «package: read and write». Senza, l'immagine si costruisce ma non si pubblica, e il lavoro lo dice. +# Variabile facoltativa (Impostazioni ▸ Actions ▸ Variabili): REGISTRY, il nome del registro come lo raggiunge il +# runner (per esempio 192.168.30.23:3000); se manca si usa l'host dell'indirizzo del server Gitea. +# Il registro in HTTP: buildx lo tratta come insicuro (configurazione qui sotto). +name: rilascio + +on: + push: + tags: ["v*"] + +jobs: + windows: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + + - name: Versione coerente con il tag + run: | + V=$(sed -n 's:.*\(.*\).*:\1:p' Directory.Build.props | head -n 1) + [ "v$V" = "${GITHUB_REF_NAME}" ] || { echo "Il tag ${GITHUB_REF_NAME} non coincide con $V"; exit 1; } + echo "VERSION=$V" >> "$GITHUB_ENV" + + - uses: actions/setup-dotnet@v4 + with: + dotnet-version: "10.0.x" + + - name: NSIS e zip + run: | + SUDO=""; [ "$(id -u)" = 0 ] || SUDO=sudo + $SUDO apt-get update -qq + $SUDO apt-get install -y -qq nsis zip > /dev/null + + - name: Febe.exe, programma di installazione e zip portabile + run: bash installer/costruisci.sh "$VERSION" + + - uses: actions/upload-artifact@v3 + with: + name: windows + path: | + out/Febe-Setup-*.exe + out/Febe-*-portabile.zip + if-no-files-found: error + + immagine: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + + - name: Versione, registro e nome dell'immagine + run: | + V=$(sed -n 's:.*\(.*\).*:\1:p' Directory.Build.props | head -n 1) + [ "v$V" = "${GITHUB_REF_NAME}" ] || { echo "Il tag ${GITHUB_REF_NAME} non coincide con $V"; exit 1; } + REGISTRY="${{ vars.REGISTRY }}" + [ -n "$REGISTRY" ] || REGISTRY=$(echo "${{ gitea.server_url }}" | sed -E 's#^https?://##; s#/$##') + OWNER=$(echo "${{ gitea.repository_owner }}" | tr '[:upper:]' '[:lower:]') + echo "VERSION=$V" >> "$GITHUB_ENV" + echo "REGISTRY=$REGISTRY" >> "$GITHUB_ENV" + echo "IMAGE=$REGISTRY/$OWNER/febe" >> "$GITHUB_ENV" + + - name: Costruzione dell'immagine (le prove girano dentro la build) + run: | + docker build -f docker/Dockerfile \ + --build-arg VERSION="$VERSION" \ + --build-arg GIT_COMMIT="${GITHUB_SHA::12}" \ + -t "$IMAGE:$VERSION" . + docker run --rm --entrypoint /usr/bin/chromium "$IMAGE:$VERSION" --version + + - name: Pubblicazione sul registro di Gitea + env: + TOKEN: ${{ secrets.REGISTRY_TOKEN }} + run: | + if [ -z "$TOKEN" ]; then + echo "::warning::Manca il segreto REGISTRY_TOKEN: l'immagine è stata costruita ma non pubblicata." + echo "Aggiungi il segreto (token con package: read and write) e rilancia questo lavoro." + exit 1 + fi + echo "$TOKEN" | docker login "$REGISTRY" -u "${{ gitea.actor }}" --password-stdin + docker push "$IMAGE:$VERSION" + case "$VERSION" in + *-*) echo "Versione di anteprima: :latest non si sposta." ;; + *) docker tag "$IMAGE:$VERSION" "$IMAGE:latest" && docker push "$IMAGE:latest" ;; + esac + docker logout "$REGISTRY" + + release: + runs-on: ubuntu-latest + needs: windows + steps: + - uses: actions/checkout@v4 + + - uses: actions/download-artifact@v3 + with: + name: windows + path: out + + - name: Release con installatore, zip portabile, modello Unraid e compose + env: + TOKEN: ${{ github.token }} + API: ${{ gitea.server_url }}/api/v1/repos/${{ gitea.repository }} + run: | + set -eu + TAG="${GITHUB_REF_NAME}" + VERSION="${TAG#v}" + case "$VERSION" in *-*) PRE=true ;; *) PRE=false ;; esac + NOTE=$(awk -v v="$VERSION" '/^## /{p=($2==v)} p' CHANGELOG.md || true) + [ -n "$NOTE" ] || NOTE="Febe $VERSION" + ID=$(curl -sf -H "Authorization: token $TOKEN" "$API/releases/tags/$TAG" | jq -r '.id // empty' || true) + if [ -z "$ID" ]; then + ID=$(jq -n --arg t "$TAG" --arg n "Febe $VERSION" --arg b "$NOTE" --argjson p "$PRE" \ + '{tag_name:$t, name:$n, body:$b, draft:false, prerelease:$p}' \ + | curl -sf -X POST -H "Authorization: token $TOKEN" -H "Content-Type: application/json" \ + --data-binary @- "$API/releases" | jq -r .id) + echo "Release $TAG creata (id $ID)" + else + echo "Release $TAG già presente (id $ID): aggiungo gli allegati mancanti" + fi + cp docker/unraid/febe.xml "out/febe-unraid-$VERSION.xml" + cp docker/compose.yml "out/febe-compose-$VERSION.yml" + ESISTENTI=$(curl -sf -H "Authorization: token $TOKEN" "$API/releases/$ID/assets" | jq -r '.[].name') + for f in out/Febe-Setup-*.exe out/Febe-*-portabile.zip "out/febe-unraid-$VERSION.xml" "out/febe-compose-$VERSION.yml"; do + n=$(basename "$f") + if echo "$ESISTENTI" | grep -qx "$n"; then echo "$n già allegato"; continue; fi + curl -sf -X POST -H "Authorization: token $TOKEN" -F "attachment=@$f" "$API/releases/$ID/assets?name=$n" > /dev/null + echo "$n allegato" + done diff --git a/docs/decisioni.md b/docs/decisioni.md index 9ff5a6d..ad2a486 100644 --- a/docs/decisioni.md +++ b/docs/decisioni.md @@ -142,3 +142,36 @@ Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15). | 2026-10-13 | Modalità di sviluppo `--sito-di-prova` (solo indirizzi locali), `--accesso-di-prova`, `--prima-sessione` | Composizione vera senza Instagram (regola 1) | | 2026-10-13 | Prove d'insieme: orologio compresso 10× e fuso `Etc/GMT±n` dove è mezzogiorno | Motore sempre in fascia, a qualunque ora giri la prova | | 2026-10-13 | Il server reale registra `EngineHostSettingsControl`, un'anteprima vera del browser (`Page.captureScreenshot` al più ogni 4 s, niente sulla pagina vuota) e l'acquisizione della libreria, che riceve subito il nuovo schema dei nomi (`LibraryIngest.Apply`) | Raccordo fra interfaccia parte 2 e composizione del server: i limiti arrivano al motore in esecuzione e lo schema vale per i prossimi file senza riavvio (§4.7) | +| 2026-10-13 | Composizione condivisa in `src/Febe.App` (`FebeApp`, `IFebePlatform`, `IFebeBrowser`); Febe.Server = `DockerPlatform` + `FebeServer` sottile con la stessa superficie; ServerLog→FebeLog, ServerConnectionService→BrowserConnectionService, BrowserSupervisor→ChromiumBrowser, ServerBrowserPreview→LiveBrowserPreview | Un motore e una composizione per le due vesti (§5) | +| 2026-10-13 | Logica di Windows provabile su Linux in `src/Febe.Desktop.Core` (net10.0); in Febe.Desktop solo le chiamate a Windows | Le prove girano su Linux | +| 2026-10-13 | Adattatore CDP di WebView2 (`WebView2CdpSession`) in Febe.Browser dietro `IWebView2DevTools`; eventi in ordine su un ciclo proprio, mai sul thread dell'interfaccia; degli errori del protocollo solo codice e messaggio | Stesse regole del client Chromium; niente blocchi col thread di WPF | +| 2026-10-13 | `WebView2Host` ospita `CoreWebView2Controller` direttamente sull'HWND (pixel reali), non il controllo WPF | `IsVisible` sempre vero; serve anche alla composizione | +| 2026-10-13 | S2: browser fuori dallo schermo, mai nascosto né ridotto a icona (ridurlo = fuori vista); `--disable-features=CalculateNativeWinOcclusion --disable-backgrounding-occluded-windows` | §6.6; gli argomenti non cambiano ciò che il browser dichiara (UA, navigator, lingua, fuso, intestazioni) | +| 2026-10-13 | Modo di S2 con `--browser finestra\|composizione\|edge`, salvato in `desktop.browser`; Edge assente → finestra | Prove di Alberto senza interfaccia apposita | +| 2026-10-13 | Edge: profilo `Dati\browser\edge` (Scollega cancella tutto `Dati\browser`), porta 9222 su 127.0.0.1, password e compilazione automatica spente dalle preferenze del profilo, nessun criterio nel registro | Non toccare l'Edge di Alberto | +| 2026-10-13 | «Browser di Febe» senza pulsante nella barra delle applicazioni; un'attivazione mentre è fuori vista non conta come «Alberto guida» | Windows attiva la finestra successiva quando un'altra si chiude: il motore si fermerebbe da solo | +| 2026-10-13 | Barra sotto la pagina con Indietro, Ricarica e indirizzo senza query (GoBack/Reload di WebView2, non CDP); nel browser di Febe nuove finestre aperte nella stessa, scaricamenti annullati, permessi negati | Navigazione di Alberto, non del motore; la sessione resta nel profilo | +| 2026-10-13 | Interfaccia in un WebView2 con dati propri in `Dati\interfaccia` (in temp se la cartella dei dati ha un problema); ogni altro indirizzo va al browser predefinito; porta 0 con `LoopbackHosts(0)` | §13.1 | +| 2026-10-13 | Istanza unica per cartella dei dati: mutex `Local\Febe-<16 hex SHA-256>`, pipe `CurrentUserOnly`, messaggi `FEBE1 mostra\|nascosto` | Un secondo account con cartelle proprie resta possibile (§3) | +| 2026-10-13 | Cambio della cartella dei dati: registrato in `HKCU\Software\Febe` (CartellaDati, NuovaCartellaDati), applicato al prossimo avvio prima di aprire qualunque cosa; copia riletta con SHA-256, poi la vecchia si cancella; con un errore si resta sulla vecchia; nuova cartella vuota e locale; con `--dati` non disponibile | La sessione non si copia né si lascia in giro (§13.2) | +| 2026-10-13 | Desktop: la libreria è l'impostazione `libreria.cartella` (predefinita Immagini\Febe); il cambio vale subito per i prossimi file (`LibraryIngest.UseLayout`); l'importazione la costruisce `ImportHub` | «I nuovi file andranno in …» | +| 2026-10-13 | Avvisi: `AlertDispatcher` nella composizione condivisa, canali `IAlertChannel` dalle vesti (Windows: notifiche dell'icona; M8: Telegram); codice `disco-quasi-pieno` già mappato | Un aggancio solo per le due vesti | +| 2026-10-13 | Notifiche di Windows con i balloon tip di NotifyIcon; avvio con il computer in HKCU…\Run «Febe» = `"…\Febe.exe" --nascosto` | Nessun pacchetto in più | +| 2026-10-13 | Icona da BrandMark (SkiaSharp) e IcoWriter a mano: DIB a 32 bit fino a 128, PNG a 256; una prova la confronta col disegno | Appendice C, elenco chiuso di §3 | +| 2026-10-13 | Un solo Febe.exe: niente pdb, XML né config/ accanto (target `FebeSingleFileOnly`); `WFO0003` soppresso (app WPF, DPI dal manifesto) | §12 | +| 2026-10-13 | Installatore NSIS per utente in %LOCALAPPDATA%\Programs\Febe senza scelta della cartella, collegamento sul desktop facoltativo (scelto di serie), HKCU Uninstall, WebView2 cercato con «pv» delle chiavi EdgeUpdate, rifiuto se Febe è aperto, `/DVERSION` obbligatorio, disinstallazione che non tocca dati né libreria e dice dove sono | Domanda 6 di §16 | +| 2026-10-13 | «Scollega» che non riesce a cancellare il profilo: browser e motore ripartono, la sessione si ricontrolla, 400 in italiano (entrambe le vesti) | Il motore non deve restare fermo per un file bloccato | +| 2026-10-13 | M9 («collegati a un Febe già in funzione») non fatto | Facoltativo, non banale | +| 2026-10-13 | `AlertService` ascolta la cronologia del motore (codici degli eventi), non lo stato dell'interruttore | Una sola fonte per interfaccia e avvisi; i testi del motore portano già i fatti | +| 2026-10-13 | «Ricetta sospesa» è un avviso a sé, sotto l'interruttore «Formato non riconosciuto»; «avviso-non-inviato» è una riga, mai un avviso | La sospensione è la conseguenza seria; niente catene di avvisi | +| 2026-10-13 | Intervalli minimi: verifica, disconnessione, fermo e ripresa 30 min; storico 24 h per account; formato e ricetta sospesa 6 h; disco 20 h per insieme di dischi. Orari salvati in `avvisi.inviato.*` | Uno stato che va e viene non manda raffiche; un riavvio non ripete | +| 2026-10-13 | Disco quasi pieno: meno di 10 GB o meno del 5%, libreria e dati, controllo 1 min dopo l'avvio e poi ogni 15 min; riga in Attività quando cambia l'insieme e ogni 24 h; disco non misurabile = nessun avviso | Soglie facili da spiegare; vale sia per un array grande sia per un SSD piccolo | +| 2026-10-13 | Telegram: JSON a mano, testo semplice fino a 3.500 caratteri, 15 s, forma del gettone controllata, nessun nuovo tentativo automatico | §13.3, regola 10; l'avviso resta comunque nell'interfaccia | +| 2026-10-13 | Indirizzo di Telegram come stringa assoluta | «bot123:ABC» relativo diventa uno schema | +| 2026-10-13 | `NoTelegramSender` (nuovo nome) come ripiego di Febe.Web; la composizione registra `TelegramAlertChannel` | La dimostrazione e le prove non usano mai la rete | +| 2026-10-13 | Sezione «Avvisi» in Attività (`GET /api/alerts`, 14 giorni) | Storico completato, disco e formato non avevano un posto visibile | +| 2026-10-13 | Ricette sospese in Attività con «Riattiva» | Il motore diceva «si riattiva da Attività», ma non c'era modo | +| 2026-10-13 | «Esporta l'elenco» a sola icona; la riga degli strumenti va a capo sopra i 1000 px | Nella riga del mockup non c'è spazio | +| 2026-10-13 | Guida in `docs/guida`, una pagina per file, collegamenti `[Testo](Pagina)`, prova `Febe.Tests.Docs` | Formato del wiki di Gitea | +| 2026-10-13 | Avvisi collegati una sola volta in `FebeApp` (composizione condivisa): `AlertService` di `Febe.Core.Alerts` con i canali notifica di sistema (`INativeShell`) e Telegram; tolto il gancio doppio `AlertDispatcher` del ramo desktop; `AlertServiceOptions.FolderSource` legge la cartella della libreria a ogni controllo del disco | Un solo meccanismo per le due vesti; sul desktop la libreria può cambiare mentre Febe gira | +| 2026-10-13 | Flusso di rilascio `.gitea/workflows/rilascio.yml` a ogni tag: installatore e zip per Windows costruiti sul runner Linux, immagine Docker costruita e pubblicata sul registro di Gitea con il segreto `REGISTRY_TOKEN` (variabile facoltativa `REGISTRY`), release con allegati creata con il gettone automatico di Actions | Stesso schema di Encelado e Mimante; senza segreto l'immagine si costruisce ma non si pubblica e il lavoro lo dice |