docs(readme): aggiorna stato mcp-docugen, layout themes/, sezione template

- mcp-docugen ora 72 test verde, template seed versionati
- aggiunta dir themes/ nel layout
- sezione "Template mcp-docugen": elenco offerta + report-analisi,
  comportamento idempotente del seed, workflow modifica
- elenco endpoint utili (health, docs, redoc, mcp)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

README.md

@@ -13,7 +13,7 @@ Due pezzi, stesso repo:
 
 | Servizio | Stato | Funzione |
 |---|---|---|
-| `mcp-docugen` | Implementato, 68 test verde, deploy Docker via gateway Caddy (porta 8090), 6 tool MCP esposti | Genera Markdown formale da template + LLM (OpenRouter). Vedi [`docs/mcp-docugen-design.md`](docs/mcp-docugen-design.md) + [`docs/mcp-docugen-implementation.md`](docs/mcp-docugen-implementation.md). |
+| `mcp-docugen` | Implementato, 72 test verde, deploy Docker via gateway Caddy (porta 8090), 6 tool MCP esposti, template seed versionati con auto-seed al boot | Genera Markdown formale da template + LLM (OpenRouter). Vedi [`docs/mcp-docugen-design.md`](docs/mcp-docugen-design.md) + [`docs/mcp-docugen-implementation.md`](docs/mcp-docugen-implementation.md). |
 | `mcp-convert` | Da progettare | Conversione Markdown → PDF / DOCX / HTML (pandoc/typst backend). |
 | `mcp-inbox` | Da progettare | Ingest da Telegram (+ STT opzionale via Whisper) verso draft inbox consumati da Claude Code desktop. |
 
@@ -33,6 +33,7 @@ ArcaSuite/
 ├── secrets/                      # chiavi, token (gitignored)
 ├── docker/                       # base.Dockerfile condiviso multi-stage
 ├── gateway/                      # Caddy reverse proxy (Caddyfile)
+├── themes/                       # CSS condivisi (Tielogic DEVNOTES per md-to-pdf)
 ├── docker-compose.yml            # stack completo (gateway + servizi MCP)
 ├── pyproject.toml                # workspace uv + ruff + pytest root
 ├── .env.example                  # config root stack
@@ -69,6 +70,26 @@ Smoke test:
 curl -H "Authorization: Bearer $DOCUGEN_API_KEY" http://localhost:8090/mcp-docugen/health
 ```
 
+Endpoint utili (richiede Bearer per quelli MCP, pubblici per la documentazione):
+
+- `GET /mcp-docugen/health` — healthcheck (pubblico)
+- `GET /mcp-docugen/docs` — Swagger UI REST (pubblico)
+- `GET /mcp-docugen/redoc` — ReDoc REST (pubblico)
+- `POST /mcp-docugen/mcp` — endpoint MCP JSON-RPC (Bearer + sessione MCP)
+
+## Template `mcp-docugen`
+
+I template ufficiali sono versionati in `services/mcp-docugen/templates_seed/<nome>/template.md` e copiati nel volume `docugen-data` al primo boot. La copia è **idempotente**: se un template esiste già nel volume (es. modificato a runtime via tool MCP `template_update`) non viene sovrascritto.
+
+Template attualmente disponibili:
+
+- `report-analisi` — report tecnico stile DEVNOTES Tielogic (analisi sperimentali, criticità, fattibilità, roadmap, accettazione)
+- `offerta` — offerta economica stile docx Tielogic (cover FORNITORE/CLIENTE, modello commerciale setup+canone+sconto+proiezione, condizioni, accettazione)
+
+Per propagare modifiche al template versionato su un'installazione esistente: usare il tool MCP `template_update`, oppure rimuovere il template dal volume e fare restart del container.
+
+Conversione Markdown→PDF (in attesa di `mcp-convert`): `md-to-pdf <file>.md` con il CSS `themes/tielogic-devnotes.css` referenziato dal frontmatter dei template.
+
 ## Remote
 
 - Gitea: `ssh://git@git.tielogic.xyz:222/Adriano/ArcaSuite.git`