이마트는 사내 결제 플랫폼 eMoney를 포함한 핵심 시스템들이 수년간 독립적으로 성장하면서 API 간 품질 편차, 문서 부재, 통합 관리 공백이라는 세 가지 구조적 문제에 봉착했습니다.

개발마다 상이한 방식으로 API를 설계·운영한 결과, 사용 팀은 정확한 명세를 확보하기 어렵고 통합팀은 전체 API 현황을 파악조차 할 수 없는 상태였습니다.

이마트 D/T본부 차세대혁신담당은 단순한 도구 도입이 아닌 진단 → 표준화 → 검증으로 이어지는 체계적 접근이 필요하다고 판단, API 거버넌스와 엔터프라이즈 통합 분야의 글로벌 수준의 전문성을 보유한 하나루프를 파트너로 선택했습니다.

하나루프는 프로젝트 착수 전, 고객 환경에 맞는 독자적인 3단계 Engagement 구조를 설계했습니다. 단순 실행 대행이 아닌, 각 단계의 산출물이 다음 단계의 입력값이 되는 논리적 연속성을 갖춘 것이 핵심입니다.

또한 Agile Scrum 방법론을 컨설팅 전 과정에 적용하여 Sprint마다 고객 책임자의 승인(Demo & Review)을 거치는 구조를 설계함으로써, 결과물의 방향이 고객 기대와 어긋나는 리스크를 사전에 차단했습니다.

하나루프는 자체 정의한 API 진단 프레임워크를 적용하여 eMoney API를 유지보수성·통합성·운용성 세 축으로 평가했습니다. 기존 API 문서, 개발자 인터뷰, 코드 저장소, 테스트 케이스, 모니터링 리포트를 교차 분석하여 표면적 문제가 아닌 구조적 품질 격차(Quality Gap)를 도출했습니다.

진단 결과는 단순 현황 나열이 아니라 개선 우선순위 실행 가능한 권고사항이 포함된 보고서로 제공되었으며, 동시에 이마트 환경에 최적화된 API Gateway 솔루션 선정 권장사항을 함께 제시했습니다.

고객이 "무엇이 문제인가"를 넘어 "무엇을 먼저 해야 하는가"를 판단할 수 있도록 설계된 결과물입니다.

진단 결과를 기반으로 하나루프는 eMoney API endpoint들을 OpenAPI 표준으로 직접 정의하고, API Documentation Repository 웹 포털을 구축했습니다. 핵심은 단순한 문서 작업이 아니라, SCM 연동을 통한 문서 자동화 파이프라인을 설계했다는 점입니다. 이로써 이후 개발팀이 API를 추가·변경할 때마다 문서가 자동으로 갱신되는 지속 가능한 구조가 만들어졌습니다.

이 단계에서 하나루프가 제공한 것은 포털 설치가 아니라, API 표준화 문화가 조직 내 자연스럽게 내재화될 수 있는 기반이었습니다.

하나루프는 선정된 API Gateway를 이마트 개발 환경에 직접 설치하고, Test Client와 Mock Server를 자체 구축하여 eMoney API 연동을 단계적으로 검증했습니다. 단순 설치 검증에 그치지 않고, routing·caching·rate-limiting 등 Gateway의 핵심 기능을 실제 eMoney 서버와 연동하여 실증함으로써 프로덕션 전환의 현실적 가능성을 이마트 경영진에게 직접 보여주었습니다.

PoC 설계 시 하나루프는 현재 시스템의 cloud/on-prem 혼용 구조와 네트워크 토폴로지를 면밀히 분석하여, 이마트 고유 환경에 맞는 아키텍처 안을 제시했습니다. 이는 범용 레퍼런스가 아닌 이마트 맞춤형 통합 청사진이었습니다.