Versión 1.0.0-alpha.1 más reciente
Capítulo 2.24
Creación de una solución vertical personalizada de principio a fin
Una compilación práctica del paquete de dominio de cadena de frío, desde las especificaciones iniciales hasta una versión en ejecución para cada unidad, con su modelo de conocimiento, lentes, una habilidad, un complemento de servicio completo y datos de muestra. A continuación, cómo ampliar un paquete ya existente y cómo añadir una lente a uno que ya se ha distribuido.
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

Soy Mateo Ruiz, desarrollador en Corrán Orbital. La mayor parte de mi semana se dedica a nuestro propio software de carga útil, pero este capítulo trata sobre un trabajo que hicimos para un cliente. Larkfield & Vane asegura carga, y una proporción creciente de ella viaja en contenedores refrigerados. Cuando un contenedor refrigerado pierde la alimentación de tierra en el muelle, la temperatura sube, la carga se echa a perder y semanas después llega una reclamación. Larkfield quería que su personal viera esa cadena como una sola cosa en Nexus, desde el fallo eléctrico hasta la reclamación, de modo que cada rol viera únicamente su parte. Eso se convirtió en el paquete Cold chain.
Lo que sigue es el desarrollo en el orden en que lo hicimos, con las pantallas, los archivos y los comandos. He mantenido los errores porque dos de los rechazos que encontramos nos enseñaron más sobre la plataforma que el camino sin fallos. El material de referencia se encuentra en los capítulos anteriores a este, y remito a ellos en lugar de repetirlos. En los que más me apoyé fueron el capítulo 2.18, El modelo de extensión, y el capítulo 2.23, Paquetes de dominio, con el capítulo 2.21, El SDK de plugins, abierto junto a ellos para el propio kit de desarrollo de software.
Las especificaciones y quién hace qué
Larkfield me asignó una plaza de desarrollador en su organización durante todo el proyecto. Esto es importante, porque un paquete privado para un cliente se construye dentro de la instalación de ese cliente, en sus espacios de desarrollo y ramas de datos, bajo las aprobaciones de su personal. Un paquete destinado a muchos clientes se construye de forma diferente, en un clúster de editor solo con datos de muestra, y el capítulo 2.25, Desarrollo para cada edición, cubre ese caso.
Las especificaciones cabían en una página:
- Contenedores refrigerados en el muelle y en los buques: su alimentación eléctrica, sus desviaciones de temperatura y las reclamaciones posteriores.
- Dos roles para empezar: un técnico de contenedores refrigerados en el muelle y un controlador de la cadena de frío en la oficina.
- Un piloto que se ejecuta primero en la unidad de Rotterdam y pasa después a Felixstowe.
- Evidencia para tres conjuntos de normas: el acuerdo ATP para alimentos perecederos, las buenas prácticas de distribución de medicamentos de la UE y los registros de seguridad alimentaria bajo HACCP (análisis de peligros y puntos de control crítico). Las reclamaciones bajo las Reglas de La Haya-Visby utilizan los mismos registros de desviación, por lo que las anotamos para después del piloto.
Los paquetes de dominio son una capacidad de Enterprise. Larkfield utiliza Enterprise, por lo que la ruta del paquete de dominio estaba abierta para mí. En Community, la ruta recomendada para un paquete no se ofrece en absoluto.
Comenzar desde la ruta recomendada
Todo comienza en la página Start something new. Ofrece seis rutas recomendadas: plugin, paquete de dominio, lente, plataforma, habilidad y flujo de trabajo. Cada una crea un repositorio a partir de una plantilla versionada, un manifiesto que declara lo que el elemento necesita, pruebas, un espacio de desarrollo y ramas de datos. Las mismas rutas funcionan en la consola, en la línea de comandos y desde su IDE (entorno de desarrollo integrado), donde la herramienta de Workbench nexus.create hace el mismo trabajo con un plan que usted confirma primero.
nexus create y su plantilla fijada. Observe el aviso al pie: el manifiesto es de cumplimiento obligatorio, no orientativo, y una versión que solicita más permisos se retiene hasta que dos personas la revisan.Tomamos la ruta del paquete de dominio desde esa página, llamando al paquete cold-chain y a su primera unidad Rotterdam. El resultado indica la plantilla fijada, domain-pack@1.6.0, y enumera lo que creó: el repositorio, un manifiesto que declara cuatro alcances, dos almacenes y ninguna dirección de salida, 66 pruebas de la plantilla, un espacio de desarrollo en Rotterdam, tres ramas de datos sintéticos y una entrada en borrador en el propio catálogo de Larkfield que solo yo podía ver. La versión de la plantilla está fijada, y su actualización posterior llega como un cambio revisado como cualquier otro, de modo que el paquete de nadie cambia sin previo aviso porque se haya modificado una plantilla. De todos modos, utilicé el asistente de la consola para nuestro primer paquete, porque muestra el plan antes de crear nada.
Paso 1: indicar para qué sirve el paquete
El asistente New domain pack consta de tres pasos: información general, modelo de conocimiento y revisión y creación. El paso 1 pregunta los pocos aspectos que dan forma a todo lo que viene después.
| Campo | Lo que introdujimos | Nota |
|---|---|---|
| Nombre | Cadena de frío | Utilizado para el repositorio y el catálogo |
| Para qué sirve | Contenedores refrigerados en el muelle y en los buques: alimentación eléctrica, desviaciones de temperatura y las reclamaciones posteriores | |
| Sector | Logística y sector marítimo | Se basa en el paquete Logistics and maritime |
| Propietario | La persona que lo crea | Bloqueado en el asistente |
| Unidades | Rotterdam (piloto) | Felixstowe después del piloto |
| Plantilla | domain-pack@1.6.0 |
Bloqueada; las actualizaciones llegan como cambios revisados |
| Normas que asigna | Acuerdo ATP, buenas prácticas de distribución de la UE, registros de seguridad alimentaria | Cada norma se convierte en una página en el mapa de evidencias del paquete |
El asistente del panel sugirió la última fila, incluido el punto de que las reclamaciones de carga reutilizan los mismos registros de desviación. Un aviso al pie de la página indica que aún no se ha creado nada. El repositorio, el espacio de desarrollo y las ramas de datos se crean únicamente cuando usted pulsa Create en el paso 3, después de haber visto el plan. Puede guardar un borrador y volver más tarde.
Paso 2: el modelo de conocimiento
El modelo de conocimiento es el conjunto de tipos de entidades que el paquete conoce y cómo se vinculan entre sí. Cold chain partió del modelo base de logística, logistics-base 4.2, importado del SDK, que nos proporcionó cinco tipos base sobre los que construir (Vessel, Port, Container, Carrier y Shipment). Los tipos base son de solo lectura en el asistente. Si uno necesita cambiar, cambia en el paquete al que pertenece.
Añadimos cinco tipos propios:
| Tipo | Qué es | Propiedades |
|---|---|---|
| Unidad refrigerada | Un contenedor refrigerado | 9 |
| Escala de buque | Un buque en un atraque | 6 |
| Desviación de temperatura | Una temperatura fuera de sus límites | 8 |
| Suministro eléctrico | Un punto de alimentación en tierra o en el buque | 4 |
| Reclamar | Dinero reclamado por carga estropeada | 7 |
Cada propiedad se clasifica al crearla. «Reported by» en una Excursion es personal. «Cargo value at risk» y el importe y la liquidación de una reclamación son comerciales. Esto pareció mero papeleo el primer día, pero nos salvó dos veces más adelante, porque las clases deciden qué puede mostrar una lente, qué reemplaza una copia enmascarada y qué oculta una línea de registro.
Dos de nuestras relaciones llegan hasta el modelo base: una Reefer unit está conectada a una Power supply, y una Claim hace referencia a un Shipment. El modelo base en sí no se modifica. Una propiedad que usted retira permanece en la versión 1.0 del modelo y desaparece solo en una versión posterior, de modo que nada que fuera válido en los registros antiguos deja de ser legible.
Paso 3: revisar y crear
El paso 3 es el plan. Enumera lo que se creará, los alcances que declarará el manifiesto, las ramas de datos y el espacio de desarrollo. Usted confirma el plan con su llave de acceso y el plan recibe una huella digital. A continuación, la creación sigue ese plan exactamente, paso a paso, y usted puede detenerse en cualquier paso y conservar lo que se haya creado.
El plan para Cold chain declaró cuatro alcances:
| Alcance | Por qué lo necesita el paquete |
|---|---|
| Leer telemetría de contenedores refrigerados | Lecturas de alimentación y temperatura |
| Escribir desviaciones | Registra una desviación cuando se superan los límites |
| Leer envíos | Vincula una reclamación con su envío |
| Redactar borradores de notas de reclamación | Solo borradores; una persona los envía |
Sus almacenes eran el grafo y los registros. No tenía direcciones de salida y contaba con el perfil de entorno aislado Standard. El espacio de desarrollo incluía 4 núcleos, 16 GiB de memoria y 50 GiB de almacenamiento, una red cerrada salvo para lo que declara el manifiesto, únicamente imágenes firmadas y una finalización tras 7 días de inactividad. Cuando finaliza, su definición permanece en el repositorio, por lo que puede volver a crearlo desde allí.
Las tres ramas de datos procedían del generador sintético. No se copiaron datos de clientes. Una copia enmascarada de Rotterdam requiere la aprobación del propietario de los datos, que en Larkfield es Priya Natarajan, y se solicita por separado.
El manifiesto del paquete
El repositorio contiene el manifiesto del paquete, pack.json. Indica el nombre del paquete, su versión, el paquete del que hereda (si lo hay), sus clústeres y sus términos. Un clúster es o bien una lente, que es lo que ve un rol dentro del paquete, o bien compartido, que se ejecuta en todas las lentes. Aquí está el núcleo del nuestro:
{
"id": "cold-chain",
"name": "Cold chain",
"version": "0.4.0",
"clusters": [
{
"id": "CC01",
"kind": "lens",
"name": "Reefer technician",
"seats": "Technicians on the quay",
"purpose": "Which reefers have lost power or warmed up, and what to do next.",
"lexicon": ["cold"],
"menu": [],
"screens": []
},
{
"id": "CC02",
"kind": "lens",
"name": "Cold-chain controller",
"seats": "Controllers in the operations office",
"purpose": "Every excursion from first reading to closed claim, with its evidence.",
"lexicon": ["cold"],
"menu": [],
"screens": []
}
],
"lexicon": {
"core": [],
"cold": [
["excursion", "a time when the temperature left its limits", ""],
["set point", "the temperature a reefer is told to hold", ""],
["shore power", "electricity from the quay rather than the ship", ""]
]
}
}El léxico contiene los términos propios del paquete con una explicación sencilla para cada uno, lo bastante breve como para leerse en un teléfono.
Junto a pack.json, el manifiesto también declara a qué puede acceder el paquete: sus alcances, almacenes, direcciones de salida y perfil de entorno aislado. Nexus concede exactamente eso y nada más. Cada llamada a una herramienta se comprueba con respecto a los alcances declarados, y una dirección externa se bloquea a menos que esté en la lista. Puede leer la declaración, y el cambio con respecto a la última versión, en la página Manifest and permissions del paquete.
Lentes: qué ve cada rol
Una lente solo puede restringir lo que muestra su base, y esa única regla condicionó nuestro diseño más que ninguna otra. Una lente muestra una parte de lo que muestra su lente base, y los permisos siguen procediendo de los roles: una lente decide qué ve un rol en el paquete, no qué tiene permitido hacer.
La lente Reefer technician restringe Operations controller, la lente base que Larkfield ya utiliza para el trabajo logístico. En el Lens builder se marcan las tarjetas, los campos y las acciones que muestra la lente. Los elementos que la base no muestra están bloqueados.
| Componente | Reefer technician muestra | Omitido |
|---|---|---|
| Tarjetas | Contenedores refrigerados en el muelle, desviaciones abiertas, puntos de alimentación, escalas de buques hoy | Cualquier información sobre reclamaciones |
| Campos | Estado de alimentación, punto de consigna, última lectura, temperatura máxima | Importe de la reclamación (no está en la lente base), campos personales (desactivados por defecto) |
| Acciones | Registrar la causa de una desviación, solicitar una comprobación de alimentación | Cambiar un punto de consigna y cerrar una desviación (solo controladores), redactar un borrador de nota de reclamación |
Intenté añadir de todos modos el importe de la reclamación a la lente del técnico, porque un técnico lo había pedido. El constructor lo rechazó con LENS_CANNOT_WIDEN y no guardó nada. No hay ninguna solución alternativa dentro de la lente: la vía para hacerlo es crear una lente sobre una base más amplia, una solicitud diferente que decide el administrador de la organización. Lo dejamos fuera.
Ocultar algo en una lente no lo elimina de Nexus. Significa que este rol no lo ve. El constructor muestra a cuántas personas llegará una lente en el piloto (29, en nuestro caso) y mantiene un registro de cada adición, cambio y retirada. Una lente se define una vez para la organización y se concede por unidad a un rol de la plataforma, de modo que la misma lente Reefer technician puede asignarse a los técnicos de Rotterdam este mes y a los de Felixstowe el mes que viene.
Una habilidad para redactar notas de reclamación
Los controladores querían un primer borrador de la nota que se envía al propietario de la carga tras una desviación. Ese es un trabajo lingüístico, por lo que se ejecuta en un modelo, y la cuestión era dónde colocarlo.
Hay dos tipos de habilidades en Nexus, y la diferencia es importante aquí. Una habilidad de manifiesto es una fila tipada en el skills[] de un plugin, despachada por la plataforma. Una habilidad del Skills Engine es un paquete SKILL.md en la biblioteca de habilidades de la organización, que los agentes, los botones de IA (inteligencia artificial), los flujos de trabajo y las herramientas de desarrollo ejecutan de la misma manera. El capítulo 2.20, Habilidades, cubre ambos tipos.
El nivel de confianza de nuestro plugin es community, y un plugin comunitario solo puede declarar habilidades de manifiesto que no accedan a un modelo (host_callback y plugin_queue). Los dos niveles que acceden al AI Provider Router, tool_using y llm_only, necesitan el nivel de confianza core o verified. Por tanto, la redacción de borradores de notas de reclamación se convirtió en una habilidad del Skills Engine, y el enrutador elige el modelo del propio grupo de Larkfield:
---
name: draft-claim-note
description: Draft a note to a cargo owner about one reefer excursion, from the excursion record and its readings. Drafts only; a person reviews and sends.
allowed-tools: Read, Grep
triggers:
- /draft-claim-note
capabilities:
- name: draft_note
description: Write a first draft for one excursion
version: 1.0.0
---
# Draft a claim note
Use this when a controller asks for a note about one excursion.
## Steps
1. Read the excursion: unit, start, length, highest temperature and cause.
2. Read the shipment it belongs to, for the cargo owner's name.
3. Write four short paragraphs: what happened, when, what the readings show, what happens next.
4. Never state a claim amount. Never send anything.El paquete reside en skills/draft-claim-note/ en el repositorio, con el nombre de la carpeta igual al nombre de la habilidad. Lo validamos y lo subimos desde la terminal:
npm run skill:validate skills/draft-claim-note
npm run skill:upload skills/draft-claim-note --dry-run
npm run skill:upload skills/draft-claim-noteSubir el mismo contenido dos veces devuelve la versión existente en lugar de una nueva (CONTENT_HASH_ALREADY_PUBLISHED), por lo que volver a ejecutar la subida es seguro. Antes de publicar una versión, el Skills Engine ejecuta sus casos de prueba, un simulacro en modo sombra sobre trabajos anteriores y una revisión ciega por parte de un modelo de otra empresa, indicando el tiempo y el coste de cada ejecución.
El complemento de servicio completo
El paquete también necesitaba código que se ejecutara continuamente: un lector para el canal de telemetría de los contenedores refrigerados y un escritor que abre un registro de desviación cuando una lectura supera sus límites. Un código así pertenece a un plugin de servicio completo, y generamos su estructura base con el comando propio del SDK, que escribe todo el árbol de referencia sustituyendo el nombre:
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin scaffold cold-chain --tier full-service
cd cold-chain
npm install
npm ci
npm run typecheck && npm test && npm run build
npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json
npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-testEl SDK se instala desde https://registry.adverant.ai/npm/ con el token de extracción de la página Pull tokens and install commands de su cuenta de Adverant. Confirme en el repositorio el package-lock.json que escribe la primera instalación; la compilación de la imagen ejecuta npm ci y falla si no existe.
Aquí está la parte de nuestro nexus.manifest.json que difiere de la plantilla. No es el archivo completo: los bloques description, author, license, runtime, backend y frontend de la estructura base permanecen tal cual, y el validador rechaza un manifiesto de servicio completo sin ellos. Las tres frases de architecture son la norma que todo plugin reafirma, y el validador comprueba la redacción. UNO en la primera es el motor de flujos de trabajo:
{
"manifestVersion": "2",
"name": "cold-chain",
"displayName": "Cold chain",
"version": "0.4.0",
"tier": "full-service",
"trust": "community",
"architecture": {
"compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
"ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
"deploy": "Deploy is through the installation's release channels only."
},
"api": {
"version": "1",
"basePath": "/",
"endpoints": [
{ "method": "GET", "path": "/health", "summary": "Liveness", "auth": "public", "allowAnonymous": true },
{ "method": "GET", "path": "/api/excursions", "summary": "List the unit's excursions", "auth": "scope", "right": "excursion.read", "needsUnit": true },
{ "method": "POST", "path": "/api/excursions", "summary": "Record an excursion", "auth": "scope", "right": "excursion.create", "needsUnit": true },
{ "method": "POST", "path": "/internal/skills/excursion_open", "summary": "host_callback receiver the platform POSTs to", "auth": "internal" }
]
},
"rights": {
"excursion.read": { "summary": "Read the unit's excursions.", "roles": ["owner", "admin", "member", "viewer"] },
"excursion.create": { "summary": "Record an excursion.", "roles": ["owner", "admin", "member"] }
},
"skills": [
{
"id": "excursion_open",
"displayName": "Open an excursion",
"description": "Open an excursion record when a reading breaks its set point limits. No model; runs in the plugin's own backend.",
"tier": "host_callback",
"classification": "tenant",
"dataResidency": "eu",
"inputSchema": { "type": "object", "properties": { "readingId": { "type": "string" } }, "required": ["readingId"] },
"outputSchema": { "type": "object", "properties": { "opened": { "type": "boolean" } }, "required": ["opened"] },
"hostCallback": {
"service": "cold-chain",
"port": 8080,
"path": "/internal/skills/excursion_open",
"maxRequestBytes": 65536,
"maxResponseBytes": 16384,
"tenantHeader": "X-Organization-ID"
},
"timeoutMs": 10000
}
],
"changePolicy": {
"enabled": true,
"classes": ["website", "bff", "migration"],
"approvals": { "website": 1, "bff": 1, "migration": 2 }
}
}excursion_open es una habilidad de manifiesto con el nivel host_callback: la plataforma envía los datos de entrada a nuestro propio Service, dentro de nuestro espacio de nombres, y nunca a un host que indiquemos. La ruta receptora se declara como auth: internal y se protege con serviceMiddleware del SDK, la forma para Express de la protección, que rechaza cualquier token de llamada emitido para otro plugin, organización, habilidad o ruta. Su classification es tenant, que es el límite máximo para un plugin comunitario. El capítulo 2.27, Escenarios de desarrollo, explica paso a paso una habilidad host_callback por separado.
Merece la pena copiar dos hábitos de esta etapa. Cada tabla lleva organization_id, owner_user_id y business_unit_id desde la primera migración, porque añadir un eje más adelante supone una migración sobre filas en producción. Y ejecutamos nexus-gates localmente antes de cada envío al repositorio, ya que es el mismo comando que ejecuta la canalización; una ejecución que no haya examinado nada termina con el código 2 y lo indica. El capítulo 2.19, Las reglas que toda extensión hereda, enumera los controles.
Datos de muestra para pruebas
La página Sample data for testing ofrece tres tipos de ramas:
| Tipo | Qué contiene | Quién lo aprueba |
|---|---|---|
| Sintética | Datos generados a partir de recuentos y estructuras que usted define; nada procede de una unidad real | Nadie; es suya |
| Copia enmascarada | Una copia de una unidad en la que se han reemplazado los campos personales, sensibles y comerciales | El propietario de los datos (Priya Natarajan para Rotterdam) |
| Solo esquema | La estructura de los almacenes, sin filas | Nadie; para migraciones |
Generamos una semana de mucha actividad: unas 7 desviaciones por cada 100 contenedores refrigerados, que es como se ve un mes de agosto con mucho tráfico en Rotterdam. Los casos atípicos importaban más que el volumen. Solicitamos una pérdida de alimentación durante la descarga, una puerta dejada abierta, un fallo temporal de lectura del sensor y dos reclamaciones para una misma desviación. La página puede sugerir casos atípicos a partir de las causas de desviación del modelo de conocimiento, nunca a partir de registros reales.
Cada conjunto de recuentos y estructuras se guarda como una semilla, como cold-chain-busy-01, con su huella digital. La misma semilla produce los mismos datos, de modo que cada ejecución de pruebas en cada rama ve la misma semana. Eso fue lo que hizo que nuestras 66 pruebas fueran repetibles.
Una rama dura 72 horas por defecto y 14 días como máximo. Solicité conservar nuestra rama de alta actividad durante 30 días durante una revisión larga, y la página lo rechazó con BRANCH_LIFE_EXCEEDED. La solución es la que sugiere el aviso: conservar la semilla y crear una rama nueva a partir de ella cuando la necesite. Una copia enmascarada sigue los mismos límites, y su solicitud incluye un motivo y una duración de hasta 14 días.
Vista previa de una lente como una persona
Antes de que nadie en Rotterdam viera Cold chain, lo examinamos tal como lo verían ellos. Preview a lens as a person muestra el paquete exactamente como lo ve un rol elegido, en una rama de datos, dentro de un marco de vista previa con borde discontinuo.
Tres reglas hacen que las vistas previas se puedan usar libremente de forma segura. Una vista previa utiliza una rama de datos, nunca la unidad en producción. Sus propios permisos no se filtran en ella, por lo que usted ve lo que ve el rol y no lo que usted puede ver. Y finaliza a los 30 minutos. Apuntar una vista previa a una unidad en producción se rechaza con CONNECTION_SCOPE_EXCEEDED; si necesita estructuras reales, solicite al propietario de los datos una copia enmascarada y realice la vista previa sobre ella.
En la vista previa fue donde detectamos un error real. El gráfico de temperatura en la vista del técnico mostraba el punto de consigna, y la edición del punto de consigna estaba destinada únicamente a los controladores. El gráfico estaba bien; el botón de edición que había debajo no. La versión 0.3.2 ocultó la edición del punto de consigna a los técnicos, y fue en la vista previa donde lo descubrimos.
Cambio del modelo de conocimiento después de su distribución
Para la versión 0.4.0 necesitábamos un tipo Inspection para las inspecciones previas al viaje, y la relación «Excursion caused Claim» se entendía mejor como «Excursion led to Claim». Pasar el modelo de la versión 1.3 a la 1.4 es un cambio en el modelo de conocimiento, y la página Knowledge model changes muestra sus diferencias, a qué afectaría y en qué punto del proceso se encuentra.
El cambio se tramita como una solicitud de cambio en el grafo. Su simulacro contabiliza a qué afectaría en la copia enmascarada de Rotterdam, en forma de recuentos: en nuestro caso, 1,284 enlaces renombrados y nada eliminado. Dos revisores lo aprueban y la canalización lo aplica al entorno de preproducción y, después, al piloto. Nadie escribe manualmente en el grafo compartido; cualquier intento se rechaza y queda registrado. Tres preguntas guardadas utilizaban la palabra «caused», y el cambio incluía una reescritura automática para cada una de ellas, que la página enumeraba. Los filtros de las lentes no cambiaron, porque ambas lentes seguían limitándose a restringir.
Promoción a producción
Cada versión avanza por una única ruta: espacio de desarrollo, preproducción, una unidad piloto y, por último, todas las unidades. Cada paso tiene controles, y nada se salta ninguno.
| Hacia | Controles |
|---|---|
| Preproducción | Todas las pruebas superadas; controles de calidad; manifiesto sin cambios o ampliación aceptada; imagen firmada |
| Piloto (Rotterdam) | Simulacro de cambio de modelo en la copia enmascarada sin errores; comprobación de políticas sobre reglas de lentes y alcances; dos revisores que no sean el autor, uno de ellos el propietario de los datos |
| Todas las unidades | 14 días en el piloto; errores por debajo de 1 entre 1,000, contabilizados en el piloto; cada administrador de unidad acepta para su unidad; dos revisores que no sean el autor |
Intenté tomar el atajo una vez, un viernes, para una corrección de una sola línea: promocionar 0.4.0-dev desde mi espacio de desarrollo a todas las unidades. Fue rechazado con GATE_CANNOT_BE_SKIPPED, y no se promocionó nada. El aviso le indica que promocione al siguiente paso en su lugar, y esa es la única respuesta posible.
La revisión de la versión en sí, las evidencias que lee un segundo revisor y los canales que eligen las unidades se encuentran en el capítulo 2.28, Publicación de su extensión. Dos datos de ese capítulo corresponden aquí, porque condicionan cómo se planifica una solución vertical. El autor nunca cuenta como revisor, por lo que un equipo de dos personas necesita a una tercera persona para cada versión. Además, cada entorno conserva la versión anterior durante 30 días, de modo que revertir es un cambio revisado que la canalización realiza en aproximadamente un minuto.
Ampliación de un paquete ya existente
No toda solución vertical parte de cero. Un paquete puede heredar de otro y añadir únicamente lo que es diferente. El paquete Banking and payments, que utiliza Larchmont Bank, es el ejemplo más claro del catálogo. Su manifiesto comienza así:
{
"id": "fintech",
"name": "Banking and payments",
"version": "0.1",
"inherits": "insurance",
"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": []
}
],
"lexicon": {
"core": [],
"fin": [
["APR", "the yearly cost of borrowing, fees included", "exact"],
["mandate", "the most one person may lend alone", ""]
]
}
}inherits indica el nombre del paquete sobre el que se construye. Banking and payments conserva la estructura del paquete Insurance, sus clústeres de conversación compartidos y sus términos principales, y añade tres lentes propias: Lending decisions, Card disputes y My account. El tercer elemento de cada entrada del léxico es exact para un término que debe mostrarse tal como está escrito, como APR (tasa anual equivalente), en lugar de reformularse.
Hay algunas cosas que no se pueden hacer mediante herencia. Un paquete nunca cambia la interfaz base, los componentes ni las reglas de redacción, por lo que un paquete derivado no puede cambiar el estilo visual de la consola. Un régimen normativo que varios paquetes necesitan es una única lente compartida en lugar de una copia en cada uno: el registro de tecnología externalizada sirve tanto a Insurance como a Banking and payments. Si su paquete derivado necesita una lente que ya existe como lente compartida, utilícela en lugar de diseñar la suya propia.
El licenciamiento sigue la herencia. Un paquete se licencia sobre Enterprise y puede necesitar complementos, y el documento de licencia incluye esas dependencias. Insurance necesita Decision rooms and sealed records, por lo que un cliente que adquiera la licencia de un paquete que hereda de él también necesita ese complemento, y la consola se niega a emitir una licencia que lo omita. Las pantallas para teléfono de un paquete también necesitan el complemento Mobile apps. Compruebe la cadena de requisitos antes de prometer una fecha a un cliente.
Adición de una lente a un paquete distribuido
El trabajo vertical más pequeño es una nueva lente en un paquete que usted no escribió. A los seis meses del proyecto piloto, el equipo de reclamaciones marítimas de Larkfield quiso su propia lente dentro de Cold chain: desviaciones y reclamaciones, sin tomas de corriente ni valores de consigna. No tocamos el código del paquete. Una lente es una fila en el registro de lentes de la organización, propiedad del paquete, por lo que la iniciamos desde la ruta recomendada de lentes en Empezar algo nuevo y le dimos forma en el Creador de lentes tomando como base la lente Cold-chain controller. Se aplica la misma regla que antes: la nueva lente puede ocultar lo que su base muestra, pero nunca puede mostrar más. Se define una sola vez para la organización y se concede a un rol de la plataforma en cada unidad. Una concesión se retira, nunca se elimina, y volver a otorgar la lente crea una nueva concesión, de modo que siempre se puede consultar quién tuvo qué lente y cuándo. El registro cuenta cuántas personas tuvieron una lente cada mes, nunca quiénes.
La página Lentes y quién las ve muestra el resultado como una matriz de lentes por unidad y rol, con las opciones Añadir, Cambiar y Retirar en cada celda. Previsualice la nueva lente como una persona antes de concederla, exactamente como se indicó arriba.
Cuánto costó, con total transparencia
Un paquete accede a los registros del cliente, por lo que la plataforma hace que algunas cosas sean lentas a propósito, y usted debe planificarlas desde el primer día.
- Una copia enmascarada necesita siempre la aprobación del propietario de los datos. La nuestra tardó un día en llegar la primera vez, porque Priya quiso leer primero el modelo de conocimiento. Empiece con datos sintéticos y solicítela con antelación.
- El autor no puede aprobar su propia versión, y las solicitudes caducan a los 3 días. Si sus revisores están ocupados, su versión espera.
- Una versión que solicita más permisos que la anterior, como enviar correo o acceder a una dirección externa, se retiene hasta que dos revisores acepten el manifiesto ampliado. El Capítulo 2.28, Publicación de su extensión, muestra la página Manifiesto y permisos que le informa antes de que lo solicite.
- Una lente no puede mostrar lo que su lente base oculta. Si un rol realmente necesita ver más, eso requiere hablar con el administrador de la organización, no cambiar un ajuste.
Ninguno de estos puntos nos frenó dos veces. La segunda versión de Cadena de frío tardó una semana desde el primer commit hasta el piloto de Rotterdam, y la mayor parte del tiempo se dedicó a las 66 pruebas ejecutándose en tres ramas y a dos personas leyendo las evidencias.




