본문으로 건너뛰기

기능 명세서 작성법, 적을 항목 8개와 회원가입 예시

기능 명세서는 기능 하나마다 입력 · 처리 · 출력 · 예외를 적어 개발이 끝난 뒤의 수정 요청을 줄이는 문서입니다. 요구사항 정의서 · 화면 설계서와의 차이, 기능마다 적을 항목 8개, 예외를 찾는 질문 목록, 만 14세 미만 동의까지 넣은 회원가입 채운 예시를 정리했습니다.

기능 명세서 작성법, 적을 항목 8개와 회원가입 예시

기능 명세서는 기능 하나마다 입력 · 처리 · 출력 · 예외를 적는 문서입니다. 요구사항 정의서가 무엇이 필요한지를 정하고 화면 설계서가 어떻게 보이는지를 그린다면, 이 문서는 버튼을 눌렀을 때 무슨 일이 일어나는지를 적습니다. 정상 흐름보다 예외, 곧 값이 비었을 때 · 권한이 없을 때 · 같은 값이 이미 있을 때를 적어 두는 것이 중요합니다. 예외가 비어 있으면 개발하는 쪽이 그때그때 정하게 되고, 맡긴 쪽 생각과 다르면 오픈 뒤 수정 요청으로 돌아옵니다. 부르는 이름(기능 정의서 · 기능 명세서 · 기능 설계서)과 양식은 회사와 개발사마다 달라, 아래 항목 8개와 회원가입 예시는 하나의 예로 봐 주세요.

기능 명세서는 요구사항 정의서 · 화면 설계서와 무엇이 다른가요

문서답하는 질문적는 단위회원가입을 예로 들면
요구사항 정의서무엇이 필요한가요구 하나"회원은 이메일로 가입할 수 있어야 한다"
화면 설계서어떻게 보이나화면 하나가입 화면의 입력 항목 배치와 버튼 위치
기능 명세서어떻게 동작하나기능 하나입력값 검사 규칙, 저장되는 값, 실패할 때 안내 문구

쓰는 순서는 요구사항 정의서, 화면 설계서, 기능 명세서가 자연스럽습니다. 요구사항 번호와 화면 번호가 먼저 정해져 있어야 명세서에서 그 번호를 이어 받을 수 있습니다. 요구사항을 정리하는 법은 프로그램 개발 의뢰 전 요구사항 정리하는 순서에, 화면 번호를 붙이는 법은 화면 설계서 쓰는 법에 있습니다.

공공 SW사업 대가산정 가이드도 기능점수(소프트웨어 규모를 기능 개수로 재는 단위) 산정에 도움이 되는 문서로 요구사항문서 · 화면 레이아웃과 함께 기능명세서를 들고 있습니다. 잘 쓴 명세서는 개발 지시서이면서 규모와 견적을 따지는 근거로도 쓰입니다.

기능 하나에 무엇을 적나요

번호항목적는 내용쓰는 요령
1기능 번호F-01처럼 기능마다 붙이는 고유 번호요구사항 번호를 옆에 함께 적어 출처를 남김
2기능 이름무엇을 하는 기능인지"회원가입하기"처럼 동사로
3화면이 기능이 쓰이는 화면 번호화면 설계서 번호 그대로
4입력받는 값과 형식, 필수 여부값 하나에 한 행
5처리시스템이 순서대로 하는 일번호를 붙인 단계로
6출력화면에 보이는 결과, 저장되는 값, 보내는 알림저장되는 표 이름까지
7예외정상 흐름이 아닐 때의 동작과 안내 문구조건 · 동작 · 문구를 함께
8권한이 기능을 쓸 수 있는 사람로그인 여부와 역할

입력 · 처리 · 출력은 개발자가 바로 옮겨 만들 수 있을 만큼 구체적이어야 합니다. "적절히 검사한다" 대신 "이메일 형식이 아니면 저장하지 않는다"처럼 시스템이 하는 동작으로 적으세요.

예외 처리는 어떻게 찾아 적나요

예외는 떠올리기보다 질문 목록으로 찾는 편이 빠릅니다. 입력값 하나마다 다섯 가지를 묻습니다.

  1. 비었을 때: 필수 값이 없으면 어디에 어떤 문구를 띄우나
  2. 형식이 틀릴 때: 숫자 자리에 글자, 이메일 형식이 아닌 값
  3. 너무 길거나 짧을 때: 최대 · 최소 글자 수
  4. 이미 있을 때: 같은 이메일, 같은 예약 시간처럼 겹치는 값
  5. 권한이 없을 때: 로그인하지 않았거나 역할이 맞지 않는 사람의 접근

처리 단계에는 세 가지를 더 묻습니다. 버튼을 두 번 눌렀을 때, 중간에 연결이 끊겼을 때, 문자 · 메일 · 결제 같은 외부 서비스가 실패했을 때입니다. 찾은 예외는 조건, 시스템 동작, 사용자에게 보이는 문구 순서로 적습니다. 문구까지 적어 두면 디자인과 개발이 같은 글자를 씁니다.

회원가입 기능은 어떻게 채우나요

아래는 가상의 서비스를 가정해 회원가입 기능을 채운 예시입니다. 비밀번호 길이 같은 규칙은 예시로 정한 값입니다.

항목채운 예시
기능 번호F-01(요구사항 R-03)
기능 이름회원가입하기
화면S-02 가입 화면, S-03 가입 완료 화면
입력이메일(필수, 이메일 형식), 비밀번호(필수, 8자 이상), 이름(필수), 생년월일(필수, 만 14세 확인용), 휴대폰 번호(선택), 이용약관 · 개인정보 수집 동의(필수), 마케팅 정보 수신 동의(선택)
처리① 입력값 검사 ② 이메일 중복 확인 ③ 만 14세 미만이면 법정대리인 동의 단계로 이동 ④ 비밀번호는 되돌릴 수 없는 방식으로 암호화해 저장 ⑤ 회원 표에 1건 저장 ⑥ 가입 완료 메일 발송
출력S-03 화면으로 이동, 회원 표 1건 추가(가입일 · 동의 항목 · 동의 시각 포함), 가입 완료 메일
예외E1 이메일이 비었으면 저장하지 않고 "이메일을 입력해 주세요" 표시
E2 이미 가입된 이메일이면 로그인 · 비밀번호 찾기 안내
E3 비밀번호가 8자 미만이면 입력 항목 아래에 규칙 안내
E4 만 14세 미만이면 법정대리인 동의 화면으로 이동
E5 메일 발송이 실패해도 가입은 완료하고 재발송 목록에 올림
권한로그인하지 않은 사용자만(로그인 상태면 첫 화면으로 이동)

처리 ③과 예외 E4는 법에서 온 것입니다. 개인정보 보호법 제22조의2는 만 14세 미만 아동의 개인정보를 처리하려고 동의를 받아야 할 때 법정대리인의 동의를 받고 그 동의를 확인하도록 정하고 있습니다. 마케팅 수신 동의를 선택으로 둔 것은 같은 법 제22조 제5항이 선택 동의 사항이나 홍보 · 판매 권유 목적의 동의를 하지 않았다는 이유로 서비스 제공을 거부하지 못하게 하기 때문입니다. 서비스에 어떤 동의 절차가 필요한지는 개인정보 보호 담당자나 전문가와 확인하세요.

명세서가 정리되면 프로그램 개발 견적을 받을 때 같은 문서를 건네면 됩니다. 견적은 기능 수뿐 아니라 예외와 외부 연동(문자 · 메일 · 본인확인) 수로도 달라지므로, 예외까지 적힌 명세서가 있으면 여러 업체의 견적을 같은 기준으로 비교할 수 있습니다.

자주 묻는 질문

기능 명세서는 누가 쓰나요?

맡기는 쪽 기획 담당이 입력 · 출력 · 예외 · 권한을 먼저 쓰고, 개발하는 쪽이 처리 단계와 저장 구조를 채워 넣는 식으로 나누면 각자 잘 아는 부분을 맡게 됩니다. 서로 고친 뒤에는 문서 맨 위에 버전 번호와 날짜를 적어 어느 판을 기준으로 개발하는지 분명히 하세요.

모든 기능을 8개 항목으로 자세히 써야 하나요?

그렇지 않습니다. 목록 보기 · 상세 보기 같은 단순 조회 기능은 입력 · 출력 · 권한만 짧게 적고, 돈이 오가거나 개인정보를 다루거나 상태가 바뀌는 기능(결제 · 가입 · 예약 취소)만 8개 항목을 모두 채웁니다.

기능 명세서를 외주 개발사에 넘길 때 무엇을 함께 주나요?

요구사항 목록, 화면 설계서, 옮길 기존 데이터의 표본, 화면에 쓸 안내 문구 목록, 연동할 외부 서비스 이름을 함께 넘깁니다. 외부 서비스 계정 정보는 문서에 적지 않고 (발급받은 키)처럼 자리만 표시해 두었다가 개발 단계에서 따로 전달하세요. 견적은 기능 수 · 예외 수 · 연동 수로 정해지므로 이 자료가 함께 있어야 견적 범위가 맞습니다.

개발 중에 명세가 바뀌면 어떻게 하나요?

명세서 끝에 변경 이력 표를 두고 날짜 · 바뀐 기능 번호 · 바뀐 내용 · 요청한 사람을 한 행씩 적습니다. 바뀐 내용이 일정이나 비용에 미치는 영향은 개발하는 쪽과 함께 보고 정합니다. 오픈 뒤 고칠 점을 전달하는 법은 개발 수정 요청 쓰는 법을 참고하세요.

오늘 할 일

기능 목록에서 가장 복잡한 기능 하나를 골라 예외를 5개 적어 보세요.

이어서 읽기 — 과업지시서 작성법, 목차 9개와 개발 용역 채운 예시

FacebookX

이 글과 맞는 서비스

이어서 읽기

블로그 전체 글 목록 →

카카오톡 상담식스원 고객센터 카카오톡 채널 (새 창)