Files
Febe/CLAUDE.md
T
Alby96andClaude Opus 5.5 2ffb766a95
verifica / controlli (push) Successful in 21s
verifica / prove (push) Successful in 25m28s
verifica / installatore (push) Successful in 12m42s
verifica / immagine (push) Successful in 25m29s
Strada B: la pagina chiede i dati; febe-sonda richieste per i campioni nuovi
La prova dal vivo del 12/11 è fallita perché le ricette passive dipendono da
bersagli che si scoprono solo su Instagram. Alberto ha scelto la strada B
(issue #34): dalla pagina già aperta Febe chiede al sito gli stessi dati che
chiede la sua applicazione web, solo verso gli indirizzi di
richieste.<sito>.json, in lettura e con il permesso del Governatore.

- Specifica: eccezione della regola 2, riga e regole delle richieste in §6.1,
  correzione dell'idea di §1, regola 5, §6.3 e §7.4 da riscrivere con #36,
  §14.5, domanda 11 sulle storie; regola 4 di CLAUDE.md; due righe in
  decisioni.md.
- febe-sonda richieste: descrive la forma delle richieste XHR/Fetch della
  pagina (percorso, nomi e tipi di parametri, intestazioni, campi, struttura
  delle variabili GraphQL) senza valori personali. Un nome che nel HAR compare
  come valore diventa «(nome tolto)». 27 prove su un HAR sintetico; corretti
  i 17 difetti confermati da una revisione avversaria.
- OperationName accetta il suffisso «…Query_connection».
- prove-dal-vivo.md, parte A ter: il giro da fare per il HAR nuovo (#35).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 16:56:26 +01:00

4.9 KiB

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 .
  • Da VS Code: attività e configurazioni di debug in .vscode/ (guida: docs/guida/Sviluppo.md, «Da VS Code»); Febe per Windows di sviluppo tiene i dati in %USERPROFILE%\FebeSviluppo\<cartella del checkout>, mai in %LOCALAPPDATA%\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.

Repository e rilascio

  • Repository: Gitea di casa, https://gitea.encke-hake.ts.net/Alby96/Febe (ramo main). Non è GitHub: niente strumenti GitHub.
  • Processo (rami <tipo>/<argomento>, commit piccoli, una richiesta di unione per ramo, verifica verde per unire in main, commit di unione, rilasci, correzioni urgenti): docs/processo.md.
  • CI in .gitea/workflows/, script comuni in .gitea/scripts/:
    • verifica.yml a ogni push su qualunque ramo (non sui tag) e a mano, niente pull_request: controlli e gitleaks; compilazione di tutta la soluzione e tutte le prove di tests/Febe.Tests con Chromium, Xvfb, ffmpeg e NSIS veri in Debian, nessuna saltata, anche con il seme dell'esecuzione (FEBE_SEME_PROVA); installatore e zip -ci.<numero>; immagine provata senza rete e scansionata con Trivy. Dopo un push su main pubblica :main e :sha-<commit> (con il segreto REGISTRY_TOKEN; senza, un avviso).
    • rilascio.yml a ogni tag vX.Y.Z: immagine :X.Y.Z (e :latest) sul registro di Gitea, installatore Windows e release.
    • pulizia.yml ogni lunedì e a mano (con «Solo prova» elenca e non toglie nulla): resti della CI di Febe e di act_runner, immagini che nessun contenitore usa e cache di costruzione più vecchie di 24 ore, di tutti i progetti; con REGISTRY_TOKEN le :sha- oltre le 10 più recenti, mai main, latest o X.Y.Z. Mai contenitori, volumi o reti che non siano della CI, mai system prune. Ogni lavoro «immagine» toglie alla fine anche le immagini senza nome e la cache penzolante non usata da 24 ore.
  • Le prove nella CI passano solo da tests/Febe.Tests, mai dotnet test sulla soluzione intera.
  • La versione sta solo in Directory.Build.props (<Version>); il tag deve coincidere.
  • Guida per l'uso: wiki del repository (sorgenti in docs/guida/).