철도 노선도는 선을 곧게 펴고 역 사이를 고르게 띄워 환승을 쉽게 보여줄 수 있습니다. 동시에 걸어서 금방 갈 두 역이 멀어 보이게 할 수도 있습니다. 열차를 고르도록 돕는 바로 그 추상화가 도보 경로를 고르는 사람을 오도할 수 있습니다.
교통 노선도의 역사는 개략도가 경로 선택을 넘어 다른 업무에 쓰일 때 무슨 일이 생겼는지 묻습니다. 뉴욕 교통 박물관의 설명은 1972년 지도가 노선을 직선화하고 대부분의 지형 정보를 제거했다고 확인합니다. 한 업무에 좋은 그림도 다른 업무에는 보조 화면이 필요할 수 있다는 교훈을 줍니다. 제안된 보조 자료의 정확한 제작 과정의 역사는 이 교훈에 필요하지 않습니다.
독자가 찾으려는 경로 정의하기
모든 그림은 정보를 제거합니다. 시스템 구조 스케치는 시간을 빼고, 워크플로 차트는 데이터 값을 빼고, 동기화 방향도는 쓰기를 누가 승인할 수 있는지를 뺄 수 있습니다. 정보를 뺀 덕분에 그림을 읽을 수 있는 경우가 많습니다. 빠진 속성이 독자의 선택에 중요할 때 문제가 시작됩니다.
매장과 이메일 플랫폼을 두 상자와 한 화살표로 그린 설명용 동기화 그림을 떠올려 보세요. 매장 → 이메일 플랫폼입니다. “고객 레코드를 어느 시스템이 보내나요?”에는 답합니다. 동의도 함께 전달되는지, 중복을 어떻게 처리하는지, 구매가 대기 중인 메시지를 취소하는지는 답하지 못합니다. 그림은 틀리지 않았습니다. 그 결정에는 불완전합니다.
그리기 전에 독자의 질문을 한 문장으로 적으세요.
- A역출발연결
- 환승노선 변경연결
- B역목적지
“이 필드는 어디서 생기나요?”에는 데이터 계보가 필요합니다. “원본을 사용할 수 없으면 어떻게 되나요?”에는 시점과 실패 상태가 필요합니다. “누가 캠페인을 시작할 수 있나요?”에는 권한이 필요합니다. 한 페이지에 여러 화면을 담을 수 있지만 하나의 화면이 모든 업무에 최적이라고 가장해서는 안 됩니다.
| 화면 | 보존하는 관계 | 흔한 왜곡 |
|---|---|---|
| 개략 노선도 | 연결과 환승 | 실제 거리와 방향 |
| 데이터 흐름도 | 원본, 데이터 이용 측, 방향 | 시점과 권한 |
| 시퀀스 다이어그램 | 호출과 응답의 순서 | 오래 지속되는 상태와 사람의 업무 |
| 권한 표 | 허용된 주체와 동작 | 시스템 안의 사용자 여정 |
이는 개념적인 예이며 특정 제품이나 지도를 평가한 결과가 아닙니다.
사용하는 곳에 생략을 표시하기
“축척에 맞지 않음”이라는 각주는 여행자가 개략 지도를 이해하는 데 도움이 됩니다. 동기화 그림이라면 “정상 데이터 방향만 표시하며 쓰기에는 실패 경로와 권한 표를 참고하세요”라는 캡션이 좋습니다. 무엇이 빠졌는지 명시하기에 일반적인 면책 문구보다 유용합니다.
보조 화면은 결과의 중요성에 맞춰 골라야 합니다. 보안 검토에 쓰는 그림이라면 권한은 선택적 배경 정보가 아닙니다. 오래된 레코드를 조사할 때는 상자 배치보다 타임스탬프와 재시도 상태가 중요합니다. 새 연동을 계획한다면 필드 소유권과 수정 경로가 구현을 결정할 수 있습니다.
그래서 시각적인 깔끔함은 함정이 될 수 있습니다. 다른 화살표와 교차하지 않는 화살표는 깨끗해 보이지만 피드백 경로를 감출 수 있습니다. 똑같은 상자는 한 시스템이 진실을 소유하고 다른 시스템은 버릴 수 있는 복사 상태만 보유해도 책임이 같다고 암시합니다. 중요할 때는 운영상의 비대칭을 보이게 설계해야 합니다.
필요한 지점에 다음 화면 제공하기
하나의 그림도 결정이 필요한 지점에 다음 화면을 제공하면 여러 독자를 도울 수 있습니다. 당장의 질문에 답하는 화면으로 시작하고, 가까운 곳에 다음에 필요한 화면으로 가는 링크나 전환 기능을 두세요. 화면마다 라벨을 일치시켜 흐름 속 “고객”이 권한 표에서도 같은 객체임을 알게 하세요.
유용한 검토에서는 시스템을 모르는 사람에게 두 가지 결정을 맡깁니다. 먼저 그림을 원래 목적대로 써 봅니다. 그다음 생략된 속성에 달린 질문을 합니다. 독자가 자신 있게 잘못된 추론을 한다면 생략에 라벨이나 보조 화면이 필요합니다. 다음에 볼 곳을 안다면 추상화가 제 역할을 하는 것입니다.
데이터 소유권 가이드는 그 아래의 연동 선택을 다룹니다. 선택을 그린 지도는 완전해 보이는 구조를 감상하게 하는 대신 독자가 올바른 다음 단계로 가게 해야 합니다.
그림 자체에 테스트 사례를 담을 수도 있습니다. 정상 레코드 하나와 예외 하나를 놓고 독자에게 둘 다 따라가게 하세요. 예외가 라벨 없는 화살표에서 사라진다면 그림이 결정을 숨긴 것입니다. 경영진용 버전은 필드 이름을 생략할 수 있지만 실패의 소유자는 보여줘야 합니다. 구현자용 버전은 스키마와 재시도를 보여주고 조직 내 정치적 맥락은 생략할 수 있습니다. 각 생략이 해당 업무를 지켜 주느냐가 질문입니다. 새 독자가 추측해야 한다면 빈 곳을 상자로 다 채우기보다 빠진 관계를 추가하거나 보조 화면을 가리키세요.
지도는 신중하게 생략할 때 성공합니다. 독자가 결정하러 온 바로 그 정보를 생략하면 실패합니다.
자주 묻는 질문
단순화한 그림이 정직하려면 무엇이 필요하나요?
어떤 업무를 돕고 어떤 속성을 보존하는지 명시한 뒤 중요한 생략을 보이게 해야 합니다. 배치, 거리, 완전성이 실제와 다르다면 문자 그대로라고 암시해서는 안 됩니다.
그림에 보조 화면이 필요한 때는 언제인가요?
독자가 물리적 거리, 접근 제어, 지연 시간, 예외 경로처럼 그림에서 의도적으로 뺀 정보로 결정을 내려야 할 때입니다.
팀은 시스템 지도를 어떻게 검토해야 하나요?
독자에게 의도한 업무를 그림으로 수행하게 한 뒤, 생략된 세부사항에 의존하는 두 번째 업무도 시험하세요. 생략이 오해를 부르면 그림을 고치거나 보조 화면을 연결하세요.