diff --git a/.vscode/extensions.json b/.vscode/extensions.json index 8682b19..d19cdaa 100644 --- a/.vscode/extensions.json +++ b/.vscode/extensions.json @@ -1,4 +1,3 @@ -// Estensioni consigliate per Febe: C# Dev Kit (soluzione, prove) e C# (linguaggio e debugger «coreclr» di launch.json). { "recommendations": ["ms-dotnettools.csdevkit", "ms-dotnettools.csharp"] } diff --git a/.vscode/launch.json b/.vscode/launch.json index 2490e2a..5b44080 100644 --- a/.vscode/launch.json +++ b/.vscode/launch.json @@ -1,18 +1,7 @@ -// Configurazioni di debug di Febe (guida: docs/guida/Sviluppo.md, «Da VS Code»). Tipo «coreclr» dell'estensione C#. -// - Prima di partire compilano tutta la soluzione con l'attività «compila» (.vscode/tasks.json). -// - Febe per Windows di sviluppo tiene dati e libreria in %USERPROFILE%\FebeSviluppo: mai in %LOCALAPPDATA%\Febe. -// - Nessuna configurazione contatta Instagram tranne l'ultima, «⚠ Febe per Windows · Instagram vero (dati veri)»: -// è per le prove dal vivo di Alberto (regola 1) e chiede conferma prima di partire. -// - VS Code non sa nascondere una configurazione per sistema operativo: quelle che non possono girare su un sistema -// lì si fermano subito con un messaggio (attività «solo su Windows» e «solo su Linux»). -// - Tutte usano la Console di debug («internalConsole»), mai il terminale integrato: il terminale carica il profilo di -// PowerShell, che può mettere davanti un altro .NET (per esempio quello di un ambiente conda, con il solo .NET 8, e -// il programma non parte). La Console di debug usa l'ambiente di VS Code. { "version": "0.2.0", "configurations": [ { - // Il sito di prova parte come attività di sfondo (porte 8481 e 8482) e a fine debug si ferma. "name": "Febe per Windows · sito di prova", "type": "coreclr", "request": "launch", @@ -39,8 +28,6 @@ "presentation": { "group": "1-windows", "order": 1 } }, { - // Il sito di prova nel debugger; quando scrive «Sito di prova: http://…» parte anche Febe per Windows - // (configurazione nascosta qui sotto), che si ferma insieme al sito. "name": "Sito di prova + Febe per Windows", "type": "coreclr", "request": "launch", @@ -84,9 +71,6 @@ "presentation": { "hidden": true } }, { - // L'interfaccia viene da src/Febe.Web/wwwroot (FEBE_INTERFACCIA): modifichi un file e ricarichi la pagina. - // Fermata dal debugger, la dimostrazione non cancella la sua cartella temporanea: su Windows finisce in - // %USERPROFILE%\FebeSviluppo\temporanei, che si svuota quando vuoi. "name": "Febe Server · dimostrazione (--demo)", "type": "coreclr", "request": "launch", @@ -133,8 +117,6 @@ "presentation": { "group": "2-strumenti", "order": 3 } }, { - // Il server vero contro il sito di prova, con Chromium su Xvfb (specifica §11): solo su Linux. Come root serve - // anche --senza-sandbox; se Chromium non è nel PATH, FEBE_CHROMIUM. Interfaccia su 127.0.0.1:8480, password «prova». "name": "Febe Server · sito di prova (solo Linux)", "type": "coreclr", "request": "launch", @@ -170,15 +152,11 @@ }, "checkForDevCert": false, "logging": { "moduleLoad": false }, - // Su Windows e macOS si ferma con un messaggio; anche con «Esegui comunque il debug» stampa solo l'aiuto. "windows": { "preLaunchTask": "solo su Linux", "postDebugTask": "", "args": ["--aiuto"] }, "osx": { "preLaunchTask": "solo su Linux", "postDebugTask": "", "args": ["--aiuto"] }, "presentation": { "group": "3-linux", "order": 1 } }, { - // Instagram vero, con l'account e i dati veri (%LOCALAPPDATA%\Febe, Immagini\Febe): solo per le prove dal vivo di - // Alberto. Chiede conferma (Esc annulla). 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. "name": "⚠ Febe per Windows · Instagram vero (dati veri)", "type": "coreclr", "request": "launch", diff --git a/.vscode/settings.json b/.vscode/settings.json index a309826..70cf8cc 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,4 +1,3 @@ -// Impostazioni di VS Code condivise per Febe: solo ciò che vale per tutti (guida: docs/guida/Sviluppo.md). { "dotnet.defaultSolution": "Febe.slnx" } diff --git a/.vscode/tasks.json b/.vscode/tasks.json index ecdff2a..1599c2b 100644 --- a/.vscode/tasks.json +++ b/.vscode/tasks.json @@ -1,14 +1,9 @@ -// Attività di VS Code per Febe (guida: docs/guida/Sviluppo.md, «Da VS Code»). -// Sono i comandi della guida. Le due opzioni in più di compilazione e prove (-tl:off, -clp:ForceNoAlign) danno il -// registro classico, come nella CI: ogni errore su una riga sola, che $msCompile porta nel pannello Problemi. -// Tutte sono di tipo «process»: nessuna shell, quindi nessun profilo di PowerShell che metta davanti un altro .NET. -// Nessuna attività contatta Instagram: il sito di prova è locale (regola 1). { "version": "2.0.0", "tasks": [ { "label": "compila", - "detail": "dotnet build Febe.slnx -warnaserror: tutta la soluzione, gli avvisi sono errori", + "detail": "dotnet build Febe.slnx -warnaserror: tutta la soluzione, gli avvisi sono errori; con -tl:off -clp:ForceNoAlign ogni errore sta su una riga e finisce nel pannello Problemi", "type": "process", "command": "dotnet", "args": [ @@ -58,10 +53,8 @@ "presentation": { "clear": true } }, { - // In sfondo: VS Code lo considera pronto quando il sito scrive «Sito di prova: http://…». Il «CDN» ascolta su - // 127.0.0.2:8482, l'indirizzo che Febe si aspetta con --sito-di-prova http://127.0.0.1:8481. "label": "sito di prova", - "detail": "dotnet run --project tools/Febe.SitoDiProva: http://127.0.0.1:8481, CDN su 127.0.0.2:8482, dati sintetici del seme 13", + "detail": "dotnet run --project tools/Febe.SitoDiProva: http://127.0.0.1:8481, CDN su 127.0.0.2:8482 (dove Febe lo cerca), dati sintetici del seme 13; in sfondo, pronto alla riga «Sito di prova: http://…»", "type": "process", "command": "dotnet", "args": [ @@ -79,8 +72,6 @@ "base": "$msCompile", "owner": "sito-di-prova", "background": { - // Al lavoro dall'avvio (activeOnStart) fino alla riga di endsPattern, poi pronto per sempre: «(?!)» non trova - // mai nulla, quindi nessuna riga successiva lo rimette «al lavoro». "activeOnStart": true, "beginsPattern": "(?!)", "endsPattern": "^Sito di prova: http://" @@ -125,8 +116,6 @@ "problemMatcher": [], "presentation": { "clear": true } }, - - // Attività di servizio delle configurazioni di debug (.vscode/launch.json): non compaiono nell'elenco. { "label": "compila e avvia il sito di prova", "detail": "Prima del debug contro il sito di prova: compila, poi avvia il sito (se è già aperto, lo usa così com'è)", @@ -136,11 +125,8 @@ "problemMatcher": [] }, { - // VS Code non ha un'attività che ne chiuda un'altra: lo fa l'input «fermaIlSitoDiProva», che esegue il comando - // workbench.action.tasks.terminate mentre VS Code prepara questa attività. Il comando non restituisce un testo, - // quindi l'argomento resta com'è e «echo» lo stampa e basta. Un processo e non una shell: niente profilo da caricare. "label": "ferma il sito di prova", - "detail": "A fine debug: chiude l'attività «sito di prova»", + "detail": "A fine debug: chiude l'attività «sito di prova» con l'input fermaIlSitoDiProva (comando workbench.action.tasks.terminate); echo stampa solo il suo argomento", "type": "process", "command": "echo", "args": ["${input:fermaIlSitoDiProva}"], diff --git a/docs/decisioni.md b/docs/decisioni.md index b264c27..90a590f 100644 --- a/docs/decisioni.md +++ b/docs/decisioni.md @@ -229,9 +229,10 @@ Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15). | 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 | 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://»; a fine debug la ferma un input che esegue `workbench.action.tasks.terminate` | 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 | 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 | 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 44ddb15..3c8c7c7 100644 --- a/docs/guida/Sviluppo.md +++ b/docs/guida/Sviluppo.md @@ -59,8 +59,8 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev | Febe Server · dimostrazione (--demo) | La dimostrazione su `http://127.0.0.1:8480`, che si apre da sola nel browser; l'interfaccia viene da `src/Febe.Web/wwwroot` (`FEBE_INTERFACCIA`): modifichi un file e ricarichi la pagina | | Sito di prova | Solo il sito di prova, nel debugger | | Simulazione 30 giorni (prudente) | `--simula 30g --profilo prudente`, con il resoconto nella Console di debug | -| 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`). Su Windows e macOS si ferma con un messaggio | -| ⚠ 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 | +| 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 @@ -80,6 +80,8 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev - Attività (Terminale ▸ Esegui attività): `compila`, `prove` (`dotnet test tests/Febe.Tests`), `prove con filtro` (chiede il filtro, per esempio `FullyQualifiedName~Febe.Tests.Docs`), `sito di prova`, `pubblica Febe.exe` (un file solo in `out/pubblicazione/`, come `installer/costruisci.sh`) e `immagine Docker (serve Docker Desktop)`. +- I file di `.vscode/` sono JSON senza commenti, così li legge anche un lettore rigido come quello dei controlli della + CI: le spiegazioni stanno in questa sezione, nei campi `detail` delle attività e in `docs/decisioni.md`. ## Dimostrazione