WebRobot

Progettare un’app · Lezione 1

Descrivere un’app invece di programmarla: il manifest, passo dopo passo

Un manifest è un file che descrive un’app: chi la usa, quali dati tiene, quali pagine mostra, quali agenti lavorano, cosa succede da solo, dove deve decidere una persona, come si paga. Non contiene codice: un unico runtime lo legge e diventa quell’app. Qui ne progettiamo una piccola, ContractCheck, rispondendo in ordine a nove domande, ognuna delle quali aggiunge qualche entità a un grafo.

Usa Avanti, oppure i tasti ← →. A ogni passo il validatore vero della piattaforma controlla il manifest nel tuo browser; prova l’errore tipico per vedere la regola che fa rispettare.

Tre controlli, in quest’ordine

  1. Forma. Un JSON Schema: chiavi ammesse, tipi, valori da elenchi fissi. Un refuso in una parola chiave si ferma qui.
  2. Riferimenti e sicurezza. Ogni nome deve puntare a qualcosa che esiste, e valgono le regole che proteggono le persone: niente dati riservati, nessuno sconosciuto che approva, nessun agente che si riavvia da solo, nessun host fuori da egress.
  3. Qualità. Suggerimenti di progettazione che non bloccano la pubblicazione, come una collezione che qualcuno legge ma nessuno riempie.

Cosa portarsi a casa

Le entità che questo esempio non ha usato

ContractCheck usa le entità più comuni. Le altre seguono la stessa logica:

Prossima lezione

Da qui il percorso entra nel dettaglio di ogni area, partendo da quella da cui dipende ogni regola di sicurezza: i dati, e di chi è ogni record.

Lezione 2: I dati, di chi è ogni record →

← Tutto il percorso