Files
Febe/CLAUDE.md
T

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

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.
  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.
  • CI in .gitea/workflows/: verifica.yml a ogni push e pull request, rilascio.yml a ogni tag vX.Y.Z (immagine Docker sul registro di Gitea, installatore Windows e release).
  • La versione sta solo in Directory.Build.props (<Version>); il tag deve coincidere.
  • Guida per l'uso: wiki del repository (sorgenti in docs/guida/).