0→1 · Architecture · 피에프씨테크놀로지스
서비스 지도그리기
크플 프로덕트 맵웹·Android·iOS·React Native 코드에서 화면과 화면 흐름을 읽어 하나의 지도로 자동 생성합니다. 사람이 손으로 관리하던 화면 목록과 플로우 문서를, 코드가 바뀌면 같이 바뀌는 데이터로 바꿨어요.
0+
화면·다이얼로그
0+
화면 간 연결
0+
자동 촬영 스크린샷
0%
본인 커밋 비중

01Problem
아무도 서비스 전체를 한 번에 볼 수 없었어요
크플의 화면은 웹, Android, iOS, React Native에 흩어져 있었어요. 한 사용자가 투자를 끝내기까지 어느 플랫폼의 어느 화면을 지나는지 알려면 레포를 하나씩 열어봐야 했죠.
손으로 만든 화면 목록과 플로우 문서도 있었지만, 코드가 바뀌는 순간 낡았어요. 기획·QA·개발 누구도 그 문서를 믿고 쓰지 못했습니다.
02Decision
"사람이 관리하는 값은 관리되지 않는 값"
- 파생하는 구조화면 목록·연결·스크린샷을 손으로 적지 않고, 각 플랫폼의 코드·API 명세·테스트 인프라에서 파생하기로 했어요.
- 운영 부담 대신 검증 비용런타임 서버 없이 '추출 → 합치기 → 분류 → 렌더'가 파일로 이어지는 정적 파이프라인. 대신 각 단계의 정확성을 테스트와 가드로 지켜요.
- 실제 앱과 같은 빌드네이티브 화면은 별도 도구 대신 각 앱 레포의 스냅샷 테스트 인프라에서 찍어요. 앱 코드와 같은 빌드를 타서 실제 화면과 어긋나지 않아요.
- 파생할 수 없는 값은 시끄럽게사람이 적어야 하는 값은 이유를 남기고, 낡으면 검사가 실패하게 했어요. 의사결정은 ADR 290여 건으로 기록.
- 1플랫폼 레포웹 · Android · iOS · RN 레포를 커밋 단위로 고정입력
- 2추출코드를 읽어 화면 · 이동 · 이벤트 · API를 뽑기약 1분
- 3캡처테스트 인프라로 화면을 상태마다 찍기수십 분
- 4합치기 · 페어링하나로 합치고 Android · iOS 같은 화면 잇기1초 미만
- 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를 열어 찍히는 화면을 늘렸어요.


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
- 화면 2
- 화면 3
Android
- 한 화면
06Learning
지도는 '한 번 그리는 일'보다 '계속 맞게 두는 일'이 훨씬 어렵다. 파생할 수 있는 것은 파생하고, 파생할 수 없는 것은 틀렸을 때 시끄럽게 멈추게 만드는 것이 유지 가능한 시스템의 조건이었다.