AccediPrenota un briefing

Capitolo 2.23

Pacchetti di dominio

Di cosa è composto un pacchetto di dominio e cosa indica il suo file pack.json; le viste e il registro delle viste; i modelli di conoscenza, i connettori e gli overlay mobili; come un pacchetto viene concesso in licenza e attivato per un'unità; e i dieci pacchetti forniti da Adverant.

Questa pagina è stata tradotta dall'IA a partire dall'originale in inglese. In caso di dubbi, fa fede la pagina in inglese. Legga questa pagina in inglese

19 minuti di lettura

Il pacchetto che ho creato presso Corrán Orbital è nato come due plugin e una dozzina di competenze dello Skills Engine utilizzate solo dal nostro team della stazione di terra. Quando l'unità operativa di missione ha chiesto la stessa cosa, mi sono trovato di fronte a una scelta: copiare tutto e mantenere due versioni di ogni elemento, oppure trasformarlo in un pacchetto di dominio con un unico modello di conoscenza e due lenti, attivabili per singola unità. Mi ci è voluta una settimana per trasformarlo in un pacchetto. Rifarei la stessa scelta domani e, la prossima volta, partirei direttamente dal pacchetto.

Un pacchetto di dominio porta in Nexus il modo di lavorare di uno specifico settore. Contiene le tipologie di entità del settore e il modo in cui si collegano, oltre a ciò che ogni ruolo vede. Include i modelli e i flussi di lavoro che le persone usano ogni giorno, le prove richieste dalle normative del settore e le schermate che funzionano su un telefono anche in assenza di segnale. Non modifica mai la shell o i suoi componenti, e mai le regole di scrittura. Un nuovo settore è un pacchetto, non un'app.

Di cosa è composto un pacchetto

Sotto la superficie, un pacchetto è composto da quattro elementi, e nessuno di essi è codice specifico del pacchetto nella piattaforma:

  1. Un bundle di gruppi di funzionalità nel controllo delle abilitazioni. I controlli del pacchetto appartengono a un insieme di gruppi di funzionalità. Ogni riga di menu e scheda di pannello aggiunta dal pacchetto viene quindi gestita dallo stesso meccanismo del resto di Nexus: abilitata, mostrata come anteprima (teaser) o nascosta.
  2. Un manifesto del pacchetto, pack.json, che dichiara i cluster di schermate del pacchetto e il suo vocabolario, le sue lenti e le sue schermate per telefono.
  3. Moduli chiusi che verificano autonomamente la propria concessione. Il codice server che prende le decisioni, come i cervelli compilati di un pacchetto, include al suo interno il verificatore di licenza e controlla autonomamente la licenza firmata. Nulla all'esterno del modulo può attivarlo.
  4. Una voce di catalogo, affinché il pacchetto appaia nella pagina Pacchetti di dominio con ciò che offre e ciò di cui ha bisogno.

Sopra questi elementi si trovano le parti visibili agli utenti: il modello di conoscenza e le lenti; i modelli, i flussi di lavoro e le competenze dello Skills Engine; i connettori di sola lettura verso i sistemi che già detengono i record, una mappa delle prove che collega ogni regola ai record che vi rispondono e un overlay mobile.

Pacchetti di dominio
Pacchetti di dominio
La pagina Pacchetti di dominio elenca tutti i dieci pacchetti con i requisiti di ciascuno e dove viene eseguito. Solo Adverant concede un pacchetto; lei decide in quali unità eseguirlo.

Il file pack.json

Ecco il manifesto del pacchetto Servizi bancari e pagamenti, ridotto a una lente con una postazione e due termini. Il suo ID file è fintech e name contiene il nome di lavoro del pacchetto; la console e il catalogo lo mostrano come Servizi bancari e pagamenti.

{
  "id": "fintech",
  "name": "Financial services",
  "version": "0.1",
  "inherits": "insurance",
  "screenCount": 10,
  "clusters": [
    {
      "id": "FL01",
      "kind": "lens",
      "name": "Lending decisions",
      "seats": "Credit analysts, underwriters of loans, credit committee",
      "purpose": "Whether to lend, how much, at what price, and writing down why.",
      "lexicon": ["fin"],
      "menu": [],
      "screens": [
        { "id": "FL01-A01", "title": "Credit desk today", "who": "Omar Haddad, credit analyst", "doing": "Seeing which applications are waiting and which rule held each one" },
        { "id": "FL01-A04", "title": "Refer to credit committee", "who": "Omar Haddad, credit analyst", "doing": "Sending a loan above his mandate to two people who can decide it" }
      ]
    }
  ],
  "lexicon": {
    "core": [],
    "fin": [
      ["affordability", "whether someone can pay it back without hardship", ""],
      ["mandate", "the most one person may lend alone", ""]
    ]
  },
  "world": {
    "tenants": [
      {
        "id": "larchmont",
        "name": "Larchmont Bank",
        "kind": "bank",
        "market": "GB",
        "locale": "en-GB",
        "people": 212,
        "plan": { "areas": ["H", "C", "E", "B", "X", "FL01", "FL02", "FL03"], "of": 12 },
        "ai": { "onDevice": "allowed", "personalDataToCloudModels": "uk-only", "sealRequiresUno": true }
      }
    ],
    "seats": [
      {
        "id": "credit-analyst",
        "person": "Omar Haddad",
        "tenant": "larchmont",
        "title": "Credit analyst",
        "lens": "FL01",
        "clusters": ["C", "E", "B", "X"],
        "home": "FL01-A01",
        "posture": "desk"
      }
    ]
  }
}

I campi, dall'alto verso il basso:

Campo Cosa indica
id L'ID del pacchetto, in minuscolo
name Il suo nome di lavoro
version La versione specifica del pacchetto
inherits Il pacchetto su cui questo si basa. Servizi bancari e pagamenti eredita da Assicurazioni, che contiene i cluster condivisi utilizzati da ogni pacchetto, come la conversazione e le impostazioni. Un nuovo pacchetto aggiunge le proprie lenti e lascia i cluster condivisi al pacchetto da cui eredita
screenCount Quante schermate definisce il pacchetto
clusters[] I gruppi di schermate del pacchetto. Ciascuno ha un id, un kind, un name, il seats a cui è destinato, il suo purpose, i set lexicon da cui provengono i suoi termini, i suoi menu e i suoi screens, ciascuno con un id, un title, who e per cosa sono doing
clusters[].kind shared per un cluster raggiungibile da ogni lente (ad esempio, la conversazione); lens per le schermate proprie di un singolo ruolo. L'elemento scope di un cluster indica se appartiene al core (core) o al settore (domain)
lexicon I termini del pacchetto, in set denominati. Ogni termine ha una glossa chiara che un nuovo arrivato può leggere, e il terzo slot è exact per un termine che deve essere usato parola per parola, come un dato normativo
world Il mondo di esempio di tenant e postazioni fittizi che le schermate e i test del pacchetto utilizzano, e i suoi rami di dati
world.tenants[].plan L'elemento areas del piano: i cluster e le lenti che il piano di questo tenant apre, su of
world.tenants[].ai La policy di IA (intelligenza artificiale) dell'organizzazione per il pacchetto: se i modelli sul dispositivo sono consentiti (onDevice), dove i dati personali possono essere inviati a un modello cloud (personalDataToCloudModels, come uk-only o eu-only) e se la sigillatura di un record richiede l'invio a UNO (sealRequiresUno)
world.seats[] La postazione di una persona: il suo title, la lens che detiene, i clusters condivisi che può inoltre raggiungere, la sua schermata home, il suo posture (desk, field o consumer) e, nel file completo, le sue authority, ovvero i limiti entro i quali agisce

Due regole stabiliscono cosa può contenere un file pack.json. Una normativa è indicata con parole semplici e una glossa, mai come semplice sigla. Inoltre, nulla nel file è codice: è una definizione leggibile che il server e le app interpretano, quindi non contiene mai una regola o un prompt, e mai un cervello compilato.

Viste condivise

Alcuni regimi normativi appartengono a più settori. Un registro delle tecnologie esternalizzate serve sia Assicurazioni sia Servizi bancari e pagamenti; gli orologi degli incidenti (i conti alla rovescia per le segnalazioni che un'autorità di regolamentazione si aspetta dopo un incidente) servono sia Infrastrutture critiche ed energia sia Governo e settore pubblico. Un regime utilizzato da più pacchetti viene scritto una sola volta come lente condivisa. Ogni pacchetto che ne ha bisogno lo include. Quando la regola cambia, cambia in un unico posto.

Una vista può solo restringere il campo

Una lente è ciò che un ruolo vede all'interno di un pacchetto o di una piattaforma: quali schede e campi, e quali azioni. È sempre definita come una restrizione di una lente di base. Una lente con una base non mostra alcun tipo di entità che la sua base non mostri e non apre alcuna area che la sua base non apra, e non può contemporaneamente mostrare e nascondere lo stesso tipo. I permessi derivano comunque dai ruoli; una lente modifica la vista, mai ciò che una persona è autorizzata a fare.

Se si prova ad ampliarne una, la risposta è LENS_CANNOT_WIDEN (422), senza alcun salvataggio. Nel generatore di lenti, per una lente da tecnico di container refrigerati (reefer) costruita su una base da controllore operativo che non mostra gli importi dei sinistri, si legge: "L'importo del sinistro non può essere aggiunto a questa lente". La soluzione consiste nell'utilizzare una lente di base diversa, il che comporta una richiesta diversa a chi detiene la proprietà della base.

Generatore di lenti
Generatore di lenti
Il generatore di lenti elenca ciò che un ruolo vede, scheda per scheda e campo per campo, spuntato rispetto alla lente di base che restringe. Il tentativo di mostrare un campo nascosto dalla base viene rifiutato indicando il motivo e il nome di chi può modificare la base.

La regola è mantenuta nel database, non solo nella route. Le lenti di ciascuna organizzazione risiedono in quattro tabelle dello schema del registro dei plugin:

Tabella Contenuto
plugins.lenses Una lente di un proprietario, un pacchetto (owner_kind pack) o una piattaforma (platform): i suoi slug e name, la sua base_lens_id, i tipi che shows e hides, le aree che opens, il suo status (active o withdrawn) e il suo version
plugins.lens_grants Una lente assegnata a un ruolo (owner, admin, member, viewer, developer o billing_admin) in una business unit
plugins.lens_changes Ogni modifica a una lente o alle sue concessioni, conservata come stato precedente e successivo con l'indicazione di chi l'ha effettuata e perché. Solo in aggiunta (append-only)
plugins.lens_holder_months Quante persone hanno detenuto una lente in un'unità ogni mese. Un conteggio, mai i nomi

Un trigger rifiuta qualsiasi lente che mostri più della sua base e rifiuta una modifica a una base che lascerebbe una lente costruita su di essa a mostrare più di quanto faccia la base stessa. Nulla viene eliminato. Le lenti e le concessioni vengono revocate e riassegnare una lente genera una nuova riga; una modifica non viene mai riscritta e il conteggio di un mese passato non viene mai modificato. Ogni riga cita una lente della propria organizzazione tramite una chiave composta, pertanto una concessione non può puntare a un'altra organizzazione.

La console e i suoi strumenti raggiungono il registro tramite /api/v1/lenses, con il bearer token personale dell'utente. L'organizzazione, la persona e la postazione dell'unità provengono esclusivamente dal token verificato.

Metodo e percorso Cosa fa
GET / Lenti, filtrate per owner_kind, owner_id e status, con le relative concessioni nella sua postazione
POST / Aggiungere una lente: owner_kind, owner_id, slug, name, shows e facoltativamente description, base_lens_id, hides, opens e reason
GET /owners/:kind/:id Le lenti di un pacchetto o di una piattaforma e quale di esse mostra ciascun tipo
GET /owners/:kind/:id/grants Lente per unità: i ruoli a cui è stata assegnata ciascuna lente e le persone che raggiunge
GET /owners/:kind/:id/holders Persone che detengono una lente ogni mese (months, sei per impostazione predefinita)
POST /owners/:kind/:id/holders/count Registrare i conteggi di questo mese
GET /owners/:kind/:id/changes La cronologia delle modifiche delle lenti del proprietario (limit, 50 per impostazione predefinita)
GET /:lensId Una lente con la sua base e le lenti che la restringono, oltre alle sue concessioni e modifiche
PATCH /:lensId Modificare una lente: name, description, shows, hides, opens, reason
POST /:lensId/withdraw Revocare una lente e, con essa, le sue concessioni. Una lente ristretta da un'altra lente attiva non può essere revocata finché non viene revocata quest'ultima
POST /:lensId/grants Assegnare una lente: business_unit_id, role, reason
POST /:lensId/grants/:grantId/withdraw Revocare una concessione

:kind è pack o platform. Ogni rifiuto riporta un codice con una frase e un passo successivo, mentre un errore imprevisto risponde UNHANDLED_ERROR registrando la causa nel log di servizio, mai nella risposta.

Modello di conoscenza, connettori e cervelli compilati

Il modello di conoscenza rappresenta le tipologie di entità che il pacchetto conosce e il modo in cui si collegano. È sottoposto a controllo di versione e un pacchetto si basa solitamente su un modello di base del pacchetto da cui eredita: un pacchetto per la catena del freddo basato sul modello di base della logistica aggiunge cinque tipologie (tra cui unità reefer e scalo nave) e ne collega due alla base senza modificare la base stessa. Ogni proprietà viene classificata al momento della creazione, in modo che i campi personali e quelli commerciali siano noti prima che qualsiasi lente o ramo di dati li utilizzi. Una lente per i tecnici non potrà quindi mostrare un importo di sinistro classificato come commerciale. Una proprietà ritirata rimane nella versione che la includeva e scompare solo in una versione successiva. La preparazione (staging) di una nuova versione copia prima la conoscenza e la possibilità di ripristino rimane aperta per un periodo prestabilito.

I connettori importano i record dai sistemi che già li detengono: amministrazione delle polizze, un sistema di gestione dei sinistri, una cartella di posta contenente file inviati dai partner. Ciascuno è di sola lettura, viene eseguito secondo la propria pianificazione e dispone di un pulsante di test. Durante l'importazione, i record vengono mappati ai termini del pacchetto e confluiscono nel modello di conoscenza letto dalle lenti; le risposte dell'assistente lo citano. Nulla viene riscritto nel sistema di origine da Nexus.

I cervelli compilati sono le parti di un pacchetto che prendono decisioni: il cervello di sottoscrizione del pacchetto Assicurazioni e il suo cervello dei sinistri, ad esempio. Vengono eseguiti sul server come moduli compilati e concessi in licenza, ciascuno dei quali verifica autonomamente la licenza, e non vengono mai distribuiti su un telefono o un browser.

Modello di conoscenza e connettori
Modello di conoscenza e connettori
Modello di conoscenza e connettori mostra la versione del modello e il vocabolario del pacchetto, con i termini propri dell'organizzazione, e testa ciascun connettore di sola lettura. Nulla nei sistemi di gestione delle polizze o dei sinistri viene modificato da Nexus.

L'overlay mobile e i campi offline

Un pacchetto dichiara le proprie schermate per telefono nello stesso manifesto, come overlay mobile: quali schede e passaggi di acquisizione appaiono sui telefoni e per quali ruoli. Un amministratore imposta quindi le regole sui telefoni per ciascuna organizzazione, ad esempio per quanto tempo le acquisizioni possono restare in attesa offline, se ogni foto riporta il luogo in cui è stata scattata e se le approvazioni richiedono una passkey. La configurazione resta su computer; l'amministratore vede ciò che i telefoni inviano sotto forma di nomi e conteggi, mai le foto o le note stesse.

Ogni campo offerto da una schermata del telefono in assenza di segnale dichiara una di queste tre classi, e la schermata indica quale:

Classe Cosa succede all'elemento Esempi
Creato offline Salvato sul telefono e unito quando il telefono si riconnette Note, foto, letture
Proposto offline Inviato come proposta su cui l'ufficio decide. Il server non lo unisce mai direttamente; lo riesegue attraverso i propri controlli di autorizzazione Un importo, un riscontro, una modifica di riserva, una decisione
Mai offline Non eseguibile sul campo. Mostrato come una riga con la relativa motivazione, mai come un pulsante Una firma, un sigillo, un controllo di autorizzazione, una verifica rispetto a una lista di sanzioni

Gli overlay non contengono regole, né prompt, né cervelli. Sono definizioni di schermate leggibili e tutto ciò che prende decisioni rimane sul server. Le schermate per telefono di un pacchetto si aprono solo all'interno delle app per telefono di Nexus e solo quando l'organizzazione detiene sia il pacchetto sia il componente aggiuntivo App mobili.

Interfaccia mobile
Interfaccia mobile
L'overlay mobile seleziona quali schede e passaggi di acquisizione del pacchetto appaiono sui telefoni e per quali ruoli. Le acquisizioni restano in attesa offline per il tempo consentito dall'organizzazione e le approvazioni richiedono una passkey. L'anteprima mostra esattamente ciò che vede un singolo ruolo.

Abilitazione: chi possiede il pacchetto e dove viene eseguito

Un pacchetto è concesso in licenza, mai attivato tramite configurazione. Tre livelli decidono chi lo vede.

La licenza. Il documento di licenza firmato contiene un elenco domain_packs di ID matrice (al massimo 100, eventualmente vuoto), accanto ai suoi grants e add_ons dei gruppi di funzionalità. La console di Adverant non emetterà un pacchetto senza i componenti aggiuntivi di cui ha bisogno: un pacchetto che richiede Decision rooms e record sigillati non può essere emesso su una licenza che ne sia priva. I gruppi di funzionalità in una licenza vengono concessi all'intera installazione o a organizzazioni specifiche, e il controllo delle abilitazioni risponde per singola organizzazione. Rimuovendo la concessione, ogni lente e schermata per telefono del pacchetto diventa un'anteprima (teaser), mantenendo però i relativi record.

Il controllo delle abilitazioni. Per ogni organizzazione e piano, ogni ruolo e ogni persona, il controllo delle abilitazioni decide se un controllo aggiunto dal pacchetto è abilitato, mostrato come anteprima (teaser), nascosto o rifiutato con un codice. Governa le righe di menu e le schede dei pannelli, nonché i controlli di route e di invio (dispatch). Il modulo chiuso rimane l'autorità per la propria concessione.

Unità e lenti. All'interno di un'organizzazione che dispone del pacchetto, un amministratore decide dove eseguirlo. Un pacchetto viene attivato per un'unità per fasi, mai per l'intera unità contemporaneamente: la verifica della licenza, un gruppo pilota, un preset di impostazioni, per poi estendersi a tutti nell'unità in una data scelta dall'amministratore. Prima che qualcosa cambi, la pagina mostra chi ottiene cosa, per ruolo. Le lenti vengono quindi assegnate per ruolo e per unità, in un'unica matrice. La successiva disattivazione del pacchetto per un'unità conserva tutti i record creati dalle persone; le lenti e i modelli scompaiono e null'altro cambia.

Attivare un dominio per un'unità
Attivare un dominio per un'unità
L'attivazione di un dominio per un'unità avviene per fasi, dalla verifica della licenza attraverso un gruppo pilota fino all'intera unità. L'amministratore vede chi ottiene cosa prima che avvenga qualsiasi modifica e le impostazioni del gruppo pilota vengono trasferite invariate.

I dieci pacchetti

Adverant fornisce dieci pacchetti di dominio. Ciascuno richiede la licenza di base Enterprise e alcuni richiedono componenti aggiuntivi. Le schermate per telefono di ogni pacchetto richiedono inoltre il componente aggiuntivo App mobili.

Pacchetto ID matrice Cosa offre Richiede inoltre
Assicurazioni insurance Lenti assicurative per sottoscrizione, sinistri, riassicurazione, Lloyd's e autorità delegata, tra le altre; il flusso per frodi e indagini; percorsi e impostazioni della vetrina digitale assicurativa; i cervelli compilati assicurativi Sale decisionali e registri sigillati
Banche e pagamenti financial-services Un registro delle tecnologie esternalizzate; orologi e segnalazioni di incidenti tecnologici; piani di uscita per fornitori critici; decisioni di credito; contestazioni su carte Nulla oltre la base
Mercati dei capitali e gestione patrimoniale capital-markets Lenti per l'analista di ricerca, il gestore di portafoglio, la sorveglianza e conformità e la rendicontazione ai clienti; chiamate sui trading desk registrate; ricerche mantenute dietro una barriera informativa (wall) fino alla pubblicazione; modelli per il registro di superamento della barriera (wall-crossing), la revisione delle chiamate e la pubblicazione delle ricerche. I telefoni ricevono il briefing mattutino e le approvazioni di pubblicazione, nonché gli avvisi di sorveglianza, mai gli ordini Sale decisionali e registri sigillati
Enti governativi e settore pubblico government Richieste di prestazioni e sussidi; domande di pianificazione territoriale; richieste di accesso alle informazioni Nulla oltre la base
Sanità healthcare-providers Accesso e condivisione delle cartelle cliniche dei pazienti e richieste di informazioni. Nessun supporto alle decisioni cliniche Nulla oltre la base
Scienze della vita life-sciences Deviazioni e azioni correttive; revisione dei batch record; controllo delle modifiche convalidato Nulla oltre la base
Infrastrutture critiche ed energia energy-and-utilities Orologi e segnalazioni degli incidenti; ispezioni e difetti; ordini di lavoro Nulla oltre la base
Difesa e sicurezza defence-and-mission Rapporti dal campo fusi con gli avvisi della piattaforma; contrassegni di condivisione; debriefing. La sua build per telefono viene installata solo tramite la gestione dei dispositivi Nexus Edge, per gli avvisi della piattaforma
Servizi legali e professionali legal Lenti per il professionista tariffabile (fee earner), il knowledge lawyer, conflitti e rischi e fatturazione; una verifica dei conflitti per ogni nuova pratica; barriere etiche (ethical wall) rimosse solo da due partner; modelli per la verifica di una nuova pratica, il generatore di barriere e i promemoria delle barriere. I telefoni ricevono la registrazione del tempo e gli aggiornamenti sulle pratiche con le approvazioni, mai file coperti da segreto professionale Sale decisionali e record sigillati, e Mail
Logistica e settore marittimo logistics-and-maritime Lenti per il controllore operativo, il funzionario doganale, il gestore dei vettori e l'ispettore portuale; dichiarazioni e blocchi doganali; controlli sulle sanzioni prima della prima prenotazione, con una persona che sblocca ogni fermo; un modello di conoscenza di porti e navi, vettori e blocchi. I telefoni ricevono le ispezioni di piazzale e d'ormeggio e i blocchi doganali, con i rilevamenti dei droni Mappa e GeoAI

Harrow Port Authority utilizza il pacchetto Logistica e settore marittimo, ed è il primo che leggerei se stesse creando il suo: il suo modello di conoscenza è la base su cui poggia l'esempio della catena del freddo visto sopra.

Creare il proprio pacchetto

Su Enterprise, uno sviluppatore avvia un pacchetto dal percorso guidato (golden path) in Inizia qualcosa di nuovo, in tre passaggi. "Informazioni" assegna un nome al pacchetto, indica le sue unità, il pacchetto su cui si basa e le regole per le quali deve fornire prove. "Modello di conoscenza" aggiunge le nuove tipologie di entità sopra il modello di base. "Rivedi e crea" mostra il piano e poi lo esegue. Crea un repository dal modello del pacchetto con un manifesto che dichiara ciò che il pacchetto può raggiungere e i relativi test; quindi uno spazio di sviluppo con rami di dati sintetici; infine una bozza di voce di catalogo visibile solo a lei. Nulla viene creato finché non preme Crea nell'ultimo passaggio. Il Capitolo 2.24, Creazione di un verticale personalizzato end-to-end, illustra l'intero percorso.

Quanto costa un pacchetto

Un pacchetto è l'estensione più onerosa da mantenere. Il suo modello di conoscenza ha versioni da cui le persone dipendono, quindi una proprietà di cui ci si pente rimane nella versione con cui è stata rilasciata. Le sue lenti possono solo sottrarre elementi, quindi un ruolo che necessita di vedere di più comporta una discussione sulla lente di base. La sua mappa delle prove cita normative che il suo consulente legale deve confermare prima che chiunque vi faccia affidamento. E un cliente lo ottiene solo tramite la propria licenza: può costruire il miglior pacchetto del settore e comunque non poterlo attivare nemmeno per una singola unità finché la licenza dell'organizzazione non lo include. In compenso, la trentesima unità che lo richiede le costa solo un'attivazione e un progetto pilota.