ADR-0022: Τεκμηρίωση και Στοίβα RAG¶
Κατάσταση: Εγκρίθηκε Τελευταία Ενημέρωση: 2026-03-12
Περίληψη Απόφασης¶
Το Jorvis χρησιμοποιεί μια στοίβα (stack) τεκμηρίωσης κατασκευασμένη γύρω από:
- MkDocs για την απόδοση (rendering) της τεκμηρίωσης
- Open WebUI + pgvector για το RAG και την ανάκτηση πληροφοριών στο chat
- Pipeline ProcessorFactory για την εισαγωγή εταιρικών εγγράφων στο ευρετήριο RAG
Υποστηριζόμενες Πηγές Εισαγωγής¶
- Συνδέσεις Cloud: Google Docs (μόνο για ανάγνωση), Google Drive (μόνο για ανάγνωση), Google Sheets (μόνο για ανάγνωση)
- Έγγραφα γραφείου: PDF, DOCX, XLSX, PPTX
- Δομημένες μορφές/Web: JSON, HTML, CSV, απλό κείμενο, Markdown
- Embedding: τα έγγραφα χωρίζονται σε τμήματα (chunks), μετατρέπονται σε embeddings μέσω ενός μοντέλου Gemini και αποθηκεύονται στο pgvector για σημασιολογική αναζήτηση.
Γιατί Επιλέχθηκε¶
- Ταιριάζει με την υπάρχουσα αυτο-φιλοξενούμενη (self-hosted) στοίβα.
- Διατηρεί τον φόρτο χρόνου εκτέλεσης (runtime overhead) σε χαμηλά επίπεδα.
- Υποστηρίζει διαγράμματα Mermaid και στατική δημοσίευση.
- Αποφεύγει την προσθήκη ενός δεύτερου βαρύ περιβάλλοντος τεκμηρίωσης, δεδομένου ότι η τρέχουσα στοίβα υποστηρίζει ήδη την ανάκτηση (retrieval) πληροφοριών.
- Το μοτίβο ProcessorFactory επεκτείνεται εύκολα για νέες μορφές εγγράφων χωρίς αρχιτεκτονικές αλλαγές.
Αποτέλεσμα Δημόσιας Αναφοράς¶
Οι δημόσιες οπτικοποιήσεις πλέον παραπέμπουν σε μια αποκλειστική έκδοση mkdocs-public.yml στη διεύθυνση /reference-el/, ώστε οι χρήστες του προγράμματος περιήγησης να προσγειώνονται σε αποδοσμένες σελίδες HTML, αντί για ακατέργαστο Markdown ή εσωτερικές διαδρομές διακυβέρνησης.