사용자 여정 지도6단계

커밋 b8fd588b 생성 2026-08-22 00:52 KST 화면 119 · 요소 1,062 · API 210
이 단계에서 볼 수 있는 것

세 축 + 상태·권한 + 오버레이. 🟢 는 근거·구현·검증이 모두 있는 것 — 닫아도 되는 칸이다.

  • 스크린샷은 인증을 푼 개발 백엔드 기준이다. 프로덕션에서 저렇게 보인다는 뜻이 아니다.
  • 초록은 '누가 확인했다'이지 '맞다'가 아니다. 비즈니스 규칙 자체가 틀릴 수 있다.

스크린샷은 옆의 shots/ 폴더를 참조한다 — 옮길 때는 map.htmlshots/같이 옮겨야 한다. (링크로 받은 단독본은 그림이 안에 들어 있어 이 줄이 지워진다.)

한눈에 먼저 볼 곳부터

0
여정 위의 실패
테스트가 실제로 깨진 칸 — 제일 먼저 볼 곳
1
여정 위의 미확인
만들었는데 아무도 확인 안 함
23
여정 위의 확인함
테스트 통과 + 스크린샷
0/3
★ 인수인계 통과
여기가 깨지면 양쪽이 초록이어도 서비스는 안 돈다
74
미분류 화면
코드에는 있는데 여정에 아직 못 넣음

색이 뜻하는 것 색만으로 읽지 않게 기호와 낱말을 같이 붙였습니다

색은 “작업했다”가 아니라 “닫혔다”를 뜻합니다. 증거가 없으면 색이 안 바뀝니다. 다만 지금은 근거 축이 없어서 🟢 는 “확인함”까지입니다. 파랑·검정은 근거 축(4단계)이 붙어야 나타나므로 지금은 전부 0입니다.

화면요소해야 할 일
확인함 테스트가 통과했고 스크린샷도 찍혔다근거 ✓ · 구현 ✓ · 검증 ✓ 65 124 없음. 다시 안 본다 — 근거·구현·검증이 다 켜졌으면 닫힌 칸이다
!미확인 만들었는데 아무도 확인 안 했다근거 ✓ · 구현 ✓ · 검증 ✗ 2 71 확인한다 — 이 화면을 여는 테스트를 붙인다
실패 이 화면을 보는 테스트가 실제로 깨져 있다검증 실패 0 0 고친다. 지도에서 제일 먼저 볼 곳이다
?출처 불명 잘 도는데 왜 있는지 아무도 모른다근거 ✗ · 구현 ✓ · 검증 ✓ 0 0 고치지 말고 물어본다 (KYB 사건, §5.4)
숨겨짐 코드에는 있는데 화면에 안 그려진다코드엔 있음 · 화면엔 없음 0 0 스위치가 있으면 정상, 없으면 버그다 (§5.45)
안 만듦 약속했는데 아직 안 만들었다근거 ✓ · 구현 ✗ 0 0 만든다. 근거 축(4단계)이 붙어야 비로소 보인다
·판정 불가 테스트가 이걸 지목할 수단이 없다 52 867 가리킬 표식(test id)을 붙이기 전에는 영원히 색이 안 바뀐다

여정 지도 가로는 시간, 세로는 사람 — 칸을 누르면 오른쪽에 자세히 뜹니다

여정에 놓인 화면 24개. ★ 는 레인과 레인 사이의 인수인계입니다 — 여기가 깨지면 양쪽 레인이 전부 초록이어도 서비스는 안 돕니다. 지도가 화면보다 넓으면 지도 안에서 옆으로 밀어서 봅니다.

시간 →
123456789101112
사용자 웹
★ 인수인계
관리자 웹
① 왼쪽에서 오른쪽으로 시간이 흐릅니다 ② 줄 하나가 사람 한 종류입니다 ③ ★ 는 줄과 줄 사이의 넘겨주기입니다

서브 여정 도구가 링크를 따라가 찾은 흐름 — 손으로 넣지 않았습니다

위 여정 25칸은 사람이 “이게 우리 제품의 줄기다”라고 정한 것입니다. 여기 것은 코드의 링크가 이렇게 이어져 있더라는 관찰입니다. 믿을 수 있는 정도가 달라서 섞지 않고 따로 그립니다. 화살표는 실제로 코드에 있는 링크만 긋습니다 — 나란히 놓였다는 이유로 선을 그으면 없는 흐름을 지어내는 것이기 때문입니다.

이 그림은 불완전합니다. 목적지가 변수인 링크(to={주소변수})는 일부러 안 풉니다 — 거슬러 올라가다 틀리면 “안 가는 곳으로 간다”고 말하는 링크가 생깁니다. 그래서 여기서 “안 이어졌다”는 “이어진 것을 못 찾았다”는 뜻입니다.

사용자 웹 · 3칸
들어오는 링크를 못 찾은 화면 1개

이 화면들에서 나가는 링크는 있는데, 여기로 들어오는 링크를 코드에서 못 찾았습니다. 주소를 직접 치지 않으면 못 가는 화면이거나, 목적지가 변수라 도구가 못 푼 링크에 가려진 것입니다. 어느 쪽인지 도구는 단정할 수 없습니다.

한 화면에서 뻗는 것5묶음

순서가 있는 줄이 아니라 한 칸에 달린 가지입니다. 줄로 그리면 없는 순서를 지어내는 것이 됩니다.

같은 API 를 쓰는 화면 링크로는 안 보이는 연결

위의 여정·서브 여정은 링크를 따라간 것입니다. 그런데 링크에는 구멍이 있습니다 — 목적지가 변수면 못 풀고, 애초에 링크가 없어도 같은 일을 하는 화면은 링크로 안 엮입니다. 같은 API 를 부른다는 것은 같은 데이터를 만진다는 뜻이고, 그건 링크가 없어도 성립하는 진짜 관계입니다.

서로 다른 사람이 같은 데이터를 만진다14건

발행사 화면과 운영자 화면이 같은 API 를 부릅니다. 여기가 ★ 인수인계 후보입니다 — 한쪽에서 바꾼 것이 다른 쪽에 제때 보이지 않으면, 양쪽 화면이 모두 초록이어도 서비스는 안 돕니다.

API 1개 공유
BE-0074

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0077

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

API 1개 공유
BE-0197

관리자 웹 ↔ 사용자 웹

미분류 여정에도 서브 여정에도 아직 안 놓인 화면 74개

아래 화면들은 코드에는 분명히 있는데 위 여정 어디에 놓아야 할지 아직 정하지 않은 것입니다. 고장난 것이 아니고, 없는 것도 아닙니다. 숨기지 않습니다 — 숨기면 영원히 안 채워지기 때문입니다. 여정에 놓으려면 docs/visualization/journey.json 에 줄 하나를 더하면 됩니다.

사용자 웹14개

관리자 웹8개

공용 UI52개