VIEW
← 전시장으로
Architecture · 피에프씨테크놀로지스

날면서 비행기갈아타기

레거시 → 모노레포 마이그레이션

웹 화면 대부분이 모여 있던 레거시 레포를 모노레포로 옮기는 일의 첫 주자였어요. 투자 도메인에서 시작한 방식이 대출·회원까지 이어지며, 이관이 한 번의 프로젝트가 아니라 반복 가능한 절차가 됐습니다.

역할
레거시 이관 첫 주자, 투자 도메인 이관 주도
범위
투자 → 회원 · 웹뷰 · 대출 → 도메인 루트
스택
TanStack Start · TanStack Router · Orval · knip
전환
경로 단위 단계적 전환
0개 도메인
투자 · 회원 · 대출
0개 화면
이관한 화면
0+
이관 뒤 미사용 파일 제거
15분 → 3분
투자 배포 (전체 빌드 → 앱 단독)
Before

레거시 레포 하나

  • 홈
  • 회원
  • 투자
  • 앱 안 화면
  • 공지 · 공시
  • 대출

빌드 한 번에 약 15분, 작은 수정도 전체 배포

After
주소별로 도메인 앱에 나눠 보냄
  • 홈 · 회원공지 · 공시 포함
  • 투자투자 · 투자자 등록
  • 대출가심사 · 계약 · 마이페이지
  • 웹뷰앱 안에서 여는 화면
레거시에는 아직 옮기지 않은 일부 화면만 남음
주요 도메인만 단순하게 그렸어요. 앱마다 따로 빌드·배포돼요(투자는 약 3분).

01Problem

부채가 줄지 않고 늘어나는 구조

웹 화면 대부분이 한 레거시 레포에 혼재해, 작은 수정에도 전체 빌드에 약 15분이 걸렸어요.

더 큰 문제는 신규 기능이 계속 레거시 위에 쌓인다는 점이었어요. 옮기는 속도보다 쌓이는 속도가 빠르면, 이관은 끝나지 않습니다.

02Decision

왜 가장 바쁜 도메인부터 옮겼나

보통은 조용한 도메인부터 옮겨요. 위험이 적으니까요. 하지만 그동안 바쁜 도메인에는 레거시 위로 신규 코드가 계속 쌓이고, 이관할 대상은 늘어납니다.

그래서 신규 개발이 가장 활발한 투자 도메인을 먼저 옮겼어요. 신규 개발이 몰리는 곳을 먼저 옮기면 부채 증가를 가장 먼저 멈출 수 있고, 이관 비용을 신규 개발 안에 흡수할 수 있습니다.

  • TanStack Start상품별 동적 SEO 때문에 SSR이 필요했고, 모노레포 내 다른 앱들의 라우팅(TanStack Router)과의 일관성을 우선했어요. Next.js보다 성숙도가 낮은 점은 감수.
  • 위험 통제병행 운영, 재배포 없는 전환, 환경별 단계 적용, 사전 롤백 계획.

03Cutover

언제든 되돌릴 수 있게

1
정리
AWS 접근 기록을 조회하고 Amplitude 데이터와 대조해, 쓰이지 않는 페이지를 먼저 정리했어요 (약 640개 파일, 로컬 빌드 58% 단축).
2
병행 운영
임시 주소를 새 앱으로 보내도록 경로 설정만 바꿔서, 앱 코드 수정 없이 옛 화면과 새 화면을 약 한 달 나란히 띄웠어요. QA도 두 화면을 비교하며 검증했어요.
3
경로 전환
재배포 없이 경로만 바꿨어요. 투자 상품이 열리는 시각은 피했고, 운영 전환 중 문제를 발견하자 경로만 되돌려 복구한 뒤 원인을 해결하고 재전환.
4
확장 · 정리
같은 방식으로 회원·대출까지. 옛 주소는 서버에서 308·307로 새 주소에 넘기고, 이관한 화면은 레거시에서 삭제.
  1. 이관 계획PRD · 단계 · 롤백 계획
  2. 병행 운영임시 주소로 새 앱을 한 달 함께
  3. 개발망 전환확인할 게 생겨 경로만 되돌림
  4. 운영 전환문제를 발견해 경로만 되돌림
  5. 재전환 완료원인을 고친 뒤 다시 전환
  6. 옛 코드 삭제레거시 투자 화면 제거
되돌리기는 앱 재배포 없이 경로 설정만 바꾸면 되게 설계해서, 두 번 모두 빠르게 복구했어요.

04What I built

  • 투자 도메인 이관라우팅을 TanStack Router로 재구성하고 SSR이 필요한 페이지는 TanStack Start로. 투자 확정(결제) 플로우는 웹뷰 전용으로 따로 구현. 손으로 쓴 API 호출을 Orval 생성 함수로 교체.
  • 대출 · 회원 확장홈·설정·개인/법인 회원가입·AML 재이행·채권 투표·가심사·대출 마이페이지까지. 홈·공지·FAQ는 SSR로 바꿔 SEO 확보.
  • 도메인 루트 전환마지막으로 사이트 첫 화면(/)까지 새 앱으로 넘겼어요. 레거시가 가지고 있던 옛 주소를 서버 리다이렉트로 옮기고, 검색 노출(robots·sitemap·canonical)을 새 앱 기준으로 다시 맞췄어요.
  • 레거시 정리이관 뒤 미사용 코드 분석 도구(knip)로 약 1,500개 파일 제거. 루트 전환 직후 한 번에 지운 것만 페이지 89개, 파일 510개, 38,853줄이에요. 테스트에서만 쓰이던 파일까지 찾도록 설정을 바꿔 한 번 더 훑었어요.
  • AI 기반 플래닝기존 코드의 의존성·API 호출부를 Claude로 분석해 이관 대상·순서 문서를 만들고, 그 문서로 작업 실행을 위임하는 개인 워크플로우.

05Result

  • 투자 신규 기능이 더 이상 레거시에 쌓이지 않게 됐어요. 전환 뒤 신규 서비스 '세컨드 마켓'도 새 앱에서 런칭했고, 레거시 투자 영역 추가 개발은 0건이었어요.
  • 첫 이관의 방식으로 회원·대출까지 이어 가 도메인 루트까지 넘겼고, 이관이 반복 가능한 절차가 됐어요.
  • 투자 배포가 레거시 전체 빌드와 분리되어 앱 단독으로 배포돼요(약 15분 → 약 3분).
시작2개월4개월6개월8개월
투자
리스트 · 상세 · 투자 확정 · 투자자 등록
회원 · 홈
로그인 · 회원가입 · 홈(SSR) · 공시
웹뷰
AML 재이행 · 채권 투표 · 약관 · 공시
대출
개인신용 · 주담대 가심사 · 본심사 계약
루트 전환 · 정리
도메인 루트를 새 앱으로 · 옛 화면 삭제
약 8개월, 본인이 이관한 작업 기준. 투자에서 만든 방식(병행 운영 → 경로 전환 → 옛 코드 삭제)을 도메인마다 되풀이했어요. 합계 217개 화면.

06Learning

마이그레이션은 한 번에 끝내는 작업이 아니라 신규 개발의 흐름을 바꾸는 작업이다. 그리고 전환은 트래픽이 한 번에 넘어가는 일이라, 새 구조의 용량과 환경별 빌드까지 전환 전에 점검해야 한다.