epmet-cloud-lingshan/epmet-user/epmet-user-server/src/main/java/com/epmet/service/CustomerStaffService.java

/**
 * Copyright 2018 人人开源 https://www.renren.io
 * <p>
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * <p>
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * <p>
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

package com.epmet.service;

import com.epmet.commons.mybatis.service.BaseService;
import com.epmet.commons.tools.page.PageData;
import com.epmet.commons.tools.utils.Result;
import com.epmet.dto.*;
import com.epmet.dto.form.*;
import com.epmet.dto.result.*;
import com.epmet.entity.CustomerStaffEntity;

import java.util.List;
import java.util.Map;

/**
 * 政府工作人员表
 *
 * @author generator generator@elink-cn.com
 * @since v1.0.0 2020-04-18
 */
public interface CustomerStaffService extends BaseService<CustomerStaffEntity> {

	/**
	 * 默认分页
	 *
	 * @param params
	 * @return PageData<CustomerStaffDTO>
	 * @author generator
	 * @date 2020-04-18
	 */
	PageData<CustomerStaffDTO> page(Map<String, Object> params);

	/**
	 * 默认查询
	 *
	 * @param params
	 * @return java.util.List<CustomerStaffDTO>
	 * @author generator
	 * @date 2020-04-18
	 */
	List<CustomerStaffDTO> list(Map<String, Object> params);

	/**
	 * 单条查询
	 *
	 * @param id
	 * @return CustomerStaffDTO
	 * @author generator
	 * @date 2020-04-18
	 */
	CustomerStaffDTO get(String id);

	/**
	 * 默认保存
	 *
	 * @param dto
	 * @return void
	 * @author generator
	 * @date 2020-04-18
	 */
	void save(CustomerStaffDTO dto);

	/**
	 * 默认更新
	 *
	 * @param dto
	 * @return void
	 * @author generator
	 * @date 2020-04-18
	 */
	void update(CustomerStaffDTO dto);

	/**
	 * 批量删除
	 *
	 * @param ids
	 * @return void
	 * @author generator
	 * @date 2020-04-18
	 */
	void delete(String[] ids);

	/**
	 * @param mobile 手机号
	 * @return com.epmet.commons.tools.utils.Result
	 * @Author yinzuomei
	 * @Description 根据手机号查询政府端工作人员基本信息，校验用户是否存在
	 * @Date 2020/4/18 14:07
	 **/
	Result<List<CustomerStaffDTO>> getCustsomerStaffByPhone(String mobile);

	/**
	 * @param mobile 手机号
	 * @return com.epmet.commons.tools.utils.Result
	 * @Author yinzuomei
	 * @Description 根据手机号查询政府端工作人员基本信息，校验用户是否存在
	 * @Date 2020/4/18 14:07
	 **/
	Result<List<CustomerStaffDTO>> getCustsomerStaffByAccount(String userAccount);

	/**
	 * @param formDTO
	 * @return com.epmet.commons.tools.utils.Result<com.epmet.dto.CustomerStaffDTO>
	 * @Author yinzuomei
	 * @Description 根据手机号+客户id获取工作人员基本信息
	 * @Date 2020/4/20 14:05
	 **/
	Result<CustomerStaffDTO> getCustomerStaffInfo(CustomerStaffFormDTO formDTO);

	/**
	 * 根据用户ID获取工作人员基本信息
	 *
	 * @param formDTO
	 * @return com.epmet.commons.tools.utils.Result<com.epmet.dto.CustomerStaffDTO>
	 * @author zhaoqifeng
	 * @date 2020/4/22 10:05
	 **/
	Result<CustomerStaffDTO> getCustomerStaffInfoByUserId(CustomerStaffDTO formDTO);

	/**
	 * 根据guidId查询网格下的用户信息
	 * @param customerStaffGridDTOS
	 * @return
	 */
	Result<List<StaffGridListDTO>> selectStaffGridListByUserId(List<UserIdAndPidDTO> customerStaffGridDTOS);

	/**
	 * 组织首页-工作人员列表
	 * @param fromDTO
	 * @return
	 */
	Result<List<StaffInfoResultDTO>> getStaffInfoForHome(StaffsInAgencyFromDTO fromDTO);

	/**
	 * 工作人员列表
	 * @param fromDTO
	 * @return
	 */
	Result<List<StaffInfoResultDTO>> getStaffList(StaffsInAgencyFromDTO fromDTO);

	/**
	 * 人员添加页面初始化
	 *
	 * @param fromDTO 参数
	 * @return Result<StaffInitResultDTO>
	 */
	Result<List<RoleInfoResultDTO>> addStaffInit(StaffInfoFromDTO fromDTO);

	/**
	 * 人员编辑页面初始化
	 *
	 * @param fromDTO 参数
	 * @return Result<StaffInitResultDTO>
	 */
	Result<StaffInitResultDTO> editStaffInit(StaffInfoFromDTO fromDTO);

	/**
	 * 人员添加
	 *
	 * @param fromDTO 参数
	 * @return Result
	 */
	Result<CustomerStaffDTO> addStaff(StaffSubmitFromDTO fromDTO);

	/**
	 * 人员添加
	 *
	 * @param fromDTO 参数
	 * @return Result
	 */
	Result<CustomerStaffDTO> addStaffV3(StaffSubmitV3FromDTO fromDTO);


	/**
	 * 人员编辑
	 *
	 * @param fromDTO 参数
	 * @return Result
	 */
	Result editStaff(StaffSubmitFromDTO fromDTO);

	/**
	 * 人员编辑
	 *
	 * @param fromDTO 参数
	 * @return Result
	 */
	Result editStaffV3(StaffSubmitV3FromDTO fromDTO);

	/**
	 * 人员详情
	 *
	 * @param fromDTO 参数
	 * @return Result<StaffDetailResultDTO>
	 */
	Result<StaffDetailResultDTO> getStaffDetail(StaffInfoFromDTO fromDTO);

	/**
	 * 人员禁用
	 *
	 * @param fromDTO 参数
	 * @return Result
	 */
	Result disabledStaff(StaffInfoFromDTO fromDTO);

	/**
	 * 根据userId查询网格下未被禁用的人员数量
	 * @param userIdDTO
	 * @return
	 */
	Result<GridStaffCountDTO> selectGridStaffCountByUserId(List<UserIdDTO> userIdDTO);

	/**
	 * @param fromDTO
	 * @return
	 * @Author sun
	 * @Description 根据客户Id及userId集合查询用户基本信息
	 */
	Result<List<DepartInStaffListResultDTO>> getDepartmentStaffList(DepartmentInStaffFormDTO fromDTO);

	/**
	 * @Description 通过userId列表查询未被禁用的用户信息
	 * @Param CommonUserIdListFormDTO :: getUserIdList
	 * @return Result<List<CommonStaffInfoResultDTO>>
	 * @Author wangc
	 * @Date 2020.04.24 15:44
	 **/
	Result<List<CommonStaffInfoResultDTO>> getEnableStaffMsgList(CommonUserIdListFormDTO userIdList);

	/**
	 * @param staffIdList
	 * @return
	 * @Author sun
	 * @Description 根据staffId集合查询工作人员基础信息
	 **/
	CustomerStaffListResultDTO getCustomerStaffList(List<String> staffIdList);

	/**
	 * @param staffId
	 * @return
	 * @Author sun
	 * @Description 根据staffId查询工作人员基本信息
	 **/
    CustomerStaffDTO getCustomerStaff(String staffId);

    /**
     * @return void
     * @param staffResetPwFormDTO
     * @author yinzuomei
     * @description 工作端，修改工作人员密码
     * @Date 2020/7/1 10:41
     **/
    void resetStaffPassword(StaffResetPwFormDTO staffResetPwFormDTO);

    /**
     * @Description 得到工组人员的头像、名称、所属机关名称
     * @param userId
     * @return
     * @author wangc
     * @date 2020.07.27 14:45
    **/
	StaffEtAgencyResultDTO getStaffMsg(IssueInitiatorFormDTO userId);

	/**
	 * @param formDTO
	 * @return
	 * @Author sun
	 * @Description 根据客户ID、手机号查询政府端工作人员基本信息，校验用户是否存在
	 **/
	List<CustomerStaffDTO> getCustsomerStaffByIdAndPhone(ThirdCustomerStaffFormDTO formDTO);

	/**
	 * @param formDTO
	 * @return
	 * @Author zhy
	 * @Description 根据客户ID、手机号查询政府端工作人员基本信息，校验用户是否存在
	 **/
	List<CustomerStaffDTO> getCustsomerStaffByIdAndAccount(ThirdCustomerStaffByAccountFormDTO formDTO);

	/**
	 * @Description  查询工作人员的信息
	 * @param formDTO
	 * @author zxc
	 * @date 2020/8/13 1:45 下午
	 */
	List<StaffSinGridResultDTO> getStaffInfoList( UserIdsFormDTO formDTO);

	/**
	 * @Description 查找工作人员的信息 - 对外开放接口
	 * @param staffParam
	 * @return
	 * @author wangc
	 * @date 2020.08.17 10:30
	**/
    ExtStaffInfoResultDTO extStaffInfo(CommonStaffIdFormDTO staffParam);

	/**
	 * 修改根管理员信息
	 * @author zhaoqifeng
	 * @date 2020/8/19 14:11
	 * @param formDTO
	 * @return com.epmet.dto.CustomerStaffDTO
	 */
	void updateRootManage(UpdateRootManageFormDTO formDTO);

    /**
     * 查询登陆用户客户列表（工作端）
     *   根据手机号查询customer_staff表数据，在根据查询到的数据的userId判断是不是根管理员，最后将同一手机号对应的客户列表且该手机都是根管理员的客户列表返给前端
     *
     * @param formDTO
     * @return com.epmet.commons.tools.utils.Result<java.util.List<com.epmet.dto.result.CustomerListResultDTO>>
     * @Author zhangyong
     * @Date 10:03 2020-08-25
     **/
	Result<List<CustomerListResultDTO>> selectCustomerList(CustomerListFormDTO formDTO);

	/**
	 * 获取pc工作端登陆用户信息
     *   根据token中userId，去查询登陆用户基本信息
     *
	 * @param userId
	 * @return com.epmet.commons.tools.utils.Result<com.epmet.dto.result.StaffBasicInfoResultDTO>
	 * @Author zhangyong
	 * @Date 11:10 2020-08-25
	 **/
    Result<StaffBasicInfoResultDTO> selectStaffBasicInfo(String userId,String customerId);

	/**
	 * @param  formDTO
	 * @return
	 * @Author sun
	 * @Description PC工作端登陆-根据客户Id和手机号查询登陆用户信息
	 **/
	GovWebOperLoginResultDTO getStaffIdAndPwd(GovWebOperLoginFormDTO formDTO);

	/**
	 * 根据staffId查询用户基本信息
	 * @author sun
	 * @return
	 */
	BasicInfoResultDTO getStaffBasicInfo(StaffBasicInfoFromDTO fromDTO);

	/**
	 * @Description 根据姓名查询工作人员
	 * @return
	 * @author wxz
	 * @date 2021.06.08 10:52
	*/
	List<CustomerStaffDTO> list(String customerId, String realName, String mobile, List<String> ids);

	/**
	 * 【通讯录】工作人员解禁
	 * @author sun
	 */
    void enableStaff(EnableStaffFormDTO fromDTO);

	/**
	 * @Author sun
	 * @Description 根据工作人员姓名批量查询基础信息数据
	 **/
    List<CustomerStaffDTO> getByRealNames(GetByRealNamesFormDTO formDTO);

	/**
	 * @Author sun
	 * @Description 【事件】网格员服务电话
	 **/
    List<GridMobileListResultDTO> gridMobileList(String gridId, String userId);
}