Mappe Mappa funzionale Mappa tecnica Storia delle decisioni Documentazione viva · mappa tecnica
Come è costruita LIA , livello per livello I livelli del sistema, dallo schermo al database, cosa fa ogni blocco, con quali tecnologie, dove vive nel repository, e i percorsi che segue una richiesta.
59 blocchi tecnici 10 livelli 7 percorsi commentati 57 moduli di infrastruttura 63 domini di business serviti Versione 4.6.0 10 novembre 2026 aggiornata a ogni commit, dai dati del repository
Panoramica
I livelli del sistema Dallo schermo al database. Passa sopra un blocco per tracciarne i legami, clicca per le sue tecnologie, i suoi file e le sue decisioni.
Client Ciò che la persona tocca: l'applicazione web, la sua modalità offline, i gusci per mobile e i canali di messaggistica.
Applicazione web PWA e offline Gusci per mobile Canali di messaggistica Rig e volume dei compagni nativi Perimetro Ciò che sta tra Internet e l'applicazione: tunnel, politica dei contenuti, rate limiting, sessioni.
Tunnel, CSP e rate limiting Sessioni e autenticazione API e base applicativa L'API FastAPI suddivisa in domini di business, il suo flusso SSE, il suo avvio ordinato e la sua configurazione.
API FastAPI per domini Streaming SSE Avvio ordinato Configurazione e interruttori Sei lingue Mondo isometrico e autorità nativa Orchestrazione degli agenti Il grafo LangGraph: instradamento, pianificazione o ciclo ReAct, validazione umana, strumenti e risposta.
Grafo LangGraph Router Pianificatore ed esecutore Ciclo ReAct Sintesi della risposta Validazione e bozze Strumenti e manifest Registro dati e contesto Prompt versionati Nodo di iniziativa Comandi applicativi durevoli Modelli e costi L'accesso ai modelli di ogni fornitore, il ragionamento, gli output strutturati, gli embedding, e la contabilità di ogni chiamata.
Factory dei modelli Ragionamento Catalogo dei modelli Output strutturati Embedding e ricerca Contabilità e tetti di spesa Integrazioni I client dei servizi esterni, i protocolli aperti, la sandbox e i canali vocali.
Client dei connettori Client MCP Competenze e plugin Sandbox e proxy di uscita Browser pilotato Voce: trascrizione e sintesi Trasporti Live Telefonia Notifiche push Avatar: sessione e riproduzione Acquisizione dal telefono Job in background Ciò che gira senza richieste: scheduler a leader unico, motore proattivo, job durevoli, autodiagnosi.
Scheduler a leader unico Motore proattivo Job durevoli Autodiagnosi Radio: redazione e antenna Dati Dove vive lo stato: PostgreSQL e pgvector, Redis, file, e i registri di ciò che LIA ha fatto, letto e deciso.
PostgreSQL e pgvector Redis File Registri tracciabili Osservabilità Misurare, vedere, allertare, rileggere: metriche, dashboard, allarmi, log, tracce.
Metriche Dashboard Allarmi Log Tracce Consegna Come il codice diventa un servizio: immagini, integrazione continua e le sue guardie, release qualificata, installer, demo.
Immagini e composizione Integrazione continua e guardie Release, deployment e installer Demo pubblica PercorsiScegli uno scenario: i suoi passi si accendono uno a uno sulla mappa.
Il percorso di un messaggio di chat Una chiamata al modello, da cima a fondo Un job proattivo in background Una sessione Live delegata Dal commit alla produzione Vedere, allertare, diagnosticarsi Eseguire un comando applicativo LivelliClicca un livello per isolarlo.
Client5 Perimetro2 API e base applicativa6 Orchestrazione degli agenti11 Modelli e costi6 Integrazioni11 Job in background5 Dati4 Osservabilità5 Consegna4 I percorsi
Il percorso di una richiesta, di una chiamata, di una consegna Ogni passo nomina il blocco che agisce e ciò che garantisce.
Il percorso di un messaggio di chatDalla tastiera allo schermo, passando per il grafo: una richiesta, un flusso, nessun token esposto.
1 2 3 4 5 Grafo LangGraphLo stato della conversazione viene ricaricato dal suo checkpoint.
6 RouterLa richiesta viene classificata, gli strumenti valutati.
7 8 9 10 11 Streaming SSEArriva parola per parola, con il suo costo, sullo stesso flusso.
Riproduci sulla mappa Una chiamata al modello, da cima a fondoLimitata prima, tradotta per il fornitore, tariffata al suo istante, tracciata dopo.
1 Prompt versionatiIl prompt viene assemblato: prima la parte stabile, un solo confine di cache.
2 3 RagionamentoL'intenzione di ragionamento viene tradotta per quel modello preciso.
4 5 6 7 8 MetricheToken, latenza e costo diventano metriche.
Riproduci sulla mappa Un job proattivo in backgroundUn solo leader, un jitter, una rivendicazione, un invio liquidato in base al suo risultato.
1 2 3 4 5 6 7 Riproduci sulla mappa Una sessione Live delegataIl percorso delegato: il browser parla con il fornitore e ogni richiesta torna al grafo.
1 2 Trasporti LiveL'API emette un identificativo monouso e compone il mandato della voce.
3 Trasporti LiveIl browser apre il trasporto del fornitore (WebSocket o WebRTC).
4 5 Grafo LangGraphIl grafo la esegue con le sue validazioni e i suoi registri.
6 Trasporti LiveLa risposta, limitata e appiattita, viene restituita alla voce.
7 Job durevoliAlla fine, un'unica chiusura archivia, quantifica e inoltra.
Riproduci sulla mappa Dal commit alla produzioneOgni guardia gira prima del push; nulla viene pubblicato senza qualifica.
1 2 3 4 5 6 7 Riproduci sulla mappa Vedere, allertare, diagnosticarsiOgni segnale ha un lettore; un allarme ha un runbook; LIA legge le proprie prove.
1 MetricheI processi pubblicano le loro metriche, memoria compresa.
2 LogI log strutturati, senza dati personali, arrivano a Loki.
3 4 AllarmiUn allarme parte con il suo runbook.
5 AutodiagnosiLIA raccoglie le prove dell'incidente e lo diagnostica.
Riproduci sulla mappa Eseguire un comando applicativoIdentità durevole e precondizioni attuali; una prosecuzione aperta resta in attesa.
1 Applicazione webIl client usa il catalogo di operazioni offerto a questo account.
2 3 4 Validazione e bozzeIl gate degli effetti verifica l'approvazione esatta quando l'operazione la richiede.
5 Comandi applicativi durevoliL'esecuzione rilegge permessi e capacità; claim vincolato da token e compare-and-set del servizio sorgente proteggono le rispettive frontiere.
6 Sessioni e autenticazioneUna prosecuzione privata è legata alla sessione e, se necessario, al dispositivo destinatario; i segreti restano fuori dal modello.
7 Comandi applicativi durevoliCommitted, waiting, conflitto, errore e annullamento restano distinti; una risposta persa non viene rieseguita automaticamente.
8 Applicazione webUn segnale indirizzato invalida le risorse interessate; il client rilegge le relative query autenticate.
Riproduci sulla mappa