돈은 당신의 시스템이 지킵니다. 산수는 우리 것이 지킵니다.

도착을 믿을 수 있는 이벤트.

열한 가지 이벤트 타입이, 그것을 만든 상태 변경과 같은 트랜잭션에서 큐에 들어갑니다.

1. 01

   던지고 잊는 POST가 아니라 트랜잭셔널 아웃박스

   이벤트는 그것을 일으킨 트랜잭션 안에서 기록되고, 이후 리스 기반 큐에서 발송됩니다. 원장이 롤백한 일을 당신의 시스템이 통보받는 구간도, 원장은 커밋했는데 아무도 통보받지 못하는 구간도 없습니다.

   internal/outbox

2. 02

   서명되며, 키 id는 교체 가능

   모든 전달에 키 id와 타임스탬프가 붙은 HMAC-SHA256 서명이 실립니다. 교체는 겹칩니다. 전환하는 동안 예전 키가 유효하므로, 시크릿 교체는 일정을 잡아야 하는 중단이 아닙니다.

   internal/outbox/sign.go

3. 03

   정산 이벤트가 먼저 갑니다

   청구 지시는 알림 더미 뒤에 줄 서지 않습니다. 전달 등급은 별도의 차선이고, 정산은 자금 지시를 실은 차선입니다.

   internal/events

4. 04

   결정론적 id, 그래서 재실행은 아무 일도 하지 않습니다

   핸들러를 다시 돌리면 같은 이벤트 id가 다시 큐에 들어가고 아웃박스가 중복을 제거합니다. 조심조심 다뤄야 하는 최소 1회 전달이 아니라, 실제로 재시도할 수 있는 최소 1회 전달입니다.

   internal/events · internal/outbox

5. 05

   당신의 URL에 걸리는 아웃바운드 가드

   목적지는 운영자가 설정하며, 그것만으로 이미 구조적인 SSRF 통로입니다. 디스패처는 요청 전에 URL을 검사하고, 당연히 막아야 할 주소들을 막습니다.

   internal/outbox/ssrf.go

6. 06

   백오프, 파킹, 그리고 대사기

   실패는 간격을 늘려 재시도하다 결국 파킹되며, 내려간 목적지를 두들기지 않습니다. 큐가 완벽하리라 믿는 대신, 시스템 간 대사기가 정말로 사라진 이벤트를 잡아냅니다.

   internal/outbox · internal/reconciler

지금 정산하던 방식 그대로 정산하세요.

플랫폼은 정확한 원장 라인을 선점하고 지시합니다. 지급을 집행하는 것은 당신입니다.

internal/claims · internal/httpapi/payouts.go