feat(settings): SMS 읽기 권한 상태/요청 위젯 추가 (Android)

- 설정 화면에 SMS 권한 카드 추가: 상태 표시(허용/미허용/영구 거부), 권한 요청/설정 이동 지원\n- 기존 알림 권한 카드 스타일과 일관성 유지

feat(permissions): 최초 실행 시 SMS 권한 온보딩 화면 추가 및 Splash에서 라우팅 (Android)

- 권한 필요 이유/수집 범위 현지화 문구 추가\n- 거부/영구거부 케이스 처리 및 설정 이동

chore(codex): AGENTS.md/체크 스크립트/CI/프롬프트 템플릿 추가

- AGENTS.md, scripts/check.sh, scripts/fix.sh, .github/workflows/flutter_ci.yml, .claude/agents/codex.md, 문서 템플릿 추가

refactor(logging): 경로별 print 제거 후 경량 로거(Log) 도입

- SMS 스캐너/컨트롤러, URL 매처, 데이터 리포지토리, 내비게이션, 메모리/성능 유틸 등 핵심 경로 치환

feat(exchange): 환율 API URL을 --dart-define로 오버라이드 가능 + 폴백 로깅 강화

test: URL 매처/환율 스모크 테스트 추가

chore(android): RECEIVE_SMS 권한 제거 (READ_SMS만 유지)

fix(lints): dart fix + 수동 정리로 경고 대폭 감소, 비동기 context(mounted) 보강

fix(deprecations):\n- flutter_local_notifications의 androidAllowWhileIdle → androidScheduleMode 전환\n- WillPopScope → PopScope 교체

i18n: SMS 권한 온보딩/설정 문구 현지화 키 추가
This commit is contained in:
JiWoong Sul
2025-09-07 21:32:16 +09:00
parent d1a6cb9fe3
commit d37f66d526
53 changed files with 435 additions and 290 deletions

View File

@@ -169,7 +169,7 @@ class _AnalysisScreenState extends State<AnalysisScreen>
// 2. 총 지출 요약 카드
TotalExpenseSummaryCard(
key: ValueKey('total_expense_${_lastDataHash}'),
key: ValueKey('total_expense_$_lastDataHash'),
subscriptions: subscriptions,
totalExpense: _totalExpense,
animationController: _animationController,
@@ -179,7 +179,7 @@ class _AnalysisScreenState extends State<AnalysisScreen>
// 3. 월별 지출 차트
MonthlyExpenseChartCard(
key: ValueKey('monthly_expense_${_lastDataHash}'),
key: ValueKey('monthly_expense_$_lastDataHash'),
monthlyData: _monthlyData,
animationController: _animationController,
),

View File

@@ -13,13 +13,13 @@ class AppLockScreen extends StatelessWidget {
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Icon(
const Icon(
Icons.lock_outline,
size: 80,
color: AppColors.navyGray,
),
const SizedBox(height: 24),
Text(
const Text(
'앱이 잠겨 있습니다',
style: TextStyle(
fontSize: 24,
@@ -28,7 +28,7 @@ class AppLockScreen extends StatelessWidget {
),
),
const SizedBox(height: 16),
Text(
const Text(
'생체 인증으로 잠금을 해제하세요',
style: TextStyle(
fontSize: 16,
@@ -42,7 +42,7 @@ class AppLockScreen extends StatelessWidget {
final success = await appLock.authenticate();
if (!success && context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
const SnackBar(
content: Text(
'인증에 실패했습니다. 다시 시도해주세요.',
style: TextStyle(

View File

@@ -43,7 +43,7 @@ class _CategoryManagementScreenState extends State<CategoryManagementScreen> {
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text(
title: const Text(
'카테고리 관리',
style: TextStyle(
color: AppColors.pureWhite,
@@ -66,7 +66,7 @@ class _CategoryManagementScreenState extends State<CategoryManagementScreen> {
children: [
TextFormField(
controller: _nameController,
decoration: InputDecoration(
decoration: const InputDecoration(
labelText: '카테고리 이름',
labelStyle: TextStyle(
color: AppColors.navyGray,
@@ -82,7 +82,7 @@ class _CategoryManagementScreenState extends State<CategoryManagementScreen> {
const SizedBox(height: 16),
DropdownButtonFormField<String>(
value: _selectedColor,
decoration: InputDecoration(
decoration: const InputDecoration(
labelText: '색상 선택',
labelStyle: TextStyle(
color: AppColors.navyGray,
@@ -94,31 +94,31 @@ class _CategoryManagementScreenState extends State<CategoryManagementScreen> {
child: Text(
AppLocalizations.of(context).colorBlue,
style:
TextStyle(color: AppColors.darkNavy))),
const TextStyle(color: AppColors.darkNavy))),
DropdownMenuItem(
value: '#4CAF50',
child: Text(
AppLocalizations.of(context).colorGreen,
style:
TextStyle(color: AppColors.darkNavy))),
const TextStyle(color: AppColors.darkNavy))),
DropdownMenuItem(
value: '#FF9800',
child: Text(
AppLocalizations.of(context).colorOrange,
style:
TextStyle(color: AppColors.darkNavy))),
const TextStyle(color: AppColors.darkNavy))),
DropdownMenuItem(
value: '#F44336',
child: Text(
AppLocalizations.of(context).colorRed,
style:
TextStyle(color: AppColors.darkNavy))),
const TextStyle(color: AppColors.darkNavy))),
DropdownMenuItem(
value: '#9C27B0',
child: Text(
AppLocalizations.of(context).colorPurple,
style:
TextStyle(color: AppColors.darkNavy))),
const TextStyle(color: AppColors.darkNavy))),
],
onChanged: (value) {
setState(() {
@@ -129,13 +129,13 @@ class _CategoryManagementScreenState extends State<CategoryManagementScreen> {
const SizedBox(height: 16),
DropdownButtonFormField<String>(
value: _selectedIcon,
decoration: InputDecoration(
decoration: const InputDecoration(
labelText: '아이콘 선택',
labelStyle: TextStyle(
color: AppColors.navyGray,
),
),
items: [
items: const [
DropdownMenuItem(
value: 'subscriptions',
child: Text('구독',
@@ -171,7 +171,7 @@ class _CategoryManagementScreenState extends State<CategoryManagementScreen> {
const SizedBox(height: 16),
ElevatedButton(
onPressed: _addCategory,
child: Text(
child: const Text(
'카테고리 추가',
style: TextStyle(
color: AppColors.pureWhite,
@@ -201,7 +201,7 @@ class _CategoryManagementScreenState extends State<CategoryManagementScreen> {
title: Text(
provider.getLocalizedCategoryName(
context, category.name),
style: TextStyle(
style: const TextStyle(
color: AppColors.darkNavy,
),
),

View File

@@ -111,7 +111,7 @@ class _DetailScreenState extends State<DetailScreen>
Text(
AppLocalizations.of(context)
.changesAppliedAfterSave,
style: TextStyle(
style: const TextStyle(
fontSize: 14,
color: AppColors.darkNavy,
),

View File

@@ -5,7 +5,6 @@ import '../providers/notification_provider.dart';
import 'dart:io';
import '../services/notification_service.dart';
import 'package:url_launcher/url_launcher.dart';
import '../theme/adaptive_theme.dart';
import '../widgets/glassmorphism_card.dart';
import '../theme/app_colors.dart';
import '../widgets/native_ad_widget.dart';
@@ -230,6 +229,7 @@ class SettingsScreen extends StatelessWidget {
if (granted) {
await provider.setEnabled(true);
} else {
if (!context.mounted) return;
AppSnackBar.showError(
context: context,
message: AppLocalizations.of(context)
@@ -273,7 +273,7 @@ class SettingsScreen extends StatelessWidget {
elevation: 0,
color: Theme.of(context)
.colorScheme
.surfaceVariant
.surfaceContainerHighest
.withValues(alpha: 0.3),
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(12),
@@ -414,7 +414,7 @@ class SettingsScreen extends StatelessWidget {
decoration: BoxDecoration(
color: Theme.of(context)
.colorScheme
.surfaceVariant
.surfaceContainerHighest
.withValues(alpha: 0.3),
borderRadius:
BorderRadius.circular(8),
@@ -484,49 +484,77 @@ class SettingsScreen extends StatelessWidget {
margin:
const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
padding: const EdgeInsets.all(8),
child: FutureBuilder<bool>(
future: SMSService.hasSMSPermission(),
child: FutureBuilder<permission.PermissionStatus>(
future: permission.Permission.sms.status,
builder: (context, snapshot) {
final hasPermission = snapshot.data ?? false;
final isLoading =
snapshot.connectionState == ConnectionState.waiting;
final status = snapshot.data;
final hasPermission = status?.isGranted ?? false;
final isPermanentlyDenied =
status?.isPermanentlyDenied ?? false;
return ListTile(
leading: const Icon(
Icons.sms,
color: AppColors.textSecondary,
),
title: const Text(
'SMS 권한',
style: TextStyle(color: AppColors.textPrimary),
title: Text(
AppLocalizations.of(context).smsPermissionLabel,
style: const 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),
subtitle: !hasPermission
? Text(
isPermanentlyDenied
? AppLocalizations.of(context)
.permanentlyDeniedMessage
: AppLocalizations.of(context)
.smsPermissionRequired,
style: const TextStyle(
color: AppColors.textSecondary),
)
: 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),
),
: null,
trailing: isLoading
? const SizedBox(
width: 20,
height: 20,
child:
CircularProgressIndicator(strokeWidth: 2),
)
: hasPermission
? const Padding(
padding:
EdgeInsets.symmetric(horizontal: 8.0),
child: Icon(Icons.check_circle,
color: Colors.green),
)
: isPermanentlyDenied
? TextButton(
onPressed: () async {
await permission.openAppSettings();
},
child: Text(
AppLocalizations.of(context)
.openSettings),
)
: ElevatedButton(
onPressed: () async {
final granted = await SMSService
.requestSMSPermission();
if (!granted) {
final newStatus = await permission
.Permission.sms.status;
if (newStatus.isPermanentlyDenied) {
await permission.openAppSettings();
}
}
if (context.mounted) {
(context as Element).markNeedsBuild();
}
},
child: Text(AppLocalizations.of(context)
.requestPermission),
),
);
},
),

View File

@@ -63,18 +63,18 @@ class _SmsPermissionScreenState extends State<SmsPermissionScreen> {
context: context,
builder: (_) => AlertDialog(
title: Text(loc.smsPermissionRequired),
content: const Text('권한이 영구적으로 거부되었습니다. 설정에서 권한을 허용해주세요.'),
content: Text(loc.permanentlyDeniedMessage),
actions: [
TextButton(
onPressed: () => Navigator.of(context).pop(),
child: const Text('닫기'),
child: Text(AppLocalizations.of(context).cancel),
),
TextButton(
onPressed: () async {
await permission.openAppSettings();
if (mounted) Navigator.of(context).pop();
},
child: const Text('설정 열기'),
child: Text(loc.openSettings),
),
],
),
@@ -95,7 +95,7 @@ class _SmsPermissionScreenState extends State<SmsPermissionScreen> {
const Icon(Icons.sms, size: 64, color: AppColors.primaryColor),
const SizedBox(height: 16),
Text(
'SMS 권한 요청',
loc.smsPermissionTitle,
style: Theme.of(context).textTheme.headlineSmall?.copyWith(
color: AppColors.textPrimary,
fontWeight: FontWeight.bold,
@@ -112,16 +112,16 @@ class _SmsPermissionScreenState extends State<SmsPermissionScreen> {
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('결제 관련 문자 메시지(서비스명/금액/날짜 패턴)를 로컬에서만 처리합니다.'),
children: [
Text(loc.smsPermissionReasonTitle,
style: const TextStyle(fontWeight: FontWeight.bold)),
const SizedBox(height: 8),
Text(loc.smsPermissionReasonBody),
const SizedBox(height: 12),
Text(loc.smsPermissionScopeTitle,
style: const TextStyle(fontWeight: FontWeight.bold)),
const SizedBox(height: 8),
Text(loc.smsPermissionScopeBody),
],
),
),
@@ -131,15 +131,15 @@ class _SmsPermissionScreenState extends State<SmsPermissionScreen> {
child: ElevatedButton.icon(
onPressed: _requesting ? null : _handleRequest,
icon: const Icon(Icons.lock_open),
label:
Text(_requesting ? '요청 중...' : loc.requestPermission),
label: Text(
_requesting ? loc.requesting : loc.requestPermission),
),
),
const SizedBox(height: 8),
TextButton(
onPressed: () => Navigator.of(context)
.pushReplacementNamed(AppRoutes.main),
child: const Text('나중에 하기'),
child: Text(loc.later),
)
],
),

View File

@@ -1,5 +1,4 @@
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import '../controllers/sms_scan_controller.dart';
import '../widgets/sms_scan/scan_loading_widget.dart';
import '../widgets/sms_scan/scan_initial_widget.dart';

View File

@@ -277,13 +277,13 @@ class _SplashScreenState extends State<SplashScreen>
.withValues(alpha: 0.3),
width: 1.5,
),
boxShadow: [
boxShadow: const [
BoxShadow(
color:
AppColors.shadowBlack,
spreadRadius: 0,
blurRadius: 30,
offset: const Offset(0, 10),
offset: Offset(0, 10),
),
],
),
@@ -398,7 +398,7 @@ class _SplashScreenState extends State<SplashScreen>
width: 1,
),
),
child: CircularProgressIndicator(
child: const CircularProgressIndicator(
valueColor: AlwaysStoppedAnimation<Color>(
AppColors.pureWhite),
strokeWidth: 3,