1-05 · 첫 과정 결과 검증하고 복구하기

1. 실습 목표

새 설치와 재실행에서도 첫 과정 기대값이 같고 실패 시 입력을 훼손하지 않고 복구할 수 있다는 증거를 남깁니다.

2. 시작 지점

student/04-day1-ui-ready에서 CSV → 입력 검증 → R-01–R-04 → SQLite → 대시보드·상세 흐름을 확인합니다. 이번 단계에서는 각 결과를 원본·API·SQLite와 대조하고 전체 검증을 완료합니다.

3. 구현 범위 및 요구사항

  • 설치, Python 검사, 프런트 type check·build와 API를 실제로 실행합니다.
  • 판정을 두 번 실행해 SQLite 중복이 없는지 쿼리합니다.
  • Git 상태를 확인합니다.
  • 브라우저에서 대시보드·예외·상세·저장 피드백과 API·SQLite 값이 같은지 확인하고, 모든 검증이 통과한 뒤에만 완료 상태를 표시합니다.
  • 같은 오류가 두 번 반복되거나 10분 이상 지연되면 student/05-day1-complete로 이동합니다.

4. 실습 프롬프트

Claude Code에 붙여 넣을 프롬프트
기존 기능을 다시 확인하고 모두 정상일 때만 완료 상태를 화면에 표시해 주세요.
 
현재 입력 확인, 규칙 판정, SQLite 저장과 검토 화면까지 구현되어 있지만 화면은 아직 검증 대기 상태입니다. 새로운 기능을 추가하지 말고 지금까지 만든 흐름이 함께 동작하는지 확인해 주세요.
 
모든 확인이 끝난 뒤에만 사용자가 구현 완료 상태를 화면에서 확인할 수 있어야 합니다. 하나라도 실패하면 완료로 표시하지 말고 원인을 남겨 주세요.
 
- 기존 검사 명령과 판정 API 재실행 수행
- API 결과와 SQLite 저장 결과의 일치 여부 확인
- 입력 CSV와 생성 DB의 Git 제외 상태 확인
- 모든 확인 통과 후 완료 카드와 진행 상태 갱신
- 실패 시 재현 명령과 기존 데이터를 보존하는 복구 방법 기록
- 기존 입력, 판정, 저장과 검토 동작 변경 금지
 
구현 후에는 변경 파일, 실제 API와 SQLite 상태, 검사 통과 여부와 남은 위험만 간단히 알려 주세요.

5. 예상 결과

Success

  • 체크포인트: student/05-day1-complete

    전체유효정상검토 필요입력 오류
    30292181
  • 예외 8건과 CHG-2608-030 확인

  • 두 번 실행해도 SQLite 결과 중복 없음

  • CSV 6종 유지, 실행 중 생성되는 DB·로그 미추적

  • 전체 검사 통과 후 05에서 첫 과정 완료와 5개 완료 항목 확인

6. 대표 실패 사례 및 복구

Failure

  • 개발 서버가 떠 있다는 이유로 검사·빌드를 생략함
  • 이전 DB를 현재 실행 결과로 오해함
  • 확인하지 못한 화면을 성공으로 기록함

다시 검사하는 방법

  1. 백엔드와 프런트엔드를 실행한 두 터미널에서 각각 Ctrl+C를 눌러 종료합니다.
  2. 새 PowerShell 터미널을 ai-coding-class-pwc-practice 저장소의 최상위 폴더에서 엽니다.
  3. 아래 명령으로 practice/workspace에 들어가 전체 검사를 실행합니다.
cd practice/workspace
npm run check

npm run check가 Python 검사, 백엔드 테스트, 프런트엔드 type check와 build를 차례로 실행합니다. 모두 통과하면 다시 검사가 끝난 것입니다. 같은 오류가 두 번 반복되면 현재 작업을 별도 폴더에 복사한 뒤 복구 안내에 따라 student/05-day1-complete를 적용합니다.

직접 확인할 결과

  1. 04-day1-ui-ready에서 집계·예외·상세·저장 결과를 원본·API·SQLite와 대조합니다.
  2. 검사 중 하나를 의도적으로 중단하거나 백엔드를 멈춰 오류 상태와 복구 절차를 확인합니다.
  3. 모든 검사가 통과한 뒤 05-day1-complete에서 첫 과정 완료와 5개 완료 항목을 확인합니다.
  4. 모집단 30건, 유효 29건, 정상 21건, 검토 필요 8건, 입력 오류 1건이 최종 화면과 일치하는지 확인합니다.

7. 다음 실습

코딩 결과를 자신의 업무로 옮겨 업무 흐름·Agent 후보 Action Plan을 작성합니다.