| name | pre-deploy-check |
| description | Firebase 배포 직전에 type-check, lint, test, 번들 크기, 인덱스 동기화, 환경 변수, CHANGELOG 갱신을 일괄 점검한다. 사용자가 "배포 전 점검", "배포 준비", "릴리즈 준비", "배포 가능한지 확인" 등을 요청할 때 발동한다. |
배포 전 점검 (pre-deploy-check)
차량 운행일지 프로젝트의 배포 직전 루틴. 최근 커밋 기록에 "배포 전 문서 및 환경 갱신 완료"가 반복적으로 등장하는 작업을 표준화한다.
발동 조건
- 사용자가 "배포 준비", "배포 전 점검", "배포해도 되는지 확인", "릴리즈 노트 갱신" 등을 명시했을 때
firebase deploy 실행 직전chore: 배포 전 ... 커밋 직전
점검 순서 (순서 중요)
1. Node 버전 확인
node --version
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에 인덱스가 있는지 확인:
git diff master -- src/lib/firestore/ functions/src/
인덱스 누락은 운영에서만 터지는 사일런트 실패. 의심되면 사용자에게 확인 요청.
6. 환경 변수 점검
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.
