How to write a software requirement document (with template)

학교에서 19세기 소설을 읽고 "이게 같은 언어야?"라고 생각했던 기억이 있나요? 기술 지향적인 AI 개발자나 웹 전문 SEO 분석가와 협업할 때 사무실에서 똑같은 생각을 했을 가능성이 높습니다. 동료를 위한 CliffsNotes가 있다면 좋을 텐데 말이죠.

때때로 조직의 반대편에 있는 부서가 서로 다른 기술 언어를 사용하더라도 협력하는 것이 필수적입니다. 교차 기능 팀에서 일해 본 적이 있다면 모두가 동일한 정보를 공유하는 것이 얼마나 어려운지 알 것입니다. 

소프트웨어 요구 사항 사양 문서는 프로젝트 매니저, 제품 매니저 및 비즈니스 애널리스트가 개발 프로세스에서 모든 팀원이 따를 수 있는 실행 과제로 상위 수준의 개념을 세분화하는 데 도움이 될 수 있습니다. 

소프트웨어 요구 사항 사양 문서(SRS)란 무엇인가요?

소프트웨어 요구 사항 사양(SRS) 문서는 향후 프로젝트의 요구 사항, 기대치, 설계 및 표준을 나열합니다. 여기에는 프로젝트의 목표를 결정하는 전반적인 비즈니스 요구 사항, 최종 사용자의 요구 사항 및 필요, 기술적인 측면에서 제품의 기능이 포함됩니다. 간단히 말해서, SRS는 소프트웨어 제품이 어떻게 작동해야 하는지, 그리고 개발 팀이 어떻게 작동해야 하는지에 대한 자세한 설명을 제공합니다.

앱에 대한 훌륭한 아이디어가 있다고 상상해 보세요. 원하는 기능과 모양에 대한 비전이 있지만, 개발자에게 구두로 설명하고 기대에 부응하기를 기대할 수는 없다는 것을 알고 있습니다. 바로 이럴 때 SRS가 필요합니다.

SRS를 사용해야 하는 이유는 무엇일까요?

개발자가 새로운 제품을 만들 때 명확한 지침을 가지고 있지 않으면, 소프트웨어가 생각했던 것과 일치하도록 하기 위해 예상보다 더 많은 시간과 비용을 지출하게 될 수 있습니다. 

SRS 문서를 작성하면 아이디어를 종이에 적고 명확한 요구 사항 목록을 설정하는 데 도움이 됩니다. 이 문서는 제품의 유일한 정보 소스가 되므로 마케팅에서 유지 관리에 이르기까지 모든 팀이 동일한 정보를 공유할 수 있습니다. 

소프트웨어 요구사항 사양은 살아있는 문서이기 때문에 제품 개발 프로세스에 관련된 모든 이해관계자 간의 커뮤니케이션 지점으로도 작용할 수 있습니다. 모든 소프트웨어 개발 프로젝트에서 제품 반복이 발생할 수 있습니다. SRS의 변경 사항을 기록하면 모든 당사자가 문서에서 이를 검증할 수 있습니다. 이렇게 하면 제품 요구 사항과 관련된 혼란을 줄일 수 있습니다. 

SRS 문서에 포함해야 하는 내용

기본 SRS 문서 개요는 소개, 시스템 및 기능 요구 사항, 외부 인터페이스 요구 사항, 비기능적 요구 사항의 네 부분으로 구성됩니다.

1. 소개

SRS 서론은 전체 프로젝트를 10,000피트 높이에서 바라보는 것과 같습니다. 소개를 작성할 때 제품의 목적, 대상 고객, 대상 고객이 제품을 사용하는 방법을 설명합니다. 소개에는 다음을 포함해야 합니다.

• 제품 범위: 범위는 제품의 전반적인 비즈니스 목표와 관련이 있어야 하며, 여러 팀이나 계약자가 문서에 액세스할 수 있는 경우 특히 중요합니다. 제품의 이점, 목표, 목적을 나열하세요. 

• 제품 가치: 제품이 중요한 이유는 무엇인가요? 대상 고객에게 어떤 도움이 될까요? 어떤 기능을 제공하거나 어떤 문제를 해결할까요? 대상 고객이 제품에서 가치를 어떻게 찾을 수 있는지 자문해 보세요. 

• 대상 고객: 이상적인 고객을 설명합니다. 이들은 제품의 외관과 느낌, 마케팅 방법을 결정합니다. 

• 용도: 대상 고객이 제품을 어떻게 사용할지 상상해 보세요. 제공하는 기능과 잠재 고객의 역할에 따라 제품을 사용할 수 있는 모든 가능한 방법을 나열합니다. 비전을 설명하기 위해 사용 사례를 포함하는 것도 모범 사례입니다.

• 정의 및 약어: 모든 산업 또는 비즈니스에는 고유한 약어 또는 전문 용어가 있습니다. 모든 당사자가 여러분이 말하고자 하는 내용을 이해할 수 있도록 SRS에서 사용하는 용어의 정의를 작성하세요.

• 목차: 철저한 SRS 문서는 매우 길 수 있습니다. 모든 참가자가 원하는 것을 정확하게 찾을 수 있도록 목차를 포함하세요. 

소개가 명확하고 간결한지 확인하세요. 소개는 나머지 SRS 개요에 대한 가이드가 되며, 문서를 사용하는 모든 사람이 동일한 방식으로 해석하기를 원한다는 점을 기억하세요.

2. 시스템 요구 사항 및 기능 요구 사항

소개를 마쳤다면 이제 더 구체적으로 설명할 차례입니다. 기능 요구 사항은 시스템이 의도한 대로 작동할 수 있도록 시스템 기능과 기능을 세분화합니다. 

개요를 참조하여 세부 정보를 입력할 때 요구 사항이 사용자의 기본 요구 사항을 충족하는지 확인합니다. 제품에 따라 포함해야 하는 기능 요구 사항은 수천 가지가 있습니다. 가장 일반적인 요구 사항은 다음과 같습니다.

• If/then 동작

• 데이터 처리 로직

• 시스템 워크플로

• 거래 처리

• 관리 기능

• 규제 및 규정 준수 요구 사항

• 성과 요건

• 모든 화면에 대해 수행된 작업의 세부 정보

이것이 부담스럽게 느껴진다면 한 번에 하나의 요구 사항을 해결해 보세요. SRS 문서에 세부 정보를 더 많이 포함할수록 나중에 문제 해결을 위해 해야 할 일이 줄어듭니다. 

자세한 요구 사항을 살펴보면서 지원 자료를 일관되고 따르기 쉽게 유지하는 것도 중요합니다. 기술 문서 템플릿을 사용하면 시간을 절약하고, 오류를 줄이며, 개발자부터 최종 사용자에 이르기까지 모든 사람이 명확하고 최신 지침을 확인할 수 있습니다.

3. 외부 인터페이스 요구 사항

외부 인터페이스 요구 사항은 시스템이 다음과 같은 외부 구성 요소와 제대로 통신할 수 있도록 하는 기능 요구 사항의 유형입니다.

• 사용자 인터페이스: 내용 프레젠테이션, 애플리케이션 탐색 및 사용자 지원과 같은 구성 요소 중에서 애플리케이션 사용성의 핵심입니다.

• 하드웨어 인터페이스: 지원되는 디바이스 유형 및 커뮤니케이션 프로토콜과 같이 시스템의 소프트웨어 및 하드웨어 구성 요소 간의 각 인터페이스의 특성입니다.  

• 소프트웨어 인터페이스: 데이터베이스, 라이브러리, 운영 체제를 포함한 제품과 다른 소프트웨어 구성 요소 간의 연결. 

• 커뮤니케이션 인터페이스: 이메일이나 내장된 양식과 같이 제품에서 사용할 커뮤니케이션 기능에 대한 요구 사항입니다. 

임베디드 시스템은 외부 인터페이스 요구 사항에 의존합니다. 화면 레이아웃, 버튼 기능, 제품이 다른 시스템에 어떻게 의존하는지에 대한 설명과 같은 사항을 포함해야 합니다. 

4. 비기능적 요구 사항(NRF)

SRS의 마지막 섹션에서는 비기능적 요구 사항에 대한 세부 정보를 제공합니다. 기능적 요구 사항은 시스템에 무엇을 해야 하는지 알려주는 반면, 비기능적 요구 사항(NFR)은 시스템이 이러한 기능을 구현하는 방법을 결정합니다. 예를 들어, 기능적 요구 사항은 고객이 제품을 주문할 때 시스템에 포장 전표를 인쇄하도록 지시할 수 있습니다. NFR은 포장 전표가 포장 전표의 표준 크기인 4”x6” 흰색 용지에 인쇄되도록 합니다. 

NFR을 충족하지 않아도 시스템이 작동할 수 있지만, 사용자 또는 이해관계자의 기대를 저버릴 위험이 있습니다. 이러한 요구 사항은 기능적 요구 사항을 확인할 수 있도록 유지하므로 제품의 경제성 및 사용 편의성과 같은 속성이 여전히 포함됩니다. 

가장 일반적인 NFR 유형은 'Itys'라고 합니다. 그들은 다음과 같습니다.

• 보안: 소프트웨어가 사용자로부터 수집한 민감한 정보가 보호되도록 하는 데 필요한 사항. 

• 작업 수용량: 증가하는 볼륨 수요에 맞춰 시스템을 확장하는 방법에 대한 계획을 포함하여 제품의 현재 및 미래의 저장 공간 요구 사항.

• 호환성: 운영 체제 및 버전에 대한 지원과 같은 소프트웨어의 최소 하드웨어 요구 사항. 

• 신뢰성 및 가용성: 사용자가 소프트웨어를 사용할 것으로 예상되는 빈도와 정상적인 사용 시 중요한 장애 시간이 얼마나 되는지. 

• 확장성: 시스템이 예상대로 작동하는 가장 높은 워크로드. 

• 유지 관리성: 기능과 버그 수정을 빠르게 배포할 수 있도록 애플리케이션이 지속적인 연동 또는 통합을 사용하는 방법. 

• 사용성: 제품을 사용하는 것이 얼마나 쉬운지 나타냅니다. 

기타 일반적인 비기능적 요구 사항에는 성능, 규제 및 환경 요구 사항이 포함됩니다. 

소프트웨어 요구 사항 문서 템플릿

소프트웨어 개발 벤처를 시작할 준비가 되셨나요? Asana의 SRS 템플릿은 훌륭한 SRS 문서의 4가지 핵심 구성 요소를 모두 설명하여 회원님과 팀이 개발할 제품에 대한 귀중한 인사이트를 제공합니다. 모든 당사자가 동일한 비전을 염두에 둘 수 있도록 요구 사항을 상세하고 명확하며 간결하게 유지해야 합니다.

SRS 문서를 작성하기 위한 모범 사례

SRS의 목적은 모든 부서의 각 팀이 명확한 목표를 향해 노력하도록 하는 것입니다. 그렇지만 SRS가 그 목적을 달성할 수 있도록 하기 위해 따라야 할 몇 가지 모범 사례가 있습니다.

시각 자료로 SRS 보강하기

다이어그램, 도식, 모델과 같은 시각 자료를 포함하면 팀원들이 프로세스를 더 잘 이해할 수 있습니다. 이는 소프트웨어의 주요 기능과 작동 방식을 설명할 때 특히 유용합니다. 

프로젝트에 대한 브레인스토밍을 하는 동안 시도할 수 있는 한 가지 기법은 아이디어, 기능, 시나리오를 구성하고 이들 사이의 연결 고리를 그리는 마인드 매핑입니다. 아이디어를 조합하기 시작할 때 무작위 생각을 구조화하기 위해 마인드 맵을 만드세요. 이 시각 자료는 매우 상세할 필요는 없습니다. 그것이 바로 SRS의 목적입니다. 대신, 소프트웨어의 핵심 기능과 이러한 기능들이 서로 어떻게 관련되어 있는지에 집중하세요.

명확하고 간결하게 유지하세요

제품을 구축할 때 개발자가 스스로를 의심하는 것은 가장 피하고 싶은 일입니다. 팀원이 창의력을 발휘하고 빈칸을 채울 수 있는 여지를 남겨두지 마세요. 소프트웨어 요구 사항을 설명할 때 가능한 한 많은 세부 정보를 포함하고 다음을 피하세요.

• 일반적으로 또는 대략적으로 와 같은 모호한 단어 사용

• ‘/’로 용어를 결합하는 것(��및’ 또는 ‘또는’으로 해석될 수 있음)

• 복잡한 경계 값 사용

• 이중 및 삼중 부정문 사용

공식적인 동료 검토는 SRS 문서의 모호함을 정확히 파악하는 좋은 방법입니다. 각 참가자와 함께 요구사항에 대한 이해도를 비교하고 필요한 사항을 변경할 계획을 세우세요. 

최종 사용자를 파악하세요

SRS에 필드 리서치와 사용자 인터뷰를 추가하여 최종 사용자의 요구 사항, 기대치, 니즈를 명확히 이해하세요. 이렇게 하면 최종 사용자가 소프트웨어로 수행할 작업을 시각화하는 데 도움이 됩니다. 발생할 수 있는 모든 가능한 시나리오와 뉘앙스를 고려하고 이를 SRS에 포함하세요. 개발자는 문서에 포함된 내용을 정확히 구현합니다. 

유연성을 위한 여유를 포함

SRS는 계속 업데이트되는 살아있는 문서입니다. 즉, 매번 새로운 기능과 수정 사항을 추가하게 됩니다. 결과가 기대에 미치지 못하는 경우를 대비하여 요구 사항을 유연하게 유지하세요. 오해를 피하기 위해 문서 변경 사항을 기록하는 것도 모범 사례입니다. 참여자는 각 요구 사항을 원래대로 추적하고 누가 언제, 왜 변경했는지 확인할 수 있어야 합니다. 

소프트웨어 요구 사항 문서를 사용하여 비전을 명확히 합니다

SRS를 작성하는 것은 쉽지 않지만, 끝없는 문제 해결이나 팀원 간의 논쟁을 해결하는 것도 쉽지 않습니다. 포괄적인 소프트웨어 요구 사항 사양 문서에 투자한 노력은 여러분과 이해관계자가 자랑스러워할 만한 멋진 제품으로 보답할 것입니다.