Versão 1.0.0-alpha.1mais recente
Capítulo 2.23
Pacotes de domínio
De que é feito um pacote de domínio e o que diz o seu pack.json; lentes e o registo de lentes; modelos de conhecimento, conectores e sobreposições móveis; como um pacote é licenciado e ativado para uma unidade; e os dez pacotes que a Adverant disponibiliza.
Esta página foi traduzida por IA a partir do original em inglês. Em caso de dúvida, a página em inglês serve de referência. Ler esta página em inglês

O pacote que construí na Corrán Orbital começou como dois plugins e uma dúzia de competências do Skills Engine que apenas a nossa equipa da estação terrestre utilizava. Quando a unidade de operações de missão pediu o mesmo, tive uma escolha: copiar tudo e manter dois de cada, ou transformá-lo num pacote de domínio com um modelo de conhecimento e duas lentes, ativadas por unidade. Demorei uma semana a torná-lo num pacote. Faria a mesma escolha novamente amanhã e, da próxima vez, começaria logo pelo pacote.
Um pacote de domínio traz a forma de trabalhar de um setor para o Nexus. Contém os tipos de coisas do setor e como se ligam, bem como o que cada função vê. Transporta os modelos e fluxos de trabalho que as pessoas usam todos os dias, as evidências que as regras do setor exigem e os ecrãs que funcionam num telemóvel sem rede. Nunca altera a estrutura base nem os seus componentes, e nunca altera as regras de escrita. Um novo setor é um pacote, não uma aplicação.
De que é feito um pacote
Na sua base, um pacote é composto por quatro elementos, e nenhum deles é código específico do pacote na plataforma:
- Um conjunto de grupos de funcionalidades na verificação de direitos. Os controlos do pacote pertencem a um conjunto de grupos de funcionalidades. Cada linha de menu e separador de painel que o pacote adiciona é então decidido pelo mesmo mecanismo que o resto do Nexus: com direito de acesso, mostrado como pré-visualização ou oculto.
- Um manifesto do pacote,
pack.json, que declara os grupos de ecrãs do pacote e o seu vocabulário, as suas lentes e os seus ecrãs para telemóvel. - Módulos fechados que verificam a sua própria concessão. O código do servidor que toma decisões, como os cérebros compilados de um pacote, traz o verificador de licenças no seu interior e valida ele próprio a licença assinada. Nada fora do módulo o pode ativar.
- Uma entrada de catálogo, para que o pacote apareça na página Pacotes de domínio com o que inclui e o que requer.
Acima destes elementos encontram-se as partes que as pessoas veem: o modelo de conhecimento e as lentes; modelos, fluxos de trabalho e competências do Skills Engine; conectores só de leitura para os sistemas que já guardam os registos, um mapa de evidências que liga cada regra aos registos que lhe respondem e uma sobreposição móvel.
O ficheiro pack.json
Aqui está o manifesto do pacote Banca e pagamentos, reduzido a uma lente com um lugar e dois termos. O seu identificador de ficheiro é fintech, e name guarda o nome de trabalho do pacote; a consola e o catálogo mostram-no como Banca e pagamentos.
{
"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"
}
]
}
}Os campos, de cima para baixo:
| Campo | O que indica |
|---|---|
id |
O identificador do pacote, em minúsculas |
name |
O seu nome de trabalho |
version |
A versão própria do pacote |
inherits |
O pacote sobre o qual este se baseia. Banca e pagamentos herda de Seguros, que detém os grupos partilhados que todos os pacotes usam, tais como a conversação e as definições. Um novo pacote adiciona as suas lentes e deixa os grupos partilhados no pacote do qual herda |
screenCount |
Quantos ecrãs o pacote define |
clusters[] |
Os grupos de ecrãs do pacote. Cada um tem um id, um kind, um name, a seats a que se destina, o seu purpose, os conjuntos de lexicon de onde provêm as suas palavras, os seus menu e os seus screens, cada um com um id, um title, who e para que doing servem |
clusters[].kind |
shared para um grupo que qualquer lente pode alcançar (a conversação, por exemplo); lens para os ecrãs próprios de uma função. O scope de um grupo indica se pertence ao núcleo (core) ou ao setor (domain) |
lexicon |
As palavras do pacote, em conjuntos com nome. Cada termo tem uma explicação simples que um recém-chegado pode ler, e a terceira posição é exact para um termo que deve ser usado palavra por palavra, como um indicador regulamentar |
world |
O mundo de exemplo de inquilinos e lugares fictícios que os ecrãs e testes do pacote utilizam, bem como as suas ramificações de dados |
world.tenants[].plan |
O areas do plano: os grupos e lentes que o plano deste inquilino abre, de um total de of |
world.tenants[].ai |
A política de IA (inteligência artificial) da organização para o pacote: se são permitidos modelos no dispositivo (onDevice), para onde podem ir os dados pessoais num modelo na nuvem (personalDataToCloudModels, tal como uk-only ou eu-only), e se a selagem de um registo requer despacho UNO (sealRequiresUno) |
world.seats[] |
O lugar de uma pessoa: o seu title, a lens que detém, os clusters partilhados que também alcança, o seu ecrã home, o seu posture (desk, field ou consumer) e, no ficheiro completo, os seus authority, os limites dentro dos quais atua |
Duas regras governam o que um ficheiro pack.json pode conter. Um regulamento é nomeado em palavras simples com uma explicação, nunca apenas como uma sigla isolada. E nada no ficheiro é código: trata-se de uma definição legível que o servidor e as aplicações interpretam, pelo que nunca contém uma regra ou um prompt, nem nunca um cérebro compilado.
Lentes partilhadas
Alguns regimes pertencem a vários setores. Um registo de tecnologia subcontratada serve Seguros e Banca e pagamentos; os relógios de incidentes (as contagens decrescentes para os relatórios que um regulador espera após um incidente) servem tanto Infraestruturas críticas e energia como Governo e setor público. Um regime que vários pacotes utilizam é escrito uma única vez como uma lente partilhada. Cada pacote que dele necessita inclui-o. Quando a regra muda, muda num só lugar.
Uma lente apenas restringe
Uma lente é o que uma função vê dentro de um pacote ou de uma plataforma: que cartões e campos, e que ações. É sempre definida como um estreitamento de uma lente base. Uma lente com base não mostra nenhum tipo de coisa que a sua base não mostre e não abre nenhuma área que a sua base não abra, e não pode simultaneamente mostrar e ocultar o mesmo tipo. As permissões continuam a vir das funções; uma lente altera a visualização, nunca o que uma pessoa pode fazer.
Se tentar alargar uma, a resposta é LENS_CANNOT_WIDEN (422), sem que nada seja guardado. No construtor de lentes, para uma lente de técnico de refrigeração construída sobre uma base de controlador de operações que não mostra montantes de indemnização, lê-se: «O montante de indemnização não pode ser adicionado a esta lente». A solução passa por uma lente base diferente, o que implica um pedido diferente a quem detém a base.
A regra é mantida na base de dados, não apenas na rota. As lentes de cada organização residem em quatro tabelas do esquema do registo de plugins:
| Tabela | O que contém |
|---|---|
plugins.lenses |
Uma lente de um proprietário, um pacote (owner_kind pack) ou uma plataforma (platform): o seu slug e name, a sua base_lens_id, os tipos que shows e hides, as áreas que opens, o seu status (active ou withdrawn) e o seu version |
plugins.lens_grants |
Uma lente atribuída a uma função (owner, admin, member, viewer, developer ou billing_admin) numa unidade de negócio |
plugins.lens_changes |
Cada alteração a uma lente ou às suas concessões, guardada como o estado anterior e posterior, com quem a fez e porquê. Apenas de adição |
plugins.lens_holder_months |
Quantas pessoas detiveram uma lente numa unidade em cada mês. Uma contagem, nunca quem |
Um acionador (trigger) recusa qualquer lente que mostre mais do que a sua base, e recusa uma alteração a uma base que deixasse uma lente construída sobre ela a mostrar mais do que a própria base. Nada é eliminado. As lentes e concessões são retiradas, e atribuir uma lente novamente cria uma nova linha; uma alteração nunca é reescrita e a contagem de um mês passado nunca é alterada. Cada linha cita uma lente da sua própria organização através de uma chave composta, pelo que uma concessão não pode apontar entre organizações diferentes.
A consola e as suas próprias ferramentas acedem ao registo através de /api/v1/lenses, com o token de portador (bearer token) da própria pessoa. A organização, a pessoa e o lugar na unidade provêm do token verificado e de mais nada.
| Método e caminho | O que faz |
|---|---|
GET / |
Lentes, filtradas por owner_kind, owner_id e status, com as respetivas concessões no seu lugar |
POST / |
Adicionar uma lente: owner_kind, owner_id, slug, name, shows e, opcionalmente, description, base_lens_id, hides, opens e reason |
GET /owners/:kind/:id |
As lentes de um pacote ou plataforma, e qual delas mostra cada tipo |
GET /owners/:kind/:id/grants |
Lente por unidade: as funções a que foi atribuída cada lente e as pessoas que esta abrange |
GET /owners/:kind/:id/holders |
Pessoas que detêm uma lente em cada mês (months, seis por predefinição) |
POST /owners/:kind/:id/holders/count |
Registar as contagens deste mês |
GET /owners/:kind/:id/changes |
O histórico de alterações das lentes do proprietário (limit, 50 por predefinição) |
GET /:lensId |
Uma lente com a sua base e as lentes que a estreitam, bem como as suas concessões e alterações |
PATCH /:lensId |
Alterar uma lente: name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Retirar uma lente e as respetivas concessões com ela. Uma lente que outra lente ativa estreite não pode ser retirada até que essa outra o seja |
POST /:lensId/grants |
Atribuir uma lente: business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Retirar uma concessão |
:kind é pack ou platform. Cada recusa inclui um código com uma frase e um passo seguinte, e uma falha inesperada responde UNHANDLED_ERROR registando a sua causa no registo do serviço, nunca na resposta.
Modelo de conhecimento, conectores e cérebros compilados
O modelo de conhecimento corresponde aos tipos de coisas que o pacote conhece e à forma como se ligam. Tem controlo de versões e um pacote baseia-se normalmente num modelo base do pacote do qual herda: um pacote de cadeia de frio sobre o modelo base de logística adiciona cinco tipos (unidade de refrigeração e escala de navio entre eles) e liga dois deles à base sem alterar a base em si. Cada propriedade é classificada quando é criada, para que os campos pessoais e os comerciais sejam conhecidos antes de qualquer lente ou ramificação de dados os utilizar. Assim, uma lente para técnicos não pode mostrar um montante de indemnização classificado como comercial. Uma propriedade retirada permanece na versão que a continha e só sai numa versão posterior. A preparação de uma nova versão copia primeiro o conhecimento e o caminho de regresso permanece aberto durante um período definido.
Os conectores trazem registos a partir dos sistemas que já os detêm: administração de apólices, um sistema de sinistros, uma pasta de correio com ficheiros que os parceiros enviam. Cada um é só de leitura, é executado no seu próprio horário e tem um botão de teste. Os registos são mapeados para as palavras do pacote à entrada e aterram no modelo de conhecimento que as lentes leem; as respostas do assistente citam-no. Nada é escrito de volta no sistema de origem a partir do Nexus.
Os cérebros compilados são as partes de um pacote que tomam decisões: o cérebro de subscrição do pacote Seguros e o seu cérebro de sinistros, por exemplo. São executados no servidor como módulos compilados e licenciados, verificando cada um a própria licença, e nunca são enviados para um telemóvel ou navegador.
A sobreposição móvel e os campos offline
Um pacote declara os seus ecrãs para telemóvel no mesmo manifesto, como uma sobreposição móvel: que cartões e passos de recolha aparecem nos telemóveis, e para que funções. Um administrador define então as regras nos telemóveis por organização, tais como quanto tempo as recolhas podem aguardar offline, se cada fotografia inclui o local onde foi tirada e se as aprovações necessitam de uma chave de acesso (passkey). A configuração mantém-se num computador; o administrador vê o que os telemóveis enviam sob a forma de nomes e contagens, nunca as próprias fotografias ou notas.
Cada campo que um ecrã de telemóvel oferece sem rede declara uma de três classes, e o ecrã mostra qual:
| Classe | O que lhe acontece | Exemplos |
|---|---|---|
| Criado offline | Guardado no telemóvel e intercalado quando o telemóvel se volta a ligar | Notas, fotografias, leituras |
| Proposto offline | Enviado como uma sugestão que o escritório decide. O servidor nunca o intercala; reprodu-lo através das suas próprias verificações de autoridade | Um montante, uma conclusão, uma alteração de reserva, uma decisão |
| Nunca offline | Não é possível no terreno. Desenhado como uma linha com o respetivo motivo, nunca como um botão | Uma assinatura, um selo, uma verificação de autoridade, uma verificação contra uma lista de sanções |
As sobreposições não contêm regras nem prompts, nem tão-pouco cérebros. São definições de ecrã legíveis, e tudo o que toma decisões permanece no servidor. Os ecrãs de telemóvel de um pacote abrem apenas dentro das aplicações móveis do Nexus, e apenas quando a organização detém tanto o pacote como o suplemento Aplicações móveis.
Direitos de utilização: quem tem o pacote e onde é executado
Um pacote é licenciado, nunca ativado por configuração. Três camadas decidem quem o vê.
A licença. O documento de licença assinado contém uma lista domain_packs de identificadores de matriz (no máximo 100, possivelmente vazia), ao lado dos seus grupos de funcionalidades grants e add_ons. A consola da Adverant não emitirá um pacote sem os suplementos de que este necessita: um pacote que exija Salas de decisão e registos selados não pode ser emitido para uma licença sem esse suplemento. Os grupos de funcionalidades numa licença são concedidos a toda a instalação ou a organizações nomeadas, e a verificação de direitos responde por organização. Se remover a concessão, cada lente e ecrã de telemóvel do pacote passa a ser uma pré-visualização, mantendo os seus registos.
A verificação de direitos. Para cada organização e plano, cada função e cada pessoa, a verificação de direitos decide se um controlo que o pacote adiciona tem direito de acesso, é mostrado como pré-visualização, fica oculto ou é recusado com um código. Esta verificação governa as linhas de menu e os separadores de painel, bem como as verificações de rota e de despacho. O módulo fechado continua a ser a autoridade para a sua própria concessão.
Unidades e lentes. Dentro de uma organização que possui o pacote, um administrador decide onde este é executado. Um pacote é ativado para uma unidade por fases, nunca para toda a unidade de uma só vez: a verificação da licença, um grupo piloto, uma predefinição de configurações e, depois, o alargamento a todos na unidade numa data escolhida pelo administrador. Antes de qualquer alteração, a página mostra quem ganha o quê, por função. As lentes são então atribuídas por função e por unidade, numa única matriz. Desativar o pacote para uma unidade mais tarde mantém todos os registos que as pessoas criaram; as lentes e os modelos desaparecem, e nada mais muda.
Os dez pacotes
A Adverant disponibiliza dez pacotes de domínio. Cada um necessita da licença base Enterprise e alguns necessitam de suplementos. Os ecrãs de telemóvel de cada pacote necessitam também do suplemento Aplicações móveis.
| Pacote | ID da matriz | O que inclui | O que também requer |
|---|---|---|---|
| Seguros | insurance |
Lentes de seguros para subscrição, sinistros, resseguro, Lloyd's e autoridade delegada, entre outros; o fluxo de fraude e investigações; jornadas e definições de loja digital de seguros; os cérebros compilados de seguros | Salas de decisão e registos selados |
| Banca e pagamentos | financial-services |
Um registo de tecnologia subcontratada; relógios e relatórios de incidentes tecnológicos; planos de saída para fornecedores críticos; decisões de concessão de crédito; disputas de cartões | Nada além da base |
| Mercados de capitais e gestão de ativos | capital-markets |
Lentes para o analista de investigação, o gestor de carteira, vigilância e conformidade, e relatórios de clientes; chamadas em mesas de negociação gravadas; investigação mantida atrás de uma barreira até à publicação; modelos para o registo de cruzamento de barreiras (wall-crossing), revisão de chamadas e publicação de investigação. Os telemóveis recebem o resumo matinal e as aprovações de publicação, bem como alertas de vigilância, nunca ordens | Salas de decisão e registos selados |
| Governo e setor público | government |
Pedidos de prestações e direitos; pedidos de licenciamento urbanístico; pedidos de informação | Nada além da base |
| Saúde | healthcare-providers |
Acesso e partilha de processos clínicos de doentes, e pedidos de informação. Sem apoio à decisão clínica | Nada além da base |
| Ciências da vida | life-sciences |
Desvios e ações corretivas; revisão de registos de lote; controlo de alterações validado | Nada além da base |
| Infraestruturas críticas e energia | energy-and-utilities |
Relógios e relatórios de incidentes; inspeções e defeitos; ordens de trabalhos | Nada além da base |
| Defesa e segurança | defence-and-mission |
Relatórios de campo fundidos com alertas da plataforma; marcações de partilha; relatórios pós-missão (debriefs). A sua versão para telemóvel é instalada apenas através da gestão de dispositivos | Nexus Edge, para os alertas da plataforma |
| Serviços jurídicos e profissionais | legal |
Lentes para o advogado faturador, o advogado de gestão de conhecimento, conflitos e risco, e faturação; uma verificação de conflitos em cada novo assunto; barreiras éticas levantadas apenas por dois sócios; modelos para verificação de novo assunto, construtor de barreiras e lembretes de barreiras. Os telemóveis recebem registo de tempo e atualizações de assuntos com aprovações, nunca ficheiros sujeitos a sigilo profissional | Salas de decisão e registos selados, e Correio |
| Logística e setor marítimo | logistics-and-maritime |
Lentes para o controlador de operações, o oficial aduaneiro, o gestor de transportadoras e o inspetor portuário; declarações e retenções aduaneiras; verificações de sanções antes da primeira reserva, com uma pessoa a libertar cada retenção; um modelo de conhecimento de portos e navios, transportadoras e retenções. Os telemóveis recebem inspeções de pátio e de cais e retenções aduaneiras, com conclusões de drones | Mapa e GeoAI |
A Harrow Port Authority executa o pacote Logística e marítimo, e é o que eu leria primeiro se estivesse a construir o seu próprio pacote: o seu modelo de conhecimento é a base sobre a qual assenta o exemplo da cadeia de frio acima.
Construir o seu próprio pacote
No plano Enterprise, um programador inicia um pacote a partir do caminho padrão em Começar algo novo, em três passos. «Sobre o pacote» dá o nome ao pacote, às suas unidades, ao pacote em que se baseia e às regras para as quais deve apresentar evidências. «Modelo de conhecimento» adiciona os novos tipos de coisas sobre o modelo base. «Rever e criar» mostra o plano e depois executa-o. Cria um repositório a partir do modelo de pacote com um manifesto que declara o que o pacote pode alcançar e os respetivos testes; depois, um espaço de desenvolvimento com ramificações de dados sintéticos; depois, um rascunho de entrada de catálogo que apenas o utilizador pode ver. Nada é criado até premir Criar no último passo. O Capítulo 2.24, Construir uma vertical personalizada de ponta a ponta, percorre todo o caminho.
Quanto lhe custa um pacote
Um pacote é a extensão mais dispendiosa de manter. O seu modelo de conhecimento tem versões das quais as pessoas dependem, pelo que uma propriedade de que se arrependa permanece na versão em que foi lançada. As suas lentes só podem retirar elementos, pelo que uma função que precise de ver mais implica uma conversa sobre a lente base. O seu mapa de evidências nomeia regras que o seu próprio departamento jurídico tem de confirmar antes que alguém confie nele. E um cliente só o obtém através da sua licença: pode construir o melhor pacote do setor e, ainda assim, não o ativar para uma única unidade até que a licença da organização o inclua. Em contrapartida, a trigésima unidade que o quiser custa-lhe apenas um interruptor e um piloto.




