갈라진 배차·작업지시·순찰 제품 사본을 하나로 되돌리기

한 배차 제품이 몇 년에 걸쳐 서로 어긋나는 여러 사본으로 갈라져 있었습니다. 개발을 멈추지 않고 컴포넌트마다 기준이 되는 코드를 하나로 되돌렸고, 다시 갈라지지 않도록 변경 절차를 마련했습니다.

핵심 요약: 한 배차 제품이 서로 어긋나는 여러 사본으로 갈라져, 한 사본을 고치고 다른 사본을 출시하는 일이 반복되었습니다. 개발을 멈추지 않고 컴포넌트마다 기준이 되는 코드를 하나로 되돌렸고, 다시 갈라지지 않도록 변경 절차를 마련했습니다.

개요

제품은 웹 배차 콘솔, Android 앱, 작업지시 백엔드, 순찰 백엔드로 구성됩니다. 통합은 2026-08-04에 끝났으며, 그동안 일상적인 개발은 멈추지 않았습니다.

문제, 제공한 것, 결과의 세 열: 서로 어긋난 여러 사본, 컴포넌트당 하나의 기준 코드와 변경 절차, 이후 모든 변경 추적 가능.

문제

시간이 지나면서 컴포넌트마다 사본이 여러 개 생겼습니다. 변경은 사본 사이에서 손으로 옮겨졌고, 빌드가 잘못된 소스를 쓰기도 했으며, 같은 종류의 결함이 계속 다시 나타났습니다. 백업은 프로젝트 폴더를 통째로 복사한 것이었고, 어느 사본이 진짜인지 아무도 말할 수 없었습니다. 제3자가 보낸 소스 압축 파일이 그대로 풀려 별도의 개발 라인이 되어 있었습니다.

제공한 것

  • 컴포넌트마다 하나의 기준 코드. 삭제한 사본의 이력은 보관해 필요하면 되찾을 수 있습니다.
  • 외부 코드와 기준 코드를 파일 단위로 비교해 실제 변경만 반영하고, 서식 차이는 통일했습니다.
  • 변경 절차: 먼저 영향 범위를 평가하고, 결함 수정은 재현 테스트부터 시작하며, 인수 확인을 통과한 뒤에만 커밋합니다. 기존 문제는 등록되어 줄어들기만 할 수 있습니다.
  • 암호화되었거나 손상된 파일이 코드에 섞이지 않도록 커밋 전에 자동으로 검사합니다.

결과

이제 각 컴포넌트에는 기준이 되는 버전이 하나뿐이고, 빌드가 잘못된 소스를 쓰는 일은 없어졌습니다. 이후의 모든 변경에는 서면 영향 범위 기록이 남아, 문제가 생기면 원인이 된 변경까지 추적할 수 있습니다.

한계

통합 전후의 결함률은 측정하지 않았으며 이에 대해 주장하지 않습니다. 고객 신원, 제품 브랜드, 배포 세부 사항은 공개하지 않습니다.

자주 묻는 질문

왜 하나의 큰 저장소로 합치지 않았나요?

각 컴포넌트에는 이미 고유한 이력과 릴리스 주기가 있었습니다. 컴포넌트마다 저장소를 하나씩 두어 이력을 온전히 보존했고, 진행 중인 작업에 주는 영향도 가장 적었습니다.

기존 코드의 문제를 한 번에 정리했나요?

단계적으로 진행합니다. 기존 문제는 목록에 등록하고 각 항목은 줄어드는 방향으로만 바뀔 수 있으며, 새 코드는 기준을 지켜야 합니다. 납품은 계속되었고 문제 총량은 줄어들기만 합니다.

두 번째 사본이 다시 생기지 않게 하려면?

외부에서 받은 코드는 기준 코드와 비교해 실제 변경만 반영합니다. 특정 시점을 남길 때는 태그를 달고, 디렉터리를 통째로 복사하지 않습니다.