From 0ab6fcb188efe8063a2baa1a36c2b918181f7349 Mon Sep 17 00:00:00 2001 From: AdrianoDev Date: Sat, 25 Apr 2026 12:44:15 +0200 Subject: [PATCH] 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) --- README.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 35896c0..41f1739 100644 --- a/README.md +++ b/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//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 .md` con il CSS `themes/tielogic-devnotes.css` referenziato dal frontmatter dei template. + ## Remote - Gitea: `ssh://git@git.tielogic.xyz:222/Adriano/ArcaSuite.git`