From f812d4b9fd1d49d069d58058a4c2291c47b9b52d Mon Sep 17 00:00:00 2001
From: JiWoong Sul <maximilian.j.sul@gmail.com>
Date: Sun, 7 Sep 2025 19:33:11 +0900
Subject: [PATCH] feat(permissions): add SMS permission screen and settings
 button; route from splash on Android

---
 android/app/src/main/AndroidManifest.xml |   4 +
 lib/routes/app_routes.dart               |  34 +++--
 lib/screens/settings_screen.dart         |  56 +++++++++
 lib/screens/sms_permission_screen.dart   | 151 +++++++++++++++++++++++
 lib/screens/splash_screen.dart           |  19 ++-
 5 files changed, 249 insertions(+), 15 deletions(-)
 create mode 100644 lib/screens/sms_permission_screen.dart

diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml
index 797fa90..8ae03d5 100644
--- a/android/app/src/main/AndroidManifest.xml
+++ b/android/app/src/main/AndroidManifest.xml
@@ -33,6 +33,10 @@
         <meta-data
             android:name="flutterEmbedding"
             android:value="2" />
+        <!-- Google AdMob App ID -->
+        <meta-data
+            android:name="com.google.android.gms.ads.APPLICATION_ID"
+            android:value="ca-app-pub-6691216385521068~6638409932" />
     </application>
     <!-- Required to query activities that can process text, see:
          https://developer.android.com/training/package-visibility and
diff --git a/lib/routes/app_routes.dart b/lib/routes/app_routes.dart
index 8346ea9..882a24f 100644
--- a/lib/routes/app_routes.dart
+++ b/lib/routes/app_routes.dart
@@ -6,6 +6,7 @@ import 'package:submanager/screens/sms_scan_screen.dart';
 import 'package:submanager/screens/analysis_screen.dart';
 import 'package:submanager/screens/settings_screen.dart';
 import 'package:submanager/screens/splash_screen.dart';
+import 'package:submanager/screens/sms_permission_screen.dart';
 import 'package:submanager/models/subscription_model.dart';
 
 class AppRoutes {
@@ -16,6 +17,7 @@ class AppRoutes {
   static const String smsScanner = '/sms-scanner';
   static const String analysis = '/analysis';
   static const String settings = '/settings';
+  static const String smsPermission = '/sms-permission';
 
   static Map<String, WidgetBuilder> getRoutes() {
     return {
@@ -25,6 +27,7 @@ class AppRoutes {
       smsScanner: (context) => const SmsScanScreen(),
       analysis: (context) => const AnalysisScreen(),
       settings: (context) => const SettingsScreen(),
+      smsPermission: (context) => const SmsPermissionScreen(),
     };
   }
 
@@ -32,29 +35,33 @@ class AppRoutes {
     switch (routeSettings.name) {
       case splash:
         return _buildRoute(const SplashScreen(), routeSettings);
-      
+
       case main:
         return _buildRoute(const MainScreen(), routeSettings);
-      
+
       case addSubscription:
         return _buildRoute(const AddSubscriptionScreen(), routeSettings);
-      
+
       case subscriptionDetail:
         final subscription = routeSettings.arguments as SubscriptionModel?;
         if (subscription != null) {
-          return _buildRoute(DetailScreen(subscription: subscription), routeSettings);
+          return _buildRoute(
+              DetailScreen(subscription: subscription), routeSettings);
         }
         return _errorRoute();
-      
+
       case smsScanner:
         return _buildRoute(const SmsScanScreen(), routeSettings);
-      
+
       case analysis:
         return _buildRoute(const AnalysisScreen(), routeSettings);
-      
+
       case settings:
         return _buildRoute(const SettingsScreen(), routeSettings);
-      
+
+      case smsPermission:
+        return _buildRoute(const SmsPermissionScreen(), routeSettings);
+
       default:
         return _errorRoute();
     }
@@ -77,15 +84,18 @@ class AppRoutes {
     );
   }
 
-  static void navigateTo(BuildContext context, String routeName, {Object? arguments}) {
+  static void navigateTo(BuildContext context, String routeName,
+      {Object? arguments}) {
     Navigator.pushNamed(context, routeName, arguments: arguments);
   }
 
-  static void navigateAndReplace(BuildContext context, String routeName, {Object? arguments}) {
+  static void navigateAndReplace(BuildContext context, String routeName,
+      {Object? arguments}) {
     Navigator.pushReplacementNamed(context, routeName, arguments: arguments);
   }
 
-  static void navigateAndRemoveUntil(BuildContext context, String routeName, {Object? arguments}) {
+  static void navigateAndRemoveUntil(BuildContext context, String routeName,
+      {Object? arguments}) {
     Navigator.pushNamedAndRemoveUntil(
       context,
       routeName,
@@ -103,4 +113,4 @@ class AppRoutes {
   static bool canPop(BuildContext context) {
     return Navigator.canPop(context);
   }
-}
\ No newline at end of file
+}
diff --git a/lib/screens/settings_screen.dart b/lib/screens/settings_screen.dart
index 8c92407..bace00b 100644
--- a/lib/screens/settings_screen.dart
+++ b/lib/screens/settings_screen.dart
@@ -12,6 +12,8 @@ import '../widgets/native_ad_widget.dart';
 import '../widgets/common/snackbar/app_snackbar.dart';
 import '../l10n/app_localizations.dart';
 import '../providers/locale_provider.dart';
+import 'package:permission_handler/permission_handler.dart' as permission;
+import '../services/sms_service.dart';
 
 class SettingsScreen extends StatelessWidget {
   const SettingsScreen({super.key});
@@ -476,6 +478,60 @@ class SettingsScreen extends StatelessWidget {
                 ),
               ),
 
+              // SMS 권한 설정
+              if (!kIsWeb && Platform.isAndroid)
+                GlassmorphismCard(
+                  margin:
+                      const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
+                  padding: const EdgeInsets.all(8),
+                  child: FutureBuilder<bool>(
+                    future: SMSService.hasSMSPermission(),
+                    builder: (context, snapshot) {
+                      final hasPermission = snapshot.data ?? false;
+                      return ListTile(
+                        leading: const Icon(
+                          Icons.sms,
+                          color: AppColors.textSecondary,
+                        ),
+                        title: const Text(
+                          'SMS 권한',
+                          style: TextStyle(color: AppColors.textPrimary),
+                        ),
+                        subtitle: Text(
+                          AppLocalizations.of(context).smsPermissionRequired,
+                          style:
+                              const TextStyle(color: AppColors.textSecondary),
+                        ),
+                        trailing: hasPermission
+                            ? const Padding(
+                                padding: EdgeInsets.symmetric(horizontal: 8.0),
+                                child: Icon(Icons.check_circle,
+                                    color: Colors.green),
+                              )
+                            : ElevatedButton(
+                                onPressed: () async {
+                                  final granted =
+                                      await SMSService.requestSMSPermission();
+                                  if (!granted) {
+                                    final status =
+                                        await permission.Permission.sms.status;
+                                    if (status.isPermanentlyDenied) {
+                                      await permission.openAppSettings();
+                                    }
+                                  }
+                                  if (context.mounted) {
+                                    // 상태 갱신을 위해 다시 build 트리거
+                                    (context as Element).markNeedsBuild();
+                                  }
+                                },
+                                child: Text(AppLocalizations.of(context)
+                                    .requestPermission),
+                              ),
+                      );
+                    },
+                  ),
+                ),
+
               // 앱 정보
               GlassmorphismCard(
                 margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
diff --git a/lib/screens/sms_permission_screen.dart b/lib/screens/sms_permission_screen.dart
new file mode 100644
index 0000000..b1dd8c3
--- /dev/null
+++ b/lib/screens/sms_permission_screen.dart
@@ -0,0 +1,151 @@
+import 'package:flutter/material.dart';
+import 'package:permission_handler/permission_handler.dart' as permission;
+import '../theme/app_colors.dart';
+import '../widgets/glassmorphism_card.dart';
+import '../routes/app_routes.dart';
+import '../l10n/app_localizations.dart';
+import '../services/sms_service.dart';
+import '../utils/platform_helper.dart';
+
+class SmsPermissionScreen extends StatefulWidget {
+  const SmsPermissionScreen({super.key});
+
+  @override
+  State<SmsPermissionScreen> createState() => _SmsPermissionScreenState();
+}
+
+class _SmsPermissionScreenState extends State<SmsPermissionScreen> {
+  bool _requesting = false;
+
+  Future<void> _handleRequest() async {
+    if (_requesting) return;
+    setState(() => _requesting = true);
+
+    try {
+      if (!PlatformHelper.isAndroid) {
+        // iOS/Web은 권한 흐름 없이 메인으로 이동
+        if (mounted) {
+          Navigator.of(context).pushReplacementNamed(AppRoutes.main);
+        }
+        return;
+      }
+
+      final status = await permission.Permission.sms.status;
+      if (status.isGranted) {
+        if (mounted) {
+          Navigator.of(context).pushReplacementNamed(AppRoutes.main);
+        }
+        return;
+      }
+
+      // 권한 요청
+      final granted = await SMSService.requestSMSPermission();
+      if (mounted) {
+        if (granted) {
+          Navigator.of(context).pushReplacementNamed(AppRoutes.main);
+        } else {
+          final newStatus = await permission.Permission.sms.status;
+          if (newStatus.isPermanentlyDenied) {
+            // 설정 열기 유도
+            _showSettingsDialog();
+          }
+          // 거부지만 영구 거부가 아니라면 그대로 대기 (사용자가 다시 시도 가능)
+        }
+      }
+    } finally {
+      if (mounted) setState(() => _requesting = false);
+    }
+  }
+
+  void _showSettingsDialog() {
+    final loc = AppLocalizations.of(context);
+    showDialog(
+      context: context,
+      builder: (_) => AlertDialog(
+        title: Text(loc.smsPermissionRequired),
+        content: const Text('권한이 영구적으로 거부되었습니다. 설정에서 권한을 허용해주세요.'),
+        actions: [
+          TextButton(
+            onPressed: () => Navigator.of(context).pop(),
+            child: const Text('닫기'),
+          ),
+          TextButton(
+            onPressed: () async {
+              await permission.openAppSettings();
+              if (mounted) Navigator.of(context).pop();
+            },
+            child: const Text('설정 열기'),
+          ),
+        ],
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final loc = AppLocalizations.of(context);
+    return Scaffold(
+      body: SafeArea(
+        child: Center(
+          child: Padding(
+            padding: const EdgeInsets.all(16.0),
+            child: Column(
+              mainAxisAlignment: MainAxisAlignment.center,
+              children: [
+                const Icon(Icons.sms, size: 64, color: AppColors.primaryColor),
+                const SizedBox(height: 16),
+                Text(
+                  'SMS 권한 요청',
+                  style: Theme.of(context).textTheme.headlineSmall?.copyWith(
+                        color: AppColors.textPrimary,
+                        fontWeight: FontWeight.bold,
+                      ),
+                ),
+                const SizedBox(height: 8),
+                Text(
+                  loc.smsPermissionRequired,
+                  textAlign: TextAlign.center,
+                  style: const TextStyle(color: AppColors.textSecondary),
+                ),
+                const SizedBox(height: 16),
+                GlassmorphismCard(
+                  padding: const EdgeInsets.all(16),
+                  child: Column(
+                    crossAxisAlignment: CrossAxisAlignment.start,
+                    children: const [
+                      Text('이유:',
+                          style: TextStyle(fontWeight: FontWeight.bold)),
+                      SizedBox(height: 8),
+                      Text('문자 메시지에서 반복 결제 내역을 분석해 구독 서비스를 자동으로 탐지합니다.'),
+                      SizedBox(height: 12),
+                      Text('수집 범위:',
+                          style: TextStyle(fontWeight: FontWeight.bold)),
+                      SizedBox(height: 8),
+                      Text('결제 관련 문자 메시지(서비스명/금액/날짜 패턴)를 로컬에서만 처리합니다.'),
+                    ],
+                  ),
+                ),
+                const SizedBox(height: 24),
+                SizedBox(
+                  width: double.infinity,
+                  child: ElevatedButton.icon(
+                    onPressed: _requesting ? null : _handleRequest,
+                    icon: const Icon(Icons.lock_open),
+                    label:
+                        Text(_requesting ? '요청 중...' : loc.requestPermission),
+                  ),
+                ),
+                const SizedBox(height: 8),
+                TextButton(
+                  onPressed: () => Navigator.of(context)
+                      .pushReplacementNamed(AppRoutes.main),
+                  child: const Text('나중에 하기'),
+                )
+              ],
+            ),
+          ),
+        ),
+      ),
+    );
+  }
+}
diff --git a/lib/screens/splash_screen.dart b/lib/screens/splash_screen.dart
index 16c8845..cea021a 100644
--- a/lib/screens/splash_screen.dart
+++ b/lib/screens/splash_screen.dart
@@ -2,6 +2,8 @@ import 'dart:async';
 import 'dart:ui';
 import 'package:flutter/material.dart';
 import '../theme/app_colors.dart';
+import '../services/sms_service.dart';
+import '../utils/platform_helper.dart';
 import '../routes/app_routes.dart';
 import '../l10n/app_localizations.dart';
 
@@ -98,9 +100,20 @@ class _SplashScreenState extends State<SplashScreen>
     }
   }
 
-  void navigateToNextScreen() {
-    // 앱 잠금 기능 비활성화: 항상 MainScreen으로 이동
-    // 모든 이전 라우트를 제거하고 홈으로 이동
+  Future<void> navigateToNextScreen() async {
+    // Android에서 SMS 권한이 없으면 권한 안내 화면으로 이동
+    if (PlatformHelper.isAndroid) {
+      final hasPermission = await SMSService.hasSMSPermission();
+      if (!hasPermission && mounted) {
+        Navigator.of(context).pushNamedAndRemoveUntil(
+          AppRoutes.smsPermission,
+          (route) => false,
+        );
+        return;
+      }
+    }
+
+    if (!mounted) return;
     Navigator.of(context).pushNamedAndRemoveUntil(
       AppRoutes.main,
       (route) => false,