배달의민족 Flutter 도입과 아키텍처 설계 교훈

배달의민족은 주문접수 채널에서 Flutter를 도입하여 멀티 플랫폼 대응력을 높이고, Clean Architecture를 통해 효율적인 코드 관리를 실현했습니다. 이 글에서는 Flutter 도입과 아키텍처 설계의 과정에서 얻은 교훈을 바탕으로, 변화하는 비즈니스 요구에 맞추기 위한 혁신적인 접근을 소개합니다. 또한, 이러한 경험이 다른 기업이나 개발자에게도 유용한 전략이 될 수 있도록 공유하고자 합니다. Flutter 도입으로 인한 혁신적인 변화 배달의민족은 Flutter 도입을 통해 플랫폼 전환과 유지보수 측면에서 큰 혁신을 이루었습니다. 기존의 Windows, Android, iOS 플랫폼에 추가하여 macOS와 다양한 Android 디바이스로까지 확장할 필요성을 느꼈습니다. Flutter의 도움으로 단일 코드베이스에 의해 멀티 플랫폼을 동시에 지원할 수 있게 되었고, 이를 통해 개발자 수를 줄이고 생산성을 향상시킬 수 있었습니다. 개발자들은 각 플랫폼에 대해 반복적으로 구현할 필요가 없어졌고, 버그 수정이나 기능 변경 시에도 이전에 비해 적은 시간에 모든 플랫폼에 적용할 수 있게 되었습니다. Flutter의 도입은 크로스 플랫폼 반응형 UI 구현을 가능하게 하여, 사용자 경험의 일관성을 높였습니다. 이제 파트너들은 다양한 OS 환경에서 동일한 경험을 하게 되므로, 학습 비용도 줄어들고, 혼란이 줄어드는 장점을 경험하고 있습니다. 이러한 변화는 단순히 기술적인 접근방식이 아닌, 사업의 방향성을 전환하는 계기로 작용했습니다. 파트너사들이 원하는 효율적인 주문 관리 시스템을 제공하기 위해, 기존의 네이티브 아키텍처에서 벗어나 새로운 기술 스택으로 과감히 옮겨갔습니다. Firebase와 같은 클라우드 서비스를 활용하여 실시간 데이터 업데이트와 동기화가 가능하게 되었고, Flutter의 강점을 극대화하여 사용자 친화적인 UI/UX도 구현됐습니다. 이로 인해 즉각적인 피드백을 수렴할 수 있는 구조가 마련됐습니다. 결국 Flutter의 도입은 배달의...

Kotlin으로 전환한 Java 레거시 시스템 개선 사례




2025년 상반기, 배민페이 플랫폼팀은 Java 기반의 레거시 시스템을 Kotlin으로 전환하는 대규모 프로젝트를 수행했습니다. 이 과정에서 기술적 이슈를 해결하고, 팀의 개발 언어 통일과 함께 생산성을 높이는 것을 목표로 했습니다. 이번 글에서는 Kotlin으로의 전환이 어떻게 이루어졌고, 어떤 결과를 가져왔는지에 대해 자세히 살펴보겠습니다.

Java 레거시 시스템의 전환 전략

Kotlin으로의 전환은 단순한 언어 변경을 넘어 팀의 전반적인 개발 프로세스와 코드 품질에 긍정적인 영향을 미쳤습니다. 우선, 시스템의 유지보수를 개선하기 위해 처음으로 도입한 전략은 테스트 코드부터 Kotlin으로 전환하는 것이었습니다. 테스트 코드는 실제 운영 로직에 직접적인 영향을 주지 않으면서도 Kotlin 문법을 실험해보기 안전한 영역이기 때문입니다. 이 단계에서는 기존 테스트 코드의 커버리지를 점검하여, 커버리지가 부족한 부분을 보완하기 위한 작업도 동시에 진행했습니다. 또한, 테스트 스타일을 통일하기 위해 Kotest와 MockK를 도입했습니다. 이는 테스트 코드의 가독성과 작성 경험을 향상시켜 팀원 간의 협업 효율성을 높이는 데 기여했습니다. 배포 전략에서도 변화가 있었습니다. 기능 단위로 잘게 나누어 점진적으로 배포하는 방식은 장애 가능성을 최소화하고, 코드 리뷰 및 QA 과정을 간소화하는 데 도움을 주었습니다. 이러한 전략적 접근은 프로젝트 수행 중 단 한 번의 장애 없이 진행할 수 있던 요인이 되었습니다.

프로그래밍 언어 변경으로 인한 기술적 이슈

전환 과정에서 Java 코드를 Kotlin으로 변환할 때 다양한 기술적 이슈들이 발생하기 마련입니다. 유의미한 코드 품질 개선을 위해 가장 주의 깊게 다뤄야 하는 부분 중 하나는 null 처리였습니다. Java에서 모든 객체는 null이 될 수 있는 반면, Kotlin은 nullable과 non-nullable 타입을 명확히 구분하는 구조입니다. 이를 점검하며 수작업으로 코드 수정 진행을 하였고, 이 과정에서 발생할 수 있는 오류를 방지하기 위해 null 체크 작업을 필수적으로 수행했습니다. 이 외에도 Lombok을 데이터를 공통적으로 사용하는 방식으로 변환해야 했습니다. Lombok에서 제공하는 @Getter, @Setter와 같은 어노테이션은 Kotlin에서는 불필요하므로, 이를 간단한 data class로 재작성했습니다. 이는 코드의 복잡도를 줄이고 가독성을 높이는 데 기여했습니다. 나아가, Java의 Stream API를 제거하고 Kotlin의 컬렉션 함수로 변경함으로써 코드 흐름을 더욱 간결하게 만들 수 있었습니다. 이러한 일련의 과정들은 팀이 Kotlin의 특성을 최대한 활용하도록 도와주었습니다.

안정적인 전환과 팀 문화의 발전

Kotlin 전환 프로젝트는 단순히 언어를 변경한 것에 그치지 않고, 개발 문화에서도 긍정적인 변화를 조성하였습니다. 전환되는 동안 약 82개의 작업 티켓이 처리되었고, 10회에 걸친 운영 배포가 이뤄졌지만, 그 과정에서 단 한 건의 장애도 발생하지 않았습니다. 이러한 결과는 팀 내 개발 표준을 확립하는 데 큰 도움이 되었습니다. 기술적 일관성이 확보됨에 따라 협업 과정이 한층 원활해졌습니다. Kotlin으로 통일된 개발 언어는 코드 리뷰 및 신규 개발 시 진입 장벽을 낮췄고, 팀원 간의 소통을 강화했습니다. 더불어, 테스트와 배포 전략을 함께 설계한 경험은 팀원들에게 변화를 함께 설계하고 논의하는 협업 문화를 자연스럽게 자리잡게 했습니다. 올해의 Kotlin 전환 경험은 앞으로 유사한 프로젝트를 진행하는 데 자신감을 주었습니다. 안정성을 우선으로 하면서도 점진적으로 추진한 이번 전환은 팀의 미래에 대한 기반을 다지는 계기가 되었음을 자부합니다.

이번 Kotlin 전환 프로젝트는 Java 기반 레거시 시스템을 개선하기 위한 다각적인 접근의 결과물로 요약됩니다. 사용자는 향상된 코드 품질과 안정성을 직접적으로 느낄 수 있으며, 다음 단계로는 이러한 경험을 바탕으로 지속적인 기술 개선과 새로운 도전에 맞서겠다는 의지를 가지고 있습니다. 이는 결국 팀의 기술 자산을 더욱 풍부하게 할 것입니다.

이 블로그의 인기 게시물

우아한형제들의 실시간 알림 혁신: SSE(Server-Sent Events)로 이룬 효율성과 안정성

이미지
운영 효율성의 혁신 기존의 MQTT 기반 실시간 알림 시스템은 빠르지만, 운영의 복잡성과 네트워크 제약이 존재했습니다. MQTT는 별도의 포트를 필요로 하기 때문에 방화벽 이슈가 잦았고, 각 클라이언트별 Polling 로직은 서버 트래픽을 불필요하게 증가시켰습니다. 이러한 문제는 인프라 비용 증가로 직결되었습니다. 우아한형제들은 이 문제를 해결하기 위해 Server-Sent Events(SSE)를 도입했습니다. SSE는 HTTP 표준 포트를 이용해 통신하므로 방화벽 문제를 근본적으로 해결했습니다. 또한 Polling 구조가 제거되면서 네트워크 요청 횟수가 급감하고, 서버 처리 부하 역시 현저히 감소했습니다. 결과적으로 서버 대수가 줄고, 일평균 약 4천만 건 이상의 이벤트를 안정적으로 처리할 수 있게 되었습니다. 개인적인 견해로는, 단순한 기술 교체를 넘어 “운영 효율성”이라는 비즈니스 가치로 확장된 사례라 평가할 수 있습니다. 개발 효율이 인프라 절감과 사용자 만족을 동시에 이끈 대표적인 케이스입니다. 안정적인 메시지 전달 체계 구축 SSE의 도입은 단순한 비용 절감이 아니라, 메시지의 신뢰성과 안정성을 강화한 기술적 진화이기도 합니다. SSE는 서버에서 클라이언트로 단방향 실시간 스트림을 유지하여, 연결 상태가 유지되는 한 발생하는 모든 이벤트를 즉시 전달할 수 있습니다. 특히 우아한형제들은 Last-Event-ID 기능을 적극 활용했습니다. 이 기능은 클라이언트가 잠시 연결이 끊겼다가 재접속하더라도, 마지막으로 받은 이벤트 이후의 메시지를 재전송받을 수 있도록 합니다. 덕분에 프린트 명령 등과 같은 중요한 이벤트가 유실되는 일이 사라졌습니다. 모든 메시지는 Kafka와 같은 고성능 메시지 브로커를 통해 순서가 보장된 상...
자세한 내용 보기

우아한 디버깅 툴 개선으로 QA 업무 효율화

이미지
세션 리플레이로 이슈 재현 시간 단축 QA 업무의 핵심은 “문제를 얼마나 정확하게 재현하느냐”입니다. 과거에는 문제가 발생한 상황을 영상으로 녹화하고, 동일한 조건을 맞추는 데 많은 시간이 소요됐습니다. 그러나 **세션 리플레이** 기능이 도입되면서 상황이 완전히 달라졌습니다. DOM 스냅샷, 사용자 클릭, 입력 이벤트 등 모든 상호작용이 자동 기록되어 마치 영상을 돌려보듯 확인이 가능합니다. 이제 QA 담당자는 반복적인 수동 재현 작업에서 벗어나 보다 분석 중심의 업무에 집중할 수 있게 되었죠. 저는 특히 이 기능이 단순한 자동화 이상의 의미를 가진다고 생각합니다. 문제를 ‘정확히’ 보여줄 수 있다는 점에서, 개발자와 QA 간의 오해를 줄이고 문제 해결의 속도를 높여줍니다. 이처럼 시각적 정보 기반의 재현 방식은 QA 효율을 끌어올리는 중요한 도약점이 되었습니다. 슬랙 DM 알림으로 신속한 정보 전달 QA 업무의 또 다른 어려움은 정보를 제때 전달하는 문제였습니다. 이슈 발생 후 기록방 링크를 수동으로 공유하고, 개발자가 확인하기까지 지연이 발생하는 경우가 많았습니다. 이 불편을 해소하기 위해 **슬랙 DM 자동 알림** 기능이 도입되었습니다. 테스트 디바이스 정보를 입력하면 자동으로 관련 기록방 링크와 로그 정보가 개발자에게 전달됩니다. 덕분에 QA는 더 이상 “공유 늦음”이나 “링크 누락” 문제로 시간을 낭비하지 않게 되었습니다. 물론 구현 과정은 간단하지 않았습니다. 사용자별로 계정과 디바이스가 달라 연결 구조를 만드는 것이 까다로웠기 때문입니다. 이를 해결하기 위해 구글 시트를 연동하여 Slack ID와 디바이스를 매칭하는 방식을 적용했습니다. 이 결과, 알림 전송 속도와 정확성이 개선되었고 QA-개발 간 커뮤니케이션이 실시간으로 이어졌습니다. 개인적으로 이런 자동화 기능은 “툴이 사람의 시간을 되돌려주는” 대표 사례라 생각합니다. 티켓 생성 기능으...
자세한 내용 보기

물어보새의 진화와 지식 공유 확장

이미지
1. 물어보새의 지속적인 진화 ‘물어보새’의 시작점은 구성원이 데이터에 쉽게 접근하고, 이를 통해 업무 효율성을 높이는 것이었습니다. 초기 모델은 단순한 데이터 조회 중심의 기능을 제공했지만, 시간이 지남에 따라 사용자 요구에 맞춰 고도화되었습니다. 이제는 질문의 맥락과 의도를 파악해, 다양한 부서의 실제 업무 흐름에 맞춘 답변을 제시할 수 있게 되었습니다. 발전 과정은 크게 네 가지 축으로 이루어졌습니다. 첫째, 지식의 확장 입니다. 단일 데이터베이스 중심에서 벗어나, 사내 Wiki·Confluence·Jira 등 다양한 비정형 정보원을 통합하여 한 번의 질문으로 여러 지식 자원에서 답변을 도출할 수 있습니다. 이를 통해 구성원은 더 이상 여러 플랫폼을 이동하지 않고도 필요한 정보를 한 곳에서 즉시 확인할 수 있습니다. 둘째, 기억 기능의 도입 입니다. 과거의 대화 이력을 기반으로 질문의 맥락을 이해하고, 연속된 대화처럼 응답하는 시스템이 구축되었습니다. 사용자는 이전 대화의 내용을 기억한 상태에서 후속 질문을 이어갈 수 있으며, ‘물어보새’는 질문이 많아질수록 더 정교하게 학습된 응답을 제공합니다. 이러한 ‘기억 기반 대화 구조’는 사용자 경험을 한층 풍부하게 만들어줍니다. 셋째, 맥락 분석 강화 입니다. 단순 키워드 매칭이 아닌 의미 기반 검색(Semantic Search)을 적용하여, 사용자의 질문 의도에 따라 적합한 데이터 세트를 자동으로 선택합니다. 이로써 데이터 분석 결과가 더 구체적이고 실무에 적용 가능한 형태로 제공됩니다. 마지막으로, 자기 학습 시스템(Self-learning) 이 도입되었습니다. 구성원의 질문 패턴과 피드백 데이터를 활용해, 시스템이 스스로 정확도를 향상시키며 더 자연스러운 응답을 제공합니다. 이를 통해 ‘물어보새’는 시간이 지날수록 조직...
자세한 내용 보기