科技服务人员管理 — 前端技术方案
依据：同目录功能需求、技术方案；模式对齐「风险因子设置」：全局单套 GET + PUT；字段 小驼峰。
1. 页面与路由
| 项 |
说明 |
| Vue 路径 |
ruoyi-ui/src/views/techService/techServicePersonnel/index.vue |
| 组件名 |
TechServicePersonnel |
| 菜单配置 |
组件路径：techService/techServicePersonnel/index（「牧业养殖科技服务」目录下） |
| 权限 |
techService:techServicePersonnel:query\|edit |
本期 无 列表分页、删除、导入、导出。
2. API 模块
| 项 |
说明 |
| 文件 |
ruoyi-ui/src/api/techService/techServicePersonnel.js |
| Base |
/techService/techServicePersonnel |
| 方法 |
路径 |
说明 |
getTechServicePersonnel |
GET / |
获取当前单例填报；无记录时 data 为 null |
updateTechServicePersonnel |
PUT / |
保存可填人数；后端 upsert 并重算总人数 |
3. 页面结构
- 单页卡片：进入即加载配置。
- 科技特派员：男性、女性、党员（选填）；总人数只读预览（= 男 + 女）。
- 农业事业单位：初级、员级、中级、副高、管理级（选填）；总人数只读预览（五级合计）。
- 保存：
edit 权限；成功后重新拉取。
- 审计：有
updateTime 时展示更新人、更新时间。
字段映射
| 界面 |
字段 |
| 特派员男/女/党员 |
envoyMaleCount / envoyFemaleCount / envoyPartyMemberCount |
| 特派员总人数（派生） |
envoyTotalCount（仅展示，不提交） |
| 初级～管理级 |
agriJuniorCount … agriManagementCount |
| 事业总人数（派生） |
agriTotalCount（仅展示，不提交） |
4. 业务规则
| 规则 |
实现 |
| 单例 |
无列表；进入页 GET 一次 |
| 人数 |
均可空；非负整数；单位「人」 |
| 特派员总人数预览 |
男、女皆空 →「—」；否则二者之和（党员不计入） |
| 事业总人数预览 |
五级皆空 →「—」；否则有值项之和 |
| 提交 |
仅可填字段；总人数由后端重算落库 |
5. 国际化
techService.techServicePersonnel（lang/zh|bo/techService.js）；页面 tsNs = 'techServicePersonnel'，复用 techServiceLocaleMixin（tsT / tsCommon）。
6. 联调说明
- 执行
sql/biz_tech_service_personnel.sql。
- 菜单组件
techService/techServicePersonnel/index，权限见 §1。
- 验证：空库进入表单为空、保存后总人数正确、再次进入回填、党员不计入特派员总人数。
7. 文件清单
| 类型 |
路径 |
| 页面 |
ruoyi-ui/src/views/techService/techServicePersonnel/index.vue |
| API |
ruoyi-ui/src/api/techService/techServicePersonnel.js |
| i18n |
lang/zh/techService.js、lang/bo/techService.js → techServicePersonnel |
| 前端技术方案 |
本文档 |
8. 修订记录
| 版本 |
说明 |
| 1.0 |
初版：单例 GET+PUT；两分区数值填报与总人数只读预览 |
