feat(client): Flutter 逐屏还原 + iPad ≥900 断点 (tsk_gpPXi-icyeOE)

对照 design/ui_kits mobile+tablet 原型逐屏补齐 Flutter 客户端: - l10n 资源层(strings_zh/en,单显)+ Riverpod 状态层(连接状态机/免费额度/ 节点选择/语言/主题),UI 与数据解耦,mock 数据接 API 不动 UI。 - 连接键严格三态(off 虚线轨道环 / connecting 旋转弧 / on 满环+计时+光晕), 状态来自 connectionProvider,点击只派发事件——禁止乐观显示。 - 节点页置顶「智能选择」推荐卡(clay 渐变 zap + 推荐胶囊,默认选中); 免费额度卡(剩余分钟+进度条 ≤3 分钟切 warning + 看广告解锁变绿)。 - Tab 左右滑动切换(手势竞技场仲裁,子页滚动不误触发,200ms 方向感知滑入)。 - iPad/宽屏 ≥900 LayoutBuilder 切侧栏分栏(导航行高 ≥48,连接页双栏/节点双列网格), 复用同一批原子组件,不 fork 页面。 - 语义 token 零硬编码;文案全部走 l10n;套餐数字对齐 §7;无支付表单/emoji 国旗。 - CI 红线词扫描扩展到 client/lib;新增 Flutter analyze+test CI 任务。 - 测试:连接状态机/额度/节点单测、连接键三态与卡片组件测试、 golden(连接键三态/推荐卡/额度卡 × 明暗)。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 14:32:36 +08:00
parent 787151245e
commit f97ae8186b
40 changed files with 3369 additions and 567 deletions
@@ -0,0 +1,71 @@
+// connection_controller_test.dart — 连接状态机:严格三态、禁乐观显示
+import 'package:flutter_test/flutter_test.dart';
+import 'package:pangolin_vpn/state/connection_provider.dart';
+
+void main() {
+  // 注入极短握手时长,用真实计时器走完状态流转。
+  ConnectionController make() => ConnectionController(handshake: const Duration(milliseconds: 20));
+
+  test('初始为 off', () {
+    final ctl = make();
+    expect(ctl.state.phase, VpnPhase.off);
+    ctl.dispose();
+  });
+
+  test('connect: off → connecting → on', () async {
+    final ctl = make();
+    ctl.connect();
+    expect(ctl.state.phase, VpnPhase.connecting);
+    await Future<void>.delayed(const Duration(milliseconds: 60));
+    expect(ctl.state.phase, VpnPhase.on);
+    ctl.dispose();
+  });
+
+  test('握手中再次 toggle 被忽略(禁止乐观回退)', () async {
+    final ctl = make();
+    ctl.toggle(); // off → connecting
+    expect(ctl.state.phase, VpnPhase.connecting);
+    ctl.toggle(); // connecting 中点击 → 仍 connecting
+    expect(ctl.state.phase, VpnPhase.connecting);
+    await Future<void>.delayed(const Duration(milliseconds: 60));
+    expect(ctl.state.phase, VpnPhase.on);
+    ctl.dispose();
+  });
+
+  test('on 态 toggle → off', () async {
+    final ctl = make();
+    ctl.connect();
+    await Future<void>.delayed(const Duration(milliseconds: 60));
+    expect(ctl.state.phase, VpnPhase.on);
+    ctl.toggle();
+    expect(ctl.state.phase, VpnPhase.off);
+    ctl.dispose();
+  });
+
+  test('已连接时切换节点 → 重连(回到 connecting)', () async {
+    final ctl = make();
+    ctl.connect();
+    await Future<void>.delayed(const Duration(milliseconds: 60));
+    expect(ctl.state.phase, VpnPhase.on);
+    ctl.onNodeChanged();
+    expect(ctl.state.phase, VpnPhase.connecting);
+    ctl.dispose();
+  });
+
+  test('on 态计时累加', () async {
+    final ctl = make();
+    ctl.connect();
+    await Future<void>.delayed(const Duration(milliseconds: 60));
+    expect(ctl.state.elapsed, Duration.zero);
+    await Future<void>.delayed(const Duration(milliseconds: 1100));
+    expect(ctl.state.elapsed.inSeconds, greaterThanOrEqualTo(1));
+    ctl.dispose();
+  });
+
+  test('off 态切换节点不会自动连接', () {
+    final ctl = make();
+    ctl.onNodeChanged();
+    expect(ctl.state.phase, VpnPhase.off);
+    ctl.dispose();
+  });
+}
@@ -0,0 +1,40 @@
+// nodes_provider_test.dart — 节点选择 / 智能选择派生
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:pangolin_vpn/l10n/app_text.dart';
+import 'package:pangolin_vpn/models/node.dart';
+import 'package:pangolin_vpn/state/nodes_provider.dart';
+
+void main() {
+  test('默认智能选择(AUTO)', () {
+    final c = ProviderContainer();
+    addTearDown(c.dispose);
+    expect(c.read(selectedNodeCodeProvider), kSmartNodeCode);
+    expect(c.read(isSmartSelectProvider), true);
+  });
+
+  test('智能选择取延迟最小节点', () {
+    final c = ProviderContainer();
+    addTearDown(c.dispose);
+    final node = c.read(effectiveNodeProvider);
+    final minPing = kDemoNodes.map((n) => n.ping).reduce((a, b) => a < b ? a : b);
+    expect(node.ping, minPing);
+  });
+
+  test('选中具体节点后生效节点随之改变', () {
+    final c = ProviderContainer();
+    addTearDown(c.dispose);
+    c.read(selectedNodeCodeProvider.notifier).state = 'JP';
+    expect(c.read(isSmartSelectProvider), false);
+    expect(c.read(effectiveNodeProvider).code, 'JP');
+  });
+
+  test('localizedSub 不串语言:无标签用拉丁地名', () {
+    const tw = Node(code: 'TW', nameZh: '台湾 台北', nameEn: 'Taipei', ping: 28);
+    expect(tw.localizedSub(AppLang.zh), 'Taipei');
+    expect(tw.localizedSub(AppLang.en), 'Taipei');
+    const hk = Node(code: 'HK', nameZh: '香港 · 流媒体', nameEn: 'Hong Kong', ping: 18, tag: NodeTag.streaming);
+    expect(hk.localizedSub(AppLang.zh), '流媒体优化');
+    expect(hk.localizedSub(AppLang.en), 'Streaming');
+  });
+}
@@ -0,0 +1,36 @@
+// quota_controller_test.dart — 免费额度状态机
+import 'package:flutter_test/flutter_test.dart';
+import 'package:pangolin_vpn/state/quota_provider.dart';
+
+void main() {
+  test('默认值:10 分钟总额 / 6 分钟剩余 / 未解锁', () {
+    final ctl = QuotaController();
+    expect(ctl.state.totalMinutes, 10);
+    expect(ctl.state.remainingMinutes, 6);
+    expect(ctl.state.adUnlocked, false);
+  });
+
+  test('progress = 剩余/总额', () {
+    final ctl = QuotaController(const FreeQuotaState(totalMinutes: 10, remainingMinutes: 5));
+    expect(ctl.state.progress, closeTo(0.5, 1e-9));
+  });
+
+  test('isLow:剩余 ≤3 分钟为真', () {
+    expect(const FreeQuotaState(remainingMinutes: 3).isLow, true);
+    expect(const FreeQuotaState(remainingMinutes: 4).isLow, false);
+  });
+
+  test('watchAd 解锁今日使用', () {
+    final ctl = QuotaController();
+    expect(ctl.state.adUnlocked, false);
+    ctl.watchAd();
+    expect(ctl.state.adUnlocked, true);
+  });
+
+  test('reset 回到未解锁初始态', () {
+    final ctl = QuotaController()..watchAd();
+    ctl.reset();
+    expect(ctl.state.adUnlocked, false);
+    expect(ctl.state.remainingMinutes, 6);
+  });
+}