提交 添加 service 注释

liquidnet-bus-service/liquidnet-service-kylin/liquidnet-service-kylin-api/src/main/java/com/liquidnet/service/kylin/service/admin/IKylinPerformancesAdminService.java

@@ -22,23 +22,61 @@ import java.util.List;
  */
 public interface IKylinPerformancesAdminService extends IService<KylinPerformances> {
 
+    /**
+     * 获取演出详情
+     * @param performancesId 演出id
+     * @return PerformanceMisVo
+     */
     PerformanceMisVo performanceDetails(String performancesId);
 
-    PerformanceMisVo performanceCreateDetails(String performancesId);
-
-    PerformanceMisVo performanceUpdateDetails(String performancesId);
-
+    /**
+     * 演出审核
+     * @param performancesId 演出id
+     * @param status 审核状态 3通过 4拒绝
+     * @param rejectTxt 拒绝理由 如果 status == 4 必填
+     * @return boolean
+     */
     boolean performanceAudit(String performancesId,int status ,String rejectTxt);
 
+    /**
+     * 获取 演出列表 (全量)
+     * @param performanceAdminListParam 列表搜索参数
+     * @return 分页 sql 数据
+     */
     PageInfo<PerformanceAdminListDao> getList(PerformanceAdminListParam performanceAdminListParam);
 
+    /**
+     * 根据巡演id 查询演出列表 简易
+     * @param roadShowId 巡演id
+     * @return 20个 sql 数据
+     */
     List<PerformanceTitleDao> getListByRoadShowId(String roadShowId);
 
+    /**
+     * 根据演出状态 查询演出列表 简易
+     * @param status 演出状态
+     * @return 20个 sql  数据
+     */
     List<PerformanceTitleDao> getListByStatus(String status);
 
+    /**
+     * 修改演出的巡演关联
+     * @param performancesId 演出id
+     * @param roadShowId 巡演id
+     * @return
+     */
     boolean changeRoadShowId(String performancesId,String roadShowId);
 
+    /**
+     * 设置 演出推荐 关联
+     * @param performancesId 相关参数
+     * @return
+     */
     boolean setRecommend(List<PerformanceRecommendAdminParam> performancesId);
 
+    /**
+     * 查询 推荐演出列表
+     * @return 分页 sql 数据
+     */
     PageInfo<PerformanceRecommendAdminDao> listRecommend();
 }

liquidnet-bus-service/liquidnet-service-kylin/liquidnet-service-kylin-api/src/main/java/com/liquidnet/service/kylin/service/admin/IKylinRoadShowsAdminService.java

@@ -18,14 +18,42 @@ import com.liquidnet.service.kylin.entity.KylinRoadShows;
  */
 public interface IKylinRoadShowsAdminService extends IService<KylinRoadShows> {
 
-    String  createRoadShow(CreateRoadShowParam createRoadShowParam);
-
+    /**
+     * 创建巡演
+     * @param createRoadShowParam 创建巡演参数
+     * @return 巡演id
+     */
+    String createRoadShow(CreateRoadShowParam createRoadShowParam);
+
+    /**
+     * 修改巡演
+     * @param createRoadShowParam 修改巡演参数
+     * @return 巡演id
+     */
     boolean updateRoadShow(CreateRoadShowParam createRoadShowParam);
 
+    /**
+     * 删除巡演 (修改巡演上下线关系)
+     * @param roadShowId 巡演id
+     * @param status 状态 0停用 1启用
+     * @return boolean
+     */
     boolean deleteRoadShow(String roadShowId, int status);
 
+    /**
+     * 巡演详情
+     * @param roadShowId 巡演id
+     * @return 巡演数据
+     */
     RoadShowAdminVo detailsRoadShow(String roadShowId);
 
+    /**
+     * 巡演列表
+     * @param title 巡演名称
+     * @param page 页数
+     * @param size 数量
+     * @return 分页 sql 数据
+     */
     PageInfo<RoadShowAdminListDao> listRoadShow(String title, int page, int size);
 
 

liquidnet-bus-service/liquidnet-service-kylin/liquidnet-service-kylin-api/src/main/java/com/liquidnet/service/kylin/service/partner/IKylinPerformancesPartnerService.java

@@ -20,28 +20,28 @@ public interface IKylinPerformancesPartnerService extends IService<KylinPerforma
 
     /**
      * 演出第一步
-     * @param step1Param
-     * @return
+     * @param step1Param 相关参数
+     * @return 演出id
      */
     String step1(PerformanceStep1Param step1Param);
     /**
      * 创建演出第一步
-     * @param step1Param
-     * @return
+     * @param step1Param 相关参数
+     * @return 演出id
      */
     String createStep1(PerformanceStep1Param step1Param);
 
     /**
      * 修改演出第一步
-     * @param step1Param
-     * @return
+     * @param step1Param 相关参数
+     * @return 演出id
      */
     String updateStep1(PerformanceStep1Param step1Param);
 
     /**
      * 获取演出第一步数据
-     * @param performancesId
-     * @return
+     * @param performancesId 演出id
+     * @return 演出对象
      */
     PerformancePartnerVo getStep1(String performancesId);
 
@@ -62,36 +62,61 @@ public interface IKylinPerformancesPartnerService extends IService<KylinPerforma
 
     /**
      * 演出第二步
-     * @param step2Param
-     * @return
+     * @param step2Param 相关参数
+     * @return boolean
      */
     boolean step2(PerformanceStep2Param step2Param);
 
     /**
      * 演出第二步创建
-     * @param step2Param
-     * @return
+     * @param step2Param 相关参数
+     * @return boolean
      */
     boolean createStep2(PerformanceStep2Param step2Param);
 
     /**
      * 演出第二步修改
-     * @param step2Param
-     * @return
+     * @param step2Param 相关参数
+     * @return boolean
      */
     boolean updateStep2(PerformanceStep2Param step2Param);
 
+    /**
+     * 获取演出第二步数据
+     * @param performancesId 演出id
+     * @return 演出 第二步 数据
+     */
     PerformanceStep2Param getStep2(String performancesId);
 
 //    PerformanceStep2Param getCreateStep2(String performancesId);
 //
 //    PerformanceStep2Param getUpdateStep2(String performancesId);
 
+    /**
+     * 演出上线
+     * @param performancesId 演出id
+     * @return boolean
+     */
     boolean onLinePerformance(String performancesId);
 
+    /**
+     * 演出下线
+     * @param performancesId 演出id
+     * @return boolean
+     */
     boolean outLinePerformance(String performancesId);
 
+    /**
+     * 复制演出 (只有巡演类型)
+     * @param performancesId 演出id
+     * @return 演出id
+     */
     String copyPerformance(String performancesId);
 
+    /**
+     * 演出列表
+     * @param performancePartnerListParam 相关参数
+     * @return 分页 msql 数据
+     */
     PageInfo<PerformancePartnerListDao> getList(PerformancePartnerListParam performancePartnerListParam);
 }

liquidnet-bus-service/liquidnet-service-kylin/liquidnet-service-kylin-api/src/main/java/com/liquidnet/service/kylin/service/partner/IKylinTicketTimesPartnerService.java

@@ -20,35 +20,50 @@ public interface IKylinTicketTimesPartnerService extends IService<KylinTicketTim
 
     /**
      * 创建场次汇总
-     * @param createTicketTimesParam
-     * @return
+     * @param createTicketTimesParam 相关参数
+     * @return vo
      */
     TicketTimesPartnerVo createTimesSummary(CreateTicketTimesParam createTicketTimesParam);
 
     /**
      * 未通过审核创建场次
-     * @param createTicketTimesParam
-     * @return
+     * @param createTicketTimesParam 相关参数
+     * @return vo
      */
     TicketTimesPartnerVo createTimes(CreateTicketTimesParam createTicketTimesParam);
 
     /**
      * 通过审核后创建场次
-     * @param createTicketTimesParam
-     * @return
+     * @param createTicketTimesParam 相关参数
+     * @return 相关参数
      */
     TicketTimesPartnerVo addNewTimes(CreateTicketTimesParam createTicketTimesParam);
 
     /**
      * 删除 场次(只有未审核通过可删除)
-     * @param ticketTimesId
-     * @return
+     * @param ticketTimesId 场次id
+     * @return boolean
      */
     Boolean deleteTimes(String ticketTimesId);
 
+    /**
+     * 修改场次信息
+     * @param createTicketTimesParam 相关参数
+     * @return vo
+     */
     TicketTimesPartnerVo changeTimes(CreateTicketTimesParam createTicketTimesParam);
 
+    /**
+     * 根据演出id 获取全部场次数据
+     * @param performancesId 演出id
+     * @return list<vo>
+     */
     List<TicketTimesPartnerVo> getTimesMongoList(String performancesId);
 
+    /**
+     * 根据场次id 获取场次信息
+     * @param timesId 场次id
+     * @return vo
+     */
     TicketTimesPartnerVo getTimesMongo(String timesId);
 }

liquidnet-bus-service/liquidnet-service-kylin/liquidnet-service-kylin-api/src/main/java/com/liquidnet/service/kylin/service/partner/IKylinTicketsPartnerService.java

@@ -19,39 +19,64 @@ public interface IKylinTicketsPartnerService extends IService<KylinTickets> {
 
     /**
      * 创建票汇总
-     * @param ticketCreateParam
-     * @return
+     * @param ticketCreateParam 相关参数
+     * @return vo
      */
     TicketPartnerVo createTicketSummary(TicketCreateParam ticketCreateParam);
 
     /**
      * 未通过审核创建票
-     * @param ticketCreateParam
-     * @return
+     * @param ticketCreateParam 相关参数
+     * @return vo
      */
     TicketPartnerVo createTicket(TicketCreateParam ticketCreateParam);
 
     /**
-     * 通过审核后创建场次
-     * @param ticketCreateParam
-     * @return
+     * 通过审核后创建票
+     * @param ticketCreateParam 相关参数
+     * @return vo
      */
     TicketPartnerVo addNewTicket(TicketCreateParam ticketCreateParam);
 
+    /**
+     * 修改票
+     * @param ticketCreateParam 相关参数
+     * @return vo
+     */
     TicketPartnerVo updateTicket(TicketCreateParam ticketCreateParam);
 
     /**
      * 删除 票(只有未审核通过可删除)
-     * @param ticketsId
-     * @return
+     * @param ticketsId 票id
+     * @return boolean
      */
     boolean deleteTicket(String ticketsId);
 
+    /**
+     * 复制票
+     * @param ticketsId 票id
+     * @return vo
+     */
     TicketPartnerVo copyTicket(String ticketsId);
 
+    /**
+     * 整个场次票 提交 审核
+     * @param timesId 场次id
+     * @return boolean
+     */
     boolean submitTicketByTimes(String timesId);
 
+    /**
+     * 从mongo 获取 当前场次所有 票
+     * @param timesId 场次id
+     * @return list<vo>
+     */
     List<TicketPartnerVo> getTicketMongoList(String timesId);
 
+    /**
+     * 从mongo 获取 当前票
+     * @param ticketsId 票id
+     * @return vo
+     */
     TicketPartnerVo getTicketsMongo(String ticketsId);
 }

liquidnet-bus-service/liquidnet-service-kylin/liquidnet-service-kylin-do/src/main/resources/com.liquidnet.service.kylin.mapper/KylinPerformancesMapper.xml

@@ -198,9 +198,9 @@
                  LEFT JOIN kylin_performance_relations AS pr ON pr.performance_id = p.performances_id
         WHERE (ps.status = 3 or ps.status = 6 or ps.status = 7)
           AND pr.road_show_id = ${roadShowId}
-
+        LIMIT 20
     </select>
-    <!-- Mis 根据巡演查询演出列表 -->
+    <!-- Mis 根据状态查询演出列表 -->
     <select id="misTitleByStatusList" parameterType="java.lang.String" resultMap="performanceTitleDaoResult">
         SELECT performances_id,
                title
@@ -208,6 +208,7 @@
                  LEFT JOIN kylin_performance_status AS ps ON ps.performance_id = p.performances_id
                  LEFT JOIN kylin_performance_relations AS pr ON pr.performance_id = p.performances_id
         WHERE ps.status = ${roadShowId}
+        LIMIT 20
     </select>
     <!-- Mis演出推荐列表 -->
     <select id="reCommendPerformanceList" resultMap="PerformanceRecommendAdminDaoResult">

liquidnet-bus-service/liquidnet-service-kylin/liquidnet-service-kylin-impl/src/main/java/com/liquidnet/service/kylin/service/impl/admin/KylinPerformancesAdminServiceImpl.java

@@ -96,29 +96,12 @@ public class KylinPerformancesAdminServiceImpl extends ServiceImpl<KylinPerforma
 
     @Override
     public PerformanceMisVo performanceDetails(String performancesId) {
-        PerformanceMisVo createMisVo = performanceUpdateDetails(performancesId);
-        if (createMisVo == null) {
-            createMisVo = performanceCreateDetails(performancesId);
-        }
         log.info(" PERFORMANCE  mis演出详情");
-        return createMisVo;
-    }
-
-    @Override
-    public PerformanceMisVo performanceCreateDetails(String performancesId) {
-        return mongoTemplate.findOne(
-                Query.query(Criteria.where("performancesId").is(performancesId)),
-                PerformanceMisVo.class,
-                PerformanceMisVo.class.getSimpleName()
-        );
-    }
-
-    @Override
-    public PerformanceMisVo performanceUpdateDetails(String performancesId) {
-        return mongoTemplate.findOne(
+        PerformanceMisVo createMisVo = mongoTemplate.findOne(
                 Query.query(Criteria.where("performancesId").is(performancesId)),
                 PerformanceMisVo.class,
                 PerformanceMisVo.class.getSimpleName());
+        return createMisVo;
     }
 
     @Override