Documentation

Tout ce qu'il faut pour livrer

Parcourez la documentation de Simmetric Chat - de votre premier prompt aux déploiements en production.

Moteur de wiki — archives à schéma, wikilinks et synthèse

Le moteur de wiki donne à chaque archive un modèle d'instruction à trois niveaux : des règles dures appliquées par le code, un prompt de schéma par archive (lignes directrices éditoriales advisory) et des champs structurés (persona, purpose, scope). Modè…

Pipeline de synthèse — réunir les documents, déceler les contradictions

La pipeline de synthèse multi-documents prend un ensemble de pages/documents d'une archive et produit des pages wiki réunies : chaque page synthétise les sources, signale où les sources ne sont pas d'accord (contradiction detection), respecte les budgets…

Quotas et coûts — les plafonds d'usage et de dépense

Le moteur de quota couvre trois genres : le quota de tokens et le quota de stockage (Phase 207) plus le quota de coût (Phase 216, hold-and-settle sur la mathématique d'argent réel). Les quotas sont l'outil de l'opérateur pour les plafonds d'usage sur les…

La pipeline DLP des documents — référence opérateur

Quand le balayage DLP est activé pour un workspace, chaque document téléversé traverse un balayage asynchrone pg-boss après l'ingestion :

Skills personnalisées — instructions sur mesure, appelables par `/slug`

Une skill personnalisée est un template de prompt qu'un opérateur ou un utilisateur compose une fois et rappelle à l'infini depuis le chat comme une commande slash (/translate Bonjour le monde). Les skills ne sont qu'une capacité prompt-template : l'invo…

Connecteurs — les canaux externes connectés à la base de connaissances

Les connecteurs relient les canaux de messagerie où se trouvent déjà vos clients et vos collaborateurs — WhatsApp, Telegram, Discord, Slack — à la même base de connaissances qui alimente le chat interne. Les conversations restent sur vos serveurs : l'app…

Guide de démarrage

Simmetric Chat est une plateforme de chat IA local-first et capable de fonctionner hors connexion (air-gap) : elle fonctionne sans accès aux services cloud externes, avec un LLM local (Ollama), des embeddings locaux (Xenova) et une base vectorielle local…

Architecture

Simmetric Chat est un monorepo TypeScript modulaire avec 5 packages plus une application desktop Tauri. Le principe directeur est la séparation des frontières : chaque package a des responsabilités distinctes et ne communique avec les autres que par des …

Configuration

Simmetric Chat dispose de deux niveaux de configuration : des variables d'environnement validées avec Zod au démarrage du processus, et un niveau de configuration runtime stocké en base de données que les administrateurs peuvent modifier depuis l'interfa…

Référence API

API REST du serveur Express (port 3000, préfixe /api), avec une interface Swagger interactive et une spec OpenAPI servie par le serveur lui-même, documentée ici par domaine avec ses mécanismes d'authentification, ses limites de débit et ses conventions d…

Guide des fonctionnalités

Guide des fonctionnalités avec internals, flux de données et références file:line. Pour chaque fonctionnalité : comment elle fonctionne, comment l'utiliser, comment l'étendre.

Intégration du widget

Le widget embarquable est un service séparé (packages/widget, port 3211) qui expose un chat AI sur votre site. Architecture : Express + Preact IIFE en iframe sandboxed, proxy SSE transparent vers le serveur, sessions anonymes, lead capture, branding par-…

MCP Marketplace

Le MCP Marketplace permet d'installer, d'activer et de scoper des MCP server externes depuis un catalogue curé. Les MCP server exposent des tools que l'agent ReAct peut invoquer pendant les chats, étendant les capacités sans code.

Administration

Guide opérationnel pour les administrateurs : utilisateurs, rôles (RBAC), workspace, audit, licences et backups administratifs. Toutes les opérations exigent authMiddleware plus des permissions spécifiques - voir l'API Reference pour l'inventaire complet…

Déploiement

Simmetric Chat est air-gap capable et local-first. Cinq cibles de déploiement : Docker Compose multi-container (recommandée pour la production), container unique all-in-one (environnements air-gapped), stack géré Coolify, override dev (hot-reload sur Doc…

Développement

Guide pour contribuer au codebase : setup, structure monorepo, scripts, conventions, i18n.

Testing

Simmetric Chat utilise Jest 30 avec la transformation @swc/jest (unit + integration) et Playwright (E2E), orchestrés par Turborepo. Le jest.config.cjs racine agrège les 5 projets (shared, server, frontend, collector, widget).

Troubleshooting

Symptômes courants, cause, résolution. Références file:line et cross-link vers les docs.

Documentation API interactive

Swagger / OpenAPI 3.0 sont servis sur /api-docs lorsque le serveur est en cours d'exécution.