event-processor

Event Processor

Consumes loan lifecycle events and handles audit trails, notifications, and aggregate stats.

Stack

Java 21, Spring Boot, Spring Kafka

Consumer Modes

• Local/Docker: @KafkaListener polling from loan-events topic
• Cloud: HTTP push via QStash → POST /internal/events

Switching is controlled by nanolend.consumer-mode property. Both paths use the same handler logic.

Idempotency

Every event is checked against an event_log table before processing. Redelivery is safe.

Dead Letter Queue

Failed events route to loan-events-dlq for manual review.