주석 오류와 드리프트 감시로 수수료 처리 안정성 확보

결제 플랫폼의 충전 수수료 처리 로직을 정리하면서 코드와 주석 사이의 불일치를 발견했고, 동시에 수수료 차감 과정에서 발생할 수 있는 데이터 드리프트를 감시하는 기능을 추가했다.

주석이 거짓말을 할 때

사실 이번 작업의 절반은 "코드 리뷰"였다. 충전 수수료를 로트(lot) 잔액에서 차감하는 부분을 다시 들여다봤는데, 주석이 실제 동작과 맞지 않는 부분을 발견했다. 이건 생각보다 흔한 문제다.

코드는 살아있는 실체지만, 주석은 과거의 유물일 수 있다. 누군가가 로직을 개선했을 때, 새로운 팀원이 인수인계받을 때, 요구사항이 변했을 때—이런 순간들에 주석이 따라가지 못한다. 나는 이걸 "주석 부채"라고 부르는데, 부채는 쌓일수록 이자가 커진다.

특히 결제 시스템처럼 금액 계산이 들어가는 부분은 잘못된 주석이 팀원을 잘못된 이해로 유도할 수 있다. 다음 사람이 "아, 이건 A 방식으로 동작하는 거구나" 하고 또 다른 수수료 처리 로직을 짜면, 시스템 전체에 일관성이 깨진다.

주석 정정만으로는 충분하지 않았다. 더 근본적인 질문을 던졌다: 실제로 로트 차감이 제대로 일어나고 있나?

충전 수수료는 여러 곳에서 처리될 수 있다. 초기 차감, 재정렬(C-1 재정리), 환불 시 복구 등. 이런 지점들이 많을수록 데이터가 "드리프트"할 수 있다. 즉, 우리가 기대하는 값과 실제 데이터베이스의 값이 점점 멀어지는 것이다.

이 드리프트는 보통 정산 때까지 감춰진다. 그리고 정산이 맞지 않으면 뒤늦게 원인을 파헤쳐야 한다. 결제 시스템에서는 그런 시간이 없다.

그래서 이번에는 드리프트를 조기에 감지하는 알림 로직을 추가했다. 만약 수수료 차감이 예상과 다르게 일어나면, 즉시 관리자에게 알려주는 식이다. 이렇게 하면 문제가 작을 때 발견하고 대응할 수 있다.

주석을 정정한다고 해도, 앞으로 또 누군가는 주석을 무시하고 코드만 봐야 한다. 그래서 정말 중요한 건 주석에만 의존하지 않는 시스템을 만드는 것이다. 드리프트 감시는 정확히 그거다—코드가 올바르게 동작하는지를 자동으로 확인하는 메커니즘.

사실 이런 식의 감시 로직은 결제 시스템이 아니어도 중요하다. 멀티 스테이프 처리, 비동기 작업, 여러 엔티티가 얽혀 있는 부분이라면 언제든 드리프트가 생길 수 있다. 나는 이제 이런 지점들을 설계할 때 "드리프트를 어떻게 감시할까"를 먼저 생각한다.

앞으로 코드 리뷰할 때도, 주석과 코드 사이의 갭을 발견하면 단순히 주석을 수정하는 데 그치지 말고, 더 근본적으로 "이게 정말 지금처럼 동작하는 게 맞나?"라고 물어보려고 한다. 그리고 금액이 들어가는 부분이라면 더더욱.

🛒 이 글과 어울리는 추천 상품

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.