zhaoyuxi/patbond-flutter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

新增：体重录入与历史列表接入真实数据（T2-13 体重半边）

Browse Source 
- 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:
Lixi20
2026-09-08 13:17:17 +08:00
parent 97a1f46e3f
commit 5b34fa336b
10 changed files with 1528 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lib/features/pets/health_record_analytics.dart
+125
View File
@@ -0,0 +1,125 @@
import 'package:patbond_flutter/analytics/page_view_tracker.dart';
/// health_record 域埋点强类型封装（06 号规划 §1.4 字典 v2；后端白名单
/// 已扩充就绪，24 号报告 §2.2）。沿用 13 号规范 §3.1 惯例：枚举编译期
/// 锁死，业务代码禁止手拼事件名与属性。
///
/// T2-13 挂接创建漏斗三事件 + viewed；edit/deleted 事件的挂接随
/// 编辑/删除交互落地（「标记完成」等）另行接线，见 25 号报告遗留。
/// 记录类型（06 §1.4 recordType 枚举，四类记录接口对应）。
enum HealthRecordType {
weight('weight'),
vaccine('vaccine'),
healthEvent('health_event'),
reminder('reminder');
const HealthRecordType(this.value);
final String value;
}
/// 记录创建入口（06 §1.4 entryPoint 枚举）。
enum HealthRecordEntryPoint {
petDetail('pet_detail'),
recordList('record_list'),
reminder('reminder');
const HealthRecordEntryPoint(this.value);
final String value;
}
/// 创建失败原因（06 §1.4 基底 + M2 验收新增三值）。与 pet 域同款
/// 网络归并口径：断网/超时/5xx 均并入 network_error，server_error
/// 保留给无法归类的兜底。
enum HealthRecordFailureReason {
validationError('validation_error'),
permissionDenied('permission_denied'),
notFound('not_found'),
rateLimited('rate_limited'),
networkError('network_error'),
serverError('server_error');
const HealthRecordFailureReason(this.value);
final String value;
}
/// viewed 的来源（06 §1.4 source 枚举）。
enum HealthRecordViewSource {
recordList('record_list'),
petDetail('pet_detail'),
reminder('reminder');
const HealthRecordViewSource(this.value);
final String value;
}
class HealthRecordAnalytics {
HealthRecordAnalytics(this._track);
/// 生产传 `AnalyticsService.trackEvent`，测试传录制桩。
final TrackEventFn _track;
/// 进入某类记录的创建表单并产生首次输入（每次进入记一次，表单层去重）。
void createStarted({
required HealthRecordType recordType,
required HealthRecordEntryPoint entryPoint,
}) {
_track('health_record_create_started', {
'recordType': recordType.value,
'entryPoint': entryPoint.value,
});
}
/// 创建接口成功响应（漏斗事件，北极星与 H1/H3/H4 的核心数据源）。
///
/// [photoCount] 无照片为 0（M2 不做媒体上传，恒 0，字段随字典保留）。
void createSucceeded({
required HealthRecordType recordType,
required int durationMs,
int photoCount = 0,
}) {
_track('health_record_create_succeeded', {
'recordType': recordType.value,
'durationMs': durationMs,
'photoCount': photoCount,
});
}
/// 创建失败：失败响应 / 超时 / 本地校验拦截。
///
/// [errorCode] 为业务错误码（本地校验/网络错误时缺席）；
/// [httpStatus] 由五位业务码推导（`code ~/ 100`）；
/// [attemptSeq] 为本次表单会话内第几次提交尝试（从 1 起）。
void createFailed({
required HealthRecordType recordType,
required HealthRecordFailureReason reason,
required int attemptSeq,
int? errorCode,
}) {
_track('health_record_create_failed', {
'recordType': recordType.value,
'failureReason': reason.value,
'attemptSeq': attemptSeq,
'errorCode': ?errorCode,
if (errorCode != null && errorCode >= 10000)
'httpStatus': errorCode ~/ 100,
});
}
/// 记录曝光。06 §1.4 定义在详情页可见；M2 体重/疫苗无独立详情页，
/// 以「列表页每次进入首个成功加载」为曝光时点（每次进入一次、
/// 不随滚动逐条上报，防事件洪水的意图不变）。
void viewed({
required HealthRecordType recordType,
required HealthRecordViewSource source,
}) {
_track('health_record_viewed', {
'recordType': recordType.value,
'source': source.value,
});
}
}
lib/features/pets/health_record_display.dart
+86
View File
@@ -0,0 +1,86 @@
/// 体重 / 疫苗展示与输入解析的纯函数集合（列表 / 表单共用，可单测）。
library;
import 'package:flutter/material.dart';
import 'package:patbond_flutter/core/theme/app_theme.dart';
import 'package:patbond_flutter/features/pets/pet_models.dart';
/// 体重输入解析：契约区间 (0, 500]、最多两位小数（numeric(6,2)）。
/// 非法（非数字、越界、三位小数）返回 null，由表单层给 errorText。
double? parseWeightKgInput(String raw) {
final text = raw.trim();
if (!RegExp(r'^\d{1,3}(\.\d{1,2})?$').hasMatch(text)) return null;
final value = double.parse(text);
if (value <= 0 || value > 500) return null;
return value;
}
/// 体重展示：去掉无意义尾零（4.35 → 4.35、5.00 → 5、4.50 → 4.5）。
String formatWeightKg(double weightKg) {
var text = weightKg.toStringAsFixed(2);
if (text.contains('.')) {
text = text.replaceFirst(RegExp(r'0+$'), '');
text = text.replaceFirst(RegExp(r'\.$'), '');
}
return text;
}
String vaccinationStatusLabel(VaccinationStatus status) => switch (status) {
VaccinationStatus.scheduled => '计划中',
VaccinationStatus.completed => '已完成',
VaccinationStatus.cancelled => '已取消',
};
/// 状态标签基色（TagPill 淡染底；文字深变体由 TagPill 内置映射）。
Color vaccinationStatusColor(VaccinationStatus status) => switch (status) {
VaccinationStatus.scheduled => AppColors.accent,
VaccinationStatus.completed => AppColors.success,
VaccinationStatus.cancelled => AppColors.muted,
};
/// 剂次展示：doseLabel 优先，缺席回落「第 N 针」。
String vaccinationDoseLabel(Vaccination vaccination) =>
vaccination.doseLabel ?? '第 ${vaccination.doseNo} 针';
/// 疫苗条目副行：按状态给日期语义（计划 / 接种 + 下次到期 / 取消）。
String vaccinationDateLine(
Vaccination vaccination,
) => switch (vaccination.status) {
VaccinationStatus.scheduled =>
'计划 ${vaccination.plannedOn == null ? '未定' : dateToJson(vaccination.plannedOn!)}',
VaccinationStatus.completed =>
'接种 ${vaccination.administeredOn == null ? '—' : dateToJson(vaccination.administeredOn!)}'
'${vaccination.nextDueOn == null ? '' : ' · 下次 ${dateToJson(vaccination.nextDueOn!)}'}',
VaccinationStatus.cancelled => '已取消',
};
/// 摘要疫苗进度展示：契约 null 语义——无登记为 null（不是 0/0），
/// 调用方对 null 自行给空态文案。
String vaccinationProgressLabel(SummaryVaccinationProgress progress) =>
'${progress.completedDoses}/${progress.totalDoses}';
/// 疫苗状态-日期规则前端校验（契约 42201 规则的前置拦截；纯函数可单测）：
/// scheduled 必有 plannedOn；completed 必有 administeredOn；
/// nextDueOn 与 administeredOn 同时存在时须 nextDueOn ≥ administeredOn。
/// 通过返回 null，违反返回给用户的拦截文案。
String? vaccinationDateRuleError({
required VaccinationStatus status,
DateTime? plannedOn,
DateTime? administeredOn,
DateTime? nextDueOn,
}) {
if (status == VaccinationStatus.scheduled && plannedOn == null) {
return '请选择计划接种日期';
}
if (status == VaccinationStatus.completed && administeredOn == null) {
return '请选择接种日期';
}
if (administeredOn != null &&
nextDueOn != null &&
nextDueOn.isBefore(
DateTime(administeredOn.year, administeredOn.month, administeredOn.day),
)) {
return '下次接种日期不能早于接种日期';
}
return null;
}
lib/features/pets/pets_controller.dart
+4
View File
@@ -21,6 +21,10 @@ class PetsController extends ChangeNotifier {
final PetsRepository _repository;
/// 记录级页面（体重/疫苗/事件/提醒）直接经仓库取数（22 号报告 §7
/// 交接约定：页面级状态按页自建，不膨胀本控制器）。
PetsRepository get repository => _repository;
PetsLoadPhase _phase = PetsLoadPhase.initial;
List<Pet> _pets = const [];
ApiException? _lastError;
lib/features/pets/weight_form_page.dart
+288
View File
@@ -0,0 +1,288 @@
import 'package:flutter/material.dart';
import 'package:flutter/semantics.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/app_text_field.dart';
import 'package:patbond_flutter/core/widgets/inline_error_banner.dart';
import 'package:patbond_flutter/core/widgets/primary_button.dart';
import 'package:patbond_flutter/features/pets/health_record_analytics.dart';
import 'package:patbond_flutter/features/pets/health_record_display.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/pets_repository.dart';
/// 体重录入表单页（T2-13）。
///
/// - `weightKg` 前端校验对齐契约：(0, 500]、最多两位小数；后端 40000 兜底。
/// - 称重时间默认「现在」，可回选日期（非今日取当日 12:00，保持
/// measured_at DESC 排序直觉）；提交前转 UTC，ISO 8601 带 Z 上送。
/// - 错误分层沿用登录纵切：字段 errorText / InlineErrorBanner / SnackBar。
/// - 埋点：首次输入 health_record_create_started(recordType=weight)，
/// 成功/失败按 06 §1.4 经 [HealthRecordAnalytics] 上报。
class WeightFormPage extends StatefulWidget {
const WeightFormPage({
required this.repository,
required this.petId,
super.key,
this.analytics,
this.entryPoint = HealthRecordEntryPoint.recordList,
});
final PetsRepository repository;
final String petId;
final HealthRecordAnalytics? analytics;
final HealthRecordEntryPoint entryPoint;
@override
State<WeightFormPage> createState() => _WeightFormPageState();
}
class _WeightFormPageState extends State<WeightFormPage> {
final _weightCtrl = TextEditingController();
final _noteCtrl = TextEditingController();
DateTime _measuredDate = DateTime.now();
String? _weightError;
String? _formError;
bool _submitting = false;
bool _startedFired = false;
int _attemptSeq = 0;
late final DateTime _openedAt;
@override
void initState() {
super.initState();
_openedAt = DateTime.now();
}
@override
void dispose() {
_weightCtrl.dispose();
_noteCtrl.dispose();
super.dispose();
}
void _markStarted() {
if (_startedFired) return;
_startedFired = true;
widget.analytics?.createStarted(
recordType: HealthRecordType.weight,
entryPoint: widget.entryPoint,
);
}
void _trackFailed(HealthRecordFailureReason reason, [int? errorCode]) {
widget.analytics?.createFailed(
recordType: HealthRecordType.weight,
reason: reason,
attemptSeq: _attemptSeq,
errorCode: errorCode,
);
}
String? _validateWeight() {
final text = _weightCtrl.text.trim();
if (text.isEmpty) return '请输入体重';
if (parseWeightKgInput(text) == null) {
return '体重需大于 0 且不超过 500 公斤，最多两位小数';
}
return null;
}
void _showFormError(String message) {
setState(() => _formError = message);
SemanticsService.sendAnnouncement(
View.of(context),
message,
TextDirection.ltr,
);
}
/// 称重时刻：今日取此刻，历史日期取当日 12:00（本地），提交前转 UTC。
DateTime _measuredAt() {
final now = DateTime.now();
final sameDay =
_measuredDate.year == now.year &&
_measuredDate.month == now.month &&
_measuredDate.day == now.day;
final local = sameDay
? now
: DateTime(
_measuredDate.year,
_measuredDate.month,
_measuredDate.day,
12,
);
return local.toUtc();
}
Future<void> _submit() async {
if (_submitting) return;
_attemptSeq++;
final weightError = _validateWeight();
if (weightError != null) {
setState(() => _weightError = weightError);
_trackFailed(HealthRecordFailureReason.validationError);
return;
}
setState(() {
_submitting = true;
_formError = null;
});
try {
final note = _noteCtrl.text.trim();
final record = await widget.repository.createWeight(
widget.petId,
CreateWeightRequest(
weightKg: parseWeightKgInput(_weightCtrl.text)!,
measuredAt: _measuredAt(),
note: note.isEmpty ? null : note,
),
);
widget.analytics?.createSucceeded(
recordType: HealthRecordType.weight,
durationMs: DateTime.now().difference(_openedAt).inMilliseconds,
);
if (mounted) Navigator.of(context).pop(record);
} on PetAccessDeniedException {
if (!mounted) return;
_showFormError('你没有权限为该宠物添加记录');
_trackFailed(HealthRecordFailureReason.permissionDenied, 40300);
} on PetNotFoundException {
if (!mounted) return;
final navigator = Navigator.of(context);
ScaffoldMessenger.of(
context,
).showSnackBar(const SnackBar(content: Text('宠物不存在或已被删除')));
_trackFailed(HealthRecordFailureReason.notFound, 40401);
navigator.pop();
} on ApiRateLimitException {
if (!mounted) return;
_showFormError('操作过于频繁，请稍后再试');
_trackFailed(HealthRecordFailureReason.rateLimited);
} on ApiBusinessException catch (error) {
if (!mounted) return;
final isParam = error.code == ApiCodes.paramError;
_showFormError(isParam ? '请检查填写内容后重试' : '保存失败，请稍后重试');
_trackFailed(
isParam
? HealthRecordFailureReason.validationError
: HealthRecordFailureReason.serverError,
error.code,
);
} on ApiNetworkException {
if (!mounted) return;
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: const Text('网络异常，请检查网络后重试'),
action: SnackBarAction(label: '重试', onPressed: _submit),
),
);
_trackFailed(HealthRecordFailureReason.networkError);
} on SessionExpiredException {
// 会话失效：认证状态机自动回登录页。
} finally {
if (mounted) setState(() => _submitting = false);
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
backgroundColor: Colors.transparent,
elevation: 0,
foregroundColor: AppColors.ink,
title: const Text('记录体重'),
centerTitle: true,
titleTextStyle: const TextStyle(
color: AppColors.ink,
fontSize: 16,
fontWeight: FontWeight.w800,
),
),
body: SafeArea(
child: ListView(
padding: const EdgeInsets.fromLTRB(20, 8, 20, 30),
children: [
AppTextField(
label: '体重（公斤）',
controller: _weightCtrl,
prefixIcon: Icons.monitor_weight_outlined,
errorText: _weightError,
helperText: '大于 0 且不超过 500，最多两位小数',
enabled: !_submitting,
keyboardType: const TextInputType.numberWithOptions(
decimal: true,
),
textInputAction: TextInputAction.next,
onChanged: (_) {
_markStarted();
if (_weightError != null || _formError != null) {
setState(() {
_weightError = null;
_formError = null;
});
}
},
),
const SizedBox(height: 14),
ListTile(
shape: RoundedRectangleBorder(
side: const BorderSide(color: AppColors.border),
borderRadius: BorderRadius.circular(AppRadius.lg),
),
tileColor: AppColors.surface,
leading: const Icon(Icons.event_outlined, color: AppColors.muted),
title: const Text('称重日期', style: TextStyle(fontSize: 14)),
subtitle: Text(
dateToJson(_measuredDate),
style: const TextStyle(color: AppColors.inkSoft, fontSize: 12),
),
trailing: const Icon(
Icons.calendar_month_outlined,
color: AppColors.muted,
),
enabled: !_submitting,
onTap: () async {
final now = DateTime.now();
final value = await showDatePicker(
context: context,
initialDate: _measuredDate,
firstDate: DateTime(1990),
lastDate: now,
);
if (value != null && mounted) {
_markStarted();
setState(() => _measuredDate = value);
}
},
),
const SizedBox(height: 14),
AppTextField(
label: '备注（可选，如：饭后称重）',
controller: _noteCtrl,
prefixIcon: Icons.sticky_note_2_outlined,
enabled: !_submitting,
textInputAction: TextInputAction.done,
onChanged: (_) => _markStarted(),
onSubmitted: (_) => _submit(),
),
if (_formError != null) ...[
const SizedBox(height: 16),
InlineErrorBanner(message: _formError!),
],
const SizedBox(height: 24),
PrimaryButton(
label: '保存记录',
isLoading: _submitting,
onPressed: _submit,
),
],
),
),
);
}
}
lib/features/pets/weight_records_page.dart
+294
View File
@@ -0,0 +1,294 @@
import 'package:flutter/material.dart';
import 'package:patbond_flutter/analytics/analytics_page_name.dart';
import 'package:patbond_flutter/core/navigation/fade_route.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/core/widgets/inline_error_banner.dart';
import 'package:patbond_flutter/core/widgets/record_type_dot.dart';
import 'package:patbond_flutter/features/pets/health_record_analytics.dart';
import 'package:patbond_flutter/features/pets/health_record_display.dart';
import 'package:patbond_flutter/features/pets/pet_display.dart';
import 'package:patbond_flutter/features/pets/pet_models.dart';
import 'package:patbond_flutter/features/pets/pets_repository.dart';
import 'package:patbond_flutter/features/pets/weight_form_page.dart';
enum _ListPhase { loading, ready, error }
/// 体重历史列表页（T2-13）：cursor 分页（「加载更多」追加，末页收起），
/// 四态齐备；新记录经 [WeightFormPage] 录入后就地插入列表头。
///
/// 曝光埋点：每次进入首个成功加载上报一次
/// `health_record_viewed(recordType=weight, source=pet_detail)`
/// （工单口径：列表曝光；不随滚动逐条上报）。
class WeightRecordsPage extends StatefulWidget {
const WeightRecordsPage({
required this.repository,
required this.petId,
required this.canWrite,
super.key,
this.analytics,
this.pageSize,
});
final PetsRepository repository;
final String petId;
/// owner/caregiver 可写；viewer 隐藏录入入口（40300 语义前置）。
final bool canWrite;
final HealthRecordAnalytics? analytics;
/// 每页条数（测试注入小页验证分页；缺省走服务端默认 20）。
final int? pageSize;
@override
State<WeightRecordsPage> createState() => _WeightRecordsPageState();
}
class _WeightRecordsPageState extends State<WeightRecordsPage> {
_ListPhase _phase = _ListPhase.loading;
List<WeightRecord> _records = const [];
String? _nextCursor;
bool _hasMore = false;
bool _loadingMore = false;
ApiException? _error;
bool _viewedFired = false;
@override
void initState() {
super.initState();
_loadFirstPage();
}
Future<void> _loadFirstPage() async {
setState(() {
_phase = _ListPhase.loading;
_error = null;
});
try {
final page = await widget.repository.listWeights(
widget.petId,
limit: widget.pageSize,
);
if (!mounted) return;
setState(() {
_records = page.items;
_nextCursor = page.nextCursor;
_hasMore = page.hasMore;
_phase = _ListPhase.ready;
});
if (!_viewedFired) {
_viewedFired = true;
widget.analytics?.viewed(
recordType: HealthRecordType.weight,
source: HealthRecordViewSource.petDetail,
);
}
} on ApiException catch (error) {
if (!mounted) return;
setState(() {
_error = error;
_phase = _ListPhase.error;
});
}
}
Future<void> _loadMore() async {
if (_loadingMore || !_hasMore) return;
setState(() => _loadingMore = true);
try {
final page = await widget.repository.listWeights(
widget.petId,
limit: widget.pageSize,
cursor: _nextCursor,
);
if (!mounted) return;
setState(() {
_records = [..._records, ...page.items];
_nextCursor = page.nextCursor;
_hasMore = page.hasMore;
});
} on ApiException catch (error) {
if (!mounted) return;
ScaffoldMessenger.of(
context,
).showSnackBar(SnackBar(content: Text(petLoadErrorMessage(error))));
} finally {
if (mounted) setState(() => _loadingMore = false);
}
}
Future<void> _openCreate() async {
final created = await Navigator.of(context).push<WeightRecord>(
fadePageRoute(
WeightFormPage(
repository: widget.repository,
petId: widget.petId,
analytics: widget.analytics,
),
// record_form：健康记录漏斗到达段页名（06 §1.6 / §2.2）。
settings: RouteSettings(name: AnalyticsPageName.recordForm.pageName),
),
);
if (created != null && mounted) {
setState(() {
// 契约排序 measured_at DESC, id DESC：新记录通常最新，就地插头；
// 补录历史日期的位置以下次刷新为准（服务端是唯一事实来源）。
_records = [created, ..._records];
if (_phase != _ListPhase.ready) _phase = _ListPhase.ready;
});
ScaffoldMessenger.of(
context,
).showSnackBar(const SnackBar(content: Text('已记录体重')));
}
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
backgroundColor: Colors.transparent,
elevation: 0,
foregroundColor: AppColors.ink,
title: const Text('体重记录'),
centerTitle: true,
titleTextStyle: const TextStyle(
color: AppColors.ink,
fontSize: 16,
fontWeight: FontWeight.w800,
),
actions: [
if (widget.canWrite && _phase == _ListPhase.ready)
IconButton(
tooltip: '记录体重',
onPressed: _openCreate,
icon: const Icon(Icons.add),
),
],
),
body: switch (_phase) {
_ListPhase.loading => const Center(child: CircularProgressIndicator()),
_ListPhase.error => Center(
child: Padding(
padding: const EdgeInsets.all(24),
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
InlineErrorBanner(message: petLoadErrorMessage(_error)),
const SizedBox(height: 16),
FilledButton(
onPressed: _loadFirstPage,
child: const Text('重试'),
),
],
),
),
),
_ListPhase.ready when _records.isEmpty => Center(
child: SingleChildScrollView(
child: EmptyStateIllustration(
icon: Icons.monitor_weight_outlined,
title: '还没有体重记录',
description: '定期称重，看见毛孩子的成长曲线',
ctaLabel: widget.canWrite ? '记录第一条' : null,
onCtaPressed: widget.canWrite ? _openCreate : null,
),
),
),
_ListPhase.ready => _list(),
},
);
}
Widget _list() {
return RefreshIndicator(
onRefresh: _loadFirstPage,
child: ListView(
padding: const EdgeInsets.fromLTRB(16, 8, 16, 30),
children: [
for (final record in _records) ...[
_WeightTile(record: record),
const SizedBox(height: 10),
],
if (_hasMore)
Center(
child: _loadingMore
? const Padding(
padding: EdgeInsets.all(12),
child: SizedBox(
width: 22,
height: 22,
child: CircularProgressIndicator(strokeWidth: 2),
),
)
: TextButton(onPressed: _loadMore, child: const Text('加载更多')),
),
],
),
);
}
}
/// 体重条目：RecordTypeDot(体重) + 大数值（primaryDark w800）+
/// 日期/备注副行（05 §3.3 时间线条目形态的数值型变体）。
class _WeightTile extends StatelessWidget {
const _WeightTile({required this.record});
final WeightRecord record;
@override
Widget build(BuildContext context) {
final meta = StringBuffer(formatMeasuredAt(record.measuredAt));
if (record.note != null && record.note!.isNotEmpty) {
meta.write(' · ${record.note}');
}
return Card(
child: Padding(
padding: const EdgeInsets.all(14),
child: Row(
children: [
const RecordTypeDot(
type: RecordType.weight,
size: RecordTypeDotSize.md,
),
const SizedBox(width: 12),
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'${formatWeightKg(record.weightKg)} kg',
style: const TextStyle(
color: AppColors.primaryDark,
fontSize: 15,
fontWeight: FontWeight.w800,
),
),
const SizedBox(height: 4),
Text(
meta.toString(),
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: const TextStyle(
color: AppColors.inkSoft,
fontSize: 12,
),
),
],
),
),
],
),
),
);
}
}
/// 称重时刻展示：本地时区 `YYYY-MM-DD HH:mm`。
String formatMeasuredAt(DateTime measuredAt) {
final local = measuredAt.toLocal();
final h = local.hour.toString().padLeft(2, '0');
final min = local.minute.toString().padLeft(2, '0');
return '${dateToJson(local)} $h:$min';
}
test/features/pets/health_record_analytics_test.dart
+85
View File
@@ -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('createStarted：recordType + 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('createSucceeded：durationMs + photoCount（M2 无媒体恒 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：五位业务码推导 httpStatus（40904 → 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('viewed：recordType + source（health_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',
});
});
}
test/features/pets/health_record_display_test.dart
+150
View File
@@ -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('vaccinationDateRuleError（42201 规则前端拦截）', () {
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,
);
});
});
}
test/features/pets/weight_form_page_test.dart
+195
View File
@@ -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',
);
});
}
test/features/pets/weight_records_page_test.dart
+206
View File
@@ -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：空态插画 + 记录 CTA（canWrite）', (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('viewer（canWrite=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);
});
}
test/helpers/pet_test_helpers.dart
+95
View File
@@ -129,6 +129,44 @@ Pet buildPet(
),
);
Map<String, dynamic> sampleVaccineCatalogJson({
String id = 'v-1',
String code = 'rabies',
String name = '狂犬疫苗',
String species = 'dog',
}) => {
'id': id,
'code': code,
'name': name,
'species': species,
'description': null,
};
/// 快速构造体重记录（widget 测试共用）。
WeightRecord buildWeight(
String id, {
double weightKg = 4.35,
String measuredAt = '2026-09-07T09:00:00+08:00',
Map<String, Object?> overrides = const {},
}) => WeightRecord.fromJson({
...sampleWeightJson(),
'id': id,
'weightKg': weightKg,
'measuredAt': measuredAt,
...overrides,
});
/// 快速构造疫苗记录。
Vaccination buildVaccination(
String id, {
Map<String, Object?> overrides = const {},
}) =>
Vaccination.fromJson({...sampleVaccinationJson(), 'id': id, ...overrides});
/// 快速构造摘要（缺省为「三聚合齐备」样本；overrides 可置 null 验证空态）。
PetSummary buildSummary({Map<String, Object?> overrides = const {}}) =>
PetSummary.fromJson({...samplePetSummaryJson(), ...overrides});
/// 假仓库：各方法可注入行为；listPets 默认空列表，其余未注入的方法抛
/// UnimplementedError（22 号报告 §7：widget 测试注入假仓库的共享实现）。
class FakePetsRepository implements PetsRepository {
@@ -137,6 +175,16 @@ class FakePetsRepository implements PetsRepository {
Future<Pet> Function(String)? getPetHandler;
Future<Pet> Function(String, UpdatePetRequest)? updatePetHandler;
Future<List<Breed>> Function(PetSpecies?)? listBreedsHandler;
Future<CursorPage<WeightRecord>> Function(String, int?, String?)?
listWeightsHandler;
Future<WeightRecord> Function(String, CreateWeightRequest)?
createWeightHandler;
Future<List<VaccineCatalogItem>> Function(PetSpecies?)?
listVaccineCatalogHandler;
Future<List<Vaccination>> Function(String)? listVaccinationsHandler;
Future<Vaccination> Function(String, CreateVaccinationRequest)?
createVaccinationHandler;
Future<PetSummary> Function(String, String?)? getPetSummaryHandler;
@override
Future<List<Pet>> listPets() =>
@@ -157,6 +205,53 @@ class FakePetsRepository implements PetsRepository {
listBreedsHandler?.call(species) ??
Future.value([Breed.fromJson(sampleBreedJson())]);
@override
Future<CursorPage<WeightRecord>> listWeights(
String petId, {
int? limit,
String? cursor,
}) => listWeightsHandler!(petId, limit, cursor);
@override
Future<WeightRecord> createWeight(
String petId,
CreateWeightRequest request,
) => createWeightHandler!(petId, request);
@override
Future<List<VaccineCatalogItem>> listVaccineCatalog({PetSpecies? species}) =>
listVaccineCatalogHandler?.call(species) ??
Future.value([VaccineCatalogItem.fromJson(sampleVaccineCatalogJson())]);
@override
Future<List<Vaccination>> listVaccinations(String petId) =>
listVaccinationsHandler!(petId);
@override
Future<Vaccination> createVaccination(
String petId,
CreateVaccinationRequest request,
) => createVaccinationHandler!(petId, request);
@override
Future<PetSummary> getPetSummary(String petId, {String? tz}) =>
getPetSummaryHandler?.call(petId, tz) ??
// 缺省给「无任何记录」空摘要（契约 null 语义），既有详情页测试
// 不必逐个注入。
Future.value(
PetSummary.fromJson({
'petId': petId,
'latestWeight': null,
'vaccinationProgress': null,
'nextVaccination': null,
'monthlyExpense': {
'month': '2026-09',
'timezone': 'UTC',
'amountCents': 0,
},
}),
);
@override
dynamic noSuchMethod(Invocation invocation) =>
throw UnimplementedError('${invocation.memberName}');