feat(wms): 添加考勤排班、班次及倒班规则功能模块

- 新增 IWmsAttendanceScheduleService 接口及其实现类 - 新增 IWmsAttendanceShiftService 接口及其实现类 - 新增 IWmsAttendanceShiftRuleService 接口及其实现类 - 添加 WmsAttendanceSchedule、WmsAttendanceShift、WmsAttendanceShiftRule 实体类 - 创建对应的 BO 和 VO 类用于数据传输 - 添加 WmsAttendanceScheduleController、WmsAttendanceShiftController、WmsAttendanceShiftRuleController 控制器 - 新增相应的 Mapper 接口和 XML 映射文件 - 实现分页查询、新增、修改、删除等基础功能 - 集成 Excel 导出功能和数据校验机制
2026-05-08 15:40:39 +08:00
parent a54ca9ef95
commit e11a125d0d
24 changed files with 1524 additions and 0 deletions
--- a/klp-wms/src/main/java/com/klp/controller/WmsAttendanceScheduleController.java
+++ b/klp-wms/src/main/java/com/klp/controller/WmsAttendanceScheduleController.java
@@ -0,0 +1,99 @@
+package com.klp.controller;
+
+import java.util.List;
+import java.util.Arrays;
+
+import lombok.RequiredArgsConstructor;
+import javax.servlet.http.HttpServletResponse;
+import javax.validation.constraints.*;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.validation.annotation.Validated;
+import com.klp.common.annotation.RepeatSubmit;
+import com.klp.common.annotation.Log;
+import com.klp.common.core.controller.BaseController;
+import com.klp.common.core.domain.PageQuery;
+import com.klp.common.core.domain.R;
+import com.klp.common.core.validate.AddGroup;
+import com.klp.common.core.validate.EditGroup;
+import com.klp.common.enums.BusinessType;
+import com.klp.common.utils.poi.ExcelUtil;
+import com.klp.domain.vo.WmsAttendanceScheduleVo;
+import com.klp.domain.bo.WmsAttendanceScheduleBo;
+import com.klp.service.IWmsAttendanceScheduleService;
+import com.klp.common.core.page.TableDataInfo;
+
+/**
+ * 排班(谁在哪天上班)
+ *
+ * @author klp
+ * @date 2026-05-08
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/wms/attendanceSchedule")
+public class WmsAttendanceScheduleController extends BaseController {
+
+    private final IWmsAttendanceScheduleService iWmsAttendanceScheduleService;
+
+    /**
+     * 查询排班(谁在哪天上班)列表
+     */
+    @GetMapping("/list")
+    public TableDataInfo<WmsAttendanceScheduleVo> list(WmsAttendanceScheduleBo bo, PageQuery pageQuery) {
+        return iWmsAttendanceScheduleService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出排班(谁在哪天上班)列表
+     */
+    @Log(title = "排班(谁在哪天上班)", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(WmsAttendanceScheduleBo bo, HttpServletResponse response) {
+        List<WmsAttendanceScheduleVo> list = iWmsAttendanceScheduleService.queryList(bo);
+        ExcelUtil.exportExcel(list, "排班(谁在哪天上班)", WmsAttendanceScheduleVo.class, response);
+    }
+
+    /**
+     * 获取排班(谁在哪天上班)详细信息
+     *
+     * @param scheduleId 主键
+     */
+    @GetMapping("/{scheduleId}")
+    public R<WmsAttendanceScheduleVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long scheduleId) {
+        return R.ok(iWmsAttendanceScheduleService.queryById(scheduleId));
+    }
+
+    /**
+     * 新增排班(谁在哪天上班)
+     */
+    @Log(title = "排班(谁在哪天上班)", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsAttendanceScheduleBo bo) {
+        return toAjax(iWmsAttendanceScheduleService.insertByBo(bo));
+    }
+
+    /**
+     * 修改排班(谁在哪天上班)
+     */
+    @Log(title = "排班(谁在哪天上班)", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsAttendanceScheduleBo bo) {
+        return toAjax(iWmsAttendanceScheduleService.updateByBo(bo));
+    }
+
+    /**
+     * 删除排班(谁在哪天上班)
+     *
+     * @param scheduleIds 主键串
+     */
+    @Log(title = "排班(谁在哪天上班)", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{scheduleIds}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] scheduleIds) {
+        return toAjax(iWmsAttendanceScheduleService.deleteWithValidByIds(Arrays.asList(scheduleIds), true));
+    }
+}
--- a/klp-wms/src/main/java/com/klp/controller/WmsAttendanceShiftController.java
+++ b/klp-wms/src/main/java/com/klp/controller/WmsAttendanceShiftController.java
@@ -0,0 +1,99 @@
+package com.klp.controller;
+
+import java.util.List;
+import java.util.Arrays;
+
+import lombok.RequiredArgsConstructor;
+import javax.servlet.http.HttpServletResponse;
+import javax.validation.constraints.*;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.validation.annotation.Validated;
+import com.klp.common.annotation.RepeatSubmit;
+import com.klp.common.annotation.Log;
+import com.klp.common.core.controller.BaseController;
+import com.klp.common.core.domain.PageQuery;
+import com.klp.common.core.domain.R;
+import com.klp.common.core.validate.AddGroup;
+import com.klp.common.core.validate.EditGroup;
+import com.klp.common.enums.BusinessType;
+import com.klp.common.utils.poi.ExcelUtil;
+import com.klp.domain.vo.WmsAttendanceShiftVo;
+import com.klp.domain.bo.WmsAttendanceShiftBo;
+import com.klp.service.IWmsAttendanceShiftService;
+import com.klp.common.core.page.TableDataInfo;
+
+/**
+ * 班次
+ *
+ * @author klp
+ * @date 2026-05-08
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/wms/attendanceShift")
+public class WmsAttendanceShiftController extends BaseController {
+
+    private final IWmsAttendanceShiftService iWmsAttendanceShiftService;
+
+    /**
+     * 查询班次列表
+     */
+    @GetMapping("/list")
+    public TableDataInfo<WmsAttendanceShiftVo> list(WmsAttendanceShiftBo bo, PageQuery pageQuery) {
+        return iWmsAttendanceShiftService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出班次列表
+     */
+    @Log(title = "班次", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(WmsAttendanceShiftBo bo, HttpServletResponse response) {
+        List<WmsAttendanceShiftVo> list = iWmsAttendanceShiftService.queryList(bo);
+        ExcelUtil.exportExcel(list, "班次", WmsAttendanceShiftVo.class, response);
+    }
+
+    /**
+     * 获取班次详细信息
+     *
+     * @param shiftId 主键
+     */
+    @GetMapping("/{shiftId}")
+    public R<WmsAttendanceShiftVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long shiftId) {
+        return R.ok(iWmsAttendanceShiftService.queryById(shiftId));
+    }
+
+    /**
+     * 新增班次
+     */
+    @Log(title = "班次", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsAttendanceShiftBo bo) {
+        return toAjax(iWmsAttendanceShiftService.insertByBo(bo));
+    }
+
+    /**
+     * 修改班次
+     */
+    @Log(title = "班次", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsAttendanceShiftBo bo) {
+        return toAjax(iWmsAttendanceShiftService.updateByBo(bo));
+    }
+
+    /**
+     * 删除班次
+     *
+     * @param shiftIds 主键串
+     */
+    @Log(title = "班次", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{shiftIds}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] shiftIds) {
+        return toAjax(iWmsAttendanceShiftService.deleteWithValidByIds(Arrays.asList(shiftIds), true));
+    }
+}
--- a/klp-wms/src/main/java/com/klp/controller/WmsAttendanceShiftRuleController.java
+++ b/klp-wms/src/main/java/com/klp/controller/WmsAttendanceShiftRuleController.java
@@ -0,0 +1,99 @@
+package com.klp.controller;
+
+import java.util.List;
+import java.util.Arrays;
+
+import lombok.RequiredArgsConstructor;
+import javax.servlet.http.HttpServletResponse;
+import javax.validation.constraints.*;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.validation.annotation.Validated;
+import com.klp.common.annotation.RepeatSubmit;
+import com.klp.common.annotation.Log;
+import com.klp.common.core.controller.BaseController;
+import com.klp.common.core.domain.PageQuery;
+import com.klp.common.core.domain.R;
+import com.klp.common.core.validate.AddGroup;
+import com.klp.common.core.validate.EditGroup;
+import com.klp.common.enums.BusinessType;
+import com.klp.common.utils.poi.ExcelUtil;
+import com.klp.domain.vo.WmsAttendanceShiftRuleVo;
+import com.klp.domain.bo.WmsAttendanceShiftRuleBo;
+import com.klp.service.IWmsAttendanceShiftRuleService;
+import com.klp.common.core.page.TableDataInfo;
+
+/**
+ * 倒班规则（支持按日期或按周期自动切换班次）
+ *
+ * @author klp
+ * @date 2026-05-08
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/wms/attendanceShiftRule")
+public class WmsAttendanceShiftRuleController extends BaseController {
+
+    private final IWmsAttendanceShiftRuleService iWmsAttendanceShiftRuleService;
+
+    /**
+     * 查询倒班规则（支持按日期或按周期自动切换班次）列表
+     */
+    @GetMapping("/list")
+    public TableDataInfo<WmsAttendanceShiftRuleVo> list(WmsAttendanceShiftRuleBo bo, PageQuery pageQuery) {
+        return iWmsAttendanceShiftRuleService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出倒班规则（支持按日期或按周期自动切换班次）列表
+     */
+    @Log(title = "倒班规则（支持按日期或按周期自动切换班次）", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(WmsAttendanceShiftRuleBo bo, HttpServletResponse response) {
+        List<WmsAttendanceShiftRuleVo> list = iWmsAttendanceShiftRuleService.queryList(bo);
+        ExcelUtil.exportExcel(list, "倒班规则（支持按日期或按周期自动切换班次）", WmsAttendanceShiftRuleVo.class, response);
+    }
+
+    /**
+     * 获取倒班规则（支持按日期或按周期自动切换班次）详细信息
+     *
+     * @param ruleId 主键
+     */
+    @GetMapping("/{ruleId}")
+    public R<WmsAttendanceShiftRuleVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long ruleId) {
+        return R.ok(iWmsAttendanceShiftRuleService.queryById(ruleId));
+    }
+
+    /**
+     * 新增倒班规则（支持按日期或按周期自动切换班次）
+     */
+    @Log(title = "倒班规则（支持按日期或按周期自动切换班次）", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody WmsAttendanceShiftRuleBo bo) {
+        return toAjax(iWmsAttendanceShiftRuleService.insertByBo(bo));
+    }
+
+    /**
+     * 修改倒班规则（支持按日期或按周期自动切换班次）
+     */
+    @Log(title = "倒班规则（支持按日期或按周期自动切换班次）", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody WmsAttendanceShiftRuleBo bo) {
+        return toAjax(iWmsAttendanceShiftRuleService.updateByBo(bo));
+    }
+
+    /**
+     * 删除倒班规则（支持按日期或按周期自动切换班次）
+     *
+     * @param ruleIds 主键串
+     */
+    @Log(title = "倒班规则（支持按日期或按周期自动切换班次）", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ruleIds}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] ruleIds) {
+        return toAjax(iWmsAttendanceShiftRuleService.deleteWithValidByIds(Arrays.asList(ruleIds), true));
+    }
+}