ADR-0022: Dokumentacija i RAG Stack¶
Status: Prihvaćeno Posljednje ažuriranje: 2026-03-12
Sažetak Odluke¶
Jorvis koristi skup alata za dokumentaciju (stack) izgrađen oko:
- MkDocs za prikaz (rendering) dokumentacije
- Open WebUI + pgvector za RAG i dohvaćanje u chatu
- ProcessorFactory pipeline za uvoz korporativnih dokumenata u RAG indeks
Podržani Izvori za Uvoz¶
- Cloud konektori: Google Docs (samo za čitanje), Google Drive (samo za čitanje), Google Sheets (samo za čitanje)
- Uredski dokumenti: PDF, DOCX, XLSX, PPTX
- Strukturirani/Web formati: JSON, HTML, CSV, običan tekst, Markdown
- Ugrađivanje (Embedding): dokumenti se dijele na dijelove (chunks), pretvaraju u ugrađivanja putem Gemini modela i pohranjuju u pgvector za semantičko pretraživanje.
Zašto Je Ovo Odabrano¶
- Uklapa se u postojeći self-hosted stack.
- Zadržava niske režijske troškove okruženja za izvršavanje (runtime overhead).
- Podržava Mermaid dijagrame i statično objavljivanje.
- Izbjegava dodavanje drugog teškog okruženja za dokumentaciju jer trenutni stack već podržava dohvaćanje (retrieval) informacija.
- Obrazac ProcessorFactory lako se proširuje na nove formate dokumenata bez promjena arhitekture.
Rezultat za Javne Reference¶
Javne vizualizacije sada vode na dedicirani build mkdocs-public.yml na ruti /reference-hr/, tako da korisnici preglednika slijeću na prikazane HTML stranice umjesto na sirovi Markdown ili interne rute za upravljanje.