[서비스 기획 숙련] 실무 문서 작성

문서	핵심 역할
요구사항 정의서(PRD)	무엇을, 왜, 어디까지 만들지 정의
정보 구조(IA)	정보를 어디에 배치하고 어떻게 연결할지 설계
서비스 정책서	기능의 노출 조건과 동작 기준 정의
에러 케이스 정의	예외 상황과 대응 방식 정리
상세 기획안 / 스토리보드	화면 흐름과 기능 명세를 구체화

 

---

 

요구사항 정의서(PRD)

PRD(Product Requirements Document)

어떤 제품을 만들어야 하는지 명확히 이해할 수 있도록 정리하는 문서

 

PRD의 핵심
“무엇을 만들 것인가”에 그치지 않고
“왜 만들고, 어디까지 만들고, 어떤 기준이면 완료인가”를 정의한다.

 

항목

항목	설명
기능 이름	어떤 기능인지 한눈에 알 수 있는 이름
기능 설명	사용자와 서비스 관점에서 기능의 역할 설명
우선순위	먼저 개발해야 하는 기능과 후순위 기능 구분
구현 기준	개발 완료 여부를 판단할 수 있는 기준

 

함께 정리하면 좋은 내용

• 프로젝트 개요
• 목적과 목표
• 주요 기능
• 타깃 사용자
• 서비스 또는 제품의 배경
• 현재 문제 정의
• 해결 방향
• 우선순위
• MVP(Minimum Viable Product) 기준
• 릴리즈 계획
• 기대 성과
• 성과 측정 기준

 

작성 시 주의점

“나와 같은 생각을 하는 사람은 없다”
이 전제로 작성하기

• 구체적인 요구사항
• 기능별 우선순위
• 기능 범위
• 일정
• 시간 기준
• 선택 기준
• 완료 기준

 

---

정보 구조(IA)

IA(Information Architecture)

서비스 안의 정보를 어디에 배치하고, 어떻게 연결할지 설계한 문서

사용자는 정보를 많이 보고 싶은 것이 아닌, 필요한 정보를 빠르게 찾고 싶어 한다.

IA는 사용자가 서비스 안에서 길을 잃지 않도록 만드는 구조

 

목적

목적	설명
사용자 경험 개선	원하는 정보를 빠르게 찾을 수 있도록 돕는다
정보 탐색 효율화	정보의 위치와 중요도를 명확히 구분한다
서비스 확장 대응	기능 추가나 수정에도 유연하게 대응할 수 있다

 

예시

e.g) 사용자는 주문한 상품이 뭐였는지 알고 싶다.

• 마이페이지에 들어간다
• 주문 내역을 찾는다
• 내가 주문한 상품을 확인한다

메뉴 이름이 애매하거나, 주문 내역이 예상하지 못한 위치에 있다면 사용자는 쉽게 불편함을 느낀다.

→ 잘못된 IA 설계

 

작성 방법

순서	내용
1	시스템 내 제공 기능 전체 나열
2	비슷한 기능끼리 카테고리화
3	상위 / 하위 계층 구조 설계
4	중요한 정보는 상위 카테고리에 배치
5	사용자 탐색 흐름에 맞게 정리

 

IA 예시

 

---

 

서비스 정책서

어떤 조건에서 어떻게 동작해야 하는지 정리한 문서

PRD가 제품의 목적과 요구사항을 정의한다면,
서비스 정책서는 실제 구현과 운영 기준을 더 구체적으로 다룬다.

 

항목

항목	설명
노출 항목	화면에 보여줄 정보나 기능
노출 조건	어떤 사용자, 어떤 상태에서 보여줄지에 대한 기준
동작 흐름	사용자 행동에 따라 기능이 작동하는 방식
제한 조건	기능 사용이 제한되는 조건

 

예시

e.g) 쿠폰 노출 정책서

• 누구에게 노출할 것인가
• 언제 노출할 것인가
• 어떤 조건에서 숨길 것인가
• 이미 사용한 쿠폰은 어떻게 처리할 것인가
• 만료된 쿠폰은 보여줄 것인가
• 중복 노출은 허용할 것인가

 

목적

1. 일관성 있는 방향 설정
2. 효율적인 협업과 커뮤니케이션
3. 법적 및 규제 준수

서비스는 정상적인 상황만 존재하지 않는다.

사용자 상태, 가입 여부, 결제 여부, 기간, 권한 등에 따라 화면과 기능은 달라질 수 있다.

정책서는 이런 다양한 조건을 하나의 기준으로 정리해준다.

 

작성 방법

단계	내용
목적 정의	어떤 문제를 해결하기 위한 정책인지 정리
범위 설정	정책이 적용되는 기능과 운영 범위 제한
주요 항목 작성	정책 항목을 구조화
세부 조건 작성	상황별 기준을 구체적으로 작성
공유 및 업데이트	관련 팀과 공유하고 서비스 변경 시 갱신

---

 

에러 케이스 정의서

서비스에서 발생할 수 있는 예외 상황을 미리 정리한 문서

 

목적

목적	설명
서비스 안정성	예외 상황에서도 서비스가 무너지지 않도록 대비
사용자 경험 향상	사용자가 현재 상태와 다음 행동을 이해할 수 있도록 안내
빠른 문제 대응	문제 발생 시 원인 파악과 대응 시간을 줄임

 

에러의 종류

구분	설명	예시
사용자 오류	사용자가 정상 조건을 충족하지 못한 경우	비밀번호 오입력, 필수값 누락, 만료 카드 사용
시스템 오류	서비스 내부 또는 외부 시스템 문제	서버 장애, DB connection 실패, API 응답 오류, 파싱 오류

 

작성 방법

1. 에러 케이스 정의
제공 기능마다 가능한 오류 상황을 미리 예측하고 정의

2. 에러 발생 조건 명시
협업하는 팀이 동일한 조건을 이해하고 테스트하며, 에러 발생 시 추적 및 대처에 용이

3. 에러 메세지 작성
사용자에게 보여줄 오류 메세지를 작성하여, 사용자가 취할 행동을 구체적으로 안내

4. 에러 코드
에러 코드를 포함시켜, 시스템이나 개발팀이 문제를 더 빠르게 파악할 수 있도록 작성하면 더 좋음

 

❓의문점
백엔드 / 프론트 에러 코드 및 에러 메세지 정의 및 관리 주체
 
백엔드 에러 코드 및 에러 메세지는 개발자가 정의 및 관리 할 것이고 ....
프론트 에러 코드와 메세지는 PM이 정의 및 관리 하는걸까? 
아니면, 공통 문서를 만들어서 프론트 개발자가 관리하고 PM이 팔로업 하는걸까?

---

 

상세 기획안 / 스토리보드

화면 설계와 기능 흐름을 구체적으로 정리하는 문서

기능 명세와 화면 흐름을 연결해 실제 서비스가 어떻게 동작해야 하는지 보여준다.

참고
기능 명세, 상세 기획안, 스토리보드, 화면 설계서 등은 비슷한 의미로 통용된다.

 

작성 방법

1. 기능 개요
기능의 맥락 정리
어떤 문제를 해결하는지, 사용자가 어떤 행동을 할 수 있는지, 완성 후 어떤 성과를 기대할 수 있는지 정리

2. 서비스 / 사용자 Flow 도식화
사용자가 서비스에 진입해서 목표 행동을 완료하기까지의 흐름을 정리

1. 목표를 달성하기 위한 필수 단계 정의
2. 사용자가 서비스에 들어오는 시작점 설정
3. 사용자가 목표를 달성하기 위한 단계별 흐름 나열
4. 옵셔널 경로의 결정 노드와 분기점 추가
5. 시각적으로 흐름을 도식화

3. 상세 기능 명세
각 기능이 어떻게 동작해야 하는지 구체적으로 작성

1. 이름 - 기능이 무엇을 하는지 간결하고 명확하게 표현
2. 설명 - 기능이 어떤 작업을 수행하는지 간략하게 설명
3. 입력값 - 기능이 처리해야 하는 입력값
4. 출력값 - 기능 실행 후 시스템에서 사용자에게 보여줄 출력값

입력값 예시

e.g) 결제 처리

• 카드 번호: 유효한 카드 번호
• 유효 기간: 카드의 만료 날짜(MM/YY)
• CVC: 카드 뒷면의 보안 코드

출력값 예시

e.g) 결제 처리

• 성공 시: 결제가 완료되었습니다. 상품을 곧 배송합니다.
• 실패 시: 결제 처리 중 오류가 발생했습니다. 다시 시도해 주세요.
• 예외 시: 결제 중입니다. 조금만 기다려 주세요.

 

---

 

문서별 핵심 정리

문서	핵심 질문
PRD	무엇을, 왜, 어디까지 만들 것인가?
IA	사용자가 정보를 어떻게 찾게 할 것인가?
서비스 정책서	어떤 조건에서 어떻게 동작해야 하는가?
에러 케이스	예외 상황에서 어떻게 안내하고 대응할 것인가?
스토리보드	화면과 기능은 어떤 흐름으로 연결되는가?