随着伴侣动物家庭化地位提升，毛孩子科学健康管理与疾病预防已成为数以千万计爱宠家庭的刚性需求。针对养宠过程中普遍存在的“疫苗驱虫周期易遗忘、给药剂量按人换算易中毒、化验病历零散丢失、突发急症无从初筛”等痛点，我们设计并开发了这套【宠物健康档案与猫狗日常用药提醒系统】（PetHealth Assistant）。
系统采用现代企业级全栈架构：Vue 3.4 Composition API + Pinia + Tailwind CSS + ECharts 5 构建三端响应式界面，后端集成 Spring Boot 3.2 + Redis + MySQL，实现三端一体化闭环：
- 🖥️ PC端家庭爱宠健康大屏：面向多宠家庭的健康看板、指标曲线走势分析（体重/体温/饮水雷达）、终身病历时间轴与兽药剂量沙盘；
- 🛡️ 运营与医疗管理总控台 (Admin)：全网犬猫健康态势大屏、1500+ 款犬猫专科药品与禁忌知识库、疫苗批号溯源与执业兽医资质审核；
- 📱 微信小程序/随身移动端 (Mobile App)：随身健康档案、用药定时提醒闹钟与一键喂药打卡、疫苗驱虫倒计时与电子化验单病历夹。
一、 系统视觉设计美学：暖萌马卡龙粉黄与治愈天蓝
本系统严格杜绝了模板化深黑 AI Slop 界面，全面拥抱“暖萌马卡龙粉黄 + 治愈天蓝 + 柔和奶白”（#fbbf24, #38bdf8, #fffbeb）的温馨现代美学设计。通过磨砂毛玻璃微质感、生动清晰的爱宠健康雷达与温馨给药向导，为宠物家长打造充满信任与温度的数字健康伴侣。
二、 三端高保真全套运行界面逐图深度解析
1. PC端家庭爱宠健康作战室与全域看板 (PC Terminal)
(1) 家庭爱宠全景健康大屏 (PetHealthDeskView)
整合爱宠当前芯片编号、综合健康评分、今日待办喂药流与近期过敏警示。
(2) 今日定时给药与健康打卡清单 (MedicationChecklist)
清晰标注意图用量、适口性喂药指南，轻点一键记录喂服时间与食后状态反馈。
(3) 近半年体重体况波动走势看板 (WeightCurve)
基于体况评分 (BCS) 科学监测犬猫体重区间，严防肥胖诱发关节与内分泌疾病。
(4) 全生命周期电子病历交互时间轴 (PetTimelineView)
从幼宠免疫、绝育手术到历次化验病历结构化归档，一键导出完整 PDF 就诊摘要。
(5) 兽医级药品剂量与安全换算沙盘 (DosageSandbox)
严格按 kg 体重折算精准药量，内置小动物临床药典校验，排查犬猫致命禁忌。
(6) 爱宠体征指标趋势与生化雷达 (VitalsAnalytics)
ECharts 5 渲染每日饮水量走势柱状图与五维体况雷达模型（泌尿/肠胃/口腔/关节）。
(7) 多宠无忧终身健康 VIP 特权 (PetVipView)
尊享三甲动物医院执业兽医 7x24h 绿通问诊、化验单 OCR 解读与宠物医疗险理赔直连。
2. 运营与医疗管理总控台 (Admin Console)
(1) 全网养宠健康大数据监控 (AdminDashboardView)
实时监控全国犬猫建档量、准时喂药率、疫苗接种率与季节高发疾病预警分布。
(2) 犬猫专科药品与禁忌防呆库 (PetDrugsLibraryView)
收录常用抗生素、止痛驱虫处方药剂量换算标准与致命毒性禁忌清单。
(3) 疫苗规格与批次防伪冷链追溯 (PetVaccinesView)
管理妙三多、硕腾等疫苗批号效期，实时监控冷链温控合规记录。
(4) 执业兽医师资质与电子处方合规审计 (PetVetAuditView)
严格审核全国执业兽医师资质真伪，抽检远程电子处方合规性与用药安全。
(5) 系统设置与提醒调度规则 (PetSystemSettingsView)
配置微信服务号模板通知、推送频次上限与家庭成员协同防漏喂规则。
3. 手机移动端与微信小程序随身端 (Mobile H5 / 小程序)
(1) 爱宠健康今日主屏 (MobileHomeView)
实时展示当前爱宠体况与今日待办给药卡片，一键打卡完成。
(2) 精准用药方案中枢 (MobileMedicationView)
支持多药联用时序提醒与适口性喂药小妙招指引。
(3) 疫苗与驱虫全景日历 (MobileCalendarView)
核心疫苗/体内外驱虫智能倒计时，到期自动弹窗提醒。
三、 核心兽药剂量换算与禁忌防呆实现代码
// Spring Boot 3.2 兽药剂量临床换算与高危禁忌防呆校验核心服务
@Service
@Transactional
public class PetMedicationServiceImpl implements PetMedicationService {
@Autowired
private PetProfileRepository petRepo;
@Autowired
private DrugKnowledgeRepository drugRepo;
@Autowired
private MedicationScheduleRepository scheduleRepo;
@Override
public DosageCalcVO calculateSafeDosage(Long petId, Long drugId, String frequency) {
PetProfile pet = petRepo.findById(petId)
.orElseThrow(() -> new BusinessException("目标爱宠健康档案不存在"));
DrugKnowledge drug = drugRepo.findById(drugId)
.orElseThrow(() -> new BusinessException("目标药品未在临床数据库中收录"));
// 1. 致命物种禁忌严格阻断拦截 (如对乙酰氨基酚禁用于猫咪)
if ("cat".equalsIgnoreCase(pet.getSpecies()) && drug.getContraindicationSpecies().contains("cat")) {
throw new DangerousMedicationException("【严重禁忌警告】该药物属于猫咪剧毒禁用药，绝对禁止服用！");
}
// 2. 基于精准实测体重 (kg) 动态测算推荐单次有效剂量
BigDecimal currentWeight = pet.getCurrentWeightKg();
BigDecimal minDose = currentWeight.multiply(drug.getMinDosagePerKg()).setScale(2, RoundingMode.HALF_UP);
BigDecimal maxDose = currentWeight.multiply(drug.getMaxDosagePerKg()).setScale(2, RoundingMode.HALF_UP);
// 3. 计算规格剂型换算 (如折算为片剂或混悬液体积 ml)
BigDecimal unitPerDose = minDose.divide(drug.getStrengthPerUnit(), 2, RoundingMode.HALF_UP);
return DosageCalcVO.builder()
.petName(pet.getName())
.weightKg(currentWeight)
.drugName(drug.getGenericName())
.standardDoseRange(minDose + "mg ~ " + maxDose + "mg")
.recommendedUnit(unitPerDose + " " + drug.getFormUnit())
.administrationRoute(drug.getRoute())
.foodInteractionTips(drug.getFoodTips())
.frequency(frequency)
.build();
}
}
四、 常见问题解答 (FAQ)
Q1: 为什么猫咪绝对不能使用人用的感冒药或止痛药？
A: 猫咪体内极度缺乏合成葡萄糖醛酸转移酶的能力，常见感冒药（如泰诺、白加黑、芬必得等）中的对乙酰氨基酚（扑热息痛）会在猫体内转化为强毒性代谢产物，导致急性红细胞变性（高铁血红蛋白血症）及急性肝坏死，致死率极高。本系统已在规则引擎中硬编码防呆阻断！
Q2: 前端工程如何启动与二次开发？
A: 工程基于纯净的 Vue 3.4 + Pinia + Vite 5 架构，解压后执行 npm install 与 npm run dev 即可秒级热启动。内嵌完整的多宠健康模拟字典与全套 15 张 4K 原生截图，开箱即用！
