mitao
2025-05-20 179c4d64313c9b7572778da4aaaf6c6584fe457d
springcloud_k8s_panzhihuazhihuishequ/service_api/src/main/java/com/panzhihua/serviceapi/biz/LcApiService.java
@@ -1,27 +1,28 @@
package com.panzhihua.serviceapi.biz;
import com.panzhihua.common.model.dtos.api.EventFile;
import com.panzhihua.common.model.dtos.api.EventInfo;
import com.panzhihua.common.model.vos.R;
import com.panzhihua.serviceapi.model.dto.LcGridData;
import java.util.List;
import com.panzhihua.common.api.LcReturnObject;
import com.panzhihua.common.model.dtos.api.EventFile;
import com.panzhihua.common.model.dtos.api.EventInfo;
import com.panzhihua.common.model.dtos.grid.LcEventVisitingTasksListDTO;
import com.panzhihua.common.model.vos.R;
import com.panzhihua.serviceapi.model.dto.*;
/**
 * program 攀枝花智慧社区项目
 * description 浪潮综治市平台网格管理API
 * program 攀枝花智慧社区项目 description 浪潮综治市平台网格管理API
 *
 * @author manailin
 * Date 2021-01-22 15:30
 * @author manailin Date 2021-01-22 15:30
 **/
public interface LcApiService {
    /**
     * description 获取token,并将token存入到redis,设置失效时间是12小时
     * 超过12个小时,重新获取token存入到redis数据库
     * description 获取token,并将token存入到redis,设置失效时间是12小时 超过12个小时,重新获取token存入到redis数据库
     *
     * @param name     账号
     * @param password 密码
     * @param name
     *            账号
     * @param password
     *            密码
     * @return String token
     * @author manailin
     * @date 2021/6/10 17:00
@@ -40,7 +41,8 @@
    /**
     * description 提交事件登记
     *
     * @param eventInfo 事件信息
     * @param eventInfo
     *            事件信息
     * @return String 上传成功或失败信息
     * @author manailin
     * @date 2021/6/10 17:00
@@ -50,17 +52,19 @@
    /**
     * description 提交事件登记关联的文件或者图片信息
     *
     * @param eventFile 事件信息
     * @param eventFile
     *            事件信息
     * @return String 上传成功或失败信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    R submitEventRelationFile(EventFile eventFile);
    R submitEventOrVisitRecordRelationFile(EventFile eventFile);
    /**
     * description 获取指定事件信息
     *
     * @param eventId 事件ID
     * @param eventId
     *            事件ID
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
@@ -70,22 +74,38 @@
    /**
     * description 获取指定区域网格列表
     *
     * @param areaId 区域ID
     * @param areaId
     *            区域ID
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    List<LcGridData> getGridListByAreaId(String areaId);
    List<LcGridData> getGridTreeByAreaId(String areaId);
    /**
     * description 获取指定区域网格列表,直接返回网格列表
     *
     * @param areaId
     *            区域ID
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    List<LcGridData> getGridDataListByAreaId(String areaId);
    /**
     * description 获取所有或者根据姓名和工号查询,分页
     *
     * @param areaId 区域ID
     * @param areaId
     *            区域ID
     * @param param
     *            姓名或者工号
     * @return String 网格员列表
     * @author manailin
     * @date 2021/6/10 17:00
     */
    String getGridMemberListByAreaIdOrName(String areaId);
    List<GridMemberPageListDTO> getGridMemberListByAreaIdOrName(String areaId, String param, Long pageNum,
        Long pageSize);
    /**
     * description 提交事件登记关联的文件或者图片信息
@@ -95,4 +115,126 @@
     */
    void automationUploadEventAndFile();
    /**
     * description 流动人口 走访详情
     *
     * @param recordId
     *            流动人口走访任务ID
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    String getFlowPersonVisitRecordDetailById(String recordId);
    /**
     * description 流动人口 走访记录列表
     *
     * @param personVisitRecordQueryDTO
     *            入参参数
     * @param loginUserId
     *            当前登陆用户ID
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    String getFlowPersonVisitRecordPage(LcKeyPersonVisitRecordQueryDTO personVisitRecordQueryDTO, Long loginUserId);
    /**
     * description 上传流动人口走访记录
     *
     * @param lcFlowPersonVisitRecordDTO
     *            入参参数
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    String uploadFlowPersonVisitRecord(LcFlowPersonVisitRecordDTO lcFlowPersonVisitRecordDTO);
    /**
     * description 请求上传流动人口走访记录导浪潮市平台服务器
     *
     * @param lcEventVisitingTasksListDTO
     *            走访事件对象
     * @param lcGrid
     *            浪潮对应的网格ID
     * @param lcGridUserId
     *            浪潮网格员对应的用户ID
     * @param populationDetail
     *            实有人口基础信息
     * @param gridName
     *            网格名称
     * @param data
     *            精度维度数组
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    LcReturnObject requestLcFlowPersonVisitRecord(LcEventVisitingTasksListDTO lcEventVisitingTasksListDTO,
        String lcGrid, String lcGridUserId, Object populationDetail, String gridName, String[] data);
    /**
     * description 请求上传重点人口走访记录导浪潮市平台服务器
     *
     * @param lcEventVisitingTasksListDTO
     *            走访事件对象
     * @param lcGrid
     *            浪潮对应的网格ID
     * @param lcGridUserId
     *            浪潮网格员对应的用户ID
     * @param populationDetail
     *            实有人口基础信息
     * @param gridName
     *            网格名称
     * @param data
     *            精度维度数组
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    LcReturnObject requestLcKeyPersonVisitRecord(LcEventVisitingTasksListDTO lcEventVisitingTasksListDTO, String lcGrid,
        String lcGridUserId, Object populationDetail, String gridName, String[] data);
    /**
     * description 上传重点人口走访记录
     *
     * @param lcKeyPersonVisitRecordDTO
     *            入参参数
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    String uploadKeyPersonVisitRecord(LcKeyPersonVisitRecordDTO lcKeyPersonVisitRecordDTO);
    /**
     * description 重点人口 走访详情
     *
     * @param recordId
     *            流动人口走访任务ID
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    String getKeyPersonVisitRecordDetailById(String recordId);
    /**
     * description 重点人口 走访记录列表
     *
     * @param personVisitRecordQueryDTO
     *            入参参数
     * @param loginUserId
     *            当前登陆用户ID
     * @return String 事件信息
     * @author manailin
     * @date 2021/6/10 17:00
     */
    String getKeyPersonVisitRecordPage(LcKeyPersonVisitRecordQueryDTO personVisitRecordQueryDTO, Long loginUserId);
    /**
     * description 自动上传重点人员走访记录
     *
     * @author manailin
     * @date 2021/6/10 17:00
     */
    void automationUploadVisitRecord();
}