Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> # Conflicts: # docs/decisioni.md
4.3 KiB
4.3 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)
- IMPORTANTE: non contattare mai Instagram da prove, script o verifiche tue. Si usa solo tools/Febe.SitoDiProva. Le prove dal vivo le lancia Alberto.
- 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.
- Verso Instagram parla solo il browser di Febe. Nessun HttpClient verso domini di Instagram o Meta, tranne il CDN alle condizioni di §6.5.
- 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.
- CAPTCHA, verifiche e codici non si risolvono mai in automatico: Febe si ferma e avvisa.
- Sola lettura (niente mi piace, segui, commenti, messaggi) e solo ciò che l'account di Alberto vede già.
- Un account, un motore. I cookie non si copiano da una macchina all'altra.
- Ogni azione del motore verso il sito passa da IGovernor. Al primo segnale di §7.6 ci si ferma.
- I lettori si scrivono solo su campioni reali ripuliti. Il formato delle risposte non si inventa.
- Mai password, cookie, tasti o corpi di risposta nei log. Il client CDP registra solo nomi di comandi.
- La libreria non cancella e non sostituisce file da sola.
- 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.ymla 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 ditests/Febe.Testscon 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:maine:sha-<commit>(con il segretoREGISTRY_TOKEN; senza, un avviso).rilascio.ymla ogni tagvX.Y.Z: immagine:X.Y.Z(e:latest) sul registro di Gitea, installatore Windows e release.pulizia.ymlogni lunedì: solo i resti della CI di Febe sul demone Docker condiviso.
- Le prove nella CI passano solo da
tests/Febe.Tests, maidotnet testsulla 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/).