팀 레거시 개선 (3) 쏘카존 관리 시스템 - 6년간 진행된 팀 레거시 코드 및 문서 개선기
스토리 · 쏘카 테크 · 2026.02.14
쏘카 자산개발팀의 원스톤 개발자님이 공유해주신 이 글은, 비즈니스를 중단하지 않으면서 6년 동안 점진적으로 진행해 온 레거시 코드와 문서 개선 과정을 담고 있습니다. 주요 내용으로는 테이블 구조의 노후화 문제를 해결하기 위해 ERD를 비즈니스 로직에 맞게 재설계하고, 테스트 코드를 작성할 수 있는 구조를 만든 경험을 다룹니다. 또한, 데이터 정합성을 유지하며 안전하게 스키마를 변경하는 방법(Code first, Schema later)과 Postman 및 Confluence를 활용해 지식의 속인화를 방지하고 팀 전체의 장애 대응 역량을 높인 문서화 전략을 소개합니다. 레거시는 한 번에 고치는 것이 아니라, 매일 조금씩 더 나은 구조로 만들어가는 과정임을 강조하고 있습니다.