Editor’s Note

2주 전쯤 소개해 드린 크플 프로덕트 맵, 기억하시나요? 코드가 바뀌면 자동으로 업데이트되는 서비스 지도 덕분에, 달라진 화면을 사람이 일일이 피그마에 옮겨 그릴 필요가 없어졌다는 이야기를 전해 드렸죠.

그렇다면 이 지도는 어떻게 만들어졌을까요? 쓰는 사람이 편한 만큼, 만드는 과정에는 적지 않은 기술적 고민이 있었다고 하는데요. 웹·Android·iOS·React Native에 흩어진 화면과 이동 경로를 찾아내는 일부터 API 응답을 고정해 상태별 스크린샷을 찍는 일, 이름이 서로 다른 Android·iOS 화면을 짝짓는 일까지 그 과정을 담았습니다.

웹·웹뷰·네이티브가 섞인 앱을 운영하면서 서비스 지도 만들기를 고려하고 있는 팀이라면, Client Team 예지님이 직접 부딪히며 찾아낸 해결 방법을 확인해 보세요!

들어가며

안녕하세요, PFCT Client Team 프론트엔드 개발자 하예지입니다. 1편 마지막에 다음 편에서는 조금 더 깊이 있는 기술 이야기를 들려드리겠다고 말씀드렸는데요. 그 약속을 지키러 왔습니다!

기술 이야기라고 하면 지도를 어떻게 그렸는지부터 궁금하실 것 같아요. 그런데 의외로 지도를 그리는 것 자체는 그리 어렵지 않았습니다. 웹뷰 화면 몇 개를 연결한 첫 프로토타입은 금방 만들 수 있었거든요.

오히려 진짜 어려운 건 코드가 바뀌어도 지도가 실제 서비스의 모습을 정확하게 반영하도록 유지하는 일이었어요. 이번 글에서는 화면을 찾고, 찍고, 지도를 최신으로 유지하기까지 마주한 문제와 해결 과정을 이야기해 보겠습니다.

전체 구조는 어떻게 짰을까?

프로덕트 맵을 항상 실제 서비스와 같은 상태로 유지하기 위해서는 먼저 지도가 틀렸을 때 바로 알아챌 수 있어야 했습니다. 그래서 두 가지를 설계 기준으로 삼았어요.

하나는 코드가 그대로면 지도도 그대로여야 한다는 것입니다. 같은 코드로 뽑은 지도가 매번 달라진다면 화면이 정말 바뀐 건지, 추출이 잘못된 건지 구분할 수 없으니까요. 다른 하나는 놓친 것을 숨기지 않아야 한다는 것입니다. 추출기가 찾지 못한 화면이나 어디로 가는지 알 수 없는 이동은 따로 목록으로 뽑아서 지도에서 무엇이 빠졌는지 바로 보이게 했어요.

구조는 생각보다 단순합니다. 프로덕트 맵에는 따로 돌아가는 서버가 없는데요. 각 단계에서 만든 결과를 파일로 저장하고 다음 단계에 넘기는 CLI 파이프라인 구조입니다. 최종 결과물도 정적 파일로 배포하고요.

  1. 플랫폼 레포: 웹·Android·iOS·React Native 레포를 submodule로 연결해, 어느 커밋에서 뽑는지 고정합니다.
  2. 추출: 각 레포의 코드를 읽는 프로그램(추출기)이 화면과 이동 같은 정보를 뽑아냅니다.
  3. 캡처: 플랫폼별로 화면을 띄워 스크린샷을 찍습니다.
  4. 합치기·분류: 추출과 캡처 결과를 하나의 지도 데이터로 합치고, 화면을 서비스 영역(도메인)과 흐름(플로우)으로 묶습니다.
  5. 배포: 지도 데이터를 올리면 프로덕트 맵 화면이 이를 읽어 지도를 그립니다.

‘코드가 그대로면 지도도 그대로’라는 기준은 1단계에서부터 지켜집니다. submodule은 레포마다 커밋 하나를 가리키고, 그 정보는 프로덕트 맵 레포의 커밋에 함께 기록되죠. 그래서 지도 데이터마다 ‘이 지도는 이 커밋들에서 나왔다’는 기록이 남습니다. 옛 커밋으로 돌아가면 그 시점의 지도도 다시 만들 수 있고요.

그럼 화면과 이동 경로를 추출하는 과정부터 자세히 살펴볼까요?

화면은 어떻게 찾을까?

화면 찾기의 핵심은 클래스를 하나씩 세는 대신, 플랫폼마다 정해진 화면 구조를 패턴으로 읽는 것입니다.

지도를 그리려면 먼저 화면 목록이 있어야 하죠. 처음에는 클래스 하나를 화면 하나로 봤는데, 여러 단계로 이어지는 흐름에서 문제가 생겼습니다. 아래는 투자자 등록 흐름의 클래스 이름만 바꾼 예시입니다.

단계 화면들이 클래스가 아니라 함수라서, 클래스를 찾으면 바깥 화면 하나만 잡히고 안에 있는 단계는 통째로 빠집니다.

투자자 등록 흐름. 클래스 선언으로 찾으면 화면 1개만 잡히고, NavGraph로 읽으면 단계마다 화면이 하나씩 잡힙니다.

그래서 클래스 대신 코드 구조를 읽기로 했습니다. Android의 NavGraph, iOS의 Coordinator, 웹의 라우터처럼 플랫폼마다 화면을 선언하고 이동을 잇는 정해진 형태가 있거든요. 이 구조를 패턴으로 읽으면 화면 목록뿐 아니라 화면 사이의 이동 경로까지 함께 추출할 수 있습니다.

웹은 TypeScript 컴파일러로 코드의 구문 트리(AST)를 읽고, Android·iOS는 직접 만든 스캐너를 사용하는데요. Kotlin·Swift용 파서를 따로 도입하지 않은 건 찾아야 할 코드 패턴이 정해져 있어 스캐너만으로도 충분했기 때문입니다.

URL이 없는 다이얼로그도 같은 방식으로 찾습니다. 바텀시트나 모달은 컴포넌트 내부의 상태에 따라 열리고 닫히기 때문에, 주소 대신 그 상태를 바꾸는 버튼이 입구가 되는데요. 그래서 열림 상태에서 출발해 해당 상태를 변경하는 버튼까지 코드를 거슬러 올라가고, 버튼의 역할(role, 버튼·링크 등의 종류)과 접근성 이름(화면에 보이는 버튼 문구)을 알아냅니다.

예를 들어 쿠폰 선택 바텀시트라면, 아래처럼 ① 열림 상태에서 출발해 ④ 해당 상태를 바꾸는 버튼을 찾고, ⑤ 버튼의 역할과 접근성 이름을 추출합니다. 이렇게 알아낸 버튼 정보는 뒤에서 스크린샷을 찍을 때 다시 쓰여요.

화면 사이는 어떻게 이을까?

화면 잇기의 핵심은 이동 경로가 상수나 함수 안에 숨어 있어도, 코드를 따라가 실제 경로를 알아내는 것입니다.

화면을 찾았으면 이제 화살표를 그려야 하죠. 경로가 문자열로 적혀 있는 경우는 패턴 매칭으로 충분했습니다. 문제는 웹뷰 화면이었어요. 웹뷰에서는 네이티브 앱에 화면 전환을 요청하는 통로인 ‘네이티브 브리지’를 사용하는 경우가 많고, 이동 경로도 대부분 상수나 함수 안에 들어 있었거든요.

이 코드에서 bridge.open에 넘어가는 값은 toAbsoluteUrl(GUIDE_PAGE_URL)입니다. 이동하는 줄만 봐서는 경로가 보이지 않죠. 그래서 GUIDE_PAGE_URL의 선언까지 따라가 '/example/guide'를 알아내고, 경로를 URL로 바꾸기만 하는 toAbsoluteUrl은 걷어 냅니다.

그래도 놓치는 이동은 생깁니다. 이때는 앞에서 정한 두 번째 설계 기준대로, 추출할 때마다 목적지를 알 수 없는 이동과 다른 화면에 연결되지 않은 화면을 별도 목록으로 뽑아 확인하고 수정합니다.

코드 구조를 읽다 보니 화면과 이동 외에도 얻을 수 있는 정보가 많았습니다. 트래킹 이벤트, API 호출과 응답 형태, 화면 문구, 버튼의 접근성 이름까지 다양한 정보를 추출할 수 있었는데요. 이렇게 추출한 정보는 뒤에서 설명할 스크린샷 촬영, 같은 화면 묶기, 화면 배치에 모두 다시 쓰입니다.

화면은 어떻게 찍을까?

화면과 이동 경로를 찾았으니 이제 화면마다 스크린샷이 필요하죠. 먼저 E2E 테스트를 검토했습니다. 그런데 E2E로 모든 화면 상태를 찍으려면 상태마다 시나리오와 테스트 계정을 따로 만들어야 했어요. 스테이징 서버의 데이터가 바뀌면 같은 화면도 찍을 때마다 다르게 나왔고요. ‘코드가 그대로면 지도도 그대로’라는 기준과는 맞지 않는 방식이었습니다.

Storybook은 화면마다 스토리를 따로 작성해야 하는 데다 웹 화면만 담을 수 있다는 한계가 있었어요. 저희는 웹과 네이티브 화면을 하나의 지도에서 함께 보고 싶었거든요.

그래서 화면 이동 경로를 따라가며 찍는 대신, 화면을 하나씩 띄워 상태별로 찍기로 했습니다. 도구는 각 플랫폼에서 이미 쓰고 있던 Roborazzi(Android), swift-snapshot-testing(iOS), Playwright(웹·웹뷰)를 그대로 활용했어요. React Native 화면은 iOS 시뮬레이터 테스트로 찍습니다.

찍을 화면 목록도 따로 관리하지 않아요. 앱 레포의 스크린샷 테스트와 웹 라우트를 읽어 그때그때 계산하거든요. 덕분에 개발자가 스크린샷 테스트를 하나 커밋하면 다음 추출 때 해당 화면이 지도에 반영됩니다.

데이터는 어떻게 고정할까?

데이터 고정의 핵심은 화면 상태마다 API 응답을 파일로 저장하고, 네트워크 계층에서 해당 응답을 돌려주는 것입니다.

화면을 하나씩 띄워도 E2E에서 부딪혔던 문제는 그대로 남습니다. 화면은 뜨자마자 API를 호출하고, 응답이 바뀌면 스크린샷도 달라지니까요. 그래서 화면 상태마다 API 응답을 미리 저장한 JSON 파일, 즉 fixture를 하나씩 만들었습니다. 파일에는 엔드포인트별 응답을 그대로 담았어요.

success.json, empty.json, error.json처럼 상태마다 파일이 하나씩 있습니다. 파일 하나가 곧 해당 상태의 스크린샷으로 이어지는 거죠.

장바구니 화면의 정상·빈 화면·에러·로딩 스크린샷.

각 플랫폼에서는 네트워크 계층에서 실제 API 응답 대신 fixture에 담긴 데이터를 돌려줍니다. Android는 HTTP 클라이언트의 인터셉터, iOS는 URLProtocol 스텁, 웹은 MSW(Mock Service Worker), React Native는 axios 어댑터가 그 역할을 맡아요. 덕분에 앱은 평소처럼 응답을 받아 정상·빈 화면·에러 상태를 스스로 그리지만, 실제 서버나 데이터에는 접근하지 않습니다.

응답을 고정하니 코드가 같으면 언제 찍어도 같은 데이터로 화면이 그려집니다. ‘코드가 그대로면 지도도 그대로’라는 기준이 스크린샷에도 적용되는 거죠. 덕분에 과거 지도와 현재 지도를 나란히 비교할 수 있고, 변경된 화면만 다시 찍을 수도 있어요. 입력이 이전과 같다면 새로 촬영하지 않고 기존 이미지를 재사용합니다. 이 경우 iOS는 18.5분, Android는 7.5분 걸리던 스크린샷 촬영이 1분 이내로 끝나요.

남은 건 양이었습니다. 수백 개 화면에 필요한 API 응답을 사람이 일일이 작성할 수는 없으니, fixture도 코드에서 자동으로 생성합니다. 서버의 API 정의, 웹의 API 타입, 네이티브 앱의 응답 모델을 함께 스캔해 응답 형태를 알아내는 방식이에요.

다만 생성기는 데이터 타입은 알아도 실제 값까지 알지는 못합니다. 문자열에는 ‘문자열’, 숫자에는 0 같은 임시값을 넣어요. 이미지나 링크는 예외입니다. 임시값이 들어가면 화면이 깨지거나 엉뚱한 곳으로 이동할 수 있어 ‘없음’으로 둡니다. 화면에 표시되는 한글 문구는 AI가 서버와 클라이언트 코드를 참고해 채우고, 사람이 지도에서 확인합니다.

API 응답만으로 화면을 그릴 수 없는 경우도 있습니다. 예를 들어 대출 가심사에서 소득 유형을 선택해야 나타나는 직업 입력 화면은 앞 단계에서 선택한 값이 필요하죠. 이런 경우에는 fixture 옆에 시드 파일을 따로 둡니다. 앞 단계에서 저장됐을 값을 화면이 그려지기 전에 미리 넣어 두는 거예요.

언제 찍을까?

찍는 시점의 핵심은 정해진 시간 대신, 화면이 다 그려졌다는 신호를 보고 찍는 것입니다.

데이터를 고정해도 언제 찍느냐는 문제가 남습니다. fixture가 API 응답을 바로 돌려주더라도, 화면은 요청을 보내고, 응답을 받아 그 값으로 다시 그리는 과정을 거쳐야 완성되거든요. 한 화면에서 여러 API를 호출하면 이 과정도 여러 번 반복됩니다. 그동안 화면에는 데이터가 오기 전 회색 틀만 보이는 스켈레톤이 떠 있죠.

처음에는 정해진 시간만큼 기다렸다가 찍었습니다. 그런데 시간을 짧게 잡으면 스켈레톤이 찍혔고, 길게 잡으면 천 장이 넘는 스크린샷을 찍는 데 불필요한 시간이 들었어요. 그래서 지금은 화면 상태에 따라 촬영 기준을 달리합니다.

  • 정상 화면: 데이터 요청이 모두 끝난 상태가 400ms 동안 유지되면 앱이 ‘다 그렸다’는 표시(준비 신호)를 켭니다. 이 신호를 확인한 뒤 찍습니다.
  • 조회가 이어지는 화면: 앞선 응답을 받아야 시작되는 조회가 있으면 준비 신호가 켜진 뒤에도 조금 더 기다립니다. 어떤 화면이 해당하는지는 사람이 따로 지정하지 않고 지난 실행 기록을 바탕으로 판단해요.
  • 로딩 화면: 데이터 요청을 붙잡아 둔 채 찍습니다. 반복되는 스켈레톤 애니메이션은 첫 프레임에서 멈춰 매번 같은 그림이 나오도록 해요.

다 찍은 뒤에도 한 번 더 확인합니다. 아무것도 그려지지 않은 백지 스크린샷은 성공으로 세지 않습니다.

화면 속 버튼은 어떻게 찾을까?

버튼 찾기의 핵심은 코드에서 알아낸 접근성 이름으로 실제 화면의 버튼을 찾아내는 것입니다.

앞에서 다이얼로그를 찾을 때 알아낸 버튼 정보가 여기서 쓰입니다. 웹의 바텀시트와 모달은 주소만으로는 열 수 없어요. 그래서 추출기가 코드에서 알아낸 버튼의 역할과 접근성 이름(예: button '쿠폰 선택')을 Playwright에 넘깁니다. 그러면 Playwright가 화면에서 해당 버튼을 찾아 사용자처럼 누르는 거죠. 접근성 이름은 사용자가 보는 문구를 기반으로 하기 때문에, 마크업이 바뀌어도 이름이 유지된다면 같은 버튼을 찾을 수 있어요.

같은 방법으로 스크린샷 위에 이벤트 위치도 표시합니다. 코드에서 클릭 이벤트를 보내는 버튼의 접근성 이름을 알아낸 뒤, 스크린샷을 찍을 때 해당 버튼의 위치를 함께 기록하는 거예요. 지금은 웹 스크린샷 700여 장에 이벤트 위치가 표시돼 있습니다.

투자 장바구니 화면. 클릭·노출 이벤트가 나가는 버튼마다 자리가 표시됩니다.

같은 화면은 어떻게 묶을까?

화면 묶기의 핵심은 클래스 이름이 아니라, 두 앱의 코드에 공통으로 남아 있는 단서로 같은 화면을 찾아내는 것입니다.

스크린샷까지 찍고 나면 같은 화면이 Android에 하나, iOS에 하나씩 생깁니다. 지도에서는 둘을 하나의 화면으로 보여줘야 해요. 그런데 두 앱은 같은 화면에도 서로 다른 이름을 붙입니다. 출금 완료 화면만 해도 Android는 ‘…Done’, iOS는 ‘…Complete’로 끝나죠.

처음에는 두 앱의 화면 쌍을 목록으로 직접 적었습니다. 하지만 화면이 늘어날 때마다 목록도 수정해야 하는 문제가 있었어요. 그래서 지금은 코드에서 같은 화면임을 알려주는 단서를 찾습니다. 아래 다섯 가지 기준을 순서대로 확인하죠.

  1. 진입 이벤트: 화면에 들어올 때 보내는 트래킹 이벤트 이름이 같은가
  2. fixture 키: 같은 테스트 데이터 키를 사용하는가
  3. 화면 문구: 두 화면에 공통으로 등장하는 고유한 문구가 있는가
  4. 웹 화면: 같은 웹 화면을 띄우는가
  5. API: 해당 화면에서만 호출하는 API가 같은가

이렇게 바꾼 뒤로 사람이 직접 관리하는 화면 쌍은 하나도 남지 않았어요.

가령, 출금 완료 화면에는 진입 이벤트도 fixture도 없었습니다. 대신 두 앱 모두 ‘출금을 완료했어요’라는 문장을 사용하고 있었죠. 덕분에 화면 문구를 단서로 같은 화면임을 알아낼 수 있었습니다.

물론 ‘확인’이나 ‘다음’처럼 흔한 문구는 걸러야 합니다. 그래서 앱 전체에서 두 화면 이하에만 등장하는 네 글자 이상 문구만 사용해요. 이 기준을 적용해도 후보가 둘 이상 남으면 억지로 짝짓지 않습니다.

Android와 iOS의 출금 완료 화면. 강조한 문구가 두 화면을 연결하는 단서가 됐습니다.

화면은 어떤 순서로 놓을까?

화면 배치의 핵심은 링크 수 대신, 사용자가 실제로 많이 지나간 화면부터 놓는 것입니다.

코드에서 뽑을 건 다 뽑았고 스크린샷도 찍었으니, 이제 화면들을 지도 위에 배치할 차례예요. 처음에는 연결된 링크가 많은 화면부터 놓아 봤습니다. 그랬더니 실제 사용자 흐름과 어긋나는 순서가 나왔어요. 로그인 화면 바로 다음에 홈 화면 대신 회원가입 화면이 놓이는 식이었죠. 회원가입은 단계가 많아 연결된 링크도 많지만, 실제 사용자는 대부분 이미 가입한 사람이라 로그인한 뒤 홈으로 이동하거든요.

그래서 사용자 행동 분석 도구인 Amplitude를 활용하기로 했습니다. 저희는 화면마다 사용자의 진입을 기록하는 트래킹 이벤트를 심어 두었는데요. 이 이벤트가 얼마나 발생했는지 확인하면 사용자가 각 화면을 실제로 얼마나 많이 거쳤는지 알 수 있습니다.

게다가 추출기가 코드에서 뽑아 둔 이벤트 이름이 Amplitude에 기록된 이름과 그대로 일치해서, 둘을 연결하는 매핑을 따로 만들 필요도 없었어요. 지금은 이 이벤트 발생량을 기준으로 화면을 배치합니다.

코드가 바뀌어도 지도를 최신 상태로 유지하려면?

지도를 최신 상태로 유지하는 핵심은 예외를 하드코딩하는 대신 원본 코드에서 읽어 오고, 원본과 어긋나면 추출을 멈추는 것입니다.

1편에서 프로덕트 맵의 가장 중요한 기능으로 ‘코드에 따라 바뀌는 지도’를 소개했습니다. 개발자가 화면을 만들거나 이동 경로를 바꾸면 다음 추출 때 지도가 자동으로 갱신되고, 프로덕트 맵 코드는 따로 수정할 필요가 없다는 것이었죠.

하지만 실제로 추출기를 만들다 보니 규칙으로 잡히지 않는 경우가 계속 나왔습니다. 처음에는 그때마다 예외를 하드코딩했어요. 규칙을 고치는 것보다 훨씬 빨랐거든요. ‘이 앱도 스크린샷 대상에 넣는다’, ‘이 화면은 이 도메인이다’처럼 원본 코드에서 읽어 오지 않고 프로덕트 맵에 직접 적어 둔 목록이나 매핑이 쌓이기 시작했습니다.

문제는 이렇게 적어 둔 예외가 원본 코드의 변화를 따라가지 않는다는 것이었습니다. 클라이언트 코드가 바뀔 때마다 누군가 프로덕트 맵의 예외도 함께 수정해야 했어요. 하나라도 놓치면 에러 없이 잘못된 지도가 만들어졌고요. 프로덕트 맵 코드는 손대지 않아도 된다는 1편의 약속과 정반대로 가고 있었던 거죠.

그래서 예외를 다시 규칙으로

예외를 계속 추가하는 대신, 최대한 줄이기로 했습니다. 레포 규칙 문서에도 이런 문장을 적어 두었어요.

사람이 관리하는 값은 관리되지 않는 값이다.

이후 규칙으로 잡히지 않는 경우를 만나면, 예외를 추가하기 전에 세 가지를 먼저 확인합니다.

  1. 원본 코드에서 읽어 올 수 있는가? 가능하다면 예외를 추가하지 않고 추출 규칙을 고칩니다.
  2. 정말 읽어 올 수 없는가? 그렇다면 예외를 직접 적되, 그 이유를 바로 옆에 남깁니다.
  3. 원본과 어긋났을 때 알아챌 수 있는가? 남겨 둔 예외가 원본과 달라지면 에러가 발생하도록 합니다.

이 기준으로 2026년 11월에 레포 전체를 점검해 하드코딩된 예외 18건을 고쳤습니다.

다만 브리지 타입 이름이나 온투플러스(네이티브로 만든 이전 버전의 커뮤니티)가 커뮤니티 탭에 속한다는 정보처럼 코드만으로 알 수 없는 값은 직접 적되, 그 이유를 코드 옆에 남겼습니다.

그럼 실제로 어떤 문제가 있었고, 어떻게 해결했는지 세 가지 사례를 보여드릴게요.

스크린샷 0장이 된 대출 화면 39개

웹 레포에는 웹 앱이 6개 있습니다. 처음에는 지도에 포함할 앱 목록을 추출기와 스크린샷 촬영 스크립트가 각각 관리했어요. 그러다 대출 앱을 추가하면서 추출기 목록에만 반영하고 스크린샷 목록에서는 빠뜨렸습니다.

그 결과 추출기는 대출 화면 39개를 지도에 올렸지만, 스크린샷은 한 장도 찍히지 않았어요. 에러는 발생하지 않았고, 지도에는 스크린샷이 없는 화면 39개만 남았습니다.

지금은 웹 앱 목록을 하나의 명부로 관리하고, 추출기와 스크린샷 스크립트 모두 이 명부를 읽도록 바꿨습니다. 추출할 때마다 명부를 클라이언트 레포에 실제로 존재하는 앱과 대조하고, 둘이 어긋나면 추출을 멈춥니다.

이미 사라진 메서드를 찾던 브리지 목록

웹뷰 브리지 메서드도 처음에는 11개를 직접 적어 두었습니다. 그런데 확인해 보니 그중 replace는 클라이언트 코드에서 이미 사라진 메서드였어요. 반대로 새로운 메서드가 추가되더라도 목록에 반영하지 않으면, 해당 메서드로 발생하는 화면 이동이 지도에서 누락되는 문제가 있었습니다.

지금은 클라이언트 코드의 브리지 타입을 읽어 메서드 목록을 자동으로 만듭니다. 해당 타입을 찾지 못하면 추출을 멈추고요.

12개 도메인으로 흩어진 대출 화면 191개

화면을 도메인으로 묶을 때도 처음에는 이벤트 이름의 두 번째 토큰이나 폴더 이름으로 도메인을 짐작했습니다. 그랬더니 도메인이 제품 구조가 아니라 작명 습관을 따라가더라고요. 대출 화면 191개가 12개 도메인으로 흩어졌고, 그중 85개는 투자 도메인에 들어가 있었습니다.

지금은 앱의 하단 탭과, 각 플랫폼이 제품 영역을 나누려고 정해 둔 폴더 구조를 기준으로 도메인을 나눕니다.

마치며

지금 프로덕트 맵은 하루에도 여러 번 네 플랫폼의 코드를 읽어 지도를 다시 그립니다. 개발자는 평소처럼 코드를 머지하고, 지도는 그 변화를 따라가죠.

물론 아직 해결할 과제도 남아 있습니다. 대표적인 것이 fixture에 들어가는 값이에요. 현재는 코드에서 API 응답의 형태를 자동으로 만들지만, 화면에 표시되는 값은 여전히 사람이 확인해야 합니다. 앞으로는 이 과정까지 자동화해, 새로운 화면도 코드만 머지하면 지도에 올라오도록 만들 계획입니다.

혹시 ‘우리 서비스에 화면이 몇 개나 있지?’라는 질문에 선뜻 답하지 못했던 팀이라면, 화면 목록을 코드에서 뽑아 보는 것부터 시작해 보세요. 시작은 생각보다 쉽습니다. 다만 그 지도를 계속 정확하게 유지하는 데 진짜 시간이 든다는 점은 미리 알고 시작하시면 좋겠어요.

1편에서 플랫폼 코드에 담긴 지식을 꺼내 회사 전체가 활용할 수 있도록 하는 일, 프로덕트 맵이 제게 그 첫 시도였다고 말씀드렸는데요. 직접 만들어 보니 이 일은 결국 경계를 엮는 일이었습니다. 웹과 Android·iOS·React Native 코드, 서버의 API 정의, Amplitude 데이터까지. 서로 다른 곳에 있던 정보를 한 장의 지도로 연결한 거죠. 그게 가능했던 건 각 팀이 코드를 일관되게 작성해 둔 덕분이었습니다.

함께해 준 클라이언트 팀원들, 그리고 AX 스쿼드의 범준님과 영수님께 특히 감사드립니다.

written by Yeji
edited by Hoonjung


아이디어를 생각하는 데서 그치고 싶지 않다면