Files
Febe/docs/decisioni.md
T

20 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
2026-10-13 Interfaccia incorporata come risorse wwwroot/… con un IFileProvider proprio nessun pacchetto in più, un solo file da distribuire
2026-10-13 Nomi JSON dell'API in inglese camelCase, testi per Alberto in italiano identificatori in inglese, interfaccia in italiano
2026-10-13 In modalità dimostrativa niente SSE, la pagina chiede il motore ogni 30 s le schermate senza finestra finiscono
2026-10-13 Gettone del desktop scambiato una volta con un cookie HttpOnly Strict e tolto dall'indirizzo non resta in cronologia né nei registri
2026-10-13 Blocco password per client e complessivo; il tentativo che raggiunge la soglia risponde già «bloccato» rallenta anche i tentativi da più indirizzi
2026-10-13 Esportazione CSV con ;, BOM e prefisso ' sui campi che iniziano con = + - @ Excel italiano, niente formule iniettate
2026-10-13 AccountPlanInput con GradualStartSince e Now il piano dell'account deve sapere se l'avvio graduale è ancora in corso
2026-10-13 Strumento per le schermate in tools/schermate (Node, nessun pacchetto) rifare le schermate di §10.7 anche nella parte 2
2026-10-13 Nessuna migrazione nuova: le scelte di un'importazione senza colonna (ipotesi Stogram, nuovi account) stanno in setting con chiavi importazione.{id}.*; le note dei file in import_file.last_error Evita conflitti di numerazione fra rami paralleli; lo schema 1 basta
2026-10-13 Nuovi valori ImportOutcome.IdenticalInSource e ImportDateSource.Journal Una copia identica nella sorgente non è «già in libreria»; la data del giornale di Febe è esatta
2026-10-13 Unità da associare: le cartelle di primo livello, oppure la cartella scelta se contiene solo cartelle di tipo/anni o solo file Una riga per account nella tabella del mockup 09 anche scegliendo direttamente un account
2026-10-13 Confronto: SHA in libreria (prima l'account di destinazione), SHA nella sorgente, identificativo/codice con posizione, impronta in libreria, poi identità e impronta nella sorgente; una coppia al massimo per file, verso il primo file del gruppo §9.3; niente catene di coppie
2026-10-13 «Stesso identificativo, file diverso» vale anche per i video; per i video si esclude solo l'impronta «Per i video vale solo lo SHA-256» riguarda le soglie dell'impronta
2026-10-13 Uno SHA o un identificativo di un elemento eliminato «ricordando la scelta» conta come «già in libreria», con nota Un'importazione non annulla un'eliminazione (§4.6)
2026-10-13 Associazione iniziale: account per identificativo poi per nome; altrimenti nuovo «Solo archivio» col nome della cartella se valido; altrimenti nessuno. Gli account nascono all'avvio della copia, con «Tieni aggiornato» spento Mockup 09; un'importazione abbandonata non lascia account vuoti
2026-10-13 File senza account o con doppione da decidere restano «analizzati» con la nota; la copia si rilancia sulla stessa importazione «Blocca solo i propri file» (§9.4)
2026-10-13 «Più grande» = più pixel, poi più byte; a parità vince la libreria. Sostituzione: nuovo file scritto e riletto (SHA-256), poi record e _febe.jsonl, poi eliminazione del vecchio file e della sua miniatura Regola 12
2026-10-13 Nella sorgente, fra file uniti da «tieni il più grande» si importa solo il più grande del gruppo Nessun effetto a catena
2026-10-13 «Sposta» elimina solo originali di file copiati in modalità Sposta, dopo aver riletto la copia dal disco; mai i file saltati §9.4
2026-10-13 Sola lettura riconosciuta senza scrivere nella sorgente: ro nei montaggi (Linux), dischi ottici (Windows), /importa in sola lettura per configurazione L'analisi non scrive nemmeno un file di prova
2026-10-13 Sorgenti rifiutate: dentro o sopra la cartella dei dati, sopra la libreria, dentro una cartella di account con _febe.jsonl Niente libreria importata in sé stessa
2026-10-13 Date: nome (o giornale di Febe), metadati (EXIF con fuso, mvhd, ffprobe solo in aggiunta), data di modifica; un nome con il solo giorno cede all'ora dei metadati dello stesso giorno; ore senza fuso = fuso di Alberto §9.2
2026-10-13 Il riconoscitore generico non estrae identificativi: i codici vengono solo dai nomi e dal giornale di Febe Regola 10
2026-10-13 Ipotesi 4K Stogram dietro un'opzione per importazione, spenta; ora del nome letta come locale; stogram.sqlite mai aperto (si guarda solo se esiste) §9.6: va riscritta sui dati veri
2026-10-13 MediaContent.FixedRelativePath ed ExpectedSha256; la copia usa un LibraryIngest senza indice e aggiorna da sé l'indice condiviso Stessa via degli scaricamenti; nessuna coppia «da scaricamento» per varianti già decise; un file cambiato dopo l'analisi non entra
2026-10-13 CSV con ;, UTF-8 con BOM, CRLF, date locali, durate con la virgola, apostrofo davanti a = + - @ Excel in italiano; nessuna formula da un nome di file
2026-10-13 Analisi a gruppi di 64 file, lettura in parallelo (fino a 4), confronto e salvataggio in ordine; foto fino a 64 MB lette una volta sola «Primo incontrato» stabile e un solo passaggio sul disco
2026-10-13 Un lavoro d'importazione alla volta; eventi «importazione-analizzata», «importazione-completata», «account-solo-archivio» Il disco è il collo di bottiglia; cronologia in Attività