docs: documentazione iniziale (requisiti, architettura, roadmap, ADR 0001-0013)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-11 18:49:10 +02:00
commit a49b1b13ca
24 files changed
+677

No files matched your search

@@ -0,0 +1,20 @@
# 0002 — Ricodifica video invece di archivio zip/tar.gz
- **Stato**: Accettato
- **Data**: 2026-10-11
## Contesto
Requisito originale: risparmiare spazio salvando i filmati compressi e decomprimendoli all'apertura.
## Decisione
Non usare archivi. Alla prima acquisizione il video viene **ricodificato una volta** con un codec più efficiente e salvato come .mp4 direttamente riproducibile.
## Alternative
- zip/tar.gz con decompressione all'apertura: gli mp4 sono già compressi da codec video, quindi un compressore generico guadagna in genere pochissimo (ordine di 0-2%, **da misurare sui tuoi file in M0**); costa attesa, spazio temporaneo, gestione dei file decompressi aperti e della ricompressione.
- Tenere gli mp4 così come sono: nessun risparmio, nessuna perdita di qualità. Resta un'opzione valida se lo spazio non è un problema.
## Conseguenze
- ✔ Nessun ciclo decomprimi/ricomprimi; seek e ripresa nativi.
- ✔ Risparmio reale (da misurare in M0; l'entità dipende da sorgente e impostazioni).
- ⚠ Ricodificare è **con perdita**: tenere gli originali finché la qualità del risultato non è validata (Q-04).
- ⚠ Costo: tempo di CPU all'ingest.