verifica / prove (push) Successful in 3m56s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA
114 lines
20 KiB
Markdown
114 lines
20 KiB
Markdown
# 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à |
|