Αυτοφιλοξενία

Το Node και ένας κατάλογος με δικαίωμα εγγραφής είναι η μόνη απαίτηση. Οι δηλώσεις παρακάτω διαβάστηκαν από τα αρχεία που αναφέρονται δίπλα τους· ό,τι δεν μπορούσε να επιβεβαιωθεί δεν βρίσκεται εδώ.

Σημεία εισόδου

• Το package.json απαιτεί Node >= 22.5. Η αποθήκη SQLite είναι το δικό του module node:sqlite του Node.
• Δεν υπάρχει καθόλου λίστα εξαρτήσεων: εφαρμογές, πακέτα, σενάρια και δοκιμές εκτελούνται στην τυπική βιβλιοθήκη του Node, και το Dockerfile δεν εγκαθιστά τίποτα.
• Υπάρχουν τρεις διεργασίες· καθεμία ανοίγει τη βάση δεδομένων και εκτελεί τη μετανάστευση κατά την εκκίνηση.

node apps/web/server/main.mjs                   # hub + console + embedded API
API_EMBED=false node apps/api/src/main.mjs    # API only, no pages
node apps/worker/src/run.mjs                  # probes, latency, rollup, housekeeping

Αποθήκη δεδομένων

Το DATABASE_URL=sqlite:./data/llmeu.db δεν χρειάζεται διακομιστή, και ο κατάλογος και το αρχείο δημιουργούνται στο πρώτο άνοιγμα. Η λαβή εκτελείται σε λειτουργία WAL με ενεργοποιημένα ξένα κλειδιά και χρονικό όριο απασχόλησης 5 s.

Το packages/shared/src/db/schema.sql είναι το σχήμα. Είναι μόνο για δημιουργία και idempotent, οπότε η εκ νέου εκτέλεσή του είναι ασφαλής· μια στήλη που προστίθεται σε υπάρχοντα πίνακα πρέπει επίσης να δηλώνεται στο πρόσθετο βήμα στο packages/shared/src/db/index.mjs.

CLI χειριστή

Το node scripts/db.mjs διαβάζει το DATABASE_URL και δεν χρειάζεται υπηρεσίες. Εντολές:

Περιβάλλον

Ομαδοποιημένα όπως τα ομαδοποιεί το .env.example.

Docker

Το Compose και η εικόνα είναι προαιρετικά: η ίδια η σουίτα του αποθετηρίου δεν απαιτεί Docker, και η κύρια διαδρομή είναι μια τοπική διεργασία χωρίς υπηρεσίες.

• Το προεπιλεγμένο προφίλ εκτελεί το web: θύρες 3000 και 8088, SQLite στον τόμο llmeu-data στο /app/data, το ενσωματωμένο API, και έναν έλεγχο υγείας στο /healthz.
• Η ίδια εικόνα εκτελεί τον worker με node apps/worker/src/run.mjs, περιμένοντας το web να γίνει υγιές και μοιράζεται τον τόμο llmeu-data.
• Δύο επιπλέον προφίλ είναι απενεργοποιημένα από προεπιλογή: postgres (postgres:16-alpine) και redis (redis:7-alpine, δεσμευμένο και δεν διαβάζεται από τη διαδρομή κώδικα v1).
• Το προφίλ gpu εκτελεί το vllm/vllm-openai με δέσμευση συσκευής NVIDIA και προσαρτά βάρη μόνο για ανάγνωση από τον κεντρικό υπολογιστή· δεν είναι ενεργοποιημένο από προεπιλογή, επειδή το να ισχυριστεί κανείς συμπεράσματα ΕΕ χωρίς GPU θα ήταν ψευδές.
• Το Dockerfile είναι FROM node:24-alpine με tini, χωρίς βήμα build και χωρίς εγκατάσταση εξαρτήσεων, εκτελείται ως χρήστης node, γράφει μόνο κάτω από το /app/data, εκθέτει τις 3000 και 8088, και ξεκινά το apps/web/server/main.mjs.

Αντίγραφα ασφαλείας

Το node scripts/backup.mjs χωρίς σημαίες γράφει ./backups/llmeu-<stamp>.db. Το SQLite αντιγράφεται με VACUUM INTO, ποτέ με cp, επειδή μια ζωντανή βάση δεδομένων WAL που αντιγράφεται με cp μπορεί να δώσει σκισμένη ή παρωχημένη κατάσταση.

node scripts/backup.mjs                                  # ./backups/llmeu-<stamp>.db
node scripts/backup.mjs --out /srv/backups/              # explicit destination
node scripts/backup.mjs --verify ./backups/llmeu-<stamp>.db
node scripts/backup.mjs --restore ./backups/llmeu-<stamp>.db --yes
node scripts/backup.mjs --list

Κάθε αντίγραφο ασφαλείας SQLite επαληθεύεται πριν το script αναφέρει επιτυχία: επαναφέρεται σε προσωρινό αντίγραφο, το PRAGMA integrity_check πρέπει να επιστρέψει ok, το σχήμα επανεφαρμόζεται και εκτυπώνονται οι μετρήσεις γραμμών για models, organizations και users.

Με URL postgres://, το script χρησιμοποιεί pg_dump --format=custom και χρειάζεται το pg_dump στο PATH· ένα dump δεν μπορεί να ανοίξει ως βάση δεδομένων, οπότε οι μετρήσεις γραμμών του χρειάζονται δοκιμαστική επαναφορά.

Αλληλογραφία

Η συναλλακτική αλληλογραφία — επαναφορά κωδικού, επαλήθευση διεύθυνσης, προσκλήσεις — χρησιμοποιεί MAIL_SMTP_* ή MAIL_API_URL με MAIL_FROM. Το κανάλι μεταφοράς επιλέγεται μία φορά κατά την εκκίνηση και αναφέρεται σε κάθε σελίδα που χρειάζεται αλληλογραφία.

Μια ανάπτυξη χωρίς κανένα από τα δύο είναι υποστηριζόμενη κατάσταση: εγγραφή, σύνδεση, αλλαγή κωδικού, ομάδες και προσκλήσεις λειτουργούν, αλλά η αλληλογραφία επαναφοράς κωδικού και επαλήθευσης δεν μπορεί να επεξεργαστεί εκεί. Οι σελίδες το δηλώνουν, και το node scripts/db.mjs passwd <email> είναι η οδός ανάκτησης.

Backends συμπερασματολογίας

Μια γραμμή endpoint ονομάζει ένα runtime και μια περιοχή, και το μητρώο backend επιλέγει τον προσαρμογέα ανά περιοχή, επομένως ένα endpoint μπορεί να απαντηθεί μόνο από μηχάνημα στην περιοχή που ονομάζει.

• Το INFERENCE_MOCK=true διατηρεί το ντετερμινιστικό mock backend, το οποίο δεν χρειάζεται GPU ούτε βάρη.
• Το GPU_ENABLED=false κρατά έξω τα διαχειριζόμενα backends· με GPU_ENABLED=true, το VLLM_BASE_URL ισχύει για τη μοναδική περιοχή που ονομάζει το VLLM_REGION.
• Μια ανάπτυξη με πολλές περιοχές ορίζει μία μεταβλητή ανά περιοχή, με όνομα από το slug της περιοχής (για παράδειγμα VLLM_BASE_URL_DE_FRA). Ένα endpoint σε περιοχή χωρίς διαμορφωμένο backend απορρίπτεται, αντί να εξυπηρετηθεί από μηχάνημα σε άλλη περιοχή.
• Τα partner backends προέρχονται από το PARTNER_BASE_URL_<REGION> και παίρνουν PARTNER_SOVEREIGNTY και PARTNER_API_KEY· ο διακομιστής επιτρέπει τη χρήση συνεργάτη όταν έχει οριστεί το PARTNER_BASE_URL.