feat: 落地登录纵切——网络层、认证会话与登录/注册/Splash 三页（ADR-003/ADR-004）
- 新增 lib/core/network/：ApiClient（dio 封装，错误信封→类型化异常，base URL 经 --dart-define=PATBOND_API_BASE_URL 注入）、AuthInterceptor（Bearer + 设备标识）、TokenRefresher（单飞刷新，401/40101 重放一次，仅 40102/再 401 清会话） - 新增 lib/features/auth/：SessionManager（token 只进 flutter_secure_storage）、AuthRepository（login/register/refresh/logout/me，注册带 Idempotency-Key）、Splash（500ms 最短停留/5s 超时/错误态重试+改用账号登录）、登录页与注册页（照 12 号组装稿，错误三层映射，预留区不渲染） - App 根组件改为认证状态机驱动（Splash↔登录↔主壳 300ms fade）；个人中心退出登录接入真实 logout - 顺带修复：FIX-1 促销卡渐变改 [primaryStrong, primary]、FIX-2 补 helperStyle: muted、README dart format 命令补 --output=none - 新增依赖：dio ^5.11.1、flutter_secure_storage ^11.0.0、uuid ^4.6.0 - 门禁：dart format（0 changed）/ flutter analyze（No issues）/ flutter test（30 passed，其中新增 23：TokenRefresher 5 + AuthRepository 10 + 登录页 4 + 注册页 4） Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,147 @@
|
||||
import 'dart:async';
|
||||
|
||||
import 'package:flutter/material.dart';
|
||||
import 'package:patbond_flutter/core/network/api_exception.dart';
|
||||
import 'package:patbond_flutter/core/theme/app_theme.dart';
|
||||
import 'package:patbond_flutter/core/widgets/brand_mark.dart';
|
||||
import 'package:patbond_flutter/features/auth/auth_repository.dart';
|
||||
import 'package:patbond_flutter/features/auth/session_manager.dart';
|
||||
|
||||
enum _SplashState { checking, failed }
|
||||
|
||||
/// 启动 Splash（12 号组装稿 §7）：静默恢复会话。
|
||||
///
|
||||
/// 流程约束：最短停留 500ms；刷新超时 5s；spinner 等待超过 300ms 才出现；
|
||||
/// 网络失败不清除本地 refresh token（只有服务端明确 401/40102 才清）。
|
||||
class SplashPage extends StatefulWidget {
|
||||
const SplashPage({
|
||||
required this.authRepository,
|
||||
required this.sessionManager,
|
||||
super.key,
|
||||
});
|
||||
|
||||
final AuthRepository authRepository;
|
||||
final SessionManager sessionManager;
|
||||
|
||||
@override
|
||||
State<SplashPage> createState() => _SplashPageState();
|
||||
}
|
||||
|
||||
class _SplashPageState extends State<SplashPage> {
|
||||
_SplashState _state = _SplashState.checking;
|
||||
bool _showSpinner = false;
|
||||
Timer? _spinnerTimer;
|
||||
|
||||
@override
|
||||
void initState() {
|
||||
super.initState();
|
||||
_restore();
|
||||
}
|
||||
|
||||
@override
|
||||
void dispose() {
|
||||
_spinnerTimer?.cancel();
|
||||
super.dispose();
|
||||
}
|
||||
|
||||
Future<void> _restore() async {
|
||||
_spinnerTimer?.cancel();
|
||||
_spinnerTimer = Timer(const Duration(milliseconds: 300), () {
|
||||
if (mounted) setState(() => _showSpinner = true);
|
||||
});
|
||||
final minStay = Future<void>.delayed(const Duration(milliseconds: 500));
|
||||
try {
|
||||
final result = await widget.authRepository.restoreSession().timeout(
|
||||
const Duration(seconds: 5),
|
||||
);
|
||||
await minStay;
|
||||
if (!mounted) return;
|
||||
switch (result) {
|
||||
case SessionRestoreResult.authenticated:
|
||||
widget.sessionManager.markAuthenticated();
|
||||
case SessionRestoreResult.noSession:
|
||||
widget.sessionManager.markUnauthenticated();
|
||||
}
|
||||
} on SessionExpiredException {
|
||||
// refresh 已被服务端判失效，会话已清、状态机已切换，无需处理。
|
||||
} catch (_) {
|
||||
// 网络失败 / 超时：token 保留，转错误态供重试。
|
||||
await minStay;
|
||||
if (!mounted) return;
|
||||
setState(() {
|
||||
_state = _SplashState.failed;
|
||||
_showSpinner = false;
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
void _retryRefresh() {
|
||||
setState(() {
|
||||
_state = _SplashState.checking;
|
||||
_showSpinner = false;
|
||||
});
|
||||
_restore();
|
||||
}
|
||||
|
||||
Future<void> _clearCredentialsAndGoLogin() async {
|
||||
// 逃生通道：放弃本地凭证，改用账号登录。
|
||||
await widget.sessionManager.clearSession();
|
||||
}
|
||||
|
||||
@override
|
||||
Widget build(BuildContext context) {
|
||||
return Scaffold(
|
||||
backgroundColor: AppColors.canvas,
|
||||
body: Center(
|
||||
child: _state == _SplashState.checking
|
||||
? Column(
|
||||
mainAxisSize: MainAxisSize.min,
|
||||
children: [
|
||||
const BrandMark(),
|
||||
const SizedBox(height: 32),
|
||||
// 占位保高度，spinner 出现时不跳动。
|
||||
SizedBox.square(
|
||||
dimension: 20,
|
||||
child: _showSpinner
|
||||
? const CircularProgressIndicator(
|
||||
strokeWidth: 2.5,
|
||||
color: AppColors.primary,
|
||||
)
|
||||
: null,
|
||||
),
|
||||
],
|
||||
)
|
||||
: Column(
|
||||
mainAxisSize: MainAxisSize.min,
|
||||
children: [
|
||||
const BrandMark(),
|
||||
const SizedBox(height: 24),
|
||||
const Text(
|
||||
'网络连接失败，无法恢复登录',
|
||||
style: TextStyle(color: AppColors.ink, fontSize: 14),
|
||||
),
|
||||
const SizedBox(height: 16),
|
||||
OutlinedButton(
|
||||
style: OutlinedButton.styleFrom(
|
||||
minimumSize: const Size(120, 44),
|
||||
foregroundColor: AppColors.primaryStrong,
|
||||
side: const BorderSide(color: AppColors.border),
|
||||
),
|
||||
onPressed: _retryRefresh,
|
||||
child: const Text('重试'),
|
||||
),
|
||||
const SizedBox(height: 8),
|
||||
TextButton(
|
||||
style: TextButton.styleFrom(
|
||||
foregroundColor: AppColors.primaryStrong,
|
||||
minimumSize: const Size(44, 44),
|
||||
),
|
||||
onPressed: _clearCredentialsAndGoLogin,
|
||||
child: const Text('改用账号登录'),
|
||||
),
|
||||
],
|
||||
),
|
||||
),
|
||||
);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user