新增:体重录入与历史列表接入真实数据(T2-13 体重半边)

- WeightRecordsPage:cursor 分页(加载更多/末页收起/翻页失败保留重试)、
  loading/empty/error/retry 四态、下拉刷新;viewer 隐藏录入入口
- WeightFormPage:weightKg 契约区间 (0,500] 与两位小数前端校验 + 40000
  兜底;称重时间转 UTC 上送;错误三层分层沿用登录纵切
- health_record 域埋点强类型封装(06 §1.4:create_started/succeeded/
  failed + viewed,httpStatus 由业务码推导;viewed 按工单口径取列表曝光)
- health_record_display 纯函数(体重解析/展示、疫苗状态映射、42201
  规则前端拦截函数);PetsController 暴露 repository(22 号 §7 交接)
- 测试 177 → 205(+28)全绿

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-08 13:17:17 +08:00
parent 97a1f46e3f
commit 5b34fa336b
10 changed files with 1528 additions and 0 deletions
@@ -0,0 +1,85 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:patbond_flutter/features/pets/health_record_analytics.dart';
void main() {
late List<(String, Map<String, dynamic>?)> events;
late HealthRecordAnalytics analytics;
setUp(() {
events = [];
analytics = HealthRecordAnalytics(
(name, [props]) async => events.add((name, props)),
);
});
test('createStartedrecordType + entryPoint 两属性', () {
analytics.createStarted(
recordType: HealthRecordType.weight,
entryPoint: HealthRecordEntryPoint.recordList,
);
expect(events.single.$1, 'health_record_create_started');
expect(events.single.$2, {
'recordType': 'weight',
'entryPoint': 'record_list',
});
});
test('createSucceededdurationMs + photoCountM2 无媒体恒 0', () {
analytics.createSucceeded(
recordType: HealthRecordType.vaccine,
durationMs: 1234,
);
expect(events.single.$1, 'health_record_create_succeeded');
expect(events.single.$2, {
'recordType': 'vaccine',
'durationMs': 1234,
'photoCount': 0,
});
});
test('createFailed:五位业务码推导 httpStatus40904 → 409', () {
analytics.createFailed(
recordType: HealthRecordType.vaccine,
reason: HealthRecordFailureReason.validationError,
attemptSeq: 2,
errorCode: 40904,
);
expect(events.single.$2, {
'recordType': 'vaccine',
'failureReason': 'validation_error',
'attemptSeq': 2,
'errorCode': 40904,
'httpStatus': 409,
});
});
test('createFailed:本地校验/网络失败无 errorCode 时可空属性整体缺席', () {
analytics.createFailed(
recordType: HealthRecordType.weight,
reason: HealthRecordFailureReason.networkError,
attemptSeq: 1,
);
expect(events.single.$2, {
'recordType': 'weight',
'failureReason': 'network_error',
'attemptSeq': 1,
});
});
test('viewedrecordType + sourcehealth_event/reminder 取值随字典)', () {
analytics.viewed(
recordType: HealthRecordType.healthEvent,
source: HealthRecordViewSource.petDetail,
);
expect(events.single.$1, 'health_record_viewed');
expect(events.single.$2, {
'recordType': 'health_event',
'source': 'pet_detail',
});
});
}
@@ -0,0 +1,150 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:patbond_flutter/core/theme/app_theme.dart';
import 'package:patbond_flutter/features/pets/health_record_display.dart';
import 'package:patbond_flutter/features/pets/pet_models.dart';
import '../../helpers/pet_test_helpers.dart';
void main() {
group('parseWeightKgInput(契约 (0,500] 两位小数)', () {
test('合法值:整数、一位、两位小数、上边界 500', () {
expect(parseWeightKgInput('5'), 5);
expect(parseWeightKgInput(' 4.5 '), 4.5);
expect(parseWeightKgInput('4.35'), 4.35);
expect(parseWeightKgInput('500'), 500);
expect(parseWeightKgInput('0.01'), 0.01);
});
test('非法值:0、越界、三位小数、非数字、负数、科学计数', () {
expect(parseWeightKgInput('0'), isNull);
expect(parseWeightKgInput('0.00'), isNull);
expect(parseWeightKgInput('500.01'), isNull);
expect(parseWeightKgInput('4.356'), isNull);
expect(parseWeightKgInput('abc'), isNull);
expect(parseWeightKgInput('-3'), isNull);
expect(parseWeightKgInput('1e2'), isNull);
expect(parseWeightKgInput(''), isNull);
});
});
test('formatWeightKg:去尾零(4.35 / 4.5 / 5 / 400', () {
expect(formatWeightKg(4.35), '4.35');
expect(formatWeightKg(4.50), '4.5');
expect(formatWeightKg(5.00), '5');
expect(formatWeightKg(400), '400');
});
group('疫苗展示映射', () {
test('状态标签与基色(TagPill 三态)', () {
expect(vaccinationStatusLabel(VaccinationStatus.scheduled), '计划中');
expect(vaccinationStatusLabel(VaccinationStatus.completed), '已完成');
expect(vaccinationStatusLabel(VaccinationStatus.cancelled), '已取消');
expect(
vaccinationStatusColor(VaccinationStatus.scheduled),
AppColors.accent,
);
expect(
vaccinationStatusColor(VaccinationStatus.completed),
AppColors.success,
);
expect(
vaccinationStatusColor(VaccinationStatus.cancelled),
AppColors.muted,
);
});
test('剂次标签:doseLabel 优先,缺席回落「第 N 针」', () {
expect(vaccinationDoseLabel(buildVaccination('vx-1')), '第 1 针');
expect(
vaccinationDoseLabel(
buildVaccination('vx-2', overrides: {'doseLabel': '首免'}),
),
'首免',
);
});
test('日期副行:计划 / 接种+下次 / 已取消 三态', () {
expect(vaccinationDateLine(buildVaccination('vx-1')), '计划 2026-10-01');
expect(
vaccinationDateLine(
buildVaccination(
'vx-2',
overrides: {
'status': 'completed',
'plannedOn': null,
'administeredOn': '2026-09-01',
'nextDueOn': '2027-09-01',
},
),
),
'接种 2026-09-01 · 下次 2027-09-01',
);
expect(
vaccinationDateLine(
buildVaccination(
'vx-3',
overrides: {'status': 'cancelled', 'plannedOn': null},
),
),
'已取消',
);
});
});
group('vaccinationDateRuleError42201 规则前端拦截)', () {
test('scheduled 缺 plannedOn 拦截;补齐通过', () {
expect(
vaccinationDateRuleError(status: VaccinationStatus.scheduled),
'请选择计划接种日期',
);
expect(
vaccinationDateRuleError(
status: VaccinationStatus.scheduled,
plannedOn: DateTime(2026, 10),
),
isNull,
);
});
test('completed 缺 administeredOn 拦截(未填接种日期就标完成)', () {
expect(
vaccinationDateRuleError(status: VaccinationStatus.completed),
'请选择接种日期',
);
expect(
vaccinationDateRuleError(
status: VaccinationStatus.completed,
administeredOn: DateTime(2026, 9, 1),
),
isNull,
);
});
test('nextDueOn 早于 administeredOn 拦截;同日与晚于通过', () {
expect(
vaccinationDateRuleError(
status: VaccinationStatus.completed,
administeredOn: DateTime(2026, 9, 8),
nextDueOn: DateTime(2026, 9, 7),
),
'下次接种日期不能早于接种日期',
);
expect(
vaccinationDateRuleError(
status: VaccinationStatus.completed,
administeredOn: DateTime(2026, 9, 8),
nextDueOn: DateTime(2026, 9, 8),
),
isNull,
);
expect(
vaccinationDateRuleError(
status: VaccinationStatus.completed,
administeredOn: DateTime(2026, 9, 8),
nextDueOn: DateTime(2027, 9, 8),
),
isNull,
);
});
});
}
@@ -0,0 +1,195 @@
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/health_record_analytics.dart';
import 'package:patbond_flutter/features/pets/pet_exceptions.dart';
import 'package:patbond_flutter/features/pets/pet_models.dart';
import 'package:patbond_flutter/features/pets/weight_form_page.dart';
import '../../helpers/pet_test_helpers.dart';
void main() {
late FakePetsRepository repository;
late List<(String, Map<String, dynamic>?)> events;
late HealthRecordAnalytics analytics;
setUp(() {
repository = FakePetsRepository();
events = [];
analytics = HealthRecordAnalytics(
(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) async {
tester.view.physicalSize = const Size(700, 1600);
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: (_) => WeightFormPage(
repository: repository,
petId: 'p-1',
analytics: analytics,
),
),
),
);
await tester.pumpAndSettle();
}
Finder weightField() => find.widgetWithText(TextFormField, '体重(公斤)');
testWidgets('空值提交拦截 + failed(validation_error)', (tester) async {
await pumpForm(tester);
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
expect(find.text('请输入体重'), findsOneWidget);
final failed = eventsOf('health_record_create_failed');
expect(failed.single!['recordType'], 'weight');
expect(failed.single!['failureReason'], 'validation_error');
expect(failed.single!['attemptSeq'], 1);
});
testWidgets('契约区间前端拦截:>500 与三位小数均不放行、不发请求', (tester) async {
var createCalls = 0;
repository.createWeightHandler = (petId, request) async {
createCalls++;
return buildWeight('w-x');
};
await pumpForm(tester);
await tester.enterText(weightField(), '500.5');
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
expect(find.text('体重需大于 0 且不超过 500 公斤,最多两位小数'), findsOneWidget);
await tester.enterText(weightField(), '4.356');
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
expect(find.text('体重需大于 0 且不超过 500 公斤,最多两位小数'), findsOneWidget);
expect(createCalls, 0);
expect(eventsOf('health_record_create_failed'), hasLength(2));
});
testWidgets('首次输入触发 started(每次进入仅一次,recordType=weight', (tester) async {
await pumpForm(tester);
expect(eventsOf('health_record_create_started'), isEmpty);
await tester.enterText(weightField(), '4');
await tester.enterText(weightField(), '4.3');
await tester.pumpAndSettle();
final started = eventsOf('health_record_create_started');
expect(started, hasLength(1));
expect(started.single, {
'recordType': 'weight',
'entryPoint': 'record_list',
});
});
testWidgets('保存成功:请求对齐契约(UTC 时间戳、note 可选)、pop 回列表、succeeded', (tester) async {
CreateWeightRequest? captured;
repository.createWeightHandler = (petId, request) async {
expect(petId, 'p-1');
captured = request;
return buildWeight('w-new', weightKg: 4.35);
};
await pumpForm(tester);
await tester.enterText(weightField(), '4.35');
await tester.enterText(
find.widgetWithText(TextFormField, '备注(可选,如:饭后称重)'),
'饭后',
);
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
final json = captured!.toJson();
expect(json['weightKg'], 4.35);
expect(json['note'], '饭后');
// 今日称重取此刻并转 UTC(ISO 带 Z 后缀,避免服务端时区歧义)。
expect(json['measuredAt'], endsWith('Z'));
expect(json.containsKey('source'), isFalse);
expect(find.text('列表基底'), findsOneWidget);
final succeeded = eventsOf('health_record_create_succeeded');
expect(succeeded.single!['recordType'], 'weight');
expect(succeeded.single!['durationMs'], isA<int>());
expect(succeeded.single!['photoCount'], 0);
});
testWidgets('40000 后端兜底:横幅提示 + failed 带 errorCode/httpStatus', (
tester,
) async {
repository.createWeightHandler = (petId, request) async =>
throw const ApiBusinessException(code: 40000, message: '参数校验失败');
await pumpForm(tester);
await tester.enterText(weightField(), '4.35');
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
expect(find.text('请检查填写内容后重试'), findsOneWidget);
expect(find.byType(WeightFormPage), findsOneWidget);
final failed = eventsOf('health_record_create_failed');
expect(failed.single!['errorCode'], 40000);
expect(failed.single!['httpStatus'], 400);
expect(failed.single!['failureReason'], 'validation_error');
});
testWidgets('40300 viewer 越权兜底:横幅 + failed(permission_denied)', (
tester,
) async {
repository.createWeightHandler = (petId, request) async =>
throw const PetAccessDeniedException(message: '无权限');
await pumpForm(tester);
await tester.enterText(weightField(), '4.35');
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
expect(find.text('你没有权限为该宠物添加记录'), findsOneWidget);
expect(
eventsOf('health_record_create_failed').single!['failureReason'],
'permission_denied',
);
});
testWidgets('网络异常:SnackBar + 重试动作 + failed(network_error)', (tester) async {
repository.createWeightHandler = (petId, request) async =>
throw const ApiNetworkException('断网');
await pumpForm(tester);
await tester.enterText(weightField(), '4.35');
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
expect(find.text('网络异常,请检查网络后重试'), findsOneWidget);
expect(find.text('重试'), findsOneWidget);
expect(
eventsOf('health_record_create_failed').single!['failureReason'],
'network_error',
);
});
}
@@ -0,0 +1,206 @@
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/health_record_analytics.dart';
import 'package:patbond_flutter/features/pets/pet_models.dart';
import 'package:patbond_flutter/features/pets/weight_form_page.dart';
import 'package:patbond_flutter/features/pets/weight_records_page.dart';
import '../../helpers/pet_test_helpers.dart';
void main() {
late FakePetsRepository repository;
late List<(String, Map<String, dynamic>?)> events;
late HealthRecordAnalytics analytics;
setUp(() {
repository = FakePetsRepository();
events = [];
analytics = HealthRecordAnalytics(
(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> pumpPage(WidgetTester tester, {bool canWrite = true}) async {
tester.view.physicalSize = const Size(700, 1600);
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: (_) => WeightRecordsPage(
repository: repository,
petId: 'p-1',
canWrite: canWrite,
analytics: analytics,
),
),
),
);
await tester.pump();
}
CursorPage<WeightRecord> page(
List<WeightRecord> items, {
String? nextCursor,
bool hasMore = false,
}) => CursorPage(items: items, nextCursor: nextCursor, hasMore: hasMore);
testWidgets('四态 · loading → ready:条目渲染体重值与时间;viewed 上报一次', (tester) async {
final completer = Completer<CursorPage<WeightRecord>>();
repository.listWeightsHandler = (petId, limit, cursor) => completer.future;
await pumpPage(tester);
await tester.pump();
expect(find.byType(CircularProgressIndicator), findsOneWidget);
completer.complete(
page([
buildWeight('w-1', weightKg: 4.35),
buildWeight('w-2', weightKg: 4.2, overrides: {'note': '洗澡后'}),
]),
);
await tester.pumpAndSettle();
expect(find.text('4.35 kg'), findsOneWidget);
expect(find.text('4.2 kg'), findsOneWidget);
expect(find.textContaining('洗澡后'), findsOneWidget);
// 列表曝光(每次进入一次),source=pet_detail。
final viewed = eventsOf('health_record_viewed');
expect(viewed.single, {'recordType': 'weight', 'source': 'pet_detail'});
});
testWidgets('四态 · empty:空态插画 + 记录 CTAcanWrite', (tester) async {
repository.listWeightsHandler = (petId, limit, cursor) async =>
page(const []);
await pumpPage(tester);
await tester.pumpAndSettle();
expect(find.byType(EmptyStateIllustration), findsOneWidget);
expect(find.text('还没有体重记录'), findsOneWidget);
expect(find.text('记录第一条'), findsOneWidget);
});
testWidgets('四态 · error/retry:横幅 + 重试恢复', (tester) async {
var calls = 0;
repository.listWeightsHandler = (petId, limit, cursor) async {
calls++;
if (calls == 1) throw const ApiNetworkException('断网');
return page([buildWeight('w-1')]);
};
await pumpPage(tester);
await tester.pumpAndSettle();
expect(find.text('网络异常,请检查网络后重试'), findsOneWidget);
await tester.tap(find.text('重试'));
await tester.pumpAndSettle();
expect(find.text('4.35 kg'), findsOneWidget);
// 失败后的首个成功加载才计一次曝光。
expect(eventsOf('health_record_viewed'), hasLength(1));
});
testWidgets('cursor 分页:加载更多追加下一页并透传游标,末页收起按钮', (tester) async {
final cursors = <String?>[];
repository.listWeightsHandler = (petId, limit, cursor) async {
cursors.add(cursor);
if (cursor == null) {
return page(
[buildWeight('w-1')],
nextCursor: 'CURSOR-1',
hasMore: true,
);
}
return page([buildWeight('w-2', weightKg: 4.1)]);
};
await pumpPage(tester);
await tester.pumpAndSettle();
expect(find.text('加载更多'), findsOneWidget);
await tester.tap(find.text('加载更多'));
await tester.pumpAndSettle();
expect(cursors, [null, 'CURSOR-1']);
expect(find.text('4.35 kg'), findsOneWidget);
expect(find.text('4.1 kg'), findsOneWidget);
expect(find.text('加载更多'), findsNothing);
});
testWidgets('加载更多失败:SnackBar 提示,按钮保留可再试', (tester) async {
var calls = 0;
repository.listWeightsHandler = (petId, limit, cursor) async {
calls++;
if (calls == 1) {
return page([buildWeight('w-1')], nextCursor: 'C1', hasMore: true);
}
throw const ApiNetworkException('断网');
};
await pumpPage(tester);
await tester.pumpAndSettle();
await tester.tap(find.text('加载更多'));
await tester.pumpAndSettle();
expect(find.text('网络异常,请检查网络后重试'), findsOneWidget);
expect(find.text('加载更多'), findsOneWidget);
});
testWidgets('viewercanWrite=false):无添加入口、空态无 CTA', (tester) async {
repository.listWeightsHandler = (petId, limit, cursor) async =>
page(const []);
await pumpPage(tester, canWrite: false);
await tester.pumpAndSettle();
expect(find.byIcon(Icons.add), findsNothing);
expect(find.text('记录第一条'), findsNothing);
});
testWidgets('录入闭环:添加 → 表单(record_form 路由名)→ 成功后插入列表头', (tester) async {
repository.listWeightsHandler = (petId, limit, cursor) async =>
page([buildWeight('w-1')]);
repository.createWeightHandler = (petId, request) async =>
buildWeight('w-new', weightKg: 4.6);
await pumpPage(tester);
await tester.pumpAndSettle();
await tester.tap(find.byIcon(Icons.add));
await tester.pumpAndSettle();
expect(find.byType(WeightFormPage), findsOneWidget);
final route = ModalRoute.of(tester.element(find.byType(WeightFormPage)))!;
expect(route.settings.name, 'record_form');
await tester.enterText(find.widgetWithText(TextFormField, '体重(公斤)'), '4.6');
await tester.tap(find.text('保存记录'));
await tester.pumpAndSettle();
expect(find.byType(WeightFormPage), findsNothing);
expect(find.text('已记录体重'), findsOneWidget);
expect(find.text('4.6 kg'), findsOneWidget);
expect(find.text('4.35 kg'), findsOneWidget);
});
}