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.email, entity.id, entity.role_id
RoleCreated	Se creo un nuevo rol	entity.id, entity.name

---

Credit Events

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

Ciclo de Vida de Facilidad

Event	Description	Payload Fields
FacilityProposalCreated	Se creo una propuesta de facilidad de credito	entity.amount, entity.created_at, entity.customer_id, entity.id, entity.status, entity.terms
FacilityActivated	Se activo una facilidad de credito	entity.activated_at, entity.activation_tx_id, entity.amount, entity.collateral_id, entity.collateralization, entity.completed_at, entity.customer_id, entity.id, entity.liquidation_trigger
FacilityCompleted	Una facilidad de credito fue totalmente pagada y cerrada	entity.activated_at, entity.activation_tx_id, entity.amount, entity.collateral_id, entity.collateralization, entity.completed_at, entity.customer_id, entity.id, entity.liquidation_trigger

Eventos de Colateral

Event	Description	Payload Fields
PendingCreditFacilityCollateralizationChanged	Cambio el estado de colateralizacion para facilidad pendiente	entity.amount, entity.collateralization, entity.completed_at, entity.created_at, entity.customer_id, entity.id, entity.status, entity.terms
FacilityCollateralizationChanged	Cambio el estado de colateralizacion para facilidad activa	entity.activated_at, entity.activation_tx_id, entity.amount, entity.collateral_id, entity.collateralization, entity.completed_at, entity.customer_id, entity.id, entity.liquidation_trigger

Eventos de Pago

Event	Description	Payload Fields
DisbursalSettled	Se liquido un desembolso	entity.amount, entity.credit_facility_id, entity.id, entity.settlement, entity.status
AccrualPosted	Se registro el devengamiento de intereses	entity.credit_facility_id, entity.due_at, entity.id, entity.period, entity.posting

Eventos de Liquidacion

Event	Description	Payload Fields
PartialLiquidationInitiated	Se inicio una liquidacion parcial	entity.activated_at, entity.activation_tx_id, entity.amount, entity.collateral_id, entity.collateralization, entity.completed_at, entity.customer_id, entity.id, entity.liquidation_trigger

Event	Description	Payload Fields
FacilityProposalConcluded	No description available	entity.amount, entity.created_at, entity.customer_id, entity.id, entity.status, entity.terms
PendingCreditFacilityCompleted	No description available	entity.amount, entity.collateralization, entity.completed_at, entity.created_at, entity.customer_id, entity.id, entity.status, entity.terms
DisbursalApprovalConcluded	No description available	entity.amount, entity.credit_facility_id, entity.id, entity.settlement, entity.status

---

Custody Events

Eventos relacionados con custodia de Bitcoin y gestion de billeteras.

Event	Description	Payload Fields
WalletBalanceUpdated	No description available	entity.address, entity.balance, entity.id, entity.network

---

Customer Events

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

Event	Description	Payload Fields
CustomerCreated	Se creo un nuevo cliente	entity.id, entity.kyc_verification, entity.party_id
CustomerKycUpdated	No description available	entity.id, entity.kyc_verification, entity.party_id
PartyCreated	No description available	entity.customer_type, entity.email, entity.id
PartyEmailUpdated	No description available	entity.customer_type, entity.email, entity.id
ProspectCreated	No description available	entity.id, entity.kyc_status, entity.party_id, entity.stage, entity.status
ProspectKycStarted	No description available	entity.id, entity.kyc_status, entity.party_id, entity.stage, entity.status
ProspectKycPending	No description available	entity.id, entity.kyc_status, entity.party_id, entity.stage, entity.status
ProspectKycDeclined	No description available	entity.id, entity.kyc_status, entity.party_id, entity.stage, entity.status
ProspectConverted	No description available	entity.id, entity.kyc_status, entity.party_id, entity.stage, entity.status
ProspectClosed	No description available	entity.id, entity.kyc_status, entity.party_id, entity.stage, entity.status

---

Deposit Events

Eventos relacionados con cuentas de deposito y transacciones.

Event	Description	Payload Fields
DepositAccountCreated	Se creo una cuenta de deposito	entity.account_holder_id, entity.id
DepositInitialized	Se inicializo un deposito	entity.amount, entity.deposit_account_id, entity.id
WithdrawalConfirmed	Se confirmo un retiro	entity.amount, entity.deposit_account_id, entity.id, entity.status
WithdrawalApprovalConcluded	No description available	entity.amount, entity.deposit_account_id, entity.id, entity.status
DepositReverted	Se revirtio un deposito	entity.amount, entity.deposit_account_id, entity.id

---

Price Events

Eventos relacionados con actualizaciones de precio BTC/USD.

Event	Description	Payload Fields
PriceUpdated	Se actualizo el precio BTC/USD	price, 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.id, entity.process_type, entity.status, entity.target_ref

---

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.*
Custody	core.custody.*
Customer	core.customer.*
Deposit	core.deposit.*
Price	core.price.*
Report	core.report.*
Governance	governance.*

---

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.