Skip to content

Release Note v1.0.2

YooJeong Hwang edited this page Jul 1, 2026 · 2 revisions

Release Note

기본 정보


배포 요약

  • 새로 디자인된 홈페이지 모바일 UI를 적용합니다.
    • 모바일 화면에서는 모바일 전용 홈 UI를 노출합니다.
    • 모바일 홈의 무료로 제작하기 버튼은 에디터로 이동하지 않고 PC 이용 안내 모달을 표시합니다.
  • 일부 모바일 기기에서 뷰포트 가드가 정상적으로 적용되지 않던 문제를 수정합니다.
    • 에디터 전용 EditorViewportGuard를 복구합니다.
    • /editor, /editor/[id]에서만 데스크톱 안내 가드가 동작하도록 범위를 명확히 분리합니다.
  • 모바일 홈 PC 안내 모달의 반응형 전환 케이스를 보완합니다.
    • 안내 모달이 열린 상태에서 데스크톱 폭으로 리사이즈하면 모달이 자동으로 닫히도록 수정합니다.
    • Escape 키로 안내 모달을 닫을 수 있도록 보완합니다.
  • 데스크톱 홈/대시보드 타이틀 및 버튼 래퍼의 스케일 정책을 조정합니다.
    • 최소 데스크톱 기준 폭인 1340px 이하에서는 scale이 더 줄어들지 않도록 수정합니다.
    • 1340px 이하에서는 레이아웃을 더 축소하지 않고 가로 스크롤 정책에 맡기도록 조정합니다.

변경 사항

✨ 신규 기능

  • 홈페이지 모바일 전용 UI 추가
image
  • 모바일 홈 PC 이용 안내 모달 추가
image
  • 에디터 전용 뷰포트 가드 복구

🐛 버그 수정

  • 일부 모바일 기기에서 에디터 뷰포트 가드가 정상 동작하지 않던 문제 수정
  • 모바일 홈에서 PC 안내 모달을 연 상태로 데스크톱 폭으로 리사이즈하면 모달이 남아 있던 문제 수정
  • 기존 전역 뷰포트 가드 제거로 인해 에디터 모바일 접근 차단이 누락될 수 있던 문제 수정

♻️ 개선 및 리팩터링

  • 에디터 뷰포트 가드를 전역 가드가 아닌 에디터 전용 가드로 분리
  • 홈 모바일 UI와 에디터 데스크톱 가드의 동작 범위 분리
  • 공통 viewport scale hook이 1340px 기준 이하로 더 축소되지 않도록 개선
  • 대시보드 타이틀 액션 래퍼가 1340px 최소 폭 스크롤 컨텐츠 기준으로 배치되도록 조정

🎨 UI/UX 변경

  • 모바일 홈 UI 추가
  • 모바일 홈 CTA 클릭 시 PC 이용 안내 모달 표시
  • 에디터 모바일/좁은 화면 접근 시 데스크톱 이용 안내 화면 표시
  • 데스크톱 홈/대시보드 타이틀 및 버튼 영역의 최소 스케일 기준 조정

🔧 기타 변경

  • 홈 모바일 breakpoint와 에디터 viewport guard 기준을 1340px 기준으로 정렬
  • main merge 후 dev 브랜치 정합성 맞춤 필요

영향 범위

  • 영향받는 기능:
    • 홈페이지 /
    • 모바일 홈 UI
    • 모바일 홈 PC 안내 모달
    • 에디터 /editor, /editor/[id]
    • 에디터 viewport guard
    • 대시보드 /dashboard
    • 데스크톱 홈 CTA 영역
    • 공통 viewport scale hook
  • 사용자 영향: 보통
  • 데이터베이스 변경: 없음
  • 환경변수 변경: 없음
  • 외부 API 변경: 없음

QA 확인

  • 주요 기능 정상 동작 확인
  • 모바일 환경 확인
  • 데스크톱 환경 확인
  • 운영 환경변수 확인
  • 데이터 저장 및 조회 확인
  • 오류 로그 확인
  • 홈페이지 모바일 UI 노출 확인
  • 홈페이지 데스크톱 UI 노출 확인
  • 모바일 홈 CTA 클릭 시 PC 안내 모달 노출 확인
  • 모바일 홈 PC 안내 모달 Escape 닫기 확인
  • 모바일 홈 PC 안내 모달 오픈 후 데스크톱 리사이즈 시 모달 닫힘 확인
  • 모바일/좁은 화면에서 에디터 뷰포트 가드 노출 확인
  • 데스크톱 화면에서 에디터 정상 노출 확인
  • /faq 등 에디터 외 페이지에서 에디터 가드 미노출 확인
  • npm run build 통과
  • npm run lint -- --quiet 통과
  • git diff --check 통과

배포 결과

  • 배포 상태: -
  • 배포 URL: https://invia.co.kr/
  • 확인 사항:
    • https://invia.co.kr/ 접속 확인
    • 모바일 홈 UI 정상 노출 확인
    • 데스크톱 홈 UI 정상 노출 확인
    • 모바일 홈 PC 안내 모달 정상 동작 확인
    • 에디터 뷰포트 가드 정상 동작 확인
    • Vercel 배포 로그 확인
    • Clarity/Vercel 오류 모니터링 확인

롤백 계획

문제 발생 시 Vercel에서 이전 Production 배포로 롤백하거나, hotfix PR을 Revert합니다.

  • 롤백 기준:
    • 홈 페이지 접근 불가
    • 모바일 홈 UI 주요 동작 장애 발생
    • 에디터 접근 또는 편집 플로우 장애 발생
    • 에디터 뷰포트 가드 오동작으로 모바일/데스크톱 접근 정책이 깨지는 경우
    • 대시보드 또는 홈 CTA 영역 레이아웃이 주요 뷰포트에서 깨지는 경우
    • 운영 에러 로그 급증
  • 롤백 대상 버전:
    • 직전 Production 배포 버전
  • 롤백 방법:
    • Vercel Production Deployment를 직전 정상 배포로 Rollback
    • 필요 시 hotfix PR Revert
    • 롤백 후 main 및 dev 브랜치 정합성 확인

Clone this wiki locally