Kantin-Petit
a301281594
Pose le socle méta : CLAUDE.md (architecture cible + règles non négociables versioning/sécurité/risque), README, CHANGELOG, .env.example (références secrets only), .gitignore, squelette d'arborescence. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# 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`].
|