AutentificareProgramați o prezentare

Capitolul 2.23

Pachete de domeniu

Din ce este compus un pachet de domeniu și ce specifică fișierul său pack.json; lentilele și registrul de lentile; modelele de cunoștințe, conectorii și suprapunerile mobile; cum este licențiat și activat un pachet pentru o unitate; și cele zece pachete pe care le livrează Adverant.

Această pagină a fost tradusă cu ajutorul IA din originalul în limba engleză. Dacă există neclarități, pagina în limba engleză rămâne cea de referință. Citiți această pagină în limba engleză

19 minute de lectură

Pachetul pe care l-am construit la Corrán Orbital a pornit ca două pluginuri și o duzină de abilități Skills Engine pe care le folosea doar echipa noastră de la stația terestră. Când unitatea de operațiuni ale misiunii a cerut același lucru, am avut de ales: să copiez totul și să întrețin câte două din fiecare sau să îl transform într-un pachet de domeniu cu un singur model de cunoaștere și două lentile, activate pentru fiecare unitate în parte. Mi-a luat o săptămână să îl transform în pachet. Aș face aceeași alegere și mâine, iar data viitoare aș începe direct cu pachetul.

Un pachet de domeniu aduce în Nexus modul de lucru al unei industrii. Acesta conține tipurile de entități ale industriei și modul în care sunt legate între ele, precum și ce vede fiecare rol. Include șabloanele și fluxurile de lucru pe care oamenii le folosesc zilnic, dovezile cerute de regulile industriei și ecranele care funcționează pe un telefon fără semnal. Nu modifică niciodată interfața de bază (shell) sau componentele acesteia și nici regulile de redactare. O industrie nouă este un pachet, nu o aplicație.

Din ce este compus un pachet

În esență, un pachet înseamnă patru lucruri și niciunul dintre ele nu este cod specific pachetului în platformă:

  1. Un set de grupuri de funcționalități în verificarea drepturilor de utilizare. Comenzile pachetului aparțin unui set de grupuri de funcționalități. Fiecare rând de meniu și fiecare filă de panou adăugate de pachet sunt apoi stabilite prin același mecanism ca restul Nexus: disponibile conform licenței, afișate ca previzualizare sau ascunse.
  2. Un manifest al pachetului, pack.json, care declară grupurile de ecrane ale pachetului și termenii acestuia, lentilele și ecranele pentru telefon.
  3. Module închise care își verifică singure acordarea. Codul de server care ia decizii, cum ar fi „creierele” compilate ale unui pachet, include verificatorul de licență și verifică el însuși licența semnată. Nimic din afara modulului nu îl poate activa.
  4. O intrare în catalog, astfel încât pachetul să apară pe pagina Pachete de domeniu, împreună cu ce aduce și de ce are nevoie.

Peste acestea se află părțile pe care oamenii le văd: modelul de cunoaștere și lentilele; șabloanele, fluxurile de lucru și abilitățile Skills Engine; conectorii doar în citire către sistemele care dețin deja înregistrările, o hartă a dovezilor de la fiecare regulă la înregistrările care îi răspund și un strat pentru dispozitive mobile.

Pachete de domeniu
Pachete de domeniu
Pagina Pachete de domeniu listează toate cele zece pachete, cu ce necesită fiecare și unde rulează. Doar Adverant acordă un pachet; dumneavoastră decideți în ce unități rulează.

Fișierul pack.json

Iată manifestul pachetului Banking and payments, redus la o singură lentilă cu un singur loc și la doi termeni. ID-ul fișierului său este fintech, iar name conține numele de lucru al pachetului; consola și catalogul îl afișează ca Banking and payments.

{
  "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"
      }
    ]
  }
}

Câmpurile, de sus în jos:

Câmp Ce indică
id ID-ul pachetului, cu litere mici
name Numele său de lucru
version Versiunea proprie a pachetului
inherits Pachetul pe care se bazează acesta. Banking and payments moștenește de la Insurance, care conține grupurile comune folosite de fiecare pachet, cum ar fi conversația și setările. Un pachet nou își adaugă lentilele și lasă grupurile comune în seama pachetului de la care moștenește
screenCount Câte ecrane definește pachetul
clusters[] Grupurile de ecrane ale pachetului. Fiecare are un id, un kind, un name, seats căruia îi este destinat, purpose, seturile lexicon din care provin termenii săi, menu și screens, fiecare cu un id, un title, who și ceea ce sunt doing
clusters[].kind shared pentru un grup pe care îl poate accesa orice lentilă (de exemplu, conversația); lens pentru ecranele proprii ale unui rol. scope al unui grup indică dacă acesta aparține nucleului (core) sau industriei (domain)
lexicon Termenii pachetului, în seturi denumite. Fiecare termen are o explicație simplă pe care o poate citi un începător, iar a treia poziție este exact pentru un termen care trebuie folosit cuvânt cu cuvânt, cum ar fi un indicator reglementar
world Lumea de exemplu, formată din tenanți și locuri fictive, pe care o folosesc ecranele și testele pachetului, precum și ramurile sale de date
world.tenants[].plan areas al planului: grupurile și lentilele pe care le deschide planul acestui tenant, din of
world.tenants[].ai Politica organizației privind IA (inteligența artificială) pentru pachet: dacă sunt permise modelele pe dispozitiv (onDevice), unde pot ajunge datele personale către un model în cloud (personalDataToCloudModels, cum ar fi uk-only sau eu-only) și dacă sigilarea unei înregistrări necesită expediere UNO (sealRequiresUno)
world.seats[] Locul unei persoane: title, lens pe care îl deține, clusters comun pe care îl accesează de asemenea, ecranul său home, posture (desk, field sau consumer) și, în fișierul complet, authority, limitele în care acționează

Două reguli stabilesc ce poate conține un pack.json. O reglementare este denumită în cuvinte simple, cu o explicație, niciodată doar printr-o abreviere. Și nimic din fișier nu este cod: este o definiție lizibilă pe care serverul și aplicațiile o interpretează, așa că nu conține niciodată o regulă sau un prompt și niciodată un creier compilat.

Lentile partajate

Unele regimuri aparțin mai multor industrii. Un registru al tehnologiei externalizate servește Insurance și Banking and payments; termenele pentru incidente (numărătorile inverse până la rapoartele pe care o autoritate de reglementare le așteaptă după un incident) servesc atât Critical infrastructure and energy, cât și Government and public sector. Un regim folosit de mai multe pachete este scris o singură dată, ca lentilă comună. Fiecare pachet care are nevoie de el îl include. Când regula se schimbă, aceasta se modifică într-un singur loc.

O lentilă doar restrânge

O lentilă reprezintă ceea ce vede un rol în cadrul unui pachet sau al unei platforme: ce carduri și câmpuri și ce acțiuni. Este definită întotdeauna ca o restrângere a unei lentile de bază. O lentilă cu o bază nu afișează niciun tip de entitate pe care baza sa nu îl afișează și nu deschide nicio zonă pe care baza sa nu o deschide și nu poate atât să afișeze, cât și să ascundă același tip. Permisiunile provin în continuare din roluri; o lentilă modifică vizualizarea, niciodată ceea ce poate face o persoană.

Dacă încercați să lărgiți una, răspunsul este LENS_CANNOT_WIDEN (422), fără ca nimic să fie salvat. În generatorul de lentile, pentru o lentilă de tehnician pentru containere frigorifice construită pe o bază de controlor de operațiuni care nu afișează sumele daunelor, mesajul este: „Claim amount cannot be added to this lens”. Soluția este o altă lentilă de bază, ceea ce înseamnă o altă solicitare adresată proprietarului bazei.

Constructor de lentile
Constructor de lentile
Generatorul de lentile listează ce vede un rol, card cu card și câmp cu câmp, bifate în raport cu lentila de bază pe care o restrânge. Încercarea de a afișa un câmp pe care baza îl ascunde este refuzată, cu motivul și numele persoanei care poate modifica baza.

Regula este impusă în baza de date, nu doar în rută. Lentilele fiecărei organizații se află în patru tabele din schema registrului de pluginuri:

Tabel Ce conține
plugins.lenses O lentilă a unui proprietar, un pachet (owner_kind pack) sau o platformă (platform): slug și name, base_lens_id, tipurile pe care le shows și hides, zonele pe care le opens, status (active sau withdrawn) și version
plugins.lens_grants O lentilă acordată unui rol (owner, admin, member, viewer, developer sau billing_admin) într-o unitate de business
plugins.lens_changes Fiecare modificare a unei lentile sau a acordărilor sale, păstrată ca stare anterioară și ulterioară, cu autorul și motivul. Doar adăugare
plugins.lens_holder_months Câte persoane au deținut o lentilă într-o unitate în fiecare lună. Un număr, niciodată cine

Un declanșator refuză orice lentilă care afișează mai mult decât baza sa și refuză o modificare a unei baze care ar face ca o lentilă construită pe ea să afișeze mai mult decât aceasta. Nimic nu este șters. Lentilele și acordările sunt retrase, iar acordarea din nou a unei lentile reprezintă un rând nou; o modificare nu este niciodată rescrisă, iar numărul dintr-o lună trecută nu este niciodată schimbat. Fiecare rând face referire la o lentilă a propriei organizații printr-o cheie compusă, astfel încât o acordare nu poate indica spre o altă organizație.

Consola și propriile dumneavoastră instrumente accesează registrul prin /api/v1/lenses, cu tokenul bearer al persoanei. Organizația și persoana, precum și locul în unitate, provin din tokenul verificat și din nimic altceva.

Metodă și cale Ce face
GET / Lentile, filtrate după owner_kind, owner_id și status, cu acordările lor în locul dumneavoastră
POST / Adăugarea unei lentile: owner_kind, owner_id, slug, name, shows și, opțional, description, base_lens_id, hides, opens și reason
GET /owners/:kind/:id Lentilele unui pachet sau ale unei platforme și care dintre ele afișează fiecare tip
GET /owners/:kind/:id/grants Lentile pe unitate: rolurile cărora li s-a acordat fiecare lentilă și persoanele la care ajunge
GET /owners/:kind/:id/holders Persoanele care au deținut o lentilă în fiecare lună (months, șase în mod implicit)
POST /owners/:kind/:id/holders/count Înregistrarea numerelor din luna curentă
GET /owners/:kind/:id/changes Istoricul modificărilor lentilelor proprietarului (limit, 50 în mod implicit)
GET /:lensId O lentilă, cu baza sa și lentilele care o restrâng, precum și acordările și modificările sale
PATCH /:lensId Modificarea unei lentile: name, description, shows, hides, opens, reason
POST /:lensId/withdraw Retragerea unei lentile, împreună cu acordările sale. O lentilă restrânsă de o altă lentilă activă nu poate fi retrasă până când aceasta nu este retrasă
POST /:lensId/grants Acordarea unei lentile: business_unit_id, role, reason
POST /:lensId/grants/:grantId/withdraw Retragerea unei acordări

:kind este pack sau platform. Fiecare refuz conține un cod, cu o propoziție și un pas următor, iar un eșec neașteptat răspunde cu UNHANDLED_ERROR, cauza fiind în jurnalul serviciului, niciodată în răspuns.

Model de cunoștințe, conectori și nuclee compilate

Modelul de cunoaștere reprezintă tipurile de entități pe care le cunoaște pachetul și modul în care se conectează. Este versionat, iar un pachet se bazează de obicei pe un model de bază din pachetul de la care moștenește: un pachet pentru lanțul de frig construit pe modelul de bază pentru logistică adaugă cinci tipuri (printre care unitatea frigorifică și escala navei) și leagă două dintre ele de bază fără a modifica baza însăși. Fiecare proprietate este clasificată la creare, astfel încât câmpurile personale și cele comerciale sunt cunoscute înainte ca vreo lentilă sau ramură de date să le folosească. O lentilă pentru tehnicieni nu poate afișa atunci o sumă a daunei clasificată drept comercială. O proprietate retrasă rămâne în versiunea care o conținea și dispare doar într-o versiune ulterioară. Pregătirea unei versiuni noi copiază mai întâi cunoștințele, iar calea de revenire rămâne deschisă pentru o perioadă stabilită.

Conectorii aduc înregistrări din sistemele care le dețin deja: administrarea polițelor, un sistem de daune, un dosar de e-mail cu fișiere trimise de parteneri. Fiecare funcționează doar în citire, rulează după propriul program și are un buton de testare. Înregistrările sunt mapate la termenii pachetului la intrare și ajung în modelul de cunoaștere pe care îl citesc lentilele; răspunsurile asistentului îl citează. Nimic nu este scris înapoi din Nexus în sistemul sursă.

Creierele compilate sunt părțile unui pachet care iau decizii: de exemplu, creierul de subscriere și creierul de daune ale pachetului Insurance. Acestea rulează pe server ca module compilate și licențiate, fiecare verificând el însuși licența, și nu sunt livrate niciodată pe un telefon sau într-un browser.

Model de cunoaștere și conectori
Modelul de cunoaștere și conectorii
Model de cunoaștere și conectori afișează versiunea modelului și vocabularul pachetului, cu termenii proprii ai organizației, și testează fiecare conector doar în citire. Nimic din sistemele de polițe sau de daune nu este modificat din Nexus.

Suprapunerea mobilă și câmpurile offline

Un pachet își declară ecranele pentru telefon în același manifest, ca strat pentru dispozitive mobile: ce carduri și pași de captură apar pe telefoane și pentru ce roluri. Un administrator stabilește apoi regulile pentru telefoane la nivelul fiecărei organizații, cum ar fi cât timp pot aștepta capturile offline, dacă fiecare fotografie include locul în care a fost făcută și dacă aprobările necesită o cheie de acces (passkey). Configurarea rămâne pe un computer; administratorul vede ce trimit telefoanele sub formă de nume și numere, niciodată fotografiile sau notele propriu-zise.

Fiecare câmp oferit de un ecran de telefon fără semnal declară una dintre trei clase, iar ecranul arată care:

Clasă Ce se întâmplă cu acesta Exemple
Creat offline Salvat pe telefon și integrat când telefonul se reconectează Note, fotografii, citiri
Propus offline Trimis ca sugestie asupra căreia decide biroul. Serverul nu îl integrează niciodată; îl reaplică prin propriile verificări de autoritate O sumă, o constatare, o modificare a rezervei, o decizie
Niciodată offline Imposibil pe teren. Afișat ca rând cu motivul său, niciodată ca buton O semnătură, un sigiliu, o verificare de autoritate, o verificare în raport cu o listă de sancțiuni

Straturile nu conțin reguli, nici prompturi și nici creiere. Sunt definiții de ecran lizibile, iar tot ce ia decizii rămâne pe server. Ecranele pentru telefon ale unui pachet se deschid doar în aplicațiile pentru telefon Nexus și doar când organizația deține atât pachetul, cât și suplimentul Mobile apps.

Interfața mobilă
Interfața mobilă
Stratul pentru dispozitive mobile alege ce carduri ale pachetului și ce pași de captură apar pe telefoane și pentru ce roluri. Capturile așteaptă offline atât timp cât permite organizația, iar aprobările necesită o cheie de acces (passkey). Previzualizarea arată exact ce vede un rol.

Drepturi de utilizare: cine deține pachetul și unde rulează acesta

Un pachet este licențiat, niciodată activat prin configurare. Trei niveluri decid cine îl vede.

Licența. Documentul de licență semnat conține o listă domain_packs de ID-uri de matrice (cel mult 100, posibil goală), alături de grants și add_ons ale grupurilor de funcționalități. Consola Adverant nu va emite un pachet fără suplimentele de care are nevoie: un pachet care necesită Decision rooms și înregistrări sigilate nu poate fi emis pentru o licență care nu le include. Grupurile de funcționalități dintr-o licență sunt acordate fie întregii instalări, fie unor organizații numite, iar verificarea drepturilor de utilizare răspunde pentru fiecare organizație. Dacă eliminați acordarea, fiecare lentilă și fiecare ecran pentru telefon al pachetului devine o previzualizare, iar înregistrările sale sunt păstrate.

Verificarea drepturilor. Pentru fiecare organizație și plan, fiecare rol și fiecare persoană, verificarea drepturilor decide dacă un control adăugat de pachet este disponibil, afișat ca previzualizare, ascuns sau refuzat cu un cod. Aceasta determină rândurile din meniu și filele din panouri, precum și verificările de rută și de distribuire. Modulul închis rămâne autoritatea pentru propria sa acordare.

Unități și lentile. În cadrul unei organizații care deține pachetul, un administrator decide unde rulează acesta. Un pachet este activat pentru o unitate în etape, niciodată pentru întreaga unitate dintr-odată: verificarea licenței, un grup pilot, o presetare de setări, apoi extinderea la toți cei din unitate la o dată aleasă de administrator. Înainte ca ceva să se schimbe, pagina arată cine ce câștigă, pe roluri. Lentilele sunt apoi atribuite pe rol și pe unitate, într-o singură matrice. Dezactivarea ulterioară a pachetului pentru o unitate păstrează fiecare înregistrare creată de utilizatori; lentilele și șabloanele dispar și nimic altceva nu se schimbă.

Activarea unui domeniu pentru o unitate
Activarea unui domeniu pentru o unitate
Activarea unui domeniu pentru o unitate se desfășoară în etape, de la verificarea licenței, printr-un grup pilot, până la întreaga unitate. Administratorul vede cine ce câștigă înainte ca ceva să se schimbe, iar setările pilotului se preiau neschimbate.

Cele zece pachete

Adverant oferă zece pachete de domeniu. Fiecare necesită licența de bază Enterprise, iar unele necesită suplimente. Ecranele pentru telefon ale fiecărui pachet necesită, de asemenea, suplimentul Mobile apps.

Pachet Id matrice Ce aduce Mai necesită
Asigurări insurance Lentile de asigurări pentru subscriere, daune, reasigurare, Lloyd's și autoritate delegată, printre altele; fluxul de fraudă și investigații; parcursuri și setări pentru vitrina de asigurări; creierele compilate pentru asigurări Camere de decizie și înregistrări sigilate
Bănci și plăți financial-services Un registru al tehnologiei externalizate; termene și rapoarte pentru incidentele tehnologice; planuri de ieșire pentru furnizorii critici; decizii de creditare; dispute privind cardurile Nimic în afară de licența de bază
Piețe de capital și administrarea activelor capital-markets Lentile pentru analistul de cercetare, administratorul de portofoliu, supraveghere și conformitate, precum și raportarea către clienți; apelurile de pe birourile de tranzacționare sunt înregistrate; cercetarea este ținută în spatele unui zid până la publicare; șabloane pentru jurnalul de trecere a zidului, revizuirea apelurilor și publicarea cercetării. Telefoanele primesc informarea de dimineață și aprobările de publicare, precum și alertele de supraveghere, niciodată ordine Camere de decizie și înregistrări sigilate
Guvern și sectorul public government Cereri de beneficii și drepturi; cereri de urbanism; cereri de informații Nimic în afară de licența de bază
Sănătate healthcare-providers Accesul la dosarele pacienților și partajarea acestora, precum și cereri de informații. Fără asistență pentru decizii clinice Nimic în afară de licența de bază
Științele vieții life-sciences Abateri și acțiuni corective; revizuirea înregistrărilor de lot; controlul validat al modificărilor Nimic în afară de licența de bază
Infrastructură critică și energie energy-and-utilities Termene și rapoarte pentru incidente; inspecții și defecte; ordine de lucru Nimic în afară de licența de bază
Apărare și securitate defence-and-mission Rapoarte de teren combinate cu alertele platformei; marcaje de partajare; debriefinguri. Versiunea sa pentru telefon se instalează doar prin gestionarea dispozitivelor Nexus Edge, pentru alertele platformei
Servicii juridice și profesionale legal Lentile pentru avocatul care facturează ore, avocatul de cunoaștere, conflicte și riscuri, precum și facturare; o verificare a conflictelor la fiecare dosar nou; ziduri etice ridicate doar de doi parteneri; șabloane pentru verificarea unui dosar nou, constructorul de ziduri și mementourile privind zidurile. Telefoanele primesc înregistrarea timpului și actualizările dosarelor cu aprobări, niciodată fișiere privilegiate Camere de decizie și înregistrări sigilate, precum și Mail
Logistică și transport maritim logistics-and-maritime Lentile pentru controlorul de operațiuni, ofițerul vamal, managerul de transportatori și inspectorul portuar; declarații vamale și rețineri; verificări privind sancțiunile înainte de prima rezervare, cu o persoană care eliberează fiecare reținere; un model de cunoaștere pentru porturi și nave, transportatori și rețineri. Telefoanele primesc inspecții în curte și la dană și rețineri vamale, cu constatări de la drone Hartă și GeoAI

Harrow Port Authority folosește pachetul Logistică și maritim și pe acesta l-aș citi primul dacă vă construiți propriul pachet: modelul său de cunoaștere este baza pe care se construiește exemplul de lanț frigorific de mai sus.

Construirea propriului pachet

Pe Enterprise, un dezvoltator pornește un pachet din calea standard din Start something new, în trei pași. „About it” denumește pachetul, unitățile sale, pachetul pe care se bazează și regulile pentru care trebuie să prezinte dovezi. „Knowledge model” adaugă noile tipuri de elemente peste modelul de bază. „Review and create” afișează planul și apoi îl urmează. Creează un depozit din șablonul de pachet, cu un manifest care declară ce poate accesa pachetul, și testele sale; apoi un spațiu de dezvoltare cu ramuri de date sintetice; apoi o intrare de catalog în stadiu de schiță pe care doar dumneavoastră o puteți vedea. Nimic nu este creat până când nu apăsați Create la ultimul pas. Capitolul 2.24, Construirea unei verticale personalizate de la cap la coadă, parcurge întreaga cale.

Cât vă costă un pachet

Un pachet este extensia cea mai costisitoare de întreținut. Modelul său de cunoaștere are versiuni de care depind oamenii, astfel încât o proprietate pe care o regretați rămâne în versiunea care a livrat-o. Lentilele sale pot doar să restrângă, astfel încât un rol care are nevoie de mai mult înseamnă o discuție despre lentila de bază. Harta sa de dovezi numește reguli pe care propriii dumneavoastră consilieri juridici trebuie să le confirme înainte ca cineva să se bazeze pe ea. Iar un client îl primește doar prin licența sa: puteți construi cel mai bun pachet din industrie și totuși să nu îl puteți activa nici măcar pentru o singură unitate până când licența organizației nu îl include. În schimb, a treizecea unitate care îl dorește vă costă o singură activare și un pilot.