Eventos de Tracer

El components/tracer actual de Midaz emite sus hechos de negocio JSON públicos como CloudEvents 1.0 en modo de contenido binario sobre Kafka mediante lib-streaming. Este es el productor del contrato studio.lerian.tracer.* de esta página. Tracer es el componente de Midaz desplegado por separado y el único productor documentado aquí; no atribuyas estos eventos a un repositorio separado.

Catálogo JSON público de Tracer

El manifiesto de Midaz components/tracer contiene las siguientes definiciones verificadas. Las 12 definiciones tienen emisores de producción no test; ninguna está solo en el catálogo. Midaz no inicializa un consumidor lib-streaming para estos hechos.

Catalogadas	Emitidas	Solo en el catálogo
12	12	0

Sobre CloudEvents

Cada hecho JSON público utiliza el sobre compartido siguiente. Las cabeceras llevan la información de enrutamiento y schema; el valor de Kafka lleva el objeto JSON data.

Cabecera	Presencia y valor
`ce-specversion`	Siempre `1.0`.
`ce-id`	Siempre; identificador opaco del evento definido por el productor.
`ce-source`	Siempre `tracer`.
`ce-type`	Siempre `studio.lerian.tracer.<resource>.<event>`.
`ce-time`	Siempre; timestamp de emisión RFC 3339.
`ce-resourcetype`	Siempre; el token de recurso de la clave de definición.
`ce-eventtype`	Siempre; el token de evento de la clave de definición.
`ce-subject`	Siempre `p.ID` para estos 12 contratos.
`ce-tenantid`	Siempre presente. El ID de tenant resuelto en el ámbito multi-tenant; literal `default` en el ámbito single-tenant o sin tenant.
`ce-schemaversion`	Siempre `1.0.0` para los 12 hechos JSON públicos.
`ce-datacontenttype`	`application/json`.

Temas, manifiesto y enrutamiento

El tema de aplicación identifica el Tracer de Midaz, no un evento individual. Enruta un registro por ce-resourcetype y ce-eventtype, y valida ce-schemaversion antes de decodificar su valor data.

Hechos: lerian.streaming.tracer
DLQ de ruta: lerian.streaming.tracer.dlq
Manifiesto: GET /v1/streaming/manifest expone el catálogo JSON público y el mapeo de temas, incluso cuando la publicación está deshabilitada.

Semántica de entrega y fallo

La publicación está deshabilitada hasta que STREAMING_ENABLED=true y la configuración del broker tenga éxito. Cuando está habilitado, Midaz emite después del cambio de estado de negocio. No conecta un writer de outbox, repositorio de outbox, outbox transaccional ni relay de outbox de lib-streaming.

Política: cada definición JSON pública es un fact con entrega directa, gestión de DLQ on_routable_failure y fallback_on_circuit_open configurado por lib-streaming v3.
Límite real de Midaz: como no hay un writer de outbox conectado, el fallback de circuito abierto no puede persistir un evento. Las rutas de emisión registran e ignoran los errores de publicación en lugar de devolverlos al comando de negocio. Este no es un contrato de outbox atómico.
Límite del consumidor: Midaz no conecta un consumidor para estos hechos, y la política directa del productor no establece una garantía transaccional de entrega. Los consumidores deben mantener los handlers idempotentes y deduplicar con (ce-source, ce-id).

Contratos completos de `data`

Estas declaraciones estilo TypeScript reflejan las etiquetas JSON de data del CloudEvent en Midaz. Cada nombre de campo es su nombre JSON. ? significa que el campo tiene omitempty; | null significa que el campo admite nulos sin omitirse. Un comentario de tipo fuente conserva exactamente el tipo del inventario. Todos los campos de estos 12 payloads de Tracer están presentes (omitempty: false); los campos anulables se emiten igualmente con null cuando faltan.

limit.activated

Clave de definición: limit.activated (LimitActivatedDefinition)Evento: studio.lerian.tracer.limit.activatedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: ActivateLimitCommand activa un límite correctamente.Subject: p.ID

// limit.activated
type LimitActivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.created

Clave de definición: limit.created (LimitCreatedDefinition)Evento: studio.lerian.tracer.limit.createdTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: CreateLimitCommand crea un límite correctamente.Subject: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// limit.created
type LimitCreatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  limitType: string // string; wire null: false; omitempty: false
  asset: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  activeTimeStart: string | null // *string; wire null: true; omitempty: false
  activeTimeEnd: string | null // *string; wire null: true; omitempty: false
  customStartDate: string | null // *string; wire null: true; omitempty: false
  customEndDate: string | null // *string; wire null: true; omitempty: false
  resetAt: string | null // *string; wire null: true; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.deactivated

Clave de definición: limit.deactivated (LimitDeactivatedDefinition)Evento: studio.lerian.tracer.limit.deactivatedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: DeactivateLimitCommand desactiva un límite correctamente.Subject: p.ID

// limit.deactivated
type LimitDeactivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.deleted

Clave de definición: limit.deleted (LimitDeletedDefinition)Evento: studio.lerian.tracer.limit.deletedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: DeleteLimitCommand elimina un límite correctamente.Subject: p.ID

// limit.deleted
type LimitDeletedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  deletedAt: string // string; wire null: false; omitempty: false
}

limit.drafted

Clave de definición: limit.drafted (LimitDraftedDefinition)Evento: studio.lerian.tracer.limit.draftedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: DraftLimitCommand mueve a DRAFT un límite correctamente.Subject: p.ID

// limit.drafted
type LimitDraftedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.updated

Clave de definición: limit.updated (LimitUpdatedDefinition)Evento: studio.lerian.tracer.limit.updatedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: UpdateLimitCommand actualiza un límite correctamente.Subject: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// limit.updated
type LimitUpdatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  limitType: string // string; wire null: false; omitempty: false
  asset: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  activeTimeStart: string | null // *string; wire null: true; omitempty: false
  activeTimeEnd: string | null // *string; wire null: true; omitempty: false
  customStartDate: string | null // *string; wire null: true; omitempty: false
  customEndDate: string | null // *string; wire null: true; omitempty: false
  resetAt: string | null // *string; wire null: true; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.activated

Clave de definición: rule.activated (RuleActivatedDefinition)Evento: studio.lerian.tracer.rule.activatedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: ActivateRuleService activa una regla correctamente.Subject: p.ID

// rule.activated
type RuleActivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  activatedAt: string | null // *string; wire null: true; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.created

Clave de definición: rule.created (RuleCreatedDefinition)Evento: studio.lerian.tracer.rule.createdTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: CreateRuleCommand crea una regla correctamente.Subject: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// rule.created
type RuleCreatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  action: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.deactivated

Clave de definición: rule.deactivated (RuleDeactivatedDefinition)Evento: studio.lerian.tracer.rule.deactivatedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: DeactivateRuleService desactiva una regla correctamente.Subject: p.ID

// rule.deactivated
type RuleDeactivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  deactivatedAt: string | null // *string; wire null: true; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.deleted

Clave de definición: rule.deleted (RuleDeletedDefinition)Evento: studio.lerian.tracer.rule.deletedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: DeleteRuleService elimina una regla correctamente.Subject: p.ID

// rule.deleted
type RuleDeletedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  deletedAt: string // string; wire null: false; omitempty: false
}

rule.drafted

Clave de definición: rule.drafted (RuleDraftedDefinition)Evento: studio.lerian.tracer.rule.draftedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: DraftRuleService mueve a DRAFT una regla correctamente.Subject: p.ID

// rule.drafted
type RuleDraftedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.updated

Clave de definición: rule.updated (RuleUpdatedDefinition)Evento: studio.lerian.tracer.rule.updatedTema: lerian.streaming.tracerDLQ de ruta: lerian.streaming.tracer.dlqSchema: 1.0.0 (application/json)Se emite cuando: UpdateRuleCommand actualiza una regla correctamente.Subject: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// rule.updated
type RuleUpdatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  action: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

Índice de eventos emitidos

Clave de definición	`ce-type`	Schema	Subject	Se emite cuando
`limit.activated`	`studio.lerian.tracer.limit.activated`	`1.0.0`	`p.ID`	`ActivateLimitCommand` activa un límite correctamente.
`limit.created`	`studio.lerian.tracer.limit.created`	`1.0.0`	`p.ID`	`CreateLimitCommand` crea un límite correctamente.
`limit.deactivated`	`studio.lerian.tracer.limit.deactivated`	`1.0.0`	`p.ID`	`DeactivateLimitCommand` desactiva un límite correctamente.
`limit.deleted`	`studio.lerian.tracer.limit.deleted`	`1.0.0`	`p.ID`	`DeleteLimitCommand` elimina un límite correctamente.
`limit.drafted`	`studio.lerian.tracer.limit.drafted`	`1.0.0`	`p.ID`	`DraftLimitCommand` mueve a DRAFT un límite correctamente.
`limit.updated`	`studio.lerian.tracer.limit.updated`	`1.0.0`	`p.ID`	`UpdateLimitCommand` actualiza un límite correctamente.
`rule.activated`	`studio.lerian.tracer.rule.activated`	`1.0.0`	`p.ID`	`ActivateRuleService` activa una regla correctamente.
`rule.created`	`studio.lerian.tracer.rule.created`	`1.0.0`	`p.ID`	`CreateRuleCommand` crea una regla correctamente.
`rule.deactivated`	`studio.lerian.tracer.rule.deactivated`	`1.0.0`	`p.ID`	`DeactivateRuleService` desactiva una regla correctamente.
`rule.deleted`	`studio.lerian.tracer.rule.deleted`	`1.0.0`	`p.ID`	`DeleteRuleService` elimina una regla correctamente.
`rule.drafted`	`studio.lerian.tracer.rule.drafted`	`1.0.0`	`p.ID`	`DraftRuleService` mueve a DRAFT una regla correctamente.
`rule.updated`	`studio.lerian.tracer.rule.updated`	`1.0.0`	`p.ID`	`UpdateRuleCommand` actualiza una regla correctamente.

Resumen

Midaz

Tracer

Lender

Matcher

Reporter

Fetcher

Consignado

Pix Directo vía JD

Eventos de Tracer

Catálogo JSON público de Tracer

Sobre CloudEvents

Temas, manifiesto y enrutamiento

Semántica de entrega y fallo

Contratos completos de `data`

Índice de eventos emitidos

​Catálogo JSON público de Tracer

​Sobre CloudEvents

​Temas, manifiesto y enrutamiento

​Semántica de entrega y fallo

​Contratos completos de data

​Índice de eventos emitidos

Catálogo JSON público de Tracer

Sobre CloudEvents

Temas, manifiesto y enrutamiento

Semántica de entrega y fallo

Contratos completos de `data`

Índice de eventos emitidos