docs: add CLAUDE.md and docs/ configuration reference

docs/backup-restore.md

@@ -0,0 +1,38 @@
+# Backup, restore, aggiornamenti
+
+## Cosa salvare
+Tutto lo stato è in `./gitea-data` (repo, SQLite, app.ini con SECRET_KEY, chiavi host SSH) e `./caddy/data` (certificati TLS, riemettibili). Nessuno dei due è versionato.
+
+## Metodo semplice (consigliato per SQLite)
+```bash
+docker compose stop gitea
+tar czf gitea-backup-$(date +%F).tgz gitea-data
+docker compose start gitea
+```
+Conservare il backup fuori dall'host e **insieme** a `app.ini` (senza SECRET_KEY i dati cifrati/2FA sono persi).
+
+## gitea dump
+Richiede Gitea fermo per consistenza. In Docker (RUN_USER=git in app.ini):
+```bash
+docker exec -u git -w /tmp gitea /usr/local/bin/gitea dump -c /data/gitea/conf/app.ini
+docker cp gitea:/tmp/gitea-dump-*.zip .
+```
+Lo zip contiene `app.ini`, `custom/`, `data/`, `repos/`, `gitea-db.sql`, `log/` (non necessario). Opzioni: `--file`, `--tempdir`, `--type`, `--database`, `--skip-repository`, `--skip-log`, ecc. Per MySQL/Postgres preferire `mysqldump`/`pg_dump`.
+
+## Restore (manuale, non esiste comando)
+1. Estrarre lo zip.
+2. `data/*` → `/data/gitea`, `repos/*` → `/data/git/repositories`, `app.ini` → `/data/gitea/conf/`.
+3. Importare `gitea-db.sql` (con SQLite basta ripristinare `gitea.db`).
+4. `chown -R git:git /data` (nel container).
+5. `gitea admin regenerate hooks`; se problemi `gitea doctor check --all --fix`.
+
+## Aggiornamento
+```bash
+# 1) backup  2) poi:
+docker compose pull
+docker compose up -d
+```
+L'immagine è `gitea/gitea:latest`: per aggiornamenti controllati fissare un tag (es. `gitea/gitea:1.x`) e leggere le note di rilascio. Le migrazioni DB partono in automatico (`AUTO_MIGRATION`) e non sono reversibili: il backup pre-update è l'unico rollback.
+
+## Cambio tipo di database
+`gitea dump --database postgres` genera SQL nel formato di destinazione; poco testato, scegliere il DB giusto dall'inizio. Prima: `gitea doctor check --all --fix` e `doctor recreate-table`.