실습 과제와 포트폴리오 기초집LESSON 03
요구사항과 완료 기준: ‘만들었다’를 검증 가능한 기준으로 바꾸기
난이도입문
예상 시간35분
선수지식공개할 프로젝트 범위
3강. 요구사항과 완료 기준: ‘만들었다’를 검증 가능한 기준으로 바꾸기
1. 이번 강의에서 해결할 문제
“반응형이다”, “게임이 완성됐다”처럼 관찰 조건이 없는 문장은 완료 여부를 판단할 수 없습니다. 사용자 행동과 예상 결과가 있는 요구사항으로 바꿉니다.
2. 학습 목표
3. 핵심 개념
요구사항은 사용자가 얻을 결과이고 완료 기준은 그 결과를 확인하는 조건입니다. “localStorage를 쓴다”는 구현 방법이고 “새로고침 뒤 선택한 테마가 유지된다”가 완료 기준입니다.
4. 단계별 실습
문서 작업 · 산출물: <PROJECT_ROOT>/docs/requirements.md
docs/requirements.md
# 요구사항과 완료 기준
| ID | 사용자 요구 | 완료 기준 | 증거 | 상태 |
| --- | --- | --- | --- | --- |
| R-01 | 핵심 기능을 시작한다 | 첫 화면에서 2단계 이내에 시작된다 | media/01-start.png | 통과 |
| R-02 | 결과를 확인한다 | 성공·실패 뒤 결과가 화면에 표시된다 | 테스트 T-02 | 통과 |
| R-03 | 오류에서 회복한다 | 잘못된 입력 뒤 수정해 다시 실행할 수 있다 | 테스트 T-05 | 확인 중 |
| R-04 | 다시 사용한다 | 재시작 또는 재실행 시 초기 상태가 정상이다 | 테스트 T-07 | 통과 |
| R-05 | 제한을 안다 | README에 알려진 문제와 우회 방법이 있다 | README 제한 사항 | 통과 |
프로젝트에 맞게 R-01~R-05를 바꿉니다. 게임은 조작·게임 오버·재시작, 웹은 모바일·키보드·오류, 콘솔 프로그램은 입력·출력·잘못된 입력을 포함할 수 있습니다.
테스트 작업: 각 행을 직접 수행하고 상태를 통과, 실패, 확인 중 중 하나로 기록합니다. 실패를 통과로 바꾸지 않습니다.
완료 기준: 요구사항이 5개 이상이며 모든 행에 관찰 가능한 조건과 증거 위치가 있습니다.
5. 작성 방식이 필요한 이유
완료 기준은 개발자 기억이 아니라 다른 사람이 반복할 수 있는 판정 기준입니다. 테스트와 미디어가 같은 기준을 가리켜 과장된 설명을 줄입니다.
6. 자주 하는 실수와 해결법
7. 직접 실습
8. 이해 점검 질문 3개
9. 핵심 요약
MINI QUIZ
0 / 2요구사항과 완료 기준 점검
선택 즉시 정답과 해설을 확인할 수 있습니다. 결과는 이 브라우저에만 저장됩니다.
LESSON STATUS
3강. 요구사항과 완료 기준: ‘만들었다’를 검증 가능한 기준으로 바꾸기 미완료 상태학습을 마쳤나요?
직접 실습과 점검 질문까지 확인한 뒤 완료로 표시하세요.