西藏巴青项目

生长与出栏标准管理前端技术方案.md 4.0KB

生长与出栏标准管理 — 前端技术方案

依据:doc/生长与出栏标准/生长与出栏标准管理技术方案.md;页面布局对齐 ruoyi-ui/src/views/breedingStandards/breedingManage/index.vue;请求与表单字段统一 小驼峰,与后端 BizGrowthSlaughterStandard 及 Jackson 序列化一致。


1. 页面与路由

说明
Vue 路径 ruoyi-ui/src/views/breedingStandards/growthOutbound/index.vue
组件名 GrowthOutboundStandard
菜单配置 若依「菜单管理」组件路径:breedingStandards/growthOutbound/index
权限前缀 growthSlaughter:standard:

2. API 模块

说明
文件 ruoyi-ui/src/api/breedingStandards/growthSlaughter.js
Base Path /growthSlaughter/standard

封装方法:listGrowthSlaughterStandardgetGrowthSlaughterStandardaddGrowthSlaughterStandardupdateGrowthSlaughterStandarddelGrowthSlaughterStandardsyncKbGrowthSlaughterStandardremoveKbGrowthSlaughterStandardpublishGrowthSlaughterStandardofflineGrowthSlaughterStandard


3. 列表与查询

  • 分页pageNumpageSize(默认 20)。
  • 筛选keyword(标准名称或简介模糊);standardType(精确,可空)。
  • 标准类型created 调用 listInformationCategoryChildren('001', 4) 动态加载;value=codelabel=name
  • 表格列:标准名称、标准类型、简介、正文附件链接、publishStatuskbSyncStatus、发布日期、创建时间、操作列。

4. 表单与上传

  • 新增/编辑:标准名称(1~20)、标准类型、简介(≤50 字,选填)、正文附件(必填)、封面(选填)。
  • 上传POST /common/upload,Header Authorization: Bearer <token>;映射 urlcontentFileUrlfileNamecontentFilePathoriginalFilename/文件名 → contentFileName
  • 前端校验:正文扩展名与大小(≤30MB)、封面 jpg/jpeg/png(≤10MB)、文件名不含英文逗号,与疫病诊疗/养殖标准页一致。
  • 编辑态:仅 publishStatus === 0(未发布)时可替换正文与封面。

5. 操作按钮与状态机

与《养殖标准管理技术方案》双维模型一致:未发布/已发布 × 未同步/已同步

按钮 显示条件 权限标识
查看 有 query 权限 growthSlaughter:standard:query
同步知识库 未发布且未同步 growthSlaughter:standard:syncKb
移出知识库 未发布且已同步 growthSlaughter:standard:removeKb
编辑 未发布 growthSlaughter:standard:edit
删除 未发布且未同步 growthSlaughter:standard:remove
发布 未发布且已同步 growthSlaughter:standard:publish
下架 已发布 growthSlaughter:standard:offline

下架完成后业务稳态为 未发布 + 已同步,可再次修改并重新发布(与功能需求 4.8 一致)。


6. 与疫病诊疗标准前端的差异

疫病诊疗 生长与出栏
API 文件 epidemicTreatment.js growthSlaughter.js
Base Path /epidemicTreatment/standard /growthSlaughter/standard
标准类型选项 资讯类别接口 001011 牦牛生长、001012 牦牛出栏(parentCode=001categoryType=4

页面结构、上传组件与权限粒度与疫病诊疗标准页保持一致,便于维护。


7. 联调说明

  1. 确认后端 BizGrowthSlaughterStandardController 已部署,VUE_APP_BASE_API 代理正确。
  2. 菜单与按钮权限与 sql/biz_growth_slaughter_standard.sql 注释中的标识一致。
  3. 新增前可先调用 /common/upload 验证 Token 与跨域;再提交 POST /growthSlaughter/standard 全量合法 Body。

8. 修订记录

日期 说明
2026-05-13 初稿:页面、API、权限与后端 Controller 对齐