Versioon 1.0.0-alpha.1uusim
Peatükk 2.23
Valdkonnapaketid (Domain packs)
Millest valdkonnapakett koosneb ja mida ütleb selle pack.json; vaated (lenses) ja vaadete register; teadmismudelid, konnektorid ja mobiilikihid; kuidas paketti litsentsitakse ja üksuse jaoks sisse lülitatakse; ning kümme paketti, mida Adverant tarnib.
Selle lehe tõlkis AI ingliskeelsest originaalist. Kui miski jääb ebaselgeks, võtke aluseks ingliskeelne leht. Lugege seda lehte inglise keeles

Pakett, mille ma Corrán Orbitalis ehitasin, sai alguse kahest pistikprogrammist ja tosinast Skills Engine'i oskusest, mida kasutas ainult meie maajaama meeskond. Kui missiooni operatsioonide üksus soovis sama asja, oli mul valik: kopeerida kõik ja hallata kõike kahes eksemplaris või muuta see domeenipaketiks, millel on üks teadmusmudel ja kaks vaadet, mis lülitatakse sisse üksuse kaupa. Paketiks muutmine võttis mul nädala. Teeksin homme sama valiku ja järgmine kord alustaksin kohe paketist.
Domeenipakett toob Nexusesse ühe tööstusharu töökorralduse. See sisaldab tööstusharu objektiliike ja nende omavahelisi seoseid ning seda, mida iga roll näeb. See sisaldab malle ja töövooge, mida inimesed iga päev kasutavad, tõendeid, mida tööstusharu reeglid nõuavad, ning ekraane, mis töötavad telefonis ka ilma levita. See ei muuda kunagi kesta ega selle komponente ega ka kirjutamisreegleid. Uus tööstusharu on pakett, mitte rakendus.
Millest pakett koosneb
Sisuliselt koosneb pakett neljast osast, millest ükski ei ole platvormis paketipõhine kood:
- Funktsioonirühmade komplekt õiguste kontrollis. Paketi juhtelemendid kuuluvad funktsioonirühmade komplekti. Iga menüürea ja paneeli vahekaardi, mille pakett lisab, üle otsustab seejärel sama mehhanism nagu ülejäänud Nexuses: õigus olemas, kuvatud tutvustusena või peidetud.
- Paketi manifest,
pack.json, mis deklareerib paketi ekraaniklastrid ja sõnavara, vaated ning telefoniekraanid. - Suletud moodulid, mis kontrollivad ise oma õigust. Otsustav serverikood, näiteks paketi kompileeritud ajud, sisaldab litsentsi kontrollijat ja kontrollib allkirjastatud litsentsi ise. Miski väljaspool moodulit ei saa seda sisse lülitada.
- Kataloogikirje, et pakett ilmuks lehele Domeenipaketid koos sellega, mida see toob ja mida see vajab.
Nende peal asuvad osad, mida inimesed näevad: teadmusmudel ja vaated; mallid, töövood ja Skills Engine'i oskused; kirjutuskaitstud konnektorid süsteemidesse, mis kirjeid juba hoiavad, tõendikaart igast reeglist sellele vastavate kirjeteni ning mobiilne kiht.
Fail pack.json
Siin on paketi Pangandus ja maksed manifest, kärbitud ühe vaateni ühe kohaga ja kahe terminini. Selle faili id on fintech ja name sisaldab paketi töönime; konsool ja kataloog kuvavad seda nimega Pangandus ja maksed.
{
"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"
}
]
}
}Väljad ülevalt alla:
| Väli | Mida see ütleb |
|---|---|
id |
Paketi id väiketähtedega |
name |
Selle töönimi |
version |
Paketi enda versioon |
inherits |
Pakett, millele see pakett tugineb. Pangandus ja maksed pärib paketist Kindlustus, mis sisaldab ühiseid klastreid, mida iga pakett kasutab, näiteks vestlust ja seadeid. Uus pakett lisab oma vaated ja jätab ühised klastrid paketile, millest see pärib |
screenCount |
Mitu ekraani pakett määratleb |
clusters[] |
Paketi ekraanirühmad. Igal on id, kind, name, seats, kellele see on mõeldud, selle purpose, lexicon komplektid, millest selle sõnad pärinevad, selle menu ja selle screens, igaühel id, title, who ja see, milleks need on doing |
clusters[].kind |
shared klastri jaoks, millele pääseb ligi iga vaade (näiteks vestlus); lens ühe rolli enda ekraanide jaoks. Klastri scope näitab, kas see kuulub tuuma (core) või tööstusharule (domain) |
lexicon |
Paketi sõnad nimega komplektides. Igal terminil on lihtne selgitus, mida uustulnuk saab lugeda, ja kolmas väli on exact termini puhul, mida tuleb kasutada sõna-sõnalt, näiteks regulatiivse näitaja puhul |
world |
Väljamõeldud rentnike ja kohtade näidismaailm, mida paketi ekraanid ja testid kasutavad, ning selle andmeharud |
world.tenants[].plan |
Plaani areas: klastrid ja vaated, mille selle rentniku plaan avab, of hulgast |
world.tenants[].ai |
Organisatsiooni AI (tehisintellekti) poliitika paketi jaoks: kas seadmesisesed mudelid on lubatud (onDevice), kuhu võib isikuandmeid pilvemudelile saata (personalDataToCloudModels, näiteks uk-only või eu-only) ning kas kirje pitseerimine nõuab UNO saatmist (sealRequiresUno) |
world.seats[] |
Ühe inimese koht: tema title, lens, mida ta omab, ühine clusters, millele ta samuti ligi pääseb, tema home ekraan, tema posture (desk, field või consumer) ja täielikus failis tema authority, piirid, mille raames ta tegutseb |
Kaks reeglit määravad, mida pack.json võib sisaldada. Regulatsioon nimetatakse lihtsate sõnadega koos selgitusega, mitte kunagi pelga lühendina. Ja miski failis ei ole kood: see on loetav määratlus, mida server ja rakendused tõlgendavad, seega ei sisalda see kunagi reeglit ega viipa ega kunagi kompileeritud aju.
Jagatud vaated (lenses)
Mõned režiimid kuuluvad mitmele tööstusharule. Väljasisseostetud tehnoloogia register teenindab pakette Kindlustus ning Pangandus ja maksed; intsidentide tähtajad (pöördloendused aruanneteni, mida regulaator pärast intsidenti ootab) teenindavad nii pakette Kriitiline taristu ja energeetika kui ka Valitsus ja avalik sektor. Režiim, mida kasutavad mitu paketti, kirjutatakse üks kord ühise vaatena. Iga pakett, mis seda vajab, kaasab selle. Kui reegel muutub, muutub see ühes kohas.
Vaade ainult kitsendab
Vaade on see, mida üks roll paketis või platvormil näeb: millised kaardid ja väljad ning millised toimingud. See määratletakse alati baasvaate kitsendusena. Baasiga vaade ei näita ühtegi objektiliiki, mida selle baas ei näita, ega ava ühtegi ala, mida selle baas ei ava, ning see ei saa sama liiki korraga nii näidata kui ka peita. Õigused tulenevad endiselt rollidest; vaade muudab kuva, mitte kunagi seda, mida inimene teha tohib.
Kui proovite vaadet laiendada, on vastus LENS_CANNOT_WIDEN (422) ja midagi ei salvestata. Vaatekoostajas kõlab see külmutuskonteineri tehniku vaate puhul, mis on ehitatud operatsioonide kontrolöri baasile, mis ei näita nõude summasid, järgmiselt: „Claim amount cannot be added to this lens”. Lahenduseks on teine baasvaade, mis tähendab teistsugust taotlust baasi omanikule.
Reeglit hoitakse andmebaasis, mitte ainult marsruudis. Iga organisatsiooni vaated asuvad pistikprogrammide registri skeemi neljas tabelis:
| Tabel | Mida see sisaldab |
|---|---|
plugins.lenses |
Ühe omaniku üks vaade, pakett (owner_kind pack) või platvorm (platform): selle slug ja name, selle base_lens_id, liigid, mida see shows ja hides, alad, mida see opens, selle status (active või withdrawn) ja selle version |
plugins.lens_grants |
Vaade, mis on antud ühele rollile (owner, admin, member, viewer, developer või billing_admin) ühes äriüksuses |
plugins.lens_changes |
Iga muudatus vaates või selle õigustes, säilitatuna enne- ja pärast-olekuna koos sellega, kes selle tegi ja miks. Ainult lisamine |
plugins.lens_holder_months |
Mitu inimest omas üksuses vaadet igal kuul. Arv, mitte kunagi isikud |
Päästik lükkab tagasi iga vaate, mis näitab rohkem kui selle baas, ning lükkab tagasi baasi muudatuse, mille tulemusel sellele ehitatud vaade näitaks rohkem kui baas. Midagi ei kustutata. Vaated ja õigused võetakse tagasi ning vaate uuesti andmine on uus rida; muudatust ei kirjutata kunagi üle ja möödunud kuu arvu ei muudeta kunagi. Iga rida viitab liitvõtme kaudu oma organisatsiooni vaatele, seega ei saa õigus osutada üle organisatsioonide.
Konsool ja teie enda tööriistad pääsevad registrile ligi /api/v1/lenses kaudu, kasutades inimese enda kandjatõendit. Organisatsioon ja inimene ning üksuse koht tulenevad kontrollitud tõendist ja mitte millestki muust.
| Meetod ja tee | Mida see teeb |
|---|---|
GET / |
Vaated, filtreerituna owner_kind, owner_id ja status järgi, koos nende õigustega teie kohas |
POST / |
Vaate lisamine: owner_kind, owner_id, slug, name, shows ja valikuliselt description, base_lens_id, hides, opens ja reason |
GET /owners/:kind/:id |
Paketi või platvormi vaated ja see, milline neist näitab iga liiki |
GET /owners/:kind/:id/grants |
Vaated üksuste kaupa: igale vaatele antud rollid ja inimesed, keda see hõlmab |
GET /owners/:kind/:id/holders |
Vaadet omavad inimesed kuude kaupa (months, vaikimisi kuus) |
POST /owners/:kind/:id/holders/count |
Selle kuu arvude salvestamine |
GET /owners/:kind/:id/changes |
Omaniku vaadete muudatuste ajalugu (limit, vaikimisi 50) |
GET /:lensId |
Üks vaade koos oma baasi ja seda kitsendavate vaadetega ning selle õiguste ja muudatustega |
PATCH /:lensId |
Vaate muutmine: name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Vaate tagasivõtmine koos selle õigustega. Vaadet, mida kitsendab mõni teine aktiivne vaade, ei saa tagasi võtta enne, kui see teine on tagasi võetud |
POST /:lensId/grants |
Vaate andmine: business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Ühe õiguse tagasivõtmine |
:kind on pack või platform. Iga tagasilükkamine sisaldab koodi koos lause ja järgmise sammuga ning ootamatu tõrke korral vastatakse UNHANDLED_ERROR, mille põhjus on teenuse logis, mitte kunagi vastuses.
Teadmismudel, konnektorid ja kompileeritud ajud
Teadmusmudel on objektiliigid, mida pakett tunneb, ja see, kuidas need on seotud. See on versioonitud ja pakett tugineb tavaliselt baasmudelile paketist, millest see pärib: logistika baasmudelil põhinev külmaahela pakett lisab viis liiki (nende hulgas külmutuskonteiner ja laevakülastus) ning seob kaks neist baasiga ilma baasi ennast muutmata. Iga omadus klassifitseeritakse selle loomisel, nii et isikuandmete väljad ja ärilised väljad on teada enne, kui ükski vaade või andmeharu neid kasutab. Tehnikute vaade ei saa seejärel näidata nõude summat, mis on klassifitseeritud äriliseks. Tagasivõetud omadus jääb versiooni, milles see oli, ja kaob alles hilisemas versioonis. Uue versiooni ettevalmistamisel kopeeritakse esmalt teadmus ja tagasitee jääb kindlaks ajaks avatuks.
Konnektorid toovad kirjed sisse süsteemidest, mis neid juba hoiavad: poliisihaldus, nõuete süsteem, postikaust partnerite saadetud failidega. Iga konnektor on kirjutuskaitstud, töötab oma ajakava järgi ja sellel on testinupp. Kirjed vastendatakse sisenemisel paketi sõnavarale ja need jõuavad teadmusmudelisse, mida vaated loevad; assistendi vastused viitavad sellele. Nexusest ei kirjutata midagi tagasi lähtesüsteemi.
Kompileeritud ajud on paketi osad, mis teevad otsuseid: näiteks paketi Kindlustus riskihindamise aju ja nõuete aju. Need töötavad serveris kompileeritud, litsentsitud moodulitena, millest igaüks kontrollib litsentsi ise, ning neid ei tarnita kunagi telefoni ega brauserisse.
Mobiilikiht ja võrguvälised väljad
Pakett deklareerib oma telefoniekraanid samas manifestis mobiilse kihina: millised kaardid ja jäädvustussammud telefonides kuvatakse ning milliste rollide jaoks. Seejärel määrab administraator telefonide reeglid organisatsiooni kaupa, näiteks kui kaua jäädvustused võivad võrguühenduseta oodata, kas igal fotol on kaasas pildistamise asukoht ja kas kinnitused nõuavad pääsuvõtit. Seadistamine toimub arvutis; administraator näeb telefonide saadetut nimede ja arvudena, mitte kunagi fotode ega märkmetena endina.
Iga väli, mida telefoniekraan ilma levita pakub, deklareerib ühe kolmest klassist ja ekraan näitab, millise:
| Klass | Mis sellega juhtub | Näited |
|---|---|---|
| Koostatud võrguühenduseta | Salvestatakse telefoni ja ühendatakse, kui telefon uuesti võrku ühendub | Märkmed, fotod, näidud |
| Pakutud võrguühenduseta | Saadetakse ettepanekuna, mille üle otsustab kontor. Server ei ühenda seda kunagi; see esitab selle uuesti oma volituste kontrollide kaudu | Summa, leid, reservi muudatus, otsus |
| Mitte kunagi võrguühenduseta | Väljas pole võimalik. Kuvatakse reana koos põhjusega, mitte kunagi nupuna | Allkiri, pitser, volituste kontroll, sanktsiooninimekirja kontroll |
Kihid ei sisalda reegleid ega viipasid ega ka ajusid. Need on loetavad ekraanimääratlused ja kõik otsustav jääb serverisse. Paketi telefoniekraanid avanevad ainult Nexuse telefonirakendustes ja ainult siis, kui organisatsioonil on nii pakett kui ka lisamoodul Mobiilirakendused.
Kasutusõigus: kellel on pakett ja kus see töötab
Pakett on litsentsitud, seda ei lülitata kunagi sisse konfiguratsiooniga. Kolm kihti otsustavad, kes seda näeb.
Litsents. Allkirjastatud litsentsidokument sisaldab maatriksi id-de loendit domain_packs (kuni 100, võib olla tühi) oma funktsioonirühmade grants ja add_ons kõrval. Adveranti konsool ei väljasta paketti ilma lisamooduliteta, mida see vajab: paketti, mis nõuab otsustusruume ja pitseeritud kirjeid, ei saa väljastada litsentsile, millel seda pole. Litsentsi funktsioonirühmad antakse kas kogu paigaldusele või nimetatud organisatsioonidele ning õiguste kontroll vastab organisatsiooni kaupa. Kui õigus eemaldatakse, muutub iga paketi vaade ja telefoniekraan tutvustuseks, kusjuures selle kirjed säilitatakse.
Õiguste kontroll. Iga organisatsiooni ja plaani, iga rolli ja iga isiku puhul otsustab õiguste kontroll, kas paketi lisatud juhtelement on lubatud, kuvatakse tutvustusena, peidetakse või keelatakse koodiga. See juhib menüüridu ja paneelide vahekaarte ning marsruudi- ja suunamiskontrolle. Suletud moodul jääb oma õiguste andmisel ainupädevaks.
Üksused ja vaated. Organisatsioonis, millel pakett on, otsustab administraator, kus see töötab. Pakett lülitatakse üksuse jaoks sisse etappide kaupa, mitte kunagi kogu üksusele korraga: litsentsikontroll, pilootrühm, seadete eelseadistus ja seejärel laiendamine kõigile üksuse liikmetele administraatori valitud kuupäeval. Enne mis tahes muudatust näitab leht rollide kaupa, kes mida juurde saab. Seejärel antakse vaated rolli ja üksuse kaupa ühes maatriksis. Kui pakett hiljem üksuse jaoks välja lülitada, säilivad kõik inimeste loodud kirjed; vaated ja mallid kaovad ning midagi muud ei muutu.
Kümme paketti
Adverant pakub kümmet valdkonnapaketti. Igaüks neist vajab Enterprise'i baaslitsentsi ja mõned vajavad lisamooduleid. Iga paketi telefonikuvad vajavad lisaks lisamoodulit Mobile apps.
| Pakett | Maatriksi ID | Mida see pakub | Lisaks vajab see |
|---|---|---|---|
| Kindlustus | insurance |
Kindlustusvaated muu hulgas riskihindamise, kahjunõuete, edasikindlustuse, Lloyd'si ja delegeeritud volituste jaoks; pettuste ja uurimiste töövoog; kindlustuse e-poe teekonnad ja seaded; kindlustuse kompileeritud ajud | Otsustusruumid ja pitseeritud kirjed |
| Pangandus ja maksed | financial-services |
Sisseostetud tehnoloogia register; tehnoloogiaintsidentide tähtajad ja aruanded; kriitiliste teenusepakkujate väljumisplaanid; laenuotsused; kaardivaidlused | Ei midagi peale baaslitsentsi |
| Kapitaliturud ja varahaldus | capital-markets |
Vaated uuringuanalüütikule, portfellihaldurile, järelevalvele ja vastavusele ning kliendiaruandlusele; kauplemislaudade kõned salvestatakse; uuringud hoitakse kuni avaldamiseni tõkke taga; mallid tõkke ületamise logi, kõnede ülevaatuse ja uuringute avaldamise jaoks. Telefonid saavad hommikuse ülevaate ja avaldamiskinnitused ning järelevalvehoiatused, mitte kunagi korraldusi | Otsustusruumid ja pitseeritud kirjed |
| Valitsus ja avalik sektor | government |
Hüvitise- ja õigustenõuded; planeerimistaotlused; teabenõuded | Ei midagi peale baaslitsentsi |
| Tervishoid | healthcare-providers |
Patsiendiandmetele juurdepääs ja nende jagamine ning teabenõuded. Kliinilise otsuse tuge ei ole | Ei midagi peale baaslitsentsi |
| Bioteadused | life-sciences |
Kõrvalekalded ja parandusmeetmed; partiikirjete ülevaatus; valideeritud muudatuste haldus | Ei midagi peale baaslitsentsi |
| Elutähtis taristu ja energeetika | energy-and-utilities |
Intsidentide tähtajad ja aruanded; ülevaatused ja puudused; tööde tellimused | Ei midagi peale baaslitsentsi |
| Kaitse ja julgeolek | defence-and-mission |
Väliaruanded, mis on ühendatud platvormi hoiatustega; jagamismärgistused; järelarutelud. Selle telefoniversioon paigaldatakse ainult seadmehalduse kaudu | Nexus Edge, platvormi hoiatuste jaoks |
| Õigus- ja kutseteenused | legal |
Vaated tasu teenivale juristile, teadmusjuristile, huvide konfliktidele ja riskidele ning arveldusele; huvide konflikti kontroll iga uue asja juures; eetilised tõkked, mida saavad tühistada ainult kaks partnerit; mallid uue asja kontrolli, tõkke koostaja ja tõkke meeldetuletuste jaoks. Telefonid saavad ajaarvestuse ja asjade uuendused koos kinnitustega, mitte kunagi privilegeeritud faile | Otsustusruumid ja kinnitatud kirjed ning e-post |
| Logistika ja merendus | logistics-and-maritime |
Vaated operatsioonide kontrollerile, tolliametnikule, vedajate haldurile ja sadamainspektorile; tollideklaratsioonid ja kinnipidamised; sanktsioonikontrollid enne esimest broneeringut, kusjuures iga kinnipidamise vabastab inimene; sadamate ja laevade, vedajate ja kinnipidamiste teadmusmudel. Telefonid saavad laoplatsi ja kaikoha ülevaatused ning tollikinnipidamised koos droonileidudega | Kaart ja GeoAI |
Harrow Port Authority kasutab logistika ja merenduse paketti ning just seda soovitaksin lugeda esimesena, kui ehitate oma paketti: selle teadmusmudel on alus, millele ülaltoodud külmaahela näide tugineb.
Oma lahenduse loomine
Enterprise'i puhul alustab arendaja paketti kuldsest rajast jaotises Start something new kolmes etapis. „About it“ annab paketile nime ning määrab selle üksused, paketi, millele see tugineb, ja reeglid, mille kohta see peab tõendeid esitama. „Knowledge model“ lisab baasmudeli peale uued objektitüübid. „Review and create“ näitab plaani ja seejärel täidab selle. See loob paketimallist hoidla koos manifestiga, mis deklareerib, millele pakett võib ligi pääseda, ning selle testid; seejärel sünteetiliste andmeharudega arenduskeskkonna; seejärel kataloogikirje mustandi, mida näete ainult teie. Midagi ei looda enne, kui vajutate viimases etapis nuppu Create. Peatükk 2.24, kohandatud valdkonnalahenduse ehitamine algusest lõpuni, käsitleb kogu teekonda.
Mis pakett teile maksma läheb
Pakett on kõige kallim laiendus omada. Selle teadmusmudelil on versioonid, millest inimesed sõltuvad, nii et omadus, mida kahetsete, jääb versiooni, millega see välja anti. Selle vaated saavad ainult piirata, nii et roll, mis vajab rohkem, tähendab arutelu baasvaate üle. Selle tõendite kaart nimetab reegleid, mille teie enda õigusnõustaja peab kinnitama, enne kui keegi sellele tugineb. Ja klient saab selle ainult oma litsentsi kaudu: võite ehitada valdkonna parima paketi ega saa seda siiski ühegi üksuse jaoks sisse lülitada enne, kui organisatsiooni litsents seda hõlmab. Vastutasuks maksab kolmekümnes üksus, mis seda soovib, teile vaid ühe lüliti ja ühe piloodi.




