Adriano
7b169fb8db
Layout stile CerberoSuite/Cerbero: - services/ per MCP workspace members (futuri: mcp-docugen, mcp-convert, mcp-inbox) - docs/ flat con design+implementation per componente - scripts/, secrets/ placeholder - pyproject.toml root (uv workspace vuoto + ruff + pytest) - .gitignore, .env.example, .mcp.json.example, README.md Rinominate le doc: Docs/<comp>/2026-04-21-*.md -> docs/<comp>-*.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
66 lines
3.3 KiB
Markdown
66 lines
3.3 KiB
Markdown
# ArcaSuite
|
|
|
|
Monorepo per il **sistema documentale personale+aziendale** di Adriano e gli **MCP server** che lo supportano.
|
|
|
|
## Cos'è
|
|
|
|
Due pezzi, stesso repo:
|
|
|
|
1. **Sistema Documentale** — vault multi-wiki Markdown versionati su Gitea, pubblicati in sola lettura via Quartz, editabili da Obsidian + Claude Code. Vedi [`docs/sistema-documentale.md`](docs/sistema-documentale.md).
|
|
2. **MCP server** — microservizi MCP riusabili dai wiki (e da altri client Claude). Ogni MCP vive in `services/mcp-<nome>/` come membro del workspace `uv`.
|
|
|
|
## MCP previsti
|
|
|
|
| Servizio | Stato | Funzione |
|
|
|---|---|---|
|
|
| `mcp-docugen` | Design pronto, implementazione da iniziare | 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. |
|
|
|
|
Ogni MCP ha il suo `pyproject.toml`, `src/mcp_<nome>/`, `tests/` e Dockerfile. Viene registrato in `pyproject.toml` root come workspace member.
|
|
|
|
## Layout
|
|
|
|
```
|
|
ArcaSuite/
|
|
├── docs/ # design + implementation plan per componente
|
|
│ ├── sistema-documentale.md
|
|
│ ├── mcp-docugen-design.md
|
|
│ └── mcp-docugen-implementation.md
|
|
├── services/ # workspace members uv (uno per MCP)
|
|
│ └── mcp-<nome>/ # src/ tests/ pyproject.toml Dockerfile
|
|
├── scripts/ # script operativi (provisioning, backup, smoke)
|
|
├── secrets/ # chiavi, token (gitignored)
|
|
├── docker-compose.yml # stack completo (TODO: arriverà con primo MCP)
|
|
├── pyproject.toml # workspace uv + ruff + pytest root
|
|
├── .env.example # config root stack
|
|
├── .mcp.json.example # template registrazione client MCP
|
|
└── .gitignore
|
|
```
|
|
|
|
## Convenzioni
|
|
|
|
- **Nomenclatura**: `mcp-<nome>` per tutti gli MCP (pattern Cerbero). Package Python: `mcp_<nome>` (snake_case).
|
|
- **Package manager**: `uv` workspace. Nessun `requirements.txt`. `uv.lock` committato.
|
|
- **Python**: 3.11+, async-first, Pydantic v2 per ogni I/O.
|
|
- **Testing**: `pytest` + `pytest-asyncio`, `asyncio_mode = "auto"`, test sotto `services/<svc>/tests/`.
|
|
- **Lint**: `ruff` (config root), line 100.
|
|
- **Config**: ogni servizio ha un proprio `.env.example`. Root `.env` solo per cose cross-cutting (gateway port, dominio pubblico).
|
|
- **Secrets**: mai committati. `.mcp.json` locale gitignored, solo `.mcp.json.example` tracciato.
|
|
|
|
## Riferimento spec Python
|
|
|
|
Servizi non-MCP (es. eventuali `inbox-service` REST) seguono [`/home/adriano/Documenti/Struttura_Progetti/2026-04-01-python-project-spec-design.md`](/home/adriano/Documenti/Struttura_Progetti/2026-04-01-python-project-spec-design.md). Gli MCP server seguono la struttura specifica descritta nei rispettivi design doc (FastMCP come root ASGI).
|
|
|
|
## Setup (quando ci sarà il primo MCP implementato)
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
cp .mcp.json.example .mcp.json # compila con URL + API key
|
|
uv sync --all-groups
|
|
```
|
|
|
|
## Remote
|
|
|
|
- Gitea: `ssh://git@git.tielogic.xyz:222/Adriano/ArcaSuite.git`
|