실습 준비

수강생은 별도 실습 저장소 ai-coding-class-pwc-practice를 새로 clone한 뒤 practice/workspace에서 작업합니다. student/00-starter에는 health와 최소 시작 화면만 있으며, Day 1에서 앱 셸·모집단·판정·저장·통합 UI를 순서대로 구현합니다.

1. 필수 프로그램 설치

Windows용 설치 파일은 공식 링크에서 받습니다. 이미 설치된 프로그램은 다시 설치하지 않습니다.

설치가 끝나면 PowerShell을 모두 닫고 새 PowerShell을 열어 버전을 확인합니다.

git --version
node --version
npm --version
python --version
claude --version

각 결과에서 Node.js는 v22.16.0, npm은 10.9.2, Python은 Python 3.14.5여야 합니다. 버전이 다르거나 명령을 찾지 못하면 다음 단계로 가지 않고 설치와 PATH를 먼저 확인합니다.

2. 저장소 clone과 의존성 설치

작업 폴더를 둘 위치에서 PowerShell을 열고 실행합니다.

git clone https://github.com/LiJe58/ai-coding-class-pwc-practice.git
cd ai-coding-class-pwc-practice
python scripts/checkpoint.py reset instructor/complete
cd practice/workspace
npm run setup
cd ../..
python scripts/checkpoint.py reset student/00-starter
cd practice/workspace
npm run check

instructor/complete에서 Python·프런트엔드 의존성을 한 번 설치한 뒤 수강생 시작점으로 전환합니다. 체크포인트 전환 시 .venv와 frontend/node_modules가 보존되므로 다시 설치하지 않습니다.

Claude Code에서 작업 폴더 열기

CLI를 사용하면 현재 practice/workspace에서 다음 명령으로 시작합니다.

# 일반
claude
or
# 모든 권한 부여
claude --dangerously-skip-permissions

나중에 다시 열 때는 저장소를 clone한 위치에서 다음처럼 실행합니다.

cd ai-coding-class-pwc-practice\practice\workspace
claude

Claude Code Desktop을 사용하면 Code 탭에서 Local을 선택하고 ai-coding-class-pwc-practice/practice/workspace 폴더를 지정합니다.

설치 또는 검사 실패

다음 단계로 가지 않습니다. 요구 버전과 현재 폴더가 맞는지 확인하고 실패한 명령, 오류의 첫 줄과 마지막 줄을 보존합니다.

3. 실행

첫 번째 터미널:

npm run start:backend

두 번째 터미널:

npm run dev:frontend

시작 상태

화면에 실습 준비 완료, 처리 영역에 정상이 보입니다. 00에는 거래처 변경 결과와 담당자 검토 기능이 없으며, 첫 실습에서 공통 앱 셸과 모집단 화면을 추가합니다.

4. 입력 원본과 시나리오 확인

체크포인트를 적용하면 input/day-1의 CSV 6종과 assets/scenario의 시나리오 기준이 작업공간에 함께 복사됩니다.

입력 원본 보존

파일을 직접 고치지 말고 애플리케이션이 읽기 전용 원본으로 사용하게 합니다.

• vendor_changes.csv
• vendor_master.csv
• change_approvals.csv
• evidence_register.csv
• payment_requests.csv
• user_roles.csv

시나리오 기준은 코드를 작성하기 전에 먼저 확인합니다.

• assets/scenario/control-card.md: 통제 목적, 연결 키, R-01–R-04 문장 기준
• assets/scenario/case-matrix.xlsx: 교육용 RCM 역할의 규칙 시트와 30건 사례 판정 시트

특히 CHG-2608-023은 승인 행이 없어서 R-02는 실패하지만 R-03·R-04는 실패가 아닌 평가 불가입니다. CSV에서 해당 행이 실제로 없는지 확인한 뒤 구현합니다.

5. 교재 사용법

1. 페이지의 결과와 업무 기준을 먼저 읽습니다.
2. 프롬프트 블록 전체를 Claude Code에 붙여 넣습니다.
3. Claude Code가 조사한 현재 상태와 변경 범위를 확인합니다.
4. 실행한 검사와 화면·API·데이터 값을 교재와 대조합니다.
5. 값이 다르면 다음 작업으로 넘어가지 않고 안전한 복구 절차를 따릅니다.

AI가 어떤 정보를 참고하고 지시를 어떤 순서로 적용하는지 헷갈리면 AI-02 · 컨텍스트 이해와 구성을 먼저 확인합니다.

Day 1 · AI 업무 이해와 검토 웹앱 만들기에서 첫 결과를 만듭니다.