아이디어에서 배포까지, 먼저 확인할 다섯 가지

1. 범위: 첫 버전이 할 일

가상의 견적 계산기를 만들어 봅시다. 수량, 단가, 배송비를 입력해 총액을 계산하는 개인용 도구입니다. 첫 버전에는 고객 정보 저장이나 결제 기능을 넣지 않습니다.

이 범위를 요구사항에 적고, 정답을 아는 예도 하나 남깁니다. 수량 10, 단가 12, 배송비 8을 입력하면 10 × 12 + 8 = 128이 나와야 합니다. 여러분과 AI가 계산을 확인할 공통 기준입니다.

계정, 주문, 결제가 필요하다면 각각 해결해야 할 일을 따로 적고, 현재 역량과 시간에 맞춰 버전을 나누세요.

2. 조작: 시작부터 결과까지 이어지는가

처음 보는 사람의 입장에서 페이지 열기, 항목 입력, 계산 버튼 누르기, 결과 찾기, 입력을 바꿔 다시 계산하기를 해봅니다. 단위와 금액, 안내 문구가 어디에 표시되는지도 확인하세요.

휴대전화에서도 같은 작업을 합니다. 키보드가 버튼을 가리거나 결과를 찾으려고 화면을 계속 움직여야 하는지 살펴보세요. 단계와 입력을 기록해 두면 수정할 때마다 다시 시험할 수 있습니다.

3. 오류: 사용자가 고치고 계속할 수 있는가

수량 비우기, 음수 단가, 소수 수량처럼 잘못된 입력도 넣어봅니다. 안내에는 무엇을 바꿔야 하는지 드러나야 하고, 수정한 뒤에는 계산을 계속할 수 있어야 합니다.

외부 서비스를 호출하는 프로젝트라면 실패와 시간 초과도 시험하세요. 계속 로딩만 하는지, 재시도가 가능한지, 기록이 중복 생성되는지 확인합니다. 실제 기능에 필요한 항목만 추가하면 됩니다. 정적 계산기에 사용하지 않을 서버 기능을 만들 필요는 없습니다.

4. 데이터: 무엇을 저장하고 누가 볼 수 있는가

입력이 현재 브라우저 안에만 남는지, 서버나 외부 서비스로 전송되는지 확인하세요. 업무 자료를 저장한다면 누가 조회하고 수정할 수 있는지 정하고, 서로 다른 계정으로 시험합니다.

화면에서 내용을 숨기는 것과 함께 서버에서도 조회 권한을 검사해야 합니다. 가상 고객 자료 페이지 예제를 참고해 ‘내 자료 조회’와 ‘다른 계정 자료 조회 시도’를 별도 시험 항목으로 적어보세요.

5. 배포: 실제 주소에서도 같은 작업이 되는가

프로젝트에 맞는 호스팅을 선택하고 빌드, 배포, 실행 절차를 기록합니다. 최종 주소에서 HTTPS, 모바일 화면, 주요 링크, 새로고침을 확인한 다음 원래 입력 예제를 다시 실행하세요. 서버가 있다면 운영 설정, 데이터 읽기와 쓰기, 오류를 확인하는 방법도 점검합니다.

배포 전에 작동하는 버전을 보관하고 복원 방법을 알아두세요. 업무 데이터를 바꾸는 작업이라면 적절한 백업도 필요합니다. 코드를 이전 버전으로 되돌릴 때 데이터는 어떻게 처리할지 별도로 확인하세요.

다음 수정에도 쓸 기록 남기기

요구사항, 작동하는 버전, 시험 입력, 사용 설명, 아직 해결하지 못한 문제를 남깁니다. 배포 후 사용할 사람에게 시험을 부탁하고, 멈추는 지점을 기록해 영향에 따라 수정하세요. 기능이 늘어날 때마다 관련 예제도 갱신합니다.

전체 항목은 배포 전 체크리스트에서 받을 수 있습니다. 아직 시작 단계라면 작업 설명 템플릿으로 목표와 범위를 먼저 적어보세요.

자주 묻는 질문

이어 읽기

• 처음 만드는 웹사이트 — 한 장의 요구사항부터 시작하기
• 배포 전 체크리스트 — 실제 기능에 맞는 항목 선택하기
• 프로젝트 문제를 찾는 순서 — 증상을 남기고 원인 좁히기