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