Iniciar sesiónReservar sesión

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

19 minutos de lectura

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Paquetes de dominio
Paquetes de dominio
La página de paquetes de dominio muestra los diez paquetes con lo que cada uno necesita y dónde se ejecuta. Solo Adverant concede un paquete; usted decide en qué unidades se ejecuta.

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.

Creador de lentes
Creador de lentes
El creador de lentes enumera lo que ve un rol, tarjeta por tarjeta y campo por campo, marcado en función de la lente base que restringe. Si se intenta mostrar un campo que la base oculta, la acción se rechaza indicando el motivo y el nombre de quien puede modificar 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.

Modelo de conocimiento y conectores
Modelo de conocimiento y conectores
Modelo de conocimiento y conectores muestra la versión del modelo y el vocabulario del paquete, con los términos propios de la organización, y permite probar cada conector de solo lectura. Desde Nexus no se modifica nada en los sistemas de pólizas o reclamaciones.

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.

Capa móvil
Capa móvil
La capa móvil selecciona qué tarjetas y pasos de captura del paquete aparecen en los teléfonos y para qué roles. Las capturas esperan sin conexión durante el tiempo que permita la organización y las aprobaciones requieren una clave de acceso. La vista previa muestra exactamente lo que ve un rol.

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.

Activar un dominio para una unidad
Activar un dominio para una unidad
La activación de un dominio para una unidad se realiza por etapas, desde la comprobación de la licencia, pasando por un grupo piloto, hasta llegar a toda la unidad. El administrador ve quién obtiene qué antes de que se produzca ningún cambio, y la configuración del piloto se transfiere sin modificaciones.

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.