ADR-0022: Документация и RAG Stack¶
Статус: Прието Последна актуализация: 2026-03-12
Резюме на Решението¶
Jorvis използва документационен стек (stack), изграден около:
- MkDocs за рендиране на документацията
- Open WebUI + pgvector за RAG и извличане в чата
- Pipeline на ProcessorFactory за импортиране на корпоративни документи в RAG индекса
Поддържани Източници за Импорт¶
- Клауд конектори: Google Docs (само за четене), Google Drive (само за четене), Google Sheets (само за четене)
- Офис документи: PDF, DOCX, XLSX, PPTX
- Структурирани/уеб формати: JSON, HTML, CSV, обикновен текст, Markdown
- Embedding: документите се разделят на фрагменти (chunks), преобразуват се в embedding-и чрез модел Gemini и се съхраняват в pgvector за семантично търсене.
Защо бе избрано това¶
- Пасва на съществуващия self-hosted стек.
- Поддържа ниска режийни разходи по време на изпълнение (runtime overhead).
- Поддържа диаграми Mermaid и статично публикуване.
- Избягва добавянето на втора тежка среда за документация, тъй като настоящият стек вече поддържа извличане на информация (retrieval).
- Моделът ProcessorFactory се разширява лесно за нови формати на документи без архитектурни промени.
Резултат за Публичната Справка¶
Публичните визуализации вече препращат към специален билд на mkdocs-public.yml под директорията /reference-bg/, така че потребителите в браузъра да попадат на рендирани HTML страници вместо на суров Markdown или вътрешни маршрути за управление.