docs: add CLAUDE.md and docs/ configuration reference

docs/cli.md

@@ -0,0 +1,42 @@
+# CLI di Gitea
+
+Eseguire nel container come utente `git` (mai root):
+
+```bash
+docker exec -u git gitea gitea <comando>
+# se non trova la config:
+docker exec -u git gitea gitea -c /data/gitea/conf/app.ini <comando>
+```
+Opzioni globali: `--config/-c`, `--custom-path/-C`, `--work-path/-w`.
+
+## Utenti
+```bash
+gitea admin user create --username U --password P --email E [--admin] [--must-change-password] [--random-password] [--access-token]
+gitea admin user list [--admin]
+gitea admin user change-password -u U -p NUOVA [--must-change-password]
+gitea admin user delete --id N | --username U | --email E
+gitea admin user generate-access-token -u U -t NOME --scopes ...
+```
+## Manutenzione
+```bash
+gitea admin regenerate hooks     # dopo restore/spostamento directory
+gitea admin regenerate keys      # rigenera authorized_keys
+gitea doctor check --list        # elenco controlli
+gitea doctor check --all [--fix] # diagnosi/riparazione
+gitea doctor recreate-table      # backup DB prima!
+gitea doctor convert             # utf8 → utf8mb4 (MySQL)
+gitea migrate                    # migrazioni DB (idempotente)
+gitea generate secret SECRET_KEY|INTERNAL_TOKEN|JWT_SECRET
+gitea cert --host your-domain.com
+```
+## Autenticazione esterna
+`gitea admin auth list|delete --id|add-oauth|add-smtp|add-ldap|add-ldap-simple|update-*`
+
+## Server in esecuzione
+`gitea manager shutdown|restart|flush-queues|logging|processes [--stacktraces --cancel PID]`
+
+## Backup
+`gitea dump` (vedi [backup-restore.md](backup-restore.md)), `dump-repo`/`restore-repo` per singoli repo.
+
+## Actions
+`gitea actions generate-runner-token [--scope owner[/repo]]`