Τεχνικές Προδιαγραφές, Πρόσθετα & Αρχιτεκτονική Πυρήνα

Απαράβατοι Κανόνες Συστήματος (Invariants 5.A – 5.J)

1. Τριπλό Όριο Απομόνωσης (Tri-Boundary Demarcation)

SYSTEM_INVARIANT

Αυστηρός μαθηματικός διαχωρισμός ταυτότητας: organization_id (Tenant) ≠ installation_id (Deployment) ≠ node_id (Compute Node). Αποτρέπει κάθε διαρροή δεδομένων σε επίπεδο εγγραφών PostgreSQL, διανυσμάτων Qdrant και μνήμης ReAct prompts.

┌────────────────────────────────────────────────────────┐ │ MATHEMATICAL IDENTITY DEMARCATION │ ├────────────────────────────────────────────────────────┤ │ organization_id (Tenant Boundary / RDBMS & Vectors) │ │ ≠ installation_id (Air-Gapped Deployment UUID) │ │ ≠ node_id (Execution Compute Socket / IP) │ └────────────────────────────────────────────────────────┘

2. Υβριδικός Βρόχος ReAct Δύο Φάσεων (Hybrid ReAct Loop)

AI_INVARIANT

Απόλυτος διαχωρισμός μεταξύ Phase 1 (Περιορισμένη εκτέλεση εργαλείων με fast_model <= 256 tokens και JSON Schema επικύρωση) και Phase 2 (Καθαρή σύνθεση φυσικής γλώσσας). Μηδενική διαρροή τεχνικών JSON tokens στον τελικό πελάτη.

[PROMPT] ──► [PHASE 1: Tool Selection (think: false, fast_model)] │ ├──► Schema Validation (Draft 2020-12) └──► PolicyEngine Authorization (4-Gate) │ ▼ [SYNTHESIS] ◄── [PHASE 2: Clean Natural Stream (Zero JSON Leaks)]

3. Μηχανή Pure Qdrant REST & FAQ Fast Path

DATA_INVARIANT

Αποκλειστική χρήση Qdrant REST (:6333) με Int8 Scalar Quantization και UTF-8 chunking (mb_strlen). Ενσωματωμένο FAQ Fast Path (<100ms) που παρακάμπτει το LLM για ερωτήσεις με Cosine Distance <= 0.15.

User Query ──► nomic-embed-text (768d) ──► Qdrant REST (:6333) │ ├──► Cosine Dist <= 0.15 AND doc_type == 'faq' │ └──► [FAST PATH: Direct Hit < 100ms] │ └──► Deep RAG: mb_strlen 512 chunks + 60 overlap

4. Κρυπτογραφία Ed25519 & C Zend Extension

SECURITY_INVARIANT

Ασύμμετρη επικύρωση αδειών Ed25519 (Libsodium) για λειτουργία σε Air-Gapped περιβάλλοντα. Προστασία πηγαίου κώδικα μέσω του εγγενούς C extension helios_guard.so με αποκρυπτογράφηση ChaCha20-Poly1305 απευθείας στη RAM.

Encrypted PHP File (.php) ──► zend_compile_file() Hook │ ▼ [helios_guard.so] ──► ChaCha20-Poly1305 Decrypt in RAM │ ▼ OPcache Bytecode Memory ──► Zero Plain-Text on Physical Disk!

5. Ατομικοί Σηματοφορείς Redis & Ασύγχρονοι Workers

CONCURRENCY

Διαχείριση ταυτοχρονίας daemons και workers με SET key 1 NX EX ttl. Πλήρης εξάλειψη των HTTP 504 Timeouts μέσω του μοντέλου ασύγχρονων CLI workers με cache polling (1.5s interval).

Client Web Request ──► Spawns Async CLI Worker (php spark helios:*) │ (session_write_close() avoids session locks) ▼ Redis Atomic Mutex: "helios:{domain}:{category}:{orgId}:{id}" Redis Key Polling : 1.5s interval ──► Zero HTTP 504 Timeouts!

6. Distributed Runtime Profiles & Topologies

FLEET_CONVERGENCE

Πλήρης υποστήριξη προφίλ STANDALONE, CONTROL_PLANE και NODE σε τοπολογίες CONNECTED, SEMI_ISOLATED και AIR_GAPPED με 100% εξερχόμενα heartbeats (Outbound Pull-Only).

CONTROL PLANE ◄────────── Pull-Based Polling ────────── NODES (Global Release Hub) (IPv4 CURL_IPRESOLVE_V4) (Zero Inbound Ports) │ ├──► CONNECTED : Real-time telemetry & OTA Symlinks ├──► SEMI-ISOLATED: Scheduled VPC synchronization └──► AIR-GAPPED : Detached Ed25519 bundles (.helios-bundle)

Αλυσίδα Ασφαλείας 4 Επιπέδων (4-Gate Formula)

Κάθε ενέργεια στο σύστημα (UI views, API endpoints, AI tool execution) υπολογίζεται μέσω της αυστηρής μαθηματικής συνάρτησης τομής 4 πυλών:

Effective Access = Gate_0 (Shield) ∧ Gate_1 (License) ∧ Gate_2 (Tenant Role) ∧ Gate_3 (Profile Tool)