Riorganizza la documentazione per l'uso con assistenti AI

- Spezza il registro delle decisioni in docs/decisions/DD-XXX.md, con indice
- Ripulisce DATABASE.md dalla storia delle migration e aggiunge la sezione Lettura
- Riduce PROJECT_STATE.md a una pagina; la procedura di allestimento passa in OPERATIONS.md
- Aggiunge OPERATIONS.md, GLOSSARIO.md, trappole note e checklist in ARCHITECTURE.md
- Sintetizza la copertura test di badge.md e documenta docs/archive
- Allinea AGENTS.md, README.md e la regola Cursor (tolto l'obbligo di develop, in contrasto con DD-019)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

docs/decisions/DD-021.md

@@ -0,0 +1,40 @@
+# DD-021 — Molle interrompibili al posto delle animazioni a durata fissa
+
+**Data:** 5 settembre 2026  
+**Stato:** Accettata
+
+**Contesto**  
+Il movimento era fatto con `@keyframes` CSS e transizioni a durata fissa. Funzionava, ma
+nessuna di quelle animazioni può essere interrotta: se l'utente tocca o scorre a metà, la
+sequenza va avanti per conto suo, e per ripartire deve prima finire. Mancava del tutto
+qualsiasi gesto: il calendario si cambiava solo con due frecce.
+
+Contemporaneamente 43 componenti su 45 in `src/components/ui/` non erano importati da nessuna
+parte, e con loro ~45 dipendenze (tutti i `@radix-ui/*`, `recharts`, `react-hook-form`,
+`date-fns`, `embla`, `cmdk`, …): superficie di aggiornamento e di sicurezza pagata a vuoto.
+
+**Decisione**  
+Aggiungere **una** libreria di animazione — `motion` — e toglierne ~45 inutilizzate. I
+parametri stanno in `src/lib/molla.ts` e sono i due di Apple (_Designing Fluid Interfaces_):
+rimbalzo e durata, non massa/rigidità/smorzamento. `molla.ui` (nessun sorpasso) è il default;
+`molla.slancio` si usa **solo** dopo un gesto che portava già inerzia.
+
+**Alternative scartate**
+
+- Tenere solo CSS con easing `linear()` e View Transitions → copre le comparse, non i gesti:
+  niente handoff di velocità, niente ripartenza dal valore corrente.
+- GSAP → più grande e orientato alla timeline, cioè al modello prescritto che stiamo lasciando.
+
+**Conseguenze**
+
+- Le animazioni partono dal valore _a schermo_: un dato che cambia a metà transizione non
+  produce salti.
+- Il movimento è ora codice JavaScript: senza JS non c'è comparsa (l'app già non funziona
+  senza, per auth e dati).
+- `src/lib/motion.ts` resta solo per il movimento ridotto e i coriandoli.
+- `src/components/ui/` non è più una libreria: aggiungere una primitiva shadcn significa
+  installarla, non pescarla da lì.
+
+**Riesame**  
+Se il peso del bundle client diventasse un problema misurato, o se il web recuperasse
+nativamente l'interrompibilità (`ScrollTimeline` e `linear()` sono un primo passo).