huimv-baqing/doc/交易市场平台/隔离巡查登记/隔离巡查登记前端技术方案.md

隔离巡查登记 — 前端技术方案

依据：隔离巡查登记功能需求.md、隔离巡查登记技术方案.md；布局对齐 tradeMarket/entryIsolation/index.vue（双 el-card）；字段 小驼峰。

---

1. 页面与路由

项	说明
Vue 路径	ruoyi-ui/src/views/tradeMarket/isolationPatrol/index.vue
组件名	TradeMarketIsolationPatrol
菜单配置	组件路径：tradeMarket/isolationPatrol/index（「交易市场平台」目录下，手工配置）
权限前缀	tradeMarket:isolationPatrol:list\|query\|add\|edit\|remove

---

2. API 模块

项	说明
文件	ruoyi-ui/src/api/tradeMarket/isolationPatrol.js
Base	/tradeMarket/isolationPatrol

方法	HTTP	说明
listIsolationPatrol	GET	/list
getIsolationPatrol	GET	/{id}
addIsolationPatrol	POST	/
updateIsolationPatrol	PUT	/
delIsolationPatrol	DELETE	/{ids}
listPatrolPenOptions	GET	/penOptions
listPatrolPenEarTags	GET	/penEarTags?penId=

---

3. 页面结构

1. 筛选区：巡查日期 daterange → patrolDateStart/patrolDateEnd；圈位编号模糊；搜索、重置、新增。
   
2. 列表区：巡查时间、圈位编号、巡查照片（缩略图预览）、巡查内容描述、处理情况、病死病害数量、耳标号、操作。
   
3. 新增/编辑弹窗：巡查时间、圈位（在栏下拉）、病死病害数量、文案联动、条件展示耳标多选、单图上传。
   
4. 查看弹窗：只读全字段 + 审计信息；可进编辑、删除。

---

4. 业务规则（前端）

规则	实现
巡查日期区间	queryDateRange 绑定 daterange，查询拆为 patrolDateStart、patrolDateEnd
数量联动文案	onSickDeadQtyChange：0 → 正常/无需处理；>0 → 异常/需要处理（i18n 默认文案）
耳标区显示	showEarTagField：sickDeadQty > 0 时展示多选
换圈位	onPenChange 清空耳标并 listPatrolPenEarTags
P1～P3	validateEarTagList：0 无耳标；>0 个数=数量且须在 penEarTagOptions 内
巡查时间	validatePatrolTime：必填且 ≤ 当前时间
巡查照片	/common/upload；jpg/jpeg/png；≤10MB；选填；photoUrl/photoPath
提交 Body	buildSubmitPayload：qty=0 时 earTagList=[]
无在栏圈位	penOptions 空时提示 tipNoPenInStock，阻止保存

---

5. 国际化

项	说明
语言包	tradeMarket.isolationPatrol（lang/zh/tradeMarket.js、lang/bo/tradeMarket.js）
Mixin	tradeMarketLocaleMixin，tmNs = 'isolationPatrol'，tmT / tmCommon

---

6. 联调说明

1. 部署 BizIsolationPatrolController 及表 biz_isolation_patrol（见后端技术方案）。
   
2. 预置入场隔离登记在栏数据（expected_release_date >= 今天 且已分圈）。
   
3. 菜单组件 tradeMarket/isolationPatrol/index，权限与后端一致。
   
4. 验证：日期区间、圈位模糊、数量 0/>0 联动、耳标个数校验、照片上传、修改/逻辑删除、双语切换。

---

7. 文件清单

类型	路径
页面	ruoyi-ui/src/views/tradeMarket/isolationPatrol/index.vue
API	ruoyi-ui/src/api/tradeMarket/isolationPatrol.js
Mixin	ruoyi-ui/src/mixins/tradeMarketLocaleMixin.js（复用）
i18n	ruoyi-ui/src/lang/zh/tradeMarket.js、lang/bo/tradeMarket.js（isolationPatrol 节点）

---

8. 修订记录

版本	说明
1.0	初版：列表+CRUD 弹窗、在栏圈位/耳标接口、P1～P3 前端校验、照片上传、汉藏双语