西藏巴青项目

设备实施作业标准管理 — 技术方案

依据：设备实施作业标准管理功能需求.md（同目录）。状态机、知识库语义与《养殖标准管理技术方案》对齐；本文仅给出设备实施作业标准管理本模块的库表与接口约定，与其它业务模块实现相互独立。

1. 技术架构

项	说明
后端	RuoYi v3.9.2（springboot2 分支）：JDK 8、Spring Boot 2.x、Spring MVC、MyBatis、Druid
数据库	MySQL 5.7.39，InnoDB，`utf8mb4`
前端	若依 Vue2（与分支配套，路由与权限按项目惯例配置）
文件	复用 RuoYi 上传（`/common/upload` 等）；表内存 URL、存储路径、正文原始文件名；不入库文件大小
知识库	HTTP 调用知识库后台管理服务；URL、鉴权、路径见《知识库接口对接说明》；调用时机与操作类型语义与养殖标准方案 §4.2 一致

分层：Controller → Service（状态机、事务、知识库编排、删文件）→ Mapper/XML → domain。

一致性（摘要）

修改：仅 publish_status=0 且 kb_sync_status=0；不自动推库（已同步须先移出）。
下架：publish_status=0，kb_sync_status=1，保留 kb_doc_id；知识库侧不删条目，仅结束对外可见/检索。
移出：通知知识库删除后，kb_sync_status=0，清空 kb_doc_id。
删除：kb_sync_status=0 可直接删；publish_status=0 且 kb_sync_status=1 须先移出或接口内联动删库条目后再删本地。

2. 数据库设计

2.1 表 `biz_equipment_work_standard`

业务含义：设备实施作业标准主表（命名缩写 work_standard = 作业标准）。

字段	类型	非空	默认值	说明
`id`	`bigint(20)`	Y	自增	主键
`standard_name`	`varchar(64)`	Y	—	标准名称（需求 1～20 字符）
`standard_type`	`varchar(32)`	Y	—	资讯类别编码，见 2.2
`introduction`	`varchar(200)`	N	NULL	简介，选填
`content_file_url`	`varchar(512)`	Y	—	正文附件访问 URL
`content_file_path`	`varchar(512)`	Y	—	正文存储路径
`content_file_name`	`varchar(256)`	Y	—	正文原始文件名
`cover_file_url`	`varchar(512)`	N	NULL	封面 URL，选填
`cover_file_path`	`varchar(512)`	N	NULL	封面存储路径，选填
`publish_status`	`tinyint(4)`	Y	`0`	`0` 未发布，`1` 已发布
`kb_sync_status`	`tinyint(4)`	Y	`0`	`0` 未同步，`1` 已同步
`kb_doc_id`	`varchar(128)`	N	NULL	知识库文档 ID
`publish_time`	`datetime`	N	NULL	发布时间
`offline_time`	`datetime`	N	NULL	下架时间
`create_by` / `create_time` / `update_by` / `update_time`	若依惯例	—	—	—
`remark`	`varchar(500)`	N	NULL	备注

索引：PRIMARY KEY (id)；KEY idx_create_time (create_time)；KEY idx_type (standard_type)；KEY idx_pub_kb (publish_status, kb_sync_status)。

合法组合（应用层强校验）：仅 (publish_status, kb_sync_status) ∈ {(0,0),(0,1),(1,1)}。

DDL 示例

CREATE TABLE `biz_equipment_work_standard` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
  `standard_name` varchar(64) NOT NULL COMMENT '标准名称（业务1～20字符）',
  `standard_type` varchar(32) NOT NULL COMMENT '标准类型编码，对应资讯类别 parentCode=001&categoryType=3',
  `introduction` varchar(200) DEFAULT NULL COMMENT '简介',
  `content_file_url` varchar(512) NOT NULL COMMENT '正文附件URL',
  `content_file_path` varchar(512) NOT NULL COMMENT '正文存储路径',
  `content_file_name` varchar(256) NOT NULL COMMENT '正文原始文件名',
  `cover_file_url` varchar(512) DEFAULT NULL COMMENT '封面URL',
  `cover_file_path` varchar(512) DEFAULT NULL COMMENT '封面存储路径',
  `publish_status` tinyint(4) NOT NULL DEFAULT '0' COMMENT '0未发布 1已发布',
  `kb_sync_status` tinyint(4) NOT NULL DEFAULT '0' COMMENT '0未同步 1已同步',
  `kb_doc_id` varchar(128) DEFAULT NULL COMMENT '知识库文档ID',
  `publish_time` datetime DEFAULT NULL COMMENT '发布时间',
  `offline_time` datetime DEFAULT NULL COMMENT '下架时间',
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  KEY `idx_create_time` (`create_time`),
  KEY `idx_type` (`standard_type`),
  KEY `idx_pub_kb` (`publish_status`,`kb_sync_status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='设备实施作业标准';

2.2 标准类型与资讯类别

数据来源：biz_information_category，查询子节点接口 GET /category/informationCategory/children?parentCode=001&categoryType=3；响应项字段 code（编码）、name（展示名）。
落库值：standard_type 存编码（如 001007），非数字序号。
校验：EquipmentWorkStandardTypeValidator 在保存/修改时校验编码属于上述接口返回集合；非法编码返回「标准类型无效，请选择资讯类别中的类型」。

编码（示例）	名称（与种子数据一致）
`001007`	设备操作
`001008`	设备保养
`001009`	设备排障
`001010`	设备维修

存量库迁移：执行 sql/biz_equipment_work_standard_alter_standard_type.sql（1→001007 … 4→001010）。

2.3 其它枚举常量（后端建议）

字段	值	含义
`publish_status`	`0`	未发布
	`1`	已发布
`kb_sync_status`	`0`	未同步
	`1`	已同步

3. 接口设计

统一响应：RuoYi AjaxResult（code / msg / data）或分页 TableDataInfo。

Base Path（示例）：/equipment/workStandard（与项目 context-path、模块前缀对齐）

#	说明	Method	URI	权限	要点
3.1	分页列表	GET	`/equipment/workStandard/list`	`equipment:workStandard:list`	Query：`pageNum`（默认 1）、`pageSize`（默认 20）、`keyword`、`standardType`（精确可空）；排序 `create_time DESC, id DESC`
3.2	详情	GET	`/equipment/workStandard/{id}`	`equipment:workStandard:query`	全字段；下载 `/common/download` 或鉴权直链
3.3	新增	POST	`/equipment/workStandard`	`equipment:workStandard:add`	Body：`standardName`、`standardType`、`introduction`（可空）、`contentFileUrl`、`contentFilePath`、`contentFileName`、`coverFileUrl`、`coverFilePath`（可空）；落库 `publish_status=0`，`kb_sync_status=0`
3.4	修改	PUT	`/equipment/workStandard`	`equipment:workStandard:edit`	Body 含 `id`；仅 `publish_status=0` 且 `kb_sync_status=0`；不自动推库（已同步不可改，须先移出）
3.5	删除	DELETE	`/equipment/workStandard/{ids}`	`equipment:workStandard:remove`	`publish_status=1` 禁止；`kb_sync_status=0` 允许；`0+1` 须先移出或联动删库；删文件 + 通知知识库删除
3.6	同步知识库	POST	`/equipment/workStandard/syncKb/{id}`	`equipment:workStandard:syncKb`	前置 `publish_status=0` 且 `kb_sync_status=0`
3.7	移出知识库	POST	`/equipment/workStandard/removeKb/{id}`	`equipment:workStandard:removeKb`	前置 `publish_status=0` 且 `kb_sync_status=1`
3.8	发布	POST	`/equipment/workStandard/publish/{id}`	`equipment:workStandard:publish`	前置 `publish_status=0` 且 `kb_sync_status=1`
3.9	下架	POST	`/equipment/workStandard/offline/{id}`	`equipment:workStandard:offline`	前置 `publish_status=1`；本地回流 `publish_status=0`，`kb_sync_status=1`，`offline_time=now()`

校验（摘要）：名称 1～20；standard_type 非空且为资讯类别有效编码（2.2）；简介 ≤50 字；正文后缀白名单 pdf/md/doc/docx/xls/xlsx/pptx 与 ≤30MB；封面后缀 jpg/jpeg/png 与 ≤10MB（EquipmentWorkStandardRules.isContentExtensionAllowed）。

4. 知识库交互与附件（摘录）

变更通知（同步、移出、发布、下架、删除联动）：语义与《养殖标准管理技术方案》§4.2 一致；扩展字段中区分 设备实施作业标准 业务类型，以对端约定为准。
上传：先 /common/upload；替换附件成功后删除旧 content_file_path / cover_file_path 对应物理文件。

5. 交付清单（勾选）

biz_equipment_work_standard DDL；存量环境执行 biz_equipment_work_standard_alter_standard_type.sql / 菜单按钮权限 SQL
Domain / Mapper / Service / Controller
知识库 Client 复用或按本模块扩展配置
集成测试：同步、发布、下架、移出、删除及非法状态拦截；已同步修改被拒绝

设备实施作业标准管理技术方案.md 9.2KB 文件歷史 原始文件