epmet-cloud-rizhao0920/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 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 editStaff(StaffSubmitFromDTO 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);
}