提交代码修改为准

docs/变更管理/code-adjust-record-2025-01-08-cursor.md

@@ -217,6 +217,16 @@
 - **权限配置**: `docs/设计文档/database/12-class-cadre-management-menu.sql`
 - **开发规范**: `.cursor/cursorrules-backend.md`、`.cursor/cursorrules-frontend.md`
 
+### 2025-07-01 逻辑删除规范完善（by cursor）
+
+- 【后端】HqSatCategory实体类deleted字段添加@TableLogic注解，类型改为Integer，符合MyBatis-Plus逻辑删除规范。
+- 【后端】HqSatCategoryBo、HqSatCategoryVo的deleted字段类型统一为Integer。
+- 【后端】HqSatCategoryServiceImpl.deleteWithValidByIds方法实现改为逻辑删除（update deleted=1），彻底禁止物理删除。
+- 【文档】API文档基础规范.md补充逻辑删除规范说明。
+- 【前端】删除按钮提示语优化，明确为逻辑删除。
+
+> 本次调整严格落实项目强制性逻辑删除规范，确保数据安全可恢复，前后端及文档同步更新。
+
 ---
 
 **记录完成时间**: 2025-01-08 15:30:00  

docs/开发文档/API/API文档基础规范.md

@@ -539,3 +539,18 @@ public List<${ClassName}VO> queryList(${ClassName}BO bo) {
 - 更新人：wuzilong
 - 基于实际项目开发经验总结
 - 持续补充和优化
+
+## 逻辑删除规范（2025-07-01更新）
+
+- 所有删除操作必须为逻辑删除，禁止物理删除。
+- 实体类需使用@TableLogic注解，deleted字段类型为Integer，0代表存在，1代表删除。
+- 删除接口实际为将deleted字段置为1，数据不会被物理移除。
+- 前端需在删除提示中明确“本操作为逻辑删除，数据不会被物理移除，可在后台恢复”。
+- 参考示例：
+
+```java
+@TableLogic
+private Integer deleted; // 0-存在，1-删除
+```
+
+- 适用范围：所有业务表、VO、BO、API接口。