From 6972cb5a63aef2fe3b2ca49526ed602e284fdd12 Mon Sep 17 00:00:00 2001
From: ByungCheol <kenneth73510@nurier.co.kr>
Date: Mon, 29 Jun 2026 09:11:17 +0900
Subject: [PATCH 1/2] =?UTF-8?q?docs(brand):=20=EC=B6=9C=EC=8B=9C=20?=
 =?UTF-8?q?=EC=A0=84=20=EB=8B=A4=EB=93=AC=EA=B8=B0=20=EC=A7=84=ED=96=89?=
 =?UTF-8?q?=EC=83=81=ED=99=A9=20=EA=B0=B1=EC=8B=A0(=EB=B9=88=EC=83=81?=
 =?UTF-8?q?=ED=83=9C=C2=B7=EC=98=A4=ED=94=84=EB=9D=BC=EC=9D=B8=C2=B7?=
 =?UTF-8?q?=EC=95=B1=EC=9E=A0=EA=B8=88=C2=B7=EC=97=90=EB=9F=AC=ED=8F=B4?=
 =?UTF-8?q?=EB=B0=B1=C2=B7=EB=92=A4=EB=A1=9C=EA=B0=80=EA=B8=B0)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 brand/LAUNCH-PROGRESS.md | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/brand/LAUNCH-PROGRESS.md b/brand/LAUNCH-PROGRESS.md
index 3f60bbf..72bf3a4 100644
--- a/brand/LAUNCH-PROGRESS.md
+++ b/brand/LAUNCH-PROGRESS.md
@@ -87,11 +87,14 @@
 
 ## 💡 출시 전 다듬기 후보 (대기 시간 활용, 선택)
 신규(빈손) 유저 경험 위주 — 저위험·고효율 순:
-1. **빈 상태 → 행동 유도** (첫 내역/계좌 추가 CTA) ⭐ 임팩트 高/노력 低
-2. **오프라인·네트워크 오류 UX 견고화** (폐쇄 테스트 대비)
-3. 첫 실행 온보딩(시작하기 카드)
-4. Play 인앱 리뷰 요청
-5. (선택) 앱 잠금(PIN/생체) — 매니페스트에 USE_BIOMETRIC 권한 존재, 구현 여부 미확인
+1. ✅ **빈 상태 → 행동 유도** (완료) — 홈 '시작하기' 카드 + 가계부내역/계좌 빈 상태 CTA. 데이터 0 계정에서만 노출
+2. ✅ **오프라인·네트워크 오류 배너** (완료) — http net:error 이벤트 + App.vue 상단 고정 배너(오프라인/서버연결실패, 새로고침 버튼)
+3. ✅ **앱 잠금(PIN)** (완료) — 자체 구현(해시 저장, 기본 OFF), 시작·복귀 시 잠금, 설정 토글+PIN설정 모달, 'PIN 분실→로그아웃' 갇힘 방지. 생체는 추후(네이티브 플러그인 필요)
+4. ✅ **전역 에러 폴백** (완료) — errorHandler + onErrorCaptured → 흰 화면 대신 '문제 발생 + 새로고침'
+5. ✅ **안드로이드 뒤로가기 개선** (완료) — 오버레이 닫기 우선 → 화면 뒤로 → 최상위 '한 번 더 누르면 종료' 토스트
+6. 첫 실행 온보딩(1번과 중복이라 보류) / Play 인앱 리뷰(플러그인 필요, 출시 후) / 생체인증(출시 후)
+
+> ⚠️ 앱 잠금은 시작 흐름을 가로채는 기능이라 **실기기 검증 권장**: 설정→앱잠금 ON→PIN 설정→백그라운드 후 복귀→잠금화면 확인→PIN 해제. (현재 설치 APK엔 미반영 — 재빌드·재설치 필요)
 
 ---
 

From b50a81028f3cad66b4bdae970cb843a84547cee1 Mon Sep 17 00:00:00 2001
From: ByungCheol <kenneth73510@nurier.co.kr>
Date: Mon, 29 Jun 2026 09:25:57 +0900
Subject: [PATCH 2/2] =?UTF-8?q?fix:=20=ED=95=98=EB=8B=A8=20=EB=82=B4?=
 =?UTF-8?q?=EB=B9=84=20=EB=92=A4=EB=A1=9C=20=EB=B2=84=ED=8A=BC=EB=8F=84=20?=
 =?UTF-8?q?=ED=95=98=EB=93=9C=EC=9B=A8=EC=96=B4=20=EB=92=A4=EB=A1=9C?=
 =?UTF-8?q?=EC=99=80=20=EB=8F=99=EC=9D=BC=20=EB=8F=99=EC=9E=91?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 통합 핸들러 appBack.handleBack 추출: 오버레이 닫기 → 화면 뒤로 →
  최상위에서 '한 번 더 누르면 종료' 토스트(네이티브)
- 하단 내비 뒤로 버튼이 옛 로직(홈에서 무반응)이라 하드웨어 뒤로와
  동작이 달랐던 문제 해결 — 둘이 같은 핸들러 사용
- capacitor.js 중복 로직 제거

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 src/capacitor.js                       | 30 ++------------------
 src/components/layout/AppBottomNav.vue |  6 ++--
 src/composables/appBack.js             | 39 ++++++++++++++++++++++++++
 3 files changed, 45 insertions(+), 30 deletions(-)
 create mode 100644 src/composables/appBack.js

diff --git a/src/capacitor.js b/src/capacitor.js
index 0605ad8..c01203c 100644
--- a/src/capacitor.js
+++ b/src/capacitor.js
@@ -1,37 +1,13 @@
 // Capacitor 네이티브(안드로이드) 통합. 웹에서는 no-op.
 import { Capacitor } from '@capacitor/core'
 import { App as CapApp } from '@capacitor/app'
-import { useUiStore } from '@/stores/ui'
-import { appLock } from '@/composables/appLock'
+import { handleBack } from '@/composables/appBack'
 
 export function setupCapacitor(router) {
   if (!Capacitor.isNativePlatform()) return
 
-  const ui = useUiStore()
-  let exitArmed = false
-  let exitTimer = null
-
-  // 안드로이드 하드웨어 뒤로가기 우선순위:
-  //   1) 잠금 화면이면 우회 불가 → 종료
-  //   2) 열린 전역 오버레이(회원가입/로그인/비번/사이드바) 닫기
-  //   3) 화면 뒤로
-  //   4) 최상위에서 한 번 더 누르면 종료(실수 종료 방지)
-  CapApp.addListener('backButton', ({ canGoBack }) => {
-    if (appLock.state.locked) { CapApp.exitApp(); return }
-
-    if (ui.signupOpen) { ui.closeSignup(); return }
-    if (ui.loginOpen) { ui.closeLogin(); return }
-    if (ui.passwordOpen) { ui.closePassword(); return }
-    if (ui.sidebarOpen) { ui.closeSidebar(); return }
-
-    if (canGoBack && window.history.length > 1) { router.back(); return }
-
-    if (exitArmed) { CapApp.exitApp(); return }
-    exitArmed = true
-    window.dispatchEvent(new CustomEvent('app:toast', { detail: '한 번 더 누르면 종료됩니다' }))
-    clearTimeout(exitTimer)
-    exitTimer = setTimeout(() => { exitArmed = false }, 2000)
-  })
+  // 안드로이드 하드웨어 뒤로가기 → 하단 내비 뒤로 버튼과 동일한 통합 처리
+  CapApp.addListener('backButton', () => handleBack(router))
 
   // 네이티브 표시용 클래스 (safe-area 등 스타일 분기)
   document.documentElement.classList.add('is-native')
diff --git a/src/components/layout/AppBottomNav.vue b/src/components/layout/AppBottomNav.vue
index b014907..862b685 100644
--- a/src/components/layout/AppBottomNav.vue
+++ b/src/components/layout/AppBottomNav.vue
@@ -1,6 +1,7 @@
 <script setup>
 import { computed } from 'vue'
 import { useRouter, useRoute } from 'vue-router'
+import { handleBack } from '@/composables/appBack'
 
 const router = useRouter()
 const route = useRoute()
@@ -9,9 +10,8 @@ const isHome = computed(() => route.path === '/')
 const isSettings = computed(() => route.path.startsWith('/settings'))
 
 function goBack() {
-  // 히스토리가 있으면 뒤로, 없으면 홈으로 (앱 첫 화면에서 빠져나가지 않게)
-  if (window.history.length > 1) router.back()
-  else router.push('/')
+  // 하드웨어 뒤로가기와 동일 동작(오버레이 닫기 → 화면 뒤로 → 최상위 종료 안내)
+  handleBack(router)
 }
 function goForward() {
   router.forward()
diff --git a/src/composables/appBack.js b/src/composables/appBack.js
new file mode 100644
index 0000000..31bf78a
--- /dev/null
+++ b/src/composables/appBack.js
@@ -0,0 +1,39 @@
+import { Capacitor } from '@capacitor/core'
+import { App as CapApp } from '@capacitor/app'
+import { useUiStore } from '@/stores/ui'
+import { appLock } from '@/composables/appLock'
+
+// 통합 뒤로가기 처리 — 하드웨어 뒤로(capacitor.js)와 하단 내비 뒤로 버튼이 동일 동작.
+// 우선순위:
+//   1) 잠금 화면이면 우회 불가 → (네이티브) 종료
+//   2) 열린 전역 오버레이(회원가입/로그인/비번/사이드바) 닫기
+//   3) 화면 뒤로(히스토리)
+//   4) 최상위에서 '한 번 더 누르면 종료'(네이티브만, 실수 종료 방지)
+let exitArmed = false
+let exitTimer = null
+
+export function handleBack(router) {
+  const native = Capacitor.isNativePlatform()
+  const ui = useUiStore()
+
+  if (appLock.state.locked) {
+    if (native) CapApp.exitApp()
+    return
+  }
+
+  if (ui.signupOpen) { ui.closeSignup(); return }
+  if (ui.loginOpen) { ui.closeLogin(); return }
+  if (ui.passwordOpen) { ui.closePassword(); return }
+  if (ui.sidebarOpen) { ui.closeSidebar(); return }
+
+  if (window.history.length > 1) { router.back(); return }
+
+  // 최상위(더 갈 곳 없음)
+  if (native) {
+    if (exitArmed) { CapApp.exitApp(); return }
+    exitArmed = true
+    window.dispatchEvent(new CustomEvent('app:toast', { detail: '한 번 더 누르면 종료됩니다' }))
+    clearTimeout(exitTimer)
+    exitTimer = setTimeout(() => { exitArmed = false }, 2000)
+  }
+}