lixi
294fc4a781
用户实测已因日期选择器误录：Flutter 原生日历只给年份网格、月份必须靠 < > 逐月点，从 9 月回 4 月要点 5 次，他把当月（2026-09）的就医记录记成了 2026-04-09，进而误判「本月花费 ¥0」是聚合坏了。 新增 lib/core/widgets/app_date_picker.dart，全仓 7 处裸 showDatePicker 收口 （改造后 lib/ 下 showDatePicker 只出现在该文件内部一次）： - pickAppDate(...)：calendar 首屏 + 保留头部铅笔切手输；initialDate 自动夹进 [firstDate, lastDate] 防原生越界断言（调用方常传「当前值 ?? 今天」，而 「到期日期」的 firstDate 就是今天，历史值可能已越界）；返回值统一抹时分秒； 中文文案一律交给 zh-CN 本地化，不硬编码，避免两处文案漂移。 - AppDateFieldTrailing(...)：7 处日期行统一「今天 + 日历图标」。今天越界自动 隐藏按钮、提交中禁用、触控 44×44、primaryStrong 白底 4.49:1。 入口模式取舍：不用 calendarOnly——它恰好会砍掉手输按钮，把「录一个已知日期」 这条唯一快路堵死；也不用 input 首屏——「记今天」这类高频场景敲 8 个数字更慢。 两条路都留着最省事。 「今天」为何放表单行而非弹窗内：原生 showDatePicker 无法注入自定义动作 （builder 只能包裹整个 Dialog，拿不到内部选中态；塞进 Column 还会因 Dialog 在无界高度下贪心布局而溢出）。放表单行反而更快——一键落值连弹窗都不用开， 把容易走错的月份导航整段绕开，且一次实现 7 处形态完全一致。 各调用点原有的 firstDate/lastDate 业务约束原样传入、一字未改（健康事件 不许未来、到期日不许补记过去、疫苗 allowFuture 双态、生日不许未来）， 并由 widget 测试直接断言 DatePickerDialog.firstDate/lastDate 防后续悄悄放宽。 顺带修配色：此前从未定制 datePickerTheme，选中日直接吃 ColorScheme.fromSeed 由珊瑚橙派生的暗红棕，与品牌脱节。新增 _datePickerTheme 只复用 05 号规范 （iteration-2/05、iteration-3/05）已审计的色对，不新造色值：头部 surfaceTint + primaryDark 7.98:1（选中 chip 同款）、选中日/年 primaryStrong 实底白字 4.49:1、今日 primaryStrong 1.5px 描边、星期表头 inkSoft 6.59:1、 越界日 muted（DEBT-2 允许的禁用态用途）。headerHeadlineStyle 取 22px （默认 32）：中文「9月10日周四」在横屏侧栏头部 26px 起就折行。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
535 lines
18 KiB
Dart
535 lines
18 KiB
Dart
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_date_picker.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）。
|
||
///
|
||
/// - 目录：vaccine-catalog 按宠物物种过滤（契约：疫苗 species 须与宠物
|
||
/// 一致），目录网络面自带 loading / 失败重试 / 空目录提示。
|
||
/// - 系列/剂次：seriesKey 选中疫苗后以目录 code 自动预填（可改）；
|
||
/// doseNo 默认 1。
|
||
/// - 状态机：创建仅 scheduled / completed；状态-日期规则由
|
||
/// [vaccinationDateRuleError] 前端拦截（scheduled 态不渲染接种日期字段，
|
||
/// 结构上杜绝「scheduled 带 administeredOn」），后端 42201 兜底提示；
|
||
/// 同系列同剂次重复登记 40904 兜底提示。
|
||
/// - 埋点：health_record_create_started/succeeded/failed（recordType=vaccine）。
|
||
class VaccinationFormPage extends StatefulWidget {
|
||
const VaccinationFormPage({
|
||
required this.repository,
|
||
required this.petId,
|
||
required this.petSpecies,
|
||
super.key,
|
||
this.analytics,
|
||
this.entryPoint = HealthRecordEntryPoint.recordList,
|
||
});
|
||
|
||
final PetsRepository repository;
|
||
final String petId;
|
||
final PetSpecies petSpecies;
|
||
final HealthRecordAnalytics? analytics;
|
||
final HealthRecordEntryPoint entryPoint;
|
||
|
||
@override
|
||
State<VaccinationFormPage> createState() => _VaccinationFormPageState();
|
||
}
|
||
|
||
class _VaccinationFormPageState extends State<VaccinationFormPage> {
|
||
final _seriesCtrl = TextEditingController();
|
||
final _doseNoCtrl = TextEditingController(text: '1');
|
||
final _doseLabelCtrl = TextEditingController();
|
||
final _notesCtrl = TextEditingController();
|
||
|
||
List<VaccineCatalogItem>? _catalog;
|
||
bool _catalogLoading = false;
|
||
bool _catalogFailed = false;
|
||
String? _vaccineId;
|
||
|
||
/// seriesKey 是否仍处于「目录 code 自动预填」状态（用户一改即失效）。
|
||
bool _seriesAutoFilled = true;
|
||
|
||
VaccinationStatus _status = VaccinationStatus.scheduled;
|
||
DateTime? _plannedOn;
|
||
DateTime? _administeredOn;
|
||
DateTime? _nextDueOn;
|
||
|
||
String? _vaccineError;
|
||
String? _seriesError;
|
||
String? _doseNoError;
|
||
String? _dateError;
|
||
String? _formError;
|
||
bool _submitting = false;
|
||
|
||
bool _startedFired = false;
|
||
int _attemptSeq = 0;
|
||
late final DateTime _openedAt;
|
||
|
||
@override
|
||
void initState() {
|
||
super.initState();
|
||
_openedAt = DateTime.now();
|
||
_loadCatalog();
|
||
}
|
||
|
||
@override
|
||
void dispose() {
|
||
_seriesCtrl.dispose();
|
||
_doseNoCtrl.dispose();
|
||
_doseLabelCtrl.dispose();
|
||
_notesCtrl.dispose();
|
||
super.dispose();
|
||
}
|
||
|
||
Future<void> _loadCatalog() async {
|
||
setState(() {
|
||
_catalogLoading = true;
|
||
_catalogFailed = false;
|
||
});
|
||
try {
|
||
final catalog = await widget.repository.listVaccineCatalog(
|
||
species: widget.petSpecies,
|
||
);
|
||
if (!mounted) return;
|
||
setState(() {
|
||
_catalog = catalog;
|
||
_catalogLoading = false;
|
||
});
|
||
} on ApiException {
|
||
if (!mounted) return;
|
||
setState(() {
|
||
_catalogLoading = false;
|
||
_catalogFailed = true;
|
||
});
|
||
}
|
||
}
|
||
|
||
void _markStarted() {
|
||
if (_startedFired) return;
|
||
_startedFired = true;
|
||
widget.analytics?.createStarted(
|
||
recordType: HealthRecordType.vaccine,
|
||
entryPoint: widget.entryPoint,
|
||
);
|
||
}
|
||
|
||
void _trackFailed(HealthRecordFailureReason reason, [int? errorCode]) {
|
||
widget.analytics?.createFailed(
|
||
recordType: HealthRecordType.vaccine,
|
||
reason: reason,
|
||
attemptSeq: _attemptSeq,
|
||
errorCode: errorCode,
|
||
);
|
||
}
|
||
|
||
int? get _doseNo {
|
||
final value = int.tryParse(_doseNoCtrl.text.trim());
|
||
if (value == null || value < 1 || value > 32767) return null;
|
||
return value;
|
||
}
|
||
|
||
void _showFormError(String message) {
|
||
setState(() => _formError = message);
|
||
SemanticsService.sendAnnouncement(
|
||
View.of(context),
|
||
message,
|
||
TextDirection.ltr,
|
||
);
|
||
}
|
||
|
||
Future<void> _submit() async {
|
||
if (_submitting) return;
|
||
_attemptSeq++;
|
||
final vaccineError = _vaccineId == null ? '请选择疫苗' : null;
|
||
final seriesError = _seriesCtrl.text.trim().isEmpty ? '请输入系列名称' : null;
|
||
final doseNoError = _doseNo == null ? '剂次需为 1~32767 的整数' : null;
|
||
final dateError = vaccinationDateRuleError(
|
||
status: _status,
|
||
plannedOn: _plannedOn,
|
||
administeredOn: _administeredOn,
|
||
nextDueOn: _nextDueOn,
|
||
);
|
||
if (vaccineError != null ||
|
||
seriesError != null ||
|
||
doseNoError != null ||
|
||
dateError != null) {
|
||
setState(() {
|
||
_vaccineError = vaccineError;
|
||
_seriesError = seriesError;
|
||
_doseNoError = doseNoError;
|
||
_dateError = dateError;
|
||
});
|
||
_trackFailed(HealthRecordFailureReason.validationError);
|
||
return;
|
||
}
|
||
|
||
setState(() {
|
||
_submitting = true;
|
||
_formError = null;
|
||
});
|
||
try {
|
||
final scheduled = _status == VaccinationStatus.scheduled;
|
||
final doseLabel = _doseLabelCtrl.text.trim();
|
||
final notes = _notesCtrl.text.trim();
|
||
final record = await widget.repository.createVaccination(
|
||
widget.petId,
|
||
CreateVaccinationRequest(
|
||
vaccineId: _vaccineId!,
|
||
seriesKey: _seriesCtrl.text.trim(),
|
||
doseNo: _doseNo!,
|
||
status: _status,
|
||
// 状态-日期规则结构化落地：scheduled 只发 plannedOn，
|
||
// completed 只发 administeredOn（+可选 nextDueOn）。
|
||
plannedOn: scheduled ? _plannedOn : null,
|
||
administeredOn: scheduled ? null : _administeredOn,
|
||
nextDueOn: scheduled ? null : _nextDueOn,
|
||
doseLabel: doseLabel.isEmpty ? null : doseLabel,
|
||
notes: notes.isEmpty ? null : notes,
|
||
),
|
||
);
|
||
widget.analytics?.createSucceeded(
|
||
recordType: HealthRecordType.vaccine,
|
||
durationMs: DateTime.now().difference(_openedAt).inMilliseconds,
|
||
);
|
||
if (mounted) Navigator.of(context).pop(record);
|
||
} on VaccinationDoseExistsException {
|
||
if (!mounted) return;
|
||
_showFormError('该系列该剂次已有记录（40904）；如登记有误，可取消原记录后重新登记');
|
||
_trackFailed(HealthRecordFailureReason.validationError, 40904);
|
||
} on VaccinationRuleException {
|
||
if (!mounted) return;
|
||
// 前端已拦截主路径，此处为后端状态-日期规则兜底（42201）。
|
||
_showFormError('接种状态与日期不符合规则，请核对后重试');
|
||
_trackFailed(HealthRecordFailureReason.validationError, 42201);
|
||
} 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: [
|
||
..._catalogSection(),
|
||
const SizedBox(height: 14),
|
||
AppTextField(
|
||
label: '系列名称',
|
||
controller: _seriesCtrl,
|
||
prefixIcon: Icons.tag_outlined,
|
||
errorText: _seriesError,
|
||
helperText: '区分初免/加强等系列，同系列同剂次唯一',
|
||
enabled: !_submitting,
|
||
textInputAction: TextInputAction.next,
|
||
onChanged: (_) {
|
||
_markStarted();
|
||
_seriesAutoFilled = false;
|
||
if (_seriesError != null || _formError != null) {
|
||
setState(() {
|
||
_seriesError = null;
|
||
_formError = null;
|
||
});
|
||
}
|
||
},
|
||
),
|
||
const SizedBox(height: 14),
|
||
Row(
|
||
crossAxisAlignment: CrossAxisAlignment.start,
|
||
children: [
|
||
Expanded(
|
||
child: AppTextField(
|
||
label: '剂次',
|
||
controller: _doseNoCtrl,
|
||
prefixIcon: Icons.numbers_outlined,
|
||
errorText: _doseNoError,
|
||
enabled: !_submitting,
|
||
keyboardType: TextInputType.number,
|
||
textInputAction: TextInputAction.next,
|
||
onChanged: (_) {
|
||
_markStarted();
|
||
if (_doseNoError != null || _formError != null) {
|
||
setState(() {
|
||
_doseNoError = null;
|
||
_formError = null;
|
||
});
|
||
}
|
||
},
|
||
),
|
||
),
|
||
const SizedBox(width: 12),
|
||
Expanded(
|
||
child: AppTextField(
|
||
label: '剂次标签（可选）',
|
||
controller: _doseLabelCtrl,
|
||
enabled: !_submitting,
|
||
textInputAction: TextInputAction.next,
|
||
onChanged: (_) => _markStarted(),
|
||
),
|
||
),
|
||
],
|
||
),
|
||
const SizedBox(height: 18),
|
||
const Text(
|
||
'接种状态',
|
||
style: TextStyle(
|
||
color: AppColors.inkSoft,
|
||
fontSize: 13,
|
||
fontWeight: FontWeight.w600,
|
||
),
|
||
),
|
||
const SizedBox(height: 8),
|
||
SegmentedButton<VaccinationStatus>(
|
||
segments: const [
|
||
ButtonSegment(
|
||
value: VaccinationStatus.scheduled,
|
||
icon: Icon(Icons.event_outlined),
|
||
label: Text('计划接种'),
|
||
),
|
||
ButtonSegment(
|
||
value: VaccinationStatus.completed,
|
||
icon: Icon(Icons.check_circle_outline),
|
||
label: Text('已完成'),
|
||
),
|
||
],
|
||
selected: {_status},
|
||
onSelectionChanged: _submitting
|
||
? null
|
||
: (value) {
|
||
_markStarted();
|
||
setState(() {
|
||
_status = value.first;
|
||
_dateError = null;
|
||
_formError = null;
|
||
});
|
||
},
|
||
),
|
||
const SizedBox(height: 14),
|
||
if (_status == VaccinationStatus.scheduled)
|
||
_dateTile(
|
||
label: '计划接种日期',
|
||
value: _plannedOn,
|
||
allowFuture: true,
|
||
onPicked: (value) => setState(() {
|
||
_plannedOn = value;
|
||
_dateError = null;
|
||
}),
|
||
)
|
||
else ...[
|
||
_dateTile(
|
||
label: '接种日期',
|
||
value: _administeredOn,
|
||
allowFuture: false,
|
||
onPicked: (value) => setState(() {
|
||
_administeredOn = value;
|
||
_dateError = null;
|
||
}),
|
||
),
|
||
const SizedBox(height: 12),
|
||
_dateTile(
|
||
label: '下次接种日期（可选）',
|
||
value: _nextDueOn,
|
||
allowFuture: true,
|
||
onPicked: (value) => setState(() {
|
||
_nextDueOn = value;
|
||
_dateError = null;
|
||
}),
|
||
),
|
||
],
|
||
if (_dateError != null) ...[
|
||
const SizedBox(height: 6),
|
||
Text(
|
||
_dateError!,
|
||
style: const TextStyle(color: AppColors.error, fontSize: 12),
|
||
),
|
||
],
|
||
const SizedBox(height: 14),
|
||
AppTextField(
|
||
label: '备注（可选）',
|
||
controller: _notesCtrl,
|
||
prefixIcon: Icons.sticky_note_2_outlined,
|
||
enabled: !_submitting,
|
||
textInputAction: TextInputAction.done,
|
||
onChanged: (_) => _markStarted(),
|
||
),
|
||
if (_formError != null) ...[
|
||
const SizedBox(height: 16),
|
||
InlineErrorBanner(message: _formError!),
|
||
],
|
||
const SizedBox(height: 24),
|
||
PrimaryButton(
|
||
label: '保存登记',
|
||
isLoading: _submitting,
|
||
onPressed: _submit,
|
||
),
|
||
],
|
||
),
|
||
),
|
||
);
|
||
}
|
||
|
||
List<Widget> _catalogSection() {
|
||
if (_catalogLoading) {
|
||
return const [
|
||
SizedBox(
|
||
height: 52,
|
||
child: Center(child: CircularProgressIndicator(strokeWidth: 2)),
|
||
),
|
||
];
|
||
}
|
||
if (_catalogFailed) {
|
||
return [
|
||
Row(
|
||
children: [
|
||
const Expanded(
|
||
child: Text(
|
||
'疫苗目录加载失败，请重试后选择',
|
||
style: TextStyle(color: AppColors.error, fontSize: 12),
|
||
),
|
||
),
|
||
TextButton(onPressed: _loadCatalog, child: const Text('重试')),
|
||
],
|
||
),
|
||
];
|
||
}
|
||
final catalog = _catalog ?? const <VaccineCatalogItem>[];
|
||
if (catalog.isEmpty) {
|
||
return const [
|
||
Text(
|
||
'该物种暂无可选疫苗目录',
|
||
style: TextStyle(color: AppColors.inkSoft, fontSize: 12),
|
||
),
|
||
];
|
||
}
|
||
return [
|
||
DropdownButtonFormField<String>(
|
||
initialValue: _vaccineId,
|
||
decoration: InputDecoration(labelText: '疫苗', errorText: _vaccineError),
|
||
items: [
|
||
for (final item in catalog)
|
||
DropdownMenuItem(value: item.id, child: Text(item.name)),
|
||
],
|
||
onChanged: _submitting
|
||
? null
|
||
: (value) {
|
||
_markStarted();
|
||
setState(() {
|
||
_vaccineId = value;
|
||
_vaccineError = null;
|
||
_formError = null;
|
||
// seriesKey 以目录 code 预填（用户未改过才覆盖）。
|
||
if (_seriesAutoFilled && value != null) {
|
||
final item = catalog.firstWhere((c) => c.id == value);
|
||
_seriesCtrl.text = item.code;
|
||
}
|
||
});
|
||
},
|
||
),
|
||
];
|
||
}
|
||
|
||
Widget _dateTile({
|
||
required String label,
|
||
required DateTime? value,
|
||
required bool allowFuture,
|
||
required ValueChanged<DateTime> onPicked,
|
||
}) {
|
||
return 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: Text(label, style: const TextStyle(fontSize: 14)),
|
||
subtitle: Text(
|
||
value == null ? '未选择' : dateToJson(value),
|
||
style: const TextStyle(color: AppColors.inkSoft, fontSize: 12),
|
||
),
|
||
trailing: AppDateFieldTrailing(
|
||
firstDate: DateTime(1990),
|
||
lastDate: allowFuture
|
||
? DateTime(DateTime.now().year + 5)
|
||
: DateTime.now(),
|
||
enabled: !_submitting,
|
||
onToday: (value) {
|
||
_markStarted();
|
||
onPicked(value);
|
||
},
|
||
),
|
||
enabled: !_submitting,
|
||
onTap: () async {
|
||
final now = DateTime.now();
|
||
final picked = await pickAppDate(
|
||
context: context,
|
||
initialDate: value ?? now,
|
||
firstDate: DateTime(1990),
|
||
lastDate: allowFuture ? DateTime(now.year + 5) : now,
|
||
);
|
||
if (picked != null && mounted) {
|
||
_markStarted();
|
||
onPicked(picked);
|
||
}
|
||
},
|
||
);
|
||
}
|
||
}
|