Versión 1.0.0-alpha.1 más reciente
Capítulo 2.23
Paquetes de dominio
De qué se compone un paquete de dominio y qué indica su archivo pack.json; lentes y el registro de lentes; modelos de conocimiento, conectores y superposiciones móviles; cómo se otorga la licencia de un paquete y cómo se activa para una unidad; y los diez paquetes que suministra Adverant.
Esta página fue traducida por IA a partir del original en inglés. Si algo no está claro, la página en inglés es la referencia. Leer esta página en inglés

El paquete que creé en Corrán Orbital comenzó como dos complementos y una docena de habilidades de Skills Engine que solo utilizaba nuestro equipo de estación terrena. Cuando la unidad de operaciones de misión pidió lo mismo, tuve que elegir: copiar todo y mantener dos versiones de cada cosa, o convertirlo en un paquete de dominio con un modelo de conocimiento y dos lentes, activados por unidad. Me llevó una semana convertirlo en un paquete. Volvería a tomar la misma decisión mañana mismo, y la próxima vez empezaría directamente por el paquete.
Un paquete de dominio lleva la forma de trabajar de un sector a Nexus. Contiene los tipos de elementos del sector, cómo se vinculan y qué ve cada rol. Incluye las plantillas y los flujos de trabajo que las personas usan a diario, las evidencias que exigen las normas del sector y las pantallas que funcionan en un teléfono sin cobertura. Nunca modifica el entorno ni sus componentes, ni tampoco las reglas de escritura. Un nuevo sector es un paquete, no una aplicación.
De qué se compone un paquete
Por debajo, un paquete consta de cuatro elementos, y ninguno de ellos es código específico del paquete en la plataforma:
- Un conjunto de grupos de funciones en la comprobación de derechos. Los controles del paquete pertenecen a un conjunto de grupos de funciones. Cada fila de menú y pestaña de panel que añade el paquete se decide entonces mediante el mismo mecanismo que el resto de Nexus: con derecho de acceso, mostrado como avance o oculto.
- Un manifiesto del paquete,
pack.json, que declara las agrupaciones de pantallas del paquete y su vocabulario, sus lentes y sus pantallas para teléfono. - Módulos cerrados que verifican su propia concesión. El código de servidor que toma decisiones, como los cerebros compilados de un paquete, lleva integrado el verificador de licencias y comprueba por sí mismo la licencia firmada. Nada externo al módulo puede activarlo.
- Una entrada de catálogo, para que el paquete aparezca en la página de paquetes de dominio con lo que aporta y lo que necesita.
Sobre estos elementos se sitúan las partes que ven los usuarios: el modelo de conocimiento y las lentes; las plantillas, los flujos de trabajo y las habilidades de Skills Engine; los conectores de solo lectura hacia los sistemas que ya contienen los registros, un mapa de evidencias que vincula cada norma con los registros que la cumplen y una capa móvil.
El archivo pack.json
Aquí tiene el manifiesto del paquete de Banca y pagos, reducido a una lente con un puesto y dos términos. Su identificador de archivo es fintech, y name contiene el nombre de trabajo del paquete; la consola y el catálogo lo muestran como Banca y pagos.
{
"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"
}
]
}
}Los campos, de arriba abajo:
| Campo | Qué indica |
|---|---|
id |
El identificador del paquete, en minúsculas |
name |
Su nombre de trabajo |
version |
La versión propia del paquete |
inherits |
El paquete sobre el que se basa este. Banca y pagos hereda de Seguros, que contiene las agrupaciones compartidas que utilizan todos los paquetes, como la conversación y la configuración. Un paquete nuevo añade sus lentes y deja las agrupaciones compartidas al paquete del que hereda |
screenCount |
Cuántas pantallas define el paquete |
clusters[] |
Los grupos de pantallas del paquete. Cada uno tiene un id, un kind, un name, el seats al que se destina, su purpose, los conjuntos lexicon de los que proceden sus términos, su menu y sus screens, cada uno con un id, un title, who y para qué son doing |
clusters[].kind |
shared para una agrupación a la que puede acceder cualquier lente (por ejemplo, la conversación); lens para las pantallas propias de un rol. El scope de una agrupación indica si pertenece al núcleo (core) o al sector (domain) |
lexicon |
Los términos del paquete, en conjuntos con nombre. Cada término tiene una glosa sencilla que un recién llegado puede entender, y la tercera posición es exact para un término que debe utilizarse palabra por palabra, como una cifra regulatoria |
world |
El entorno de ejemplo de inquilinos y puestos ficticios que utilizan las pantallas y pruebas del paquete, y sus ramas de datos |
world.tenants[].plan |
El areas del plan: las agrupaciones y lentes que abre el plan de este inquilino, de entre of |
world.tenants[].ai |
La política de IA (inteligencia artificial) de la organización para el paquete: si se permiten modelos en el dispositivo (onDevice), a dónde pueden enviarse datos personales a un modelo en la nube (personalDataToCloudModels, como uk-only o eu-only), y si el sellado de un registro requiere despacho UNO (sealRequiresUno) |
world.seats[] |
El puesto de una persona: su title, la lens que ocupa, las clusters compartidas a las que también accede, su pantalla home, su posture (desk, field o consumer) y, en el archivo completo, sus authority, los límites dentro de los cuales actúa |
Dos reglas rigen lo que puede contener un archivo pack.json. Una normativa se nombra con palabras claras y una glosa, nunca como una simple sigla. Y nada en el archivo es código: es una definición legible que el servidor y las aplicaciones interpretan, por lo que nunca contiene una regla ni un prompt, ni tampoco un cerebro compilado.
Lentes compartidas
Algunos regímenes pertenecen a varios sectores. Un registro de tecnología externalizada sirve tanto a Seguros como a Banca y pagos; los relojes de incidentes (las cuentas atrás para los informes que un regulador espera tras un incidente) sirven tanto a Infraestructura crítica y energía como a Gobierno y sector público. Un régimen utilizado por varios paquetes se escribe una sola vez como una lente compartida. Cada paquete que lo necesita lo incluye. Cuando la norma cambia, se modifica en un solo lugar.
Una lente solo restringe
Una lente es lo que ve un rol dentro de un paquete o una plataforma: qué tarjetas y campos, y qué acciones. Siempre se define como una restricción de una lente base. Una lente con base no muestra ningún tipo de elemento que su base no muestre y no abre ninguna área que su base no abra, y no puede mostrar y ocultar a la vez el mismo tipo. Los permisos siguen procediendo de los roles; una lente cambia la vista, nunca lo que una persona está autorizada a hacer.
Si intenta ampliar una, la respuesta será LENS_CANNOT_WIDEN (422) y no se guardará nada. En el creador de lentes, para una lente de técnico de contenedores refrigerados basada en una lente de controlador de operaciones que no muestra los importes de las reclamaciones, se lee: «El importe de la reclamación no se puede añadir a esta lente». La solución pasa por utilizar una lente base diferente, lo que implica realizar otra solicitud al propietario de la base.
La regla se mantiene en la base de datos, no solo en la ruta. Las lentes de cada organización residen en cuatro tablas del esquema del registro de complementos:
| Tabla | Qué contiene |
|---|---|
plugins.lenses |
Una lente de un propietario, un paquete (owner_kind pack) o una plataforma (platform): su slug y name, su base_lens_id, los tipos que shows y hides, las áreas que opens, su status (active o withdrawn) y su version |
plugins.lens_grants |
Una lente asignada a un rol (owner, admin, member, viewer, developer o billing_admin) en una unidad de negocio |
plugins.lens_changes |
Cada cambio en una lente o en sus concesiones, registrado con el estado anterior y posterior, quién lo hizo y por qué. Solo permite añadir registros |
plugins.lens_holder_months |
Cuántas personas tenían asignada una lente en una unidad cada mes. Un recuento, nunca quiénes |
Un disparador rechaza cualquier lente que muestre más que su base, y rechaza cualquier cambio en una base que deje a una lente basada en ella mostrando más que la propia base. No se elimina nada. Las lentes y las concesiones se retiran, y volver a asignar una lente genera una fila nueva; un cambio nunca se sobrescribe y el recuento de un mes pasado nunca se modifica. Cada fila cita una lente de su propia organización mediante una clave compuesta, de modo que una concesión no puede apuntar a otra organización.
La consola y sus propias herramientas acceden al registro a través de /api/v1/lenses, con el token portador propio de la persona. La organización, la persona y el puesto de la unidad proceden exclusivamente del token verificado.
| Método y ruta | Qué hace |
|---|---|
GET / |
Lentes, filtradas por owner_kind, owner_id y status, con sus concesiones en su puesto |
POST / |
Añadir una lente: owner_kind, owner_id, slug, name, shows y, opcionalmente, description, base_lens_id, hides, opens y reason |
GET /owners/:kind/:id |
Las lentes de un paquete o plataforma, y cuál de ellas muestra cada tipo |
GET /owners/:kind/:id/grants |
Lente por unidad: los roles a los que se asigna cada lente y las personas a las que llega |
GET /owners/:kind/:id/holders |
Personas con una lente asignada cada mes (months, seis por defecto) |
POST /owners/:kind/:id/holders/count |
Registrar los recuentos de este mes |
GET /owners/:kind/:id/changes |
El historial de cambios de las lentes del propietario (limit, 50 por defecto) |
GET /:lensId |
Una lente con su base y las lentes que la restringen, así como sus concesiones y cambios |
PATCH /:lensId |
Modificar una lente: name, description, shows, hides, opens, reason |
POST /:lensId/withdraw |
Retirar una lente y, con ella, sus concesiones. Una lente que está siendo restringida por otra lente activa no puede retirarse hasta que se retire esta última |
POST /:lensId/grants |
Asignar una lente: business_unit_id, role, reason |
POST /:lensId/grants/:grantId/withdraw |
Retirar una concesión |
:kind es pack o platform. Cada rechazo incluye un código con una frase explicativa y el siguiente paso a seguir, y un fallo inesperado devuelve UNHANDLED_ERROR registrando la causa en el registro del servicio, nunca en la respuesta.
Modelo de conocimiento, conectores y cerebros compilados
El modelo de conocimiento representa los tipos de elementos que el paquete conoce y cómo se conectan entre sí. Está versionado y, por lo general, un paquete se construye sobre un modelo base del paquete del que hereda: un paquete de cadena de frío sobre el modelo base de logística añade cinco tipos (entre ellos, unidad refrigerada y escala de buque) y vincula dos de ellos al modelo base sin modificar la base en sí. Cada propiedad se clasifica en el momento de su creación, de modo que los campos personales y los comerciales se conocen antes de que cualquier lente o rama de datos los utilice. Así, una lente para técnicos no puede mostrar un importe de reclamación clasificado como comercial. Una propiedad retirada permanece en la versión que la incluía y solo desaparece en una versión posterior. Al preparar una nueva versión, primero se copia el conocimiento y la vía de reversión permanece abierta durante un período establecido.
Los conectores importan registros desde los sistemas que ya los contienen: administración de pólizas, un sistema de reclamaciones o una carpeta de correo con archivos enviados por socios. Cada uno es de solo lectura, se ejecuta según su propia programación y cuenta con un botón de prueba. Los registros se asignan a los términos del paquete al entrar y se incorporan al modelo de conocimiento que leen las lentes; las respuestas del asistente lo citan. Desde Nexus no se escribe nada de vuelta en el sistema de origen.
Los cerebros compilados son las partes de un paquete que toman decisiones: por ejemplo, el cerebro de suscripción y el cerebro de reclamaciones del paquete de Seguros. Se ejecutan en el servidor como módulos compilados con licencia, cada uno de los cuales verifica la licencia por sí mismo, y nunca se envían a un teléfono ni a un navegador.
La superposición móvil y los campos sin conexión
Un paquete declara sus pantallas para teléfono en el mismo manifiesto, como una capa móvil: qué tarjetas y pasos de captura aparecen en los teléfonos y para qué roles. A continuación, un administrador establece las reglas en los teléfonos por organización, como cuánto tiempo pueden esperar las capturas sin conexión, si cada foto incluye el lugar donde se tomó y si las aprobaciones requieren una clave de acceso. La configuración se realiza en un ordenador; el administrador ve lo que envían los teléfonos en forma de nombres y recuentos, nunca las fotos ni las notas en sí.
Cada campo que ofrece una pantalla de teléfono sin cobertura declara una de estas tres clases, y la pantalla indica cuál es:
| Clase | Qué ocurre con él | Ejemplos |
|---|---|---|
| Creado sin conexión | Se guarda en el teléfono y se fusiona cuando el teléfono vuelve a conectarse | Notas, fotos, lecturas |
| Propuesto sin conexión | Se envía como una sugerencia sobre la que decide la oficina. El servidor nunca la fusiona directamente; la reproduce aplicando sus propias comprobaciones de autorización | Un importe, un hallazgo, un cambio de reserva, una decisión |
| Nunca sin conexión | No es posible realizarlo sobre el terreno. Se muestra como una fila con su motivo, nunca como un botón | Una firma, un sello, una comprobación de autorización, una comprobación en una lista de sanciones |
Las capas móviles no contienen reglas ni prompts, ni tampoco cerebros. Son definiciones de pantalla legibles, y todo lo que toma decisiones permanece en el servidor. Las pantallas para teléfono de un paquete se abren únicamente dentro de las aplicaciones móviles de Nexus, y solo cuando la organización dispone tanto del paquete como del complemento de aplicaciones móviles.
Derechos de uso: quién tiene el paquete y dónde se ejecuta
Un paquete se concede bajo licencia, nunca se activa mediante configuración. Tres capas deciden quién lo ve.
La licencia. El documento de licencia firmado contiene una lista domain_packs de identificadores de matriz (como máximo 100, posiblemente vacía), junto con sus listas grants y add_ons de grupos de funciones. La consola de Adverant no emitirá un paquete sin los complementos que necesita: un paquete que requiera Salas de decisión y registros sellados no puede emitirse en una licencia que carezca de ello. Los grupos de funciones de una licencia se conceden o bien a toda la instalación o bien a organizaciones concretas, y la comprobación de derechos responde por organización. Si se retira la concesión, cada lente y pantalla de teléfono del paquete pasa a mostrarse como un avance, conservando sus registros.
La comprobación de derechos. Para cada organización y plan, cada rol y cada persona, la comprobación de derechos decide si un control que añade el paquete tiene derecho de acceso, se muestra como avance, se oculta o se rechaza con un código. Esta comprobación gobierna las filas de menú y las pestañas de panel, así como las comprobaciones de ruta y despacho. El módulo cerrado sigue siendo la autoridad sobre su propia concesión.
Unidades y lentes. Dentro de una organización que dispone del paquete, un administrador decide dónde se ejecuta. Un paquete se activa para una unidad por etapas, nunca para toda la unidad de golpe: la comprobación de la licencia, un grupo piloto, un ajuste preestablecido de configuración y, finalmente, la ampliación a todos los miembros de la unidad en la fecha que elija el administrador. Antes de que cambie nada, la página muestra quién obtiene qué, por rol. A continuación, las lentes se asignan por rol y por unidad, en una única matriz. Si más adelante se desactiva el paquete para una unidad, se conservan todos los registros creados por los usuarios; las lentes y las plantillas desaparecen, y nada más cambia.
Los diez paquetes
Adverant ofrece diez paquetes de dominio. Cada uno requiere la licencia base Enterprise y algunos necesitan complementos. Las pantallas para teléfono de todos los paquetes también requieren el complemento de aplicaciones móviles.
| Paquete | Identificador de matriz | Qué aporta | También necesita |
|---|---|---|---|
| Seguros | insurance |
Lentes de seguros para suscripción, reclamaciones, reaseguros, Lloyd's y autoridad delegada, entre otros; el flujo de fraude e investigaciones; recorridos y configuración de escaparate de seguros; los cerebros compilados de seguros | Salas de decisiones y registros sellados |
| Banca y pagos | financial-services |
Un registro de tecnología externalizada; relojes e informes de incidentes tecnológicos; planes de salida para proveedores críticos; decisiones de concesión de préstamos; disputas con tarjetas | Nada más allá de la base |
| Mercados de capitales y gestión de activos | capital-markets |
Lentes para el analista de investigación, el gestor de carteras, vigilancia y cumplimiento, e informes para clientes; grabación de llamadas en mesas de contratación; investigaciones retenidas tras una barrera hasta su publicación; plantillas para el registro de cruce de barreras, revisión de llamadas y publicación de investigaciones. Los teléfonos reciben el informe matutino y las aprobaciones de publicación, así como alertas de vigilancia, nunca órdenes | Salas de decisiones y registros sellados |
| Gobierno y sector público | government |
Solicitudes de prestaciones y derechos; solicitudes de urbanismo; solicitudes de información | Nada más allá de la base |
| Atención sanitaria | healthcare-providers |
Acceso e intercambio de historiales de pacientes, y solicitudes de información. Sin soporte para decisiones clínicas | Nada más allá de la base |
| Ciencias de la vida | life-sciences |
Desviaciones y acciones correctivas; revisión de registros de lotes; control de cambios validado | Nada más allá de la base |
| Infraestructura crítica y energía | energy-and-utilities |
Relojes e informes de incidentes; inspecciones y defectos; órdenes de trabajo | Nada más allá de la base |
| Defensa y seguridad | defence-and-mission |
Informes de campo fusionados con alertas de plataforma; marcas de compartición; sesiones informativas posteriores. Su versión para teléfono se instala únicamente mediante la gestión de dispositivos | Nexus Edge, para las alertas de plataforma |
| Servicios jurídicos y profesionales | legal |
Lentes para el profesional facturable, el abogado de gestión del conocimiento, conflictos y riesgos, y facturación; comprobación de conflictos en cada nuevo asunto; barreras éticas levantadas únicamente por dos socios; plantillas para la comprobación de nuevos asuntos, el creador de barreras y recordatorios de barreras. Los teléfonos reciben registro de tiempo y actualizaciones de asuntos con aprobaciones, nunca archivos sujetos a secreto profesional | Salas de decisión y registros sellados, y Correo |
| Logística y sector marítimo | logistics-and-maritime |
Lentes para el controlador de operaciones, el agente de aduanas, el gestor de transportistas y el inspector portuario; declaraciones y retenciones aduaneras; comprobaciones de sanciones antes de la primera reserva, con una persona encargada de liberar cada retención; un modelo de conocimiento de puertos y buques, transportistas y retenciones. Los teléfonos reciben inspecciones de patios y atraques y retenciones aduaneras, con hallazgos de drones | Mapa y GeoAI |
Harrow Port Authority utiliza el paquete de Logística y sector marítimo, y es el primero que yo leería si estuviera creando el suyo propio: su modelo de conocimiento es la base sobre la que se construye el ejemplo de la cadena de frío mencionado anteriormente.
Cómo crear el suyo propio
En Enterprise, un desarrollador inicia un paquete desde la ruta recomendada en Empezar algo nuevo, en tres pasos. «Acerca de» asigna el nombre al paquete, sus unidades, el paquete sobre el que se basa y las normas para las que debe mostrar evidencias. «Modelo de conocimiento» añade los nuevos tipos de elementos sobre el modelo base. «Revisar y crear» muestra el plan y luego lo ejecuta. Crea un repositorio a partir de la plantilla del paquete con un manifiesto que declara a qué puede acceder el paquete y sus pruebas; luego, un espacio de desarrollo con ramas de datos sintéticos; y, por último, un borrador de entrada de catálogo que solo usted puede ver. No se crea nada hasta que pulsa Crear en el último paso. El Capítulo 2.24, Creación de una solución vertical personalizada de principio a fin, recorre todo el proceso.
Cuánto le cuesta un paquete
Un paquete es la extensión más costosa de mantener. Su modelo de conocimiento tiene versiones de las que dependen las personas, por lo que una propiedad de la que se arrepienta permanecerá en la versión en la que se publicó. Sus lentes solo pueden restringir, de modo que si un rol necesita ver más, habrá que negociar una modificación de la lente base. Su mapa de evidencias cita normas que su propio departamento jurídico debe confirmar antes de que nadie confíe en él. Y un cliente solo lo obtiene a través de su licencia: puede crear el mejor paquete del sector y, aun así, no poder activarlo para una sola unidad hasta que la licencia de la organización lo incluya. A cambio, la trigésima unidad que lo solicite solo le costará activar un interruptor y realizar una prueba piloto.




