package org.dromara.project.service;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;
import org.dromara.project.domain.BusAttendance;
import org.dromara.project.domain.dto.attendance.BusAttendanceMonthByUserIdReq;
import org.dromara.project.domain.dto.attendance.BusAttendanceQueryReq;
import org.dromara.project.domain.dto.attendance.BusAttendanceQueryTwoWeekReq;
import org.dromara.project.domain.vo.attendance.BusAttendanceClockDateForTwoWeekVo;
import org.dromara.project.domain.vo.attendance.BusAttendanceMonthByUserIdVo;
import org.dromara.project.domain.vo.attendance.BusAttendanceVo;

import java.util.List;

/**
 * 考勤Service接口
 *
 * @author lcj
 * @date 2025-04-07
 */
public interface IBusAttendanceService extends IService<BusAttendance> {

    /**
     * 查询考勤
     *
     * @param id 主键
     * @return 考勤
     */
    BusAttendanceVo queryById(Long id);

    /**
     * 分页查询考勤列表
     *
     * @param req       查询条件
     * @param pageQuery 分页参数
     * @return 考勤分页列表
     */
    TableDataInfo<BusAttendanceVo> queryPageList(BusAttendanceQueryReq req, PageQuery pageQuery);

    /**
     * 查询两周内的考勤列表
     *
     * @param req 查询条件
     * @return 考勤列表
     */
    List<BusAttendanceClockDateForTwoWeekVo> listClockDateForTwoWeek(BusAttendanceQueryTwoWeekReq req);

    /**
     * 查询用户每月考勤列表
     *
     * @param req 查询条件
     * @return 考勤列表
     */
    List<BusAttendanceMonthByUserIdVo> listAttendanceMonthListByUserId(BusAttendanceMonthByUserIdReq req);

    /**
     * 查询符合条件的考勤列表
     *
     * @param req 查询条件
     * @return 考勤列表
     */
    List<BusAttendanceVo> queryList(BusAttendanceQueryReq req);

    /**
     * 根据项目id查询出勤人列表
     *
     * @param projectId 项目id
     * @return 出勤人列表
     */
    List<Long> listAttendancePeopleByProjectId(Long projectId);

    /**
     * 获取考勤视图对象
     *
     * @param attendance 考勤对象
     * @return 考勤视图对象
     */
    BusAttendanceVo getVo(BusAttendance attendance);

    /**
     * 获取考勤查询条件封装
     *
     * @param req 查询条件
     * @return 查询条件封装
     */
    LambdaQueryWrapper<BusAttendance> buildQueryWrapper(BusAttendanceQueryReq req);

    /**
     * 获取考勤分页对象视图
     *
     * @param attendancePage 考勤分页对象
     * @return 考勤分页对象视图
     */
    Page<BusAttendanceVo> getVoPage(Page<BusAttendance> attendancePage);

}
