ADR-0022: Documentația și stiva RAG¶
Status: Acceptat Ultima actualizare: 2026-03-12
Rezumatul deciziei¶
Jorvis folosește o stivă (stack) de documentație construită în jurul:
- MkDocs pentru redarea (rendering) documentației
- Open WebUI + pgvector pentru RAG și interogări din chat
- Pipeline-ului ProcessorFactory pentru preluarea documentelor enterprise în indexul RAG
Surse suportate pentru import¶
- Conectori Cloud: Google Docs (read-only), Google Drive (read-only), Google Sheets (read-only)
- Documente de birou: PDF, DOCX, XLSX, PPTX
- Formate structurate/web: JSON, HTML, CSV, text simplu, Markdown
- Embedding: documentele sunt fragmentate, transformate în embedding-uri prin modelul Gemini și stocate în pgvector pentru căutare semantică
De ce a fost aleasă această soluție¶
- Se potrivește cu stiva tehnologică self-hosted existentă.
- Menține un consum scăzut de resurse la execuție (runtime overhead).
- Suportă diagrame Mermaid și publicare statică.
- Evită adăugarea unui mediu secundar complex pentru documentație, având în vedere că infrastructura actuală suportă deja funcții de căutare (retrieval).
- Modelul ProcessorFactory se extinde ușor pentru noi formate de documente, fără a necesita modificări de arhitectură.
Rezultat pentru Referințele Publice¶
Vizualizările publice conțin acum link-uri către un build dedicat mkdocs-public.yml sub /reference-ro/, astfel încât utilizatorii ajung direct la pagini HTML redate (rendered), în loc de formatul brut Markdown sau rute destinate proceselor interne.