Files
Febe/docs/decisioni.md
T

14 KiB
Raw Blame History

Decisioni

Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15).

Data Decisione Motivo
2026-10-13 Repository su Gitea di casa (Alby96/Febe), CI con Gitea Actions in .gitea/workflows/ Risposta alla domanda 1 di §16: il repository esiste già lì; stesse convenzioni di Encelado e Mimante
2026-10-13 Alberto ha chiesto di realizzare tutte le tappe in una volta, con branch, PR, CI, wiki e rilascio Richiesta esplicita del 13 ottobre. I punti di arresto di M0 e M3 non si possono attendere: le ipotesi H e S che richiedono Instagram o Windows restano da provare e sono segnate così in docs/sonda/esito.md e docs/stato.md
2026-10-13 Inversione delle dipendenze: le interfacce (IClock, IGovernor, IBrowserHost, archivi) stanno in Febe.Core; Febe.Data e Febe.Browser le implementano Febe.Core resta senza riferimenti a piattaforma (§5) e si prova con implementazioni finte
2026-10-13 Soluzione Febe.slnx, versioni dei pacchetti centralizzate in Directory.Packages.props, versione del programma in Directory.Build.props Formato usato negli altri progetti di Alberto; un solo punto per le versioni
2026-10-13 Pacchetti: Microsoft.Data.Sqlite 10.0.12, SkiaSharp 4.153.1 (+ NativeAssets.Linux.NoDependencies), Microsoft.Web.WebView2 1.0.4258.31, MSTest 4.5.1 Ultime versioni stabili dell'elenco chiuso di §3
2026-10-13 Febe.Web usa ASP.NET Core (framework condiviso, non un pacchetto) con API minime; l'interfaccia in wwwroot è incorporata nell'assembly Un solo eseguibile anche su Windows; nessuna dipendenza in più
2026-10-13 Domande di §16 senza risposta: si adotta la proposta della terza colonna (Libreria e Dati; storie aperte con interruttore; programma di installazione; Telegram facoltativo; nome Febe; solo italiano; porta 8480) §16 chiede di proporre quella risposta; si cambia quando Alberto risponde
2026-10-13 Installatore Windows con NSIS, costruito anche da Linux (makensis), più uno zip portabile Domanda 6: proposta «programma di installazione»; NSIS gira sul runner Linux
2026-10-13 Mockup: forniti a piena risoluzione solo 00, 01, 03, 08, 10; gli altri sono ritagli della panoramica in docs/mockup/miniature/ Vedi docs/mockup/LEGGIMI.md
2026-10-13 account.id è una chiave locale; l'identità è instagram_id (TEXT, unico, facoltativo) Gli account creati dall'importazione possono non conoscerlo; IGovernor riceve la chiave locale
2026-10-13 Tutti gli identificativi Instagram salvati come TEXT Regola 10: nessuna ipotesi su formato e lunghezza
2026-10-13 Orari come millisecondi Unix UTC (INTEGER); enumerazioni come nomi inglesi (TEXT) Indici compatti; database leggibile
2026-10-13 Gli archivi sono proprietà di un unico FebeDatabase (IFebeStorage) Evita conflitti di nomi fra interfacce
2026-10-13 Scrittore unico: un thread, un canale, commit di gruppo con un savepoint per scrittura; un'operazione annullata in coda non parte nemmeno se il lotto è già iniziato §8.3; una scrittura fallita non annulla le altre
2026-10-13 Finestre della libreria con paginazione a chiave su (published_at, id) e indice coprente ix_entry_library 3–6 ms a 200.000 elementi, con o senza statistiche
2026-10-13 Ricerca testuale su una colonna normalizzata (minuscole, senza accenti) con LIKE, senza FTS5 Circa 0,1 s anche a 200.000 elementi, ricerca per sottostringa
2026-10-13 «Foto»/«Video» = post con almeno una foto/un video; «In evidenza» comprende le storie richiamate da una raccolta; «Tutto» esclude le foto del profilo Tabella di §4.3
2026-10-13 Lo schema dei nomi si applica dentro la cartella dell'account; percorsi nel database con /; segnaposto sconosciuti = errore Le cartelle degli account possono stare fuori dalla Libreria (§4.4)
2026-10-13 Percorsi lunghi: si accorcia prima il nome del file (estensione tenuta, ~ + 8 cifre esadecimali), poi le cartelle più lunghe; il limite di 240 vale su ogni sistema §4.7
2026-10-13 File temporanei .febe-<hex>.part; un nome occupato diventa nome (2).ext; mai sovrascrivere Scrittura sicura (§6.5 punto 4)
2026-10-13 Miniature per SHA-256 in miniature/ab/<sha>.jpg, JPEG 82, orientamento EXIF applicato, mai ingrandite Generate una volta sola (§8.4)
2026-10-13 Impronta visiva: pHash classico su DCT, soglia 6 Su 24 scene generate: ridimensionate/ricompresse ≤ 4, ritagliate ≥ 8, scene diverse ≥ 20
2026-10-13 _febe.jsonl versione 1: righe save/delete, tipo come nome italiano della cartella; una riga troncata da un arresto si chiude prima di aggiungere Leggibile senza Febe; regge gli arresti
2026-10-13 Eliminazione: prima la riga del giornale, poi il database, poi i file e le miniature Una ricostruzione rispetta l'eliminazione anche se Febe si ferma a metà
2026-10-13 La ricostruzione non tocca mai i file; gli account ricostruiti tornano «In pausa» con impostazioni predefinite Regola 12
2026-10-13 Controllo della cartella dei dati: UNC e DriveType.Network su Windows; /proc/self/mounts su Linux; fuse.shfs di Unraid conta come locale §8.2
2026-10-13 Gli indirizzi firmati restano in media solo finché il file non è salvato La coda degli scaricamenti sopravvive al riavvio; mai nei registri
2026-10-13 Chromium si ferma con SIGINT, non SIGTERM Con SIGTERM perdeva in 3 casi su 4 un cookie scritto da meno di 30 s (S3)
2026-10-13 Fattori del ritmo dei gesti: lento 1,35, naturale 1, svelto 0,75 La specifica non dà numeri
2026-10-13 Puntatore su curva di Bézier cubica (curvatura 2–12%), profilo di velocità a scatto minimo, circa 60 eventi al secondo, arrivo nel 60% centrale del bersaglio §7.7
2026-10-13 segnali.json e bersagli.*.json con chiavi inglesi e note in italiano; chiavi sconosciute rifiutate Coordinate o nomi di classi non possono entrarci (§6.3)
2026-10-13 ReadOnlyScriptGuard: elenco di divieti sulle espressioni di Runtime.evaluate (niente modifiche, fetch, cookie, archiviazione) Rete di sicurezza per la sola lettura di §6.1, non una prova
2026-10-13 Un segnale con lo stesso codice si inoltra all'interruttore al massimo una volta ogni 60 s; le regole sul testo guardano solo JSON brevi; le pagine vuote le segnalano le ricette (soglia 3) Una didascalia con la frase cercata non è un segnale
2026-10-13 Le navigazioni comprendono i cambi di percorso con history.pushState Instagram è un'applicazione a pagina singola
2026-10-13 BrowserFileFetcher: solo domini del CDN, senza credenziali (da rivedere con H7), blocchi da 1 MB §6.5
2026-10-13 --no-sandbox solo se richiesto esplicitamente; l'host rifiuta di partire se la porta di debug è occupata o ascolta fuori da 127.0.0.1; nel profilo nuovo salvataggio delle password e compilazione automatica spenti §6.1, §11
2026-10-13 Messaggi CDP letti senza il serializzatore JSON a riflessione Compatibile con pubblicazione ridotta e file singolo
2026-10-13 Il Governatore attende la distanza minima (4 s × ritmo) invece di rifiutare; EvaluateAsync la segnala come MinimumSpacing Le storie durano 1,8–5 s: un rifiuto fermerebbe le ricette di continuo
2026-10-13 Ordine dei controlli: interruttore, pausa/browser in uso, fascia, sessione, tetto giornaliero poi orario, distanza, limiti dell'account §7.4
2026-10-13 DataDownload controlla solo il tetto giornaliero in byte, anche durante un fermo; il dimezzamento vale anche per i dati, dal segnale §7.6
2026-10-13 Limite di storico = min(limite dell'account, valore del profilo), ridotto come i tetti; conta i post scoperti oggi «Vince il più stretto»
2026-10-13 Riduzioni: fattore = min(avvio graduale, dimezzamento), tetti arrotondati per difetto, mai sotto 1 §7.4
2026-10-13 Origine dell'avvio graduale: primo avvio del motore o NotifyFirstConnectionAsync, e ogni «Riprendi» dopo verifica §7.2
2026-10-13 L'escalation conta i rallentamenti nelle 24 ore; un segnale durante un fermo non lo allunga; «Riprendi» non accorcia un rallentamento Durate fisse
2026-10-13 Spostamento della fascia: normale con σ = metà dello scarto, tagliata a ± scarto, da un seme salvato (motore.fascia-seme) Mai uniforme; un riavvio non lo riestrae
2026-10-13 La durata estratta è il tetto della sessione: finito il lavoro, la sessione chiude prima Meno traffico, mai di più
2026-10-13 Prima sessione 2–10 min dopo avvio, fine rallentamento o «Riprendi»; prossima sessione salvata e mai anticipata da un riavvio; pausa minima dall'ultima sessione o azione §7.2
2026-10-13 «Controlla ora» in fascia anticipa la sessione solo fino alla pausa minima; fuori fascia gettone valido 10 min, poi una sola visita di quell'account §7.8
2026-10-13 Controllo manuale ammesso su account in pausa o non raggiungibili, mai su «Solo archivio» o privati non seguiti Regola 6
2026-10-13 Profili non seguiti: una visita (profilo + storie) al più corto dei due intervalli Le loro storie si vedono solo dal profilo
2026-10-13 Intervallo delle storie: scostamento sotto il massimo (mediana 0,75, σ 0,25, [0,45; 1]) e mai oltre un terzo della fascia Almeno 3 controlli al giorno
2026-10-13 Ipotesi H2 da confermare in M0 (SweepCoversFollowedStories): il giro dei seguiti vale come controllo delle storie dei seguiti Meno aperture
2026-10-13 Ipotesi H3 da confermare in M0 (PostsPerBackfillPage = 12), solo per stime Regola 10
2026-10-13 Su misura: riconciliazione dei seguiti = 4 × intervallo dei post, fra 6 e 24 ore La specifica non lo dice
2026-10-13 Composizione: giro all'inizio con probabilità 0,9; sessione leggera 1 su 3; 3–12 pagine di storico; 1–4 s fra ricette × umore × ritmo; ordine pesato con u^(1/peso) §7.2
2026-10-13 Tre «formato non riconosciuto» o «bersaglio non trovato» di fila sospendono la ricetta; un bersaglio non trovato chiude la sessione §6.4, §7.7
2026-10-13 Lo storico gira solo per account nello stato «Storico in corso»; con «Tieni aggiornato» spento, dopo lo storico l'account va in pausa §4.4
2026-10-13 A fine sessione pagina vuota, tranne dopo verifica/disconnessione o con Alberto al browser §6.1, §7.6
2026-10-13 Un segnale annulla la sessione da un thread del pool, mai sul thread di cattura Il motore non deve bloccare il client CDP
2026-10-13 Una riga di evento per ricetta («ricetta.», «Titolo: dettaglio»), una per sessione, più fermi, pause, tetti raggiunti e storico Attività e cronologia dell'account
2026-10-13 Orologio virtuale a eventi, ritardi arrotondati al millisecondo; il mondo simulato ha un seme proprio e rallentamenti con probabilità 0,0003 per azione Simulazione deterministica e veloce
2026-10-13 Impostazioni del motore nella tabella setting (chiavi motore.*); profilo Su misura scritto con JsonNode Nessun serializzatore a riflessione
2026-10-13 Ore senza zero iniziale («verso le 7:42», «verso l'1:05») Uso italiano
2026-10-13 bersagli.*.json e lettori.*.json in src/Febe.Core/Config, incorporati e copiati in config/, sovrascrivibili dalla cartella Dati Stessa via di segnali.json; si aggiornano senza ricompilare
2026-10-13 bersagli.*.json ha una sezione pages (indirizzi e forma dell'indirizzo dei visualizzatori); voci con role/name/href vuoti = da compilare; una ricetta con una voce necessaria vuota si rifiuta senza aprire pagine né chiedere permessi Scheletro Instagram (H11) senza inventare nulla
2026-10-13 Vocabolario dei lettori per concetti, con stato «confermato»/«ipotesi»; Instagram = ipotesi con i soli indizi di §6.4 Regola 10
2026-10-13 Lettore per forma: contenuto = id+data+(immagini|video|figli); profilo = id+nome; raccolta = id+titolo; «vuota» = nessun elenco con elementi; il resto «non riconosciuta» con la sola struttura delle chiavi §6.4
2026-10-13 Versione: immagine di area massima; video più grande fra quelli con audio (chi non lo dice conta come completo), altrimenti il più grande §6.5 punto 1
2026-10-13 StoryView chiesto prima dell'apertura e di ogni «avanti»; se il visualizzatore avanza da solo si chiede subito dopo e, se negato, si chiude. Chiudere non è un'azione contata Una vista, un permesso; chiudere evita viste in più
2026-10-13 Storico: ripresa dalla pagina profileFrom se la mappa la prevede, altrimenti scorrendo (ogni pagina contata); cursori di Taggati e Reel nelle impostazioni (raccolta.taggati.{id}.cursore, raccolta.reel.{id}.cursore); a tab completa solo controllo della prima pagina §6.3 «riprende dal punto»
2026-10-13 Elenco dei seguiti: avanzamento in seguiti.cursore/seguiti.inizio/seguiti.letti Più sessioni (§4.2)
2026-10-13 Foto del profilo: identità = hash del percorso dell'indirizzo, senza firma Nuova copia solo quando cambia
2026-10-13 §9.5 identico: se l'esistente è importato senza identificativo, stesso tipo e un solo file, l'importato prende i dati e il nuovo record si toglie; altrimenti il nuovo file diventa «saltato» con nota Nessuna sostituzione automatica (regola 12)
2026-10-13 Coda: file temporaneo .febe-*.part in Dati/temporanei; 403/410 = indirizzo scaduto (ipotesi H7); storia scaduta → «fallito»; errori di rete → di nuovo «da scaricare», fino a 5 tentativi §6.5
2026-10-13 Via HttpClient di §6.5 punto 3 non scritta, resta dietro IFileFetcher Dipende da H7
2026-10-13 Pagina «caricata» = readyState complete + almeno un evento paint; per riportare in vista un bersaglio fino a 24 raffiche L'input prima del primo disegno si perde; una persona risale
2026-10-13 Ripulitura: lettere finte solo consonanti; un valore finto non contiene mai un frammento dei grezzi; la verifica dice dove, mai che cosa; host dei collegamenti ridotto dalla sonda a sito/cdn/altro; interazioni lette da :hover e activeElement in sola lettura §14.5
2026-10-13 Prove con orologio compresso (fattore 10), governatore permissivo, un sito di prova per prova, un Chromium per classe Prove d'insieme sotto i 2 minuti
2026-10-13 Il Governatore espone anche la vista dei tetti per le ricette (IBudgetView); un solo ItalianText per i testi (in Febe.Core.Engine) Raccordo fra motore e ricette dopo l'unione dell'ondata 2