From fe5a19157ad154de5e95770bc137d58a1d8fbec0 Mon Sep 17 00:00:00 2001
From: dzq <dzq@ys.com>
Date: Mon, 5 May 2025 16:43:50 +0800
Subject: [PATCH] =?UTF-8?q?docs(ShopController):=20=E6=B7=BB=E5=8A=A0?=
 =?UTF-8?q?=E5=BE=AE=E4=BF=A1=E5=92=8C=E4=BC=81=E4=B8=9A=E5=BE=AE=E4=BF=A1?=
 =?UTF-8?q?=E7=9B=B8=E5=85=B3=E6=8E=A5=E5=8F=A3=E7=9A=84=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

为微信端授权登录、企业微信推送消息跳转、企业微信聊天界面跳转等接口添加详细注释，明确各接口的功能和使用场景
---
 .../api/controller/ShopController.java        | 34 ++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/agileboot-api/src/main/java/com/agileboot/api/controller/ShopController.java b/agileboot-api/src/main/java/com/agileboot/api/controller/ShopController.java
index c225823..d215b34 100644
--- a/agileboot-api/src/main/java/com/agileboot/api/controller/ShopController.java
+++ b/agileboot-api/src/main/java/com/agileboot/api/controller/ShopController.java
@@ -67,6 +67,12 @@ public class ShopController {
         return ResponseDTO.ok(new ShopGoodsResponse(goodsWithCabinetList, categoryList, "0"));
     }
 
+    /**
+     * 微信端商店入口，用于微信端授权登录
+     * 参数中包含token为汇邦云登录
+     * @param request
+     * @return
+     */
     @GetMapping("/wechatAuth")
     public RedirectView wechatAuthRedirect(HttpServletRequest request) {
         /*java.util.StringJoiner joiner = new java.util.StringJoiner("&");
@@ -104,6 +110,11 @@ public class ShopController {
         return new RedirectView(authUrl);
     }
 
+    /**
+     * 企业微信推送消息点击商品图片后跳转的地址
+     * @param request
+     * @return
+     */
     @GetMapping("/qy/wechatAuth")
     public RedirectView qyWechatAuthRedirect(HttpServletRequest request) {
         /*java.util.StringJoiner joiner = new java.util.StringJoiner("&");
@@ -123,6 +134,11 @@ public class ShopController {
         return new RedirectView(authUrl);
     }
 
+    /**
+     * 企业微信推送消息点击商品图片后跳转的地址
+     * @param request
+     * @return
+     */
     @GetMapping("/approvalRedirect")
     public RedirectView approvalRedirect(HttpServletRequest request) {
         UriComponentsBuilder builder = UriComponentsBuilder
@@ -139,7 +155,11 @@ public class ShopController {
         return new RedirectView(builder.build().encode().toUriString());
     }
 
-
+    /**
+     * 企业微信聊天界面点击进入主页后跳转的地址
+     * @param request
+     * @return
+     */
     @GetMapping("/qy/wechatAuth/home")
     public RedirectView qyWechatAuthHomeRedirect(HttpServletRequest request) {
         String userAgent = request.getHeader("User-Agent");
@@ -157,6 +177,12 @@ public class ShopController {
         return new RedirectView(authUrl);
     }
 
+    /**
+     * 企业微信聊天界面点击进入主页后跳转的地址
+     * 移动端
+     * @param request
+     * @return
+     */
     @GetMapping("/homeRedirect")
     public RedirectView homeRedirect(HttpServletRequest request) {
         UriComponentsBuilder builder = UriComponentsBuilder
@@ -173,6 +199,12 @@ public class ShopController {
         return new RedirectView(builder.build().encode().toUriString());
     }
 
+    /**
+     * 企业微信聊天界面点击进入主页后跳转的地址
+     * PC端
+     * @param request
+     * @return
+     */
     @GetMapping("/adminRedirect")
     public RedirectView adminRedirect(HttpServletRequest request) {
         UriComponentsBuilder builder = UriComponentsBuilder