WebRobot

Progettare un’app · Lezione 2

I dati: di chi è ogni record

Le pagine mostrano dati, gli agenti li leggono e li scrivono, i trigger reagiscono ai dati: quasi ogni regola di un’app è una regola sui dati. Due decisioni portano quasi tutto il peso: di chi sono i record di una collezione (ownedBy), e quali altri ruoli li raggiungono (access). Qui ne vedi l’effetto su sei persone, una cella alla volta.

Usa Avanti, oppure i tasti ← →. Puoi anche cambiare tu ownedBy e la regola degli avvocati: la matrice viene ricalcolata con la regola stessa del runtime, e il validatore controlla il risultato.

La regola, in quattro righe

  1. Gli admin raggiungono tutto. Chi ha il ruolo dato da admin_emails legge e scrive ogni record di ogni collezione.
  2. shared e app: tutti leggono. La scrittura resta agli admin (shared) o agli agenti dell’app tramite i loro strumenti (app).
  3. user e instance: il proprietario. La persona il cui id il runtime ha scritto sul record quando è stato creato.
  4. Poi le regole access. Un ruolo, un where facoltativo sui campi del record ({user.email}, {user.id} stanno per la persona), e can: read, oppure read e write. Nient’altro raggiunge un record.

I campi: di cosa è fatto un record

Ogni collezione dichiara i suoi campi. Il tipo decide l’input nel modulo, come il valore viene controllato e normalizzato, e come viene mostrato.

Su qualunque campo: required, default, help, visibleWhen (mostrato solo se un altro campo ha un valore), roles (lo vedono solo alcuni ruoli — come l’avvocato assegnato qui sopra, che imposta solo la titolare), gatedBy (sbloccato da un piano).

Le altre proprietà di una collezione

Ruoli che nascono dai dati

Un ruolo può derivare da un record: assignedBy: derived, from: collection:practices.manager_email. Chi ha la sua email in quel campo ha il ruolo, finché ci resta. Insieme a where, dà a ogni responsabile la propria sede, senza che nessuno distribuisca ruoli a mano.

Nomi che non puoi usare

users, login_tokens, sessions, credentials, runs, approvals, files e pochi altri sono dati del runtime. Un manifest non può mai dichiararli, mostrarli o darci uno strumento sopra: leggere login_tokens permetterebbe di prendere il controllo degli account.

Cosa portarsi a casa

Prossima lezione

La lezione 3 riguarda le pagine: come tabelle, schede, KPI e grafici mostrano questi record, e come una landing è fatta di blocchi.

Lezione 3: Le pagine, viste sui dati →

← Tutto il percorso