From 7d2ee3cef2e0d68ba6400bc5957640d2771bbf4c Mon Sep 17 00:00:00 2001
From: liu <2021943741@qq.com>
Date: 星期三, 16 九月 2026 18:05:40 +0800
Subject: [PATCH] refactor: 单据审核改为审批配置状态机(新增:audit接口/审核人字段/DB变更脚本)

---
 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pd/techconfirm/ProductTechConfirmService.java |   88 ++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 88 insertions(+), 0 deletions(-)

diff --git a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pd/techconfirm/ProductTechConfirmService.java b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pd/techconfirm/ProductTechConfirmService.java
index 8192ac3..8293229 100644
--- a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pd/techconfirm/ProductTechConfirmService.java
+++ b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pd/techconfirm/ProductTechConfirmService.java
@@ -5,21 +5,109 @@
 import cn.iocoder.yudao.module.mes.controller.admin.pd.techconfirm.vo.ProductTechConfirmSaveReqVO;
 import cn.iocoder.yudao.module.mes.dal.dataobject.pd.techconfirm.ProductTechConfirmDO;
 
+import java.util.Set;
+
 /**
  * MES 浜у搧鎶�鏈‘璁ゅ嚱 Service 鎺ュ彛
+ *
+ * 鐘舵�佹祦杞畬鍏ㄧ敱涓氬姟娴佺▼椹卞姩锛屼笉鎺ュ彈鍓嶇鐩存帴鎸囧畾鐘舵�侊細
+ * <pre>
+ *   0 鑽夌 --鎻愪氦瀹℃牳--> 1 寰呭鏍� --瀹℃牳閫氳繃--> 2 宸插鏍� --瀹㈡埛纭--> 3 瀹㈡埛宸茬‘璁�
+ *      ^                    |
+ *      |                    +--瀹℃牳涓嶉�氳繃--> 4 瀹℃牳涓嶉�氳繃
+ *      |                                        |
+ *      +----------------------------------------+  瀹℃牳涓嶉�氳繃鍙慨鏀瑰悗閲嶆柊鎻愪氦
+ * </pre>
+ * 鍙湁鑽夌涓庡鏍镐笉閫氳繃鐘舵�佸厑璁镐慨鏀逛笟鍔″瓧娈碉紝寰呭鏍� / 宸插鏍� / 瀹㈡埛宸茬‘璁や负閿佸畾鎴栫粓鎬併��
  *
  * @author 瓒呯骇绠$悊鍛�
  */
 public interface ProductTechConfirmService {
 
+    /**
+     * 鍒涘缓鎶�鏈‘璁ゅ嚱
+     *
+     * 鐘舵�佸浐瀹氫负鑽夌锛岀紪鍒朵汉 / 缂栧埗鏃堕棿鍙栧綋鍓嶇櫥褰曠敤鎴蜂笌褰撳墠鏃堕棿銆�
+     *
+     * @param createReqVO 鍒涘缓淇℃伅
+     * @return 缂栧彿
+     */
     Long createTechConfirm(ProductTechConfirmSaveReqVO createReqVO);
 
+    /**
+     * 淇敼鎶�鏈‘璁ゅ嚱
+     *
+     * 浠呰崏绋夸笌瀹℃牳涓嶉�氳繃鐘舵�佸厑璁镐慨鏀癸紝鍏朵綑鐘舵�佷竴寰嬫嫆缁濄��
+     *
+     * @param updateReqVO 淇敼淇℃伅
+     */
     void updateTechConfirm(ProductTechConfirmSaveReqVO updateReqVO);
 
+    /**
+     * 鍒犻櫎鎶�鏈‘璁ゅ嚱
+     *
+     * 浠呰崏绋夸笌瀹℃牳涓嶉�氳繃鐘舵�佸厑璁稿垹闄ゃ��
+     *
+     * @param id 缂栧彿
+     */
     void deleteTechConfirm(Long id);
 
+    /**
+     * 鑾峰緱鎶�鏈‘璁ゅ嚱
+     *
+     * @param id 缂栧彿
+     * @return 鎶�鏈‘璁ゅ嚱
+     */
     ProductTechConfirmDO getTechConfirm(Long id);
 
+    /**
+     * 鑾峰緱鎶�鏈‘璁ゅ嚱鍒嗛〉
+     *
+     * @param pageReqVO 鍒嗛〉鏌ヨ
+     * @return 鎶�鏈‘璁ゅ嚱鍒嗛〉
+     */
     PageResult<ProductTechConfirmDO> getTechConfirmPage(ProductTechConfirmPageReqVO pageReqVO);
 
+    /**
+     * 鎻愪氦瀹℃牳锛堣崏绋� / 瀹℃牳涓嶉�氳繃 鈫� 寰呭鏍革級
+     *
+     * 瀹℃牳浜虹敱銆岀郴缁熺鐞� - 瀹℃壒閰嶇疆銆嶆寜涓氬姟绫诲瀷缁熶竴閰嶇疆锛堜笟鍔$紪鐮� pd_tech_confirm_approve锛夛紝
+     * 鎻愪氦鏃舵棤闇�鎸囧畾锛涙湭鍚敤瀹℃壒鎴栨湭閰嶇疆鏈夋晥瀹℃牳浜烘椂鎶涘嚭涓氬姟寮傚父銆�
+     *
+     * @param id 缂栧彿
+     */
+    void submitTechConfirmAudit(Long id);
+
+    /**
+     * 鑾峰緱鎶�鏈‘璁ゅ嚱瀹℃牳鐨勫鏍镐汉缂栧彿闆嗗悎
+     *
+     * 渚涘墠绔垽鏂綋鍓嶇櫥褰曠敤鎴锋槸鍚﹀簲灞曠ず銆屽鏍搞�嶆寜閽紱鏈厤缃椂杩斿洖绌洪泦鍚堛��
+     *
+     * @return 瀹℃牳浜虹敤鎴风紪鍙烽泦鍚�
+     */
+    Set<Long> getTechConfirmApproverUserIds();
+
+    /**
+     * 瀹℃牳鎶�鏈‘璁ゅ嚱锛堝緟瀹℃牳 鈫� 宸插鏍� / 瀹℃牳涓嶉�氳繃锛�
+     *
+     * 浠呬笟鍔$紪鐮� pd_tech_confirm_approve 閰嶇疆鐨勫鏍镐汉鍙搷浣滐紙澶氫汉鏃舵垨绛撅級锛屼笖浠呭湪寰呭鏍哥姸鎬佷笅鍏佽銆�
+     * 瀹℃牳閫氳繃璁板綍瀹℃牳浜轰笌瀹℃牳鏃堕棿锛涘鏍镐笉閫氳繃蹇呴』濉啓涓嶉�氳繃鍘熷洜锛�
+     * 浣垮崟鎹��鍥炲彲淇敼鐘舵�侊紝鐢辩紪鍒朵汉淇敼鍚庨噸鏂版彁浜ゃ��
+     *
+     * @param id           缂栧彿
+     * @param pass         鏄惁閫氳繃锛宼rue=閫氳繃 / false=涓嶉�氳繃
+     * @param reviewRemark 瀹℃牳鎰忚锛屽鏍镐笉閫氳繃鏃跺繀濉�
+     */
+    void auditTechConfirm(Long id, Boolean pass, String reviewRemark);
+
+    /**
+     * 瀹㈡埛纭锛堝凡瀹℃牳 鈫� 瀹㈡埛宸茬‘璁わ級
+     *
+     * 鐢变笟鍔″憳浠e鎴锋墽琛岋紝璁板綍瀹㈡埛纭浜轰笌瀹㈡埛纭鏃堕棿銆�
+     *
+     * @param id                  缂栧彿
+     * @param customerConfirmUser 瀹㈡埛纭浜哄鍚�
+     */
+    void confirmTechConfirmByCustomer(Long id, String customerConfirmUser);
+
 }

--
Gitblit v1.9.3