Files
Febe/tools/Febe.SitoDiProva/LEGGIMI.md
T

7.8 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 TestSite.StartAsync(...) (porte libere scelte da sole).
  • 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)

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 }

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/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.