쏘카 백오피스 팀 내 공통 코드(Common Code) 관리 변천사

쏘카 백오피스 팀은 공통 코드 관리에 대한 다양한 시도와 개선 과정을 공유합니다. 공통 코드는 상태 표현이나 분류 등 여러 계층에서 사용되므로 변경 시 파급력이 커서 체계적인 관리가 중요합니다.

초기에는 DB에 부모-자식 테이블 구조로 코드를 저장하고, 서버에서는 ENUM으로, 프론트엔드에서는 API로 조회하는 방식을 사용했습니다. 하지만 이 방식은 코드와 DB 간의 동기화 문제, DB 의존성 증가 등의 단점이 있었습니다.

이를 해결하기 위해 Gradle Plugin과 Kotlin PSI를 활용하여 컴파일 시점에 코드를 자동으로 생성하고 검증하는 방식으로 발전시켰습니다. 이 글은 공통 코드 관리에 대한 정답은 없지만, 팀의 시행착오를 통해 얻은 경험을 공유하여 유사한 고민을 가진 개발자들에게 참고 자료를 제공하는 것을 목표로 합니다.