앱 요구사항 문서: 앱 사양서란 무엇이고 왜 승인하나요

먼저 승인하는 한 페이지 사양서: Deployflix 블로그 글 표지

앱 요구사항 문서, 즉 앱 사양서는 누군가 앱을 만들기 전에 작성하는 짧은 계획서입니다. 누가 쓰는지, 각자 어떤 화면을 보는지, 어떤 정보를 보관하는지, 어떤 서비스와 연결되는지, 이번에 제외하는 것은 무엇인지, 빌드 비용은 최대 얼마인지 적혀 있습니다. 사양서를 읽고, 질문하고, 수정한 뒤, 실제로 원하는 앱을 설명하게 되었을 때 비로소 승인합니다.

먼저 승인하는 이유는 사양서가 실수를 찾기에 가장 저렴한 곳이기 때문입니다. 페이지의 한 줄을 옮기는 데는 비용이 들지 않습니다. 빌드가 끝난 뒤에 강사가 모든 학부모의 전화번호를 볼 수 있다거나 수강료를 분납할 수 없다는 것을 알게 되면 다시 만들어야 합니다.

소프트웨어 사양서란 쉽게 말해 무엇인가요?

소프트웨어에서 사양서(큰 프로젝트에서는 흔히 요구사항 문서, 또는 소프트웨어 요구사항 명세서의 약자인 SRS라고 부릅니다)는 앱이 필요한 사람과 앱을 만드는 사람 사이의 합의입니다. 코드가 어떻게 작동하는지가 아니라 앱이 무엇을 해야 하는지를 적습니다. 가게, 동호회, 학교라면 구체적이고 쉬운 말로 쓰기만 하면 대개 한 페이지로 충분합니다.

사양서를 시험하는 방법은 간단합니다. 서로 다른 두 제작자가 읽고 거의 같은 앱을 만들 수 있을까요? 페이지에 학생이 성적을 볼 수 있다라고 적혀 있다면 그것은 바람입니다. 학생이 전화번호로 로그인하면 본인 시험 점수를 과목별로 반 평균과 나란히 볼 수 있다라고 적혀 있다면, 누군가 만들 수 있고 본인이 확인할 수 있는 요구사항입니다.

한 페이지 앱 요구사항 문서에는 무엇이 들어가나요?

수업, 출석, 수강료를 관리할 앱이 필요한 학원을 예로 들어 보겠습니다. 이 학원에 유용한 한 페이지 사양서는 다음과 같이 구성됩니다.

사양서 항목담기는 내용학원의 예
누가 쓰나요로그인하는 사람의 유형별로 할 수 있는 일원장, 강사, 학생, 학부모. 수강료 총액은 원장만 봄
역할별 화면역할별로 보는 페이지와 그곳에서 하는 일강사: 오늘의 수업, 출석 체크, 시험 점수 입력. 학부모: 출석, 점수, 납부할 수강료
보관하는 데이터앱이 저장하는 기록과 각 기록에 담기는 내용학생, 수업, 회차별 출석, 시험과 점수, 수강료 분납과 영수증
연동연결되는 외부 서비스와 연결 방식결제 대행사를 통한 온라인 수강료 납부, 분납마다 영수증 발급
이번에는 제외이번 버전에서 하지 않는 일시간표 충돌 확인 없음, 작년 기록 가져오기 없음
비용 상한빌드 비용의 최대치작업 후의 예상치가 아니라 승인 전에 보여 주는 최대 금액

역할별 화면은 사람들이 대충 훑어보는 부분이지만 가장 중요합니다. 앱은 사실 하나의 데이터를 공유하는 여러 개의 앱입니다. 원장의 화면, 강사의 화면, 학부모의 화면이 있습니다. 역할별로 화면을 읽어야 강사는 출석을 체크할 수 있는데 잘못 체크한 것을 아무도 고칠 수 없다는 점을 알아챌 수 있습니다.

이번에는 제외 항목도 똑같이 중요합니다. 무엇을 받지 못하는지 알려 주기 때문인데, 빌드 후 실망은 대개 여기서 생깁니다. 짧고 솔직한 제외 목록은 약한 사양서가 아니라 좋은 사양서의 표시입니다.

Deployflix에 앱을 설명하면 작성되는 사양서도 이런 형식을 따릅니다. 앱을 사용하는 사람, 화면, 보관할 데이터, 이번에 제외한 항목, 빌드 비용의 최대치가 사용자가 쓴 언어로 담깁니다. 설명에 불분명한 부분이 있으면 계획하기 전에 질문합니다. 전체 단계에서 사양서가 어디에 있는지는 이용 방법에서 확인하세요.

앱 사양서는 어떻게 읽고 어떻게 질문하나요?

사양서를 계약서처럼 위에서 아래로 읽지 마세요. 비즈니스의 하루를 따라가듯 읽으세요.

  1. 역할별로 실제 하루를 따라가 보세요. 무엇을 누르고, 무엇을 보고, 무엇을 입력하나요? 다른 모든 역할도 똑같이 해 보세요.
  2. 기록 하나를 처음부터 끝까지 따라가 보세요. 학생, 주문, 예약 하나를 고르세요. 누가 만들고, 누가 바꾸고, 누가 삭제할 수 있으며, 마지막에는 어디에 남나요?
  3. 잘 안 풀리는 경우를 찾아보세요. 취소된 예약, 환불, 잘못된 입력, 실패한 결제, 탈퇴하는 회원. 사양서가 모든 일이 잘될 때만 설명한다면, 그렇지 않을 때는 어떻게 되는지 물어보세요.
  4. 인쇄할 모든 숫자와 문구를 확인하세요. 인보이스 형식, 수강료 분납, 세금 항목, 영수증 번호가 지금 일하는 방식과 맞아야 합니다. 인보이스에 GST, VAT, 판매세 같은 세금을 표시해야 한다면 세부 사항을 회계사와 확인하세요.
  5. 모호한 부분은 무엇이든 질문하세요. 관리, 추적, 쉽게, 보고서 같은 말 뒤에는 결정이 숨어 있습니다. 어떤 보고서가, 무엇을, 누구에게 보여 주는지 물어보세요.

승인하기 전에 어떤 빈틈을 찾아야 하나요?

문제가 생기는 사양서는 대부분 틀린 것이 아니라 불완전한 것입니다. 가장 자주 나타나는 빈틈은 다음과 같습니다.

누가 무엇을 볼 수 있는지

역할은 이름 붙이기도 쉽고 모호하게 두기도 쉽습니다. 각 역할이 무엇을 할 수 있는지만이 아니라 무엇을 볼 수 있는지 확인하세요. 강사가 수강료를 볼 수 있나요? 학부모가 다른 아이의 점수를 볼 수 있나요? 직원이 고객 명단을 내려받을 수 있나요? 앱이 개인정보를 보관한다면 누가 볼 수 있는지 지금 정하세요.

수정, 취소, 되돌리기

모든 기록은 언젠가 고쳐야 할 때가 옵니다. 누가 항목을 수정하거나 취소할 수 있는지, 이전 값이 보관되는지 사양서에 적혀 있는지 확인하세요.

돈

앱에서 결제를 받는다면 사양서에 결제 절차가 나와 있어야 합니다. 고객이 이용할 수 있는 결제 수단(카드 및 현지 결제 수단), 결제 대상, 일부 금액만 결제할 수 있는지, 결제 후 고객이 받는 것, 미결제나 결제 실패 시 처리 방식을 명시하세요. 환불 규정은 사업자가 결정할 사항이므로 직접 정해 적어 두세요. 결제 대행사는 보통 거래 금액의 일정 비율을 수수료로 부과하며, 많은 국가에서는 고정 수수료도 더해지므로 이용하는 서비스의 요금 페이지를 확인하세요. Deployflix로 만든 앱은 Razorpay나 캐시프리 같은 결제 대행 서비스를 통해 결제를 받으며, 국제 결제 대행 서비스도 곧 지원할 예정입니다. 현재 연결할 수 있는 서비스는 연동 페이지에서 확인할 수 있습니다.

메시지와 알림

알림을 기대한다면 이메일, 앱 내 알림, 또는 다른 방법 중 어떻게 전달되어야 하는지 적으세요. 사양서에 채널이 언급되어 있지 않다면 없는 것으로 생각하세요.

기존 데이터

스프레드시트와 예전 장부를 새 앱으로 옮겨야 하는 경우가 많습니다. 이를 가져오는 작업이 사양서에 포함되는지, 아니면 제외 목록에 있는지 물어보세요.

기기와 언어

사용자가 휴대폰, 매장 카운터의 컴퓨터 또는 두 기기 모두에서 이용하나요? 영어뿐 아니라 스페인어, 아랍어, 프랑스어 또는 다른 언어도 필요한가요? 이런 조건에 따라 화면 구성이 달라지므로 빌드 전에 결정해 주세요. Deployflix는 요청한 언어로 앱의 문구를 작성하며, 자체 화면도 41개 언어로 제공됩니다.

왜 무언가를 만들기 전에 사양서를 승인하나요?

문장 하나를 바꾸는 것이 앱을 바꾸는 것보다 저렴하기 때문입니다. 빌드 전에는 학부모 역할이나 수강료 분납을 추가하는 것이 페이지 수정에 불과합니다. 빌드 후에는 같은 변경이 이미 완성된 화면, 데이터, 권한에까지 영향을 줄 수 있습니다.

승인해 두면 완성된 앱을 대조해 볼 기준도 생깁니다. 빌드가 끝나면 사양서를 열고 역할, 화면, 데이터를 하나씩 체크해 보세요. 빠진 것이 있다면 정당하게 문제를 제기할 수 있습니다.

사양서는 진행을 결정하기 전에 비용도 명확히 해 줍니다. 사양서에 빌드의 최대 비용이 적혀 있으면 금액을 직접 확인하고 결정할 수 있습니다. Deployflix는 승인 전에 이 상한액을 표시하며, 요금 페이지의 설명처럼 실제 빌드에 사용된 만큼만 비용을 지불합니다.

앱을 만든 뒤 변경 사항은 어떻게 계획하나요?

앱이 완성되는 경우는 드뭅니다. 새 강좌, 두 번째 지점, 새로운 수강료 수납 방식 등 각각이 첫 빌드만큼 신경 쓸 가치가 있습니다.

변경 사항은 그 자체로 작은 사양서로 계획하세요. 무엇이 바뀌는지, 어떤 역할과 화면에 영향을 주는지, 어떤 데이터가 추가되거나 바뀌는지, 무엇이 그대로인지, 비용은 얼마인지 적습니다. 같은 질문으로 읽고 작업을 시작하기 전에 승인하세요. 변경이 잘못되면 잘 작동하던 버전으로 돌아갈 수 있도록 이전 버전을 보관하세요.

Deployflix는 변경 사항을 이렇게 처리합니다. 무엇을 바꿀지 말하면 변경 사항을 다음 버전으로 계획하고, 승인되기 전에는 아무것도 만들지 않습니다. 이전 버전은 모두 보관됩니다. 조직에서는 보안 페이지에서 설명하듯, 역할상 권한이 있는 사람만 승인할 수 있습니다.

바로 쓸 수 있는 앱 사양서 템플릿

사양서를 직접 쓴다면 다음 제목을 복사해 각 항목을 쉬운 문장으로 채우세요.

  • 한 문장으로 소개하는 앱: 누구를 위한 앱이고 어떤 일을 하는지.
  • 역할: 사용자 유형별로 볼 수 있는 것과 할 수 있는 일.
  • 역할별 화면: 역할마다 보는 화면과 각 화면에서 일어나는 일.
  • 보관하는 데이터: 기록의 종류와 각 기록에 담기는 세부 항목.
  • 연동: 결제, 도메인, 앱 스토어, 코드 보관 위치, 그 밖에 연결되는 모든 것.
  • 규칙: 요금, 한도, 기한, 취소와 환불.
  • 이번에는 제외: 이번 버전에서 하지 않는 일.
  • 비용 상한과 승인: 최대 비용과 최종 승인자.

역할, 화면, 데이터의 실제 예시는 학원 반 관리 시스템EN이나 클리닉 예약 앱EN을 참고하세요. 아이디어를 검증하는 창업자라면 스타트업 MVP 웹 앱EN처럼 역할 하나, 화면 몇 개, 확실한 제외 목록만으로 사양서를 더 짧게 쓸 수 있습니다.

질문

앱 사양서와 요구사항 문서는 무엇이 다른가요?

주로 분량과 형식의 차이입니다. 큰 프로젝트의 요구사항 문서는 번호가 매겨진 요구사항으로 여러 페이지에 이를 수 있습니다. 소상공인의 앱 사양서는 같은 내용(누가 쓰는지, 무엇을 하는지, 무엇을 보관하는지)을 쉬운 말로 한 페이지에 담습니다.

앱 사양서는 누가 써야 하나요?

비즈니스를 잘 아는 사람이 역할, 일상 업무, 규칙 같은 내용을 제공합니다. 제작자가 이를 체계적인 사양서로 만들 수는 있지만, 그것이 맞는지는 본인만 판단할 수 있습니다.

승인한 뒤에도 사양서를 바꿀 수 있나요?

네. 변경 사항으로 다루세요. 무엇이 달라지는지 설명하고, 업데이트된 계획을 읽고, 다시 승인합니다. 비교하거나 되돌릴 수 있도록 이전 버전을 보관하세요.

앱 사양서는 얼마나 길어야 하나요?

중요한 것이 추측에 맡겨지지 않을 만큼 길고, 끝까지 다 읽을 수 있을 만큼 짧아야 합니다. 대부분의 소상공인 앱은 한 페이지가 적당하며, 훨씬 길어진다면 단계별로 나눠 만드는 것을 고려하세요.

앱을 설명해 보세요

필요한 것을 평소 쓰는 말로 적어 주세요. Deployflix가 비용이 담긴 한 페이지 계획을 작성하고, 승인하신 후에만 만듭니다.