提交修改

api-common/src/main/java/com/heyu/api/common/annotation/Describe.java

@@ -0,0 +1,19 @@
+//
+// Source code recreated from a .class file by IntelliJ IDEA
+// (powered by FernFlower decompiler)
+//
+
+package com.heyu.api.common.annotation;
+
+import java.lang.annotation.*;
+
+@Target({ElementType.TYPE, ElementType.METHOD})
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface Describe {
+
+
+    String value() default "";
+
+
+}

api-third/src/main/java/com/heyu/api/alibaba/request/mm/VvAppCategoryRequest.java

@@ -1,10 +1,11 @@
 package com.heyu.api.alibaba.request.mm;
 
 
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 @Data
-public class VvAppCategoryRequest {
+public class VvAppCategoryRequest  extends VVBaseRequest {
 
     /***
      * 父亲id

api-third/src/main/java/com/heyu/api/alibaba/request/mm/VvAppLoginRequest.java

@@ -1,14 +1,11 @@
 package com.heyu.api.alibaba.request.mm;
 
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 @Data
-public class VvAppLoginRequest {
+public class VvAppLoginRequest extends VVBaseRequest {
 
-    /***
-     * 买家id，当前登录的买家id
-     */
-    private Long buyerId ;
 
     /***
      * 目标买家信息 ，如 buyer_name， buyer_weixin， buyer_phone

api-third/src/main/java/com/heyu/api/alibaba/request/mm/VvAppLogisticsRequest.java

@@ -1,14 +1,11 @@
 package com.heyu.api.alibaba.request.mm;
 
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 @Data
-public class VvAppLogisticsRequest {
+public class VvAppLogisticsRequest extends VVBaseRequest {
 
-    /***
-     * 买家id，当前登录的买家id
-     */
-    private Long buyerId ;
 
 
     /***

api-third/src/main/java/com/heyu/api/alibaba/request/mm/VvProductDetailRequest.java

@@ -1,10 +1,11 @@
 package com.heyu.api.alibaba.request.mm;
 
 
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 @Data
-public class VvProductDetailRequest {
+public class VvProductDetailRequest  extends VVBaseRequest {
 
 
     /***

api-third/src/main/java/com/heyu/api/alibaba/request/mm/order/AppDeliveredDTO.java

@@ -1,10 +1,11 @@
 package com.heyu.api.alibaba.request.mm.order;
 
 
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 @Data
-public class AppDeliveredDTO {
+public class AppDeliveredDTO extends VVBaseRequest {
 
 
     /***

api-third/src/main/java/com/heyu/api/alibaba/request/mm/order/resp/VvTradeOrderDTO.java

@@ -3,16 +3,15 @@ package com.heyu.api.alibaba.request.mm.order.resp;
 
 import com.alibaba.fastjson.JSON;
 import com.google.common.collect.Lists;
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 import java.util.List;
 
 @Data
-public class VvTradeOrderDTO {
+public class VvTradeOrderDTO  extends VVBaseRequest {
 
 
-    private Long buyerId;
-
     private List<VvTradeOrderLineDTO> vvTradeOrderLineDTOList;
 
 

api-third/src/main/java/com/heyu/api/alibaba/request/mm/order/resp/VvTradeOrderDeleteDTO.java

@@ -1,10 +1,11 @@
 package com.heyu.api.alibaba.request.mm.order.resp;
 
 
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 @Data
-public class VvTradeOrderDeleteDTO {
+public class VvTradeOrderDeleteDTO  extends VVBaseRequest {
 
 
     /***
@@ -13,11 +14,6 @@ public class VvTradeOrderDeleteDTO {
     private String trackNumber;
 
 
-    /***
-     * 买家id
-     */
-    private Long buyerId ;
-
 
 
 }

api-third/src/main/java/com/heyu/api/alibaba/request/mm/reverse/AppliyReverseCloseRequest.java

@@ -1,10 +1,11 @@
 package com.heyu.api.alibaba.request.mm.reverse;
 
 
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 @Data
-public class AppliyReverseCloseRequest {
+public class AppliyReverseCloseRequest extends VVBaseRequest {
 
 
 

api-third/src/main/java/com/heyu/api/alibaba/request/mm/reverse/AppliyReverseProveRequest.java

@@ -2,12 +2,13 @@ package com.heyu.api.alibaba.request.mm.reverse;
 
 
 import com.heyu.api.alibaba.request.mm.order.ResourceDTO;
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 import java.util.List;
 
 @Data
-public class AppliyReverseProveRequest {
+public class AppliyReverseProveRequest extends VVBaseRequest {
 
 
     /***

api-third/src/main/java/com/heyu/api/alibaba/request/mm/reverse/AppliyReverseRequest.java

@@ -2,13 +2,14 @@ package com.heyu.api.alibaba.request.mm.reverse;
 
 
 import com.heyu.api.alibaba.request.mm.order.ResourceDTO;
+import com.heyu.api.alibaba.request.vv.VVBaseRequest;
 import lombok.Data;
 
 import java.math.BigDecimal;
 import java.util.List;
 
 @Data
-public class AppliyReverseRequest {
+public class AppliyReverseRequest extends VVBaseRequest {
 
     /***
      *  物流单号

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppBuyerAddressRequest.java

@@ -4,7 +4,7 @@ package com.heyu.api.alibaba.request.vv;
 import lombok.Data;
 
 @Data
-public class AppBuyerAddressRequest {
+public class AppBuyerAddressRequest  extends VVBaseRequest {
 
 
     private int pageNum = 1;
@@ -13,9 +13,5 @@ public class AppBuyerAddressRequest {
     private int pageSize = 10;
 
 
-    /***
-     * 买家id
-     */
-    private Long buyerId;
 
 }

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppCommentAdd.java

@@ -8,13 +8,10 @@ import java.util.ArrayList;
 import java.util.List;
 
 @Data
-public class AppCommentAdd {
+public class AppCommentAdd extends VVBaseRequest {
 
 
 
-    //买家id
-    private Long buyerId;
-
 
     //商品评论的内容
     private String productComment;

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppCommentDelete.java

@@ -4,7 +4,7 @@ package com.heyu.api.alibaba.request.vv;
 import lombok.Data;
 
 @Data
-public class AppCommentDelete {
+public class AppCommentDelete  extends VVBaseRequest {
 
 
     /***

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppCommentRequest.java

@@ -4,7 +4,7 @@ package com.heyu.api.alibaba.request.vv;
 import lombok.Data;
 
 @Data
-public class AppCommentRequest {
+public class AppCommentRequest   extends VVBaseRequest{
 
     private int pageNum = 1;
 
@@ -18,10 +18,6 @@ public class AppCommentRequest {
 
 
 
-
-    //买家id
-    private Long buyerId;
-
     /***
      * 排序
      */

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppCommentUseful.java

@@ -4,17 +4,14 @@ import com.alibaba.fastjson.JSON;
 import lombok.Data;
 
 @Data
-public class AppCommentUseful {
+public class AppCommentUseful  extends VVBaseRequest{
 
     /***
      * 评论id
      */
     private Long commentId;
 
-    /***
+
-     * 买家id
-     */
-    private Long buyerId;
 
 
     /***

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppIndexPageRequest.java

@@ -4,7 +4,7 @@ package com.heyu.api.alibaba.request.vv;
 import lombok.Data;
 
 @Data
-public class AppIndexPageRequest {
+public class AppIndexPageRequest extends  VVBaseRequest {
 
 
     private int pageNum = 1;
@@ -44,11 +44,6 @@ public class AppIndexPageRequest {
     private Integer isTest = 0 ;
 
 
-    /***
-     * 买家id
-     */
-    private Long buyerId;
-
     /***
      * 状态
      */

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppOrderRequest.java

@@ -6,17 +6,14 @@ import lombok.Data;
 import java.util.List;
 
 @Data
-public class AppOrderRequest {
+public class AppOrderRequest extends VVBaseRequest{
 
     private int pageNum = 1;
 
 
     private int pageSize = 10;
 
-    /***
+
-     * 买家id
-     */
-    private Long buyerId;
     /***
      * 订单号id
      */

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppShippingCartDeleteRequest.java

@@ -6,7 +6,7 @@ import lombok.Data;
 import java.util.List;
 
 @Data
-public class AppShippingCartDeleteRequest {
+public class AppShippingCartDeleteRequest extends VVBaseRequest {
 
 
     /**

api-third/src/main/java/com/heyu/api/alibaba/request/vv/AppShippingCartRequest.java

@@ -4,7 +4,7 @@ package com.heyu.api.alibaba.request.vv;
 import lombok.Data;
 
 @Data
-public class AppShippingCartRequest {
+public class AppShippingCartRequest extends VVBaseRequest {
 
 
     private Integer pageNum = 1;
@@ -15,10 +15,7 @@ public class AppShippingCartRequest {
     //商品标题
     private String productName;
 
-    /***
+
-     * 买家id
-     */
-    private Long buyerId;
 
 
 

api-third/src/main/java/com/heyu/api/alibaba/request/vv/VVBaseRequest.java

@@ -0,0 +1,18 @@
+package com.heyu.api.alibaba.request.vv;
+
+public class VVBaseRequest {
+
+
+    /***
+     * 买家id，当前登录的买家id
+     */
+    private Long buyerId ;
+
+    public Long getBuyerId() {
+        return buyerId;
+    }
+
+    public void setBuyerId(Long buyerId) {
+        this.buyerId = buyerId;
+    }
+}

api-third/src/main/java/com/heyu/api/alibaba/request/vv/VvShoppingCartAddRequest.java

@@ -3,10 +3,9 @@ package com.heyu.api.alibaba.request.vv;
 import lombok.Data;
 
 @Data
-public class VvShoppingCartAddRequest {
+public class VvShoppingCartAddRequest  extends VVBaseRequest{
+
 
-    //买家id
-    private Long buyerId;
     //sku_id
     private Long skuId;
     //数量

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppBuyerAddressManagerController.java

@@ -4,6 +4,7 @@ package com.heyu.api.controller.vv;
 import com.baomidou.mybatisplus.core.metadata.IPage;
 import com.heyu.api.alibaba.request.mm.enums.BuyerAddressEnums;
 import com.heyu.api.alibaba.request.vv.AppBuyerAddressRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.VvBuyerAddressDao;
 import com.heyu.api.data.dao.vv.VvBuyerDao;
 import com.heyu.api.data.entity.vv.VvBuyerAddressEntity;
@@ -35,6 +36,7 @@ public class AppBuyerAddressManagerController {
     /***
      * 列表
      */
+    @Describe("买家地址列表")
     @RequestMapping("/list")
     public R list(@RequestBody AppBuyerAddressRequest appBuyerAddressRequest) {
 
@@ -52,7 +54,7 @@ public class AppBuyerAddressManagerController {
         return R.ok().setData(pageUtils);
     }
 
-
+    @Describe("买家地址插入或修改")
     @RequestMapping("/insertOrUpdate")
     public R inserOrUpdate(@RequestBody VvBuyerAddressEntity vvBuyerAddressEntity) {
         VvBuyerEntity vvBuyerEntity = vvBuyerDao.selectVvBuyerById(vvBuyerAddressEntity.getBuyerId());

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppCategoryController.java

@@ -2,6 +2,7 @@ package com.heyu.api.controller.vv;
 
 
 import com.heyu.api.alibaba.request.mm.VvAppCategoryRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.VvAppCategoryDao;
 import com.heyu.api.data.dto.vv.VvAppCategoryCategoryDTO;
 import com.heyu.api.data.entity.vv.VvAppCategoryEntity;
@@ -31,6 +32,7 @@ public class AppCategoryController {
      * http://localhost:8888/app/category/list
      */
     @RequestMapping("/list")
+    @Describe("app类目列表")
     public R list(@RequestBody VvAppCategoryRequest vvCategoryRequest) {
         List<VvAppCategoryEntity> vvCategoryEntities = vvAppCategoryDao.selectVvCategoryAll();
 

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppCommentController.java

@@ -6,6 +6,7 @@ import com.baomidou.mybatisplus.core.metadata.IPage;
 import com.heyu.api.alibaba.request.mm.enums.CommentStatusEnums;
 import com.heyu.api.alibaba.request.mm.order.resp.PropertyNameValue;
 import com.heyu.api.alibaba.request.vv.*;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.*;
 import com.heyu.api.data.dto.vv.VvCommentDTO;
 import com.heyu.api.data.entity.vv.*;
@@ -63,6 +64,7 @@ public class AppCommentController {
      * 列表
      */
     @RequestMapping("/list")
+    @Describe("评论列表")
     public R list(@RequestBody AppCommentRequest appCommentRequest) {
 
         PPageUtils pageUtils = null;
@@ -146,6 +148,7 @@ public class AppCommentController {
     /***
      * /app/comment/add
      */
+    @Describe("添加评论")
     @RequestMapping("/add")
     public R add(@RequestBody AppCommentAdd appCommentRequest) {
         List<VvTradeOrderLineEntity> vvTradeOrderLineEntityList = vvTradeOrderLineDao.selectVvTradeOrderLineByTrackNumberGroupBySkuId(appCommentRequest.getTrackNumber());
@@ -215,6 +218,7 @@ public class AppCommentController {
     /***
      *
      */
+    @Describe("评论是否有用")
     @RequestMapping("/useful")
     public R useful(@RequestBody AppCommentUseful appCommentRequest) {
         VvCommentUserfulEntity vvCommentUserful = vvCommentUserfulDao.selectVvCommentUserfulByCommentIdBuyerId(appCommentRequest.getCommentId(), appCommentRequest.getBuyerId());
@@ -249,6 +253,7 @@ public class AppCommentController {
     /***
      * 删除
      */
+    @Describe("删除评论")
     @RequestMapping("/delete")
     public R list(@RequestBody AppCommentDelete appCommentRequest) {
         vvCommentDao.deleteVvCommentById(appCommentRequest.getCommentId());

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppIndexPageController.java

@@ -5,6 +5,7 @@ import com.baomidou.mybatisplus.core.metadata.IPage;
 import com.heyu.api.alibaba.request.mm.VvProductDetailRequest;
 import com.heyu.api.alibaba.request.mm.enums.ProductStatusEnums;
 import com.heyu.api.alibaba.request.vv.AppIndexPageRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.*;
 import com.heyu.api.data.dto.vv.VvProductDTO;
 import com.heyu.api.data.dto.vv.VvProductPropertyDTO;
@@ -63,6 +64,7 @@ public class AppIndexPageController {
      * 列表        /app/index/page/list
      */
     @RequestMapping("/page/list")
+    @Describe("商品首页列表")
     public R list(@RequestBody AppIndexPageRequest vvProductRequest) {
         vvProductRequest.setFrontPage(1);
         vvProductRequest.setStatus(ProductStatusEnums.online.getStatus());
@@ -99,6 +101,7 @@ public class AppIndexPageController {
 
 
     // /app/index/product/detail
+    @Describe("商品详情页")
     @RequestMapping("/product/detail")
     public R detail(@RequestBody VvProductDetailRequest vvProductDetailRequest) {
         VvProductDTO vvProductDTO = new VvProductDTO();

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppLoginController.java

@@ -3,6 +3,7 @@ package com.heyu.api.controller.vv;
 
 import com.alibaba.fastjson.JSON;
 import com.heyu.api.alibaba.request.mm.VvAppLoginRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.VvBuyerDao;
 import com.heyu.api.data.dto.BuyerDTO;
 import com.heyu.api.data.entity.vv.VvBuyerEntity;
@@ -28,6 +29,7 @@ public class AppLoginController {
 
     // http://localhost:8888/app/target/login
     @RequestMapping("/login")
+    @Describe("目标用户登录")
     public R login(@RequestBody VvAppLoginRequest request) {
         VvBuyerEntity vvBuyerEntity = vvBuyerDao.selectVvBuyerIsTestById(request.getBuyerId(), 1);
         if (vvBuyerEntity == null) {

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppLogisticsController.java

@@ -3,6 +3,7 @@ package com.heyu.api.controller.vv;
 
 import com.alibaba.fastjson.JSON;
 import com.heyu.api.alibaba.request.mm.VvAppLogisticsRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.VvPackageDao;
 import com.heyu.api.data.dao.vv.VvTradeOrderLineDao;
 import com.heyu.api.data.dto.vv.KuaiDi100DTO;
@@ -35,6 +36,7 @@ public class AppLogisticsController {
 
 
     // http://localhost:8888/app/logistics/query
+    @Describe("物流查询")
     @RequestMapping("/query")
     public R query(@RequestBody VvAppLogisticsRequest request) {
 

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppOrderController.java

@@ -8,6 +8,7 @@ import com.heyu.api.alibaba.request.mm.order.AppDeliveredDTO;
 import com.heyu.api.alibaba.request.mm.order.VvTradeOrderLineTrackNumberDTO;
 import com.heyu.api.alibaba.request.mm.order.resp.*;
 import com.heyu.api.alibaba.request.vv.AppOrderRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.*;
 import com.heyu.api.data.entity.vv.*;
 import com.heyu.api.data.utils.BigDecimalUtil;
@@ -68,6 +69,7 @@ public class AppOrderController {
      * 列表
      * todo quyixiao
      */
+    @Describe("订单列表")
     @RequestMapping("/list")
     public R list(@RequestBody AppOrderRequest vvOrderRequest) {
         PPageUtils pageUtils = PPageUtils.startPage(vvOrderRequest.getPageNum(), vvOrderRequest.getPageSize())
@@ -166,6 +168,7 @@ public class AppOrderController {
     /***
      *  订单添加
      */
+    @Describe("添加订单")
     @RequestMapping("/add")
     public R add(@RequestBody VvTradeOrderDTO vvOrderRequest) {
         List<VvTradeOrderLineEntity> vvTradeOrderLineEntityList = new ArrayList<>();
@@ -298,6 +301,7 @@ public class AppOrderController {
         return R.ok("订单创建成功");
     }
 
+    @Describe("删除订单")
     @RequestMapping("/delete")
     public R add(@RequestBody VvTradeOrderDeleteDTO vvOrderRequest) {
         List<VvTradeOrderLineEntity> vvTradeOrderLineEntityList = vvTradeOrderLineDao.selectVvTradeOrderLineByTrackNumber(vvOrderRequest.getTrackNumber());
@@ -310,6 +314,7 @@ public class AppOrderController {
     /***
      * 订单 妥投   /app/order/delivered
      */
+    @Describe("订单确认收货")
     @RequestMapping("/delivered")
     public R topack(@RequestBody AppDeliveredDTO vvDeliveredDTO) {
         List<VvTradeOrderLineEntity> vvTradeOrderLineEntityList = vvTradeOrderLineDao.selectVvTradeOrderLineByTrackNumber(vvDeliveredDTO.getTrackNumber());

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppOssAuthController.java

@@ -1,6 +1,7 @@
 package com.heyu.api.controller.vv;
 
 
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.annotation.NotIntercept;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -16,6 +17,7 @@ public class AppOssAuthController {
 
     //  // https://api.1024api.com/api-interface/auth
     // http://localhost:8888/auth
+    @Describe("图片认证接口")
     @RequestMapping("/auth")
     public int auth(HttpServletRequest request, HttpServletResponse response) {
 

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppReverseController.java

@@ -7,6 +7,7 @@ import com.heyu.api.alibaba.request.mm.order.ResourceDTO;
 import com.heyu.api.alibaba.request.mm.reverse.AppliyReverseCloseRequest;
 import com.heyu.api.alibaba.request.mm.reverse.AppliyReverseProveRequest;
 import com.heyu.api.alibaba.request.mm.reverse.AppliyReverseRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.*;
 import com.heyu.api.data.entity.vv.*;
 import com.heyu.api.data.utils.BigDecimalUtil;
@@ -52,6 +53,7 @@ public class AppReverseController {
      * @param appliyReverseRequest
      * @return
      */
+    @Describe("逆向订单创建")
     @RequestMapping("/add")
     public R add(@RequestBody AppliyReverseRequest appliyReverseRequest) {
 
@@ -149,6 +151,7 @@ public class AppReverseController {
      * 退货退款 ： /app/reverse/tracknumber
      *
      */
+    @Describe("逆向订单更新订单号")
     @RequestMapping("/upload/tracknumber")
     public R uploadTracknumber(@RequestBody AppliyReverseProveRequest appliyReverseRequest) {
         VvReverseOrderEntity vvReverseOrderEntity = vvReverseOrderDao.selectVvReverseOrderById(appliyReverseRequest.getReverseOrderId());
@@ -178,6 +181,7 @@ public class AppReverseController {
     }
 
 
+    @Describe("逆向订单关闭")
     @RequestMapping("/close")
     public R close(@RequestBody AppliyReverseCloseRequest appliyReverseRequest) {
 

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppShoppingCartController.java

@@ -7,6 +7,7 @@ import com.heyu.api.alibaba.request.mm.order.resp.PropertyNameValue;
 import com.heyu.api.alibaba.request.vv.AppShippingCartDeleteRequest;
 import com.heyu.api.alibaba.request.vv.AppShippingCartRequest;
 import com.heyu.api.alibaba.request.vv.VvShoppingCartAddRequest;
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.dao.vv.*;
 import com.heyu.api.data.dto.vv.VvShoppingCartDTO;
 import com.heyu.api.data.entity.vv.*;
@@ -52,6 +53,7 @@ public class AppShoppingCartController {
     /***
      * 列表   /app/shipping/cart/list
      */
+    @Describe("购物车列表")
     @RequestMapping("/list")
     public R list(@RequestBody AppShippingCartRequest appShippingCartRequest) {
         PPageUtils pageUtils = PPageUtils.startPage(appShippingCartRequest.getPageNum(), appShippingCartRequest.getPageSize())
@@ -97,6 +99,7 @@ public class AppShoppingCartController {
     /***
      * 更新 或 添加  ，如数量更新            /app/shipping/cart/addOrUpdate
      */
+    @Describe("加购物车")
     @RequestMapping("/addOrUpdate")
     public R add(@RequestBody VvShoppingCartAddRequest VvShoppingCartAddRequest) {
         VvBuyerEntity vvBuyerEntity = vvBuyerDao.selectVvBuyerById(VvShoppingCartAddRequest.getBuyerId());
@@ -140,6 +143,7 @@ public class AppShoppingCartController {
     /***
      * 列表
      */
+    @Describe("删除购买车中商品")
     @RequestMapping("/delete")
     public R delete(AppShippingCartDeleteRequest appShippingCartDeleteRequest) {
         vvShoppingCartDao.deleteVvShoppingCartByIds(appShippingCartDeleteRequest.getShoppingCartIds());

api-web/api-interface/src/main/java/com/heyu/api/controller/vv/AppUploadOssController.java

@@ -1,6 +1,7 @@
 package com.heyu.api.controller.vv;
 
 
+import com.heyu.api.common.annotation.Describe;
 import com.heyu.api.data.utils.R;
 import com.heyu.api.oss.OssFileUploadService;
 import lombok.extern.slf4j.Slf4j;
@@ -33,8 +34,9 @@ public class AppUploadOssController {
      * http://localhost:8888/app/upload/file  file
      */
     // todo
+    @Describe("app 上传图片")
     @PostMapping("/file")
-    public R uploadFile(HttpServletRequest request, HttpServletResponse response,@RequestParam("files") MultipartFile[] files) {
+    public R uploadFile(HttpServletRequest request, HttpServletResponse response, @RequestParam("files") MultipartFile[] files) {
         List<Map<String, Object>> data = ossFileUploadService.uploadImages(files);
         return R.ok().setData(data);
     }