Definizione · perimetro web

Un ecosistema con confini leggibili.

Questa pagina definisce la porzione web: un portale statico, una directory eNET e un assistente K.I.R.A. basato su un backend separato. Gli altri repository restano progetti autonomi finché un contratto d’integrazione non dimostra il contrario.

Mappa dei ruoli

La porzione web in tre componenti.

Le chiamate AI passano dal browser al gateway HTTPS e da lì al provider configurato sul server. Le pagine non contengono credenziali.

01 · esperienza pubblica

x-zdos.it

Contenuto statico, orientamento e accesso ai repository. Nessuna sessione, account o persistenza utente.

02 · catalogo

eNET

Indice curato dei servizi e dei loro limiti. Non è una rete mesh e non attiva automaticamente i moduli elencati.

03 · servizio remoto

ZDOS-K.I.R.A.

Backend per health e generazione AI OpenAI-compatible. Richiede configurazione lato server, TLS, CORS e protezioni antiabuso.

Dipendenze esterne

Progetti collegati, non confusi.

ZDOS OS e ZLang

Repository distinti con ciclo di build e verifica propri. Non vengono eseguiti nel browser e non forniscono inferenza nativa attraverso questa chat.

ZComm

Servizio e sorgente separati. Questa directory non avvia conversazioni e non certifica cifratura o disponibilità.

ZDOS Web App

Applicazione distinta con server, OIDC e database. Nessun login o workspace è condiviso con il portale statico.

Token, wallet e scansioni

Fuori perimetro. Il sito non emette/custodisce DSN, non esegue transazioni e non avvia scansioni di sicurezza o comandi remoti.

Contratto minimo

Come si collega K.I.R.A.

Health: GET /health deve rispondere via HTTPS. Il campo inferenceConfigured segnala la configurazione lato server, non l’esito di un’inferenza.

Generazione: POST /api/v1/zllm/generate riceve un prompt testuale, limitato a 8000 caratteri. Il backend chiama il provider; la chiave ZLLM_API_KEY resta nell’ambiente server.

Configurazione del browser: l’origine si imposta nel meta zdos-kira-api-base. Il valore vuoto disabilita la chat; il sito non usa endpoint HTTP remoto né invia prompt senza una base sicura.