Files
Febe/tools/Febe.SitoDiProva/LEGGIMI.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

9.6 KiB

Sito di prova di Febe

Sito locale per far girare ricette, cattura, lettori, scaricamenti e motore con un browser vero senza toccare Instagram (specifica §14.2). Pagine spoglie, nessun marchio né grafica di Instagram, nessuna pagina di accesso: non deve somigliargli, deve solo comportarsi come un sito che carica i dati in JSON mentre si scorre.

Avvio

dotnet run --project tools/Febe.SitoDiProva -- [--porta 8481] [--porta-cdn 8482] [--indirizzo-cdn 127.0.0.2] [--seme 13]
  • Il sito ascolta su 127.0.0.1:<porta>; il «CDN» che serve foto e video su un secondo indirizzo (127.0.0.2:<porta-cdn>, oppure 127.0.0.1 su un'altra porta dove 127.0.0.2 non si può usare), così i cookie del sito non gli arrivano.
  • I dati sono sintetici e si generano da un seme: stesso seme, stessi account, post, codici e didascalie. Le date sono relative al momento dell'avvio (le storie sono attive per 24 ore da lì).
  • Le prove automatiche lo avviano dentro il processo con SyntheticSite.StartAsync() (tests/Febe.Tests/Support), che chiama TestSite.StartAsync(...) con porte libere scelte da sole e il seme della variabile FEBE_SEME_PROVA (13 se manca). La CI fa girare tutte le prove con il seme 13 e quelle della categoria SitoDiProva anche con un seme diverso a ogni esecuzione, scritto nel registro; per rifare una prova fallita con quel seme: FEBE_SEME_PROVA=<seme> dotnet test tests/Febe.Tests --filter "TestCategory=SitoDiProva".
  • Campioni grezzi per le prove dei lettori: dotnet run --project tools/Febe.SitoDiProva -- campioni --cartella <fuori dal repository> (poi febe-sonda ripulisci, vedi tests/Febe.Tests/campioni/prova/LEGGIMI.md).

Il mondo

Account Che cos'è
alberto.prova l'account collegato («Tu»); da lui si apre l'elenco dei seguiti
marta.prova pubblico, seguito: 18 post (foto, serie di tre file, video = reel), 2 post fissati, 4 storie (una è un video), raccolte «Estate» e «Viaggi»; compare nei taggati di Luca e di Paolo
luca.prova pubblico, seguito: 40 post (storico su più pagine), 2 storie, raccolta «Montagna»
giulia.prova privato, seguito: 6 post, 5 storie
nadia.prova pubblico, seguito: 3 post, 3 storie
paolo.prova pubblico, non seguito: 8 post, 1 storia
riservato.prova privato, non seguito: non si tocca
amico01.prova … amico24.prova seguiti, uno o due post ciascuno (l'elenco dei seguiti ha 28 profili)
qualunque altro nome non esiste: la pagina risponde 404 con il titolo «Profilo non trovato»

La barra delle storie elenca i seguiti con storie attive, dalla più recente: Marta, Nadia, Luca, Giulia. Una delle storie attive di Marta è anche nella raccolta «Estate», con lo stesso identificativo (ipotesi H9).

Pagine

Indirizzo Che cosa fa
/ pagina iniziale: barra delle storie (collegamenti «Storie di …») e post recenti dei seguiti; scorrendo carica altre pagine
/profilo/{nome}/ profilo: foto (con «Apri le storie di …» se ci sono storie), raccolte («Raccolta …»), schede Post, Reel, Taggati (ruolo tab), griglia che carica altre pagine scorrendo; ?dopo={cursore} riparte da un punto della griglia
/profilo/{nome}/reel/, /profilo/{nome}/taggati/ le altre schede, con lo stesso scorrimento
/profilo/alberto.prova/seguiti/ elenco dei profili seguiti, a pagine, scorrendo; accetta ?dopo=
/storie/{nome}/ visualizzatore: una storia alla volta, barra di avanzamento, zona «Storia successiva», pulsante «Chiudi». L'indirizzo diventa /storie/{nome}/{id}/ per la storia mostrata. Come i siti veri, dopo l'ultima storia passa da solo all'account successivo della barra: chi lo usa deve chiuderlo prima
/evidenza/{id}/ visualizzatore di una raccolta, come sopra (/evidenza/{id}/{contenuto}/); dopo l'ultimo contenuto passa alla raccolta successiva dello stesso account
/post/{codice}/ pagina di un post, con tutti i file
/verifica pagina di verifica, semplice testo
/sessione-scaduta pagina di sessione terminata, semplice testo (non è un modulo di accesso)
pulsante «Cerca» (in ogni pagina) apre il pannello di ricerca (bersagli search-open e search-box): a ogni tasto la pagina chiede /dati/cerca e mostra i profili trovati; con la casella vuota mostra le ricerche recenti. Premere Invio o aprire un risultato scrive una «ricerca recente» (POST /dati/ricerche-recenti), cosa che Febe non deve fare mai (issue #37)
/benvenuto quella che Febe apre come «pagina di accesso» del sito di prova (Collegamento): semplice testo, nessun modulo; la visita apre la sessione, come ogni pagina

La mappa dei bersagli di queste pagine è src/Febe.Core/Config/bersagli.prova.json (copiata accanto al programma in config/), i segnali di arresto sono in segnali.prova.json.

Formato dei dati

Le pagine caricano i dati con fetch da /dati/... e li leggono davvero (così il browser consegna il corpo alla cattura). Il formato è nostro, con chiavi italiane: non imita Instagram e non va usato come indizio sul formato di Instagram (regola 10). Il vocabolario che lo descrive ai lettori è src/Febe.Core/Config/lettori.prova.json.

Indirizzo dei dati Risposta
/dati/inizio { io, barra: [profilo], contenuti: [contenuto], pagina }
/dati/inizio/altri?dopo= { contenuti, pagina }
/dati/profilo/{nome}?scheda=post|reel|taggati&dopo= { profilo, raccolte (solo prima pagina dei post), contenuti, pagina }
/dati/profilo/{nome}/altri?scheda=&dopo= { contenuti, pagina }
/dati/post/{codice} { contenuto }
/dati/storie/{nome} { autore, storie: [contenuto], successivo }: tutte le storie attive arrivano subito
/dati/evidenza/{id} { raccolta: { numero, titolo, autore, contenuti }, successiva }
/dati/seguiti?dopo= { seguiti: [profilo], pagina }
/dati/cerca?testo= eccezione: le chiavi del campione ripulito 000002-ricerca-profili di Instagram (data.xdt_api__v1__fbsearch__topsearch_connection.users[].user), al più 8 profili, mai l'account collegato, prima quelli il cui nome comincia con il testo; maiuscole, accenti e spazi ai lati non contano
/dati/ricerche-recenti GET: le ricerche recenti; POST: ne scrive una (conta in /_controllo/ricerca/recenti)

Oggetti:

profilo    { numero, nome, nome_visibile, riservato, seguito, pubblicazioni, ritratto: [versione], ultima_storia? }
contenuto  { numero, sigla?, pubblicato, testo?, fissato, autore: { numero, nome },
             foto: [versione] | filmati: [versione] + foto (copertina) + durata | parti: [file] + parti_totali,
             scade? (storie) }
file       { numero, foto | filmati + durata }
versione   { indirizzo, larghezza, altezza, audio? (filmati) }
pagina     { altro, dopo }
  • Date in testo ISO 8601, UTC (2026-10-13T08:00:00Z); durate in secondi.
  • Le immagini hanno tre versioni (media, grande, piccola: la più grande non è la prima); i video due versioni con audio e una più grande senza audio, che i lettori non devono scegliere.
  • Nei post della pagina iniziale una serie arriva incompleta: solo il primo file e parti_totali. Profilo e pagina del post la danno intera (è il caso «Post singolo»).
  • Cursori opachi c{n}.
  • Gli indirizzi dei file sono firmati e scadono: /m/{chiave}/{L}x{A}.jpg?scad={unix}&firma={hmac} (durata predefinita 6 ore). Un indirizzo scaduto riceve 403. Le foto sono generate con SkiaSharp dalla chiave (stessa chiave, stessa immagine a ogni dimensione); i video sono due MP4 minuscoli generati una volta con ffmpeg (Risorse/filmato-con-audio.mp4, Risorse/filmato-muto.mp4), resi unici aggiungendo in coda un riquadro free.

Casi di arresto e comandi per le prove

Dentro il processo: site.Control (SiteControl). Da fuori: /_controllo/... sul sito.

Comando Effetto
/_controllo/modo?valore=troppe-richieste[&dopo=N] le richieste di dati ricevono 429 (dopo N richieste)
/_controllo/modo?valore=verifica le pagine rimandano a /verifica; i dati rispondono 403 e la pagina ci va da sola
/_controllo/modo?valore=sessione-scaduta il cookie sessione_prova si cancella e le pagine vanno a /sessione-scaduta
/_controllo/modo?valore=vuoto le pagine di dati arrivano vuote
/_controllo/modo?valore=formato-sconosciuto i dati arrivano in una forma che nessun lettore conosce
/_controllo/modo?valore=normale, /_controllo/reimposta tutto torna normale
/_controllo/durata-storie?ms= quanto resta a schermo una storia prima che il visualizzatore vada avanti da solo
/_controllo/scadenza-indirizzi?secondi= durata degli indirizzi firmati consegnati da quel momento
/_controllo/cdn-troppe-richieste?valore=si|no il CDN risponde 429 a ogni file (rallentamento chiesto dal CDN)
/_controllo/rinomina?da=&a= un account cambia nome (stesso numero)
/_controllo/ritratto?nome= nuova foto del profilo
/_controllo/pubblica?nome=&tipo=foto|video|serie nuovo post in cima
/_controllo/ricerca/ritardo?ms= ritardo di ogni risposta della ricerca
/_controllo/ricerca/disordine?valore=si|no le risposte ai testi più corti arrivano più tardi (fuori ordine)
/_controllo/ricerca/memoria?valore=si|no il pannello ricorda il testo quando si richiude, come Instagram
/_controllo/ricerca/recenti quante ricerche recenti sono state scritte
/_controllo/stato modo attuale e numero di richieste di dati

Il sito non ha pagine di accesso: la sessione (cookie sessione_prova) nasce alla prima visita di una pagina.