Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Mzbb6zeFTjT6Rp8b92AVkA
117 lines
7.8 KiB
Markdown
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.
|