F1 · Strato di piattaforma: configurazione d'avvio Docker e desktop, cartella dei dati, identità dell'installazione #7

Closed
opened 2026-11-09 11:52:24 +01:00 by Alby96 · 1 comment
Owner

Fase 1 — Fondamenta · Specifica: docs/SPEC.md §3, 15.1, 15.2, 15.6

Obiettivo

Isolare in src/Anubis/Platform/ le sole differenze tra Docker e desktop.

Passi

  • DockerPlatform: variabili ANUBIS_*, TZ, PUID/PGID, PORT, chiavi facoltative con suffisso _DEMO
  • DesktopPlatform: config.toml (parser del sottoinsieme necessario scritto in casa) nella cartella dati dell'utente (%APPDATA%\Anubis su Windows, cartelle standard su macOS e Linux), allow_live = false alla nascita
  • Chiave dei segreti: da ANUBIS_SECRET_KEY in Docker, protetta con DPAPI (ProtectedData) su Windows, file con permessi ristretti altrove (dichiarato nell'interfaccia)
  • Struttura di /data: db/, models/, research/, import/, backups/, logs/, installation.json
  • Identità dell'installazione e impronta del database: confronto tra installation.json e database all'avvio
  • Configurazione mancante o database irraggiungibile: pagina d'errore, nessun ripiego su un altro database (trappola 20)

Criteri di accettazione della fase a cui contribuisce

  • L'immagine si costruisce e parte con ANUBIS_DB_ENGINE=sqlite e con postgres
  • Con una configurazione mancante o sbagliata compare la pagina d'errore e non nasce alcun altro database
  • Staccando il database compare la pagina d'errore e al ritorno l'applicazione riprende da sola
  • Con la configurazione desktop il server parte da una cartella dei dati vuota e la chiave dei segreti non finisce in config.toml

Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di docs/SVILUPPO.md.

**Fase 1 — Fondamenta** · Specifica: `docs/SPEC.md` §3, 15.1, 15.2, 15.6 ### Obiettivo Isolare in `src/Anubis/Platform/` le sole differenze tra Docker e desktop. ### Passi - [ ] `DockerPlatform`: variabili `ANUBIS_*`, `TZ`, `PUID`/`PGID`, `PORT`, chiavi facoltative con suffisso `_DEMO` - [ ] `DesktopPlatform`: `config.toml` (parser del sottoinsieme necessario scritto in casa) nella cartella dati dell'utente (`%APPDATA%\Anubis` su Windows, cartelle standard su macOS e Linux), `allow_live = false` alla nascita - [ ] Chiave dei segreti: da `ANUBIS_SECRET_KEY` in Docker, protetta con DPAPI (`ProtectedData`) su Windows, file con permessi ristretti altrove (dichiarato nell'interfaccia) - [ ] Struttura di `/data`: `db/`, `models/`, `research/`, `import/`, `backups/`, `logs/`, `installation.json` - [ ] Identità dell'installazione e impronta del database: confronto tra `installation.json` e database all'avvio - [ ] Configurazione mancante o database irraggiungibile: pagina d'errore, nessun ripiego su un altro database (trappola 20) ### Criteri di accettazione della fase a cui contribuisce - L'immagine si costruisce e parte con `ANUBIS_DB_ENGINE=sqlite` e con `postgres` - Con una configurazione mancante o sbagliata compare la pagina d'errore e non nasce alcun altro database - Staccando il database compare la pagina d'errore e al ritorno l'applicazione riprende da sola - Con la configurazione desktop il server parte da una cartella dei dati vuota e la chiave dei segreti non finisce in `config.toml` --- Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di `docs/SVILUPPO.md`.
Alby96 added this to the Fase 1 — Fondamenta milestone 2026-11-09 11:52:24 +01:00
Alby96 added the Kind/Feature
Priority
High
2
Area/Fondamenta
labels 2026-11-09 11:52:24 +01:00
Author
Owner

Fatto (commit 53ca01b, f9d7155 sul branch fase-1).

  • Configurazione d'avvio Docker (variabili ANUBIS_*) e desktop (config.toml), cartella dei dati con le sue sottocartelle, identità dell'installazione con impronta del database (installation.json + tabella installation).
  • Chiave dei segreti: ANUBIS_SECRET_KEY in Docker, DPAPI su Windows, file a permessi ristretti altrove; mai in config.toml.
  • L'identità si controlla prima di migrare: un database di un'altra installazione non viene toccato.

Prove — test verdi su SQLite e PostgreSQL (100 ciascuno):

  • PlatformTests, InstallationIdentityAndFingerprint;
  • MissingConfigurationShowsTheErrorPageAndCreatesNoDatabase (nessun database nasce con una configurazione mancante);
  • EmptyDatabaseOfAKnownInstallationAsksTheUser;
  • DesktopStartsFromAnEmptyFolderAndKeepsTheKeyOutOfConfig.

Scelte nell'ADR 0007.

**Fatto** (commit 53ca01b, f9d7155 sul branch `fase-1`). - Configurazione d'avvio Docker (variabili `ANUBIS_*`) e desktop (`config.toml`), cartella dei dati con le sue sottocartelle, identità dell'installazione con impronta del database (`installation.json` + tabella `installation`). - Chiave dei segreti: `ANUBIS_SECRET_KEY` in Docker, DPAPI su Windows, file a permessi ristretti altrove; mai in `config.toml`. - L'identità si controlla **prima** di migrare: un database di un'altra installazione non viene toccato. **Prove** — test verdi su SQLite e PostgreSQL (100 ciascuno): - `PlatformTests`, `InstallationIdentityAndFingerprint`; - `MissingConfigurationShowsTheErrorPageAndCreatesNoDatabase` (nessun database nasce con una configurazione mancante); - `EmptyDatabaseOfAKnownInstallationAsksTheUser`; - `DesktopStartsFromAnEmptyFolderAndKeepsTheKeyOutOfConfig`. Scelte nell'ADR 0007.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Anubis#7