From 67c684d08724c01684465107ac763e513a7da906 Mon Sep 17 00:00:00 2001
From: maven <2163098428@qq.com>
Date: 星期四, 30 十月 2025 16:56:58 +0800
Subject: [PATCH] yys 1.接口文档

---
 src/main/java/com/ruoyi/procurementrecord/controller/ProcurementRecordController.java |    3 ---
 src/main/java/com/ruoyi/account/controller/AccountExpenseController.java              |    9 +++++++++
 src/main/java/com/ruoyi/account/controller/AccountFileController.java                 |    6 ++++++
 src/main/java/com/ruoyi/account/controller/AccountIncomeController.java               |    9 +++++++++
 src/main/java/com/ruoyi/approve/controller/ApproveProcessController.java              |    8 ++++++++
 5 files changed, 32 insertions(+), 3 deletions(-)

diff --git a/src/main/java/com/ruoyi/account/controller/AccountExpenseController.java b/src/main/java/com/ruoyi/account/controller/AccountExpenseController.java
index 02796b4..a6d771f 100644
--- a/src/main/java/com/ruoyi/account/controller/AccountExpenseController.java
+++ b/src/main/java/com/ruoyi/account/controller/AccountExpenseController.java
@@ -42,6 +42,7 @@
      * @return
      */
     @PostMapping("/add")
+    @ApiOperation("鏂板")
     public AjaxResult add(@RequestBody AccountExpense accountExpense) {
         accountExpense.setInputTime(new Date());
         LoginUser loginUser = SecurityUtils.getLoginUser();
@@ -55,6 +56,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @ApiOperation("鍒犻櫎")
     public AjaxResult delQualityInspect(@RequestBody List<Integer> ids) {
         if(CollectionUtils.isEmpty(ids)){
             return AjaxResult.error("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
@@ -69,6 +71,7 @@
      * @return
      */
     @PostMapping("/update")
+    @ApiOperation("淇敼")
     public AjaxResult update(@RequestBody AccountExpense accountExpense) {
         return AjaxResult.success(accountExpenseService.updateById(accountExpense));
     }
@@ -80,6 +83,7 @@
      * @return
      */
     @GetMapping("/listPage")
+    @ApiOperation("鍒嗛〉鏌ヨ")
     public AjaxResult accountExpenseListPage(Page page, AccountExpense accountExpense) {
         return AjaxResult.success(accountExpenseService.accountExpenseListPage(page, accountExpense));
     }
@@ -90,6 +94,7 @@
      * @return
      */
     @GetMapping("/{id}")
+    @ApiOperation("璇︽儏")
     public AjaxResult accountExpenseDetail(@PathVariable("id") Integer id) {
         return AjaxResult.success(accountExpenseService.getById(id));
     }
@@ -100,6 +105,7 @@
      * @param accountExpense
      */
     @PostMapping("/export")
+    @ApiOperation("瀵煎嚭")
     public void accountExpenseExport(HttpServletResponse response,AccountExpense accountExpense) {
         accountExpenseService.accountExpenseExport(response, accountExpense);
     }
@@ -110,6 +116,7 @@
      * @return
      */
     @GetMapping("/report/forms")
+    @ApiOperation("璐㈠姟鎶ヨ〃鍥捐〃鏌ヨ")
     public AjaxResult report(DateQueryDto dateQueryDto) {
         return AjaxResult.success(accountExpenseService.report(dateQueryDto));
     }
@@ -130,6 +137,7 @@
      * @return
      */
     @GetMapping("/report/income")
+    @ApiOperation("璐㈠姟鎶ヨ〃鍥捐〃鏀跺叆骞村害鏌ヨ")
     public AjaxResult reportIncome() {
         return AjaxResult.success(accountIncomeService.reportIncome());
     }
@@ -140,6 +148,7 @@
      * @return
      */
     @GetMapping("/report/expense")
+    @ApiOperation("璐㈠姟鎶ヨ〃鍥捐〃鏀嚭骞村害鏌ヨ")
     public AjaxResult reportExpense() {
         return AjaxResult.success(accountExpenseService.reportExpense());
     }
diff --git a/src/main/java/com/ruoyi/account/controller/AccountFileController.java b/src/main/java/com/ruoyi/account/controller/AccountFileController.java
index 3757bb2..130e7c8 100644
--- a/src/main/java/com/ruoyi/account/controller/AccountFileController.java
+++ b/src/main/java/com/ruoyi/account/controller/AccountFileController.java
@@ -6,6 +6,8 @@
 import com.ruoyi.framework.web.domain.AjaxResult;
 import com.ruoyi.quality.pojo.QualityInspectFile;
 import com.ruoyi.quality.service.IQualityInspectFileService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.util.CollectionUtils;
 import org.springframework.web.bind.annotation.*;
 
@@ -17,6 +19,7 @@
  */
 @RestController
 @RequestMapping("/account/accountFile")
+@Api(tags = "璐㈠姟闄勪欢")
 public class AccountFileController {
 
 
@@ -30,6 +33,7 @@
      * @return
      */
     @PostMapping("/add")
+    @ApiOperation("鏂板")
     public AjaxResult add(@RequestBody AccountFile accountFile) {
         return AjaxResult.success(accountFileService.save(accountFile));
     }
@@ -40,6 +44,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @ApiOperation("鍒犻櫎")
     public AjaxResult delAccountFile(@RequestBody List<Integer> ids) {
         if(CollectionUtils.isEmpty(ids)){
             return AjaxResult.error("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
@@ -55,6 +60,7 @@
      * @return
      */
     @GetMapping("/listPage")
+    @ApiOperation("鍒嗛〉鏌ヨ")
     public AjaxResult accountFileListPage(Page page, AccountFile accountFile) {
         return AjaxResult.success(accountFileService.accountFileListPage(page, accountFile));
     }
diff --git a/src/main/java/com/ruoyi/account/controller/AccountIncomeController.java b/src/main/java/com/ruoyi/account/controller/AccountIncomeController.java
index 68e50f7..c6a24d7 100644
--- a/src/main/java/com/ruoyi/account/controller/AccountIncomeController.java
+++ b/src/main/java/com/ruoyi/account/controller/AccountIncomeController.java
@@ -14,6 +14,8 @@
 import com.ruoyi.quality.service.IQualityInspectFileService;
 import com.ruoyi.quality.service.IQualityInspectParamService;
 import com.ruoyi.quality.service.IQualityInspectService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.util.CollectionUtils;
 import org.springframework.web.bind.annotation.*;
 
@@ -27,6 +29,7 @@
  */
 @RestController
 @RequestMapping("/account/accountIncome")
+@Api(tags = "璐㈠姟绠$悊--鏀跺叆绠$悊")
 public class AccountIncomeController {
 
     @Resource
@@ -39,6 +42,7 @@
      * @return
      */
     @PostMapping("/add")
+    @ApiOperation("鏂板")
     public AjaxResult add(@RequestBody AccountIncome accountIncome) {
         accountIncome.setInputTime(new Date());
         LoginUser loginUser = SecurityUtils.getLoginUser();
@@ -52,6 +56,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @ApiOperation("鍒犻櫎")
     public AjaxResult delQualityInspect(@RequestBody List<Integer> ids) {
         if(CollectionUtils.isEmpty(ids)){
             return AjaxResult.error("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
@@ -66,6 +71,7 @@
      * @return
      */
     @PostMapping("/update")
+    @ApiOperation("淇敼")
     public AjaxResult update(@RequestBody AccountIncome accountIncome) {
         return AjaxResult.success(accountIncomeService.updateById(accountIncome));
     }
@@ -77,6 +83,7 @@
      * @return
      */
     @GetMapping("/listPage")
+    @ApiOperation("鍒嗛〉鏌ヨ")
     public AjaxResult accountIncomeListPage(Page page, AccountIncome accountIncome) {
         return AjaxResult.success(accountIncomeService.accountIncomeListPage(page, accountIncome));
     }
@@ -87,6 +94,7 @@
      * @return
      */
     @GetMapping("/{id}")
+    @ApiOperation("璇︽儏")
     public AjaxResult accountIncomeDetail(@PathVariable("id") Integer id) {
         return AjaxResult.success(accountIncomeService.getById(id));
     }
@@ -97,6 +105,7 @@
      * @param accountIncome
      */
     @PostMapping("/export")
+    @ApiOperation("瀵煎嚭")
     public void accountIncomeExport(HttpServletResponse response,AccountIncome accountIncome) {
         accountIncomeService.accountIncomeExport(response, accountIncome);
     }
diff --git a/src/main/java/com/ruoyi/approve/controller/ApproveProcessController.java b/src/main/java/com/ruoyi/approve/controller/ApproveProcessController.java
index 1b3e84d..131f61e 100644
--- a/src/main/java/com/ruoyi/approve/controller/ApproveProcessController.java
+++ b/src/main/java/com/ruoyi/approve/controller/ApproveProcessController.java
@@ -9,6 +9,8 @@
 import com.ruoyi.framework.security.LoginUser;
 import com.ruoyi.framework.web.domain.AjaxResult;
 import com.ruoyi.project.system.domain.SysDept;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.transaction.annotation.Transactional;
 import org.springframework.web.bind.annotation.*;
@@ -19,6 +21,7 @@
 
 @RestController
 @RequestMapping("/approveProcess")
+@Api(tags = "瀹℃壒")
 public class ApproveProcessController {
 
     @GetMapping("/test")
@@ -51,6 +54,7 @@
      */
     @PostMapping("/add")
     @Transactional(rollbackFor = Exception.class)
+    @ApiOperation(value = "娣诲姞瀹℃壒")
     public AjaxResult add(@RequestBody ApproveProcessVO approveProcessVO) throws Exception {
         if (approveProcessVO == null) {
             return AjaxResult.warn("鍙傛暟涓嶈兘涓虹┖");
@@ -66,6 +70,7 @@
      * @return
      */
     @GetMapping("/get")
+    @ApiOperation(value = "瀹℃壒璇︽儏")
     public AjaxResult get(ApproveGetAndUpdateVo approveGetAndUpdateVo){
         if (approveGetAndUpdateVo.getId() == null || approveGetAndUpdateVo.getId().isEmpty()) {
             return AjaxResult.warn("鍙傛暟涓嶈兘涓虹┖");
@@ -80,6 +85,7 @@
      */
     @PostMapping("/update")
     @Transactional(rollbackFor = Exception.class)
+    @ApiOperation(value = "鏇存柊瀹℃壒")
     public AjaxResult update(@RequestBody ApproveGetAndUpdateVo approveGetAndUpdateVo) throws IOException {
         if (approveGetAndUpdateVo == null) {
             return AjaxResult.warn("鍙傛暟涓嶈兘涓虹┖");
@@ -92,6 +98,7 @@
      * @return
      */
     @GetMapping("/list")
+    @ApiOperation(value = "鑾峰彇瀹℃壒鍒楄〃")
     public AjaxResult list(Page page, ApproveProcess approveProcess) {
         return AjaxResult.success(approveProcessService.listAll(page, approveProcess));
     }
@@ -102,6 +109,7 @@
      * @return
      */
     @DeleteMapping("/deleteIds")
+    @ApiOperation(value = "鍒犻櫎瀹℃壒")
     @Transactional(rollbackFor = Exception.class)
     public AjaxResult deleteIds(@RequestBody Long[] ids) {
         if (ids == null || ids.length == 0) {
diff --git a/src/main/java/com/ruoyi/procurementrecord/controller/ProcurementRecordController.java b/src/main/java/com/ruoyi/procurementrecord/controller/ProcurementRecordController.java
index 636954c..7fb7b44 100644
--- a/src/main/java/com/ruoyi/procurementrecord/controller/ProcurementRecordController.java
+++ b/src/main/java/com/ruoyi/procurementrecord/controller/ProcurementRecordController.java
@@ -6,11 +6,8 @@
 import com.ruoyi.framework.aspectj.lang.enums.BusinessType;
 import com.ruoyi.framework.web.controller.BaseController;
 import com.ruoyi.framework.web.domain.AjaxResult;
-import com.ruoyi.framework.web.page.TableDataInfo;
 import com.ruoyi.procurementrecord.dto.*;
 import com.ruoyi.procurementrecord.service.ProcurementRecordService;
-import com.ruoyi.purchase.dto.InvoicePurchaseReportDto;
-import com.ruoyi.quality.pojo.QualityInspect;
 import io.swagger.annotations.Api;
 import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;

--
Gitblit v1.9.3