PromleeBlog

posting thumbnail
추가적인 설계 요구사항
Additional Design Requirements - Supplementary Specification with FURPS+

📅

들어가기 전에 🔗

유스케이스로 기능 요구사항을 정리해 보면, 여전히 빠진 조건이 남아 있다는 것을 알게 됩니다.
"응답은 2초 안에 끝나야 한다", "개인정보는 암호화해서 저장한다", "모바일 화면에서도 같은 작업을 할 수 있어야 한다" 같은 조건은 유스케이스 한 장에 담기 어렵습니다.

이런 조건을 담는 문서가
부가 명세
(supplementary specification)입니다.
이전 글↗에서 정리한 유스케이스와 함께 읽으면, 기능과 품질을 한눈에 맞춰 볼 수 있습니다.

기능 요구사항과 나머지 요구사항 🔗

기능 요구사항은 시스템이
무엇을 하는지
를, 추가 요구사항은
얼마나 잘, 어떤 제약 아래에서
하는지를 정합니다.
예를 들어 "결제를 할 수 있다"는 기능 요구사항입니다.
하지만 "결제 승인 응답은 2초 이내에 끝나야 한다"는 추가 요구사항이며, 이것이 없으면 개발자는 기능을 구현하고도 어느 정도 느려도 되는지 알 수 없습니다.

FURPS+로 빠짐없이 분류하기 🔗

요구사항을 빠짐없이 찾는 데는
FURPS+
분류가 자주 쓰입니다.
각 글자는 품질 범주를 나타내고, +는 설계와 구현 측면의 제약을 더한 것입니다.
분류확인할 질문예시
기능성(F)유스케이스로 다루지 못한 기능 규칙이 있는가세금 계산 방식, 주문 취소 가능 기간
사용성(U)처음 쓰는 사람도 쉽게 익힐 수 있는가주요 작업을 3번의 클릭 안에 끝낼 수 있음
신뢰성(R)얼마나 자주 멈춰도 되는가월간 가용성 99.9% 이상
성능(P)얼마나 빨라야 하는가결제 승인 응답 2초 이내, 동시 접속 1만 명
지원성(S)운영과 변경이 얼마나 쉬운가로그를 30일간 보관, 재배포 없이 설정 변경
설계 제약(+)반드시 따라야 할 설계 결정이 있는가데이터베이스는 PostgreSQL을 사용
구현(+)개발 방식에 제약이 있는가특정 라이선스의 라이브러리 사용 금지
인터페이스(+)외부 시스템과 맺은 약속이 있는가결제사 API 규격을 따름
물리(+)장비나 환경에 조건이 있는가서버 한 대당 메모리 16 GB 이상
법적(+)규제나 계약 조건이 있는가개인정보 보관 기간을 법령에 맞춤
추가 요구사항을 FURPS 다섯 범주와 설계 제약, 구현, 인터페이스, 물리, 법적 범주로 나누어 보여 주는 체크리스트
추가 요구사항을 FURPS 다섯 범주와 설계 제약, 구현, 인터페이스, 물리, 법적 범주로 나누어 보여 주는 체크리스트
표를 한 칸씩 채워 나가면, 팀이 놓치기 쉬운 범주를 체크리스트처럼 확인할 수 있습니다.
모든 칸을 채울 필요는 없고, 해당하지 않는 범주는 "해당 없음"이라고 적어 두는 것도 중요합니다.

모호한 표현을 검증 가능한 수치로 바꾸기 🔗

추가 요구사항에서 가장 흔한 실수는 "빠르게", "안정적으로", "쉽게"처럼 검증할 수 없는 표현을 쓰는 것입니다.
이런 표현은 개발자와 테스터가 같은 기준으로 판단할 수 없습니다.
각 수치에는
측정 방법
도 함께 적어야 합니다.
예를 들어 "부하 테스트에서 동시 접속 1만 명으로 측정"처럼 조건을 명시하면, 나중에 결과가 요구사항을 충족하는지 바로 판단할 수 있습니다.
👍
추가 요구사항은 나중에 수정하기 쉽다고 생각하고 미루기 쉽습니다.
하지만 설계 제약과 인터페이스 조건은 초기 구조를 바꾸는 결정이므로, 개발 초반에 확정해 두어야 나중에 큰 재작업을 피할 수 있습니다.

설계 제약이 설계를 바꾸는 예 🔗

"결제 승인 응답은 2초 이내"라는 조건이 있다고 해 보겠습니다.
결제사 API의 평균 응답이 1.5초라면, 우리 서버의 처리 시간을 제외하고 남는 여유는 0.5초뿐입니다.
이 조건 때문에 결제사 호출 시간 제한(타임아웃)과 재시도 정책을 설계 단계에서 함께 정해야 합니다.
요구사항 하나가 시스템 구조의 세부 결정으로 이어지는 것입니다.
👨‍💻
부가 명세는 유스케이스 본문에서 "부가 명세 참조"처럼 연결해 두면 좋습니다.
그러면 유스케이스를 읽는 사람이 해당 기능에 붙은 품질 조건을 바로 찾을 수 있습니다.

결론 🔗

추가 요구사항은 기능 목록 옆에 놓이는
품질과 제약의 목록
입니다.
FURPS+로 범주를 나누어 빠짐없이 찾고, 모호한 표현은 측정 가능한 수치와 측정 방법으로 바꾸어야 합니다.

이렇게 정리된 요구사항은 설계 결정의 근거가 되고, 이후 반복적 개발에서 우선순위를 정할 때도 다시 쓰이게 됩니다.

참고 🔗