PaymentServiceApplication.java

package com.checkout.paymentgw.payment;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.scheduling.annotation.EnableScheduling;

/**
 * Write-side / orchestrator of the payment saga.
 *
 * <p>End-to-end flow for {@code POST /api/payments}:
 * <ol>
 *   <li>Validate (Jakarta Bean Validation + custom expiry validator)</li>
 *   <li>Idempotency check (Redis)</li>
 *   <li>Sync REST to {@code fraud-check-service} (≤ 250 ms, circuit-broken)</li>
 *   <li>Sync REST to {@code bank-adapter-service} (≤ 2 s, circuit-broken)</li>
 *   <li>Persist {@code payment} row + {@code payment_outbox} row in one transaction</li>
 *   <li>Outbox poller publishes to Kafka {@code payments.events}</li>
 *   <li>Return API response</li>
 * </ol>
 *
 * @see com.checkout.paymentgw.payment.application.CreatePaymentUseCase
 * @see com.checkout.paymentgw.payment.outbox.OutboxPublisher
 */
@SpringBootApplication
@EnableScheduling
public class PaymentServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(PaymentServiceApplication.class, args);
    }
}