STYNA는 Firebase Hosting과 Firebase Functions로 배포합니다. 배포 전에는 TypeScript, ESLint, Jest, Functions 빌드, Next 빌드를 npm 스크립트로 묶어 확인합니다.

기준: 2026.09 개발 기록

검증과 배포 흐름

deploy:firebase는 배포 전에 verify를 먼저 실행합니다. 타입, 린트, 테스트, Functions 빌드, Next 빌드가 통과해야 배포가 이어집니다.

Functions 빌드 흐름

functions:build는 먼저 sync:chat-responses를 실행한 뒤 Functions 빌드를 수행합니다.

npm run sync:chat-responses
cd functions
npm run build

이 흐름은 채팅 fallback 응답 데이터를 Functions 코드에서 사용할 수 있게 동기화하기 위한 구조입니다.

검증 항목

개발 기록의 테스트는 UI 컴포넌트, 서비스 레이어, API proxy, Functions 도메인 로직을 나누어 검증합니다.

개발 기록에 포함된 테스트와 명령을 정리한 목록입니다.

• 대표 테스트 파일과 범위

ESLint와 TypeScript 기준

Next 15 환경에 맞춰 ESLint CLI를 사용합니다. 빌드 산출물과 외부 산출물은 lint 대상에서 제외합니다.

verify에서는 npm run lint -- --max-warnings=0을 사용해 warning도 남기지 않는 것을 목표로 합니다.

운영상 주의점

• .env와 Firebase Secrets 값은 문서나 코드에 직접 노출하지 않습니다.
• OPENAI_API_KEY는 Functions Secret에서 사용합니다.
• 배포 전에는 npm run verify를 기준으로 확인합니다.
• 이미지/Firestore 마이그레이션은 먼저 analyze와 dry-run을 실행한 뒤 execute를 실행합니다.