docs: add CLAUDE.md and docs/ configuration reference

docs/email.md

@@ -0,0 +1,21 @@
+# Email
+
+Abilita notifiche, reset password, conferma registrazione. Aggiungere a `app.ini` (o `GITEA__mailer__...`) e riavviare.
+
+```ini
+[service]
+ENABLE_NOTIFY_MAIL = true
+
+[mailer]
+ENABLED   = true
+FROM      = gitea@your-domain.com
+PROTOCOL  = smtps            ; smtps (465) | smtp+starttls (587) | smtp | sendmail
+SMTP_ADDR = mail.your-domain.com
+SMTP_PORT = 465
+USER      = gitea@your-domain.com
+PASSWD    = ***              ; meglio GITEA__mailer__PASSWD__FILE
+```
+- Gmail: `smtp.gmail.com`, 465 smtps (o 587 smtp+starttls), serve una *app password* (richiede 2FA Google); OAuth non supportato.
+- L'autenticazione richiede TLS (o HOST=localhost).
+- `sendmail` non funziona con l'immagine Docker ufficiale: usare SMTP.
+- Test: Amministrazione sito → Configurazione → Riepilogo → Configurazione mailer → invia email di prova.