Vai al contenuto
Leo
Manuale · piattaforma

La piattaforma Suite

Leo Suite non lancia i programmi: li fa parlare. Un progetto espone ciò che sa fare, un altro lo usa. Qui vedi come si dichiara e come un sistema intero prende forma senza colla scritta a mano.

Il principio: espone / usa

Ogni progetto Leo ha un file progetto.toml. Lì dichiari due cose:

  • espone — ciò che il tuo progetto mette a disposizione degli altri (una tabella, un servizio, un'azione…).
  • usa — ciò che prendi da un altro progetto, dandogli un nome locale.
# progetto "magazzino" (Leo Dati) — ESPONE
[[espone]]
tipo = "dato/tabella"
nome = "prodotti"
descrizione = "Il catalogo con prezzi e scorte"

# progetto "sito" (Leo Web) — USA
[[usa]]
progetto    = "magazzino"
interfaccia = "prodotti"
come        = "catalogo"

Da quel momento, nel codice del sito, catalogo è già pronto: la piattaforma genera il collegamento (un importa del ponte) e controlla che i tipi combacino prima di eseguire.

I tipi di interfaccia

Il vocabolario è tipizzato, così un errore si vede subito:

  • dato/ — tabella, dataset, query, valore.
  • servizio/ + eventi — sito, endpoint, trigger, azione, flusso.
  • hardware/ — lettura, comando.

Chi espone cosa

Ogni edizione ha un ruolo naturale nell'interconnessione:

  • Leo Dati è il perno: espone le tabelle, lo stato che dura.
  • Leo Web espone siti ed endpoint, e usa i dati.
  • Leo Sistema espone trigger e azioni, e usa tutto: è l'attuatore.
  • Leo Robotica espone letture e comandi della scheda, e usa Dati e Sistema.
  • Leo Sicurezza osserva, in sola lettura.
  • Leo Giochi usa, ad esempio, le classifiche.
  • Leo Suite contiene tutto: è la casa dove questi collegamenti vivono.

Un esempio end-to-end

Un piccolo negozio, costruito con tre edizioni che si parlano:

D
Leo Dati tiene il magazzino
espone dato/tabella "prodotti"
↓
W
Leo Web mostra il catalogo e raccoglie gli ordini
usa "magazzino" come catalogo
↓
S
Leo Sistema a ogni ordine aggiorna le scorte
espone azione "aggiorna"

Nessun pezzo conosce gli altri nel dettaglio: ognuno dichiara la sua interfaccia, la Suite li tiene insieme. Cambi un'edizione e il resto continua a funzionare, finché l'interfaccia resta la stessa.