수수료 최소값과 비교 기준값을 정책 문서에서 명확히 분리

내부 정책 문서를 정리하면서 '비교 기준값'과 '플랫폼 수수료 최소값' 두 개념을 명확히 분리했다. 한 파일에서 여러 정책을 관리할 때 이런 개념 분리가 왜 중요한지, 그리고 어떤 문제를 예방하는지 정리해봤다.

두 가지 값의 혼동이 왜 생기나

시스템을 운영하다 보면 '기준'이라는 단어가 여러 맥락에서 나타난다. 비교 기준값(A)은 어떤 조건을 판단할 때 쓰는 임계값이고, 플랫폼 수수료 최소값(B)은 거래 시 부과되는 수수료의 하한선이다. 얼핏 보면 비슷해 보이지만, 쓰이는 곳이 전혀 다르다.

혼동이 생기는 이유는 보통 이렇다. 문서를 처음 작성할 때는 명확했지만, 시간이 지나면서 누군가는 A를 기준으로 로직을 짜고, 누군가는 B를 기준으로 짠다. 그러다 "기준값이 뭐였더라?"라고 물을 때 두 값을 혼용하기 쉽다. 특히 onboarding 초기에 문서를 ざっと 읽은 개발자는 더욱.

분리의 의미

이번 작업은 단순한 이름 정리가 아니라, 각 값이 어떤 책임을 가지는지 명시하는 과정이었다.

이렇게 분리하면:
- 어느 값을 수정할 때 어느 부분을 영향도 분석해야 하는지 명확해진다
- 코드 리뷰 때 "어? 이건 A를 써야 하는데 B를 쓰네?"라는 실수를 조기에 잡을 수 있다
- 새로 온 팀원도 문서를 읽으면서 "아, 이 둘은 다구나"라고 자연스럽게 이해한다

회고

문서화 작업은 코드 변경만큼 중요하다고 느낀다. 특히 정책이나 비즈니스 규칙이 얽혀 있을 때는 더욱. 이번처럼 개념을 명확히 이름 짓고 분리하는 것이 나중에 몇 시간의 버그 헌팅이나 혼동을 줄여준다.

.claude/CLAUDE.md 같은 운영 문서는 초기에만 쓰이는 게 아니라, 6개월 뒤 "어라, 이 로직 왜 이렇게 짰더라?"라고 다시 읽게 되는 파일이다. 그래서 처음부터 정확하게 남기는 게 중요하다.