重构：宠物列表/详情/编辑页接入真实数据（T2-12，四态齐备）

- 档案 Tab 替换为真实宠物列表（05 号规范 P1）：PetsController 四态驱动（loading/empty/error+重试/ready），空态插画 + 建档 CTA，下拉刷新，虚线添加卡；页面一律走 T2-11 数据层、不直连 ApiClient - 新增 PetDetailPage（P2 档案信息部分）：内存副本首屏 + getPet 刷新， 40401 防枚举 → 不存在态返回列表并刷新；仅 owner 显示编辑入口（40300 语义）；体重/疫苗/时间线区块留待 T2-13/14 接摘要与记录接口 - 新增 PetFormPage（建档/编辑）：品种目录接口 + 自定义品种互斥（目录失败回落自定义 + 重试）、性别契约必填、生日+估算、芯片号；失焦+提交双校验、错误三层模型沿用登录纵切 - 40902 版本冲突：明确提示 + 自动拉取最新 version 重提路径（有测试）； 40903 芯片号冲突字段级报错（有测试） - 埋点挂接：pet_create_started（表单首次输入、每次进入一次）/ succeeded / failed 三事件接线；建宠表单路由名 pet_form、详情页 pet_detail 进入既有 RouteObserver 采集；档案 Tab 页名 pet_archive 改报 pet_list（字典 v2）；编辑表单不带路由名（漏斗到达段不掺编辑） - app.dart 装配：pet 服务 ApiClient（:8083）共享 TokenRefresher；登出 reset 控制器防跨账号泄漏；PetsController.loadBreeds 按物种缓存 - AppState 清理：pets 页原 demo 消费方移除，vaccines 及其模型/持久化删除；pet demo 仅存首页问候/创作页/主壳头像（后续工单收敛） - 头像按 ADR-010 本地占位，不做上传 - 测试 145 → 177 全绿（列表/详情/表单四态与冲突路径 widget 测试、控制器 loadBreeds/reset、展示纯函数）；analyze 0；format 无 diff Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-08 12:15:32 +08:00
parent c0a8a56e91
commit 97a1f46e3f
17 changed files with 2249 additions and 852 deletions
@@ -0,0 +1,345 @@
+import 'dart:async';
+
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:patbond_flutter/core/network/api_exception.dart';
+import 'package:patbond_flutter/core/theme/app_theme.dart';
+import 'package:patbond_flutter/features/pets/pet_analytics.dart';
+import 'package:patbond_flutter/features/pets/pet_exceptions.dart';
+import 'package:patbond_flutter/features/pets/pet_form_page.dart';
+import 'package:patbond_flutter/features/pets/pet_models.dart';
+import 'package:patbond_flutter/features/pets/pets_controller.dart';
+
+import '../../helpers/pet_test_helpers.dart';
+
+void main() {
+  late FakePetsRepository repository;
+  late PetsController controller;
+  late List<(String, Map<String, dynamic>?)> events;
+  late PetAnalytics analytics;
+
+  setUp(() {
+    repository = FakePetsRepository();
+    controller = PetsController(repository: repository);
+    events = [];
+    analytics = PetAnalytics(
+      (name, [props]) async => events.add((name, props)),
+    );
+  });
+
+  List<Map<String, dynamic>?> eventsOf(String name) => [
+    for (final e in events)
+      if (e.$1 == name) e.$2,
+  ];
+
+  Future<void> pumpForm(WidgetTester tester, Widget form) async {
+    tester.view.physicalSize = const Size(700, 2000);
+    tester.view.devicePixelRatio = 1.0;
+    addTearDown(tester.view.reset);
+    await tester.pumpWidget(
+      MaterialApp(
+        theme: buildAppTheme(),
+        home: const Scaffold(body: Text('列表基底')),
+      ),
+    );
+    final navigator = tester.state<NavigatorState>(find.byType(Navigator));
+    unawaited(navigator.push(MaterialPageRoute<void>(builder: (_) => form)));
+    await tester.pumpAndSettle();
+  }
+
+  Future<void> pumpCreate(
+    WidgetTester tester, {
+    PetCreateEntryPoint entryPoint = PetCreateEntryPoint.profileEmptyState,
+  }) {
+    return pumpForm(
+      tester,
+      PetFormPage.create(
+        controller: controller,
+        analytics: analytics,
+        entryPoint: entryPoint,
+      ),
+    );
+  }
+
+  Future<void> selectBreed(WidgetTester tester, String label) async {
+    await tester.tap(find.byType(DropdownButtonFormField<String>));
+    await tester.pumpAndSettle();
+    await tester.tap(find.text(label).last);
+    await tester.pumpAndSettle();
+  }
+
+  group('创建模式', () {
+    testWidgets('提交空表单：昵称/性别/品种三处校验拦截 + failed(validation_error)', (
+      tester,
+    ) async {
+      await pumpCreate(tester);
+
+      await tester.tap(find.text('保存档案'));
+      await tester.pumpAndSettle();
+
+      expect(find.text('请输入宠物昵称'), findsOneWidget);
+      expect(find.text('请选择性别'), findsOneWidget);
+      expect(find.text('请选择品种'), findsOneWidget);
+
+      final failed = eventsOf('pet_create_failed');
+      expect(failed, hasLength(1));
+      expect(failed.single!['failureReason'], 'validation_error');
+      expect(failed.single!['attemptSeq'], 1);
+    });
+
+    testWidgets('首次输入触发 pet_create_started（每次进入仅一次）', (tester) async {
+      await pumpCreate(tester);
+
+      expect(eventsOf('pet_create_started'), isEmpty);
+
+      await tester.enterText(find.widgetWithText(TextFormField, '宠物昵称'), '咪');
+      await tester.tap(find.text('女孩'));
+      await tester.pumpAndSettle();
+
+      final started = eventsOf('pet_create_started');
+      expect(started, hasLength(1));
+      expect(started.single!['entryPoint'], 'profile_empty_state');
+    });
+
+    testWidgets('目录品种建档成功：请求对齐契约、页面回列表、succeeded 三属性', (tester) async {
+      CreatePetRequest? captured;
+      repository.createPetHandler = (request) async {
+        captured = request;
+        return buildPet('p-new', name: '咪咪');
+      };
+
+      await pumpCreate(tester);
+      await tester.enterText(find.widgetWithText(TextFormField, '宠物昵称'), '咪咪');
+      await tester.tap(find.text('女孩'));
+      await tester.pumpAndSettle();
+      await selectBreed(tester, '柴犬');
+      await tester.enterText(
+        find.widgetWithText(TextFormField, '芯片号（可选）'),
+        '985112000000001',
+      );
+
+      await tester.tap(find.text('保存档案'));
+      await tester.pumpAndSettle();
+
+      expect(captured!.toJson(), {
+        'name': '咪咪',
+        'species': 'dog',
+        'sex': 'female',
+        'breedId': 'b-1',
+        'microchipNo': '985112000000001',
+      });
+      expect(find.text('列表基底'), findsOneWidget);
+      expect(controller.pets.single.id, 'p-new');
+
+      final succeeded = eventsOf('pet_create_succeeded');
+      expect(succeeded, hasLength(1));
+      expect(succeeded.single!['species'], 'dog');
+      expect(succeeded.single!['petIndex'], 1);
+      expect(succeeded.single!['durationMs'], isA<int>());
+    });
+
+    testWidgets('自定义品种与目录互斥：只发送 customBreedName', (tester) async {
+      CreatePetRequest? captured;
+      repository.createPetHandler = (request) async {
+        captured = request;
+        return buildPet('p-new');
+      };
+
+      await pumpCreate(tester);
+      await tester.enterText(find.widgetWithText(TextFormField, '宠物昵称'), '大黄');
+      await tester.tap(find.text('男孩'));
+      await tester.pumpAndSettle();
+      await selectBreed(tester, '自定义品种…');
+
+      expect(find.text('品种名称'), findsOneWidget);
+      await tester.enterText(
+        find.widgetWithText(TextFormField, '品种名称'),
+        '中华田园犬',
+      );
+
+      await tester.tap(find.text('保存档案'));
+      await tester.pumpAndSettle();
+
+      expect(captured!.toJson()['customBreedName'], '中华田园犬');
+      expect(captured!.toJson().containsKey('breedId'), isFalse);
+    });
+
+    testWidgets('40903 芯片号冲突：字段级报错 + failed 带 errorCode/httpStatus', (
+      tester,
+    ) async {
+      repository.createPetHandler = (request) async =>
+          throw const MicrochipTakenException(message: '已登记');
+
+      await pumpCreate(tester);
+      await tester.enterText(find.widgetWithText(TextFormField, '宠物昵称'), '咪咪');
+      await tester.tap(find.text('女孩'));
+      await tester.pumpAndSettle();
+      await selectBreed(tester, '柴犬');
+
+      await tester.tap(find.text('保存档案'));
+      await tester.pumpAndSettle();
+
+      expect(find.text('该芯片号已被登记，请核对后重试'), findsOneWidget);
+      expect(find.byType(PetFormPage), findsOneWidget);
+
+      final failed = eventsOf('pet_create_failed');
+      expect(failed.single!['errorCode'], 40903);
+      expect(failed.single!['httpStatus'], 409);
+      expect(failed.single!['failureReason'], 'validation_error');
+    });
+
+    testWidgets('网络异常：SnackBar + 重试动作 + failed(network_error)', (tester) async {
+      repository.createPetHandler = (request) async =>
+          throw const ApiNetworkException('断网');
+
+      await pumpCreate(tester);
+      await tester.enterText(find.widgetWithText(TextFormField, '宠物昵称'), '咪咪');
+      await tester.tap(find.text('未知'));
+      await tester.pumpAndSettle();
+      await selectBreed(tester, '柴犬');
+
+      await tester.tap(find.text('保存档案'));
+      await tester.pumpAndSettle();
+
+      expect(find.text('网络异常，请检查网络后重试'), findsOneWidget);
+      expect(find.text('重试'), findsOneWidget);
+      expect(
+        eventsOf('pet_create_failed').single!['failureReason'],
+        'network_error',
+      );
+    });
+
+    testWidgets('品种目录加载失败：回落自定义输入，重试后目录恢复', (tester) async {
+      var calls = 0;
+      repository.listBreedsHandler = (species) async {
+        calls++;
+        if (calls == 1) throw const ApiNetworkException('断网');
+        return [Breed.fromJson(sampleBreedJson())];
+      };
+
+      await pumpCreate(tester);
+
+      expect(find.text('品种目录加载失败，可先填写自定义品种'), findsOneWidget);
+      expect(find.text('品种名称'), findsOneWidget);
+
+      await tester.tap(find.text('重试'));
+      await tester.pumpAndSettle();
+
+      expect(find.byType(DropdownButtonFormField<String>), findsOneWidget);
+      expect(find.text('品种目录加载失败，可先填写自定义品种'), findsNothing);
+    });
+
+    testWidgets('昵称失焦校验：空值即时 errorText，输入即清除', (tester) async {
+      await pumpCreate(tester);
+
+      await tester.tap(find.widgetWithText(TextFormField, '宠物昵称'));
+      await tester.pump();
+      // 焦点移到芯片号 → 昵称失焦触发校验。
+      await tester.tap(find.widgetWithText(TextFormField, '芯片号（可选）'));
+      await tester.pumpAndSettle();
+
+      expect(find.text('请输入宠物昵称'), findsOneWidget);
+
+      await tester.enterText(find.widgetWithText(TextFormField, '宠物昵称'), '豆');
+      await tester.pumpAndSettle();
+      expect(find.text('请输入宠物昵称'), findsNothing);
+    });
+  });
+
+  group('编辑模式', () {
+    testWidgets('预填 + 物种锁定 + 差量提交（只发送改动字段与 version）', (tester) async {
+      UpdatePetRequest? captured;
+      repository.updatePetHandler = (petId, request) async {
+        captured = request;
+        return buildPet('p-1', name: '豆豆二世', version: 4);
+      };
+
+      await pumpForm(
+        tester,
+        PetFormPage.edit(
+          controller: controller,
+          pet: buildPet('p-1', version: 3),
+          analytics: analytics,
+        ),
+      );
+
+      // 物种锁定为静态文案，无可选分段控件。
+      expect(find.text('物种（创建后不可修改）'), findsOneWidget);
+      expect(find.byType(SegmentedButton<PetSpecies>), findsNothing);
+      expect(find.text('编辑宠物资料'), findsOneWidget);
+
+      await tester.enterText(
+        find.widgetWithText(TextFormField, '宠物昵称'),
+        '豆豆二世',
+      );
+      await tester.tap(find.text('保存修改'));
+      await tester.pumpAndSettle();
+
+      expect(captured!.toJson(), {'version': 3, 'name': '豆豆二世'});
+      expect(find.text('列表基底'), findsOneWidget);
+      // 编辑不产生 pet_create_* 事件（06 §1.4）。
+      expect(events, isEmpty);
+    });
+
+    testWidgets('40902 版本冲突：明确提示 + 自动取新 version，重提成功', (tester) async {
+      var updateCalls = 0;
+      final versions = <int>[];
+      repository.updatePetHandler = (petId, request) async {
+        updateCalls++;
+        versions.add(request.version);
+        if (updateCalls == 1) {
+          throw const PetVersionConflictException(message: '版本过期');
+        }
+        return buildPet('p-1', name: '豆豆二世', version: 5);
+      };
+      repository.getPetHandler = (petId) async => buildPet('p-1', version: 4);
+
+      await pumpForm(
+        tester,
+        PetFormPage.edit(
+          controller: controller,
+          pet: buildPet('p-1', version: 3),
+        ),
+      );
+      await tester.enterText(
+        find.widgetWithText(TextFormField, '宠物昵称'),
+        '豆豆二世',
+      );
+
+      await tester.tap(find.text('保存修改'));
+      await tester.pumpAndSettle();
+
+      // 明确的用户提示 + 刷新路径（已拉取最新版本）。
+      expect(find.text('资料已在其他设备被修改，已获取最新版本，请核对后重新保存'), findsOneWidget);
+      expect(find.byType(PetFormPage), findsOneWidget);
+
+      await tester.tap(find.text('保存修改'));
+      await tester.pumpAndSettle();
+
+      expect(versions, [3, 4]);
+      expect(find.text('列表基底'), findsOneWidget);
+    });
+
+    testWidgets('无任何变更：不发 PATCH 直接返回', (tester) async {
+      var updateCalls = 0;
+      repository.updatePetHandler = (petId, request) async {
+        updateCalls++;
+        return buildPet('p-1');
+      };
+
+      await pumpForm(
+        tester,
+        PetFormPage.edit(
+          controller: controller,
+          pet: buildPet('p-1', version: 3),
+        ),
+      );
+
+      await tester.tap(find.text('保存修改'));
+      await tester.pumpAndSettle();
+
+      expect(updateCalls, 0);
+      expect(find.text('列表基底'), findsOneWidget);
+    });
+  });
+}