ADR-0022: Documentatie en RAG Stack¶
Status: Geaccepteerd Laatst bijgewerkt: 2026-03-12
Beslissing Samenvatting¶
Jorvis gebruikt een documentatie stack gebouwd rond:
- MkDocs voor het renderen van documentatie
- Open WebUI + pgvector voor RAG en chat retrieval
- ProcessorFactory pipeline voor het importeren van enterprise documenten in de RAG index
Ondersteunde Import Bronnen¶
- Cloud connectors: Google Docs (read-only), Google Drive (read-only), Google Sheets (read-only)
- Kantoordocumenten: PDF, DOCX, XLSX, PPTX
- Gestructureerde/web formaten: JSON, HTML, CSV, plain text, Markdown
- Embedding: documenten worden opgedeeld in chunks, omgezet naar embeddings via een Gemini model en opgeslagen in pgvector voor semantisch zoeken.
Waarom dit is gekozen¶
- Het past bij de bestaande self-hosted stack.
- Het houdt de runtime overhead laag.
- Het ondersteunt Mermaid diagrammen en statische publicatie.
- Het vermijdt het toevoegen van een tweede zware documentatie-omgeving, aangezien de huidige stack al retrieval ondersteunt.
- Het ProcessorFactory patroon is eenvoudig uit te breiden voor nieuwe documentformaten zonder architectonische wijzigingen.
Resultaat voor Publieke Referentie¶
De publieke visualisaties linken nu naar een specifieke mkdocs-public.yml build onder /reference-nl/, zodat browsergebruikers op gerenderde HTML-pagina's landen in plaats van ruwe Markdown of interne governance routes.