feat(REQ-2106): 注释补充

banner/banner-api/src/main/java/cn/axzo/nanopart/api/MaterialApi.java

@@ -58,7 +58,7 @@ public interface MaterialApi {
      * 更新banner状态
      *
      * @param req {@link UpdateStatusReq}
-     * @return void
+     * @return 无
      */
     @PostMapping("/api/material/updateStatus")
     ApiResult<Void> updateStatus(@RequestBody @Valid UpdateStatusReq req);
@@ -76,7 +76,7 @@ public interface MaterialApi {
      * 根据广告位编码（bannerCode）查询素材
      * <p>
      * 1. 通过广告位code获取该广告位下的所有素材（默认查询上架状态且在有效期范围内的素材）
-     * 2. 根据广告位投放人群进行过滤
+     * 2. 根据广告位投放人群进行过滤（对于cms/cmp需要根据当前登录人登录企业情况进行过滤）
      * 3. 根据广告位投放规则频次进行过滤
      * 4. 将最终的素材根据优先级（priority）升序，创建时间（createAt）降序排序
      * </p>

banner/banner-server/src/main/java/cn/axzo/nanopart/server/controller/MaterialController.java

@@ -67,6 +67,18 @@ public class MaterialController implements MaterialApi {
         return ApiResult.ok(materialService.detail(req));
     }
 
+    /**
+     * 根据广告位编码（bannerCode）查询素材
+     * <p>
+     * 1. 通过广告位code获取该广告位下的所有素材（默认查询上架状态且在有效期范围内的素材）
+     * 2. 根据广告位投放人群进行过滤（对于cms/cmp需要根据当前登录人登录企业情况进行过滤）
+     * 3. 根据广告位投放规则频次进行过滤
+     * 4. 将最终的素材根据优先级（priority）升序，创建时间（createAt）降序排序
+     * </p>
+     *
+     * @param req {@link  ListMaterialByBannerCodeReq}
+     * @return 根据优先级（priority）升序，创建时间（createAt）降序排序后的列表
+     */
     @Override
     public ApiResult<List<MaterialResp>> listMaterialByBannerCode(ListMaterialByBannerCodeReq req) {
         String traceId = request.getHeader(NanopartConstant.CONTEXT_TRACE_ID);