diff --git a/docs/decisioni.md b/docs/decisioni.md index cde7593..96d1f42 100644 --- a/docs/decisioni.md +++ b/docs/decisioni.md @@ -233,7 +233,7 @@ Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15). | 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 | Tutte le configurazioni di debug usano la Console di debug (`internalConsole`), mai il terminale integrato (Febe per Windows non ha una console: il suo registro resta nella cartella dei dati, `registro`); 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 | | 2026-10-20 | `src/Febe.Desktop/Properties/launchSettings.json` con un solo profilo, «Sito di prova»: `--dati` e `--libreria` in `%USERPROFILE%\FebeSviluppo\comune`, `--sito-di-prova http://127.0.0.1:8481 --accesso-di-prova --prima-sessione 30 --sviluppo` | `dotnet run --project src/Febe.Desktop` e i comandi del C# Dev Kit (▷ «Debug project associated with this file», «Start New Instance», «C#: …») avviavano Febe senza opzioni: Instagram vero e dati veri, senza la conferma della configurazione ⚠. `dotnet run` e il Dev Kit leggono quel profilo ed espandono `%USERPROFILE%` (provato); se un altro strumento non lo facesse, Febe rifiuta il percorso non completo e non parte. Una cartella comune perché il file non conosce il checkout. Instagram vero dal terminale: `dotnet run --project src/Febe.Desktop --no-launch-profile` | diff --git a/docs/guida/Sviluppo.md b/docs/guida/Sviluppo.md index ef08910..ac22bd8 100644 --- a/docs/guida/Sviluppo.md +++ b/docs/guida/Sviluppo.md @@ -71,7 +71,12 @@ La cartella `.vscode/` prepara VS Code per Febe: estensioni consigliate (C# Dev - 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. -- I programmi scrivono nella Console di debug e le attività partono senza shell: il terminale integrato carica il +- **Registro.** Nella Console di debug compaiono le righe del sito di prova, della dimostrazione, della simulazione e + del server. Febe per Windows non ha una console: lì mostra solo i messaggi del debugger, e il suo registro sta nella + cartella dei dati, `%USERPROFILE%\FebeSviluppo\\dati\registro\febe-AAAA-MM-GG.log` (con il profilo di + `launchSettings.json`, in `FebeSviluppo\comune\dati\registro`). Lì si leggono «Interfaccia sulla porta N», lo stato + del browser di Febe e gli errori. +- Le configurazioni usano la Console di debug e le attività partono senza shell: il terminale integrato carica il profilo di PowerShell, che può mettere davanti un altro .NET (per esempio quello di un ambiente conda), e allora `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`.