AI가 안전하게 행동하도록 만드는 엔지니어

Problem

외부 Meta 호출과 DB 기록은 하나의 트랜잭션으로 묶을 수 없어, 실패와 재시도 과정에서 동일 요청이 중복 집행될 수 있었습니다.

Solution

• 실행 전 Idempotency Key를 선점해 동일 요청의 진입을 차단했습니다.
• 실행이 실패하면 예약을 해제해 안전한 재시도가 가능하도록 했습니다.
• Meta 집행은 성공했지만 후속 처리가 실패한 경우 결과를 기록하고 추가 집행을 차단했습니다.

Problem

사용자가 승인한 계획과 실제 실행 시점의 계획이 달라질 수 있는 무결성 리스크가 있었습니다.

Solution

• 계획을 proposal_hash로 고정해 승인된 내용의 변경 여부를 검증했습니다.
• 실행 직전에 승인 상태, 정책, 권한, 만료 여부를 다시 확인했습니다.
• 예산을 정수형 원화 단위로 정규화해 금액 해석의 차이를 제거했습니다.

Problem

승인 요청이 타임아웃되면 돈이 나갔는지 알 수 없습니다. 나가지 않았다고 판단했는데 실제로는 나갔다면, 취소할 대상을 모른 채 청구된 돈이 영영 돌아오지 않습니다.

Solution

• 확실히 거절된 경우(4xx)만 집행되지 않은 것으로 보고, 타임아웃과 5xx는 전부 집행된 것으로 취급했습니다.
• 예외에 실려 온 승인 식별자를 결제 기록에 남겨 취소할 대상을 잃지 않도록 했습니다.
• 실제로 집행되지 않았다면 취소 요청이 '이미 취소됨'으로 돌아오므로, 그 응답을 성공으로 흡수했습니다.

Problem

환불 후처리는 외부 취소, 적립금 복원, 쿠폰 복원, 정산 제외, 주문 확정 다섯 단계입니다. 하나로 묶으면 뒤 단계의 실패가 앞의 성공까지 롤백시키고, 앞에서 멈추면 정산 제외가 실행되지 않아 환불된 금액이 강사에게 지급됩니다.

Solution

• 각 단계를 독립 트랜잭션으로 분리하고 성공·실패를 행으로 남겼습니다.
• 한 단계가 실패해도 예외를 삼키고 나머지 단계를 계속 진행했습니다.
• 실패로 남은 단계는 5분 주기 배치가 시도 5회까지 재개하도록 했습니다.