Merge branch 'west_bigscreen_dev' into 'master'

罗元桥

2021-12-14 ecde7a30a43e3d45be2f0f9e271d0abf02c7d58e

 springcloud_k8s_panzhihuazhihuishequ/service_grid/src/main/java/com/panzhihua/service_grid/service/EventVisitingTasksService.java

@@ -1,33 +1,32 @@
package com.panzhihua.service_grid.service;

import java.util.List;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.panzhihua.common.model.dtos.grid.EventVisitingTasksAddDTO;
import com.panzhihua.common.model.dtos.grid.EventVisitingTasksDeleteDTO;
import com.panzhihua.common.model.dtos.grid.EventVisitingTasksEditDTO;
import com.panzhihua.common.model.dtos.grid.PageEventVisitingTasksDTO;
import com.panzhihua.common.model.dtos.IdDTO;
import com.panzhihua.common.model.dtos.grid.*;
import com.panzhihua.common.model.dtos.visit.EventVisitCompleteDTO;
import com.panzhihua.common.model.query.visit.EventTasksQuery;
import com.panzhihua.common.model.query.visit.EventVisitListQuery;
import com.panzhihua.common.model.vos.R;
import com.panzhihua.common.model.dtos.visit.EventVisitCompleteDTO;
import com.panzhihua.common.model.vos.visit.EventVisitingTasksDetailsVO;
import com.panzhihua.common.model.vos.visit.EventVisitingTasksVO;
import com.panzhihua.service_grid.model.dos.EventVisitingTasksDO;

import java.util.List;

/**
 * 重点人群走访记录 service
 *
 * @author cedoo email:cedoo(a)qq.com
 * @version 1.0
 * @since 1.0
 * @date 2021-05-26
 * */
 * @since 1.0
 */
public interface EventVisitingTasksService extends IService<EventVisitingTasksDO> {

    /**
     * 新增重点人群走访记录
     *
     * @param eventVisitingTasksAddDTO
     * @return 新增结果
     */
@@ -35,6 +34,7 @@

    /**
     * 修改重点人群走访记录
     *
     * @param eventVisitingTasksEditDTO
     * @return 维护结果
     */
@@ -42,6 +42,7 @@

    /**
     * 分页查找重点人群走访记录
     *
     * @param pageEventVisitingTasksDTO
     * @return 维护结果
     */
@@ -49,6 +50,7 @@

    /**
     * 删除重点人群走访记录
     *
     * @param EventVisitingTasksDeleteDTO
     * @return 平台用户信息
     */
@@ -56,14 +58,16 @@

    /**
     * 查询重点人群走访记录详细信息
     * @param id 重点人群走访记录 id
     *
     * @param id
     *            重点人群走访记录 id
     * @return 查找结果
     */
    R<EventVisitingTasksDetailsVO> eventVisitingTasksDetails(Long id);


    /**
     * 后台统计走访任务
     *
     * @param communityId
     * @return
     */
@@ -71,6 +75,7 @@

    /**
     * app走访任务
     * 
     * @param query
     * @return
     */
@@ -78,6 +83,7 @@

    /**
     * 走访任务列表
     *
     * @param query
     * @return
     */
@@ -85,14 +91,16 @@

    /**
     * 删除走访任务
     * @param ids
     *
     * @param idDTO
     * @param communityId
     * @return
     */
    R delete(String ids, Long communityId);
    R delete(IdDTO idDTO, Long communityId);

    /**
     * 需走访人员列表
     *
     * @param query
     * @return
     */
@@ -100,6 +108,7 @@

    /**
     * app查询走访记录
     *
     * @param query
     * @return
     */
@@ -107,47 +116,79 @@

    /**
     * app 走访详情
     *
     * @param id
     * @return
     */
    R detail(Long id) throws Exception;
    R detail(Long id);

    /**
     * 新增
     * @param ids
     *
     * @param idDTO
     * @param communityId
     * @param userId
     * @return
     */
    R add(String ids, Long communityId, Long userId) throws Exception;
    R add(IdDTO idDTO, Long communityId, Long userId) throws Exception;

    List<EventVisitingTasksVO> exportTaskList(EventTasksQuery query) throws Exception;

    /**
     * 撤销
     * @param id
     *
     * @param idDTO
     * @return
     */
    R cancel(Long id);
    R cancel(IdDTO idDTO);

    /**
     * 恢复
     * @param id
     *
     * @param idDTO
     * @return
     */
    R reset(Long id);
    R reset(IdDTO idDTO);

    /**
     * 开始
     *
     * @param id
     * @return
     */
    R start(Long id,Long userId);
    R start(Long id, Long userId);

    /**
     * 完成
     *
     * @param taskCompleteDTO
     * @return
     */
    R complete(EventVisitCompleteDTO taskCompleteDTO);

    /**
     * description 获取所有未上传到浪潮平台的事件列表
     *
     * @return String 事件列表
     * @author manailin
     * @date 2021/6/10 17:00
     */
    List<LcEventVisitingTasksListDTO> getUnUploadVisitingTask();

    /**
     * description 更新上传是否成功标识
     *
     * @param id
     *            事件主键ID
     * @return Boolean 上传是否成功
     * @author manailin
     * @date 2021/6/10 17:00
     */
    Boolean updateLcUploadFlagVisitingTask(Long id);

    /**
     * 定时任务-给上月已走访的人员创建定时任务
     * @return  执行结果
     */
    R timedTaskVisitingJobHandler();
}