Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA
8.6 KiB
Sviluppo
Febe è scritto in C# 14 su .NET 10, in un'unica soluzione (Febe.slnx). L'interfaccia è HTML, CSS e JavaScript senza
framework né fase di build. La specifica è docs/SPECIFICA.md; le scelte prese strada facendo sono in
docs/decisioni.md, lo stato del lavoro in docs/stato.md.
Due regole prima di tutto
- Nessuna prova, script o verifica contatta Instagram (né Meta, né il loro CDN): si usa solo il sito di prova
locale. Le prove dal vivo le lancia Alberto. Lo stesso vale per Telegram: le prove usano un gestore HTTP finto,
mai
api.telegram.org. - Dipendenze a elenco chiuso (
Directory.Packages.props): Microsoft.Data.Sqlite, SkiaSharp (con le librerie native per Linux), Microsoft.Web.WebView2, MSTest. Tutto il resto viene dalla libreria di base di .NET.
Com'è fatto il repository
| Cartella | Che cosa c'è |
|---|---|
src/Febe.Core |
Dominio e logica senza piattaforma: motore, Governatore, interruttore, ricette, lettori, libreria, importazione, avvisi (Alerts/) |
src/Febe.Data |
SQLite, migrazioni come file SQL numerati, scrittore unico |
src/Febe.Browser |
Client del protocollo DevTools, ChromiumProcessHost, gesti, cattura delle risposte, vista remota |
src/Febe.Web |
API, eventi dal server, interfaccia in wwwroot/ incorporata nell'assembly (vedi src/Febe.Web/LEGGIMI.md) |
src/Febe.Server |
L'eseguibile per Linux e Docker (febe), con la dimostrazione e la simulazione |
src/Febe.Desktop |
L'eseguibile per Windows (WPF, WebView2) |
tests/Febe.Tests |
Le prove (MSTest), con i campioni ripuliti in tests/campioni/ |
tools/Febe.SitoDiProva |
Il sito locale per le prove senza Instagram |
tools/Febe.Sonda |
La sonda passiva per raccogliere i campioni |
tools/schermate |
Le schermate dell'interfaccia per il confronto con i mockup |
docker/ |
Dockerfile, compose.yml, entrypoint.sh, file di Chromium (criteri, profilo seccomp), modello di Unraid |
docs/ |
Specifica, decisioni, stato, Docker, prove dal vivo, esiti della sonda, mockup, schermate, e questa guida (docs/guida/) |
Compilare e provare
dotnet build Febe.slnx -warnaserror
dotnet test tests/Febe.Tests
dotnet test tests/Febe.Tests --filter "FullyQualifiedName~Febe.Tests.Alerts"
- Gli avvisi del compilatore sono errori.
Febe.Desktopsi compila anche da Linux (EnableWindowsTargeting), ma gira solo su Windows. - Le prove con un browser vero cercano Chromium in
FEBE_CHROMIUM(o nelPATH) e Xvfb nelPATH; se mancano risultano inconcludenti, non fallite. Lo stesso per le prove d'insieme del server (Febe.Tests.Server), che avviano la composizione vera contro il sito di prova. - Il motore si prova con un orologio virtuale e un seme fisso; le prove d'insieme con un orologio compresso (10×).
- La prova
Febe.Tests.Docscontrolla che questa guida dica tutto ciò che la specifica chiede (§15) e che ogni collegamento fra le pagine porti a una pagina che esiste.
Dimostrazione
dotnet run --project src/Febe.Server -- --demo [--porta 8480] [--fuso Europe/Rome]
Parte senza browser e senza rete, solo su 127.0.0.1 e senza password, con una libreria temporanea di account finti
(.demo), immagini generate e un motore finto; la cartella si cancella alla chiusura. Non scrive mai nella libreria
vera e non invia messaggi Telegram.
- Scene:
?scena=normale,sessione,fermo,scollegato,errore; tema?tema=chiarooscuro; veste?veste=desktopodocker. - Indirizzi diretti:
/account?dialogo=aggiungi,/account/3/impostazioni,/importa?passo=3,/doppioni. - Per modificare l'interfaccia senza ricompilare:
FEBE_INTERFACCIA=$PWD/src/Febe.Web/wwwroot dotnet run --project src/Febe.Server -- --demo, poi basta ricaricare.
Simulazione
dotnet run --project src/Febe.Server -- --simula 30g --profilo prudente [--csv resoconto.csv] [--seme 7]
Fa girare il motore vero con l'orologio virtuale contro un mondo finto (40 account, 25 seguiti, uno con uno storico di
2.000 post, qualche rallentamento a caso) e scrive il resoconto: sessioni al giorno, azioni per categoria al giorno e
nell'ora peggiore, tempo medio e massimo fra pubblicazione e scoperta, giorni per lo storico, superamenti dei tetti
(devono essere zero). Profili: prudente, equilibrato, rapido. È il modo per giudicare un profilo prima di usarlo.
Il sito di prova
dotnet run --project tools/Febe.SitoDiProva -- --porta 8481 --porta-cdn 8482
Un sito locale con pagine spoglie e dati sintetici (alberto.prova, marta.prova, …): pagina iniziale con barra delle
storie, profili con griglia che carica scorrendo, visualizzatore delle storie e delle raccolte, elenco dei seguiti, post
singoli, e i casi di arresto. Non somiglia a Instagram e non ha pagine di accesso. I casi di arresto si comandano da
fuori: /_controllo/modo?valore=troppe-richieste|verifica|sessione-scaduta|vuoto|formato-sconosciuto|normale.
Dettagli in tools/Febe.SitoDiProva/LEGGIMI.md.
Il server vero contro il sito di prova (mai Instagram):
FEBE_PASSWORD=prova dotnet run --project src/Febe.Server -- \
--dati /tmp/febe/dati --libreria /tmp/febe/libreria --importa /tmp/febe/importa --ascolta 127.0.0.1 \
--sito-di-prova http://127.0.0.1:8481 --accesso-di-prova --prima-sessione 5
--sito-di-prova accetta solo indirizzi di questo computer; --accesso-di-prova apre il sito una volta all'avvio,
così il suo cookie di sessione esiste come dopo un accesso; --prima-sessione N fa partire la prima sessione dopo N
secondi. Come root servono --senza-sandbox e, se Chromium non è nel PATH, FEBE_CHROMIUM. Per provare gli avvisi:
imposta Telegram in Impostazioni ▸ Notifiche e chiedi al sito una verifica con /_controllo/modo?valore=verifica.
La sonda
febe-sonda registra --cartella <fuori dal repository> [--display :0 | --xvfb] [--chromium <file>]
febe-sonda ripulisci --da <grezzi> --a <ripuliti>
febe-sonda verifica --grezzi <grezzi> --ripuliti <ripuliti>
(oppure dotnet run --project tools/Febe.Sonda -- …). È passiva: apre il browser e registra ciò che la pagina riceve
mentre navighi tu; non compie gesti. I campioni grezzi stanno fuori dal repository, contengono dati di altre persone e
si cancellano dopo l'uso; nel repository entrano solo i campioni ripuliti. La procedura completa è la parte A di
docs/prove-dal-vivo.md; vedi anche Ipotesi da verificare.
Schermate
bash tools/schermate/tutte.sh 8490 rifà le schermate di docs/schermate/ da una dimostrazione avviata su quella
porta, per il confronto con i mockup (§10.7 della specifica); le differenze rimaste sono in
docs/schermate/differenze.md. Lo strumento accetta solo indirizzi di questo computer.
Immagine Docker
docker build -f docker/Dockerfile -t febe .
La compilazione e tutte le prove girano dentro la costruzione dell'immagine (quelle con il browser vero lì si saltano
da sole). Vedi Installazione con Docker e Unraid e docs/docker.md.
CI e rilascio
Il repository è sul Gitea di casa (https://gitea.encke-hake.ts.net/Alby96/Febe); la CI usa Gitea Actions in
.gitea/workflows/:
verifica.yml, a ogni push e pull request: compilazione con gli avvisi come errori, tutte le prove, costruzione dell'immagine Docker (senza pubblicarla) e due controlli sull'immagine (Chromium presente, lingua italiana generata);rilascio.yml, a ogni tagvX.Y.Z: immagine Docker sul registro di Gitea, installatore Windows e release. Al 13 ottobre 2026 è in preparazione: se il file non c'è ancora in.gitea/workflows/, il rilascio non è automatico.
La versione sta solo in Directory.Build.props (<Version>); il tag deve coincidere.
La guida
Le pagine di questa guida sono i file di docs/guida/, una pagina del wiki per file (_Sidebar.md è la navigazione).
Il wiki di Gitea è un repository git a parte: per pubblicarla si copiano i file in
https://gitea.encke-hake.ts.net/Alby96/Febe.wiki.git e si fa push. I collegamenti fra le pagine sono nel formato del
wiki, [Testo](Nome-Pagina), senza .md.
Convenzioni
- Codice e commenti in inglese; interfaccia, documenti e messaggi in italiano (glossario: appendice D della specifica).
- Nel motore mai
DateTime.Now,Task.DelayoRandomdiretti: si usanoIClockeIRandomSource. - Mai password, cookie, tasti, gettoni o corpi di risposta nei registri; il client DevTools registra solo i nomi dei comandi. Gli indirizzi verso Telegram contengono il gettone del bot: non si registrano mai.
- La libreria non cancella e non sostituisce file da sola.
- Una scelta tecnica nuova si scrive in
docs/decisioni.mdcon data e motivo.