huangsheng/kuaishai2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(auth): 添加启动认证功能

Browse Source 
- 在本地化文件中添加认证相关的多语言支持
- 实现密码验证逻辑和锁定机制
- 创建登录页面UI组件
- 集成路由保护，未认证用户自动重定向到登录页
- 支持密码错误次数限制和倒计时锁定功能
This commit is contained in:
Developer
2026-06-12 15:30:25 +08:00
parent 3d849bd468
commit 57badf213a
5 changed files with 350 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
CLAUDE.md
View File

@@ -163,4 +163,4 @@ AppLocalizations 支持中文(zh)和英文(en)，使用 `AppLocalizations.of(con
## 其他说明
1. 需求文档：[已确认-污水毒品快检一体机_功能需求文档.md](docs/%E5%B7%B2%E7%A1%AE%E8%AE%A4-%E6%B1%A1%E6%B0%B4%E6%AF%92%E5%93%81%E5%BF%AB%E6%A3%80%E4%B8%80%E4%BD%93%E6%9C%BA_%E5%8A%9F%E8%83%BD%E9%9C%80%E6%B1%82%E6%96%87%E6%A1%A3.md)
2. 运行设备屏幕尺寸为1920*1080(横屏),UI设计必须支持此尺寸
2. 运行设备屏幕尺寸为1024x600(横屏),UI设计必须支持此尺寸

22
lib/core/localization/app_localizations.dart
View File

@@ -231,6 +231,20 @@ class AppLocalizations {
String get usbUsageStep3 => _localizedValues[locale.languageCode]?['usbUsageStep3'] ?? '检测成功后点击"导入程序"加载程序列表';
String get usbPathInvalid => _localizedValues[locale.languageCode]?['usbPathInvalid'] ?? 'U盘路径无效';
// ---- 启动认证 ----
String get authTitle => _localizedValues[locale.languageCode]?['authTitle'] ?? '身份验证';
String get authSubtitle => _localizedValues[locale.languageCode]?['authSubtitle'] ?? '请输入操作员密码以继续使用';
String get enterPassword => _localizedValues[locale.languageCode]?['enterPassword'] ?? '请输入密码';
String get passwordError => _localizedValues[locale.languageCode]?['passwordError'] ?? '密码错误';
String lockCountdown(int seconds) =>
locale.languageCode == 'en'
? 'Please wait $seconds seconds to retry'
: '请等待 $seconds 秒后重试';
String remainingAttempts(int count) =>
locale.languageCode == 'en'
? '$count attempt${count > 1 ? 's' : ''} remaining'
: '剩余 $count 次尝试机会';
// ---- 通用 ----
String get back => _localizedValues[locale.languageCode]?['back'] ?? '返回';
String get totalProgress => _localizedValues[locale.languageCode]?['totalProgress'] ?? '总进度';
@@ -427,6 +441,10 @@ class AppLocalizations {
'usbUsageStep2': '插入 U盘后点击"重新检测"',
'usbUsageStep3': '检测成功后点击"导入程序"加载程序列表',
'usbPathInvalid': 'U盘路径无效',
'authTitle': '身份验证',
'authSubtitle': '请输入操作员密码以继续使用',
'enterPassword': '请输入密码',
'passwordError': '密码错误',
'back': '返回',
'totalProgress': '总进度',
'appTitle': '污水毒品快检一体机',
@@ -607,6 +625,10 @@ class AppLocalizations {
'usbUsageStep2': 'Insert USB then click "Re-detect"',
'usbUsageStep3': 'After detection, click "Import Programs" to load',
'usbPathInvalid': 'USB path invalid',
'authTitle': 'Authentication',
'authSubtitle': 'Enter operator password to continue',
'enterPassword': 'Enter password',
'passwordError': 'Password incorrect',
'back': 'Back',
'totalProgress': 'Total Progress',
'appTitle': 'Wastewater Drug Detection System',

40
lib/core/router/app_router.dart
View File

@@ -1,22 +1,53 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:go_router/go_router.dart';
import '../../features/auth/pages/login_page.dart';
import '../../features/home/pages/home_page.dart';
import '../../features/programs/pages/programs_page.dart';
import '../../features/program_detail/pages/program_detail_page.dart';
import '../../features/settings/pages/settings_page.dart';
import '../../features/home/pages/complete_page.dart';
import '../../features/auth/providers/auth_provider.dart';
final _authRefreshStream = AuthRefreshStream();
/// 应用路由配置
final goRouterProvider = Provider<GoRouter>((ref) {
final authState = ref.watch(authProvider);
// 监听认证状态变化，触发 GoRouter 重新评估 redirect
ref.listen(authProvider, (prev, next) {
_authRefreshStream.notify();
});
return GoRouter(
initialLocation: '/',
redirect: (context, state) {
final isAuthenticated = authState.status == AuthStatus.authenticated;
final isLoginPage = state.uri.path == '/login';
if (!isAuthenticated && !isLoginPage) {
return '/login';
}
if (isAuthenticated && isLoginPage) {
return '/';
}
return null;
},
refreshListenable: _authRefreshStream,
routes: [
GoRoute(
path: '/login',
name: 'login',
builder: (context, state) => const LoginPage(),
),
GoRoute(
path: '/',
name: 'home',
builder: (context, state) {
// 支持 ?tab=N 查询参数,用于从其他页面跳回首页并切换到指定 tab
final tabParam = state.uri.queryParameters['tab'];
final initialTab = int.tryParse(tabParam ?? '') ?? 0;
return HomePage(initialTab: initialTab);
@@ -47,4 +78,9 @@ final goRouterProvider = Provider<GoRouter>((ref) {
),
],
);
});
});
/// 桥接 Riverpod 到 GoRouter 的 refreshListenable
class AuthRefreshStream extends ChangeNotifier {
void notify() => notifyListeners();
}

191
lib/features/auth/pages/login_page.dart Normal file
View File

@@ -0,0 +1,191 @@
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../../core/localization/app_localizations.dart';
import '../../../core/theme/app_theme.dart';
import '../providers/auth_provider.dart';
/// 启动密码验证页面
class LoginPage extends ConsumerStatefulWidget {
const LoginPage({super.key});
@override
ConsumerState<LoginPage> createState() => _LoginPageState();
}
class _LoginPageState extends ConsumerState<LoginPage> {
final _passwordCtrl = TextEditingController();
final _focusNode = FocusNode();
String? _errorMsg;
bool _submitting = false;
@override
void initState() {
super.initState();
WidgetsBinding.instance.addPostFrameCallback((_) {
_focusNode.requestFocus();
});
}
@override
void dispose() {
_passwordCtrl.dispose();
_focusNode.dispose();
super.dispose();
}
Future<void> _submit() async {
if (_submitting) return;
final password = _passwordCtrl.text.trim();
if (password.isEmpty) return;
setState(() {
_submitting = true;
_errorMsg = null;
});
final success = await ref.read(authProvider.notifier).verify(password);
if (!mounted) return;
_passwordCtrl.clear();
if (!success) {
final l10n = AppLocalizations.of(context);
setState(() {
_submitting = false;
_errorMsg = l10n?.passwordError ?? '密码错误';
});
}
}
void _onKeyEvent(KeyEvent event) {
if (event is KeyDownEvent &&
event.logicalKey == LogicalKeyboardKey.enter) {
_submit();
}
}
@override
Widget build(BuildContext context) {
final l10n = AppLocalizations.of(context);
final authState = ref.watch(authProvider);
final isLocked = authState.isLocked;
final lockSeconds = authState.lockSecondsRemaining;
return Scaffold(
backgroundColor: AppTheme.bgPage,
body: Center(
child: Container(
constraints: const BoxConstraints(maxWidth: 420),
padding: const EdgeInsets.all(32),
decoration: BoxDecoration(
color: AppTheme.bgSurface,
borderRadius: BorderRadius.circular(AppTheme.radiusLg),
border: Border.all(color: AppTheme.borderLight),
boxShadow: AppTheme.shadowCard,
),
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
// 设备名称标识
Icon(
Icons.shield_outlined,
size: 48,
color: AppTheme.primaryColor,
),
const SizedBox(height: 16),
Text(
l10n?.authTitle ?? '身份验证',
style: TextStyle(
color: AppTheme.textHeading,
fontSize: 22,
fontWeight: FontWeight.w600,
),
),
const SizedBox(height: 8),
Text(
l10n?.authSubtitle ?? '请输入操作员密码以继续使用',
style: TextStyle(
color: AppTheme.textSecondary,
fontSize: 14,
),
),
const SizedBox(height: 32),
// 密码输入框
KeyboardListener(
focusNode: FocusNode(),
onKeyEvent: _onKeyEvent,
child: TextField(
controller: _passwordCtrl,
focusNode: _focusNode,
obscureText: true,
enabled: !isLocked && !_submitting,
decoration: InputDecoration(
labelText: l10n?.enterPassword ?? '请输入密码',
border: const OutlineInputBorder(),
errorText: _errorMsg,
prefixIcon: const Icon(Icons.lock_outline),
),
),
),
const SizedBox(height: 24),
// 确认按钮 / 锁定提示
if (isLocked)
Column(
children: [
Icon(Icons.lock_clock,
size: 32, color: AppTheme.warningColor),
const SizedBox(height: 8),
Text(
l10n?.lockCountdown(lockSeconds) ??
'请等待 $lockSeconds 秒后重试',
style: TextStyle(
color: AppTheme.warningColor,
fontSize: 14,
fontWeight: FontWeight.w500,
),
),
],
)
else
SizedBox(
width: double.infinity,
child: ElevatedButton(
onPressed: _submitting ? null : _submit,
style: ElevatedButton.styleFrom(
padding: const EdgeInsets.symmetric(vertical: 14),
),
child: _submitting
? const SizedBox(
width: 20,
height: 20,
child: CircularProgressIndicator(
strokeWidth: 2,
color: Colors.white,
),
)
: Text(l10n?.confirm ?? '确认'),
),
),
// 剩余尝试次数提示
if (!isLocked && authState.remainingAttempts < 5)
Padding(
padding: const EdgeInsets.only(top: 12),
child: Text(
l10n?.remainingAttempts(authState.remainingAttempts) ??
'剩余 ${authState.remainingAttempts} 次尝试机会',
style: TextStyle(
color: AppTheme.errorColor,
fontSize: 12,
),
),
),
],
),
),
),
);
}
}

98
lib/features/auth/providers/auth_provider.dart Normal file
View File

@@ -0,0 +1,98 @@
import 'dart:async';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../settings/services/settings_service.dart';
/// 认证状态枚举
enum AuthStatus { unauthenticated, authenticated }
/// 认证状态数据
class AuthState {
final AuthStatus status;
final int remainingAttempts;
final DateTime? lockUntil;
const AuthState({
this.status = AuthStatus.unauthenticated,
this.remainingAttempts = 5,
this.lockUntil,
});
bool get isLocked => lockUntil != null && DateTime.now().isBefore(lockUntil!);
int get lockSecondsRemaining {
if (lockUntil == null) return 0;
final diff = lockUntil!.difference(DateTime.now()).inSeconds;
return diff > 0 ? diff : 0;
}
AuthState copyWith({
AuthStatus? status,
int? remainingAttempts,
DateTime? Function()? lockUntil,
}) {
return AuthState(
status: status ?? this.status,
remainingAttempts: remainingAttempts ?? this.remainingAttempts,
lockUntil: lockUntil != null ? lockUntil() : this.lockUntil,
);
}
}
/// 认证状态管理器
class AuthNotifier extends StateNotifier<AuthState> {
AuthNotifier() : super(const AuthState());
static const maxAttempts = 5;
static const lockDuration = Duration(seconds: 30);
/// 验证密码
Future<bool> verify(String password) async {
if (state.isLocked) {
return false;
}
final isValid = await SettingsService.instance.verifyPassword(password);
if (isValid) {
state = const AuthState(status: AuthStatus.authenticated);
return true;
}
final newAttempts = state.remainingAttempts - 1;
if (newAttempts <= 0) {
state = state.copyWith(
remainingAttempts: 0,
lockUntil: () => DateTime.now().add(lockDuration),
);
_startLockTimer();
} else {
state = state.copyWith(remainingAttempts: newAttempts);
}
return false;
}
/// 锁定倒计时结束后自动解锁
void _startLockTimer() {
Timer(lockDuration, () {
if (state.status == AuthStatus.authenticated) return;
state = AuthState(
status: state.status,
remainingAttempts: maxAttempts,
lockUntil: null,
);
});
}
/// 重置认证状态（用于登出）
void reset() {
state = const AuthState();
}
}
final authProvider = StateNotifierProvider<AuthNotifier, AuthState>((ref) {
return AuthNotifier();
});