ADR-0022 : Documentation et pile RAG¶
Statut : Accepté Dernière mise à jour : 2026-03-12
Résumé de la décision¶
Jorvis utilise une pile de documentation construite autour de :
- MkDocs pour le rendu de la documentation
- Open WebUI + pgvector pour le RAG et la récupération d'informations dans le chat
- Pipeline ProcessorFactory pour intégrer les documents d'entreprise dans l'index RAG
Sources d'intégration prises en charge¶
- Connecteurs Cloud : Google Docs (lecture seule), Google Drive (lecture seule), Google Sheets (lecture seule)
- Documents bureautiques : PDF, DOCX, XLSX, PPTX
- Formats structurés/web : JSON, HTML, CSV, texte brut, Markdown
- Embedding : les documents sont découpés en fragments, transformés en embeddings via un modèle Gemini, et stockés dans pgvector pour une recherche sémantique.
Pourquoi cela a été choisi¶
- Cela s'intègre parfaitement à la pile auto-hébergée (self-hosted) existante.
- Cela maintient une faible charge d'exécution (runtime overhead).
- Prend en charge les diagrammes Mermaid et la publication statique.
- Évite d'ajouter un deuxième environnement de documentation lourd alors que la pile actuelle gère déjà la recherche d'informations (retrieval).
- Le modèle ProcessorFactory s'étend proprement pour de nouveaux formats de documents sans modification architecturale.
Résultat pour la Référence Publique¶
Les visualisations publiques renvoient désormais à un build mkdocs-public.yml dédié sous /reference-fr/, de sorte que les utilisateurs accèdent à des pages HTML générées, au lieu de fichiers Markdown bruts ou de routes internes de gouvernance.