Technote

개발 워크플로우 입문

연재 요구사항을 구조로 바꾸기 8부 중 2부

화면 목록보다 시나리오가 먼저입니다

누가 · 무엇을 하려고 · 어떤 결과를 얻는지를 문장으로 먼저 적으면, 화면은 그 문장에서 저절로 떨어져 나옵니다. 순서를 뒤집으면 화면만 남고 흐름이 사라집니다.

요구사항 문서를 열면 대개 화면 목록부터 나옵니다. 목록 화면, 상세 화면, 등록 화면, 수정 화면. 만들 것이 분명해 보여서 안심이 되는 형식입니다. 그런데 이 형식에는 화면과 화면 사이가 비어 있습니다. 사용자가 어떤 상황에서 여기에 도착했는지, 여기서 무엇을 하고 어디로 가는지가 문서 어디에도 없습니다.

그 빈칸은 사라지지 않고 개발 중에 질문으로 돌아옵니다. “등록하고 나면 어디로 가나요?” “목록에서 바로 수정할 수 있어야 하나요?” 화면을 다 그려 놓고도 이런 질문이 계속 나온다면, 문서가 화면은 정했지만 흐름은 정하지 않은 것입니다.

시나리오 한 줄의 형식

시나리오는 어렵지 않습니다. 한 줄에 세 가지가 들어가면 됩니다.

시나리오 한 줄에 반드시 들어가는 세 가지 — 하나라도 빠지면 화면이 정해지지 않는다

예를 들면 이렇습니다. “매장 담당자가 오늘 들어온 문의를 확인하고, 답변이 필요한 건에 담당자를 지정해 둔다.” 문장 하나인데 여기서 이미 여러 가지가 정해집니다. 목록의 기본 정렬은 최신순이고, “오늘” 이라는 범위가 있고, 답변 필요 여부를 구분할 표시가 필요하고, 담당자를 지정하는 동작이 목록에서 가능해야 합니다.

반대로 “문의 관리 기능” 이라고만 적으면 이 중 아무것도 정해지지 않습니다. 같은 다섯 글자를 읽고 개발자는 상세 화면에서 담당자를 지정하는 구조를 만들고, 기획자는 목록에서 지정하는 화면을 상상합니다. 둘 다 문서를 어긴 적이 없습니다.

화면은 시나리오에서 떨어져 나옵니다

시나리오를 적었다면 화면 목록은 따로 만들 필요가 거의 없습니다. 문장을 단계로 쪼개고, 각 단계에서 사용자가 보아야 하는 것과 해야 하는 것을 적으면 그것이 곧 화면입니다.

화면 목록은 만드는 것이 아니라 시나리오에서 도출되는 것이다

이 순서의 이점은 빠진 화면이 드러난다는 점입니다. 단계를 따라가다 보면 “여기서 실패하면 어디로 가지” 같은 자리가 자연스럽게 비어 있는 채로 보입니다. 화면 목록에서 출발하면 그 자리는 애초에 목록에 없으므로 아무도 눈치채지 못합니다.

시나리오는 몇 개나 쓰나

기능 하나에 시나리오를 열 개씩 쓸 필요는 없습니다. 가장 흔한 흐름 하나를 먼저 완성하고, 그다음 의미 있게 다른 흐름 두세 개를 더합니다. 역할이 다른 사람(관리자와 일반 사용자), 상황이 다른 경우(처음 쓰는 사람과 매일 쓰는 사람) 정도면 충분합니다.

중요한 것은 개수가 아니라 문장이 검증 가능한가입니다. 다 만든 뒤에 그 문장을 그대로 따라 해 볼 수 있어야 합니다. 따라 할 수 없는 문장은 시나리오가 아니라 희망사항입니다 — 이 성질은 연재 마지막 회차의 인수 기준으로 그대로 이어집니다.

정보 구조와 화면 설계를 함께 다루는 글은 개발 워크플로우 아카이브에 있고, 우리가 실제 작업에서 요구를 어떤 순서로 확정하는지는 작업 과정에 단계별로 적혀 있습니다.

다음 회차

주 흐름을 적었으면 이제 흐름이 어긋나는 자리입니다. 다음 회차는 예외 — 빈 상태, 실패, 권한 없음, 아주 긴 값을 명세에서 미리 다루는 방법입니다.

이 주제의 다른 글

노하우 목록으로

개발 워크플로우 실무

스테이징에서 먼저 올려 보는 30분

스테이징은 개발자만 쓰는 장치가 아닙니다. 프로덕션에서 복구하는 데 드는 하루와 스테이징에서 확인하는 30분을 비교하면, 이것은 취향이 아니라 계산입니다.

운영 · 관리자 3분 읽기

개발 워크플로우 실무

예외는 QA 가 아니라 명세에서 다룹니다

빈 상태 · 실패 · 권한 없음 · 아주 긴 값. 구현이 의도에서 갈라지는 자리는 거의 항상 이 넷 중 하나이고, 넷 다 명세에서 한 줄이면 끝나는 것들입니다.

기획자 3분 읽기

개발 워크플로우 실무

자주 울리는 알림은 결국 꺼집니다

알림을 무시하기 시작하면 그 감시는 이미 고장 난 것입니다. 게다가 꺼진 알림은 없는 알림보다 나쁩니다 — 지켜지고 있다는 착각을 남기기 때문입니다.

운영 · 관리자 4분 읽기

₩270,000 · 신청하기