pre-deploy-check

name	pre-deploy-check
description	Firebase 배포 직전에 type-check, lint, test, 번들 크기, 인덱스 동기화, 환경 변수, CHANGELOG 갱신을 일괄 점검한다. 사용자가 "배포 전 점검", "배포 준비", "릴리즈 준비", "배포 가능한지 확인" 등을 요청할 때 발동한다.

배포 전 점검 (pre-deploy-check)

차량 운행일지 프로젝트의 배포 직전 루틴. 최근 커밋 기록에 "배포 전 문서 및 환경 갱신 완료"가 반복적으로 등장하는 작업을 표준화한다.

발동 조건

• 사용자가 "배포 준비", "배포 전 점검", "배포해도 되는지 확인", "릴리즈 노트 갱신" 등을 명시했을 때
• firebase deploy 실행 직전
• chore: 배포 전 ... 커밋 직전

점검 순서 (순서 중요)

1. Node 버전 확인

node --version  # v22.x 여야 함. v24는 Rollup 빌드 실패

22가 아니면 사용자에게 fnm use 22 실행 요청 후 중단.

2. 정적 검사 (병렬 실행 가능)

npm run type-check
npm run lint

• 에러 0건이 통과 조건. 경고(warning)는 lint-staged에서 --max-warnings=0으로 막혀 있으므로 사실상 0건이어야 함.
• 실패 시 사용자에게 보고하고 중단. 자의로 코드를 고치지 말 것.

3. 단위 테스트

npm test

• 새로 추가/수정된 코드 경로에 대한 테스트가 누락되지 않았는지 함께 확인.
• Firestore Rules를 수정했다면 npm run test:rules도 실행.

4. 번들 사이즈 점검

npm run build

• postbuild 훅이 scripts/check-bundle-size.ts로 자동 체크. 임계치 초과 시 빌드가 실패한다.
• 통과 시 dist/ 산출물 확인.

5. Firestore 인덱스 동기화

새 복합 쿼리(where + orderBy, where + where + orderBy 등)가 추가됐다면 firestore.indexes.json에 인덱스가 있는지 확인:

# 최근 변경된 firestore 쿼리 검토
git diff master -- src/lib/firestore/ functions/src/

인덱스 누락은 운영에서만 터지는 사일런트 실패. 의심되면 사용자에게 확인 요청.

6. 환경 변수 점검

# 새 VITE_* 변수가 코드에 추가됐는데 .env.local.example에 빠졌는지
git diff master -- src/ | grep -oE 'VITE_[A-Z_]+'

functions/src/에 새 process.env.* 참조가 추가됐다면 Firebase Functions 환경변수에도 설정 필요(firebase functions:config 또는 .env).

7. CHANGELOG 갱신

CHANGELOG.md에 이번 배포 분 변경사항이 반영됐는지 확인. Phase 단위 작업이면 Phase 번호 포함. 누락 시 사용자에게 작성 의사 확인 후 진행 (자동으로 임의 작성 금지).

8. Cloud Functions 헬스 체크 (선택)

npm run health

배포 후 점검 용도이지만, 직전 배포가 의심스럽거나 외부 API 의존성 변경이 있다면 사전 한 번 더.

보고 형식

각 단계 결과를 다음 형식으로 요약:

✓ Node 22.x 확인
✓ type-check 통과
✓ lint 통과 (0 errors, 0 warnings)
✓ 단위 테스트 49/49 통과
✓ 빌드 성공 (번들 크기 임계치 내)
⚠ firestore.indexes.json — 새 쿼리 X건 검토 필요: <파일:라인>
✗ CHANGELOG.md — 이번 배포 분 항목 누락

배포 가능 여부: 차단 (CHANGELOG 갱신 필요)

차단 항목이 있으면 사용자 확인 전까지 firebase deploy 제안하지 말 것.

자주 놓치는 것

• Functions index.ts export 누락 — 새 함수를 functions/src/index.ts에서 export하지 않으면 배포돼도 호출 불가.
• firestore.rules 변경 후 룰 테스트 누락 — npm run test:rules는 별도로 돌려야 한다.
• PWA 캐시 무효화 — public/sw.js나 index.html cache-control 변경 없이 배포 시 구버전이 잔존. 최근 커밋(14d59ac)에서도 발생한 패턴.
• App Check 토큰 디버그 모드 — b295455 커밋처럼 프로덕션에 debug token이 새지 않는지 빌드 산출물 grep.