// System Architecture & Data Flow Specification

Flusso Operativo & Topologia dei Nodi

Analisi ingegneristica dell'interazione real-time tra il Gatekeeper (Nodo A), il Resonator LLM (Nodo B) e il Background Telemetry Scheduler.

// topology_ascii_stream.sh
LIVE STATUS: ACTIVE
+-------------------------------------------------------------------------------------------------+
|                                 PERIFLOW SYSTEM DATA FLOW ARCHITECTURE                          |
+-------------------------------------------------------------------------------------------------+

  [ Web Browser / Client ]
         │
         │ HTTP Request /api/query
         ▼
  =========================================
  [ NODO A: GATEKEEPER (Raspberry Pi 5) ]
  - PostgreSQL 16 + B-Tree Relational Indexes
  - CIRA Closed-Interval Check (< 1ms)
  =========================================
         │
         ├───► [ CACHE HIT ]  (~72% Probability)
         │     └─► Risposta locale immediata in ~6.83 ms
         │         (Bypass GPU/Compute Worker, 0 token consumed, ~250W power saved)
         │
         └───► [ CACHE MISS ] (~28% Probability)
               └─► Inoltro HTTP POST asincrono verso il Resonator LLM
                     │
                     ▼
               ===========================================================
               [ NODO B: LLM RESONATOR (Apple Silicon Mac M1 / Ollama) ]
               - Esecuzione modello locale (phi3:mini / llama3)
               - Generazione risposta in ~11.2 s (~19.5W power consumed)
               ===========================================================
                     │
                     ▼
               Scrittura cache locale & Log telemetria spettrale

  =================================================================================================
  [ BACKGROUND WORKER / CRON DECOUPLED PIPELINE ]
  - Cron Job (* * * * * php artisan schedule:run) esegue telemetry:collect-node-a ogni 60s
  - Lettura kernel Linux (/sys/class/thermal, /proc/stat, /proc/meminfo)
  - Scrittura telemetria hardware disaccoppiata (Zero impatto sulla latenza delle richieste utente)
  =================================================================================================
      
// 01. GATEKEEPER (NODO A)

Filtro Sub-millisecondo

Il Raspberry Pi 5 ospita il database relazionale PostgreSQL 16. Grazie agli indici B-Tree compositi e all'algoritmo CIRA, ogni query viene validata istantaneamente prima di attivare qualsiasi calcolo pesante.

// 02. RESONATOR LLM (NODO B)

Compute Worker Locale

In caso di MISS, il Mac M1 esegue l'inferenza tramite Ollama (phi3:mini). La risposta viene restituita al client e persistita nella cache relazionale per azzerare i costi computazionali delle future richieste equivalenti.

// 03. BACKGROUND SCHEDULER

Telemetria Disaccoppiata

Il Cron scheduler di Laravel esegue ogni minuto il comando di raccolta telemetria hardware (telemetry:collect-node-a), monitorando temperatura SoC, clock e carichi di CPU senza impattare la latenza dell'utente.