docs: documentazione iniziale (requisiti, architettura, roadmap, ADR 0001-0013)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
commit
a49b1b13ca
24 files changed
+677
No files matched your search
@@ -0,0 +1,32 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user