본인인증 SMS 전환 완료, 다음 단계 정의
목차
어느 정도 규모가 되는 팀에서 진행 중인 작업을 파악하고 다음 사람에게 넘겨주는 건 생각보다 복잡하다. 특히 개발과 운영이 나뉘어 있거나, 여럿이 같은 영역을 건드려야 할 때는 더더욱. 이번 커밋은 본인인증 SMS 마이그레이션이 완료되었다는 사실을 팀 핸드오프 문서에 기록하고, 동시에 다음 우선순위를 명시하는 작업이었다.
마이그레이션 완료를 기록하는 의미
"본인인증 SMS 전환"이라는 한 줄이 문서에 추가되는 것은 단순해 보이지만, 뒤에는 꽤 많은 일들이 축약되어 있다. 이전에는 어떤 방식으로 본인인증을 처리했고, SMS로 전환하면서 어떤 변경이 일어났는지, 테스트는 충분했는지, 기존 사용자들에게 어떤 영향이 있는지 등등. 마이그레이션이라는 작업은 코드 배포로 끝나지 않는다. 구버전 코드가 남아 있을 수도 있고, 폴백 로직이 필요할 수도 있고, 모니터링이 필요할 수도 있다. 그래서 이런 변경 사항을 문서로 남기는 게 중요하다.
핸드오프 문서란 다음과 같은 질문들에 명확하게 답할 수 있어야 한다:
- 무엇이 완료되었나? → 본인인증 SMS 전환
- 언제 완료되었나? → commit hash로 추적 가능
- 다음은 무엇인가? → 가상계좌 발급현황 admin 기능
- 왜 이 순서인가? → 문서에 명시되어야 다음 담당자가 이해함
특히 총괄 팀장 입장에서 이런 문서는 단순 기록이 아니라 팀의 협업 인프라다. 누군가 병가를 내거나 프로젝트가 잠시 중단되었다가 재개될 때, 이 문서만 봐도 현재 상태를 파악하고 다시 움직일 수 있다.
SMS 전환, 왜 하는가
본인인증 방식을 변경한다는 것은 보통 다음 같은 이유들이 있다:
- 이전 방식의 한계 — 예를 들어, 이메일 인증은 응답 시간이 길고, 전화 인증은 비용이 많이 든다
- 사용자 경험 개선 — SMS는 거의 실시간에 가깝고, 대부분의 사용자가 휴대폰을 들고 다닌다
- 외부 의존성 감소 — 기존 인증 제공자가 비싸거나 불안정했을 가능성
- 규정 변화 — 금융 감시 기관이나 결제 관련 정책이 변경되었을 수 있다
마이그레이션 작업은 단순히 "SMS 발송" 코드를 추가하는 정도로 끝나지 않는다. 기존 사용자와 신규 사용자를 어떻게 구분할지, 폴백 메커니즘은 어떻게 할지, SMS 발송이 실패했을 때는 어떻게 할지 등을 모두 고려해야 한다. 또한 모니터링도 필요하다 — SMS 발송 성공률, 사용자 인증 완료율, 에러율 등을 추적해서 이전 방식과 비교해야 한다.
다음 단계, 왜 가상계좌 발급현황 admin인가
"다음 = 가상계좌 발급현황 admin"이라고 명시한 건 팀의 우선순위를 드러낸다. 왜 이 작업이 다음인가?
일반적으로 결제 플랫폼이나 금융 서비스에서 "발급현황"을 관리하는 기능은:
- 운영팀의 필수 도구 — 매일 발생하는 수십~수천 건의 거래를 추적해야 함
- 장애 대응의 핵심 — "왜 이 가상계좌가 안 만들어졌나?" 하는 문의에 빠르게 답할 수 있어야 함
- 비즈니스 인사이트 — 어느 시간대에 발급이 집중되는지, 실패율은 얼마나 되는지 파악 필요
이를 admin 화면으로 제공한다는 것은 운영팀이 개발팀 없이 독립적으로 상황을 파악할 수 있도록 하는 거다. 요청이 들어올 때마다 "개발팀에 물어봐야 한다"는 상황을 피하려는 의도가 보인다.
팀 리딩 관점에서
이런 문서 갱신이 사소해 보일 수도 있지만, 팀 규모가 커질수록 중요해진다. 특히:
- 온보딩 시간 단축 — 새로운 팀원이 들어왔을 때, "지금 뭘 하고 있어?" 하는 질문에 문서 하나를 건네면 된다
- 컨텍스트 스위칭 비용 감소 — 다른 프로젝트에 갔다가 돌아올 때, 어디서 끝났는지 쉽게 파악 가능
- 우선순위 명확화 — "왜 SMS 전환을 먼저 했고, 이제 가상계좌 admin을 해야 하나?"가 자명해짐
- 리스크 감소 — "누가 뭘 했는지" 기록이 남으면, 한 사람이 빠져도 프로젝트가 멈추지 않는다
내 경험상, 이런 "문서만 갱신하는" 작업이 얼마나 팀의 협업을 부드럽게 하는지 때로는 과소평가된다. 코드 리뷰나 테스트만큼 중요하진 않다고 생각할 수 있지만, 팀의 효율은 코드의 품질뿐 아니라 정보의 투명성에도 달려 있다.
🛒 이 글과 어울리는 추천 상품
*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.
댓글 0
첫 댓글 달아줘.