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>
2026-09-04 11:52:51 +08:00
parent ee77361b92
commit 8d890c0424
30 changed files with 2306 additions and 9 deletions
@@ -0,0 +1,128 @@
+import 'dart:convert';
+import 'dart:typed_data';
+
+import 'package:dio/dio.dart';
+import 'package:patbond_flutter/features/auth/auth_models.dart';
+import 'package:patbond_flutter/features/auth/auth_repository.dart';
+import 'package:patbond_flutter/features/auth/session_manager.dart';
+
+/// 测试用内存 token 存储。
+class InMemoryTokenStore implements TokenStore {
+  final Map<String, String> values = {};
+
+  @override
+  Future<String?> read(String key) async => values[key];
+
+  @override
+  Future<void> write(String key, String value) async => values[key] = value;
+
+  @override
+  Future<void> delete(String key) async => values.remove(key);
+}
+
+/// 测试用假认证仓库：各方法可注入行为，默认成功空实现。
+class FakeAuthRepository implements AuthRepository {
+  FakeAuthRepository({
+    this.loginHandler,
+    this.registerHandler,
+    this.restoreHandler,
+  });
+
+  final Future<void> Function()? loginHandler;
+  final Future<void> Function()? registerHandler;
+  final Future<SessionRestoreResult> Function()? restoreHandler;
+
+  int loginCalls = 0;
+  int registerCalls = 0;
+  int logoutCalls = 0;
+
+  @override
+  Future<void> login({required String username, required String password}) {
+    loginCalls += 1;
+    return loginHandler?.call() ?? Future.value();
+  }
+
+  @override
+  Future<void> register({
+    required String username,
+    required String phone,
+    required String password,
+  }) {
+    registerCalls += 1;
+    return registerHandler?.call() ?? Future.value();
+  }
+
+  @override
+  Future<void> logout() async {
+    logoutCalls += 1;
+  }
+
+  @override
+  Future<SessionRestoreResult> restoreSession() {
+    return restoreHandler?.call() ??
+        Future.value(SessionRestoreResult.noSession);
+  }
+
+  @override
+  Future<UserProfile> me() async => throw UnimplementedError();
+}
+
+/// mock dio：用假 HttpClientAdapter 返回预设响应并记录请求。
+class FakeHttpAdapter implements HttpClientAdapter {
+  FakeHttpAdapter(this.handler);
+
+  final Future<ResponseBody> Function(RequestOptions options) handler;
+  final List<RequestOptions> requests = [];
+
+  @override
+  Future<ResponseBody> fetch(
+    RequestOptions options,
+    Stream<Uint8List>? requestStream,
+    Future<void>? cancelFuture,
+  ) {
+    requests.add(options);
+    return handler(options);
+  }
+
+  @override
+  void close({bool force = false}) {}
+}
+
+ResponseBody jsonResponse(int statusCode, Map<String, Object?> body) {
+  return ResponseBody.fromString(
+    jsonEncode(body),
+    statusCode,
+    headers: {
+      Headers.contentTypeHeader: [Headers.jsonContentType],
+    },
+  );
+}
+
+Map<String, Object?> okEnvelope(Map<String, Object?> data) => {
+  'code': 0,
+  'message': 'ok',
+  'data': data,
+};
+
+Map<String, Object?> errorEnvelope(int code, [String message = 'error']) => {
+  'code': code,
+  'message': message,
+  'data': null,
+};
+
+Map<String, dynamic> tokenDataJson({
+  String access = 'access-1',
+  String refresh = 'refresh-1',
+}) => {
+  'userId': 'user-1',
+  'tokenType': 'Bearer',
+  'accessToken': access,
+  'accessTokenExpiresAt': '2026-09-04T13:00:00+08:00',
+  'refreshToken': refresh,
+  'refreshTokenExpiresAt': '2026-10-04T12:00:00+08:00',
+};
+
+AuthTokens sampleTokens({
+  String access = 'access-0',
+  String refresh = 'refresh-0',
+}) => AuthTokens.fromJson(tokenDataJson(access: access, refresh: refresh));