John D. Gómez

Decisiones técnicas

Confirmar un pedido sin duplicar su efecto

Del proceso de negocio a la transacción: siete vistas de una confirmación, sus reintentos y sus límites.

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

BPMN 2.0Figura 1. Recorrido de una solicitud de confirmación
Figura 1. Recorrido de una solicitud de confirmaciónEl 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.SolicitudrecibidaConsultar confirmación¿Ya está confirmado?Recuperar resultadoGuardar confirmación y evento en una transacciónEstado confirmadoSíNo
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

PlantUMLFigura 2. Responsabilidad de la gestión de pedidos
Figura 2. Responsabilidad de la gestión de pedidosOperaciones 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.«person»Operaciones Confirma pedidos yconsulta su estado«system»Gestión de pedidos Registra unaconfirmación por pedidoy publica el evento«external_system»Preparación depedidos Recibe confirmaciones;descarta eventos yaprocesadosConfirma y consulta[HTTPS]Notifica la confirmación[Evento; entrega al menos unavez]
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")
@enduml

Operaciones 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

PlantUMLFigura 3. Identidad y relaciones que deben conservarse
Figura 3. Identidad y relaciones que deben conservarseUn 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.Pedidoid: UUIDConfirmacionpedidoId: UUIDconfirmacionId: UUIDEventoPendienteeventoId: UUIDpedidoId: UUIDtipo: PedidoConfirmadopedidoId es único.Confirmación y evento se guardanen la misma transacción.tiene0..11origina11
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
@enduml

Un 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

MermaidFigura 4. Persistir primero y entregar después
Figura 4. Persistir primero y entregar despuésEl 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.PreparaciónPublicadorBase de datosServicio de pedidosOperacionesPreparaciónPublicadorBase de datosServicio de pedidosOperacionesalt[Primera confirmación][Confirmación existente]Confirmar pedidoIniciar transacciónInsertar confirmación si no existeInsertar evento pendienteConservar resultado registradoConfirmar transacciónEstado confirmadoLeer evento pendienteEntregar evento con identificador estableAceptado o ya procesadoMarcar evento entregado
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 entregado

El 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

PlantUMLFigura 5. Separar la regla de negocio de sus mecanismos
Figura 5. Separar la regla de negocio de sus mecanismosCada 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.Interfaz HTTPValidación y autorizaciónAplicaciónCaso de uso: confirmarDominioIdentidad e invariantesPersistenciaTransacción y restriccionesPublicadorEntrega y reintentosinvocausaimplementa puertosgestiona eventos
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
@enduml

Cada 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

D2Figura 6. Asignación a nodos de ejecución
Figura 6. Asignación a nodos de ejecuciónEl 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.Nodo de aplicaciónNodo de datosPreparación de pedidosServicio de pedidosBase de datos transaccionalPublicador de eventos Confirma pedido y registra eventoConsulta pendientes y marca entregasEntrega con reintentos
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

PlantUMLFigura 7. Recorridos que deben sostener las otras vistas
Figura 7. Recorridos que deben sostener las otras vistasOperaciones 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.Gestión de pedidosOperacionesPublicadorConfirmar un pedidopor primera vezRepetir la solicitudy recuperar el resultadoRecuperar la entregatras una interrupción
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
@enduml

Operaciones 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:

ConfirmOrder.cs
csharp
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.

confirmation-schema.sql
sql
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].

confirm-order.sql
sql
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ónEstado que debe observarse
Primera confirmaciónUna confirmación y un evento pendiente.
Repetición de la solicitudLa misma confirmación y ningún evento adicional.
Fallo al guardar el eventoLa transacción se revierte; no queda una confirmación parcial.
Solicitudes concurrentesLa 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 externaEl 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

Referencias

[1]
Object Management Group, Business Process Model and Notation, Version 2.0.2, Jan. 2014. Accessed: Sep. 24, 2026. [Online]. Available: https://www.omg.org/spec/BPMN/2.0.2

Consultar fuenteFicha de la fuenteNotas de autor: Object Management GroupVolver al texto 1

[2]
S. Brown, “Diagrams | The C4 model for visualising software architecture.” Accessed: Sep. 24, 2026. [Online]. Available: https://c4model.com/diagrams

Consultar fuenteFicha de la fuenteNotas de autor: Simon BrownVolver al texto 1

[3]
P. Kruchten, “Architectural Blueprints—The 4+1 View Model of Software Architecture,” IEEE Software, vol. 12, no. 6, pp. 42–50, Nov. 1995, Accessed: Sep. 24, 2026. [Online]. Available: https://www.cs.ubc.ca/~gregor/teaching/papers/4%2B1view-architecture.pdf

Consultar fuenteFicha de la fuenteNotas de autor: Philippe KruchtenVolver al texto 1

[4]
Object Management Group, Unified Modeling Language, Version 2.5.1, Dec. 2017. Accessed: Sep. 24, 2026. [Online]. Available: https://www.omg.org/spec/UML/2.5.1

Consultar fuenteFicha de la fuenteNotas de autor: Object Management GroupVolver al texto 1

[5]
SQLite, “UPSERT.” Accessed: Sep. 24, 2026. [Online]. Available: https://sqlite.org/lang_upsert.html

Consultar fuenteFicha de la fuenteNotas de autor: SQLiteVolver al texto 1

[6]
SQLite, “Count The Number Of Rows Modified.” Accessed: Sep. 24, 2026. [Online]. Available: https://sqlite.org/c3ref/changes.html

Consultar fuenteFicha de la fuenteNotas de autor: SQLiteVolver al texto 1

[7]
SQLite, “Transaction.” Accessed: Sep. 24, 2026. [Online]. Available: https://sqlite.org/lang_transaction.html

Consultar fuenteFicha de la fuenteNotas de autor: SQLiteVolver al texto 1

Descargar referencias: CSL JSON · BibTeX