주소정제 서비스 내재화 - 5화 ( 어질어질한 변화구들 )

단독건물 주소정제만으로는 외부 API 호출 트래픽을 충분히 줄일 수 없어, 상세 동 정보가 필요한 아파트·빌라 등 복합건물 정제에 착수했다. 정제 결과를 EXACT부터 NONE까지 정확도 레벨로 나누고, 고객 입력과 행안부 건물 DB의 표기를 전처리해 비교했으며, 기본주소에서 동을 찾지 못하면 주변 건물을 탐색해 유일한 후보가 있을 때만 주소를 보정하는 HIGH 레벨 로직을 만들었다. 행안부 건물 관리 백오피스와 테스트 코드를 함께 활용해 데이터 오류와 다양한 입력 패턴을 관리하고, 배송 실패나 배송 불가 지역 판정 오류 가능성도 줄이고자 했다. 복합건물 정제 이후 외부업체 API 호출은 눈에 띄게 줄었고, 정확도 레벨은 운영 이슈를 분류하고 개선 우선순위를 정하는 기준이 됐다.

• 복합건물 주소는 기본주소만으로 배송 위치를 특정할 수 없으므로 상세 동 정보까지 정제해야 한다.
• 주변 건물 탐색은 반경과 건물관리번호 앞 14자리, 단지명 토큰을 활용하고, 후보가 하나일 때만 다른 단지 주소로 보정한다.
• 고객 입력과 행안부 건물명은 숫자·한글·알파벳 표기를 정규화한 뒤 비교하면 동호수 순서나 표기 차이에 대응할 수 있다.
• 정제 결과를 정확도 레벨로 분류하고 테스트 코드와 변경 이력을 관리하면 패치 영향과 운영 이슈를 추적하기 쉽다.
• 주소 관리 백오피스에 주변 건물 조회, 위치 수정, 변경 이력, 캐시 삭제 기능을 두면 데이터 보정과 CS 대응에 활용할 수 있다.