重构:宠物列表/详情/编辑页接入真实数据(T2-12,四态齐备)
CI / flutter-gates (push) Successful in 1m31s

- 档案 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>
This commit is contained in:
2026-09-08 12:15:32 +08:00
parent c0a8a56e91
commit 97a1f46e3f
17 changed files with 2249 additions and 852 deletions
@@ -0,0 +1,179 @@
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_detail_page.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;
setUp(() {
repository = FakePetsRepository();
controller = PetsController(repository: repository);
});
Future<void> pumpDetail(WidgetTester tester, {String petId = 'p-1'}) async {
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: (_) => PetDetailPage(controller: controller, petId: petId),
),
),
);
await tester.pump();
}
testWidgets('ready:档案字段齐备,owner 可见编辑入口', (tester) async {
repository.getPetHandler = (petId) async => buildPet(
'p-1',
overrides: {
'microchipNo': '985112000000001',
'personality': '活泼',
'sterilizedOn': '2025-06-01',
},
);
await pumpDetail(tester);
await tester.pumpAndSettle();
expect(find.text('豆豆'), findsOneWidget);
expect(find.text('基本资料'), findsOneWidget);
expect(find.text('柴犬'), findsOneWidget);
expect(find.text('男孩'), findsOneWidget);
expect(find.text('2024-03-15'), findsOneWidget);
expect(find.text('985112000000001'), findsOneWidget);
expect(find.text('活泼'), findsOneWidget);
expect(find.text('2025-06-01'), findsOneWidget);
expect(find.byIcon(Icons.edit_outlined), findsWidgets);
expect(find.text('编辑资料'), findsOneWidget);
});
testWidgets('生日估算标记与未填写字段兜底', (tester) async {
repository.getPetHandler = (petId) async =>
buildPet('p-1', overrides: {'birthDateEstimated': true});
await pumpDetail(tester);
await tester.pumpAndSettle();
expect(find.text('2024-03-15(估算)'), findsOneWidget);
// 芯片号 / 性格 / 绝育日期未填。
expect(find.text('未填写'), findsNWidgets(3));
});
testWidgets('四态 · loading:无内存副本时居中转圈', (tester) async {
final completer = Completer<Pet>();
repository.getPetHandler = (petId) => completer.future;
await pumpDetail(tester);
await tester.pump();
expect(find.byType(CircularProgressIndicator), findsOneWidget);
completer.complete(buildPet('p-1'));
await tester.pumpAndSettle();
expect(find.text('豆豆'), findsOneWidget);
});
testWidgets('四态 · error/retry:无副本加载失败给横幅与重试', (tester) async {
var calls = 0;
repository.getPetHandler = (petId) async {
calls++;
if (calls == 1) throw const ApiNetworkException('断网');
return buildPet('p-1');
};
await pumpDetail(tester);
await tester.pumpAndSettle();
expect(find.text('网络异常,请检查网络后重试'), findsOneWidget);
await tester.tap(find.text('重试'));
await tester.pumpAndSettle();
expect(find.text('豆豆'), findsOneWidget);
});
testWidgets('四态 · notFound(40401):提示不存在,返回列表并触发刷新', (tester) async {
repository.getPetHandler = (petId) async =>
throw const PetNotFoundException(message: '不存在');
var listCalls = 0;
repository.listPetsHandler = () async {
listCalls++;
return const [];
};
await pumpDetail(tester);
await tester.pumpAndSettle();
expect(find.text('宠物不存在或已被删除'), findsOneWidget);
await tester.tap(find.text('返回列表'));
await tester.pumpAndSettle();
expect(find.byType(PetDetailPage), findsNothing);
expect(find.text('列表基底'), findsOneWidget);
expect(listCalls, 1);
});
testWidgets('有内存副本时先渲染副本;后台刷新失败降级 SnackBar', (tester) async {
repository.listPetsHandler = () async => [buildPet('p-1')];
await controller.refresh();
final completer = Completer<Pet>();
repository.getPetHandler = (petId) => completer.future;
await pumpDetail(tester);
await tester.pump();
// 副本即时渲染,无整页 loading。
expect(find.text('豆豆'), findsOneWidget);
expect(find.byType(CircularProgressIndicator), findsNothing);
completer.completeError(const ApiNetworkException('断网'));
await tester.pumpAndSettle();
expect(find.text('豆豆'), findsOneWidget);
expect(find.text('网络异常,请检查网络后重试'), findsOneWidget);
});
testWidgets('viewer 角色隐藏全部编辑入口(40300 语义)', (tester) async {
repository.getPetHandler = (petId) async =>
buildPet('p-1', overrides: {'myRole': 'viewer'});
await pumpDetail(tester);
await tester.pumpAndSettle();
expect(find.byIcon(Icons.edit_outlined), findsNothing);
expect(find.text('编辑资料'), findsNothing);
expect(find.byIcon(Icons.edit), findsNothing);
});
testWidgets('owner 点编辑 → 进入编辑表单并预填', (tester) async {
repository.getPetHandler = (petId) async => buildPet('p-1');
await pumpDetail(tester);
await tester.pumpAndSettle();
await tester.tap(find.text('编辑资料'));
await tester.pumpAndSettle();
expect(find.byType(PetFormPage), findsOneWidget);
expect(find.text('编辑宠物资料'), findsOneWidget);
expect(find.text('豆豆'), findsOneWidget);
});
}