토스인컴 QA Platform: ‘누구나 테스트할 수 있는’ 도구의 시작
Summary
"Swagger는 있는데 테스트는 왜 어려울까?" 토스가 QA 병목을 해결한 방법
복잡한 JSON 대신 버튼 하나로! QA팀이 직접 만든 '누구나 테스트 가능한' 내부 플랫폼 제작기
토스인컴 QA팀이 반복되는 테스트 데이터 생성 문의를 해결하기 위해 직접 개발한 내부 테스트 플랫폼 구축 과정을 소개합니다. 기존의 Swagger API를 사용자 친화적인 UI로 래핑하고, 자동화 스크립트와 테스트 관리 시스템까지 통합하여 전사 구성원이 테스트를 일상적인 행동으로 느끼게 만든 변화를 다룹니다.
- 01QA팀이 설계부터 개발까지 100% 직접 진행한 사내 전용 플랫폼
- 02숙련도에 따라 UI 폼 기반의 'Normal 모드'와 JSON 입력 기반의 'Swagger 모드' 선택 가능
- 03드래그 앤 드롭 정렬, 최근 사용 데이터 자동 저장 등 실무 중심의 UX 최적화
- 04분산되어 있던 자동화 스크립트를 플랫폼 내부 버튼으로 통합하여 실행 편의성 증대
- 05테스트 케이스 정의부터 이력 관리, 커버리지 파악까지 아우르는 통합 관리 시스템으로 확장
RECOMMENDATION
반복되는 테스트 데이터 생성 요청으로 업무 흐름이 끊기는 QA 엔지니어나, 사내 도구의 사용자 경험을 개선하여 개발 생산성을 높이고 싶은 플랫폼 팀에게 적극 추천합니다.
The Problem
Swagger에 테스트에 필요한 API들이 정리되어 있었으나, API 호출 순서에 대한 지식과 복잡한 JSON 파라미터 구성 방식 때문에 QA 외의 구성원들이 테스트 데이터를 생성하거나 상태를 확인하는 데 높은 진입 장벽을 느끼고 QA 팀에 반복적인 문의를 하는 상황이었습니다.
The Solution
기존 Swagger API를 재활용하여 UI 기반의 입력 폼(Normal 모드)과 JSON 직접 입력(Swagger 모드)을 제공하는 전용 플랫폼을 구축하고, 여러 단계의 API 호출이 필요한 복잡한 시나리오를 버튼 하나로 실행할 수 있도록 단순화했습니다.
The Result
테스트 실행에 대한 심리적, 기술적 장벽이 낮아져 구성원들이 일상적으로 테스트를 수행하게 되었으며, 반복적인 가이드 업무가 줄어듦과 동시에 팀 전체의 검증 대기 시간이 단축되어 제품 개발 속도가 향상되었습니다.
Trade-off
본문에 구체적인 한계점은 명시되지 않았으나, 외부 도구 대신 자체 플랫폼을 100% 직접 개발하고 유지보수하는 데 QA 팀의 추가적인 엔지니어링 리소스가 투입되었으며, 향후 API 스펙 변경 시 플랫폼과 Swagger 간의 동기화를 지속적으로 관리해야 하는 운영 부담이 예상됩니다.
Key Concepts
More from 토스
View all posts from 토스
누군가는 토스를 테스트하는 동안, 우리는 테스트하는 법을 만듭니다.
QA EngineeringTest AutomationAI in Testing2주 전
es-toolkit: How a Small Internal Library Became a Global Project
JavaScriptTypeScriptTree-shaking2주 전6. 도구를 넘어, 기준과 책임으로
Technical WritingAI AutomationKnowledge Governance2주 전5. Technical Writer, 사라질 결심
LLMGitHub ActionsGenerative AI2주 전es-toolkit, 사내 작은 라이브러리가 전세계적인 라이브러리가 되기까지
JavaScriptTypeScriptTree-shaking3주 전
