package com.sptg.estate.biz.service;

import com.baomidou.mybatisplus.plugins.Page;
import com.sptg.common.core.beans.ResultBean;
import com.sptg.estate.api.dto.GuestAuthorizeDto;
import com.sptg.estate.api.entity.GuestAuthorize;

import java.util.List;
import java.util.Map;
/**
 * title: GuestAuthorizeServiceInterface
 * package: com.sptg.estate.biz.security
 * description:访客授权记录 服务层接口
 *
 *
 *
 */
public interface GuestAuthorizeServiceInterface {

    /**
     * 功能描述:访客授权记录列表查询
     * @param guestAuthorizeDto 访客授权记录业务对象（含分页及查询条件）
     * @return  Page<GuestAuthorize>
     *
     *
     */
    Page<GuestAuthorize> showGuestAuthorizeList(GuestAuthorizeDto guestAuthorizeDto);

    /**
     * 功能描述:新增访客授权记录
     * @param guestAuthorize 访客授权记录业务对象
     * @return ResultBean<GuestAuthorize>
     *
     *
     */
    ResultBean<GuestAuthorize> addGuestAuthorize(GuestAuthorize guestAuthorize);

    /**
     * 功能描述:根据Id查访客授权记录
     * @param id 必填
     * @return AccessRecords
     *
     *
     */
    GuestAuthorize findGuestAuthorizeById(Long id);

    /**
     * 功能描述:编辑访客授权记录
     * @param guestAuthorize 访客授权记录业务对象
     * @return ResultBean<Boolean>
     *
     *
     */
    ResultBean<Boolean> updateGuestAuthorize(GuestAuthorize guestAuthorize);

    /**
     * 功能描述:删除访客授权记录
     * @param guestAuthorizeDto 访客授权记录业务对象
     * @return ResultBean<Boolean>
     *
     *
     */
    ResultBean<Boolean> deleteGuestAuthorize(GuestAuthorizeDto guestAuthorizeDto);

    /**
     * 功能描述:更新访客授权记录密码状态
     * @param guestAuthorize 访客授权记录业务对象
     * @return ResultBean<Boolean>
     *
     *
     */
    ResultBean<Boolean> updateGuestAuthorizeEnableType(GuestAuthorize guestAuthorize);

    /**
     * 功能描述:根据机构位置查询访客数量
     * @param guestAuthorizeDto
     * {
     *    orgPosition : 位置信息
     * }
     * @return long
     *
     *
     */
    long getGuestCount(GuestAuthorizeDto guestAuthorizeDto);

    /**
     * 功能描述:按时间分组统计某时间访客人数
     * @param dto
     * {
     *     selectBeginDate 查询开始时间
     *     selectEndDate 查询截止时间
     *     createDate 查询时间
     *     groupType  数据分组类型  0 按时  1按日 2按周  3按月
     *     orgPosition 机构位置
     * }
     * @return List<Map<String, Object>>
     *
     *
     */
    List<Map<String, Object>> guestAuthorizeCountListForGroupType(GuestAuthorizeDto dto);

    /**
     * 功能描述:根据userId查询用户的授权密码
     * @param userIds
     * @return ResultBean<GuestAuthorize>
     *
     *
     */
    ResultBean<GuestAuthorize> getListByUserId(List<Long> userIds);

    /**
     * 根据密码和小区Id获取用户授权信息
     * @param password 开门密码
     * @param xqId 小区Id
     * @return GuestAuthorize
     */
    GuestAuthorize getByPasswordAndXqId(String password,Long xqId);

    /**
     * 功能描述:获取当天小区的访客量
     * @param guestAuthorizeDto{
     *         residentialId：小区Id必填
     * }
     * @return 
     *             
     *                      
     */
    int getGuestAuthorizeCountByDay(GuestAuthorizeDto guestAuthorizeDto);


    /**
     * 功能描述:查询有效的访客密码列表
     * @param guestAuthorizeDto 访客授权记录业务对象（含分页及查询条件）
     * @return  Page<GuestAuthorize>
     *
     *
     */
    Page<GuestAuthorize> showEffectiveGuestAuthorizeList(GuestAuthorizeDto guestAuthorizeDto);

    /**
     * 根据条件查询
     * @param guestAuthorize
     * @return
     */
    GuestAuthorize getGuestAuthorizeByCondition(GuestAuthorize guestAuthorize);
}
