[프로젝트 문서] 요구 사항 명세서란? - 요구 사항 명세서 작성법 요구사항 명세서 요약표

 

컴공이라면 프로젝트를 진행하게 되고 그 프로젝트 기능을 구현하려면 어떤 상황인지, 사용자의 니즈를 파악해야합니다. 그래서 요구사항 명세서를 작성하게 됩니다. 항상 요구사항 명세서를 작성하는게 가장 많이 걸렸던 것 같네요,,, 하지만 매번 요구사항 명세서의 양식이 다르기도 하고 헷갈려서 교수님께 다시 써오라고 한적이 있었답니다..! 그래서 어차피 제가 정리 한번은 해야할 것 같아서 제가 이해할 수 있게 작성하겠습니다!

 

 

💡 요구사항 명세서란?

요구사항 명세서란 소프트웨어 개발 프로젝트에서 사용자의 요구사항을 정의하고, 이를 개발 팀과 공유하기 위해 작성하는 문서입니다. 

이 문서는 프로젝트의 목표, 기능, 인터페이스, 제약 사항 등을 명확하게 정의하여, 프로젝트의 방향을 제시하고 이해 관계자 간의 의사소통을 원활하게 합니다.

 

 

📌 요구사항 명세서의 주요 구성 요소

1. 개요 : 프로젝트의 목적과 목표, 범위, 배경, 관련 이해 관계자 등에 대한 정보를 포함합니다.

2. 일반 요구사항 : 시스템이 가져야 하는 전반적인 기능, 성능, 인터페이스, 보안 등에 대한 요구사항을 정의합니다.

3. 상세 요구사항 : 각각의 기능이나 서비스에 대한 구체적인 요구사항을 정의합니다. 이부분은 사용자의 관점에서 시스템이 어떻게 작동해야 하는 지를 자세히 설명합니다.

4. 용어 사전 : 프로젝트에서 사용하는 용어나 약어의 정의를 제공합니다. 이는 모든 이해관계자가 같은 언어를 사용하여 의사소통하는 데 도움이 됩니다.

5. 참조 문서 : 요구사항 명세서와 관련된 다른 문서나 참고 자료의 목록을 제공합니다.

 

 

🖊️요구사항 명세서 작성 방법

1. 요구사항 수집 : 사용자 인터뷰, 설문조사, 워크숍, 문서 분석 등의 방법을 사용하여 프로젝트에 필요한 요구사항을 수집합니다.

2. 요구사항 분석 및 정의 : 수집한 요구사항을 분석하여 불명확한 점을 명확히 하고, 중복되거나 충돌하는 요구사항을 해결합니다.

3. 요구사항 문서화 : 요구사항을 체계적으로 정리하여 요구사항 명세서를 작성합니다. 각 요구사항은 명확하고 이해하기 쉬운 언어로 작성되어야 하며, 가능한 한 구체적으로 작성해야 합니다.

4. 요구사항 검토 및 승인 : 작성한 요구사항 명세서를 이해관계자에게 제공하고, 검토 및 승인을 받습니다. 이 단계에서는 요구사항이 정확하고 완전한지, 프로젝트의 목표와 일치하는 지 확인합니다.

 

요구사항 명세서는 많은 시간을 투자하는 만큼 프로젝트의 성공을 위한 핵심적인 문서입니다. 충분한 시간과 노력을 들여 작성해야합니다. 

프로젝트의 진행 과정에서 요구사항이 변경될 경우 이를 반영하여 명세서를 업데이트해야 합니다.

 

🍀 요구사항 명세서 예시

 

* 로그인 및 회원가입

개요	이 섹션에서는 사용자의 로그인 및 회원가입 기능에 대한 요구사항을 정의합니다. 이 기능들은 사용자가 서비스를 이용하기 위해 반드시 필요하며, 사용자의 개인정보 보호 및 서비스 이용에 대한 권한 제어를 제공합니다.
일반 요구사항	시스템은 사용자의 개인정보를 보호해야 합니다. 시스템은 사용자의 이메일 주소 또는 전화번호를 이용하여 회원가입을 제공해야 합니다. 시스템은 사용자에게 로그인 및 로그아웃 기능을 제공해야 합니다. 시스템은 비밀번호 재설정 기능을 제공해야 합니다.
상세 요구사항	3.1 회원가입	사용자는 이메일 주소 또는 전화번호를 입력하여 회원가입을 진행할 수 있어야 합니다. 사용자는 비밀번호를 생성하여 회원가입을 진행할 수 있어야 합니다. 사용자가 입력한 이메일 주소나 전화번호는 시스템에 이미 등록되어 있지 않아야 합니다. 사용자는 이용약관 및 개인정보 처리방침에 동의하여 회원가입을 진행할 수 있어야 합니다.
	3.2 로그인	사용자는 등록한 이메일 주소 또는 전화번호와 비밀번호를 이용하여 로그인할 수 있어야 합니다. 사용자는 '비밀번호 찾기' 기능을 통해 비밀번호를 재설정할 수 있어야 합니다.
	3.3 로그아웃	로그인한 사용자는 언제든지 로그아웃할 수 있어야 합니다.
용어사전	회원가입: 사용자가 서비스를 이용하기 위해 자신의 정보를 시스템에 등록하는 과정. 로그인: 사용자가 자신의 계정 정보를 이용하여 서비스에 접근하는 과정. 로그아웃: 로그인한 사용자가 서비스에서 나가는 과정.

위와 같이 작성하면 됩니다.

그러면 프로젝트 하나 만드는 데 로그인 및 회원가입까지 합쳐서 30개는 기본이겠죠..?ㅎㅎㅎㅎ,,,,

작성할 때마다 머리가 너무 아프더라구요ㅎㅎ,, 그치만 이렇게 미리 생각해서 코딩하면 금방 된답니다!!

무엇보다 회사에 들어가면 꼭 작성한다구 들었어요! 

꼭꼭 습득하고 가는 것이 좋습니다

 

 

아!

그리고 문서에서 요구사항 명서세서가 나오기 전에 요구사항 명세서 요약표가 있습니다!

이것도 중요합니다.

요구사항 문서 번호를 부여해주고 표로 표현한 내용입니다.

출처 : https://mklab-co.medium.com/%EC%9E%91%EC%84%B1%EB%B2%95-%EC%9A%94%EA%B5%AC%EC%82%AC%ED%95%AD-%EB%AA%85%EC%84%B8%EC%84%9C-requirements-specification-ad3533d6d5b8

 

출처 :  https://mklab-co.medium.com/%EC%9E%91%EC%84%B1%EB%B2%95-%EC%9A%94%EA%B5%AC%EC%82%AC%ED%95%AD-%EB%AA%85%EC%84%B8%EC%84%9C-requirements-specification-ad3533d6d5b8

 

위 이미지가 가장 표현이 잘 된것 같습니다!

 

 

저도 프로젝트를 하나 진행하려고 해서 요구사항 명세서를 작성해야겠습니다..... 으아