# CHLOVA

Assistant personnel (style Jarvis). **Couche d'orchestration** au-dessus d'un
homelab Debian + Docker + Traefik existant. Le cerveau est un LLM en boucle
tool-calling qui agit via des outils MCP (n8n, Portainer) et parle aux modèles
Ollama **cloud**.

> Voir [`CLAUDE.md`](./CLAUDE.md) pour l'architecture et les règles non négociables.

## État
- **Phase 0** — socle (en cours) : structure, sécurité, conventions, compose.
- **Phase 1** — cerveau **lecture seule** : orchestrateur + MCP read-only + texte.
- Phases 2+ : non implémentées (écriture, need-review, voix, auto-extension).

## Structure
| Dossier | Rôle |
|---|---|
| `docs/` | Architecture, sécurité, versioning, paliers de risque, gabarit d'asset |
| `infra/` | docker-compose de la stack + socket-proxy + notes réseau |
| `orchestrator/` | Le cerveau (TypeScript/Node, Fastify) |
| `workflows-n8n/` | Exports JSON des workflows (le dépôt fait foi) |

## Démarrage (dev)
À compléter en fin de Phase 1. Pré-requis : Node 22, Docker. Copier
`.env.example` → `.env`, renseigner les secrets (jamais commités).

## Sécurité
Seul le backend CHLOVA est exposé. Ollama/n8n/Portainer restent sur le réseau
Docker interne. Secrets via env/coffre uniquement. Voir [`docs/security.md`].