huimv-baqing/doc/产业数据模型及服务/牦牛疾病预警/牦牛疾病预警前端技术方案.md

牦牛疾病预警 — 前端技术方案

依据：牦牛疾病预警功能需求.md、牦牛疾病预警技术方案.md；列表布局参考 dataModel/grasslandUsage/index.vue（双 card + 分页）；同步交互参考 livestockFinance/yakAsset/index.vue。

---

1. 页面与路由

项	说明
Vue 路径	ruoyi-ui/src/views/dataModel/yakDiseaseWarning/index.vue
组件名	DataModelYakDiseaseWarning
菜单配置	组件路径：dataModel/yakDiseaseWarning/index
权限前缀	dataModel:yakDiseaseWarning:list、query、sync

数据范围：列表/详情按用户可见牧场过滤（后端 allowedPastureIds / 数据权限）；牧场下拉来自 GET /dataModel/pasture/list。

---

2. API 模块

项	说明
文件	ruoyi-ui/src/api/dataModel/yakDiseaseWarning.js
Base	/dataModel/yakDiseaseWarning

方法	HTTP	说明
listYakDiseaseWarning	GET	/list
getYakDiseaseWarning	GET	/{id} 详情
syncYakDiseaseWarning	POST	/sync；repeatSubmit: false

关联：listPasture（api/dataModel/pasture.js）用于牧场筛选下拉。

列表 Query（小驼峰）：startDate、endDate、pastureId、pageNum、pageSize（默认 20）。

本期无 新增/修改/删除接口。

---

3. 页面结构

1. 筛选区：预警日期范围、所属牧场；搜索、重置、同步（第三方拉取）。
   
2. 同步提示：成功后展示「数据截至：{syncTime}」。
   
3. 列表：预警时间、牦牛编号、所属牧场、预警信息、操作（查看）。
   
4. 详情弹窗：只读展示全部业务字段及扩展字段；有 yakAssetId 时可打开「牦牛资产档案」抽屉。

---

4. 业务规则（前端）

规则	实现
只读	无增删改；仅列表、详情、同步
日期筛选	startDate/endDate；开始晚于结束提示并阻断查询
牧场筛选	pastureId 精确匹配；空则不过滤
排序	后端 alert_time DESC, id DESC
预警类型	详情展示：1 体温异常、2 运动量异常、9 其他
同步结果	提示新增/更新/失败条数；刷新列表
档案跳转	复用 livestockFinance/yakAsset/detailDrawer

---

5. 国际化

项	说明
语言包	dataModel.yakDiseaseWarning（lang/zh/dataModel.js、lang/bo/dataModel.js）
Mixin	dataModelLocaleMixin，dmNs = 'yakDiseaseWarning'；warningTypeText

---

6. 文件清单

路径	说明
src/views/dataModel/yakDiseaseWarning/index.vue	主页面
src/api/dataModel/yakDiseaseWarning.js	API
src/mixins/dataModelLocaleMixin.js	预警类型文案
src/lang/zh/dataModel.js	中文
src/lang/bo/dataModel.js	藏文

---

7. 联调说明

• 配置菜单组件路径与 list/query/sync 按钮权限。
  
• 同步依赖第三方告警接口配置（见后端 application.yml）。
  
• 查看档案需「牦牛资产档案」模块数据及 dataModel:yakAsset:query 权限（抽屉只读）。