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

서비스 지도그리기

크플 프로덕트 맵

웹·Android·iOS·React Native 코드에서 화면과 화면 흐름을 읽어 하나의 지도로 자동 생성합니다. 사람이 손으로 관리하던 화면 목록과 플로우 문서를, 코드가 바뀌면 같이 바뀌는 데이터로 바꿨어요.

역할
제안 · 기획 · 설계 · 구현 (커밋 94%)
기간
약 5개월
스택
Playwright · 스냅샷 테스트 · Amplitude · Sigma.js
글
기술 블로그 #1 ↗ · #2 ↗
0+
화면·다이얼로그
0+
화면 간 연결
0+
자동 촬영 스크린샷
0%
본인 커밋 비중
줌 아웃하면 서비스 전체가, 줌 인하면 화면 하나하나와 그 사이의 이동이 보여요.
줌 아웃하면 서비스 전체가, 줌 인하면 화면 하나하나와 그 사이의 이동이 보여요. 출처: 피에프씨 기술 블로그 ↗

01Problem

아무도 서비스 전체를 한 번에 볼 수 없었어요

크플의 화면은 웹, Android, iOS, React Native에 흩어져 있었어요. 한 사용자가 투자를 끝내기까지 어느 플랫폼의 어느 화면을 지나는지 알려면 레포를 하나씩 열어봐야 했죠.

손으로 만든 화면 목록과 플로우 문서도 있었지만, 코드가 바뀌는 순간 낡았어요. 기획·QA·개발 누구도 그 문서를 믿고 쓰지 못했습니다.

02Decision

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

  • 파생하는 구조화면 목록·연결·스크린샷을 손으로 적지 않고, 각 플랫폼의 코드·API 명세·테스트 인프라에서 파생하기로 했어요.
  • 운영 부담 대신 검증 비용런타임 서버 없이 '추출 → 합치기 → 분류 → 렌더'가 파일로 이어지는 정적 파이프라인. 대신 각 단계의 정확성을 테스트와 가드로 지켜요.
  • 실제 앱과 같은 빌드네이티브 화면은 별도 도구 대신 각 앱 레포의 스냅샷 테스트 인프라에서 찍어요. 앱 코드와 같은 빌드를 타서 실제 화면과 어긋나지 않아요.
  • 파생할 수 없는 값은 시끄럽게사람이 적어야 하는 값은 이유를 남기고, 낡으면 검사가 실패하게 했어요. 의사결정은 ADR 290여 건으로 기록.
  1. 1플랫폼 레포웹 · Android · iOS · RN 레포를 커밋 단위로 고정입력
  2. 2추출코드를 읽어 화면 · 이동 · 이벤트 · API를 뽑기약 1분
  3. 3캡처테스트 인프라로 화면을 상태마다 찍기수십 분
  4. 4합치기 · 페어링하나로 합치고 Android · iOS 같은 화면 잇기1초 미만
  5. 5지도데이터 파일만 바꿔 배포, 화면이 읽어 그림정적 배포

서버 없이 단계마다 파일로 넘겨요. 같은 커밋과 같은 캡처면 언제나 같은 지도가 나와요.

03What I built

1
추출
웹 라우트·이벤트·API 호출, Android·iOS 네이티브 화면과 화면 전환, React Native 화면 연결, 네이티브↔웹뷰 브리지를 코드에서 읽어요.
2
합치기 · 페어링
같은 화면의 Android·iOS 버전을 진입 이벤트·공유 fixture 키·화면 문구·웹 셸·조회 API의 5단계 신호로 자동 매칭. 사람이 직접 적던 화면 쌍 11개를 0개로 만들었어요.
3
촬영 · 데이터
웹은 Playwright로 상태별, 네이티브는 스냅샷 테스트가 있는 상태를 자동 촬영. Amplitude 퍼널로 연결 350여 개에 실제 전환율을 붙였어요.
4
지도
잡 한 번이면 손 수정 없이 다시 그려지는 서비스 지도.

낯선 플랫폼에 직접 들어가기

네이티브 화면을 찍으려면 Android·iOS 테스트 인프라부터 고쳐야 했어요. 웹 개발자로서 두 앱 레포에 직접 PR을 올렸습니다(Android 14 · iOS 13). 캡처가 메모리를 너무 잡아 죽던 문제에 상한을 두고, 읽히지 않던 fixture를 열어 찍히는 화면을 늘렸어요.

이름이 달라도 같은 문구가 Android · iOS 화면을 잇는 단서가 돼요.
이름이 달라도 같은 문구가 Android · iOS 화면을 잇는 단서가 돼요. 출처: 피에프씨 기술 블로그 ↗
화면을 누르면 두 플랫폼 캡처를 상태별로 나란히 볼 수 있어요.
화면을 누르면 두 플랫폼 캡처를 상태별로 나란히 볼 수 있어요. 출처: 피에프씨 기술 블로그 ↗

04AI native

코드는 AI가, 기준은 사람이

이 프로젝트의 코드는 전부 Claude Code가 작성했어요. 저는 설계, ADR, 그리고 "무엇이 맞는가"를 정하는 검증 기준을 맡았습니다.

  • 병렬 위임티켓 단위로 작업을 나눠 여러 에이전트에 동시에 맡겨요.
  • 가드테스트 204개 파일, 자동 검사 14종, AI 리뷰를 붙여 PR 380여 건을 운영했어요.
  • 실측파이프라인이 83분까지 늘어났을 때, 회차별 단계 시간을 비교해 제 PR이 만든 11분 회귀를 찾아 되돌렸어요.

05Result

  • 화면·다이얼로그 520여 개, 연결 1,300여 개, 스크린샷 6,000여 장이 잡 한 번이면 손 수정 없이 다시 그려져요.
  • 지도로 만들고서야 보인 결함앱이 4xx·5xx 응답을 화면에서 구분하지 않는 문제, 같은 계좌 인증이 iOS 3화면·Android 1화면으로 다르게 구현된 문제.
  • 실행 시간전체 파이프라인 62.6분 → 49.6분(약 21%, 같은 범위 기준). 제 회귀가 섞인 83분이 아니라 같은 범위끼리 비교한 숫자예요.
  • 사내 AI 어시스턴트가 이 지도를 데이터 소스로 써서 "이 API를 쓰는 화면" 같은 질문에 답해요.
iOS
  1. 화면 1
  2. 화면 2
  3. 화면 3
3화면
Android
  1. 한 화면
1화면
같은 「계좌 인증」인데 두 앱의 단계 수가 달랐어요. 화면을 나란히 놓는 지도가 생기고서야 처음 드러났어요. (화면 수만 나타낸 도식)

06Learning

지도는 '한 번 그리는 일'보다 '계속 맞게 두는 일'이 훨씬 어렵다. 파생할 수 있는 것은 파생하고, 파생할 수 없는 것은 틀렸을 때 시끄럽게 멈추게 만드는 것이 유지 가능한 시스템의 조건이었다.