기본 문서로 명세를 정하고, 만들고 검수해 완료합니다
설계 기본 3종 요구사항정의서 · 기능명세서 · 화면설계서
구현 후 검수 테스트시나리오 · 검수기준서. 중간 체크리스트는 같은 검수기준 ID를 참조하는 점검 기록입니다.
요구사항 ID → 기능·화면 ID → 검수기준 ID → 테스트·중간 체크 → 피드백·재검수로 연결합니다. 각 문서는 작성·검토·보완·확정을 거치고 같은 문서의 버전을 갱신합니다.
W01–04 요구사항 확인·합의, W05–08 기능·화면 설계·검토, W09–20 구현·중간 점검, W21–25 연계 검수, W26–30 현업 검수·전환·완료입니다. 주마다 새 문서를 만드는 계획이 아닙니다.
기존 211개 원본 페이지 파일 대응표를 입력으로 재사용합니다. 211개는 파일 수이며 실사용 화면·업무 기능 수는 미확정입니다.
양식의 재고 예약 내용은 작성 예시입니다. 실제 결과·승인·완료를 기록한 것이 아닙니다.
주차별 작업 결과와 중간 체크
| 주차 | 남길 작업 결과 | 검수기준에 따른 중간 체크 | 참조·갱신할 기본 문서 |
|---|---|---|---|
| W01 | 기존 대응표·업무 자료를 반영한 요구사항정의서 초안 | 기존 정의와 현업 추가 요구를 구분하고 출처·미확인을 표시한다. | 요구사항정의서 |
| W02 | 현업 사용·누락 확인을 반영한 요구사항정의서 검토본 | ERP·CMS의 실제 사용·누락·불일치와 범위 분류 의견을 연결한다. | 요구사항정의서 |
| W03 | 요구사항정의서 보완본과 검수 항목·합격 조건 초안 | 현재 흐름과 목표 규칙을 구분하고 요구사항마다 확인할 결과를 적는다. | 요구사항정의서 검수기준서 |
| W04 | 피드백 반영을 마친 요구사항정의서·검수 기준 및 G1 결정 | 범위·업무 규칙·미결정 책임을 검토하고 확정·보류를 구분한다. | 요구사항정의서 검수기준서 |
| W05 | 기능명세서·화면설계서 초안 | 요구사항 ID별 정상 처리·입출력·화면 요소가 연결되는지 확인한다. | 기능명세서 화면설계서 |
| W06 | 공통·ERP 기능명세 검토본과 CMS·농가·AI 설계 진행본 | 당주 D1의 규칙·상태·권한을 검토하고 API·화면 설계의 미완료를 남긴다. | 기능명세서 화면설계서 |
| W07 | 설계 검토 의견을 반영한 기능명세서·화면설계서 | 누락 동작·오류 상태·모바일 조작·합격 조건을 보완하고 재검토한다. | 기능명세서 화면설계서 검수기준서 |
| W08 | 피드백·재검토를 마친 기능명세서·화면설계서 및 G2 결정 | 개발할 규격·화면·입출력·예외·검수 기준의 버전을 확정한다. | 기능명세서 화면설계서 검수기준서 |
| W09 | 환경 구현 결과와 스키마·권한 구현 진행본 | 명세대로 기동·배포·복구할 수 있는지 증거를 확인한다. | 기능명세서 화면설계서 검수기준서 |
| W10 | ID·권한 구현 결과와 환경 시험 결과 | 완료 기능의 시나리오를 실행하고 권한·ID·초기 데이터 결과를 비교한다. | 기능명세서 테스트시나리오 검수기준서 |
| W11 | 명령·이벤트 구현본, ID·권한 시험 결과와 피드백 | 중복 요청·권한 거절·오류 회신이 합격 기준에 맞는지 확인한다. | 기능명세서 테스트시나리오 검수기준서 |
| W12 | 공통 UI·이전 도구 등 구현본과 공통 기능 시험 결과 | 화면 동작·필수 입력·공통 명령을 대조하고 발견 문제를 반영한다. | 기능명세서 화면설계서 테스트시나리오 검수기준서 |
| W13 | 고객·견적·입고 구현 진행본과 공통 UI 시험 중간 결과 | 진행 부분·미구현·실패 항목을 구분하고 보완 담당·다음 확인을 남긴다. | 기능명세서 화면설계서 테스트시나리오 검수기준서 |
| W14 | 당주 완료 기능과 공통 UI·이전 도구 시험 결과 | 명세의 정상·오류 동작을 실행하고 수정 항목은 재시험한다. | 기능명세서 화면설계서 테스트시나리오 검수기준서 |
| W15 | 고객·판매·계약·농가 등 구현본과 완료 기능 시험 결과 | 단일 기능의 입력·출력·계산·권한을 확인하고 실제 연계 전 상태를 구분한다. | 기능명세서 화면설계서 테스트시나리오 검수기준서 |
| W16 | 재고·상품·혜택·Agent 화면 구현본과 시험 결과 | 수량·금액·화면 상태가 명세와 일치하는지 중간 체크한다. | 기능명세서 화면설계서 테스트시나리오 검수기준서 |
| W17 | 운송·원가·자료·협업 등의 구현·시험 진행본 | 남은 기능과 실패·피드백을 기록하고 확인 전 완료로 닫지 않는다. | 기능명세서 테스트시나리오 검수기준서 |
| W18 | 운송·상품·Agent 등 당주 구현본과 단일 기능 시험 결과 | 검수 항목별 실제 결과·증거·문제를 기록하고 보완 후 재시험한다. | 기능명세서 화면설계서 테스트시나리오 검수기준서 |
| W19 | 주문·배송·환불·Agent 등 구현 마감과 검수 피드백 | 요구·기능·화면 누락과 차단 결함을 확인하고 반영 버전을 연결한다. | 기능명세서 화면설계서 테스트시나리오 검수기준서 |
| W20 | 기능별 시험·피드백 반영·재시험 결과와 G3 결정 | 실제 API 연결에 진입할 기능·버전·차단 결함·보류 범위를 확인한다. | 테스트시나리오 검수기준서 |
| W21 | 실제 연결 중간 결과와 전체 업무 테스트 시나리오 | 시나리오의 양쪽 ID·수량·금액·상태 대조 기준을 확인한다. | 기능명세서 테스트시나리오 검수기준서 |
| W22 | 당주 정상 연결·업무 시나리오 결과와 피드백 | 완료 연결과 진행 연결을 구분해 기대·실제·수정 사항을 남긴다. | 테스트시나리오 검수기준서 |
| W23 | 정상 연계 결과와 취소·환불·협의 흐름 시험 결과 | 최종 원본·담당자 회신·요청자 확인을 같은 기준으로 대조한다. | 테스트시나리오 검수기준서 |
| W24 | 중복·지연·장애·권한 회수·재개 시험과 수정 결과 | 원장 복구·재처리·실패 회신을 확인하고 수정 후 같은 사례를 재실행한다. | 테스트시나리오 검수기준서 |
| W25 | 8개 전체 흐름·예외 재시험 결과와 G4 결정 | 필수 검수 항목의 증거·재검수와 미해결 보류 범위를 확인한다. | 테스트시나리오 검수기준서 |
| W26 | 현업 검수·이전 리허설·운영 준비 결과와 피드백 | 현업 업무 결과·이전 대조·복구·교육의 미완료를 확인한다. | 테스트시나리오 검수기준서 |
| W27 | 현업 피드백 반영·재검수 및 전환 준비 결과와 G5 결정 | 사용 대상·버전·복구·지원 책임과 적용 보류 항목을 확인한다. | 테스트시나리오 검수기준서 |
| W28 | 본 이전·제한 적용 결과와 실제 운영 중간 체크 | 원장 대조·허용 범위·실사용 오류·중단 조건을 확인한다. | 테스트시나리오 검수기준서 |
| W29 | 제한 적용·효과 측정 결과와 발견 문제 반영·재검수 | 피드백별 조치·재검수·잔여 문제와 운영 인수 조건을 확인한다. | 테스트시나리오 검수기준서 |
| W30 | 최종 재검수·운영 인수 결과와 G6 완료 결정 | 최종 버전·필수 검수·보완 종료를 확인하고 미해결은 보류·담당·기한을 명시한다. | 테스트시나리오 검수기준서 |
요구사항정의서
무엇을 왜 만들어야 하는지, 포함·제외 범위와 수용 조건을 합의한다.
| 작성 항목 | 작성 내용 |
|---|---|
| 요구사항ID | 기능·화면·검수에서 참조할 고유 번호 |
| 요구사항명 | 사용자가 원하는 업무 |
| 상세내용 | 조건·동작·예외를 구체적으로 기록 |
| 관련기능 | 기존 기능 ID |
| 출처·요청자 | 로드맵·기존 정의·현업 요청 근거 |
| 우선순위 | 업무 책임자와 합의 |
| 검수기준ID | 어떤 결과로 충족을 판정할지 연결 |
| 상태 | 작성·검토·보완·확정 |
작성 예시 보기 · 실제 확정·실행 결과 아님
| ID | 요구사항명 | 상세 내용 | 기능 | 근거 | 우선순위 | 검수 기준 | 상태 |
|---|---|---|---|---|---|---|---|
| REQ-INV-001 | 주문 재고 예약 | 쇼핑몰 주문 시 ERP의 현재 가용량을 확인하고 예약 결과를 반영한다. | E13·C09·C12 | 로드맵 11·19p / 기존 재고·주문 범위 | 협의 전 | E13-AC01 | 검토 전 |
| REQ-INV-002 | 중복 예약 방지 | 같은 요청을 다시 전송해도 예약이 추가로 반영되지 않아야 한다. | E13·C12 | E13 완료 기준 / 중복 처리 원칙 | 협의 전 | E13-AC02 | 검토 전 |
| REQ-INV-003 | 재고 부족 처리 | 예약 요청이 가용량을 넘으면 원본을 변경하지 않고 부족 결과를 회신한다. | E13·C12 | E13·C12 업무 규칙 / 현업 확인 필요 | 협의 전 | E13-AC01 | 검토 전 |
작성 → 검토 → 피드백 반영·재검토 → 확정. 검토자·의견·조치·재확인·확정 버전을 문서에 남깁니다.
기능명세서
확정한 요구사항을 개발자가 구현할 수 있는 정상·예외 동작과 입출력으로 구체화한다.
| 작성 항목 | 작성 내용 |
|---|---|
| 기능ID·명칭 | 구현할 기능 |
| 관련요구사항 | 요구사항정의서 ID |
| 목적·범위 | 담당하는 처리와 다른 기능 경계 |
| 정상흐름 | 사용자·시스템의 처리 순서 |
| 예외흐름 | 권한·수량 부족·중복·실패 처리 |
| 입출력 | 항목·형식·필수·단위·결과 |
| 화면·API·데이터 | 관련 화면 ID와 실제 설계 위치 |
| 완료기준 | 검수기준서로 연결할 기대 결과 |
작성 예시 보기 · 실제 확정·실행 결과 아님
기본 정보
| 항목 | 내용 |
|---|---|
| 기능 ID / 기능명 | FN-INV-001 / 주문 재고 예약 |
| 관련 요구사항 | REQ-INV-001~003 / 기존 기능 E13·C12·C09 |
| 관련 화면 | SCR-INV-001 / 화면과 API 경로는 실제 설계에서 확정 |
| 목적·범위 | ERP 원장을 기준으로 가용량을 확인하고 주문 수량을 예약한다. 출고·반품·금액 환불은 별도 기능이다. |
정상 처리
| 항목 | 내용 |
|---|---|
| 1. 요청 | 허용된 주문 처리 주체가 주문 ID·품목/BL ID·요청 수량·중복 방지 ID를 전달한다. |
| 2. 확인 | ERP가 권한·현재 상태·입력 단위·최신 가용량을 확인한다. |
| 3. 반영 | 요청이 유효하면 예약을 한 번 반영하고 예약 ID·가용량·처리 결과를 회신한다. |
| 4. 표시 | 화면은 명세된 결과와 기준 시각을 표시한다. |
예외 처리
| 항목 | 내용 |
|---|---|
| 수량 부족 | 원본을 변경하지 않고 부족 사유를 회신한다. |
| 중복 요청 | 같은 요청의 기존 결과를 반환하며 추가 예약하지 않는다. |
| 권한·연결 실패 | 권한 거절 또는 결과 확인 필요 상태를 표시한다. 결과 미확인을 성공으로 표시하지 않는다. |
입출력·연계
| 항목 | 내용 |
|---|---|
| 입력 | 주문 ID / 품목·BL ID / 요청 수량·단위 / 요청 ID / 인증 주체 |
| 출력 | 예약 ID / 처리 상태 / 기준 시각 / 현재 가용량 / 실패 사유 |
| API·데이터 | 실제 API·데이터 설계 위치와 버전을 연결한다. 이 예시는 경로·필드 형식의 확정본이 아니다. |
검수 연결
| 항목 | 내용 |
|---|---|
| 판정 기준 | E13-AC01·E13-AC02 / 정상·중복·부족의 전후 원장과 회신을 대조한다. |
작성 → 검토 → 피드백 반영·재검토 → 확정. 검토자·의견·조치·재확인·확정 버전을 문서에 남깁니다.
화면설계서
화면 배치와 요소별 표시·입력·동작·상태를 명시한다.
| 작성 항목 | 작성 내용 |
|---|---|
| 화면ID·명칭 | 화면별 식별자 |
| 관련요구·기능 | 요구사항 및 기능명세 ID |
| 사용자·진입경로 | 누가 어디에서 사용하는지 |
| 화면배치 | 조회 조건·목록·입력·버튼 위치 |
| 요소정의 | 요소 ID·표시 내용·입력 검사 |
| 이벤트 | 조회·선택·저장·취소와 호출 기능 |
| 화면상태 | 빈값·처리중·성공·실패·권한 거절 |
| 검수연결 | 요소별 기대 결과·검수기준 ID |
작성 예시 보기 · 실제 확정·실행 결과 아님
화면 정보
| 항목 | 내용 |
|---|---|
| 화면 ID / 화면명 | SCR-INV-001 / 주문 재고 예약 확인 |
| 관련 요구·기능 | REQ-INV-001~003 / FN-INV-001 |
| 사용자·진입 | 허용된 주문 처리 담당자의 예약 확인 화면 예시. 실제 권한·진입 경로는 설계 검토에서 확정한다. |
요소·동작
| 항목 | 내용 |
|---|---|
| E01 품목·BL 선택 | 선택 대상과 현재 실재고·예약·가용량·기준 시각을 표시한다. |
| E02 요청 수량 | 수량과 단위를 입력받고 필수·양수 여부를 검사한다. |
| E03 예약 확인 | FN-INV-001을 호출한다. 처리 중 중복 클릭을 방지한다. |
| E04 처리 결과 | 성공 시 예약 ID·최신 가용량, 실패 시 사유·다음 행동을 표시한다. |
화면 상태
| 항목 | 내용 |
|---|---|
| 조회 전·조회 중 | 선택 안내·처리 중 상태를 구분한다. |
| 성공 | 예시 결과: 실재고 18톤 / 예약 10톤 / 가용 8톤 |
| 수량 부족 | 부족 사유와 재입력 경로를 제공하고 성공 메시지를 표시하지 않는다. |
| 권한 거절·연결 실패 | 실행 불가 또는 결과 확인 필요 안내를 표시한다. |
검수 연결
| 항목 | 내용 |
|---|---|
| 판정 기준 | E13-AC01 / 표시 값·필수 입력·중복 클릭·오류 후 재입력을 확인한다. |
작성 → 검토 → 피드백 반영·재검토 → 확정. 검토자·의견·조치·재확인·확정 버전을 문서에 남깁니다.
테스트시나리오
구현 결과를 재현 가능한 절차로 실행하고 실제 결과를 비교한다.
| 작성 항목 | 작성 내용 |
|---|---|
| 시나리오ID | 시험 사례 식별자 |
| 관련요구·기능 | 요구사항·기능·화면 연결 |
| 검수기준ID | 판정할 기준 |
| 사전조건 | 버전·역할·초기 데이터 |
| 실행절차·입력 | 재현할 순서와 값 |
| 기대결과 | 실행 전 정의한 결과 |
| 실제결과·증거 | 실행 후 기록 |
| 판정 | 미실행·통과·실패·보류 |
| 피드백·재시험 | 문제·반영 버전·재실행 결과 |
작성 예시 보기 · 실제 확정·실행 결과 아님
| 사례 | 요구·기능·화면 | 기준 | 사전조건 | 절차·입력 | 기대 결과 | 실제 결과 | 판정 | 피드백 | 재시험 |
|---|---|---|---|---|---|---|---|---|---|
| TC-INV-001 | REQ-INV-001 / FN-INV-001 / SCR-INV-001 | E13-AC01 | 실재고 18톤·예약 0톤 / 허용 사용자 | 10톤 예약 요청 → 결과 및 ERP 원본 조회 | 실재고 18·예약 10·가용 8톤 | (실제 확인 후 작성) | 미실행 | (실제 확인 후 작성) | (실제 확인 후 작성) |
| TC-INV-002 | REQ-INV-002 / FN-INV-001 | E13-AC02 | TC-INV-001과 동일한 요청 ID | 같은 예약 요청을 2회 전송 → 원본·처리 횟수 조회 | 예약 10·가용 8톤·처리 1회 | (실제 확인 후 작성) | 미실행 | (실제 확인 후 작성) | (실제 확인 후 작성) |
| TC-INV-003 | REQ-INV-003 / FN-INV-001 / SCR-INV-001 | E13-AC01 | 가용 6톤 / 허용 사용자 | 10톤 예약 요청 → 오류·원본·화면 확인 | 원본 변화 없음·부족 사유 표시 | (실제 확인 후 작성) | 미실행 | (실제 확인 후 작성) | (실제 확인 후 작성) |
작성 → 검토 → 피드백 반영·재검토 → 확정. 검토자·의견·조치·재확인·확정 버전을 문서에 남깁니다.
검수기준서
요구사항별로 어떤 상태여야 수용할 수 있는지와 확인 방법을 정한다.
| 작성 항목 | 작성 내용 |
|---|---|
| 기준ID | 체크리스트와 시험에서 참조할 번호 |
| 요구사항ID | 검수할 업무 요구 |
| 기능·화면 | 해당 기능·화면 ID |
| 검수항목 | 확인해야 하는 업무 결과 |
| 합격기준 | 수량·금액·상태·동작의 명확한 조건 |
| 확인방법·증거 | 시험·화면·원본 대조 방법 |
| 검수역할 | 확인 책임 역할 |
| 판정 | 미확인·적합·보완·보류 |
작성 예시 보기 · 실제 확정·실행 결과 아님
| 기준 | 기능 | 항목 | 기존 합격 기준 | 판정 |
|---|---|---|---|---|
| E13-AC01 | E13 | ERP 재고 원장 | 예약은 가용량에 반영하고 출고 확정은 실재고·예약에 정해진 수량을 한 번만 반영한다 | 미확인 |
| E13-AC02 | E13 | ERP 재고 원장 | 동시 주문·예약 만료·해제·출고 재전송에서도 가용량과 예약 잔액이 일치한다 | 미확인 |
| E13-AC03 | E13 | ERP 재고 원장 | 창고 이동은 전체 수량을 보존하고 수량 조정은 승인·사유·변경 전후를 기록한다 | 미확인 |
작성 → 검토 → 피드백 반영·재검토 → 확정. 검토자·의견·조치·재확인·확정 버전을 문서에 남깁니다.
검수기준을 따라가는 중간 체크리스트
각 검수 기준에서 확인할 항목을 시점별로 꺼내 점검합니다. 보완 항목은 조치·담당·기한을 남기고 같은 항목을 재검수한 뒤 완료를 확인합니다.
| 기준 | 시점 | WBS | 체크 항목 | 대상 | 실제 증거 | 판정 | 피드백 | 조치·담당·기한 | 재검수 | 완료 확인자·일자 |
|---|---|---|---|---|---|---|---|---|---|---|
| E13-AC01 | 요구사항 검토 | Q01~Q06 | 재고 원장·예약 시점·가용량 수용 조건이 요구사항에 있는가 | REQ-INV-001 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |
| E13-AC01 | 기능명세 검토 | E13-D1·D2 | 예약 전후의 실재고·예약·가용 계산과 입력 단위가 명시됐는가 | FN-INV-001 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |
| E13-AC01 | 화면설계 검토 | 관련 화면 D 작업 | 요청 수량·가용량·결과 표시와 버튼 동작이 정의됐는가 | SCR-INV-001 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |
| E13-AC01 | 구현 중간 확인 | E13-B1 | 명세의 예약 처리와 결과를 검증 환경에서 실행할 수 있는가 | 커밋·실행 결과 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |
| E13-AC01 | 기능·연계 검수 | E13-T1·I1 | 18·0·10톤 사례의 양쪽 원본과 회신이 기대값과 일치하는가 | TC-INV-001 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |
| E13-AC02 | 예외 중간 확인 | E13-T1·I2 | 중복 재전송 후 추가 예약이 없는가 | TC-INV-002 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |
| E13-AC01 | 오류 화면 확인 | 관련 화면 T 작업 | 수량 부족 시 원본 보존·오류 표시·재입력 동작이 기준에 맞는가 | TC-INV-003 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |
| E13-AC01·E13-AC02 | 피드백·완료 확인 | E13-U1 | 보완 항목의 조치·재검수와 현업 확인이 남아 있는가 | 피드백·수정 버전·재검수 결과 | (실제 확인 후 작성) | 미점검 | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) | (실제 확인 후 작성) |