Replace flowchart/ with a traceable specification in docs/

The two Mermaid diagrams under flowchart/ described the intended flow but
had drifted from the code and carried no link back to it. docs/ now holds
the specification instead: 15 Italian documents (flows, architecture, data
model, API, security, audit log, operations, decisions and limits, bug
history) with 472 numbered requirements, each pointing at the function
that implements it and the test that covers it. docs/processo-di-modifica.md
defines the ID convention and the spec -> code -> test change workflow, and
CLAUDE.md now names docs/ as authoritative.

Writing the spec from the code also corrected stale claims in CLAUDE.md
(B-41's get_history check, BUGS.md still tracking B-71/B-72, Cache-Control
scope, the error contract's bare-string exceptions) and in the operator
guides (payouts do retry, only `drawing` fails to resume, rounds do not
open without fee_address). The B-70 doc test now pins the prose in
docs/scommesse-e-prelievi.md instead of the deleted diagram.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/setup.md

@@ -35,8 +35,11 @@ cp .env.example .env
 | `JWT_SECRET` | Firma i token di sessione degli utenti. | `python -c "import secrets; print(secrets.token_urlsafe(32))"` |
 | `ADMIN_TOKEN` | Token bearer richiesto sugli endpoint admin (header `X-Admin-Token`). | `python -c "import secrets; print(secrets.token_urlsafe(32))"` |
 
-Le altre chiavi di `.env` (`DATABASE_URL`, `ELECTRUM_HOST`/`PORT`/`USE_SSL`,
-`MASTER_KEY_PATH`) hanno default sensati in `.env.example`.
+Le chiavi Electrum (`ELECTRUM_HOST`/`PORT`/`USE_SSL`) hanno default sensati in
+`.env.example`. `DATABASE_URL` e `MASTER_KEY_PATH` non sono elencate lì:
+hanno un default in `app/config.py`, e dentro il container vengono comunque
+sovrascritte da `docker-compose.yml` per puntare a `./data/` (elenco completo
+delle variabili in [architettura.md](architettura.md)).
 
 `ENABLE_API_DOCS` (default `false`) controlla Swagger/ReDoc/l'OpenAPI JSON grezzo
 su `/docs`, `/redoc` e `/openapi.json`: espongono l'intera superficie dell'API,
@@ -119,9 +122,10 @@ pip install -e ".[dev]"
 
 ## 6. Impostare l'indirizzo delle fee
 
-Prima che il primo round possa pagare, un admin deve impostare `fee_address`
-tramite il pannello admin o l'API — vedi [guida-admin.md](guida-admin.md). I
-payout si rifiutano di partire finché non è impostato.
+Prima che si possa aprire il primo round, un admin deve impostare
+`fee_address` tramite il pannello admin o l'API — vedi
+[guida-admin.md](guida-admin.md). Finché non è impostato **nessun round si
+apre**, perché il pagamento non si potrebbe costruire.
 
 A questo punto l'istanza è pronta per essere avviata — continua con
 [running-the-server.md](running-the-server.md).