Files
Febe/docs/decisioni.md
T

114 lines
20 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.<Tipo>», «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à |