feat(mcp-docugen): scaffold service + Docker stack con gateway Caddy

Task 0 del piano (adattato a workspace uv):
- services/mcp-docugen/: pyproject.toml, src/mcp_docugen/, tests/unit+integration/,
  README, .env.example. Package rinominato da docugen_mcp -> mcp_docugen.
- Root pyproject.toml: aggiunto services/mcp-docugen a workspace members.
- .python-version: 3.11
- uv.lock committato.

Docker stack stile CerberoSuite/Cerbero con prefisso "arca-":
- docker/base.Dockerfile -> arca-base:latest
- docker/mcp-docugen.Dockerfile -> arca-mcp-docugen:dev (porta interna 9100,
  label arca.service, runtime multi-stage, user non-root, healthcheck)
- docker-compose.yml root: gateway Caddy unica porta host (8080) + mcp-docugen
  su rete interna. Security defaults cap_drop ALL, no-new-privileges, read_only
  ove applicabile, restart unless-stopped.
- gateway/Caddyfile: reverse proxy /mcp-docugen/* -> mcp-docugen:9100 + landing.
- gateway/public/index.html: landing page minimale.

.env.example root aggiornato con DOCUGEN_API_KEY + OPENROUTER_API_KEY condivisa.

Task 1-12 (implementazione TDD effettiva) ancora da fare.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-21 12:16:22 +02:00
parent 7b169fb8db
commit c5e84a578b
16 changed files with 1692 additions and 8 deletions
+9 -7
View File
@@ -1,10 +1,12 @@
# Root stack config (gateway/compose). Ogni servizio aggiunge il proprio .env.example.
# Porta host del gateway (reverse proxy Caddy/nginx) — da definire
# Porta host del gateway Caddy (unico accesso esterno allo stack)
GATEWAY_PORT=8080
# Token OpenRouter condiviso fra MCP che usano LLM
# OPENROUTER_API_KEY=
# URL pubblico del gateway (usato dai servizi per costruire link asset assoluti)
PUBLIC_BASE_URL=http://localhost:8080/mcp-docugen
# Dominio pubblico (usato da servizi che generano URL assoluti)
# PUBLIC_BASE_DOMAIN=arca.tielogic.xyz
# ===== mcp-docugen =====
# Bearer API key che i client MCP (Claude Code, ecc.) useranno
DOCUGEN_API_KEY=
# ===== OpenRouter (condiviso fra MCP che usano LLM) =====
OPENROUTER_API_KEY=