ADR-0022: Dokumentation och RAG Stack¶
Status: Accepterad Senast Uppdaterad: 2026-03-12
Sammanfattning av Beslut¶
Jorvis använder en dokumentations-stack byggd kring:
- MkDocs för rendering av dokumentation
- Open WebUI + pgvector för RAG och hämtning i chatt
- ProcessorFactory pipeline för att importera enterprise-dokument till RAG-indexet
Stödda Importkällor¶
- Moln-kopplingar: Google Docs (endast-läs), Google Drive (endast-läs), Google Sheets (endast-läs)
- Kontorsdokument: PDF, DOCX, XLSX, PPTX
- Strukturerade/webbformat: JSON, HTML, CSV, ren text, Markdown
- Embedding: dokument delas upp i fragment (chunks), omvandlas till embeddings via en Gemini-modell och lagras i pgvector för semantisk sökning.
Varför Det Valdes¶
- Det passar in i den befintliga self-hosted stacken.
- Det håller runtime-overhead låg.
- Det stöder Mermaid-diagram och statisk publicering.
- Det undviker att lägga till en andra tung dokumentationsmiljö eftersom den nuvarande stacken redan stöder informationshämtning (retrieval).
- ProcessorFactory-mönstret kan enkelt utökas för nya dokumentformat utan arkitektoniska förändringar.
Resultat för Offentlig Referens¶
De offentliga visualiseringarna länkar nu till en dedikerad mkdocs-public.yml build under /reference-sv/, så att webbläsaranvändare landar på renderade HTML-sidor istället för rå Markdown eller interna styrningsvägar (governance routes).