新增：互动埋点与乐观更新视觉基建——字典 v3 互动八事件封装 + ToggleSync 成功上报与触点归因 + LikeButton 三层闪烁抑制动画（T3-16）

- community_interaction_analytics：post_liked/unliked、post_favorited/unfavorited、 comment_create_succeeded/failed、user_followed/unfollowed 强类型封装（22 号白名单键集逐一对齐；textLengthBucket 分桶、httpStatus 由五位码推导、会话失效不上报）；comment_create_started 锁死 unknown 不封装 - CommunityController：toggleLike/toggleBookmark 增 source 触点归因（feed / post_detail），成功响应后经注入的 interactionAnalytics 上报（乐观翻转与失败不报）；adjustCommentCount 评论计数同源写入（详情副本与 Feed 卡片一并更新） - LikeButton 升 Stateful：点按激活 240ms 弹性缩放 + 120ms 图标淡入、取消仅颜色渐出；回滚/对账零动画直接跳变、计数与状态成对更新、激活动画未播完等播完再跳（05 号 §3.5/§4）；减弱动态设置降级瞬变 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-09 13:38:50 +08:00
parent 8aac8c52cc
commit 92524da8e2
5 changed files with 589 additions and 16 deletions
@@ -0,0 +1,155 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:patbond_flutter/core/theme/app_theme.dart';
+import 'package:patbond_flutter/core/widgets/like_button.dart';
+
+/// 宿主：模拟持有方（controller）的状态翻转——点按经 [onTap] 乐观翻转，
+/// 外部（回滚/对账）经 [setActive] 直接改。
+class _Host extends StatefulWidget {
+  const _Host({required this.initialActive, required this.initialCount});
+
+  final bool initialActive;
+  final int initialCount;
+
+  @override
+  State<_Host> createState() => _HostState();
+}
+
+class _HostState extends State<_Host> {
+  late bool active = widget.initialActive;
+  late int count = widget.initialCount;
+
+  void setExternal({required bool active, required int count}) {
+    setState(() {
+      this.active = active;
+      this.count = count;
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      theme: buildAppTheme(),
+      home: Scaffold(
+        body: Center(
+          child: LikeButton(
+            variant: LikeButtonVariant.like,
+            active: active,
+            count: count,
+            onPressed: () => setState(() {
+              active = !active;
+              count += active ? 1 : -1;
+            }),
+            semanticLabel: '点赞',
+          ),
+        ),
+      ),
+    );
+  }
+}
+
+void main() {
+  double scaleOf(WidgetTester tester) => tester
+      .widget<ScaleTransition>(
+        find.descendant(
+          of: find.byType(LikeButton),
+          matching: find.byType(ScaleTransition),
+        ),
+      )
+      .scale
+      .value;
+
+  testWidgets('点按激活：240ms 弹性缩放动画（中途 >1，播完归位）', (tester) async {
+    await tester.pumpWidget(const _Host(initialActive: false, initialCount: 6));
+
+    await tester.tap(find.byIcon(Icons.favorite_border));
+    await tester.pump();
+    await tester.pump(const Duration(milliseconds: 90));
+    expect(scaleOf(tester), greaterThan(1.0));
+    expect(find.byIcon(Icons.favorite), findsOneWidget);
+    expect(find.text('7'), findsOneWidget);
+
+    await tester.pumpAndSettle();
+    expect(scaleOf(tester), 1.0);
+  });
+
+  testWidgets('点按取消：仅颜色切换，无缩放动画', (tester) async {
+    await tester.pumpWidget(const _Host(initialActive: true, initialCount: 7));
+
+    await tester.tap(find.byIcon(Icons.favorite));
+    await tester.pump();
+    await tester.pump(const Duration(milliseconds: 90));
+    expect(scaleOf(tester), 1.0);
+    expect(find.byIcon(Icons.favorite_border), findsOneWidget);
+    expect(find.text('6'), findsOneWidget);
+    await tester.pumpAndSettle();
+  });
+
+  testWidgets('外部回滚：零动画直接跳变，计数与状态成对恢复', (tester) async {
+    await tester.pumpWidget(const _Host(initialActive: false, initialCount: 6));
+
+    // 点按激活并播完动画（在途请求随后失败的场景）。
+    await tester.tap(find.byIcon(Icons.favorite_border));
+    await tester.pumpAndSettle();
+    expect(find.byIcon(Icons.favorite), findsOneWidget);
+
+    // 外部（非点按）回滚：下一帧即恢复，无过渡动画。
+    tester
+        .state<_HostState>(find.byType(_Host))
+        .setExternal(active: false, count: 6);
+    await tester.pump();
+    expect(find.byIcon(Icons.favorite_border), findsOneWidget);
+    expect(find.text('6'), findsOneWidget);
+    expect(scaleOf(tester), 1.0);
+  });
+
+  testWidgets('激活动画未播完时回滚：等播完再成对跳变（§4.3a 抖动抑制）', (tester) async {
+    await tester.pumpWidget(const _Host(initialActive: false, initialCount: 6));
+
+    await tester.tap(find.byIcon(Icons.favorite_border));
+    await tester.pump();
+    await tester.pump(const Duration(milliseconds: 60));
+    expect(find.byIcon(Icons.favorite), findsOneWidget);
+
+    // 动画中途回滚：本帧仍显示激活视觉（等待播完），计数同持。
+    tester
+        .state<_HostState>(find.byType(_Host))
+        .setExternal(active: false, count: 6);
+    await tester.pump();
+    expect(find.byIcon(Icons.favorite), findsOneWidget);
+    expect(find.text('7'), findsOneWidget);
+
+    // 播完后成对跳回。
+    await tester.pumpAndSettle();
+    expect(find.byIcon(Icons.favorite_border), findsOneWidget);
+    expect(find.text('6'), findsOneWidget);
+  });
+
+  testWidgets('对账静默：状态不变的计数变化直接替换，无动画', (tester) async {
+    await tester.pumpWidget(const _Host(initialActive: true, initialCount: 7));
+
+    tester
+        .state<_HostState>(find.byType(_Host))
+        .setExternal(active: true, count: 9);
+    await tester.pump();
+    expect(find.text('9'), findsOneWidget);
+    expect(scaleOf(tester), 1.0);
+  });
+
+  testWidgets('onPressed 为 null 时禁用但照常渲染激活态', (tester) async {
+    await tester.pumpWidget(
+      MaterialApp(
+        theme: buildAppTheme(),
+        home: const Scaffold(
+          body: LikeButton(
+            variant: LikeButtonVariant.bookmark,
+            active: true,
+            count: 2,
+          ),
+        ),
+      ),
+    );
+    expect(find.byIcon(Icons.bookmark), findsOneWidget);
+    expect(find.text('2'), findsOneWidget);
+  });
+}