From a48899f522be28ef0b818ec180e73fb24e58fba3 Mon Sep 17 00:00:00 2001 From: Alberto Balbo Date: Tue, 20 Oct 2026 11:46:36 +0200 Subject: [PATCH] Dati di sviluppo da VS Code in una cartella per checkout MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Il blocco contro le istanze doppie di Febe dipende dalla cartella dei dati: con una sola %USERPROFILE%\FebeSviluppo per tutti i checkout, F5 in un secondo worktree trovava il Febe del primo, gli chiedeva di mostrarsi e finiva subito, e un database migrato da un ramo più nuovo non si apriva più da main. Ora dati, libreria e cartella temporanea della dimostrazione stanno sotto FebeSviluppo\ (${workspaceFolderBasename}), e così il server su Linux. Co-Authored-By: Claude Opus 5.5 --- .vscode/launch.json | 18 +++++++++--------- CLAUDE.md | 2 +- docs/decisioni.md | 4 ++-- docs/guida/Sviluppo.md | 13 ++++++++----- 4 files changed, 20 insertions(+), 17 deletions(-) diff --git a/.vscode/launch.json b/.vscode/launch.json index 5b44080..c42e597 100644 --- a/.vscode/launch.json +++ b/.vscode/launch.json @@ -10,9 +10,9 @@ "program": "${workspaceFolder}/src/Febe.Desktop/bin/Debug/net10.0-windows/Febe.exe", "args": [ "--dati", - "${env:USERPROFILE}\\FebeSviluppo\\dati", + "${env:USERPROFILE}\\FebeSviluppo\\${workspaceFolderBasename}\\dati", "--libreria", - "${env:USERPROFILE}\\FebeSviluppo\\libreria", + "${env:USERPROFILE}\\FebeSviluppo\\${workspaceFolderBasename}\\libreria", "--sito-di-prova", "http://127.0.0.1:8481", "--accesso-di-prova", @@ -55,9 +55,9 @@ "program": "${workspaceFolder}/src/Febe.Desktop/bin/Debug/net10.0-windows/Febe.exe", "args": [ "--dati", - "${env:USERPROFILE}\\FebeSviluppo\\dati", + "${env:USERPROFILE}\\FebeSviluppo\\${workspaceFolderBasename}\\dati", "--libreria", - "${env:USERPROFILE}\\FebeSviluppo\\libreria", + "${env:USERPROFILE}\\FebeSviluppo\\${workspaceFolderBasename}\\libreria", "--sito-di-prova", "http://127.0.0.1:8481", "--accesso-di-prova", @@ -81,8 +81,8 @@ "windows": { "env": { "FEBE_INTERFACCIA": "${workspaceFolder}/src/Febe.Web/wwwroot", - "TEMP": "${env:USERPROFILE}\\FebeSviluppo\\temporanei", - "TMP": "${env:USERPROFILE}\\FebeSviluppo\\temporanei" + "TEMP": "${env:USERPROFILE}\\FebeSviluppo\\${workspaceFolderBasename}\\temporanei", + "TMP": "${env:USERPROFILE}\\FebeSviluppo\\${workspaceFolderBasename}\\temporanei" } }, "cwd": "${workspaceFolder}", @@ -125,11 +125,11 @@ "program": "${workspaceFolder}/src/Febe.Server/bin/Debug/net10.0/febe.dll", "args": [ "--dati", - "${env:HOME}/FebeSviluppo/dati", + "${env:HOME}/FebeSviluppo/${workspaceFolderBasename}/dati", "--libreria", - "${env:HOME}/FebeSviluppo/libreria", + "${env:HOME}/FebeSviluppo/${workspaceFolderBasename}/libreria", "--importa", - "${env:HOME}/FebeSviluppo/importa", + "${env:HOME}/FebeSviluppo/${workspaceFolderBasename}/importa", "--ascolta", "127.0.0.1", "--sito-di-prova", diff --git a/CLAUDE.md b/CLAUDE.md index 468fbdd..68eaf70 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -10,7 +10,7 @@ All'inizio di ogni sessione leggi docs/stato.md. - Avviare in modalità dimostrativa: `dotnet run --project src/Febe.Server -- --demo` - Simulare il motore: `dotnet run --project src/Febe.Server -- --simula 30g --profilo prudente` - Immagine Docker: `docker build -f docker/Dockerfile -t febe .` -- Da VS Code: attività e configurazioni di debug in `.vscode/` (guida: `docs/guida/Sviluppo.md`, «Da VS Code»); Febe per Windows di sviluppo tiene i dati in `%USERPROFILE%\FebeSviluppo`, mai in `%LOCALAPPDATA%\Febe`. +- Da VS Code: attività e configurazioni di debug in `.vscode/` (guida: `docs/guida/Sviluppo.md`, «Da VS Code»); Febe per Windows di sviluppo tiene i dati in `%USERPROFILE%\FebeSviluppo\`, mai in `%LOCALAPPDATA%\Febe`. ## Regole che non si discutono (specifica §2) 1. IMPORTANTE: non contattare mai Instagram da prove, script o verifiche tue. Si usa solo tools/Febe.SitoDiProva. Le prove dal vivo le lancia Alberto. diff --git a/docs/decisioni.md b/docs/decisioni.md index 90a590f..0f18c66 100644 --- a/docs/decisioni.md +++ b/docs/decisioni.md @@ -227,12 +227,12 @@ Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15). | 2026-10-14 | Revisione avversaria di tutto il codice (7 aree, ogni rilievo verificato da un secondo revisore indipendente): 54 rilievi confermati e corretti con prove di regressione, 2 smentiti, 3 incerti corretti dove il rimedio era sicuro | §14, regola 14: resoconti onesti | | 2026-10-14 | Restano noti e accettati: «Tieni il più grande» scrive con il proprio SafeFileWriter e non passa dal lucchetto per account di `LibraryIngest` (un'importazione e uno scaricamento con gli stessi byte nello stesso istante potrebbero entrare entrambi); le prove d'interfaccia con browser vero aspettano fino a 30 s | Finestra rarissima, nessuna perdita di dati: al più un doppione esatto da togliere a mano | | 2026-10-20 | VS Code: configurazione condivisa in `.vscode/` (`launch.json`, `tasks.json`, `extensions.json`, `settings.json` con la sola `dotnet.defaultSolution`); debug con il tipo `coreclr` dell'estensione C#, senza file `launchSettings.json` | Il tipo `dotnet` del C# Dev Kit accetta solo il progetto e un profilo di `launchSettings.json`: niente argomenti, variabili d'ambiente, attività prima e dopo, `serverReadyAction`. Con `coreclr` tutto sta in un file solo | -| 2026-10-20 | Febe per Windows di sviluppo da VS Code con `--dati %USERPROFILE%\FebeSviluppo\dati` e `--libreria %USERPROFILE%\FebeSviluppo\libreria`; il debug avvia `Febe.exe`, non `dotnet Febe.dll` | Mai la cartella vera `%LOCALAPPDATA%\Febe`; fuori dal repository perché profilo del browser e libreria crescono e non devono finire in un commit. Con `Febe.exe` il percorso del processo è quello di Febe e non di `dotnet.exe` (lo usa l'avvio con il computer) | +| 2026-10-20 | Febe per Windows di sviluppo da VS Code con `--dati %USERPROFILE%\FebeSviluppo\\dati` e `--libreria %USERPROFILE%\FebeSviluppo\\libreria` (`${workspaceFolderBasename}`: una cartella per checkout); il debug avvia `Febe.exe`, non `dotnet Febe.dll` | Mai la cartella vera `%LOCALAPPDATA%\Febe`; fuori dal repository perché profilo del browser e libreria crescono e non devono finire in un commit. Una per checkout perché il blocco contro le istanze doppie dipende dalla cartella dei dati (F5 in un secondo worktree mostrava il Febe del primo e finiva subito) e un database migrato da un ramo più nuovo non si apre con una versione più vecchia. Con `Febe.exe` il percorso del processo è quello di Febe e non di `dotnet.exe` (lo usa l'avvio con il computer) | | 2026-10-20 | Attività di compilazione, prove e pubblicazione con `-tl:off -clp:ForceNoAlign` oltre al comando della guida | Registro classico, come nella CI: ogni errore su una riga sola, senza le righe che il terminal logger ridisegna nel terminale; `$msCompile` lo porta nel pannello Problemi (provato con un errore voluto) | | 2026-10-20 | Il sito di prova è un'attività di sfondo, pronta alla riga «Sito di prova: http://» (`activeOnStart`, con `beginsPattern` «(?!)», che non trova mai nulla); a fine debug la ferma un input che esegue `workbench.action.tasks.terminate` | VS Code legge `activeOnStart`, non `activeBegins`: senza, il debug aspettava il sito per sempre. Con «(?!)» nessuna riga successiva rimette l'attività «al lavoro». VS Code non ha un'attività che ne chiuda un'altra: un input di tipo `command` è l'unico modo per farlo da `postDebugTask` | | 2026-10-20 | «Sito di prova + Febe per Windows» non è un compound: la configurazione del sito avvia Febe con `serverReadyAction` (`startDebugging`, `killOnServerStop`) quando il sito scrive di essere pronto | Un compound avvia tutto insieme e senza ordine: Febe con `--accesso-di-prova` poteva cercare il sito prima che ascoltasse | | 2026-10-20 | Le configurazioni legate a un sistema (Febe per Windows; Febe Server con il sito di prova, cioè Chromium su Xvfb) sugli altri sistemi si fermano con un messaggio (attività «solo su Windows» e «solo su Linux»; il server riceve anche solo `--aiuto`) | VS Code non sa nascondere una configurazione per sistema operativo: le proprietà `windows`, `linux` e `osx` contano solo all'avvio | | 2026-10-20 | «⚠ Febe per Windows · Instagram vero (dati veri)» chiede conferma prima di compilare e partire (una scelta sola, Esc annulla) | Regola 1: le prove dal vivo le lancia Alberto; un F5 distratto non deve aprire Instagram con l'account e il database veri | | 2026-10-20 | Tutte le configurazioni di debug scrivono nella Console di debug (`internalConsole`), mai nel terminale integrato; le attività sono di tipo `process`, senza shell | Il terminale integrato e le attività `shell` caricano il profilo di PowerShell: su questo PC il profilo attiva l'ambiente conda di Pinokio, che mette in testa al `PATH` e in `DOTNET_ROOT` un .NET senza SDK e con il solo runtime 8. Lì `dotnet build` non trova l'SDK e Febe (net10.0) non parte («You must install or update .NET»), né come `febe.dll` né come `febe.exe`. Console di debug e attività `process` usano l'ambiente di VS Code | -| 2026-10-20 | La dimostrazione da VS Code serve l'interfaccia dai sorgenti (`FEBE_INTERFACCIA`), apre da sola il browser (`serverReadyAction`) e su Windows tiene la cartella temporanea in `%USERPROFILE%\FebeSviluppo\temporanei` (`TEMP`, `TMP`) | Si modifica `wwwroot` e si ricarica senza ricompilare. Fermata dal debugger, la dimostrazione non può cancellare la sua cartella (una trentina di MB): così resta fra i dati di sviluppo invece di accumularsi in `%TEMP%` | +| 2026-10-20 | La dimostrazione da VS Code serve l'interfaccia dai sorgenti (`FEBE_INTERFACCIA`), apre da sola il browser (`serverReadyAction`) e su Windows tiene la cartella temporanea in `%USERPROFILE%\FebeSviluppo\\temporanei` (`TEMP`, `TMP`) | Si modifica `wwwroot` e si ricarica senza ricompilare. Fermata dal debugger, la dimostrazione non può cancellare la sua cartella (una trentina di MB): così resta fra i dati di sviluppo invece di accumularsi in `%TEMP%` | | 2026-10-20 | I file di `.vscode/` sono JSON rigido, senza commenti: le spiegazioni stanno nella guida (pagina «Sviluppo», «Da VS Code»), nei campi `detail` delle attività e in queste righe | Il controllo «File JSON» della CI legge ogni `*.json` tracciato con `JSON.parse`, e con i commenti `//` il lavoro «controlli» falliva a ogni push dopo l'unione. VS Code legge anche il JSON rigido, così il ramo non dipende da come la CI tratta i commenti | diff --git a/docs/guida/Sviluppo.md b/docs/guida/Sviluppo.md index 3c8c7c7..fce5df8 100644 --- a/docs/guida/Sviluppo.md +++ b/docs/guida/Sviluppo.md @@ -62,9 +62,12 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev | Febe Server · sito di prova (solo Linux) | Il server vero, con Chromium su Xvfb, contro il sito di prova: interfaccia su `127.0.0.1:8480`, password `prova` (come root serve anche `--senza-sandbox`, e `FEBE_CHROMIUM` se Chromium non è nel `PATH`). Su Windows e macOS si ferma con un messaggio; anche con «Esegui comunque il debug» stampa solo l'aiuto | | ⚠ Febe per Windows · Instagram vero (dati veri) | Febe senza opzioni: Instagram vero, `%LOCALAPPDATA%\Febe` e `Immagini\Febe`. Solo per le prove dal vivo di Alberto: chiede conferma, e una versione di sviluppo può aggiornare il database vero. Se Febe installato è aperto, prima esci da lui (menu dell'icona ▸ Esci): un solo Febe per cartella dei dati | -- **Dati di sviluppo.** Febe per Windows di sviluppo tiene dati e libreria in `%USERPROFILE%\FebeSviluppo\dati` e - `%USERPROFILE%\FebeSviluppo\libreria` (il server su Linux in `~/FebeSviluppo`): fuori dal repository e mai nella - cartella vera. Con Febe chiuso si possono cancellare quando vuoi. +- **Dati di sviluppo.** Febe per Windows di sviluppo tiene dati e libreria in + `%USERPROFILE%\FebeSviluppo\\dati` e `%USERPROFILE%\FebeSviluppo\\libreria`, dove `` è + il nome della cartella aperta in VS Code (per esempio `Febe`; il server su Linux in `~/FebeSviluppo/`): + fuori dal repository e mai nella cartella vera. Una cartella per checkout perché su una cartella dei dati gira un + Febe solo (un secondo avvio mostra il primo ed esce) e un database scritto da un ramo più nuovo non si apre con una + versione più vecchia. Con Febe chiuso si possono cancellare quando vuoi. - Chiudendo la finestra Febe resta nell'area di notifica e il debug continua: per finire, menu dell'icona ▸ Esci oppure Maiusc+F5. Finché Febe gira, `compila` non può sovrascrivere `Febe.exe`. - Il sito di prova usa sempre le porte 8481 e 8482, come attività e come configurazione: uno alla volta. @@ -73,8 +76,8 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev `dotnet` non trova l'SDK 10 o Febe non parte («You must install or update .NET»). Se nel terminale `dotnet --list-sdks` non mostra il 10, usa le attività, Git Bash oppure `conda deactivate`. - Fermata dal debugger, la dimostrazione non cancella la sua cartella temporanea (`febe-dimostrazione-…`, una trentina - di MB): da VS Code su Windows finisce in `%USERPROFILE%\FebeSviluppo\temporanei`, che si svuota quando vuoi. Con - `dotnet run --project src/Febe.Server -- --demo` in un terminale, Ctrl+C la chiude in ordine e la cancella. + di MB): da VS Code su Windows finisce in `%USERPROFILE%\FebeSviluppo\\temporanei`, che si svuota quando + vuoi. Con `dotnet run --project src/Febe.Server -- --demo` in un terminale, Ctrl+C la chiude in ordine e la cancella. - Le configurazioni automatiche del C# Dev Kit («C#: …») avviano un progetto senza opzioni: per Febe per Windows vuol dire Instagram vero e dati veri. Usa quelle dell'elenco qui sopra. - Attività (Terminale ▸ Esegui attività): `compila`, `prove` (`dotnet test tests/Febe.Tests`), `prove con filtro`