Una solicitud puede repetirse porque la respuesta se perdió, porque el usuario insistió o porque un proceso reintentó la entrega. El problema de diseño aparece cuando esa repetición produce una segunda confirmación o una segunda preparación del pedido. La interfaz puede recibir dos solicitudes; la operación necesita conservar un único resultado.
Este ejemplo desarrolla un sistema ilustrativo. La regla de negocio permite una sola confirmación por pedido. No representa un sistema de un cliente ni incluye pagos, cancelaciones o modificaciones posteriores. Esas operaciones necesitarían reglas e identidades propias.
Primero, delimitar la operación
El proceso de negocio distingue una confirmación nueva de una ya registrada. BPMN permite expresar esa diferencia mediante tareas, eventos y una compuerta exclusiva [1]. La consulta inicial ayuda a explicar el recorrido; la restricción de unicidad en la base de datos será la que resuelva una carrera entre solicitudes concurrentes.
BPMN 2.0
Ver fuente de texto
<?xml version="1.0" encoding="UTF-8"?>
<bpmn:definitions xmlns:bpmn="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="Definitions_Orders" targetNamespace="https://blog.johndgomez.com/models/orders">
<bpmn:process id="ConfirmOrder" name="Confirmar un pedido" isExecutable="false">
<bpmn:startEvent id="Received" name="Solicitud recibida">
<bpmn:outgoing>StartCheck</bpmn:outgoing>
</bpmn:startEvent>
<bpmn:task id="Check" name="Consultar confirmación">
<bpmn:incoming>StartCheck</bpmn:incoming>
<bpmn:outgoing>CheckExists</bpmn:outgoing>
</bpmn:task>
<bpmn:exclusiveGateway id="Exists" name="¿Ya está confirmado?" default="New">
<bpmn:incoming>CheckExists</bpmn:incoming>
<bpmn:outgoing>Existing</bpmn:outgoing>
<bpmn:outgoing>New</bpmn:outgoing>
</bpmn:exclusiveGateway>
<bpmn:task id="Return" name="Recuperar resultado">
<bpmn:incoming>Existing</bpmn:incoming>
<bpmn:outgoing>ReturnMerge</bpmn:outgoing>
</bpmn:task>
<bpmn:task id="Persist" name="Guardar confirmación y evento en una transacción">
<bpmn:incoming>New</bpmn:incoming>
<bpmn:outgoing>PersistMerge</bpmn:outgoing>
</bpmn:task>
<bpmn:exclusiveGateway id="Merge">
<bpmn:incoming>ReturnMerge</bpmn:incoming>
<bpmn:incoming>PersistMerge</bpmn:incoming>
<bpmn:outgoing>MergeEnd</bpmn:outgoing>
</bpmn:exclusiveGateway>
<bpmn:endEvent id="Confirmed" name="Estado confirmado">
<bpmn:incoming>MergeEnd</bpmn:incoming>
</bpmn:endEvent>
<bpmn:sequenceFlow id="StartCheck" sourceRef="Received" targetRef="Check" />
<bpmn:sequenceFlow id="CheckExists" sourceRef="Check" targetRef="Exists" />
<bpmn:sequenceFlow id="Existing" name="Sí" sourceRef="Exists" targetRef="Return">
<bpmn:conditionExpression xsi:type="bpmn:tFormalExpression">existe confirmación</bpmn:conditionExpression>
</bpmn:sequenceFlow>
<bpmn:sequenceFlow id="New" name="No" sourceRef="Exists" targetRef="Persist" />
<bpmn:sequenceFlow id="ReturnMerge" sourceRef="Return" targetRef="Merge" />
<bpmn:sequenceFlow id="PersistMerge" sourceRef="Persist" targetRef="Merge" />
<bpmn:sequenceFlow id="MergeEnd" sourceRef="Merge" targetRef="Confirmed" />
</bpmn:process>
<bpmndi:BPMNDiagram id="OrdersDiagram">
<bpmndi:BPMNPlane id="OrdersPlane" bpmnElement="ConfirmOrder">
<bpmndi:BPMNShape id="Received_shape" bpmnElement="Received">
<dc:Bounds x="50" y="212" width="36" height="36" />
<bpmndi:BPMNLabel>
<dc:Bounds x="15" y="256" width="108" height="50" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Check_shape" bpmnElement="Check">
<dc:Bounds x="150" y="180" width="180" height="100" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Exists_shape" bpmnElement="Exists" isMarkerVisible="true">
<dc:Bounds x="400" y="205" width="50" height="50" />
<bpmndi:BPMNLabel>
<dc:Bounds x="465" y="208" width="90" height="60" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Return_shape" bpmnElement="Return">
<dc:Bounds x="560" y="70" width="190" height="100" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Persist_shape" bpmnElement="Persist">
<dc:Bounds x="560" y="310" width="270" height="100" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Merge_shape" bpmnElement="Merge" isMarkerVisible="true">
<dc:Bounds x="890" y="205" width="50" height="50" />
</bpmndi:BPMNShape>
<bpmndi:BPMNShape id="Confirmed_shape" bpmnElement="Confirmed">
<dc:Bounds x="1030" y="212" width="36" height="36" />
<bpmndi:BPMNLabel>
<dc:Bounds x="995" y="256" width="108" height="50" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNShape>
<bpmndi:BPMNEdge id="StartCheck_edge" bpmnElement="StartCheck">
<di:waypoint x="86" y="230" />
<di:waypoint x="150" y="230" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="CheckExists_edge" bpmnElement="CheckExists">
<di:waypoint x="330" y="230" />
<di:waypoint x="400" y="230" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="Existing_edge" bpmnElement="Existing">
<di:waypoint x="425" y="205" />
<di:waypoint x="425" y="120" />
<di:waypoint x="560" y="120" />
<bpmndi:BPMNLabel>
<dc:Bounds x="450" y="93" width="60" height="24" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="New_edge" bpmnElement="New">
<di:waypoint x="425" y="255" />
<di:waypoint x="425" y="360" />
<di:waypoint x="560" y="360" />
<bpmndi:BPMNLabel>
<dc:Bounds x="450" y="333" width="60" height="24" />
</bpmndi:BPMNLabel>
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="ReturnMerge_edge" bpmnElement="ReturnMerge">
<di:waypoint x="750" y="120" />
<di:waypoint x="915" y="120" />
<di:waypoint x="915" y="205" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="PersistMerge_edge" bpmnElement="PersistMerge">
<di:waypoint x="830" y="360" />
<di:waypoint x="915" y="360" />
<di:waypoint x="915" y="255" />
</bpmndi:BPMNEdge>
<bpmndi:BPMNEdge id="MergeEnd_edge" bpmnElement="MergeEnd">
<di:waypoint x="940" y="230" />
<di:waypoint x="1030" y="230" />
</bpmndi:BPMNEdge>
</bpmndi:BPMNPlane>
</bpmndi:BPMNDiagram>
</bpmn:definitions>El círculo inicial representa la recepción de la solicitud. Tras consultar el estado, el rombo elige una sola ruta: recuperar la confirmación existente o guardar una nueva junto con su evento. Ambas rutas terminan con el mismo estado de negocio. Las flechas indican el orden del proceso; no representan llamadas de red. La persistencia debe resolver también el caso en que otra solicitud confirme el pedido después de la consulta inicial.
Después, establecer el límite del sistema
El diagrama de contexto de C4 sitúa el sistema entre las personas y los sistemas externos con los que se relaciona. Los niveles de contenedores, componentes y código se reservan para preguntas que necesitan ese detalle [2]. Aquí basta con delimitar quién solicita la confirmación y quién recibe su consecuencia.
C4 · Contexto del sistema
Ver fuente de texto
@startuml
!include <C4/C4_Context>
HIDE_PERSON_SPRITE()
LAYOUT_LEFT_RIGHT()
UpdateRelStyle($textColor="#102b40", $lineColor="#435562")
UpdateElementStyle("person", $bgColor="#edf2f5", $fontColor="#102b40", $borderColor="#3c667b")
UpdateElementStyle("system", $bgColor="#102b40", $fontColor="#f7f9fa", $borderColor="#102b40")
UpdateElementStyle("external_system", $bgColor="#edf2f5", $fontColor="#102b40", $borderColor="#3c667b")
Person(operations, "Operaciones", "Confirma pedidos y consulta su estado")
System(orders, "Gestión de pedidos", "Registra una confirmación por pedido y publica el evento")
System_Ext(fulfillment, "Preparación de pedidos", "Recibe confirmaciones; descarta eventos ya procesados")
Rel(operations, orders, "Confirma y consulta", "HTTPS")
Rel(orders, fulfillment, "Notifica la confirmación", "Evento; entrega al menos una vez")
@endumlOperaciones confirma pedidos y consulta su estado en Gestión de pedidos. Este sistema guarda la confirmación y comunica un evento a Preparación de pedidos. La entrega admite reintentos; Preparación reconoce el identificador del evento y evita procesarlo nuevamente. El tono oscuro identifica el sistema bajo análisis; el claro, las personas y los sistemas externos. Cada flecha incluye su propósito y el mecanismo de comunicación.
La frontera importa: guardar una confirmación no prueba que el sistema externo haya recibido el evento. Confundir ambos hechos llevaría a informar una entrega que todavía puede fallar.
Mirar la misma decisión desde cinco perspectivas
El modelo 4+1 de Kruchten distingue las vistas lógica, de procesos, de desarrollo y física, y las relaciona mediante escenarios [3]. No prescribe un único lenguaje de dibujo. En este ejemplo, cada vista responde una pregunta concreta; los diagramas de clases y casos de uso emplean elementos de UML [4].
Vistas de la confirmación de pedidos
Vista lógica
UML · Clases
Ver fuente de texto
@startuml
hide circle
hide empty methods
class Pedido {
id: UUID
}
class Confirmacion {
pedidoId: UUID
confirmacionId: UUID
}
class EventoPendiente {
eventoId: UUID
pedidoId: UUID
tipo: PedidoConfirmado
}
Pedido "1" -- "0..1" Confirmacion : tiene
Confirmacion "1" -- "1" EventoPendiente : origina
note bottom of Confirmacion
pedidoId es único.
Confirmación y evento se guardan
en la misma transacción.
end note
@endumlUn pedido tiene cero o una confirmación. Una confirmación origina un evento persistido en la misma transacción. La multiplicidad 1 significa exactamente uno; 0..1 significa ninguno o uno. Las líneas representan asociaciones, no llamadas. UUID identifica un tipo de identificador. El modelo conserva el registro del evento incluso después de entregarlo.
Vista de procesos
Diagrama de secuencia
Ver fuente de texto
sequenceDiagram
participant O as Operaciones
participant A as Servicio de pedidos
participant B as Base de datos
participant W as Publicador
participant D as Preparación
O->>A: Confirmar pedido
A->>B: Iniciar transacción
A->>B: Insertar confirmación si no existe
alt Primera confirmación
A->>B: Insertar evento pendiente
else Confirmación existente
B-->>A: Conservar resultado registrado
end
A->>B: Confirmar transacción
A-->>O: Estado confirmado
W->>B: Leer evento pendiente
W->>D: Entregar evento con identificador estable
D-->>W: Aceptado o ya procesado
W->>B: Marcar evento entregadoEl tiempo avanza de arriba hacia abajo. El servicio confirma una transacción antes de responder. El publicador entrega el evento después y marca su entrega tras recibir la aceptación. El bloque alt distingue una primera confirmación de otra existente. Si el publicador se interrumpe entre la aceptación y la marca, repetirá el evento: el destinatario debe reconocer su identificador estable. Las flechas discontinuas muestran respuestas.
Vista de desarrollo
UML · Componentes
Ver fuente de texto
@startuml
left to right direction
component "Interfaz HTTP\nValidación y autorización" as Api
component "Aplicación\nCaso de uso: confirmar" as Application
component "Dominio\nIdentidad e invariantes" as Domain
component "Persistencia\nTransacción y restricciones" as Persistence
component "Publicador\nEntrega y reintentos" as Publisher
Api ..> Application : invoca
Application ..> Domain : usa
Persistence ..> Application : implementa puertos
Publisher ..> Persistence : gestiona eventos
@endumlCada componente representa un módulo de software, no una máquina. Las flechas discontinuas se leen con su etiqueta: la interfaz invoca la aplicación; la aplicación usa el dominio; persistencia implementa los puertos definidos por la aplicación. El publicador utiliza persistencia para gestionar los eventos. Esta distribución mantiene explícito dónde vive cada responsabilidad.
Vista física
Topología de despliegue
Ver fuente de texto
direction: right
style.fill: "#f7f9fa"
application: Nodo de aplicación {
style.fill: "#f7f9fa"
style.stroke: "#93adb9"
style.font-color: "#102b40"
style.font-size: 22
service: Servicio de pedidos {
shape: rectangle
style.fill: "#edf2f5"
style.stroke: "#3c667b"
style.font-color: "#102b40"
}
}
data: Nodo de datos {
style.fill: "#f7f9fa"
style.stroke: "#93adb9"
style.font-color: "#102b40"
style.font-size: 22
database: Base de datos transaccional {
shape: cylinder
style.fill: "#edf2f5"
style.stroke: "#3c667b"
style.font-color: "#102b40"
}
}
application.publisher: Publicador de eventos {
style.fill: "#edf2f5"
style.stroke: "#3c667b"
style.font-color: "#102b40"
}
destination: Preparación de pedidos {
style.fill: "#edf2f5"
style.stroke: "#3c667b"
style.font-color: "#102b40"
}
application.service -> data.database: Confirma pedido y registra evento {
style.stroke: "#435562"
style.font-color: "#102b40"
style.italic: false
}
application.publisher -> data.database: Consulta pendientes y marca entregas {
style.stroke: "#435562"
style.font-color: "#102b40"
style.italic: false
}
application.publisher -> destination: Entrega con reintentos {
style.stroke: "#435562"
style.font-color: "#102b40"
style.italic: false
}El nodo de aplicación ejecuta el servicio y el publicador. El nodo de datos mantiene la base transaccional. Preparación pertenece a un sistema externo. Las flechas muestran comunicaciones entre esas partes. Esta topología mínima no promete alta disponibilidad: replicación, recuperación y capacidad requieren decisiones adicionales según los objetivos operativos.
Escenarios
UML · Casos de uso
Ver fuente de texto
@startuml
left to right direction
actor Operaciones
rectangle "Gestión de pedidos" {
usecase "Confirmar un pedido\npor primera vez" as First
usecase "Repetir la solicitud\ny recuperar el resultado" as Retry
usecase "Recuperar la entrega\ntras una interrupción" as Recover
}
actor Publicador
Operaciones --> First
Operaciones --> Retry
Publicador --> Recover
@endumlOperaciones inicia una confirmación nueva o repite una solicitud. El publicador recupera una entrega interrumpida. Los óvalos nombran objetivos de los actores; no expresan por sí solos el orden de ejecución. Para comprobarlos, se debe recorrer la secuencia, observar la transacción y verificar el estado persistido que se describe a continuación.
Llevar la regla al almacenamiento
Para este ejemplo, el identificador del pedido constituye la clave de la confirmación. El contrato distingue ese identificador del identificador asignado al resultado. En C#, ambos pueden expresarse mediante un registro de datos:
public sealed record ConfirmOrder(
Guid OrderId,
Guid ConfirmationId);El siguiente fragmento utiliza SQLite. La clave primaria de confirmations impide una segunda fila para el mismo pedido. La tabla outbox conserva el evento que debe entregarse; una restricción adicional impide registrar más de un evento de confirmación para ese pedido.
PRAGMA foreign_keys = ON;
CREATE TABLE confirmations (
order_id TEXT PRIMARY KEY NOT NULL,
confirmation_id TEXT NOT NULL UNIQUE
);
CREATE TABLE outbox (
event_id TEXT PRIMARY KEY NOT NULL,
order_id TEXT NOT NULL UNIQUE
REFERENCES confirmations(order_id),
event_type TEXT NOT NULL
CHECK (event_type = 'OrderConfirmed'),
delivered INTEGER NOT NULL DEFAULT 0
CHECK (delivered IN (0, 1))
);La escritura agrupa ambos efectos. Los valores que comienzan con dos puntos son parámetros enlazados por el programa; no se construyen concatenando texto recibido del usuario. changes() se evalúa inmediatamente después del intento de insertar la confirmación: sólo una inserción nueva debe producir el evento. Esta interpretación depende de la semántica de SQLite para la omisión por conflicto de unicidad y el recuento de cambios [5] [6].
BEGIN IMMEDIATE;
INSERT INTO confirmations (order_id, confirmation_id)
VALUES (:order_id, :confirmation_id)
ON CONFLICT (order_id) DO NOTHING;
INSERT INTO outbox (event_id, order_id, event_type)
SELECT :event_id, :order_id, 'OrderConfirmed'
WHERE changes() = 1;
SELECT confirmation_id FROM confirmations WHERE order_id = :order_id;
COMMIT;La aplicación responde con el identificador recuperado del almacenamiento, después de completar la transacción. Si cualquier sentencia falla, debe ejecutar ROLLBACK y no informar éxito. Si la base está ocupada, debe aplicar una política acotada de reintentos. El fragmento supone que el pedido existe y que la solicitud ya superó validación y autorización; no sustituye esas comprobaciones. SQLite admite una sola transacción de escritura simultánea; iniciar o confirmar una transacción puede encontrar la base ocupada [7].
Una repetición devuelve la primera confirmación, aunque la nueva solicitud proponga otro identificador para el resultado. Esa conducta deriva de la regla de este ejemplo. Si dos solicitudes pueden expresar decisiones de negocio distintas, la aplicación debe comparar su contenido y comunicar el conflicto, en lugar de tratarlo como una repetición equivalente.
Revisar la interrupción, no sólo el recorrido exitoso
La transacción evita que el ejemplo conserve una confirmación sin su evento. La entrega externa ocurre después. Si el destinatario acepta el evento y el publicador se interrumpe antes de marcarlo, el reintento llevará el mismo identificador. La prevención del efecto duplicado debe existir también en el destinatario; no se deduce de la transacción local.
| Situación | Estado que debe observarse |
|---|---|
| Primera confirmación | Una confirmación y un evento pendiente. |
| Repetición de la solicitud | La misma confirmación y ningún evento adicional. |
| Fallo al guardar el evento | La transacción se revierte; no queda una confirmación parcial. |
| Solicitudes concurrentes | La restricción de unicidad permite una sola confirmación; la otra solicitud recupera el resultado o reintenta dentro del límite establecido. |
| Interrupción después de la entrega externa | El evento puede repetirse con el mismo identificador; el destinatario evita un segundo efecto. |
Cuando cualquiera de estas observaciones contradice un diagrama, el modelo necesita una corrección. Una arquitectura útil permite seguir la regla desde el proceso hasta los datos, explicar sus límites y preparar una comprobación que pueda fallar.
Términos y lectura de la notación
- BPMN: notación para describir procesos de negocio. Un círculo marca un evento; un rectángulo redondeado, una tarea; un rombo, una decisión o una convergencia. Una flecha de secuencia indica qué paso sigue.
- C4: modelo de vistas que distingue contexto, contenedores, componentes y código. Un contenedor, en este modelo, es una aplicación o un almacén de datos; no implica necesariamente un contenedor de virtualización.
- UML: lenguaje de modelado. En este artículo, las clases representan conceptos y datos relacionados; los casos de uso representan objetivos de los actores.
- 4+1: se lee “cuatro más uno”. Las cuatro vistas son lógica, procesos, desarrollo y física; los escenarios conectan y ayudan a comprobar esas vistas.
- 1 y 0..1: multiplicidades del diagrama de clases. La primera exige exactamente un elemento relacionado; la segunda permite ninguno o uno. Los dos puntos consecutivos expresan un intervalo.
- UUID y Guid: UUID es un tipo de identificador de 128 bits;
Guides el tipo utilizado para representarlo en .NET. En el código,OrderIdidentifica el pedido yConfirmationId, su confirmación. - C# y .NET: C# es el lenguaje del primer fragmento y .NET es su plataforma de ejecución.
publichace accesible el tipo;sealedimpide heredarlo;recorddeclara un registro de datos; los paréntesis enumeran sus datos y las comas los separan. El punto y coma termina la declaración. - SQL y SQLite: SQL permite definir y consultar datos; SQLite es el motor usado en el ejemplo.
CREATE TABLEcrea una tabla;TEXTeINTEGERindican sus tipos de datos;NOT NULLexige un valor;PRIMARY KEYidentifica una fila;UNIQUEimpide repeticiones;REFERENCESexige una fila relacionada yCHECKcomprueba una condición. - Transacción: conjunto de cambios que se confirma o se revierte como una unidad.
BEGIN IMMEDIATEinicia una transacción de escritura en SQLite;COMMITla confirma yROLLBACKla revierte. - Inserción y consulta:
INSERT INTOindica dónde guardar;VALUESaporta los valores;SELECTconsulta o produce valores;FROMseñala la tabla yWHERElimita los resultados.ON CONFLICT (order_id) DO NOTHINGomite la inserción cuando ya existe ese pedido.changes()devuelve cuántas filas modificó la sentencia anterior;= 1exige exactamente una. - Parámetros y literales:
:order_id,:confirmation_idy:event_idson valores proporcionados por el programa. Las comillas simples delimitan texto, como'OrderConfirmed'; el guion bajo une palabras dentro de un nombre.DEFAULT 0asigna cero cuando no se indica otro valor;IN (0, 1)admite sólo cero o uno. Aquí cero significa pendiente y uno significa entregado. - HTTP y HTTPS: protocolos para intercambiar solicitudes y respuestas; HTTPS protege la comunicación mediante cifrado. Outbox es el registro local de eventos pendientes. Idempotencia significa que repetir una operación conserva el mismo efecto previsto.
- Secuencia y módulos: en la secuencia el tiempo avanza hacia abajo y
altsepara alternativas. En el diagrama de componentes cada flecha expresa la relación escrita a su lado. Un puerto es un contrato que la aplicación define para una dependencia; otro módulo lo implementa.
Referencias
Consultar fuenteFicha de la fuenteNotas de autor: Object Management GroupVolver al texto 1
Consultar fuenteFicha de la fuenteNotas de autor: Simon BrownVolver al texto 1
Consultar fuenteFicha de la fuenteNotas de autor: Philippe KruchtenVolver al texto 1
Consultar fuenteFicha de la fuenteNotas de autor: Object Management GroupVolver al texto 1
Consultar fuenteFicha de la fuenteNotas de autor: SQLiteVolver al texto 1
Consultar fuenteFicha de la fuenteNotas de autor: SQLiteVolver al texto 1
Consultar fuenteFicha de la fuenteNotas de autor: SQLiteVolver al texto 1