Eventos de Dominio

Lana Bank publica eventos de dominio a traves del patron de outbox transaccional. Estos eventos pueden ser consumidos por sistemas externos para integracion, analitica y auditoria.

Todos los eventos se serializan como JSON e incluyen metadatos para trazabilidad y ordenamiento.

---

Estructura del Evento

Cada evento esta envuelto en un sobre con la siguiente estructura:

{
  "id": "uuid",
  "event_type": "core.credit.facility-activated",
  "payload": { ... },
  "recorded_at": "2024-01-15T10:30:00Z",
  "trace_id": "trace-uuid"
}

---

Access Events

Eventos relacionados con la gestion de usuarios y roles.

Event	Description	Payload Fields
UserCreated	Se creo un nuevo usuario	entity
RoleCreated	Se creo un nuevo rol	entity

---

Credit Events

Eventos relacionados con el ciclo de vida y operaciones de facilidades de credito.

Event	Description	Payload Fields
FacilityProposalCreated	Se creo una propuesta de facilidad de credito	entity
FacilityProposalConcluded	FacilityProposalConcluded	entity
PendingCreditFacilityCollateralizationChanged	Cambio el estado de colateralizacion para facilidad pendiente	entity
PendingCreditFacilityCompleted	PendingCreditFacilityCompleted	entity
FacilityActivated	Se activo una facilidad de credito	entity
FacilityCompleted	Una facilidad de credito fue totalmente pagada y cerrada	entity
FacilityCollateralizationChanged	Cambio el estado de colateralizacion para facilidad activa	entity
DisbursalInitialized	Se inició un desembolso y está pendiente de aprobación	entity
DisbursalApprovalConcluded	DisbursalApprovalConcluded	entity
DisbursalSettled	Se liquido un desembolso	entity
DisbursalCancelled	Se canceló un desembolso	entity
AccrualPosted	Se registro el devengamiento de intereses	entity
FacilityMatured	No description available	entity
PartialLiquidationInitiated	Se inicio una liquidacion parcial	entity

---

CreditCollateral Events

CoreCreditCollateralEvent module_description

Event	Description	Payload Fields
CollateralUpdated	CollateralUpdated	entity
LiquidationCollateralSentOut	LiquidationCollateralSentOut	amount, effective, ledger_tx_id, liquidation_id, recorded_at, secured_loan_id
LiquidationProceedsReceived	LiquidationProceedsReceived	amount, collateral_id, effective, ledger_tx_id, liquidation_id, payment_id, recorded_at, secured_loan_id
LiquidationCompleted	LiquidationCompleted	liquidation_id, secured_loan_id

---

CreditCollection Events

CoreCreditCollectionEvent module_description

Event	Description	Payload Fields
PaymentCreated	PaymentCreated	entity
PaymentAllocationCreated	PaymentAllocationCreated	entity
ObligationCreated	Se creo una nueva obligacion	entity
ObligationDue	Una obligacion vencio	entity
ObligationOverdue	Una obligacion entro en mora	entity
ObligationDefaulted	Una obligacion entro en incumplimiento	entity
ObligationCompleted	Una obligacion fue completamente pagada	entity

---

Custody Events

Eventos relacionados con custodia de Bitcoin y gestion de billeteras.

Event	Description	Payload Fields
WalletBalanceUpdated	No description available	entity

---

Customer Events

Eventos relacionados con el ciclo de vida del cliente y KYC.

Event	Description	Payload Fields
CustomerCreated	Se creo un nuevo cliente	entity
CustomerFrozen	Se congelo una cuenta de cliente, bloqueando operaciones financieras	entity
CustomerUnfrozen	Se descongelo una cuenta de cliente previamente congelada, restaurando operaciones normales	entity
CustomerClosed	La cuenta del cliente fue cerrada	entity
PartyCreated	No description available	entity
PartyEmailUpdated	No description available	entity
ProspectCreated	Se creó un nuevo prospecto para la incorporación	entity
ProspectKycStarted	Un prospecto inició la verificación KYC	entity
ProspectKycPending	La verificación KYC de un prospecto está pendiente de revisión	entity
ProspectKycDeclined	La verificación KYC de un prospecto fue rechazada	entity
ProspectConverted	Un prospecto fue convertido en cliente	entity
ProspectClosed	Un prospecto fue cerrado sin conversión	entity

---

Deposit Events

Eventos relacionados con cuentas de deposito y transacciones.

Event	Description	Payload Fields
DepositAccountCreated	Se creo una cuenta de deposito	entity
DepositInitialized	Se inicializo un deposito	entity
DepositReverted	Se revirtio un deposito	entity
WithdrawalInitialized	Se inició un retiro y está pendiente de aprobación	entity
WithdrawalApprovalConcluded	Se concluyó el proceso de aprobación de un retiro	entity
WithdrawalDenied	Se denegó un retiro	entity
WithdrawalConfirmed	Se confirmo un retiro	entity
WithdrawalCancelled	Se canceló un retiro	entity
WithdrawalReverted	Se revirtió un retiro confirmado	entity

---

Price Events

Eventos relacionados con actualizaciones de precio BTC/USD.

Event	Description	Payload Fields
PriceUpdated	Se actualizo el precio BTC/USD	price, timestamp
ProviderPriceFetched	No description available	price, provider_id, timestamp

---

Report Events

Eventos relacionados con generacion de reportes.

Event	Description	Payload Fields
ReportRunCreated	Se inicio una ejecucion de reporte	entity
ReportRunStateUpdated	Cambio el estado de ejecucion de reporte	entity

---

Governance Events

Eventos relacionados con flujos de aprobacion.

Event	Description	Payload Fields
ApprovalProcessConcluded	Se concluyo un proceso de aprobacion	entity

---

Time Events

CoreTimeEvent module_description

Event	Description	Payload Fields
EndOfDay	EndOfDay	closing_time, day, timezone

---

Referencia de Tipos de Eventos

Todos los tipos de eventos siguen la convencion de nombres: core.<module>.<event-name>

Modulo	Prefijo de Tipo de Evento
Access	core.access.*
Credit	core.credit.*
CreditCollateral	core.credit-collateral.*
CreditCollection	core.credit-collection.*
Custody	core.custody.*
Customer	core.customer.*
Deposit	core.deposit.*
Price	core.price.*
Report	core.report.*
Governance	governance.*
Time	core.time.*

---

Consumiendo Eventos

Los eventos se publican a traves del outbox transaccional y se pueden consumir mediante:

1. Consulta directa a la base de datos - Consultar la tabla de outbox
2. Streaming de eventos - Integracion con colas de mensajes (dependiente de la implementacion)
3. Pipelines ETL - Via extraccion de Meltano

Para detalles de integracion, contacte al equipo de plataforma.