Files
Febe/CLAUDE.md
T

44 lines
3.2 KiB
Markdown

# 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/`).