From 8c5464464036193ddac1de2c5155c94141545c7c Mon Sep 17 00:00:00 2001
From: huminmin <mac@MacBook-Pro.local>
Date: 星期四, 21 五月 2026 09:44:24 +0800
Subject: [PATCH] 质量管理增加接口描述

---
 src/main/java/com/ruoyi/quality/controller/QualityInspectController.java             |    9 +++++++++
 src/main/java/com/ruoyi/quality/controller/QualityInspectParamController.java        |    4 ++++
 src/main/java/com/ruoyi/quality/controller/QualityUnqualifiedController.java         |   10 ++++++++++
 src/main/java/com/ruoyi/quality/controller/QualityTestStandardBindingController.java |    6 ++++++
 src/main/java/com/ruoyi/quality/controller/QualityTestStandardController.java        |   11 +++++++++++
 src/main/java/com/ruoyi/quality/controller/QualityTestStandardParamController.java   |    7 +++++++
 6 files changed, 47 insertions(+), 0 deletions(-)

diff --git a/src/main/java/com/ruoyi/quality/controller/QualityInspectController.java b/src/main/java/com/ruoyi/quality/controller/QualityInspectController.java
index 0319071..be53963 100644
--- a/src/main/java/com/ruoyi/quality/controller/QualityInspectController.java
+++ b/src/main/java/com/ruoyi/quality/controller/QualityInspectController.java
@@ -10,6 +10,7 @@
 import com.ruoyi.quality.service.IQualityInspectFileService;
 import com.ruoyi.quality.service.IQualityInspectParamService;
 import com.ruoyi.quality.service.IQualityInspectService;
+import io.swagger.v3.oas.annotations.Operation;
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.AllArgsConstructor;
 import org.springframework.util.CollectionUtils;
@@ -37,6 +38,7 @@
      * @return
      */
     @PostMapping("/add")
+    @Operation(summary = "鏂板妫�楠�")
     public R<?> add(@RequestBody QualityInspectDto qualityInspectDto) {
         return R.ok(qualityInspectService.add(qualityInspectDto));
     }
@@ -48,6 +50,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @Operation(summary = "鍒犻櫎妫�楠�")
     public R<?> delQualityInspect(@RequestBody List<Integer> ids) {
         if (CollectionUtils.isEmpty(ids)) {
             return R.fail("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
@@ -76,6 +79,7 @@
      * @return
      */
     @GetMapping("/{id}")
+    @Operation(summary = "妫�楠岃鎯�")
     public R<?> QualityInspectDetail(@PathVariable("id") Integer id) {
         return R.ok(qualityInspectService.getDetailById(id));
     }
@@ -87,6 +91,7 @@
      * @return
      */
     @PostMapping("/update")
+    @Operation(summary = "淇敼妫�楠�")
     public R<?> update(@RequestBody QualityInspectDto qualityInspectDto) {
         return R.ok(qualityInspectService.updateQualityInspect(qualityInspectDto));
     }
@@ -99,6 +104,7 @@
      * @return
      */
     @GetMapping("/listPage")
+    @Operation(summary = "鍒嗛〉鏌ヨ妫�楠�")
     public R<?> qualityInspectListPage(Page page, QualityInspectDto qualityInspect) {
         return R.ok(qualityInspectService.qualityInspectListPage(page, qualityInspect));
     }
@@ -110,6 +116,7 @@
      * @param qualityInspect
      */
     @PostMapping("/export")
+    @Operation(summary = "瀵煎嚭妫�楠�")
     public void qualityInspectExport(HttpServletResponse response, QualityInspect qualityInspect) {
         qualityInspectService.qualityInspectExport(response, qualityInspect);
     }
@@ -121,6 +128,7 @@
      * @return
      */
     @PostMapping("/submit")
+    @Operation(summary = "鎻愪氦妫�楠�")
     public R<?> submit(@RequestBody QualityInspect qualityInspect) {
         return R.ok(qualityInspectService.submit(qualityInspect));
     }
@@ -132,6 +140,7 @@
      * @param qualityInspect
      */
     @PostMapping("/down")
+    @Operation(summary = "涓嬭浇妫�楠�")
     public void down(HttpServletResponse response, @RequestBody QualityInspect qualityInspect) {
         qualityInspectService.down(response, qualityInspect);
     }
diff --git a/src/main/java/com/ruoyi/quality/controller/QualityInspectParamController.java b/src/main/java/com/ruoyi/quality/controller/QualityInspectParamController.java
index b408be6..21bfa2e 100644
--- a/src/main/java/com/ruoyi/quality/controller/QualityInspectParamController.java
+++ b/src/main/java/com/ruoyi/quality/controller/QualityInspectParamController.java
@@ -9,6 +9,7 @@
 import com.ruoyi.quality.service.IQualityInspectFileService;
 import com.ruoyi.quality.service.IQualityInspectParamService;
 import com.ruoyi.quality.service.IQualityInspectService;
+import io.swagger.v3.oas.annotations.Operation;
 import org.springframework.util.CollectionUtils;
 import org.springframework.web.bind.annotation.*;
 
@@ -32,6 +33,7 @@
      * @return
      */
     @GetMapping("/{inspectId}")
+    @Operation(summary = "妫�楠屽弬鏁伴」璇︽儏")
     public R<?> QualityInspectParamDetail(@PathVariable("inspectId") Integer inspectId) {
         return R.ok(qualityInspectParamService.qualityInspectParamDetail(inspectId));
     }
@@ -43,6 +45,7 @@
      * @return
      */
     @PostMapping("/update")
+    @Operation(summary = "淇敼妫�楠屽弬鏁伴」")
     public R<?> update(@RequestBody List<QualityInspectParam> qualityInspectParams) {
         return R.ok(qualityInspectParamService.updateBatchById(qualityInspectParams));
     }
@@ -53,6 +56,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @Operation(summary = "鍒犻櫎妫�楠屽弬鏁伴」")
     public R<?> delQualityUnqualified(@RequestBody List<Integer> ids) {
         if(CollectionUtils.isEmpty(ids)){
             return R.fail("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
diff --git a/src/main/java/com/ruoyi/quality/controller/QualityTestStandardBindingController.java b/src/main/java/com/ruoyi/quality/controller/QualityTestStandardBindingController.java
index c34f3ee..e590802 100644
--- a/src/main/java/com/ruoyi/quality/controller/QualityTestStandardBindingController.java
+++ b/src/main/java/com/ruoyi/quality/controller/QualityTestStandardBindingController.java
@@ -3,6 +3,8 @@
 import com.ruoyi.framework.web.domain.R;
 import com.ruoyi.quality.pojo.QualityTestStandardBinding;
 import com.ruoyi.quality.service.QualityTestStandardBindingService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.AllArgsConstructor;
 import org.springframework.util.CollectionUtils;
 import org.springframework.web.bind.annotation.*;
@@ -20,6 +22,7 @@
 @RestController
 @RequestMapping("/qualityTestStandardBinding")
 @AllArgsConstructor
+@Tag(name = "妫�娴嬫爣鍑嗕富琛ㄤ笌浜у搧鍏宠仈琛�")
 public class QualityTestStandardBindingController {
 
     private QualityTestStandardBindingService qualityTestStandardBindingService;
@@ -31,6 +34,7 @@
      * @return
      */
     @PostMapping("/add")
+    @Operation(summary = "鏂板妫�娴嬫爣鍑嗕富琛ㄤ笌浜у搧鍏宠仈琛�")
     public R<?> add(@RequestBody List<QualityTestStandardBinding> qualityTestStandardBindings) {
         return R.ok(qualityTestStandardBindingService.add(qualityTestStandardBindings));
     }
@@ -42,6 +46,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @Operation(summary = "鍒犻櫎妫�娴嬫爣鍑嗕富琛ㄤ笌浜у搧鍏宠仈琛�")
     public R<?> delQualityTestStandard(@RequestBody List<Integer> ids) {
         if (CollectionUtils.isEmpty(ids)) {
             return R.fail("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
@@ -55,6 +60,7 @@
      * @return
      */
     @GetMapping("/list")
+    @Operation(summary = "妫�娴嬫寚鏍囩淮鎶ゆ煡璇�")
     public R<?> listBinding(Long testStandardId) {
         return R.ok(qualityTestStandardBindingService.listBinding(testStandardId));
     }
diff --git a/src/main/java/com/ruoyi/quality/controller/QualityTestStandardController.java b/src/main/java/com/ruoyi/quality/controller/QualityTestStandardController.java
index 42aa2ea..0ccfd65 100644
--- a/src/main/java/com/ruoyi/quality/controller/QualityTestStandardController.java
+++ b/src/main/java/com/ruoyi/quality/controller/QualityTestStandardController.java
@@ -7,6 +7,8 @@
 import com.ruoyi.quality.pojo.QualityTestStandardParam;
 import com.ruoyi.quality.service.IQualityTestStandardService;
 import com.ruoyi.quality.service.QualityTestStandardParamService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import org.springframework.util.CollectionUtils;
 import org.springframework.web.bind.annotation.*;
 
@@ -24,6 +26,7 @@
  */
 @RestController
 @RequestMapping("/qualityTestStandard")
+@Tag(name = "妫�娴嬫爣鍑嗕富琛�")
 public class QualityTestStandardController {
 
     @Resource
@@ -39,6 +42,7 @@
      * @return
      */
     @PostMapping("/add")
+    @Operation(summary = "鏂板妫�娴嬫爣鍑嗕富琛�")
     public R<?> add(@RequestBody QualityTestStandard qualityTestStandard) {
         return R.ok(qualityTestStandardService.save(qualityTestStandard));
     }
@@ -49,6 +53,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @Operation(summary = "鍒犻櫎妫�娴嬫爣鍑嗕富琛�")
     public R<?> delQualityTestStandard(@RequestBody List<Integer> ids) {
         if(CollectionUtils.isEmpty(ids)){
             return R.fail("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
@@ -62,6 +67,7 @@
      * @return
      */
     @PostMapping("/update")
+    @Operation(summary = "妫�娴嬫爣鍑嗕富琛ㄤ慨鏀�")
     public R<?> update(@RequestBody QualityTestStandard qualityTestStandard) {
         return R.ok(qualityTestStandardService.updateById(qualityTestStandard));
     }
@@ -73,6 +79,7 @@
      * @return
      */
     @GetMapping("/listPage")
+    @Operation(summary = "妫�娴嬫爣鍑嗕富琛ㄥ垎椤垫煡璇�")
     public R<?> qualityTestStandardListPage(Page page, QualityTestStandard qualityTestStandard) {
         return R.ok(qualityTestStandardService.qualityTestStandardListPage(page, qualityTestStandard));
     }
@@ -83,6 +90,7 @@
      * @return
      */
     @PostMapping("/copyParam")
+    @Operation(summary = "妫�娴嬫爣鍑嗗鍒跺弬鏁�")
     public R<?> copyParam(@RequestBody QualityTestStandard qualityTestStandard) {
         return R.ok(qualityTestStandardService.copyParam(qualityTestStandard));
     }
@@ -93,6 +101,7 @@
      * @return
      */
     @PostMapping("/qualityTestStandardAudit")
+    @Operation(summary = "妫�娴嬫爣鍑嗘壒閲忓鏍�")
     public R<?> qualityTestStandardAudit(@RequestBody List<QualityTestStandard> qualityTestStandards) {
         return R.ok(qualityTestStandardService.updateBatchById(qualityTestStandards));
     }
@@ -102,6 +111,7 @@
      * @return
      */
     @GetMapping("/getQualityTestStandardByProductId")
+    @Operation(summary = "鏍规嵁浜у搧id鏌ヨ鐩稿叧鐨勬楠屾爣鍑�")
     public R<?> getQualityTestStandardByProductId(@Nonnull Long productId, @Nonnull Integer inspectType, String process) {
         return R.ok(qualityTestStandardService.getQualityTestStandardByProductId(productId,inspectType,process));
     }
@@ -111,6 +121,7 @@
      * @return
      */
     @GetMapping("/getQualityTestStandardParamByTestStandardId")
+    @Operation(summary = "鏍规嵁妫�娴嬫爣鍑唅d鏌ヨ鐩稿叧鐨勬楠屾爣鍑嗗弬鏁�")
     public R<?> getQualityTestStandardParamByTestStandardId(Long testStandardId) {
         return R.ok(qualityTestStandardParamService.list(Wrappers.<QualityTestStandardParam>lambdaQuery().eq(QualityTestStandardParam::getTestStandardId, testStandardId)));
     }
diff --git a/src/main/java/com/ruoyi/quality/controller/QualityTestStandardParamController.java b/src/main/java/com/ruoyi/quality/controller/QualityTestStandardParamController.java
index 44dc0cd..a12535b 100644
--- a/src/main/java/com/ruoyi/quality/controller/QualityTestStandardParamController.java
+++ b/src/main/java/com/ruoyi/quality/controller/QualityTestStandardParamController.java
@@ -6,6 +6,8 @@
 import com.ruoyi.quality.pojo.QualityTestStandard;
 import com.ruoyi.quality.pojo.QualityTestStandardParam;
 import com.ruoyi.quality.service.QualityTestStandardParamService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.AllArgsConstructor;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.util.CollectionUtils;
@@ -24,6 +26,7 @@
 @RestController
 @RequestMapping("/qualityTestStandardParam")
 @AllArgsConstructor
+@Tag(name = "妫�娴嬫爣鍑嗗弬鏁�")
 public class QualityTestStandardParamController {
 
     private QualityTestStandardParamService qualityTestStandardParamService;
@@ -34,6 +37,7 @@
      * @return
      */
     @PostMapping("/add")
+    @Operation(summary = "鏂板妫�娴嬫爣鍑嗗弬鏁�")
     public R<?> add(@RequestBody QualityTestStandardParam qualityTestStandardParam) {
         return R.ok(qualityTestStandardParamService.save(qualityTestStandardParam));
     }
@@ -44,6 +48,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @Operation(summary = "鍒犻櫎妫�娴嬫寚鏍囩淮鎶�")
     public R<?> delQualityTestStandard(@RequestBody List<Integer> ids) {
         if(CollectionUtils.isEmpty(ids)){
             return R.fail("璇烽�夋嫨鑷冲皯涓�鏉℃暟鎹�");
@@ -57,6 +62,7 @@
      * @return
      */
     @PostMapping("/update")
+    @Operation(summary = "妫�娴嬫寚鏍囩淮鎶や慨鏀�")
     public R<?> update(@RequestBody QualityTestStandardParam qualityTestStandardParam) {
         return R.ok(qualityTestStandardParamService.updateById(qualityTestStandardParam));
     }
@@ -66,6 +72,7 @@
      * @return
      */
     @GetMapping("/list")
+    @Operation(summary = "妫�娴嬫寚鏍囩淮鎶ゆ煡璇�")
     public R<?> list(Long testStandardId) {
         return R.ok(qualityTestStandardParamService.list(Wrappers.<QualityTestStandardParam>lambdaQuery().eq(QualityTestStandardParam::getTestStandardId,testStandardId)));
     }
diff --git a/src/main/java/com/ruoyi/quality/controller/QualityUnqualifiedController.java b/src/main/java/com/ruoyi/quality/controller/QualityUnqualifiedController.java
index 33c6005..020841f 100644
--- a/src/main/java/com/ruoyi/quality/controller/QualityUnqualifiedController.java
+++ b/src/main/java/com/ruoyi/quality/controller/QualityUnqualifiedController.java
@@ -4,6 +4,8 @@
 import com.ruoyi.framework.web.domain.R;
 import com.ruoyi.quality.pojo.QualityUnqualified;
 import com.ruoyi.quality.service.IQualityUnqualifiedService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
 import org.springframework.util.CollectionUtils;
 import org.springframework.web.bind.annotation.*;
 
@@ -16,6 +18,7 @@
  */
 @RestController
 @RequestMapping("/quality/qualityUnqualified")
+@Tag(name = "涓嶅悎鏍肩鐞�")
 public class QualityUnqualifiedController {
 
     @Resource
@@ -28,6 +31,7 @@
      * @return
      */
     @PostMapping("/add")
+    @Operation(summary = "鏂板涓嶅悎鏍肩鐞�")
     public R<?> add(@RequestBody QualityUnqualified qualityUnqualified) {
         qualityUnqualified.setInspectState(0);
         return R.ok(qualityUnqualifiedService.save(qualityUnqualified));
@@ -39,6 +43,7 @@
      * @return
      */
     @DeleteMapping("/del")
+    @Operation(summary = "鍒犻櫎涓嶅悎鏍肩鐞�")
     public R<?> delQualityUnqualified(@RequestBody List<Integer> ids) {
        qualityUnqualifiedService.listByIds(ids).stream().forEach(qualityUnqualified -> {
            if (qualityUnqualified.getInspectState()==1){
@@ -54,6 +59,7 @@
      * @return
      */
     @GetMapping("/{id}")
+    @Operation(summary = "涓嶅悎鏍肩鐞嗚鎯�")
     public R<?> QualityUnqualifiedDetail(@PathVariable("id") Integer id) {
         return R.ok(qualityUnqualifiedService.getUnqualified(id));
     }
@@ -64,6 +70,7 @@
      * @return
      */
     @PostMapping("/update")
+    @Operation(summary = "涓嶅悎鏍肩鐞嗕慨鏀�")
     public R<?> update(@RequestBody QualityUnqualified qualityUnqualified) {
         return R.ok(qualityUnqualifiedService.updateById(qualityUnqualified));
     }
@@ -75,6 +82,7 @@
      * @return
      */
     @GetMapping("/listPage")
+    @Operation(summary = "涓嶅悎鏍肩鐞嗗垎椤垫煡璇�")
     public R<?> qualityUnqualifiedListPage(Page page, QualityUnqualified qualityUnqualified) {
         return R.ok(qualityUnqualifiedService.qualityUnqualifiedListPage(page, qualityUnqualified));
     }
@@ -85,6 +93,7 @@
      * @param qualityUnqualified
      */
     @PostMapping("/export")
+    @Operation(summary = "涓嶅悎鏍肩鐞嗗鍑�")
     public void qualityUnqualifiedExport(HttpServletResponse response,QualityUnqualified qualityUnqualified) {
         qualityUnqualifiedService.qualityUnqualifiedExport(response, qualityUnqualified);
     }
@@ -95,6 +104,7 @@
      * @return
      */
     @PostMapping("/deal")
+    @Operation(summary = "涓嶅悎鏍肩鐞嗗鐞�")
     public R<?> deal(@RequestBody QualityUnqualified qualityUnqualified) {
         return R.ok(qualityUnqualifiedService.deal(qualityUnqualified));
     }

--
Gitblit v1.9.3