카카오페이 iOS Module Architecture Refactoring: Monorepo 도입기

Design system을 수정하면 이를 사용하는 결제 module version을 올리고 다시 application dependency를 갱신해야 해 작은 change에도 여러 repository commit·release가 필요했다. Module별 version이 어긋나면 build가 깨지고 어떤 조합이 호환되는지 찾기 어려웠으며 developer가 repo를 계속 이동했다.

실제 logic 변경은 한 곳인데 transitive dependency chain 때문에 여러 PR과 review·CI가 연쇄적으로 발생했다. 관련 module을 하나의 commit으로 수정·test할 수 있게 하면 중간의 깨진 version이 사라진다. Migration은 history와 ownership을 보존하고 build 범위가 불필요하게 커지지 않는 조건으로 진행한다.

각 module을 Swift Package Manager target으로 정의하고 사용 목적별 target 묶음을 product로 노출한다. Service app은 필요한 product만 dependency로 선택해 쓰지 않는 module을 제외하며, 공통 test·tooling을 root에서 적용한다. 한 repository 안에서도 module encapsulation과 build isolation을 유지한다.

여러 repo에 흩어졌던 sample app을 하나의 workspace에서 실행하고 module change를 즉시 검증한다. 관리 repo는 24개에서 1개로 줄고 연쇄 PR이 atomic PR 하나가 됐으며, 주 3~4회 발생하던 version 정합성 오류도 제거됐다. Monorepo를 조직 협업과 tooling 표준화의 기반으로 활용한다.