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,24 @@
# 0010 — Categorie ad albero con filmati solo nelle foglie
- **Stato**: Accettato
- **Data**: 2026-10-11
- Sostituisce [0005](0005-categorie-ad-albero.md)
## Contesto
Risposta dell'utente a Q-02 (2026-10-11): la struttura è come una serie TV, cioè serie → stagioni → episodi. Gli episodi (filmati) stanno dentro le stagioni, non nella serie.
## Decisione
Resta quanto deciso in ADR 0005: collezione `categories` con `parent` (self-relation, nullo per le radici), profondità arbitraria, UI generica un livello alla volta.
Aggiunta: un filmato può appartenere solo a una categoria **foglia** (senza sottocategorie), e una categoria che contiene filmati non può ricevere sottocategorie. Una categoria è quindi o un contenitore di categorie o un contenitore di filmati, mai entrambe le cose.
## Alternative considerate
- Filmati ovunque nell'albero (ADR 0005): più flessibile, ma una categoria mista (sottocategorie + filmati sciolti) è ambigua da navigare e non corrisponde al modello serie/stagioni.
## Conseguenze
- Serve validazione in hook: creare un filmato in una categoria con figli, creare una sottocategoria sotto una categoria con filmati, e spostare filmati o rami che violerebbero la regola vengono rifiutati con messaggio chiaro.
- Si conferma: no cicli; eliminazione bloccata se ci sono figli o filmati.
- La navigazione ([02-architettura.md](../02-architettura.md)) in una categoria mostra o figli o filmati, mai entrambi.
- Da verificare: l'ordine degli episodi per il "precedente/successivo" (F-08) usa un campo di ordinamento manuale dentro la stagione.
## Fonti
Decisione dell'utente del 2026-10-11 (Q-02).