# Videoteca

Web app **locale** per archiviare filmati per categoria/sottocategoria e guardarli nel browser, con ripresa dal punto in cui si era rimasti.

- Stato corrente: [docs/PROJECT_STATE.md](docs/PROJECT_STATE.md)
- Indice documentazione e fonti uniche: [docs/index.md](docs/index.md)
- Storico modifiche: [CHANGELOG.md](CHANGELOG.md)

## Cosa c'è da fare

Stato: documentazione completa, **nessun codice** (primo commit = solo documentazione). Dettagli e criteri di completamento: [docs/03-roadmap.md](docs/03-roadmap.md).

1. **Assunzioni dell'MVP** (da rivedere dopo): [docs/04-rischi-e-domande-aperte.md](docs/04-rischi-e-domande-aperte.md).
2. **M0** — spike: PocketBase in locale, prova di codec e ffmpeg su 3 file campione.
3. **M1** — schema dati, utenti e regole di accesso.
4. **M2** — upload e ricodifica.
5. **M3 / M3b** — interfaccia per gli utenti e pannello admin.
6. **M4** — player con ripresa.
7. **M5** — robustezza, backup. **M6** (futura) — esposizione in rete con HTTPS.

## Principi del repo

| Principio | Significato qui |
|---|---|
| Docs-as-code | Tutta la documentazione è Markdown nel repo, versionata con il codice |
| Document-first | Prima si scrive/aggiorna doc o ADR, poi il codice |
| ADR | Ogni scelta tecnica rilevante ha un record in `docs/adr/` |
| SSOT | Ogni informazione ha **un solo** documento di riferimento (vedi `docs/index.md`); gli altri la linkano |

## Avvio (a regime, dopo M1)

Da definire in `docs/02-architettura.md` §Esecuzione. Non duplicare qui i comandi: linkare.