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

117 lines
7.8 KiB
Markdown

# 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
```sh
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:
```text
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.