ADR-0022: Dokümantasyon ve RAG Yığını¶
Durum: Kabul Edildi Son Güncelleme: 2026-03-12
Karar Özeti¶
Jorvis, şunlar etrafında oluşturulmuş bir dokümantasyon yığını kullanır:
- Dokümantasyon oluşturma (rendering) için MkDocs
- RAG ve sohbet alımı için Open WebUI + pgvector
- Kurumsal belgeleri RAG indeksine almak için ProcessorFactory hattı
Desteklenen İçe Aktarma Kaynakları¶
- Bulut bağlayıcıları: Google Docs (salt okunur), Google Drive (salt okunur), Google Sheets (salt okunur)
- Ofis belgeleri: PDF, DOCX, XLSX, PPTX
- Yapılandırılmış/web formatları: JSON, HTML, CSV, düz metin, Markdown
- Yerleştirme (Embedding): belgeler parçalara ayrılır, bir Gemini yerleştirme modeli ile yerleştirmelere dönüştürülür ve anlamsal arama için pgvector'da saklanır
Neden Seçildi¶
- Mevcut kendi barındırılan (self-hosted) yığına uyar.
- Çalışma zamanı ek yükünü (runtime overhead) düşük tutar.
- Mermaid diyagramlarını ve statik yayınlamayı destekler.
- Mevcut yığın zaten bilgi alımını (retrieval) desteklediğinde ikinci bir ağır dokümantasyon ortamı eklemekten kaçınır.
- ProcessorFactory modeli, mimari değişiklikler olmadan yeni belge formatları için temiz bir şekilde genişler.
Genel Referans Sonucu¶
Herkese açık görseller artık /reference-tr/ altında özel bir mkdocs-public.yml derlemesine bağlantı veriyor, böylece tarayıcı kullanıcıları ham Markdown veya dahili yönetişim rotaları yerine oluşturulmuş HTML sayfalarına iniyor.