Files
Febe/docs/SPECIFICA.md
T
Alby96andClaude Opus 5.5 9941a2fa1f
verifica / controlli (push) Successful in 20s
verifica / prove (push) Failing after 19m40s
verifica / installatore (push) Skipped
verifica / immagine (push) Skipped
Ricerca dei profili con suggerimenti e foto (#37)
«Aggiungi account» ha una sola casella: mentre Alberto scrive compaiono
subito i suggerimenti locali, poi i profili di Instagram con la foto, come
chiesto in #37. Il browser di Febe scrive nella casella «Cerca» di Instagram
con tasti veri da una mappa chiusa (mai Invio, Tab o Esc), controlla prima
il fuoco, legge la risposta della pagina e non clicca mai un risultato.

La ricerca ha una categoria propria nel Governatore, con tetti larghi che
non consumano quelli della raccolta, e si dà il turno con il motore
sull'unica pagina; a fine sessione la pagina torna comunque al riposo. Le
foto passano dal CDN con un permesso ciascuna e restano solo in memoria.

Le risposte di Alberto del 15 novembre (controllo del fuoco, turni, evento
requestWillBeSent, niente foto dei seguiti per ora) sono in §6.1 e in
docs/decisioni.md. Su Instagram vero la ricerca parte quando i bersagli
search-open e search-box saranno raccolti dal vivo.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 16:30:03 +01:00

1340 lines
124 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.
# Febe — specifica di progetto e istruzioni per Claude Code
Versione 1, 13 ottobre 2026. «Febe» è un nome di lavoro: si cambia con un trova-e-sostituisci prima della tappa M0.
Questo documento è la specifica completa di un programma da costruire da zero. Va tenuto nel repository come `docs/SPECIFICA.md`, insieme alle 15 immagini di `docs/mockup/`. Le sezioni 0 e 16 sono per Alberto, tutto il resto è scritto per te, Claude Code.
Tre segni ricorrono nel testo:
- **Verificato**: controllato su una fonte il 13 ottobre 2026 (elenco in appendice E).
- **Provato in locale**: provato quel giorno con Chromium 141 su un display virtuale Xvfb, contro una pagina locale, senza toccare Instagram.
- **Ipotesi**: plausibile ma non provabile senza un accesso a Instagram. Va provata nella tappa M0 prima di costruirci sopra.
---
## 0. Per Alberto: come si usa
1. Crea una cartella vuota `febe`, aprila in VS Code ed esegui `git init`.
2. Copia questo file in `docs/SPECIFICA.md` e le immagini in `docs/mockup/`, con gli stessi nomi.
3. Apri Claude Code e scegli la modalità **Plan** dall'indicatore in fondo al riquadro del prompt (in alternativa scrivi `/plan` davanti al messaggio).
4. Incolla il primo messaggio qui sotto.
5. Procedi una tappa per volta (§15). Tra una tappa e l'altra scrivi `/clear`: ogni tappa riparte pulita e rilegge solo le sezioni che le servono.
6. Restano a te: accedere a Instagram nel browser di Febe, lanciare ogni prova dal vivo e rispondere alle domande di §16.
**Primo messaggio**
```text
Leggi docs/SPECIFICA.md per intero, a blocchi, fino all'appendice E, e guarda docs/mockup/00-panoramica.png.
Non scrivere ancora codice. Poi:
1. riassumi in dieci righe che cosa costruiamo e quali regole di §2 non si discutono;
2. elenca ciò che nella specifica ti sembra contraddittorio, mancante o non realizzabile così com'è;
3. proponi il piano della tappa M0 (§15): file che creerai e come verificherai ogni punto.
Quando approvo il piano, crea CLAUDE.md copiando l'appendice A, esegui M0 e fermati al suo punto di arresto.
```
**Messaggio per ogni tappa successiva**
```text
Tappa M<n> di docs/SPECIFICA.md. Leggi docs/stato.md, poi le sezioni e i mockup indicati per questa tappa in §15.
Prima il piano, poi il codice. Alla fine esegui i controlli «Fatto quando», mostrami comandi e risultati,
aggiorna docs/stato.md e docs/decisioni.md e fermati.
```
**Messaggio per una schermata**
```text
Costruisci la schermata «Attività» seguendo docs/mockup/06-attivita.png e docs/mockup/13-foglio-di-stile.png (§10).
Poi verificala come descritto in §10.7 ed elenca le differenze rimaste.
```
Il file è lungo: non allegarlo con `@` a ogni messaggio, basta scriverne il percorso. Le immagini si passano allo stesso modo, con il percorso; in VS Code si possono anche incollare nel riquadro del prompt o trascinarvi tenendo premuto Maiusc (**Verificato**). Conviene il percorso: restano nel repository e Claude Code apre solo quella che gli serve.
---
## 1. Che cosa stiamo costruendo
Febe è un archivio personale. Scarica e conserva sul disco di Alberto le foto, i video e le storie degli account Instagram che lui sceglie, usando il suo account, e li tiene aggiornati nel tempo. Esiste in due vesti con lo stesso motore e la stessa interfaccia: un contenitore Docker per il server di casa (Unraid) e un'applicazione desktop per Windows.
Il riferimento è 4K Stogram. **Verificato**: il produttore ne ha interrotto lo sviluppo (ultima versione 4.9.0, 18 maggio 2024) dichiarando di non riuscire più a garantire né il funzionamento né la sicurezza degli account degli utenti, nonostante i tentativi di adattamento. Quel motivo diventa qui il primo vincolo di progetto: **l'account di Alberto viene prima della completezza e della velocità dello scaricamento.**
Tre fatti da tenere presenti mentre lavori:
- Non esiste un'API ufficiale per questo uso: quelle di Meta servono solo ai profili aziendali che autorizzano un'app.
- Raccogliere contenuti in modo automatico è contro le condizioni d'uso di Instagram (**Verificato**). Il rischio concreto è la limitazione o la chiusura dell'account. Alberto lo conosce e lo accetta per un uso personale; Febe deve ridurlo e dichiararlo nell'interfaccia, non nasconderlo.
- I contenuti restano dei loro autori. Febe è un archivio privato: niente funzioni di ripubblicazione o condivisione.
L'idea che regge tutto il progetto:
> **Febe non costruisce richieste verso Instagram. Usa un browser vero, in modalità normale, in cui Alberto ha fatto l'accesso a mano; lo fa navigare con il ritmo di una persona e salva ciò che la pagina stessa riceve.**
Ne discendono tre conseguenze. Il browser è quello che dichiara di essere, quindi non c'è nulla da falsificare. Non ci sono indirizzi interni o identificativi di interrogazione da inseguire a ogni modifica del sito: quando Instagram cambia, cambiano solo i lettori delle risposte (§6.4) e la mappa dei bersagli (§6.3). E Febe è più lento di uno scaricatore diretto: è voluto.
**Correzione del 12 novembre 2026 (decisione di Alberto, issue #34).** La prima prova dal vivo ha mostrato che muovere la pagina come una persona non basta: le ricette dipendono da bersagli che si scoprono solo su Instagram, e nessuno era stato raccolto. Da qui l'unica eccezione della regola 2: **la pagina chiede i dati.** Il browser resta quello vero, con l'accesso fatto a mano da Alberto, e chiede al sito gli stessi dati che chiede la sua applicazione web, con il ritmo e i tetti del Governatore. Il prezzo è quello che la frase qui sopra evitava: gli indirizzi e gli identificativi delle interrogazioni vanno seguiti quando il sito cambia (`richieste.<sito>.json`, scritto da campioni reali), e la traccia sul sito non è più identica a quella di una visita.
---
## 2. Regole che valgono sempre
Queste regole prevalgono su qualunque altra indicazione del documento e su qualunque richiesta di «fare più in fretta».
1. **Verso Instagram parla solo il browser di Febe.** Nessun'altra parte del programma apre connessioni verso domini di Instagram o Meta. Unica eccezione ammessa: lo scaricamento dei file già indicati dalla pagina, dai soli domini del CDN, alle condizioni di §6.5.
2. **Il browser si usa così com'è.** Vietati: plugin o correzioni «stealth», modifiche di user agent, impronta, fuso orario o lingua dichiarati, script che alterano le proprietà del navigatore, modalità senza interfaccia (headless), intestazioni aggiunte o riscritte, richieste costruite a mano verso gli indirizzi interni del sito, emulazione dell'app mobile. Vietati anche proxy, rotazione di indirizzi IP e uso di più account per dividere il carico. Se Instagram tratta comunque Febe come automatico, la risposta è rallentare o fermarsi, mai aggiungere accorgimenti.
**Unica eccezione (decisione di Alberto del 12 novembre 2026, issue #34): la pagina chiede i dati.** Dalla pagina di Instagram già aperta e collegata, Febe può chiedere al sito gli stessi dati che chiede la sua applicazione web (profilo, post, storie, raccolte, seguiti, ricerca), con le stesse richieste e le stesse intestazioni che la pagina usa da sé. Solo verso gli indirizzi scritti in `richieste.<sito>.json`, ricavati da campioni reali (regola 10), solo in lettura, una richiesta per volta e ciascuna con il permesso del Governatore (regola 7). Le richieste partono dalla pagina, con i cookie che il browser vi mette da sé: nessun programma fuori dal browser, nessun cookie letto o copiato, nessuna intestazione che la pagina non mandi già. I dettagli in §6.1; le ricette riscritte su queste richieste (§6.3) e la loro categoria nel Governatore (§7.4) si scrivono con l'issue #36, sui campioni.
3. **Niente scavalcamenti.** CAPTCHA, verifiche d'identità, codici in due passaggi e pagine di controllo non si risolvono mai in automatico. Febe si ferma, avvisa, e Alberto le completa a mano nel browser.
4. **Un account, una rete, un motore.** Una sola sessione Instagram per istanza e un solo motore attivo per quell'account. La sessione nasce e resta nel browser di quell'istanza: i cookie non si copiano mai da una macchina all'altra.
5. **Sola lettura.** Febe non mette «mi piace», non segue, non commenta, non scrive messaggi, non reagisce alle storie, non tocca annunci né suggerimenti. L'unica traccia che lascia è quella di una normale visita, compresa la visualizzazione delle storie (§6.3), più le richieste di dati dell'eccezione della regola 2, che sono richieste di lettura come quelle della pagina ma non sono una visita.
6. **Solo ciò che l'account di Alberto vede già.** Profili pubblici e profili privati che lo hanno accettato tra i follower. Un profilo privato non seguito non si tocca.
7. **Ogni azione del motore passa dal Governatore** (§7.4). Non esiste un percorso di codice con cui il programma carichi una pagina di Instagram o vi compia un gesto senza averne ottenuto il permesso, nemmeno per i comandi manuali. Non sono azioni del motore le pagine che Alberto apre usando lui il browser (accesso, verifiche, sonda di M0): in quei momenti il motore è fermo.
8. **Al primo segnale ci si ferma** (§7.6). Nessun nuovo tentativo automatico dopo una richiesta di verifica o una disconnessione.
9. **Tu non contatti mai Instagram e non apri i campioni grezzi.** Prove automatiche, script e verifiche tue usano solo il sito di prova locale (§14.2). Le prove dal vivo le lancia Alberto, con l'account di prova che ti indicherà. I campioni grezzi della sonda contengono dati personali di altre persone: lavori solo sulle copie ripulite (§14.5).
10. **Il formato delle risposte di Instagram non si inventa.** I lettori si scrivono soltanto su campioni reali raccolti nella tappa M0. Se un campione manca, chiedilo.
11. **Segreti fuori dai registri e fuori da git.** Mai password, cookie, token, tasti premuti o corpi di risposta nei log o nei messaggi di errore. I campioni grezzi stanno fuori dal repository.
12. **La libreria non cancella e non sostituisce da sola.** Se un contenuto sparisce da Instagram, il file resta. Un file della libreria si elimina o si sostituisce solo per una scelta esplicita di Alberto.
13. **Dipendenze a elenco chiuso** (§3). Per aggiungerne una chiedi prima, spiegando perché non basta ciò che c'è.
14. **Resoconti onesti.** Se una cosa non funziona, o non l'hai potuta verificare, scrivilo così. Un «fatto» senza il risultato del controllo non vale.
---
## 3. Decisioni già prese
Sono scelte fatte al posto di Alberto per poter scrivere una specifica coerente. Ognuna si può cambiare, ma prima di M0.
| Decisione | Motivo | Se va cambiata |
|---|---|---|
| Nome di lavoro **Febe** | Luna di Saturno, come Titano, Encelado e Mimante. Nessun richiamo ai marchi di Instagram | Trova-e-sostituisci su `Febe`/`febe` |
| **C# 14 su .NET 10**, un'unica soluzione | È lo stack degli altri progetti di Alberto; .NET 10 è la versione a supporto lungo | Rivedere §5, §11, §12 |
| **Browser vero pilotato con il protocollo DevTools (CDP)**, client scritto da noi | Vedi §1. Niente Instaloader, gallery-dl, Playwright o Selenium: i primi costruiscono richieste, i secondi avviano il browser in modalità automazione | Non cambiare senza riscrivere §6 e §7 |
| **Interfaccia web unica**, HTML, CSS e JavaScript senza framework né fase di build | Identica in Docker e su Windows; i mockup si traducono uno a uno in CSS | Alternativa: Blazor Server |
| **SQLite più file su disco** | Valutazione in §8.1 | — |
| **Un solo account Instagram per istanza** | Regola 4. Per un secondo account, una seconda istanza con cartelle proprie | — |
| **Italiano**, con tutti i testi in un file di risorse | Aggiungere una lingua non deve toccare il codice | Domanda 9 di §16 |
| **Profilo «Prudente» come predefinito** | §7.5 | Impostazione |
| **Le storie si salvano solo dopo essere state aperte** | Febe si comporta come una visita normale: Alberto risulta tra gli spettatori. Nessuna visione anonima | Domanda 5 di §16 |
| **Due percorsi generali: Libreria e Dati** | La richiesta originale era troncata su questo punto | Domanda 3 di §16 |
| **Carattere Archivo, icone Lucide**, copiati nel programma | Licenze libere (OFL e ISC), nessun caricamento da rete | — |
**Dipendenze ammesse.** In esecuzione: `Microsoft.Data.Sqlite`, `SkiaSharp` con `SkiaSharp.NativeAssets.Linux.NoDependencies` (miniature e impronta visiva), `Microsoft.Web.WebView2` (solo Windows). Per le prove: MSTest. Nell'immagine Docker: i pacchetti di §11. Nell'interfaccia: nessun pacchetto npm; carattere e icone sono file copiati nel repository con le loro licenze. Tutto il resto viene dalla libreria di base di .NET (`System.Text.Json`, `HttpClient`, `ClientWebSocket`, `System.Security.Cryptography`). Ciò che manca e serve poco si scrive a mano: per esempio la lettura della data di scatto dai metadati di una foto.
**Lingua del codice.** Identificatori e commenti in inglese; interfaccia, documentazione e messaggi per l'utente in italiano. Il glossario dell'appendice D lega i due vocabolari.
---
## 4. Funzioni
### 4.1 Collegamento a Instagram
- Alberto accede nella vera pagina di Instagram, caricata dal browser di Febe. Password e codici li scrive lui; Febe non li conserva mai.
- Su Windows il browser è una finestra a parte, «Browser di Febe»: ciò che Alberto scrive va direttamente alla pagina. In Docker il browser gira sul server e Alberto lo usa attraverso la vista remota dentro la pagina Collegamento (mockup 10): i tasti passano dal server di Febe, che li inoltra senza registrarli. I due testi della pagina dicono ciascuno la propria verità (§10.3).
- Ciò che resta è il profilo del browser nella cartella dei dati. Il collegamento sopravvive ai riavvii.
- «Scollega» chiede conferma, ferma il motore e cancella il profilo del browser. Spiega che, per chiudere la sessione anche dal lato di Instagram, Alberto può prima uscire dal sito usando lui il browser.
- Lo stato del collegamento è sempre visibile in fondo alla barra laterale: collegato, non collegato, verifica richiesta.
- Mentre Alberto usa il browser di Febe, il motore resta fermo.
### 4.2 Account da seguire
- Si aggiungono da **una sola casella di ricerca** (mockup 04, issue #37), come in 4K Stogram. Mentre Alberto scrive, sotto la casella compare un elenco di suggerimenti che si aggiorna a ogni lettera: prima, subito, i profili che segue e gli account già in Febe il cui nome utente o nome completo contiene il testo; poi, appena arrivano, i profili che trova Instagram. Ogni riga ha la foto del profilo, il nome utente, il nome completo e le etichette «Seguito», «Privato», «Già in Febe»; un profilo trovato sia in locale sia su Instagram compare una volta sola.
- Le etichette vengono solo dai dati di Febe (elenco dei seguiti, account): la risposta di Instagram non dice se un profilo è privato o seguito.
- Su Instagram cerca il browser di Febe, nel pannello «Cerca» del sito (§6.3, «Ricerca dei profili»), e ne scarica le foto (§6.5): la pagina di Febe chiede tutto a Febe, mai a Instagram. Si cercano solo profili, niente hashtag né luoghi.
- «Aggiungi» mette il profilo in «Da aggiungere»; un profilo «Già in Febe» non si aggiunge una seconda volta, neanche se ha cambiato nome (si riconosce dall'identificativo). Frecce, Invio ed Esc funzionano nell'elenco; la riga «Aggiungi @nome per nome utente» aggiunge il nome scritto anche se non compare fra i risultati.
- Nella stessa casella si possono **incollare più nomi** utente o indirizzi di profilo, uno per riga o separati da virgole: vanno tutti in «Da aggiungere», con i nomi non validi spiegati. Gli spazi da soli non separano: «mario rossi» si cerca.
- Quando la ricerca su Instagram non è possibile (Alberto usa il browser, browser spento, fuori fascia, tetto della ricerca raggiunto, un arresto di §7.6, bersagli da configurare), una riga sotto «Da Instagram» lo dice; i suggerimenti locali funzionano sempre.
- «Scegli fra tutti i profili che segui» apre al posto di «Da aggiungere» l'elenco completo dei seguiti con le caselle di spunta e «Seleziona tutti»; la casella in alto lo filtra.
- L'elenco dei profili seguiti si legge a ritmo umano, dentro i tetti: può richiedere più sessioni. La finestra mostra a che punto è («Letti 96 profili, continuo alla prossima sessione») e lavora su ciò che ha. L'elenco resta in memoria locale con la data di lettura e si rilegge solo su richiesta.
- Aggiungendo account si sceglie uno di tre punti di partenza, che poi si cambiano account per account:
| Punto di partenza | Tieni aggiornato | Tipi attivi | Quanto indietro |
|---|---|---|---|
| Scarica tutto e tieni aggiornato | sì | foto, video, storie, evidenza, foto del profilo | tutto |
| Solo le novità da oggi | sì | gli stessi | dalla data di oggi |
| Solo le storie | sì | storie, evidenza | — |
- Valori di partenza comuni: frequenza Normale; taggati spento (acceso solo per il profilo di Alberto); storico al giorno secondo il profilo di prudenza (§7.5); nessun limite alla dimensione dei video; video delle storie compresi; cartella predefinita.
- Il profilo di Alberto è presente dal primo collegamento, segnato «Tu», con «Post in cui è taggato» attivo: è così che si scaricano i post in cui lui è taggato.
- Stati di un account (mockup 03): Aggiornato, Storico in corso, In pausa, Solo archivio, Non raggiungibile (privato non seguito, inesistente, bloccato). Il filtro «Da controllare» raccoglie gli account che chiedono attenzione: non raggiungibili, con nome cambiato, con un formato non riconosciuto (§6.4).
- Le etichette sono neutre: «Seguito», «Non seguito», «Privato», «Pubblico», «Tu».
- Un account è riconosciuto dal suo identificativo numerico, non dal nome utente. Se un profilo seguito cambia nome, Febe lo scopre dai dati che riceve, aggiorna il nome, tiene la cartella e lo segnala. Un profilo non seguito che cambia nome risulta «Non raggiungibile»: Alberto può indicare il nuovo nome, e Febe conferma che l'identificativo è lo stesso prima di proseguire.
- «Solo archivio» significa che l'account vive solo in libreria e non viene mai contattato. È lo stato degli account creati dall'importazione e di quelli che Alberto congela.
- Rimuovere un account chiede sempre se tenere o eliminare i file. Il predefinito è tenerli, e l'account diventa «Solo archivio».
### 4.3 Che cosa si scarica
Due parole vanno tenute distinte. Un **elemento** è una pubblicazione: un post (anche con più foto e video), una storia, un contenuto di una raccolta in evidenza. Un **file** è ogni singola foto o video. Nell'interfaccia una tessera è un elemento e i contatori contano elementi; un post con quattro foto è un elemento con quattro file.
| Tipo (`{tipo}` e cartella) | Che cos'è | Interruttori dell'account | Dove si vede | `{codice}` nel nome |
|---|---|---|---|---|
| `post` | Post della griglia del profilo, reel compresi | «Foto dei post» per le immagini, «Video e reel» per i video | Libreria; scheda Post | Codice del post |
| `storie` | Storie attive nelle 24 ore | «Storie» | Libreria; scheda Storie | Identificativo della storia |
| `evidenza` | Contenuti delle raccolte fissate nel profilo | «Storie in evidenza» | Libreria; scheda In evidenza, raggruppati per raccolta | Identificativo del contenuto |
| `taggati` | Post di altri in cui l'account compare | «Post in cui è taggato» | Libreria; scheda Taggati | Codice del post |
| `profilo` | Foto del profilo, una copia a ogni cambio | «Foto del profilo» | Intestazione della scheda e scheda Profilo, che compare se ce n'è più d'una | Prime otto cifre dello SHA-256 |
- Un reel trovato sia nella griglia sia nella scheda Reel è lo stesso elemento: la scheda Reel è solo una seconda fonte.
- Una storia già salvata che entra in una raccolta in evidenza non si riscarica: la raccolta la richiama (ipotesi H9 di §6.6). Un contenuto può stare in più raccolte.
- Nel filtro della Libreria «Foto» e «Video» riguardano i post; storie, evidenza e taggati hanno la loro voce.
- Insieme ai file si conservano: data e ora di pubblicazione, didascalia, codice, autore, posizione nella serie, dimensioni, durata.
### 4.4 Impostazioni per account
Ogni account ha le sue (mockup 05):
- **Tieni aggiornato**: sì o no. Con «no» si fa un solo scaricamento, poi l'account resta in pausa.
- **Frequenza dei controlli**: Bassa, Normale, Alta (§7.3) oppure Su misura, che mostra due campi: ogni quante ore controllare i post, e l'intervallo massimo fra due controlli delle storie.
- **Cosa scaricare**: i sei interruttori di §4.3.
- **Limiti**: quanto indietro nel tempo (tutto, ultimi N post, da una data); massimo di post di storico al giorno; dimensione oltre la quale un video si salta (vuoto significa nessun limite); video delle storie sì o no.
- **Cartella**: per impostazione predefinita una cartella con il nome dell'account dentro la Libreria. Se ne può scegliere un'altra, anche fuori dalla Libreria. I percorsi dei file nel database sono relativi alla cartella dell'account.
A destra un riquadro «Con queste impostazioni» traduce le scelte in conseguenze: ogni quanto verrà controllato davvero, quanti giorni richiede lo storico (quando il numero dei post è già noto, altrimenti lo dice), quanto pesa sul tetto giornaliero. Limiti dell'account e limiti generali valgono insieme: vince sempre il più stretto.
### 4.5 Tenere aggiornato
«Appena pubblicato» va inteso così: **entro la sessione successiva**, non in tempo reale. Con il profilo Prudente significa di norma fra 20 e 90 minuti per gli account che Alberto segue, e l'intervallo scelto per quelli che non segue. Di notte Febe non lavora. L'interfaccia deve dirlo con numeri veri (riquadro di §4.4 e pagina Attività), e avvisare quando gli account e le frequenze chiesti superano ciò che i tetti consentono: in quel caso i controlli si diradano, non si forzano.
### 4.6 Libreria
- Mosaico di tutti gli elementi in ordine di pubblicazione, raggruppati per giorno (mockup 01). Filtri per tipo, account, periodo, provenienza (scaricati o importati). Ricerca per nome dell'account e testo della didascalia.
- Deve restare fluida con 200.000 elementi: caricamento a finestre, miniature generate una volta e conservate.
- Visualizzatore (mockup 02): elemento a tutta altezza, frecce, file della serie, scheda con dati, file e provenienza. Azioni: mostra nella cartella (Windows) o scarica il file (browser), apri su Instagram, elimina dalla libreria.
- Eliminare chiede conferma e, per impostazione predefinita, ricorda la scelta: l'elemento resta nel database senza file, nello stato «eliminato», così non viene riscaricato. La conferma offre anche «Eliminalo e lascia che torni».
- Scheda dell'account con gli elementi divisi in Post, Storie, In evidenza, Taggati (mockup 12), le impostazioni e la cronologia dei controlli.
- Selezione multipla per esportare o eliminare.
### 4.7 Percorsi e nomi dei file
- **Libreria**: dove finiscono foto e video. Può stare su un disco di rete o su una condivisione.
- **Dati**: database, profilo del browser, miniature, registro, copie di sicurezza. Deve stare su un disco locale (§8.2).
- Tre schemi dei nomi configurabili, uno generale, uno per le raccolte in evidenza e uno per le foto del profilo, con anteprima del risultato (mockup 08). Le foto del profilo restano nella loro cartella dentro l'account anche se lo schema generale cambia (#38). Predefiniti:
```text
{account}\{tipo}\{anno}\{data}_{ora}_{codice}_{n}
{account}\evidenza\{raccolta}\{data}_{ora}_{codice}_{n}
{account}\profilo\{data}_{ora}_{codice}_{n}
marta.demo\post\2026\2026-10-10_18-22-05_DBx3kQ2_2.jpg
marta.demo\storie\2026\2026-10-13_09-41-07_3742118_1.mp4
marta.demo\evidenza\Estate 2025\2025-08-02_10-11-12_3391207_1.jpg
marta.demo\profilo\2026-09-30_21-04-33_a3f9c2e1_1.jpg
```
- Segnaposto: `account`, `tipo`, `anno`, `mese`, `data`, `ora`, `codice`, `n` (posizione del file nell'elemento), `raccolta` (solo nello schema delle raccolte). Per le foto del profilo `codice` sono le prime otto cifre dello SHA-256 e `n` vale sempre 1.
- Data e ora nei nomi sono nel fuso di Alberto; nel database sono in UTC. La data di modifica del file è quella di pubblicazione.
- I nomi vengono ripuliti per Windows: caratteri vietati, nomi riservati, punti e spazi finali, percorsi oltre 240 caratteri.
- Cambiare lo schema vale per i prossimi file: quelli già salvati non si rinominano.
### 4.8 Altre funzioni
- **Limiti e comportamento**: §7 e mockup 07.
- **Importazione** di foto e video già esistenti, con controllo dei doppioni prima di copiare: §9 e mockup 09.
- **Avvisi**: striscia rossa in ogni pagina quando Febe è fermo e serve Alberto (mockup 11); notifica di Windows nella versione desktop; messaggio Telegram facoltativo (§13.3).
- **Esportazione** dell'elenco degli elementi in CSV con `;` come separatore e codifica UTF-8 con BOM, perché si apra bene in Excel italiano.
### 4.9 Fuori dalla versione 1
Hashtag e luoghi, commenti, elenchi di follower di altri, messaggi diretti, visione anonima delle storie, più account Instagram nella stessa istanza, pubblicazione di contenuti, aggiornamento automatico del programma, unione di tracce audio e video separate. Non progettare nulla in funzione di queste cose.
---
## 5. Architettura
Un solo motore e una sola interfaccia, in due involucri.
```text
Interfaccia web (HTML, CSS, JS in wwwroot)
│ HTTP, eventi dal server (SSE), WebSocket per la vista remota
┌─────┴─────┐
│ Febe.Web │ API e file statici
└─────┬─────┘
┌──────────────────────┴───────────────────────────┐
│ Febe.Core │
│ Motore · Governatore · Interruttore · Ricette │
│ Lettori · Libreria · Importazione │
└───────┬──────────────────────────────┬───────────┘
┌─────┴─────┐ ┌─────┴────────┐
│ Febe.Data │ │ Febe.Browser │ client CDP, gesti, cattura
│ SQLite │ └─────┬────────┘
└───────────┘ ┌───────────────┴────────────────┐
ChromiumProcessHost WebView2Host
Docker: Chromium su Xvfb Windows: WebView2
└───────────────┬────────────────┘
▼
instagram.com
```
| Progetto | Contenuto |
|---|---|
| `src/Febe.Core` | Dominio e logica: nessun riferimento a interfaccia o piattaforma |
| `src/Febe.Data` | Accesso a SQLite, migrazioni come file SQL numerati |
| `src/Febe.Browser` | Client CDP, `ChromiumProcessHost`, gesti umani, cattura delle risposte, vista remota |
| `src/Febe.Web` | API, eventi, file statici dell'interfaccia |
| `src/Febe.Server` | Eseguibile per Linux e Docker; funziona anche su Windows per lo sviluppo |
| `src/Febe.Desktop` | Eseguibile Windows (WPF): finestra, icona nell'area di notifica, `WebView2Host` |
| `tests/Febe.Tests` | Prove |
| `tools/Febe.Sonda` | Strumento di M0 per raccogliere i campioni |
| `tools/Febe.SitoDiProva` | Sito locale per le prove senza Instagram (§14.2) |
Contratti principali. Sono indicativi nei nomi, vincolanti nella sostanza:
```csharp
public interface IBrowserHost : IAsyncDisposable
{
Task StartAsync(BrowserOptions options, CancellationToken ct);
ICdpSession Cdp { get; }
Task ShowToUserAsync(); // Windows: porta in primo piano la finestra del browser
Task HideFromUserAsync();
bool UserIsDriving { get; } // vero mentre Alberto usa il browser: il motore non agisce
}
public interface ICdpSession
{
Task<JsonElement> SendAsync(string method, object? parameters = null, CancellationToken ct = default);
IDisposable On(string eventName, Action<JsonElement> handler);
}
public interface IGovernor // nessuna azione verso il sito senza un Permit
{
Task<Permit> RequestAsync(ActionKind kind, long? accountId, CancellationToken ct);
}
public interface ICircuitBreaker { BreakerState State { get; } void Report(Signal signal); }
public interface IClock { DateTimeOffset Now { get; } Task Delay(TimeSpan time, CancellationToken ct); }
public interface IRandomSource { double NextDouble(); }
```
`IClock` e `IRandomSource` esistono perché il motore si possa provare con un orologio virtuale e un seme fisso (§14.1): nel codice del motore non compaiono mai `DateTime.Now`, `Task.Delay` o `Random` usati direttamente.
**I due involucri.** In Docker `Febe.Server` avvia e sorveglia Xvfb e Chromium e pubblica l'interfaccia su una porta. Su Windows `Febe.Desktop` avvia lo stesso server in locale su `127.0.0.1`, lo mostra in una finestra e ospita il browser di Instagram in un secondo WebView2, in una finestra a parte. Tutto ciò che sta sopra `IBrowserHost` è identico.
**Un solo motore per account.** Se Alberto usa sia il contenitore sia il desktop, non devono raccogliere entrambi con lo stesso account. Nella versione 1 basta dirlo chiaramente nella guida e nella pagina di collegamento; la tappa M9 aggiunge al desktop la modalità «collegati a un Febe già in funzione», in cui la finestra mostra l'interfaccia del server e non avvia alcun motore.
---
## 6. Raccolta: il browser, le ricette, i lettori
### 6.1 Il browser
- **Docker**: il Chromium della distribuzione, avviato come un browser normale con finestra su un display virtuale (Xvfb), profilo in `/dati/browser`.
- **Collegamento CDP in Docker**: `ChromiumProcessHost` si collega alla porta di debug remoto del browser, fissa e in ascolto solo su `127.0.0.1`, mai pubblicata fuori dal contenitore. Non usare la porta 0, `--remote-debugging-pipe` né `--enable-automation`: mettono Chromium in modalità automazione. **Provato in locale**: con la porta fissa `navigator.webdriver` resta falso; con la porta 0 o con `--enable-automation` diventa vero.
- **Windows**: un WebView2 con una cartella dati propria in `Dati\browser`, pilotato dall'applicazione che lo ospita, senza porte. **Verificato**: il protocollo DevTools si usa con `CoreWebView2.CallDevToolsProtocolMethodAsync` e `GetDevToolsProtocolEventReceiver`; il pacchetto `DevToolsProtocolExtension` è deprecato e non va usato.
- Finestra di dimensione fissa, sempre la stessa. Lingua e fuso orario sono quelli veri di Alberto. In Docker dipendono da `LANG` e `TZ` del contenitore, non da opzioni del browser. **Provato in locale**: con `LANG=it_IT.UTF-8` e `TZ=Europe/Rome` la pagina vede `it-IT` e `Europe/Rome`.
- Il salvataggio delle password e la compilazione automatica del browser sono disattivati: nel profilo resta solo la sessione.
- Il browser deve continuare a caricare e scorrere anche quando Alberto non lo guarda. In Docker lo garantisce il display virtuale (**Provato in locale**: la pagina risulta visibile e attiva). Su Windows è il punto S2 di §6.6.
- **Riposo.** Alla fine di ogni sessione, nelle pause e di notte il browser sta su una pagina vuota: nessuna pagina di Instagram resta aperta fuori da una sessione.
- Il motore non segue mai collegamenti che portano fuori da Instagram.
**Comandi CDP ammessi.** Ogni aggiunta va motivata in `docs/decisioni.md`.
| Scopo | Comandi |
|---|---|
| Navigare e leggere lo stato | `Page.enable`, `Page.navigate`, `Page.getFrameTree`, `Runtime.evaluate` in sola lettura (posizione degli elementi, indirizzo, presenza di finestre; per la ricerca dei profili, se il fuoco è nella casella «Cerca», quanti caratteri contiene e se il cursore è in fondo, mai il testo né altri campi: decisione di Alberto del 15 novembre 2026, #37) |
| Catturare le risposte | `Network.enable`, `Network.getResponseBody`; degli eventi di rete si legge anche `Network.requestWillBeSent`, solo l'indirizzo e solo per l'ordine delle richieste della ricerca (decisione di Alberto del 15 novembre 2026, #37) |
| Gesti | `Input.dispatchMouseEvent`, `Input.dispatchKeyEvent` |
| Scaricare i file | `Network.loadNetworkResource` (richiede l'identificativo del frame), `IO.read`, `IO.close` |
| Vista remota e anteprima | `Page.startScreencast`, `Page.screencastFrameAck`, `Page.stopScreencast`, `Page.captureScreenshot` |
| Controllare il collegamento | `Network.getCookies`, solo per sapere se il cookie di sessione esiste: il valore non si legge né si registra |
| Chiedere i dati alla pagina (regola 2, eccezione) | `Runtime.evaluate` con `awaitPromise`, che esegue nella pagina un `fetch` verso un indirizzo di `richieste.<sito>.json` e ne restituisce il corpo |
**Provato in locale**: gli eventi della rotella inviati con `Input.dispatchMouseEvent` sono eventi veri e fanno scorrere la pagina; `Page.startScreencast` consegna i fotogrammi; `Network.loadNetworkResource` con `IO.read` ha scaricato integro un file di 40 MB.
**Richieste della pagina.** Le regole del `fetch` della riga «Chiedere i dati alla pagina»:
- l'indirizzo, il metodo, i nomi dei parametri e delle intestazioni vengono da un modello di `richieste.<sito>.json`; Febe vi mette solo i valori del caso (nome o identificativo dell'account, cursore della pagina successiva, testo cercato). Un indirizzo che non è nel file non si chiede, e il file si scrive solo da campioni reali (regola 10), ricavati con `febe-sonda richieste` (§14.5);
- i valori delle intestazioni che servono al sito (per esempio il gettone contro le richieste contraffatte) si leggono nella pagina, dove la pagina stessa li tiene, al momento della richiesta, e non escono dalla pagina: allo script torna solo il corpo della risposta;
- solo richieste di lettura: nessuna operazione che cambi qualcosa, anche se il sito la chiamasse con lo stesso metodo;
- una richiesta per volta, ciascuna un'azione del motore con il permesso del Governatore e il suo tetto (§7.4); la risposta passa ai lettori come quelle catturate (§6.2) e porta gli stessi segnali di arresto (§7.6);
- il testo dello script, i valori e la risposta non si registrano mai: il client CDP scrive solo «Runtime.evaluate».
Vietati, in coerenza con la regola 2: `Network.setUserAgentOverride`, tutto il dominio `Emulation`, `Network.setExtraHTTPHeaders`, `Page.addScriptToEvaluateOnNewDocument`, il dominio `Fetch`, `Runtime.evaluate` usato per scorrere, cliccare o modificare la pagina, o per richieste diverse da quelle descritte qui sopra. I gesti passano sempre da `Input`. Se una voce di §6.6 non si risolve senza uno di questi, non aggiungerlo da solo: scrivi l'esito e chiedi ad Alberto.
Il client CDP registra solo i nomi dei comandi e degli eventi, mai parametri e risultati: lì dentro passano tasti, cookie e contenuti.
### 6.2 Cattura
Un componente `ResponseTap` ascolta le risposte JSON che la pagina riceve dal sito e le passa ai lettori. Non filtra per indirizzo: riconosce le risposte dalla forma del contenuto (§6.4). Il corpo vive in memoria per il tempo della lettura e non si scrive su disco, tranne in modalità sonda (§14.5).
### 6.3 Ricette
Una ricetta è una sequenza di gesti con uno scopo. Sono poche e fisse. I passi qui sotto descrivono l'intenzione; i dettagli concreti si definiscono dopo M0, sui campioni.
**Da riscrivere (issue #36).** Con l'eccezione della regola 2 le ricette chiederanno i dati con le richieste della pagina invece di cercarne i comandi, e la mappa dei bersagli non servirà più. Che cosa resta qui sotto e che cosa cambia si decide sui campioni del nuovo HAR (#35). Una cosa non la decido da solo: oggi le storie si salvano solo se mostrate nel visualizzatore, e Alberto risulta tra gli spettatori (§3, domanda 5 di §16); chiederle con una richiesta non le segna come viste. Finché Alberto non sceglie (domanda 11 di §16), vale la regola di oggi: le storie solo dal visualizzatore.
| Ricetta | Che cosa fa | Azioni contate |
|---|---|---|
| **Giro dei seguiti** | Apre la home, legge la barra delle storie e scorre i post recenti dei profili seguiti finché incontra contenuti già noti, con un massimo di 8 raffiche di scorrimento. I post che arrivano con i dati completi si salvano subito | 1 home |
| **Storie di un account** | Apre il visualizzatore dal profilo o dalla barra, guarda le storie di quell'account una a una e salva quelle mostrate | 1 storia per storia mostrata |
| **Controllo del profilo** | Apre la pagina del profilo; legge stato, prima pagina dei post, elenco delle raccolte in evidenza; si ferma ai contenuti già noti | 1 profilo |
| **Storico** | Dal profilo scorre all'indietro una pagina per volta e riprende dal punto in cui si era fermato | 1 pagina di storico per caricamento |
| **Raccolta in evidenza** | Apre una raccolta e ne guarda i contenuti nuovi | 1 storia per contenuto mostrato |
| **Taggati** e **Reel** | Come Controllo e Storico, sulle rispettive schede del profilo | come sopra |
| **Post singolo** | Apre la pagina di un post: quando la griglia non ha dato tutti i dati, o per recuperare un indirizzo scaduto (§6.5) | 1 post |
| **Elenco dei seguiti** | Apre l'elenco dei profili seguiti da Alberto e lo scorre. Solo su richiesta | 1 pagina di elenco per caricamento |
| **Ricerca dei profili** | Solo mentre Alberto scrive nella finestra «Aggiungi account» (§4.2), anche durante una sessione, a turno con il motore fra un'azione e l'altra. Apre «Cerca» e fa clic nella casella; prima di scrivere controlla che il fuoco sia nella casella; scrive con `Input.dispatchKeyEvent` a ritmo umano solo lettere, numeri, «.», «_» e spazi, e cancella con il tasto di cancellazione; non preme mai Invio, Tab o Esc. Legge la risposta che la pagina riceve (`PolarisSearchBoxRefetchableQuery`, riconosciuta dalla forma) e **non fa mai clic su un risultato**, che finirebbe fra le ricerche recenti di Alberto (una scrittura). Fuori sessione, a finestra chiusa o dopo qualche minuto senza lettere nuove, torna alla pagina di riposo | 1 ricerca di profili per apertura, clic nella casella e raffica di tasti |
Regole comuni:
- Una ricetta chiede il permesso al Governatore prima di ogni azione contata e si interrompe con ordine se non lo ottiene.
- I contenuti fissati in cima a un profilo non sono «già noti» ai fini dell'arresto: vanno riconosciuti e saltati.
- **Le storie si salvano solo se mostrate nel visualizzatore.** Anche quando la pagina riceve in anticipo l'elenco completo, Febe salva quelle che ha effettivamente fatto scorrere. Aprire una storia la segna come vista: è il comportamento voluto (§3). Prima di aprire le storie di un account la ricetta verifica che il tetto ne consenta almeno dieci.
- **Le storie di un account finiscono con quell'account.** Dopo l'ultima storia la ricetta chiude il visualizzatore, prima che passi da solo all'account successivo. Se compare comunque una storia di un altro account, non si salva, si chiude e si registra l'accaduto.
- **Lo storico non corre più veloce dei download.** Lo storico di un account si sospende finché quell'account ha più di 60 file in attesa di essere scaricati o il tetto dei dati è raggiunto: gli indirizzi scadono, e accumularli non serve.
- Se a metà ricetta compare un segnale di §7.6, la ricetta si ferma dov'è e lascia la pagina com'è, così Alberto vede che cosa è successo.
**Mappa dei bersagli.** Per agire, una ricetta deve trovare poche cose nella pagina: l'immagine del profilo con l'anello delle storie, il comando per chiudere il visualizzatore, la zona per andare avanti, le schede del profilo, l'elenco dei seguiti, il comando «Cerca» e la sua casella (`search-open`, `search-box`). Come trovarle sta in un file di configurazione per sito (`bersagli.instagram.json`, `bersagli.prova.json`), non nel codice: ruolo dell'elemento, nome accessibile, forma del collegamento. Mai coordinate fisse, mai nomi di classi generate. Il file si aggiorna senza ricompilare, ed è la seconda cosa da ritoccare, dopo i lettori, quando Instagram cambia.
### 6.4 Lettori
Un lettore trasforma una risposta in oggetti del dominio (`Entry`, `Media`, `Account`, `Highlight`).
- Riconosce i dati dalla forma, non dall'indirizzo né da percorsi fissi: cerca nell'albero JSON i nodi che hanno l'aspetto di un contenuto (identificativo, data, versioni dell'immagine o del video, eventuali figli) ovunque si trovino. In passato le risposte del sito hanno usato chiavi come `pk`, `code`, `taken_at`, `image_versions2.candidates`, `video_versions`, `carousel_media`: prendilo come indizio su che cosa cercare, non come schema. Vale la regola 10.
- Ogni lettore ha le sue prove su campioni ripuliti in `tests/campioni/`.
- Davanti a una forma sconosciuta un lettore non fallisce in silenzio: registra un evento «formato non riconosciuto» con la sola struttura delle chiavi, senza valori. Dopo tre casi consecutivi per la stessa ricetta, quella ricetta si sospende e l'interfaccia lo dice. È il modo in cui Febe si accorge che Instagram è cambiato.
- Quando succede, il rimedio è: Alberto riattiva la modalità sonda, raccoglie un campione nuovo, tu aggiorni il lettore e le sue prove sulla copia ripulita.
### 6.5 Scaricare i file
La pagina mostra versioni ridotte; gli indirizzi delle versioni migliori sono nelle risposte e scadono dopo qualche tempo.
1. Si sceglie la versione più grande per le immagini e, per i video, la migliore fra quelle complete di audio.
2. Via preferita: il browser stesso, con `Network.loadNetworkResource` e lettura a blocchi con `IO.read`.
3. Via di riserva, solo se in M0 la prima non regge con il CDN vero (H7): `HttpClient` verso i soli domini del CDN presenti nell'indirizzo ricevuto, mai verso `instagram.com`. Senza cookie e senza intestazioni copiate dal browser: una richiesta semplice, che si presenta come Febe. Se il CDN la rifiuta, il file resta in attesa e l'interfaccia lo dice. La scelta fra 2 e 3 si scrive in `docs/decisioni.md`.
4. Il file si scrive con un nome temporaneo, se ne calcola lo SHA-256 e lo si rinomina. Uno scaricamento interrotto non lascia mai un file con il nome definitivo.
5. Se l'indirizzo è scaduto, il file torna «da scaricare». Il recupero passa dalla ricetta Post singolo, che rilegge il post e ne ottiene uno nuovo, dentro il suo tetto. Per le storie non c'è recupero dopo la scadenza.
6. Coda dedicata, al massimo due scaricamenti insieme, piccole pause casuali, tetto giornaliero sui dati. Le storie hanno la precedenza, perché scadono.
### 6.6 Ipotesi da provare in M0
Finché una voce non ha un esito scritto in `docs/sonda/esito.md`, non costruirci sopra. Le voci H riguardano Instagram e si provano con la sonda passiva (§14.5): Alberto naviga a mano, la sonda guarda. Le voci S riguardano i due browser e si provano con prove usa e getta sulla pagina locale del sito di prova, più l'accesso fatto a mano da Alberto.
| | Ipotesi |
|---|---|
| H1 | La home, ed eventualmente la vista dei soli seguiti in ordine di tempo, consegna i post recenti dei profili seguiti con i dati completi dei file |
| H2 | La barra delle storie dice quali profili seguiti hanno storie attive e a quando risale l'ultima |
| H3 | La pagina di un profilo consegna identificativo, pubblico o privato, se Alberto lo segue, prima pagina dei post con i file delle serie e le versioni video, elenco delle raccolte; lo scorrimento carica le pagine successive |
| H4 | Aprendo il visualizzatore arriva l'elenco delle storie dell'account con gli indirizzi dei file, e si capisce qual è l'ultima |
| H5 | Per i video arriva almeno un indirizzo unico con audio e video insieme |
| H6 | Le schede «taggati» e «reel» si comportano come la griglia principale |
| H7 | I file del CDN si scaricano con `Network.loadNetworkResource`; se no, con la via di riserva di §6.5 |
| H8 | I segnali di arresto di §7.6 si riconoscono da indirizzo e stato HTTP |
| H9 | Un contenuto di una raccolta in evidenza ha lo stesso identificativo che aveva come storia |
| H10 | Identificativo e nome dell'account collegato si ricavano dai dati che la pagina riceve, senza leggere i cookie |
| H11 | I bersagli delle ricette si trovano con attributi stabili: ruolo, nome accessibile, forma del collegamento |
| S1 | In WebView2 funzionano attraverso CDP il corpo delle risposte, i gesti e i fotogrammi della pagina |
| S2 | Su Windows la pagina continua a caricare e a rispondere allo scorrimento quando la finestra del browser non è in vista |
| S3 | L'accesso fatto a mano sopravvive al riavvio del programma, in Docker e su Windows |
| S4 | In Docker, con la vista remota, si riesce a scrivere in un modulo e a navigare con un ritardo sopportabile |
| S5 | Chromium in Docker parte con la sua sandbox attiva; altrimenti quale compromesso serve (§11) |
| S6 | Che cosa vede una pagina nei due browser: `navigator.webdriver`, visibilità, fuoco, lingua, fuso orario. Va scritto nell'esito, per sapere che cosa il browser dichiara |
Per S2 prova nell'ordine: finestra del browser separata, tenuta aperta ma fuori vista, con il rilevamento dell'occlusione disattivato dagli argomenti del browser; poi l'ospitalità a composizione di WebView2; infine il ripiego di avviare Edge come processo con `ChromiumProcessHost` anche su Windows. **Verificato**: se `IsVisible` del controllo va a falso, WebView2 smette di disegnare e rallenta la pagina, quindi quella proprietà deve restare vera.
---
## 7. Il motore: ritmo umano, tetti, arresti
### 7.1 Principio
Febe non cerca di sembrare un utente qualsiasi: cerca di comportarsi come **Alberto che usa Instagram dal suo computer**. Stesso dispositivo, stessa rete, stessi orari plausibili, poche visite brevi, pause lunghe, nessuna fretta. La casualità riguarda il comportamento (quando, quanto, in che ordine, a che velocità); l'identità del browser non cambia mai.
Nessuno può garantire che basti. Per questo il motore ha tre livelli indipendenti: un ritmo credibile (§7.2, §7.7), tetti rigidi che valgono anche quando il ritmo sbaglia (§7.4), e un interruttore che ferma tutto al primo segnale (§7.6).
### 7.2 Giornata, sessioni, pause
- **Fascia oraria e giorni.** Febe lavora solo dentro una fascia giornaliera, con inizio e fine spostati ogni giorno di una quantità casuale, e solo nei giorni della settimana attivi (tutti, per impostazione predefinita). Fuori fascia il motore non apre nulla di sua iniziativa; l'unica eccezione è un comando manuale confermato da Alberto (§7.8).
- **Sessioni.** Dentro la fascia l'attività è fatta di sessioni brevi separate da pause. Durata della sessione e lunghezza della pausa si estraggono ogni volta da una distribuzione log-normale tagliata sugli estremi del profilo. Mai una distribuzione uniforme, mai intervalli fissi.
- **Pavimento.** La pausa minima vale sempre, anche con molto lavoro arretrato. L'arretrato si smaltisce nei giorni, non stringendo le pause.
- **Avvio.** Dopo l'avvio del programma la prima sessione parte dopo un'attesa casuale fra 2 e 10 minuti. Tetti e registro delle azioni sono su disco: un riavvio non azzera nulla. Un programma che riparte più volte non deve produrre più traffico di uno che resta acceso.
- **Composizione.** Una sessione comincia di norma con il Giro dei seguiti, prosegue con le storie segnalate, poi con i controlli di profilo scaduti, infine con qualche pagina di storico. Non tutte le sessioni fanno tutto: circa una su tre si limita al giro e alle storie. L'ordine degli account è estratto a caso con pesi, mai lo stesso.
- **Umore della sessione.** Ogni sessione ha un fattore di velocità estratto una volta, che moltiplica tutte le attese: alcune sessioni sono svelte, altre lente.
- **Riposo.** A fine sessione il browser torna alla pagina vuota (§6.1).
- **Avvio graduale.** Se attivo (lo è per impostazione predefinita), nei primi giorni dopo il collegamento e dopo ogni verifica risolta i tetti partono dalla metà e risalgono in modo lineare fino al valore pieno, nel numero di giorni previsto dal profilo.
Parametri delle estrazioni:
| Che cosa | Distribuzione |
|---|---|
| Un intervallo «da a a b» (durate, pause, attese) | Log-normale con mediana √(a·b) e σ = ln(b/a)/4, tagliata su [a, b]. Dove è indicata una mediana si usa quella |
| Umore della sessione | Log-normale, mediana 1, σ 0,2, tagliata fra 0,7 e 1,5 |
| Scostamento del prossimo controllo | Intervallo × log-normale con mediana 1, σ 0,25, tagliata fra 0,6 e 1,8 |
| Peso di un account nella scelta | (Alta 3, Normale 2, Bassa 1) × (1 + ritardo ÷ intervallo), con il rapporto limitato a 3 |
| Distanza minima fra due azioni contate | 4 secondi con il ritmo «naturale» |
### 7.3 Frequenze
La frequenza di un account esprime un desiderio; il Governatore decide che cosa è possibile.
| Frequenza | Profilo non seguito: controllo | Profilo seguito: riconciliazione | Storie: intervallo massimo |
|---|---|---|---|
| Bassa | ogni 12 ore circa | ogni 24 ore | 8 ore |
| Normale | ogni 3 ore circa | ogni 12 ore | 6 ore |
| Alta | ogni 75 minuti circa | ogni 6 ore | 3 ore |
- I profili seguiti si scoprono con il Giro: il controllo diretto del profilo serve solo come riconciliazione, per ciò che il giro può aver perso.
- Le storie durano 24 ore: con «Storie» attivo ogni account riceve almeno tre controlli al giorno dentro la fascia, qualunque sia la frequenza.
- Lo storico avanza su un solo account per sessione. Più account possono essere «Storico in corso» nello stesso periodo: si alternano, ciascuno fino al suo massimo giornaliero.
### 7.4 Governatore e tetti
Il Governatore è l'unico punto da cui passa un'azione del motore verso il sito. Per ogni richiesta controlla, nell'ordine: stato dell'interruttore, fascia oraria, sessione in corso, tetto orario e giornaliero della categoria, distanza minima dall'azione precedente, limiti propri dell'account. Risponde con un permesso o con un rifiuto motivato, che finisce nell'interfaccia.
- I tetti orari valgono su una finestra mobile di 60 minuti; quelli giornalieri sul giorno di calendario nel fuso di Alberto.
- Il conteggio sta nella tabella `action_log`, non in memoria.
- Categorie: home, profili aperti, storie viste, pagine di storico, post singoli, pagine dell'elenco dei seguiti, dati scaricati, ricerche di profili. Le richieste della pagina (regola 2, eccezione) contano nella categoria di ciò che chiedono.
- **Ricerche di profili** (issue #37) hanno tetti propri e larghi (§7.5), che fanno da guardia e non devono mai fermare l'uso normale, e non consumano i tetti della raccolta. Non chiedono una sessione e non contano fra le azioni della sessione. L'ordine dei controlli: interruttore (ogni segnale di §7.6 ferma anche la ricerca), browser in uso da Alberto, pausa, fascia oraria, tetto orario e giornaliero proprio, distanza propria fra due passi della ricerca (1,2 s per il ritmo), 1,2 s di distanza dalle azioni del motore in entrambi i versi. Le riduzioni (avvio graduale, tetti dimezzati) valgono anche qui. Le foto dei risultati contano fra i dati scaricati.
- Sopra l'80% di un tetto l'interfaccia lo segnala in ambra. Raggiunto il tetto, quella categoria si ferma fino all'ora o al giorno dopo; le altre proseguono, salvo la regola sullo storico di §6.3.
- Quando valgono insieme più riduzioni (avvio graduale, tetti dimezzati dopo un rallentamento) si applica la più forte, non il loro prodotto.
### 7.5 Profili di prudenza
I valori sono **stime di partenza scelte con prudenza**. Non sono limiti ufficiali, che Instagram non pubblica, e non sono misure. Vanno ritoccati guardando che cosa succede, e l'interfaccia deve dirlo con le stesse parole (mockup 07).
| | Prudente | Equilibrato | Rapido |
|---|---|---|---|
| Fascia oraria | 07:30–23:30, ± 40 min | 07:00–24:00, ± 30 min | 06:30–00:30, ± 30 min |
| Durata di una sessione | 2–10 min | 3–14 min | 4–18 min |
| Pausa tra le sessioni | 20–90 min | 12–60 min | 8–40 min |
| Home, all'ora / al giorno | 4 / 30 | 5 / 45 | 6 / 60 |
| Profili aperti | 12 / 100 | 20 / 180 | 30 / 300 |
| Storie viste | 50 / 300 | 80 / 500 | 120 / 800 |
| Pagine di storico | 20 / 100 | 30 / 180 | 45 / 300 |
| Post singoli | 10 / 60 | 15 / 100 | 20 / 160 |
| Pagine dell'elenco dei seguiti | 15 / 60 | 20 / 90 | 30 / 150 |
| Ricerche di profili | 240 / 1200 | 300 / 1500 | 360 / 1800 |
| Dati scaricati al giorno | 4 GB | 8 GB | 16 GB |
| Storico per account al giorno | 300 post | 500 post | 800 post |
| Avvio graduale | 7 giorni | 5 giorni | 3 giorni |
- «Prudente» è il predefinito. «Rapido» chiede conferma e mostra l'etichetta «Più rischio». Se Alberto modifica un valore, il profilo diventa «Su misura».
- «Storico per account al giorno» è il valore di partenza del limite che ogni account ha nelle proprie impostazioni (§4.4).
- Limiti di ciò che l'interfaccia accetta: pausa minima non sotto i 5 minuti; sessione non oltre i 30; fascia non oltre le 20 ore; nessun tetto oltre il doppio di «Rapido».
### 7.6 Segnali e arresti
L'interruttore riceve segnali dalle ricette e dalla cattura. L'elenco di partenza sta in un file di configurazione (`segnali.json`), così si aggiorna senza ricompilare; va completato dopo M0 (H8).
| Livello | Segnali | Che cosa fa Febe |
|---|---|---|
| **Rallentamento** | Risposta con stato 429; risposta che chiede di attendere qualche minuto; pagine o risposte vuote ripetute | Chiude subito la sessione. Fermo 1 ora la prima volta, 6 ore la seconda nelle 24 ore, 24 ore la terza. Poi tetti dimezzati per 48 ore |
| **Verifica** | Navigazione verso pagine di verifica, controllo o sospensione; avviso di comportamento automatico; richiesta di confermare l'identità | Ferma tutto e non riparte da solo. Striscia rossa, notifica, pagina lasciata com'è |
| **Disconnessione** | La pagina torna all'accesso; il cookie di sessione non c'è più | Come Verifica. Non tenta mai di rientrare |
- Le durate dei fermi sono fisse: nella versione 1 non si modificano dall'interfaccia.
- Dopo Verifica o Disconnessione riparte solo quando Alberto ha sistemato a mano nel browser e ha premuto «Riprendi». La ripresa comincia con l'avvio graduale.
- Durante un fermo gli scaricamenti già in coda dal CDN si completano; verso il sito non parte nulla.
- Ogni arresto finisce nella tabella `incident` con data, livello, segnale e indirizzo, e nella cronologia della pagina Attività.
- Tre rallentamenti in sette giorni: Febe propone di passare al profilo più prudente o di ridurre gli account.
### 7.7 Il ritmo dei gesti
Tutte le attese seguono le distribuzioni di §7.2, moltiplicate per l'umore della sessione e per il cursore «Ritmo dei gesti» (lento, naturale, svelto). I numeri che seguono sono il punto di partenza per «naturale».
| Gesto | Come |
|---|---|
| Dopo il caricamento di una pagina | Attesa con mediana di 2,2 s (da 1 a 6) prima del primo gesto |
| Scorrimento | Raffiche di 3–8 eventi della rotella da 80–140 pixel, a 12–40 ms l'uno dall'altro, con velocità che cala. Fra una raffica e l'altra mediana di 1,1 s (da 0,4 a 4). Ogni 6–10 raffiche una sosta di lettura con mediana di 6 s (da 3 a 20). Ogni tanto un piccolo ritorno indietro |
| Puntatore | Dal punto in cui si trova al bersaglio lungo una traiettoria leggermente curva, in 250–900 ms, con partenza e arrivo morbidi. Arrivo in un punto casuale dentro la parte centrale dell'elemento, mai al centro esatto |
| Clic | Sosta di 80–300 ms sul bersaglio, pressione e rilascio a 50–140 ms di distanza |
| Storie | Foto: da 1,8 a 5 s, poi avanti con un clic o lasciando scorrere. Video: dal 40 al 100% della durata, con un massimo di 15 s. Fra un account e l'altro da 1 a 4 s |
| Distrazioni | Con probabilità dell'8% dopo un'azione, un'attesa in più fra 15 e 90 s |
Regole: il puntatore non salta mai da un punto all'altro; non si clicca nulla che non sia il bersaglio di una ricetta; se il bersaglio non si trova con la mappa di §6.3, la ricetta si ferma e segnala, non tenta coordinate a caso.
### 7.8 Comandi manuali
«Controlla ora» su un account mette quel controllo in cima alla coda. Passa comunque dal Governatore: se il tetto è esaurito Febe lo dice e non lo fa. Se si è fuori fascia chiede conferma e, avutala, esegue quel solo controllo: è l'unico caso in cui il motore agisce fuori fascia, perché in quel momento Alberto è presente. «Metti in pausa» ferma il motore finché non si preme «Riprendi».
### 7.9 Che cosa deve vedere Alberto
La pagina Attività (mockup 06 e 11) è il cruscotto del motore: che cosa sta facendo adesso, la **striscia della giornata** con sessioni, riposo, rallentamenti e arresti, i quattro tetti principali con i numeri (profili aperti, storie viste, pagine di storico, dati scaricati) e, da «Tutti i tetti», anche gli altri; la coda con orari indicativi, le ultime azioni con l'esito. Gli orari futuri si scrivono sempre come «verso le», perché sono estratti a caso.
**Rapporto di diagnostica.** Dopo una prova dal vivo andata storta, Alberto deve poter mandare un solo file che spieghi perché, senza che nessuno apra i dati di altre persone. «Esporta il rapporto di diagnostica» (pulsante «Diagnostica» nella riga del titolo di Attività) scarica `febe-diagnostica-aaaa-mm-gg.json`: per ogni sessione del motore delle ultime due settimane, e per ogni giorno fuori dalle sessioni, le pagine aperte (il nome della pagina nella mappa del sito e la sua forma, mai l'indirizzo), le risposte ricevute per tipo con numero e misure, che cosa ne hanno fatto i lettori (riconosciute, vuote, ignorate, forma sconosciuta con la sola struttura delle chiavi, in cui resta solo una chiave fatta di parole di un elenco chiuso, preso dai campioni ripuliti e dai vocabolari dei lettori, mai di sole parole che sono anche nomi come «max_mark», e ogni altra diventa `#`; diventano `#` anche le voci di una mappa, cioè le chiavi sorelle con valori della stessa forma, salvo quelle che i lettori conoscono come `user` e `owner`), i bersagli cliccati, le ricette con l'esito (e, per un errore imprevisto, il solo tipo dell'eccezione), i segnali di §7.6 per livello e codice, i rifiuti del Governatore, i file messi in coda e scaricati (per un file fallito o da riprovare, la causa da un elenco chiuso, come `http-404`), e la causa di ogni fine (fine prevista, lavoro finito, tetti esauriti, ricetta che ferma, interruttore aperto, pausa, Alberto al browser, chiusura di Febe, errore). Mai cookie, password, gettoni, corpi delle risposte, nomi utente, didascalie, codici dei post, identificativi, indirizzi interi o testi liberi (messaggi, note, eccezioni): solo valori di elenchi chiusi, conteggi, misure, orari e forme degli indirizzi in cui ogni parte che non è una parola fissa del sito è `{numero}` o `{testo}`; per il CDN solo «cdn» e l'estensione del file. Le tracce finite stanno in `Dati/diagnostica/sessioni-aaaa-mm-gg.jsonl`, una riga per sessione, e si tengono 14 giorni (Febe cancella da sé solo i file più vecchi di quella cartella); le sessioni in corso entrano nel rapporto come «in corso». Una sessione scrive una riga «in corso» quando parte e poi al più ogni 5 minuti alla fine di una ricetta, così una chiusura brusca di Febe non la cancella; leggendo, di una sessione resta la riga finita, altrimenti l'ultima. I segnali entrano anche quando arrivano all'interruttore senza passare dal rilevatore (il cookie di sessione perso), e i file in attesa perché manca la connessione hanno la causa `connessione`. La testa del file dice che cosa sicuramente manca: righe del registro rovinate (`righeRovinate`), errori del registratore, scritture non riuscite comprese (`erroriRegistratore`), file di un giorno che non si sono potuti leggere (`fileIlleggibili`) e sessioni rimaste senza fine per una chiusura brusca (`sessioniSenzaFine`). Anche a zero il rapporto non promette di essere intero: gli ultimi minuti di una chiusura brusca, le ore fuori dalle sessioni del giorno e quello che supera i tetti (contato in `overflow`) possono mancare. Le forme delle pagine della mappa del sito passano per la stessa riduzione degli indirizzi, perché la mappa può venire dalla cartella dei dati. Con un problema di configurazione il motore non parte: l'indirizzo del rapporto risponde lo stesso, con gli elenchi vuoti. Una prova dimostra che nessun valore dei dati arriva nel file.
---
## 8. Dati: database e file
### 8.1 File o database: la valutazione
| | Solo file (JSON) | SQLite più file | PostgreSQL più file |
|---|---|---|---|
| «C'è già questo contenuto?» su 200.000 elementi | Lento, tutto in memoria | Immediato, con indici | Immediato |
| Coda, tetti e registro che sopravvivono a un'interruzione | Fragile | Transazioni | Transazioni |
| Filtri e ricerca nell'interfaccia | Da scrivere a mano | SQL | SQL |
| Installazione | Nulla | Nulla: un file | Un servizio in più, anche sul desktop |
| Uguale in Docker e su Windows | Sì | Sì | No |
| Libreria leggibile senza il programma | Sì | Sì: i file restano file | Sì |
**Scelta: SQLite per l'indice e lo stato, file normali per i contenuti.** Il database non contiene immagini. La libreria resta una cartella di file con nomi parlanti, utilizzabile anche senza Febe, e ogni cartella di account porta con sé i propri metadati (§8.5), così il database si può ricostruire. PostgreSQL servirebbe solo con più utenti o più istanze sugli stessi dati, che non è il caso.
### 8.2 Dove stanno le cose
```text
Dati\
febe.sqlite database (modalità WAL)
browser\ profilo del browser: contiene la sessione di Instagram
miniature\ anteprime ridotte
copie\ copie giornaliere del database
registro\ log a rotazione
segnali.json segnali di arresto
bersagli.*.json mappa dei bersagli
Libreria\
<account>\ ... foto e video
<account>\_febe.jsonl metadati dell'account, una riga per elemento
```
La cartella dei dati deve stare su un disco locale: SQLite in modalità WAL e il profilo del browser non reggono le condivisioni di rete (**Verificato** per WebView2 nella documentazione Microsoft). All'avvio Febe controlla: se trova un percorso di rete il motore non parte, e l'interfaccia mostra solo la pagina che spiega il problema. Chi ha accesso alla cartella dei dati ha accesso alla sessione di Instagram: va detto nella guida e vale anche per le copie.
### 8.3 Schema
Tabelle principali. Completa colonne e indici dove serve, ma non cambiare i concetti.
| Tabella | Contenuto |
|---|---|
| `setting` | Chiave e valore |
| `account` | Identificativo Instagram, nome utente, nome visibile, privato, seguito, è il mio, stato, tieni aggiornato, frequenza, tipi da scaricare, limiti, cartella, punto di ripresa dello storico, ultimi e prossimi controlli |
| `entry` | Un elemento: account, tipo (§4.3), identificativo e codice Instagram, data di pubblicazione in UTC, didascalia, autore (per i taggati), stato, provenienza, date di scoperta e di scaricamento |
| `media` | Un file di un elemento: posizione, foto o video, dimensioni, durata, stato, percorso relativo, byte, SHA-256, impronta visiva, tentativi, ultimo errore |
| `highlight`, `highlight_entry` | Raccolte in evidenza di un account e loro contenuti, in ordine. Un elemento può stare in più raccolte |
| `duplicate_pair` | Coppie di file «doppione probabile» in attesa della decisione di Alberto, da importazione o da scaricamento |
| `task` | Coda del motore: tipo, account, scadenza, priorità, stato |
| `action_log` | Una riga per azione verso il sito: quando, categoria, account, sessione. È la base dei tetti |
| `session` | Inizio, fine, numero di azioni, esito. Alimenta la striscia della giornata |
| `incident` | Arresti: quando, livello, segnale, indirizzo, fermo fino a, risolto il |
| `event` | Cronologia leggibile per l'interfaccia |
| `following` | Copia locale dell'elenco dei profili seguiti, con data di lettura |
| `import_run`, `import_file` | Importazioni e loro file, con esito e decisione |
Vincoli che contano:
- `entry` è unico per (account, tipo, identificativo Instagram); `media` per (elemento, posizione). Lo stesso post può comparire sotto due account, come post di uno e come taggato di un altro: sono due elementi e due copie dei file.
- Stati di un elemento: da scaricare, scaricato, parziale, fallito, saltato, importato, eliminato. «Eliminato» resta nel database senza file, perché non venga riscaricato (§4.6).
- Indici su (account, data di pubblicazione), SHA-256, impronta, stato.
- Versione dello schema in `PRAGMA user_version`, migrazioni come file SQL numerati eseguiti all'avvio dentro una transazione. Un solo scrittore: le scritture passano da una coda.
### 8.4 Miniature e impronte
- Miniatura di 480 pixel sul lato lungo per ogni immagine; per i video si usa la copertina che arriva dalla pagina e, per quelli importati, un fotogramma estratto con ffmpeg se presente, altrimenti una tessera neutra.
- SHA-256 del file per i doppioni esatti.
- Impronta visiva a 64 bit per le immagini, per riconoscere la stessa foto salvata a risoluzione o compressione diversa. Le impronte stanno in memoria: il confronto di una foto con 200.000 è questione di millisecondi.
### 8.5 Copie e ricostruzione
- Copia giornaliera del database con `VACUUM INTO` verso un file nuovo con la data nel nome, in `Dati\copie`; si tengono sette giorni.
- In ogni cartella di account il file `_febe.jsonl` riceve una riga per ogni elemento salvato (identificativi, date, didascalia, nomi dei file) e una riga per ogni eliminazione. Si aggiunge in coda e non si riscrive.
- Comando di manutenzione «Ricostruisci il database dalla libreria»: rilegge cartelle e file `_febe.jsonl`, ricalcola hash e impronte, rispetta le eliminazioni. Deve bastare a ripartire dopo la perdita del database, senza riscaricare nulla.
---
## 9. Importazione
Serve a portare in libreria foto e video che Alberto ha già, anche di contenuti che su Instagram non esistono più, senza creare doppioni e senza toccare gli originali finché lui non decide.
### 9.1 Flusso
Quattro passi, mostrati in alto nella pagina (mockup 09):
1. **Sorgente.** Su Windows si sceglie una cartella; in Docker una sottocartella del volume `/importa`.
2. **Analisi.** Sola lettura: nessun file viene copiato o spostato. Si può interrompere e riprendere.
3. **Revisione.** Alberto vede il riepilogo, associa le cartelle agli account, decide sui doppioni probabili.
4. **Copia.** Copia o spostamento con verifica, poi resoconto.
### 9.2 Analisi
Per ogni file: tipo dal contenuto e non solo dall'estensione; byte; SHA-256; dimensioni; impronta visiva per le immagini; data, cercata nell'ordine nel nome del file, nei metadati del file (data di scatto delle foto, data di creazione dei video), nella data di modifica; identificativo o codice Instagram, se il nome lo contiene; account probabile, dal nome della cartella; tipo probabile (storia, evidenza, taggato) dalle sottocartelle. La lettura dei metadati si scrive a mano per i pochi campi che servono, oppure si usa ffprobe dove è presente.
### 9.3 Confronto con la libreria
| Esito | Criterio | Che cosa succede |
|---|---|---|
| **Già in libreria** | Stesso SHA-256 di un file presente in qualunque account | Saltato. Il resoconto dice in quale account si trova |
| **Doppione probabile** | Stesso identificativo Instagram con file diverso, oppure impronta visiva molto vicina. Si cerca prima nell'account di destinazione, poi nel resto della libreria | Alberto decide: tenere il più grande, tenere quello in libreria, tenerli entrambi. Può applicare la scelta a tutti i casi simili |
| **Nuovo** | Nessuna corrispondenza | Verrà copiato |
| **Non riconosciuto** | Né foto né video | Ignorato ed elencato |
I doppioni si cercano anche dentro la sorgente stessa. Le soglie dell'impronta si tarano con le prove di §14.1 su varianti costruite apposta: ridimensionata e ricompressa deve risultare doppione, ritagliata no. Per i video vale solo lo SHA-256. «Tenere il più grande», quando il più grande è quello importato, sostituisce un file della libreria: è una scelta esplicita di Alberto, come chiede la regola 12.
### 9.4 Associazione e copia
- Una tabella lega ogni cartella sorgente a un account: uno esistente, oppure uno nuovo «Solo archivio». Una cartella senza account blocca solo i propri file: il pulsante finale dice quanti ne importa e quanti restano fuori.
- Predefinito **Copia**. Con **Sposta** l'originale si elimina solo dopo che la copia è stata verificata con lo SHA-256. Se la sorgente è in sola lettura, come il volume `/importa` di Docker, «Sposta» non compare.
- Mai sovrascrivere. I file con data e codice noti prendono il nome secondo lo schema della libreria; gli altri vanno in `{account}\importati\` con il nome originale.
- Ogni file ha il suo esito nel database: un'importazione interrotta riprende da dove era.
- Alla fine: resoconto a schermo ed esportazione CSV.
### 9.5 Dopo l'importazione
Gli elementi importati contano come presenti. Quando Febe tiene aggiornato quell'account non li riscarica se li riconosce dall'identificativo, oppure da account, tipo e data di pubblicazione entro due secondi. Se non li riconosce prima, li riconosce dopo lo scaricamento:
- file appena scaricato identico (stesso SHA-256) a uno già presente nello stesso account: il nuovo file si scarta prima di entrare in libreria, e i dati di Instagram (identificativo, didascalia) si aggiungono all'elemento esistente;
- file visivamente uguale ma diverso: restano entrambi, e la coppia va in `duplicate_pair` per la decisione di Alberto. Nessuna sostituzione automatica.
### 9.6 Librerie di 4K Stogram
È probabile che la sorgente principale sia una libreria di 4K Stogram. **Verificato**: nella cartella di uscita di 4K Stogram ci sono i file `stogram.sqlite`, `stogram.app.sqlite` e `stogram.sqlite.backup`. **Ipotesi**, da un ricordo non verificato: una sottocartella per account e nomi del tipo `AAAA-MM-GG HH.MM.SS <id contenuto>_<id utente>.jpg`, con sottocartelle per storie, evidenza e taggati.
Prima di scrivere il riconoscitore chiedi ad Alberto una ventina di righe dell'elenco dei file di una cartella vera, con i nomi degli account sostituiti (domanda 4 di §16), e, se è d'accordo, il solo schema di `stogram.sqlite`, senza dati. Se quel database lega i file ai post, usalo in sola lettura per recuperare didascalie e identificativi. Scrivi il riconoscitore sui dati veri, con prove.
---
## 10. Interfaccia e grafica
### 10.1 Direzione
Semplice e moderna, con una ragione dietro ogni scelta:
- **Le foto portano il colore, l'interfaccia resta in grigio neutro.** Come nei programmi di fotoritocco, i grigi non hanno dominante, così i colori delle immagini non vengono falsati. Niente sfumature decorative, niente richiami alla grafica di Instagram.
- **Un solo accento**, un blu cianotipo, per l'azione principale, la selezione e le sessioni del motore. Verde, ambra e rosso servono solo a dire uno stato, sempre accompagnati da testo o numero.
- **Un solo carattere**, Archivo, in due larghezze: normale per l'interfaccia, più stretta con cifre tabellari per i dati (date, numeri, nomi di file).
- **Raggi che crescono con l'importanza**: 3 per le tessere, 7 per i controlli, 10 per i pannelli, 14 per le finestre di dialogo. Ombre solo su menu e dialoghi; il resto si separa con linee sottili.
- **Elenchi e tabelle, non mosaici di riquadri uguali.** Un pannello si usa quando raggruppa davvero qualcosa.
- **La striscia della giornata** è l'elemento che distingue Febe: una barra di 24 ore con le sessioni come tratti irregolari. Il resto le sta intorno in silenzio.
Token di colore, misure e CSS di partenza sono nell'appendice B e nel mockup 13. I nomi dei token restano quelli.
### 10.2 Ossatura
Barra laterale fissa di 228 pixel: marchio, quattro voci (Libreria, Account, Attività, Importa), separatore, Impostazioni. In fondo il riquadro di stato, sempre visibile: stato del motore, una riga su che cosa sta facendo o quando riprende, misuratore dei profili aperti oggi, account collegato. A destra la pagina: titolo, eventuale riga di strumenti, contenuto che scorre. Le azioni che salvano stanno in una barra fissa in basso.
### 10.3 Schermate
Ogni riga è un file in `docs/mockup/`. I dati sono inventati: gli account che finiscono in `.demo` non esistono e le fotografie sono disegni generati. Segui le immagini per disposizione, proporzioni e gerarchia. I loro contenuti non vanno nel codice dell'interfaccia: stanno solo nei dati della modalità dimostrativa (§10.6).
| File | Schermata | Ciò che l'immagine non dice |
|---|---|---|
| `00-panoramica.png` | Tutte le schermate insieme | Serve a orientarsi |
| `01-libreria.png` | Libreria | Righe giustificate che rispettano le proporzioni delle foto, 4 px fra le tessere. Segni in alto a destra: durata per i video, numero dei file per i post con più file, anello tratteggiato per le storie. I menu Account, Periodo e Provenienza mostrano il nome del filtro finché non si sceglie un valore. Il cursore accanto a «Seleziona» regola la grandezza delle tessere. Al passaggio del mouse: account, ora, cerchio di selezione. I nuovi elementi compaiono in cima senza spostare ciò che si sta guardando |
| `02-visualizzatore.png` | Visualizzatore | Copre tutta la finestra. Frecce e tasti freccia; Esc chiude. I video partono senza audio. Nel browser «Mostra nella cartella» diventa «Scarica» |
| `03-account.png` | Account | Le cinque icone di «Raccoglie» sono nell'ordine: foto, video, storie, evidenza, taggati; spente se non attive. L'interruttore agisce subito. Un clic sulla riga apre la scheda |
| `04-aggiungi-account.png` | Aggiungi account | I tre punti di partenza sono quelli di §4.2. **Superato da #37**: niente linguette, una sola casella con l'elenco dei suggerimenti sotto (profili seguiti, poi Instagram, con foto ed etichette), «Da aggiungere» al posto dell'elenco a spunte, che si apre con «Scegli fra tutti i profili che segui». I profili già presenti sono attenuati. Durante la lettura dell'elenco compare l'avanzamento di §4.2. Finché non c'è un mockup nuovo, il riferimento è la schermata `docs/schermate/04-aggiungi-account.png` |
| `05-account-impostazioni.png` | Scheda account, impostazioni | Il riquadro a destra si ricalcola a ogni modifica. «Controlla ora» segue §7.8. Con «Su misura» compaiono i due campi di §4.4 |
| `06-attivita.png` | Attività | Si aggiorna da sola con gli eventi del server. L'anteprima del browser è un fotogramma ogni pochi secondi, non un video. «Tutti i tetti» apre l'elenco completo di §7.4 |
| `07-limiti-e-comportamento.png` | Impostazioni, limiti | Modificare un valore cambia il profilo in «Su misura». I cerchi con le iniziali sono i giorni attivi. Nel programma la tabella dei tetti ha anche le righe Home, Post singoli ed Elenco dei seguiti di §7.5, e «Ricerche di profili» (#37). La riga degli arresti è informativa: non si modifica |
| `08-impostazioni-generali.png` | Impostazioni, generali | In Docker le due cartelle sono in sola lettura, con la nota che si cambiano dal contenitore. Il blocco «Avvio» esiste solo su Windows |
| `09-importa-revisione.png` | Importa, passo 3 | I passi 1, 2 e 4 usano la stessa intestazione: scelta della cartella, barra di avanzamento con possibilità di interrompere, resoconto finale. Nel confronto dei doppioni nessuna scelta è già fatta in partenza: l'immagine mostra una decisione presa da Alberto. «Sposta» non compare se la sorgente è in sola lettura |
| `10-collegamento-instagram.png` | Collegamento, versione Docker | Il riquadro grande è la vista remota del browser del server. Il rettangolo tratteggiato dell'immagine è un segnaposto: la pagina di Instagram non si ridisegna. Versione Windows qui sotto |
| `11-attivita-fermo-tema-scuro.png` | Attività durante un arresto, tema scuro | La striscia rossa compare in cima a tutte le pagine, non solo qui. «Riprendi» si attiva dopo che Alberto ha usato il browser |
| `12-account-storie-tema-scuro.png` | Scheda account, storie, tema scuro | Griglia regolare con proporzione 9:16. Post, In evidenza e Taggati usano il mosaico della Libreria; le raccolte in evidenza sono intestazioni di gruppo |
| `13-foglio-di-stile.png` | Colori, caratteri, misure, componenti | È il riferimento per qualunque elemento non disegnato altrove. Non è una schermata del programma |
| `14-finestra-stretta-e-telefono.png` | Finestra stretta su Windows, telefono nel browser | Sotto i 1000 px la barra laterale si riduce alle icone; sotto i 560 px una colonna e navigazione in basso |
**Collegamento su Windows.** La pagina è la stessa del mockup 10, ma il browser è la finestra «Browser di Febe». Nel riquadro grande compare la frase «Il browser di Febe è aperto in un'altra finestra» con il pulsante «Portalo in primo piano». Il testo accanto dice: «La password va solo a Instagram. La scrivi direttamente nella sua pagina: Febe non la riceve e non la salva. Resta solo la sessione del browser, nella cartella dei dati.»
**«Apri il browser»**, da Attività e dalla striscia rossa: su Windows porta in primo piano la finestra del browser; in Docker apre la pagina «Browser», che è il mockup 10 senza la colonna dei passi, con la vista remota e il pulsante «Ho finito». Finché Alberto usa il browser il motore resta fermo.
Schermate senza mockup, da comporre con gli elementi del foglio di stile: Scheda account → Cronologia (elenco dei controlli con esito); Impostazioni → Notifiche, Dati e copie di sicurezza, Informazioni; revisione dei doppioni dopo uno scaricamento (lo stesso confronto del mockup 09); primo avvio (la schermata vuota del mockup 13 con i due pulsanti); pagina di errore di configurazione (§8.2, §11).
### 10.4 Testi
- Frasi in italiano corrente, iniziale maiuscola solo alla prima parola. Niente etichette in tutto maiuscolo.
- I nomi sono quelli che usa Alberto, non quelli del codice: «storico» e non «backfill», «tetto» e non «rate limit», «verifica» e non «challenge».
- Un pulsante dice che cosa succede: «Importa 7.682 file», non «Conferma». La stessa azione ha lo stesso nome ovunque.
- Un errore dice che cosa è successo, che cosa ha fatto Febe e che cosa deve fare Alberto. Non si scusa e non resta vago.
- Gli orari futuri del motore sono sempre «verso le».
- I numeri usano il punto per le migliaia e la virgola per i decimali.
### 10.5 Requisiti di base
Fuoco da tastiera sempre visibile; contrasto del testo almeno 4,5 a 1 in entrambi i temi (i token dell'appendice B lo rispettano su tutti gli sfondi); nessuna informazione affidata al solo colore; rispetto dell'impostazione di sistema per le animazioni ridotte; tema chiaro, scuro o come il sistema. Le uniche animazioni sono quelle che rispondono a un gesto (apertura di un dialogo, comparsa di una riga).
### 10.6 Modalità dimostrativa
Con `--demo` il programma parte senza browser e senza rete, in ascolto solo su `127.0.0.1` e senza password, con una libreria temporanea di account `.demo`, immagini generate e uno stato del motore finto. Non deve poter scrivere nella libreria vera.
- Lo stato si sceglie dall'indirizzo: `?scena=normale`, `sessione`, `fermo`, `scollegato`, `alvolante` (Alberto usa il browser); il tema con `?tema=chiaro` o `scuro`. Ci sono indirizzi che aprono direttamente il dialogo «Aggiungi account» e il passo 3 dell'importazione.
- La ricerca dei profili del dialogo risponde con dati finti, senza browser: account e profili seguiti dimostrativi il cui nome contiene il testo, più qualche nome inventato, con foto disegnate che arrivano un attimo dopo. Con `fermo`, `scollegato` e `alvolante` dice perché non cerca.
- I dati dimostrativi devono essere coerenti fra loro (i conteggi tornano, gli orari sono plausibili). Non serve che ricalchino i numeri dei mockup.
### 10.7 Come si verifica una schermata
Avvia con `--demo`, fai uno screenshot nelle condizioni della tabella e confrontalo con il mockup; elenca le differenze di disposizione, misure, colori e testi; correggi; ripeti finché restano solo differenze di contenuto.
| Mockup | Finestra in pixel CSS | Tema e scena |
|---|---|---|
| 01, 02, 03, 08 | 1440 × 900 | chiaro, normale |
| 04 | 1440 × 900 | chiaro, dialogo aperto con «gaia» scritto e l'elenco dei suggerimenti aperto |
| 05 | 1440 × 1000 | chiaro, normale |
| 06 | 1440 × 900 | chiaro, sessione |
| 07 | 1440 × 1470 | chiaro, normale |
| 09 | 1440 × 900 | chiaro, passo 3 |
| 10 | 1440 × 900 | chiaro, scollegato |
| 11 | 1440 × 900 | scuro, fermo |
| 12 | 1440 × 900 | scuro, normale |
| 14 | 860 × 900 e 390 × 844 | chiaro, normale e sessione |
Le immagini sono in scala 1,25 (1800 pixel di larghezza). Se non hai uno strumento per il browser, su Windows basta Edge da riga di comando, con un profilo temporaneo suo. Per esempio, adattando il percorso:
```text
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --headless --user-data-dir=%TEMP%\febe-schermate
--window-size=1440,900 --force-device-scale-factor=1.25 --virtual-time-budget=5000
--screenshot=uscita.png "http://127.0.0.1:8480/attivita?scena=sessione"
```
Il divieto di modalità headless della regola 2 riguarda il browser che visita Instagram, non questi screenshot dell'interfaccia.
---
## 11. Docker e Unraid
- **Immagine.** Base Debian stabile in versione ridotta. Su Ubuntu il pacchetto Chromium è uno snap e nei contenitori non funziona. Febe si pubblica autosufficiente per `linux-x64`, quindi nell'immagine non serve il runtime .NET. Pacchetti: `chromium`, `chromium-l10n` (le lingue del browser sono a parte), `xvfb`, `ffmpeg`, la libreria ICU, caratteri di sistema compresi quelli per le emoji, certificati, `tzdata`, `locales` con la lingua italiana generata.
- **Processi.** `Febe.Server` è il processo principale: avvia Xvfb, poi Chromium, e li riavvia se cadono. Niente script di shell che facciano da supervisore.
- **Utente.** Non root, con `PUID` e `PGID` configurabili (su Unraid 99 e 100).
- **Avvio di Chromium.** Come un browser normale, con finestra, sul display virtuale, con: porta di debug fissa su `127.0.0.1` (§6.1), cartella del profilo, nessuna procedura di primo avvio, dimensione della finestra, archivio delle password di base, uso di `/tmp` al posto della memoria condivisa. La lingua viene da `LANG`. Mai `--headless`, `--enable-automation`, opzioni che cambiano lo user agent o che intervengono su ciò che il browser dichiara.
- **Password del browser.** Un file di criteri nell'immagine disattiva il salvataggio delle password e la compilazione automatica di Chromium: con l'archivio di base finirebbero in chiaro nel profilo.
- **Sandbox.** Esito di S5. Se la sandbox di Chromium non parte con le impostazioni normali di Docker, le alternative sono un profilo seccomp dedicato oppure `--no-sandbox`. La seconda si accetta solo perché quel browser visita esclusivamente Instagram, e va scritta nella guida come compromesso.
- **Porte.** Si pubblica solo la porta dell'interfaccia. La porta di debug del browser non esce mai dal contenitore.
| Volume | Uso |
|---|---|
| `/dati` | Database, profilo del browser, miniature, copie. Su un disco locale del server |
| `/libreria` | Foto e video |
| `/importa` | Sorgenti da importare, in sola lettura |
| Variabile | Significato | Predefinito |
|---|---|---|
| `FEBE_PASSWORD` | Password dell'interfaccia. Obbligatoria | nessuno |
| `FEBE_PORTA` | Porta dell'interfaccia | 8480 |
| `TZ` | Fuso orario | Europe/Rome |
| `LANG` | Lingua del contenitore e del browser | it_IT.UTF-8 |
| `PUID`, `PGID` | Utente e gruppo dei file | 99, 100 |
- Se `FEBE_PASSWORD` manca, o `/dati` non è scrivibile o è una condivisione di rete, il motore non parte e l'interfaccia mostra una sola pagina che spiega che cosa non va e come rimediare. Vale dal primo contenitore che costruisci, compreso quello di prova di M0: la vista remota non deve mai essere raggiungibile senza password.
- **Accesso a Instagram.** Solo dalla pagina Collegamento, con la vista remota: i fotogrammi del browser arrivano all'interfaccia e i gesti di Alberto tornano al browser. Ciò che scrive, password compresa, attraversa la rete di casa e la memoria del server senza essere registrato: la pagina lo dice (mockup 10). Per questo l'interfaccia non va mai esposta su Internet senza una VPN o un proxy con HTTPS: scrivilo nella guida.
- **Consegna.** `docker/Dockerfile`, `docker/compose.yml` di esempio, modello per Unraid `docker/unraid/febe.xml` con icona, punto di controllo `/salute`.
---
## 12. Windows
- Applicazione WPF su .NET 10, una sola istanza alla volta, icona nell'area di notifica.
- La finestra principale è un WebView2 che mostra l'interfaccia servita in locale su `127.0.0.1`, porta scelta all'avvio.
- Il browser di Instagram è un secondo WebView2, con una sua cartella dati, in una finestra separata «Browser di Febe». Alberto la apre da Collegamento e da Attività; quando non serve resta fuori vista ma attiva (S2). Salvataggio delle password e compilazione automatica sono disattivati nelle impostazioni del controllo.
- Funzioni native offerte all'interfaccia: scelta di una cartella, «Mostra nella cartella», apertura di un indirizzo nel browser predefinito, notifiche di Windows, avvio con il sistema.
- Chiudendo la finestra Febe resta nell'area di notifica e continua a lavorare; dal menu dell'icona: apri, metti in pausa, esci.
- Cartelle predefinite: dati in `%LOCALAPPDATA%\Febe`, libreria in `Immagini\Febe`.
- **Verificato**: il runtime WebView2 è già presente in Windows 11 e in quasi tutti i Windows 10. Se manca, Febe lo dice con il collegamento per installarlo.
- Pubblicazione autosufficiente in un unico eseguibile; programma di installazione secondo la domanda 6 di §16.
---
## 13. Sicurezza, riservatezza, avvisi
### 13.1 Accesso all'interfaccia
- **Docker**: password obbligatoria; sessione con un cookie non leggibile dagli script e limitato allo stesso sito (`HttpOnly`, `SameSite=Strict`); blocco dopo tentativi ripetuti. Su ogni richiesta che modifica qualcosa, e all'apertura di WebSocket ed eventi dal server, si controlla che l'intestazione `Origin` sia quella dell'interfaccia. Un'altra pagina aperta nel browser di Alberto non deve poter comandare Febe né la vista remota.
- **Windows**: il server ascolta solo su `127.0.0.1` e accetta richieste solo con un gettone generato a ogni avvio, che la finestra conosce. Si controllano anche `Host` e `Origin`.
### 13.2 Dati riservati
- La sessione di Instagram vive nel profilo del browser dentro la cartella dei dati: Febe non la esporta, non la mostra e non la copia altrove.
- Password e codici non entrano mai nei registri. Nella vista remota i tasti vanno al browser e non si conservano.
- I registri contengono azioni ed esiti, non contenuti: nomi utente sì, didascalie e corpi delle risposte no. Il client CDP registra solo nomi di comandi (§6.1). Il rapporto di diagnostica (§7.9) è più severo dei registri: nemmeno i nomi utente, né indirizzi interi, solo forme, conteggi e codici di elenchi chiusi, perché è fatto per uscire dalla macchina di Alberto. Per le richieste verso Telegram e verso il CDN non si registrano gli indirizzi: contengono il gettone del bot e le firme dei file.
- I campioni grezzi della sonda stanno fuori dal repository e si cancellano a fine M0 (§14.5).
### 13.3 Avvisi
Eventi che meritano un avviso: verifica richiesta, disconnessione, fermo per rallentamento e ripresa, storico di un account completato, disco quasi pieno, formato non riconosciuto. Canali: striscia nell'interfaccia sempre; notifica di Windows nella versione desktop; Telegram se Alberto inserisce gettone del bot e identificativo della chat nelle impostazioni. Per Telegram basta una chiamata HTTPS con `HttpClient`: nessuna libreria.
---
## 14. Prove e verifiche
### 14.1 Prove automatiche
- **Lettori**: ogni lettore sui campioni ripuliti, compresi i casi di post con più file, video, profilo privato, risposta vuota, forma sconosciuta.
- **Motore**, con orologio virtuale e seme fisso: non supera mai un tetto; non agisce mai fuori fascia, salvo il comando manuale confermato di §7.8; rispetta sempre la pausa minima; un riavvio non azzera i conteggi; gli intervalli fra gli inizi delle sessioni non sono regolari (coefficiente di variazione almeno 0,35).
- **Interruttore**: ogni segnale porta allo stato giusto; dopo una verifica non parte nulla finché non arriva la ripresa manuale.
- **Libreria**: nomi ripuliti, percorsi lunghi, scrittura con nome temporaneo, eliminazione che non torna, ricostruzione del database dai file.
- **Doppioni**: immagini di prova generate e le loro varianti ridimensionate, ricompresse e ritagliate.
- **Importazione**: interruzione e ripresa; «Sposta» non elimina mai un originale non verificato.
- **Ripulitura dei campioni**: nessun valore dei campioni grezzi sopravvive in quelli ripuliti (§14.5).
### 14.2 Sito di prova
`tools/Febe.SitoDiProva` è un piccolo sito locale che espone gli stessi dati dei campioni attraverso pagine spoglie: una griglia che carica altre pagine scorrendo, un visualizzatore, un elenco, e i casi di arresto (stato 429, rinvio a una pagina di verifica, uscita dalla sessione). Non ha marchi né grafica di Instagram e non ha pagine di accesso: non deve somigliargli, deve solo far girare ricette, cattura e motore con un browser vero senza toccare Instagram. Ha la sua mappa dei bersagli (`bersagli.prova.json`): le ricette sono le stesse, cambia solo dove trovano le cose. Tutte le prove d'insieme passano da qui.
### 14.3 Simulazione
`--simula 30g --profilo prudente` fa girare il motore con l'orologio virtuale contro un mondo finto e produce un resoconto, anche in CSV.
- Il mondo: 40 account, 25 seguiti e 15 no, con frequenze di pubblicazione diverse (in media un post ogni tre giorni; storie quotidiane per metà degli account); un account con uno storico di 2.000 post; qualche rallentamento inserito a caso. Per la simulazione si può usare un `IBrowserHost` finto che risponde con i dati dei campioni, senza avviare un browser.
- Il resoconto: sessioni al giorno; azioni per categoria al giorno e nell'ora peggiore; tempo medio e massimo tra la pubblicazione di un contenuto e la sua scoperta; giorni necessari per lo storico di 2.000 post; numero di superamenti dei tetti, che deve essere zero.
È il modo in cui Alberto giudica un profilo prima di usarlo, e il controllo principale della tappa M3.
### 14.4 Prove dal vivo
Le esegue solo Alberto, con l'account di prova, seguendo un elenco di passi che gli prepari tappa per tappa in `docs/prove-dal-vivo.md`. Ogni elenco dice che cosa fare, che cosa aspettarsi e che cosa riferirti. Prima della fine di M3 il programma non compie alcun gesto su Instagram: nella sonda di M0 naviga Alberto. Il passaggio all'account principale lo decide lui, non prima della fine di M3, e sempre con il profilo Prudente.
### 14.5 Sonda e campioni
- **La sonda è passiva.** Avvia il browser, Alberto accede e naviga a mano seguendo un elenco di cose da aprire (la home, un profilo pubblico, uno privato che segue, una storia, una raccolta, la scheda taggati, l'elenco dei seguiti), e la sonda registra ciò che la pagina riceve. Registra anche, per gli elementi che Alberto clicca, gli attributi utili alla mappa dei bersagli. Non compie gesti.
- **I campioni grezzi stanno fuori dal repository**, in una cartella che Alberto sceglie, e si cancellano a fine M0. Tu non li apri: contengono nomi, testi, indirizzi firmati e dati dell'account di Alberto e di altre persone.
- **La ripulitura lavora per elenco di ciò che è ammesso**, non di ciò che è vietato. Conserva struttura e chiavi. Sostituisce ogni stringa e ogni numero lungo con un valore finto della stessa forma, tranne i campi di un breve elenco che non dicono nulla di una persona (dimensioni, durate, conteggi, valori vero o falso, codici di tipo, date). Sostituisce anche le chiavi che hanno l'aspetto di un identificativo. Degli indirizzi tiene solo la distinzione fra sito e CDN e l'estensione del file.
- Una prova automatica confronta grezzi e ripuliti, sulla macchina di Alberto, e fallisce se una stringa di quattro o più caratteri sopravvive fuori dall'elenco ammesso.
- In `tests/campioni/` e in `docs/sonda/esito.md` entrano solo campioni ripuliti e descrizioni di forma.
- **Forma delle richieste** (per la regola 2, eccezione). `febe-sonda richieste --har <file> --a <file .json>` descrive le richieste che la pagina fa al sito: metodo, percorso con ogni parte che non è una parola fissa del sito sostituita da `{numero}` o `{testo}`, nomi dei parametri, delle intestazioni e dei campi del corpo, struttura delle variabili GraphQL. Dei valori scrive solo il tipo («numero», «testo», «vuoto»), tranne quelli di un elenco chiuso uguali per tutti (identificativo dell'applicazione, nomi e identificativi delle operazioni, grandezza delle pagine, vero/falso): mai cookie, gettoni, nomi, identificativi o cursori. Dei nomi tiene quelli di un elenco chiuso e quelli che hanno la forma di un nome del codice (senza punto, senza tre cifre di fila) e non compaiono da nessuna parte nel HAR come valore; gli altri diventano «(nome tolto)». Alberto lo legge e lo invia; da lì si scrive `richieste.<sito>.json`.
---
## 15. Tappe
Ogni tappa finisce con i controlli «Fatto quando» eseguiti e mostrati, `docs/stato.md` aggiornato e un commit. Dove c'è un arresto, fermati e aspetta Alberto.
| Tappa | Contenuto | Leggi | Fatto quando |
|---|---|---|---|
| **M0 Sonda** | Struttura del repository, `CLAUDE.md`, client CDP, `ChromiumProcessHost`, sonda passiva con ripulitura, sito di prova minimo. Prove usa e getta: una finestra WPF con un WebView2 (S1, S2, S6); un contenitore con Chromium, Xvfb, password e vista remota minima (S3, S4, S5, S6) | §2, §5, §6, §7.6, §11, §12, §13, §14.2, §14.5 | `docs/sonda/esito.md` riporta un esito con prove per ogni voce di §6.6; campioni ripuliti presenti e prova della ripulitura verde; prima mappa dei bersagli; decisioni scritte. **Arresto**: se H1–H4 non reggono, si rivede §6.3 con Alberto prima di proseguire |
| **M1 Dati e libreria** | Schema e migrazioni, modello, percorsi e nomi, hash, impronte, miniature, `_febe.jsonl`, copie, eliminazione, ricostruzione | §4.3, §4.6, §4.7, §8 | Prove di libreria e doppioni verdi; ricostruzione del database riuscita su una libreria di prova |
| **M2 Raccolta** | Lettori, cattura, gesti, ricette, mappa dei bersagli, scaricamento, sito di prova completo. Nessuna prova dal vivo | §2, §4.2, §4.3, §6, §7.7, §14.1, §14.2 | Prove dei lettori verdi; ogni ricetta verde contro il sito di prova, casi di arresto compresi |
| **M3 Motore** | Pianificazione, sessioni, Governatore, interruttore, avvio graduale, simulazione. Poi la prima prova dal vivo | §4.4, §4.5, §7, §14.1, §14.3, §14.4 | Prove del motore verdi; simulazione di 30 giorni per i tre profili senza superamenti. **Arresto**: Alberto legge i numeri. Poi, dal vivo: una sessione con l'account di prova e il profilo Prudente su un profilo pubblico, con i file arrivati in libreria |
| **M4 Interfaccia** | API, eventi, ossatura, tutte le schermate, tema scuro, finestra stretta, modalità dimostrativa | §4, §7.5, §7.9, §9.1, §10, §13.1, mockup 01–14 | Ogni schermata confrontata con il suo mockup secondo §10.7, con l'elenco delle differenze rimaste |
| **M5 Docker** | Immagine, Xvfb, vista remota, password, pagina di errore, modello Unraid | §4.1, §6.1, §11, §13 | Il contenitore parte su Unraid; Alberto accede dalla vista remota; un riavvio conserva la sessione |
| **M6 Windows** | Finestra, `WebView2Host`, area di notifica, funzioni native, installazione | §4.1, §6.1, §6.6, §12, §13 | Installazione su un Windows pulito; accesso, raccolta con la finestra del browser fuori vista, chiusura nell'area di notifica |
| **M7 Importazione** | I quattro passi, riconoscitori, revisione dei doppioni, copia verificata | §8.3, §9, mockup 09 | Prove di importazione verdi; una cartella vera di Alberto importata senza doppioni e senza toccare gli originali |
| **M8 Rifiniture** | Avvisi e Telegram, esportazione CSV, guida per l'uso, pagina sui problemi comuni | §4.8, §13.3, elenco qui sotto | Guida completa; un arresto simulato produce striscia, notifica e messaggio |
| **M9 Facoltative** | Desktop collegato a un Febe remoto; seconda lingua | §5 | Da definire con Alberto |
`docs/stato.md` è il filo fra le sessioni: che cosa è fatto, che cosa è in corso, che cosa è stato rimandato e perché. `docs/decisioni.md` raccoglie ogni scelta tecnica presa strada facendo, con data e motivo.
**Che cosa la guida deve dire per forza:**
- il rischio per l'account e le condizioni d'uso di Instagram; che cosa fa Febe per ridurlo e che cosa non fa;
- che le storie aperte da Febe risultano viste;
- che contenitore e desktop non vanno usati insieme sullo stesso account;
- che chi ha la cartella dei dati, o una sua copia, ha la sessione di Instagram;
- che l'interfaccia Docker non va esposta su Internet, e che in Docker la password di Instagram passa dal server;
- l'eventuale compromesso sulla sandbox di Chromium;
- che cosa fare dopo una verifica o un rallentamento;
- dove sono le copie del database e come si ricostruisce.
---
## 16. Domande aperte per Alberto
Falle quando arrivi al punto indicato, una per volta, proponendo la risposta della terza colonna. Non fermarti per dubbi che puoi risolvere da solo.
| | Domanda | Quando | Proposta |
|---|---|---|---|
| 1 | Dove sta il repository e chi compila l'immagine: Gitea di casa o GitHub? | M0 | Solo git locale finché non decide |
| 2 | Quale account di prova si usa per la sonda e per le prove dal vivo? | M0 | Obbligatorio prima di qualunque prova |
| 3 | La richiesta diceva «un percorso generale per le immagini e un percorso generale…» e si interrompeva. Vanno bene Libreria e Dati? | M1 | Sì; in alternativa una cartella separata per i video |
| 4 | Com'è fatta la libreria di 4K Stogram da importare? | M1, per usarla in M7 | Una ventina di righe dell'elenco dei file, con i nomi degli account sostituiti |
| 5 | Va bene che Febe apra le storie e che quindi Alberto risulti tra gli spettatori, per tutti gli account? | M2 | Sì, con l'interruttore «Storie» per escludere chi vuole |
| 6 | Su Windows serve un programma di installazione o basta una cartella da copiare? | M6 | Programma di installazione |
| 7 | Avvisi su Telegram? | M8 | Sì, facoltativi |
| 8 | Il nome «Febe» resta? | Prima di M0 | — |
| 9 | Solo italiano, o anche inglese? | M4 | Solo italiano, testi già separati |
| 10 | Su Unraid: porta, cartella della libreria, disco per i dati | M5 | Porta 8480, dati nella cartella delle applicazioni sul disco di cache |
| 11 | Con la pagina che chiede i dati, le storie si chiedono con una richiesta (non risultano viste) o si continuano ad aprire nel visualizzatore (Alberto tra gli spettatori, come oggi)? | #36, sui campioni del nuovo HAR | Restare al visualizzatore, che è la scelta di §3; la richiesta solo se il visualizzatore non si può guidare in modo affidabile |
---
## Appendice A — Contenuto di `CLAUDE.md`
Copialo così com'è nella radice del repository. Deve restare corto: le regole complete sono in questa specifica.
~~~markdown
# Febe
Archivio personale di foto, video e storie da Instagram, in due vesti: Docker e Windows.
La specifica è docs/SPECIFICA.md. Non rileggerla tutta ogni volta: apri la sezione che riguarda il lavoro in corso.
All'inizio di ogni sessione leggi docs/stato.md.
## Comandi
- Compilare: `dotnet build -warnaserror`
- Prove: `dotnet test` (una sola: `dotnet test --filter "FullyQualifiedName~Nome"`)
- Avviare in modalità dimostrativa: `dotnet run --project src/Febe.Server -- --demo`
- Simulare il motore: `dotnet run --project src/Febe.Server -- --simula 30g --profilo prudente`
- Immagine Docker: `docker build -f docker/Dockerfile -t febe .`
## Regole che non si discutono (specifica §2)
1. IMPORTANTE: non contattare mai Instagram da prove, script o verifiche tue. Si usa solo tools/Febe.SitoDiProva. Le prove dal vivo le lancia Alberto.
2. Non aprire i campioni grezzi della sonda: stanno fuori dal repository e contengono dati di altre persone. Si lavora sulle copie ripulite di tests/campioni.
3. Verso Instagram parla solo il browser di Febe. Nessun HttpClient verso domini di Instagram o Meta, tranne il CDN alle condizioni di §6.5.
4. Il browser si usa così com'è: nessuna modifica di user agent, impronta, intestazioni; niente headless, stealth, proxy, più account. Comandi CDP solo dall'elenco di §6.1. Unica eccezione: la pagina chiede i dati agli indirizzi di `richieste.<sito>.json`, uno per volta e con il permesso del Governatore (§2 regola 2, §6.1).
5. CAPTCHA, verifiche e codici non si risolvono mai in automatico: Febe si ferma e avvisa.
6. Sola lettura (niente mi piace, segui, commenti, messaggi) e solo ciò che l'account di Alberto vede già.
7. Un account, un motore. I cookie non si copiano da una macchina all'altra.
8. Ogni azione del motore verso il sito passa da IGovernor. Al primo segnale di §7.6 ci si ferma.
9. I lettori si scrivono solo su campioni reali ripuliti. Il formato delle risposte non si inventa.
10. Mai password, cookie, tasti o corpi di risposta nei log. Il client CDP registra solo nomi di comandi.
11. La libreria non cancella e non sostituisce file da sola.
12. Dipendenze a elenco chiuso (§3): prima di aggiungerne una, chiedi.
## Convenzioni
- Codice e commenti in inglese; interfaccia, documenti e messaggi in italiano (glossario: appendice D).
- Nel motore mai DateTime.Now, Task.Delay o Random diretti: si usano IClock e IRandomSource.
- Interfaccia senza framework né build: file in src/Febe.Web/wwwroot. Token e classi di base: appendice B.
- Una schermata è finita quando è stata confrontata con il suo mockup (§10.7).
- Scelte tecniche nuove: una riga in docs/decisioni.md con data e motivo.
- A fine lavoro aggiorna docs/stato.md e mostra comandi e risultati dei controlli. Se qualcosa non è verificato, dillo.
## Quando compatti la conversazione
Conserva: tappa in corso, file modificati, controlli ancora da eseguire, domande aperte per Alberto.
~~~
---
## Appendice B — Token e CSS di partenza
È il foglio che ha generato i mockup, con una sola differenza: qui il contenuto della pagina scorre (`.corpo` ha `overflow:auto`), mentre nelle immagini è tagliato al bordo. Usalo come base di `src/Febe.Web/wwwroot/css/febe.css` e completalo; i nomi delle classi puoi tenerli. Il tema scuro si attiva con `data-tema="scuro"` sull'elemento radice.
Il carattere Archivo variabile (licenza OFL) si prende dal pacchetto npm `@fontsource-variable/archivo`, cartella `files`: servono `archivo-latin-standard-normal.woff2` e `archivo-latin-ext-standard-normal.woff2`. Copiali in `wwwroot/caratteri/` con il file della licenza: il pacchetto non diventa una dipendenza.
```css
/* Febe — token e componenti di base */
@font-face{
font-family:"Archivo";
src:url(../caratteri/archivo-latin-standard-normal.woff2) format("woff2");
font-weight:100 900; font-stretch:62% 125%; font-display:block;
}
@font-face{
font-family:"Archivo";
src:url(../caratteri/archivo-latin-ext-standard-normal.woff2) format("woff2");
font-weight:100 900; font-stretch:62% 125%; font-display:block;
unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF;
}
:root{
--fondo:#F4F4F4;
--superficie:#FFFFFF;
--rialzo:#FAFAFA;
--barra:#ECECEC;
--bordo:#E1E1E1;
--bordo-forte:#CCCCCC;
--testo:#1A1A1A;
--testo-2:#555555;
--testo-3:#6A6A6A;
--accento:#0F5C8C;
--accento-scuro:#0B4A72;
--accento-tinta:#E3EEF5;
--accento-bordo:#B5D0E2;
--su-accento:#FFFFFF;
--verde:#1E7B4F;
--verde-tinta:#E3F2EA;
--ambra:#9A5B00;
--ambra-pieno:#E0A021;
--ambra-tinta:#FBF0DA;
--rosso:#B42318;
--rosso-tinta:#FBE9E7;
--velo:rgba(20,20,20,.46);
--ombra-menu:0 10px 30px rgba(0,0,0,.16),0 1px 3px rgba(0,0,0,.10);
--ombra-dialogo:0 24px 70px rgba(0,0,0,.28),0 2px 8px rgba(0,0,0,.12);
--r-tessera:3px;
--r-controllo:7px;
--r-pannello:10px;
--r-dialogo:14px;
--tratteggio:rgba(0,0,0,.075);
}
[data-tema="scuro"]{
--fondo:#1B1B1B;
--superficie:#242424;
--rialzo:#2B2B2B;
--barra:#151515;
--bordo:#363636;
--bordo-forte:#4A4A4A;
--testo:#EDEDED;
--testo-2:#B0B0B0;
--testo-3:#959595;
--accento:#62B1E0;
--accento-scuro:#8AC6EA;
--accento-tinta:#1B3342;
--accento-bordo:#2C5068;
--su-accento:#0C2230;
--verde:#5CC08D;
--verde-tinta:#1A3326;
--ambra:#E7B04C;
--ambra-pieno:#E0A021;
--ambra-tinta:#3A2E14;
--rosso:#F0776C;
--rosso-tinta:#3F1E1B;
--velo:rgba(0,0,0,.62);
--ombra-menu:0 10px 30px rgba(0,0,0,.5),0 1px 3px rgba(0,0,0,.4);
--ombra-dialogo:0 24px 70px rgba(0,0,0,.6),0 2px 8px rgba(0,0,0,.4);
--tratteggio:rgba(255,255,255,.07);
}
*{box-sizing:border-box}
html,body{margin:0;height:100%}
body{
font-family:"Archivo",system-ui,sans-serif; font-stretch:100%;
font-size:14px; line-height:1.45; color:var(--testo); background:var(--fondo);
-webkit-font-smoothing:antialiased; text-rendering:optimizeLegibility;
}
.dati{font-stretch:88%;font-variant-numeric:tabular-nums}
.muto{color:var(--testo-2)}
.tenue{color:var(--testo-3)}
svg.ic{width:18px;height:18px;flex:none;stroke-width:1.75}
svg.ic.s{width:15px;height:15px}
svg.ic.l{width:22px;height:22px}
/* ---------- ossatura ---------- */
.app{display:grid;grid-template-columns:228px 1fr;height:100vh}
.barra{background:var(--barra);border-right:1px solid var(--bordo);display:flex;flex-direction:column;padding:16px 12px 12px;min-width:0}
.marchio{display:flex;align-items:center;gap:10px;padding:2px 8px 18px}
.marchio svg{width:26px;height:26px}
.marchio b{font-size:17px;font-weight:650;font-stretch:108%;letter-spacing:.005em}
.nav{display:flex;flex-direction:column;gap:2px}
.nav a{display:flex;align-items:center;gap:11px;height:36px;padding:0 10px;border-radius:var(--r-controllo);color:var(--testo-2);text-decoration:none;font-weight:500;border:1px solid transparent}
.nav a.qui{background:var(--superficie);border-color:var(--bordo);color:var(--testo);font-weight:600}
.nav a.qui svg{color:var(--accento)}
.nav a .conta{margin-left:auto;font-size:12px;color:var(--testo-3)}
.nav a .punto{margin-left:auto;width:8px;height:8px;border-radius:50%;background:var(--rosso)}
.nav .stacco{height:1px;background:var(--bordo);margin:10px 8px}
.barra .molla{flex:1}
.stato{border:1px solid var(--bordo);background:var(--superficie);border-radius:var(--r-pannello);padding:12px}
.stato .riga{display:flex;align-items:center;gap:8px;font-weight:600}
.stato .sotto{font-size:12.5px;color:var(--testo-2);margin:3px 0 10px 16px}
.stato .conto{display:flex;justify-content:space-between;font-size:12px;color:var(--testo-2);margin-top:6px}
.stato .chi{display:flex;align-items:center;gap:9px;margin-top:12px;padding-top:11px;border-top:1px solid var(--bordo)}
.stato .chi div{min-width:0}
.stato .chi b{display:block;font-size:13px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.stato .chi span{font-size:12px;color:var(--testo-2)}
.spia{width:8px;height:8px;border-radius:50%;flex:none;background:var(--testo-3)}
.spia.verde{background:var(--verde)} .spia.accento{background:var(--accento);box-shadow:0 0 0 4px var(--accento-tinta)}
.spia.ambra{background:var(--ambra-pieno)} .spia.rosso{background:var(--rosso);box-shadow:0 0 0 4px var(--rosso-tinta)}
.pagina{display:flex;flex-direction:column;min-width:0;height:100vh;position:relative}
.testa{display:flex;align-items:center;gap:14px;padding:20px 28px 14px;flex:none}
.testa h1{margin:0;font-size:22px;font-weight:650;font-stretch:104%;letter-spacing:-.005em;line-height:1.2}
.testa .quanti{color:var(--testo-2);font-size:13.5px;padding-top:5px}
.testa .destra{margin-left:auto;display:flex;align-items:center;gap:10px}
.corpo{flex:1;overflow:auto;padding:0 28px 24px;min-height:0}
.strumenti{display:flex;align-items:center;gap:10px;padding:0 28px 14px;flex:none}
.strumenti .destra{margin-left:auto;display:flex;align-items:center;gap:10px}
/* ---------- controlli ---------- */
.btn{display:inline-flex;align-items:center;gap:8px;height:34px;padding:0 13px;border-radius:var(--r-controllo);border:1px solid var(--bordo-forte);background:var(--superficie);color:var(--testo);font:inherit;font-weight:550;font-size:13.5px;white-space:nowrap}
.btn.primo{background:var(--accento);border-color:var(--accento);color:var(--su-accento);font-weight:600}
.btn.nudo{border-color:transparent;background:transparent;color:var(--testo-2)}
.btn.pericolo{color:var(--rosso);border-color:var(--bordo-forte)}
.btn.spento{opacity:.45}
.btn.solo{width:34px;padding:0;justify-content:center}
.btn.grande{height:40px;padding:0 18px;font-size:14px}
.campo{display:flex;align-items:center;gap:8px;height:34px;padding:0 11px;border-radius:var(--r-controllo);border:1px solid var(--bordo-forte);background:var(--superficie);color:var(--testo);min-width:0}
.campo.cerca{width:280px;color:var(--testo-3)}
.campo.errore{border-color:var(--rosso);box-shadow:0 0 0 3px var(--rosso-tinta)}
.campo.fuoco{border-color:var(--accento);box-shadow:0 0 0 3px var(--accento-tinta)}
.campo .segna{color:var(--testo-3)}
.campo .val{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
.campo svg{color:var(--testo-3)}
.campo.scelta{justify-content:space-between;font-weight:500}
.campo.sola{background:var(--rialzo);color:var(--testo-2)}
.gruppo{display:inline-flex;border:1px solid var(--bordo-forte);border-radius:var(--r-controllo);background:var(--superficie);padding:2px;gap:2px}
.gruppo span{height:28px;padding:0 12px;border-radius:5px;display:inline-flex;align-items:center;gap:6px;font-weight:500;font-size:13.5px;color:var(--testo-2);white-space:nowrap}
.gruppo span.qui{background:var(--accento-tinta);color:var(--accento-scuro);font-weight:600}
[data-tema="scuro"] .gruppo span.qui{color:var(--accento-scuro)}
.filtri{display:flex;gap:6px}
.filtri span{height:30px;padding:0 12px;border-radius:15px;display:inline-flex;align-items:center;gap:6px;font-weight:500;font-size:13.5px;color:var(--testo-2);border:1px solid var(--bordo);background:var(--superficie)}
.filtri span.qui{background:var(--testo);border-color:var(--testo);color:var(--superficie);font-weight:600}
.filtri span i{font-style:normal;font-size:12px;opacity:.7}
.int{width:36px;height:20px;border-radius:10px;background:var(--bordo-forte);position:relative;flex:none;display:inline-block}
.int::after{content:"";position:absolute;top:2px;left:2px;width:16px;height:16px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.25)}
.int.si{background:var(--accento)} .int.si::after{left:18px}
[data-tema="scuro"] .int.si::after{background:#0C2230}
.int.fermo{opacity:.4}
.spunta{width:17px;height:17px;border-radius:4px;border:1.5px solid var(--bordo-forte);background:var(--superficie);flex:none;display:inline-flex;align-items:center;justify-content:center}
.spunta.si{background:var(--accento);border-color:var(--accento);color:var(--su-accento)}
.spunta svg{width:12px;height:12px;stroke-width:3}
.tondo{width:17px;height:17px;border-radius:50%;border:1.5px solid var(--bordo-forte);background:var(--superficie);flex:none;display:inline-block;position:relative}
.tondo.si{border-color:var(--accento)} .tondo.si::after{content:"";position:absolute;inset:3px;border-radius:50%;background:var(--accento)}
.et{display:inline-flex;align-items:center;gap:4px;height:20px;padding:0 7px;border-radius:4px;font-size:11.5px;font-weight:600;background:var(--fondo);color:var(--testo-2);border:1px solid var(--bordo);white-space:nowrap}
.et svg{width:11px;height:11px;stroke-width:2.2}
.et.accento{background:var(--accento-tinta);color:var(--accento-scuro);border-color:var(--accento-bordo)}
.et.verde{background:var(--verde-tinta);color:var(--verde);border-color:transparent}
.et.ambra{background:var(--ambra-tinta);color:var(--ambra);border-color:transparent}
.et.rosso{background:var(--rosso-tinta);color:var(--rosso);border-color:transparent}
.misura{height:6px;border-radius:3px;background:var(--bordo);overflow:hidden;position:relative}
.misura i{position:absolute;inset:0 auto 0 0;border-radius:3px;background:var(--accento)}
.misura.ambra i{background:var(--ambra-pieno)} .misura.rosso i{background:var(--rosso)} .misura.grigio i{background:var(--testo-3)}
.misura.fine{height:4px}
/* ---------- avatar ---------- */
.av{width:32px;height:32px;border-radius:50%;flex:none;display:inline-flex;align-items:center;justify-content:center;font-weight:650;font-size:12px;color:#fff;font-stretch:92%;letter-spacing:.02em;overflow:hidden}
.av.p{width:24px;height:24px;font-size:10px} .av.g{width:56px;height:56px;font-size:19px} .av.m{width:40px;height:40px;font-size:14px}
/* ---------- pannelli e tabelle ---------- */
.pannello{background:var(--superficie);border:1px solid var(--bordo);border-radius:var(--r-pannello)}
.tab{width:100%;border-collapse:collapse}
.tab th{font-size:12.5px;font-weight:550;color:var(--testo-2);text-align:left;padding:10px 14px;border-bottom:1px solid var(--bordo);white-space:nowrap}
.tab td{padding:11px 14px;border-bottom:1px solid var(--bordo);vertical-align:middle}
.tab tr:last-child td{border-bottom:0}
.tab tr.sopra td{background:var(--rialzo)}
.tab tr.scelto td{background:var(--accento-tinta)}
.linguette{display:flex;gap:22px;border-bottom:1px solid var(--bordo);padding:0 28px;flex:none}
.linguette span{padding:10px 0 11px;font-weight:500;color:var(--testo-2);border-bottom:2px solid transparent;margin-bottom:-1px;display:flex;gap:7px;align-items:baseline}
.linguette span.qui{color:var(--testo);font-weight:650;border-bottom-color:var(--accento)}
.linguette span i{font-style:normal;font-size:12px;color:var(--testo-3)}
/* ---------- tessere (foto) ---------- */
.tess{position:relative;border-radius:var(--r-tessera);overflow:hidden;background:var(--bordo);flex:none}
.tess svg.foto{display:block;width:100%;height:100%}
.tess .segno{position:absolute;top:6px;right:6px;display:flex;gap:4px}
.tess .segno span{display:inline-flex;align-items:center;gap:3px;height:19px;padding:0 6px;border-radius:4px;background:rgba(0,0,0,.58);color:#fff;font-size:11px;font-weight:600;font-stretch:88%}
.tess .segno svg{width:11px;height:11px;stroke-width:2.4}
.tess.sopra::after{content:"";position:absolute;inset:0;background:linear-gradient(180deg,rgba(0,0,0,.42) 0,rgba(0,0,0,0) 34%,rgba(0,0,0,0) 54%,rgba(0,0,0,.62) 100%)}
.tess .chi{position:absolute;left:8px;bottom:7px;right:8px;z-index:2;display:flex;align-items:center;gap:7px;color:#fff;font-size:12.5px;font-weight:600}
.tess .chi span:not(.av){white-space:nowrap;overflow:hidden;text-overflow:ellipsis;min-width:0}
.tess .chi small{flex:none;font-weight:400;opacity:.85;margin-left:auto;font-size:11.5px}
.tess .sel{position:absolute;left:7px;top:7px;z-index:2;width:20px;height:20px;border-radius:50%;border:2px solid #fff;background:rgba(0,0,0,.2);display:flex;align-items:center;justify-content:center;color:#fff}
.tess.scelta{outline:3px solid var(--accento);outline-offset:-3px}
.tess.scelta .sel{background:var(--accento);border-color:var(--accento)}
.tess .sel svg{width:12px;height:12px;stroke-width:3.2}
.giorno{display:flex;align-items:baseline;gap:10px;margin:18px 0 8px}
.giorno:first-child{margin-top:2px}
.giorno b{font-size:15px;font-weight:650}
.giorno span{color:var(--testo-2);font-size:13px}
.fila{display:flex;gap:4px;margin-bottom:4px}
/* ---------- striscia della giornata ---------- */
.striscia{position:relative;height:44px;border-radius:6px;background:var(--fondo);border:1px solid var(--bordo);overflow:hidden}
.striscia .notte{position:absolute;top:0;bottom:0;background:repeating-linear-gradient(135deg,var(--tratteggio) 0 2px,transparent 2px 7px)}
.striscia .sess{position:absolute;top:7px;bottom:7px;border-radius:2px;background:var(--accento);min-width:3px}
.striscia .sess.ora{box-shadow:0 0 0 3px var(--accento-tinta)}
.striscia .sess.prev{background:transparent;border:1.5px dashed var(--accento);opacity:.75}
.striscia .freno{position:absolute;top:7px;bottom:7px;border-radius:2px;background:var(--ambra-pieno)}
.striscia .fermo{position:absolute;top:0;bottom:0;background:repeating-linear-gradient(135deg,var(--rosso-tinta) 0 6px,transparent 6px 12px);border-left:2px solid var(--rosso)}
.striscia .adesso{position:absolute;top:0;bottom:0;width:2px;background:var(--testo)}
.striscia .tacca{position:absolute;top:0;bottom:0;width:1px;background:var(--bordo)}
.ore{position:relative;height:18px;margin-top:5px;font-size:11.5px;color:var(--testo-3)}
.ore span{position:absolute;transform:translateX(-50%)}
.ore span:first-child{transform:none} .ore span:last-child{transform:translateX(-100%)}
.legenda{display:flex;gap:18px;font-size:12.5px;color:var(--testo-2);align-items:center}
.legenda span{display:inline-flex;align-items:center;gap:7px}
.legenda i{width:14px;height:10px;border-radius:2px;display:inline-block}
/* ---------- avvisi, dialoghi ---------- */
.avviso{display:flex;gap:11px;align-items:flex-start;padding:11px 13px;border-radius:var(--r-controllo);font-size:13.5px;background:var(--accento-tinta);color:var(--testo)}
.avviso svg{color:var(--accento);margin-top:1px}
.avviso.ambra{background:var(--ambra-tinta)} .avviso.ambra svg{color:var(--ambra)}
.avviso.rosso{background:var(--rosso-tinta)} .avviso.rosso svg{color:var(--rosso)}
.avviso b{font-weight:650}
.velo{position:absolute;inset:0;background:var(--velo);z-index:20;display:flex;align-items:center;justify-content:center}
.dialogo{background:var(--superficie);border-radius:var(--r-dialogo);box-shadow:var(--ombra-dialogo);display:flex;flex-direction:column;overflow:hidden;border:1px solid var(--bordo)}
.dialogo header{display:flex;align-items:center;padding:18px 22px 6px}
.dialogo header h2{margin:0;font-size:18px;font-weight:650}
.dialogo footer{display:flex;align-items:center;gap:10px;padding:14px 22px;border-top:1px solid var(--bordo);background:var(--rialzo)}
.dialogo footer .destra{margin-left:auto;display:flex;gap:10px}
h2.sez{font-size:15px;font-weight:650;margin:0 0 3px}
p.aiuto{margin:0;color:var(--testo-2);font-size:13px}
.etichetta{font-size:13px;font-weight:550;margin-bottom:6px;display:block}
.voce{display:flex;align-items:center;gap:10px}
.sezione{padding:20px 0;border-bottom:1px solid var(--bordo)}
.sezione:first-child{padding-top:4px}
.sezione:last-child{border-bottom:0}
/* ---------- impostazioni: sotto-menu ---------- */
.imp{display:grid;grid-template-columns:238px 1fr;gap:28px;height:100%}
.imp nav{display:flex;flex-direction:column;gap:2px;padding-top:4px}
.imp nav span{white-space:nowrap;display:flex;align-items:center;gap:10px;height:34px;padding:0 10px;border-radius:var(--r-controllo);color:var(--testo-2);font-weight:500}
.imp nav span.qui{background:var(--superficie);border:1px solid var(--bordo);color:var(--testo);font-weight:600}
.imp .cont{max-width:820px;min-width:0}
/* ---------- finestra stretta e telefono ---------- */
@media (max-width:1000px){
.app{grid-template-columns:64px 1fr}
.barra{padding:14px 10px;align-items:center}
.marchio{padding:2px 0 16px} .marchio b{display:none}
.nav{width:100%} .nav a{justify-content:center;padding:0} .nav a span,.nav a .conta{display:none}
.stato{padding:10px 0;width:44px;display:flex;flex-direction:column;align-items:center;gap:10px}
.stato .riga span:not(.spia),.stato .sotto,.stato .conto,.stato .misura,.stato .chi div{display:none}
.stato .chi{margin:0;padding:0;border:0}
.testa,.strumenti{padding-left:20px;padding-right:20px} .corpo{padding:0 20px 20px}
.campo.cerca{width:200px}
}
@media (max-width:560px){
.app{grid-template-columns:1fr;grid-template-rows:1fr 58px}
.barra{order:2;flex-direction:row;border-right:0;border-top:1px solid var(--bordo);padding:0 6px;align-items:stretch}
.marchio,.barra .molla,.stato,.nav .stacco{display:none}
.nav{flex-direction:row;justify-content:space-around;align-items:center;width:100%}
.nav a{flex-direction:column;gap:3px;height:48px;width:68px;font-size:10.5px;border:0;background:transparent!important}
.nav a span{display:block}
.pagina{height:auto;min-height:0;overflow:hidden}
.testa{padding:16px 16px 10px} .testa h1{font-size:20px} .corpo{padding:0 16px 16px} .strumenti{padding:0 16px 12px}
}
```
---
## Appendice C — Marchio e icone
Marchio: quadrato arrotondato nel colore d'accento con un anello e un punto, cioè un corpo e la sua luna. Da questo SVG si ricavano l'icona dell'applicazione, quella dell'area di notifica e quella del modello Unraid.
```html
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
<rect width="32" height="32" rx="8" fill="#0F5C8C"/>
<circle cx="14.5" cy="17.5" r="7.4" fill="none" stroke="#FFFFFF" stroke-width="2.6"/>
<circle cx="23.2" cy="8.8" r="3.1" fill="#FFFFFF"/>
</svg>
```
Icone: Lucide (licenza ISC), dal pacchetto npm `lucide-static`, cartella `icons`. Copia nel repository solo quelle usate e inseriscile come SVG in linea, con tratto 1,75. Elenco di partenza:
| Uso | Icone |
|---|---|
| Navigazione | `layout-grid`, `users`, `activity`, `folder-input`, `settings` |
| Tipi di contenuto | `image`, `clapperboard`, `circle-dashed`, `star`, `square-user`, `circle-user`, `layers`, `play` |
| Stato e avvisi | `lock`, `user-check`, `user`, `info`, `triangle-alert`, `octagon-alert`, `shield-check`, `shield-alert`, `hourglass`, `gauge`, `clock`, `history` |
| Azioni | `plus`, `search`, `x`, `check`, `circle-check`, `refresh-cw`, `rotate-ccw`, `rotate-cw`, `pause`, `external-link`, `folder-open`, `folder`, `app-window`, `trash-2`, `archive`, `file-down`, `list-filter`, `ellipsis`, `zoom-in`, `maximize`, `grid-3x3`, `square` |
| Frecce | `arrow-left`, `chevron-left`, `chevron-right`, `chevron-down` |
| Impostazioni | `sliders-horizontal`, `key-round`, `bell`, `database`, `sun`, `moon`, `monitor`, `hard-drive` |
---
## Appendice D — Glossario
| Nell'interfaccia | Nel codice | Significato |
|---|---|---|
| Libreria | `Library` | L'insieme dei file salvati e il loro indice |
| Elemento | `Entry` | Una pubblicazione: un post, una storia, un contenuto in evidenza |
| File | `Media` | Una singola foto o un singolo video di un elemento |
| Storia | `Story` | Elemento che dura 24 ore |
| Raccolta in evidenza | `Highlight` | Gruppo di storie fissato nel profilo |
| Taggati | `Tagged` | Post di altri in cui l'account compare |
| Storico | `Backfill` | Scaricamento dei contenuti passati |
| Tieni aggiornato | `KeepUpdated` | Controllo ricorrente dei contenuti nuovi |
| Solo archivio | `ArchiveOnly` | Account presente in libreria e mai contattato |
| Giro dei profili che segui (nel testo: Giro dei seguiti) | `FollowingSweep` | Lettura di home e barra delle storie |
| Sessione | `Session` | Un periodo breve di attività del motore |
| Fascia oraria | `ActiveWindow` | Le ore del giorno in cui Febe lavora |
| Tetto | `Budget` | Massimo di azioni per ora o per giorno |
| Governatore | `Governor` | Chi concede o nega ogni azione |
| Interruttore | `CircuitBreaker` | Chi ferma tutto ai segnali di arresto |
| Rallentamento | `Throttle` | Segnale lieve: fermo a tempo |
| Verifica | `Challenge` | Segnale grave: fermo fino all'intervento di Alberto |
| Profilo di prudenza | `CautionProfile` | Prudente, Equilibrato, Rapido, Su misura |
| Ricetta | `Recipe` | Sequenza di gesti con uno scopo |
| Mappa dei bersagli | `TargetMap` | Come una ricetta trova nella pagina ciò su cui agire |
| Lettore | `Reader` | Chi trasforma una risposta in elementi |
| Sonda | `Probe` | Strumento passivo di M0 che registra ciò che la pagina riceve |
| Impronta visiva | `PerceptualHash` | Numero che riconosce la stessa immagine in file diversi |
| Vista remota | `RemoteView` | Il browser del server mostrato nell'interfaccia |
---
## Appendice E — Fonti e prove del 13 ottobre 2026
Fonti:
- 4K Stogram, pagina del prodotto (versione 4.9.0.4680 del 18 maggio 2024, elenco delle funzioni): https://www.4kdownload.com/products/stogram-8
- 4K Stogram, perché è stato interrotto: https://www.4kdownload.com/faq/faq-why-is-stogram-discontinued
- 4K Stogram, file di database nella cartella di uscita: https://www.4kdownload.com/faq/faq-howto-transfer-stogram-database-to-another-pc
- Condizioni d'uso di Instagram sulla raccolta automatica, nota di Open Terms Archive: https://opentermsarchive.org/en/memos/instagram-blocks-data-retrieval-and-clarifies-what-information-it-retrieves/
- Instaloader, risoluzione dei problemi (il contatore delle richieste riparte da zero a ogni avvio, per questo i riavvii frequenti provocano blocchi; conviene riusare la sessione): https://instaloader.github.io/troubleshooting.html
- Instaloader, segnalazione di avvisi di comportamento automatico anche a ritmi bassi: https://github.com/instaloader/instaloader/issues/2172
- WebView2 e protocollo DevTools: https://learn.microsoft.com/microsoft-edge/webview2/how-to/chromium-devtools-protocol
- WebView2, pacchetto `DevToolsProtocolExtension` deprecato: https://learn.microsoft.com/microsoft-edge/webview2/release-notes/sdk/1-0-4071-prerelease
- WebView2, proprietà `IsVisible`: https://learn.microsoft.com/dotnet/api/microsoft.web.webview2.core.corewebview2controller.isvisible
- WebView2, cartella dei dati utente: https://learn.microsoft.com/microsoft-edge/webview2/concepts/user-data-folder
- WebView2, distribuzione del runtime: https://learn.microsoft.com/microsoft-edge/webview2/concepts/distribution
- Claude Code in VS Code (allegati, modalità): https://code.claude.com/docs/en/vs-code
- Claude Code, modalità Plan: https://code.claude.com/docs/en/permission-modes
- Claude Code, `CLAUDE.md`: https://code.claude.com/docs/en/memory
- Claude Code, buone pratiche: https://code.claude.com/docs/en/best-practices
Prove in locale, con Chromium 141 su Xvfb e una pagina servita da `127.0.0.1`:
- porta di debug fissa: `navigator.webdriver` falso; porta 0 oppure `--enable-automation`: vero;
- sul display virtuale la pagina risulta visibile e attiva; con `LANG=it_IT.UTF-8` e `TZ=Europe/Rome` vede lingua `it-IT` e fuso `Europe/Rome`;
- `Input.dispatchMouseEvent` di tipo rotella: eventi veri, la pagina scorre;
- `Page.startScreencast`: fotogrammi consegnati;
- `Network.loadNetworkResource` con `IO.read`: file di 40 MB scaricato integro; senza l'identificativo del frame il comando viene rifiutato.
Non controllabile senza un accesso a Instagram, e quindi lasciato come ipotesi: tutto ciò che riguarda il comportamento attuale del sito (voci H di §6.6) e i tetti di §7.5. Le prove in locale non dicono nulla su WebView2: per quello valgono le voci S.