관리자 대시보드를 의뢰할 때 요구사항은 어떤 틀로 정리해야 할까요?
관리자 대시보드 요구사항은 누가 쓰는지, 그 사람이 무엇을 보고 처리하는지, 누가 어디까지 바꿀 수 있는지를 화면 단위로 적는 틀로 정리하면 됩니다. 이 글은 그대로 옮겨 쓸 수 있는 문서 틀과 칸을 채우는 요령을 정리합니다.
탱탱소프트
관리자 대시보드 요구사항은 화면 그림보다 사용하는 사람과 그 사람이 끝내야 하는 일, 완료 기준, 권한을 한 문서에 적는 틀로 정리할 수 있습니다. 이 글은 운영팀장이 의뢰 전에 채워 볼 수 있는 문서 틀과 채우는 요령을 제안합니다.
요구사항은 왜 화면이 아니라 사용자부터 적나요?
화면부터 그리면 버튼과 표의 모양은 정해지지만, 그 화면을 누가 왜 여는지는 빠질 수 있습니다. 영국 정부의 GOV.UK 서비스 매뉴얼 중 사용자 스토리 작성 안내는 요구를 "누가, 무엇을 하려고, 왜"의 세 부분으로 적는 형식을 제시하고, 스토리에서 가장 중요한 부분은 목표라고 설명합니다. 같은 안내는 완료 기준을 서비스가 그 필요를 충족했는지 확인하는 결과 목록이라고 정의합니다.
이 형식은 영국 정부 서비스 팀을 위한 안내이므로 그대로 따라야 하는 규정은 아닙니다. 탱탱소프트는 관리자 대시보드처럼 내부 직원이 쓰는 도구에도 이 세 부분과 완료 기준을 빌려 쓰기를 권합니다. 사용하는 사람이 한 명뿐인 작은 관리 화면이라면 문장 몇 줄로 줄여도 됩니다.
관리자 대시보드 요구사항 문서는 어떤 틀로 쓰나요?
아래 틀은 이 글에서 제안하는 구성입니다. 칸 이름은 회사 사정에 맞게 바꿔도 됩니다.
- 문서 개요: 대시보드를 만드는 이유 한두 문장, 지금 같은 일을 어떤 도구로 하고 있는지(엑셀, 메신저, 기존 관리자 화면 등).
- 사용자 목록: 대시보드를 쓰는 역할마다 한 줄씩 적습니다. 사람 이름이 아니라 역할 이름으로 씁니다.
- 할 일 목록: 역할마다 "누가, 무엇을 하려고, 왜"의 형식으로 할 일을 적습니다.
- 완료 기준: 할 일마다 "이렇게 되면 끝난 것"이라고 확인할 결과를 두세 줄 적습니다.
- 화면과 데이터: 할 일을 처리하려면 어떤 목록, 상세, 입력 화면이 필요한지, 데이터는 어디에서 오는지 적습니다.
- 권한표: 역할마다 볼 수 있는 것, 고칠 수 있는 것, 지울 수 있는 것을 나눕니다.
- 기록과 알림: 누가 언제 무엇을 바꿨는지 남길 항목과, 관리자에게 알려야 할 상황을 적습니다.
- 범위 밖: 이번 의뢰에 넣지 않는 기능을 따로 적어 둡니다.
AI로 생성한 개념 이미지. 실제 사업장 사진이 아닙니다.
권한과 기록은 어떤 기준으로 적나요?
관리자 대시보드에는 고객 정보나 거래 내역처럼 아무나 보거나 바꾸면 안 되는 데이터가 모일 수 있습니다. 웹 보안 위험을 정리한 OWASP Top 10:2021의 접근 통제 실패 항목은 접근 통제를 사용자가 정해진 권한 밖에서 행동하지 못하게 하는 정책으로 설명하고, 특정 역할에만 줘야 할 접근이 누구에게나 열려 있는 상태를 흔한 취약점으로 꼽습니다. 같은 항목은 예방책으로 접근 통제 실패를 기록하고, 반복 실패처럼 필요한 경우 관리자에게 알리라고 권합니다.
요구사항 문서 단계에서는 보안 설계를 확정하지 않아도 됩니다. 다만 권한표에 역할별로 꼭 필요한 기능만 적어 두면, 개발 단계에서 기본은 막고 필요한 권한만 여는 방향으로 설계할 때 기준이 됩니다. 기록과 알림 칸도 마찬가지로 "삭제는 누가 했는지 남긴다"처럼 결과 중심으로 적고, 구현 방법은 개발 단계에서 정합니다.
AI로 생성한 개념 이미지. 실제 사업장 사진이 아닙니다.
틀을 채울 때 어떤 칸부터 확인하면 좋을까요?
탱탱소프트는 할 일 목록과 완료 기준을 먼저 채우고, 화면과 데이터 칸은 그다음에 채우기를 권합니다. 할 일이 정해지지 않은 상태에서 화면부터 적으면 필요 없는 메뉴가 늘어날 수 있기 때문입니다.
가상의 예를 들면, 주문 담당자의 할 일은 "주문 담당자로서, 오늘 들어온 주문을 상태별로 보고 싶다. 출고가 늦어지는 주문을 먼저 처리하기 위해서다."처럼 적을 수 있습니다. 완료 기준은 "오늘 날짜 주문이 상태별로 나뉘어 보인다", "상태를 바꾸면 누가 바꿨는지 기록된다"처럼 확인 가능한 결과로 씁니다. 이 예시는 문장 형식을 보여 주기 위한 것이며 실제 고객 사례가 아닙니다.
데이터 칸에서는 지금 엑셀이나 다른 프로그램에 있는 자료를 옮겨야 하는지도 함께 적습니다. 기존 자료를 옮기는 작업은 화면 개발과 별도로 범위와 일정이 잡히는 일이므로, 문서에 적혀 있어야 견적에서 빠지지 않습니다.
의뢰 전에는 무엇을 준비하면 되나요?
위 틀을 다 채우지 못해도 상담은 시작할 수 있습니다. 사용자 목록과 할 일 몇 줄, 지금 쓰고 있는 엑셀 양식이나 관리 화면 캡처가 있으면 범위를 정하는 데 충분한 출발점이 됩니다. 캡처나 샘플 자료에 고객 개인정보가 보이면 가리고 전달해 주세요.
탱탱소프트는 충북 청주의 홈페이지 제작·웹개발 스튜디오이며 상담, 자료 전달, 검수를 모두 온라인으로 진행합니다. 웹개발 비용은 요구사항을 확인한 뒤 기본 구축비, 추가 1회 비용, 월 운영비를 나눠 개별로 안내합니다.
참고 자료
- Writing user stories — GOV.UK Service Manual
- A01:2021 – Broken Access Control — OWASP Top 10:2021
