重构：宠物列表/详情/编辑页接入真实数据（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>

test/features/pets/pets_page_test.dart

@@ -0,0 +1,147 @@
+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/core/widgets/empty_state_illustration.dart';
+import 'package:patbond_flutter/features/pets/pet_detail_page.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 'package:patbond_flutter/features/pets/pets_page.dart';
+
+import '../../helpers/pet_test_helpers.dart';
+
+class _RecordingNavObserver extends NavigatorObserver {
+  final pushedNames = <String?>[];
+
+  @override
+  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
+    pushedNames.add(route.settings.name);
+  }
+}
+
+void main() {
+  late FakePetsRepository repository;
+  late PetsController controller;
+  late _RecordingNavObserver observer;
+
+  setUp(() {
+    repository = FakePetsRepository();
+    controller = PetsController(repository: repository);
+    observer = _RecordingNavObserver();
+  });
+
+  Future<void> pumpPage(WidgetTester tester) {
+    return tester.pumpWidget(
+      MaterialApp(
+        theme: buildAppTheme(),
+        navigatorObservers: [observer],
+        home: Scaffold(body: PetsPage(controller: controller)),
+      ),
+    );
+  }
+
+  testWidgets('四态 · loading：拉取期间居中转圈', (tester) async {
+    final completer = Completer<List<Pet>>();
+    repository.listPetsHandler = () => completer.future;
+
+    await pumpPage(tester);
+    await tester.pump();
+
+    expect(find.byType(CircularProgressIndicator), findsOneWidget);
+
+    completer.complete(const []);
+    await tester.pumpAndSettle();
+    expect(find.byType(CircularProgressIndicator), findsNothing);
+  });
+
+  testWidgets('四态 · empty：空态插画 + 建档 CTA 打开 pet_form 表单页', (tester) async {
+    await pumpPage(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.byType(EmptyStateIllustration), findsOneWidget);
+    expect(find.text('还没有宠物档案'), findsOneWidget);
+
+    await tester.tap(find.text('添加宠物'));
+    await tester.pumpAndSettle();
+
+    expect(find.byType(PetFormPage), findsOneWidget);
+    // page_viewed(pet_form) 接线依据：路由名进入既有 RouteObserver 采集。
+    expect(observer.pushedNames.last, 'pet_form');
+  });
+
+  testWidgets('四态 · error/retry：横幅 + 重试按钮，重试后恢复列表', (tester) async {
+    var calls = 0;
+    repository.listPetsHandler = () async {
+      calls++;
+      if (calls == 1) throw const ApiNetworkException('断网');
+      return [buildPet('p-1')];
+    };
+
+    await pumpPage(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.text('网络异常，请检查网络后重试'), findsOneWidget);
+    expect(find.text('重试'), findsOneWidget);
+
+    await tester.tap(find.text('重试'));
+    await tester.pumpAndSettle();
+
+    expect(find.text('豆豆'), findsOneWidget);
+  });
+
+  testWidgets('四态 · ready：列表卡渲染名字与元信息，含添加入口', (tester) async {
+    repository.listPetsHandler = () async => [
+      buildPet('p-1'),
+      buildPet(
+        'p-2',
+        name: '咪咪',
+        overrides: {
+          'species': 'cat',
+          'sex': 'female',
+          'breedId': null,
+          'breedDisplayName': null,
+          'customBreedName': '狸花',
+        },
+      ),
+    ];
+
+    await pumpPage(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.text('我的宠物'), findsOneWidget);
+    expect(find.text('豆豆'), findsOneWidget);
+    expect(find.text('咪咪'), findsOneWidget);
+    expect(find.textContaining('柴犬 · 男孩'), findsOneWidget);
+    expect(find.textContaining('狸花 · 女孩'), findsOneWidget);
+    expect(find.text('＋ 添加宠物'), findsOneWidget);
+    expect(find.text('添加'), findsOneWidget);
+  });
+
+  testWidgets('点宠物卡 → 以 pet_detail 路由名进入详情页', (tester) async {
+    repository.listPetsHandler = () async => [buildPet('p-1')];
+    repository.getPetHandler = (petId) async => buildPet('p-1');
+
+    await pumpPage(tester);
+    await tester.pumpAndSettle();
+
+    await tester.tap(find.text('豆豆'));
+    await tester.pumpAndSettle();
+
+    expect(find.byType(PetDetailPage), findsOneWidget);
+    expect(observer.pushedNames.last, 'pet_detail');
+  });
+
+  testWidgets('非 active 宠物显示状态标签（走失中）', (tester) async {
+    repository.listPetsHandler = () async => [
+      buildPet('p-1', overrides: {'status': 'lost'}),
+    ];
+
+    await pumpPage(tester);
+    await tester.pumpAndSettle();
+
+    expect(find.text('走失中'), findsOneWidget);
+  });
+}