package com.ygtx.worklog.mapper;

import java.util.List;
import com.ygtx.worklog.domain.WeeklyReport;
import org.apache.ibatis.annotations.Param;

/**
 * 周报Mapper接口
 *
 * @author ruoyi
 * @date 2025-10-21
 */
public interface WeeklyReportMapper
{
    /**
     * 查询周报
     *
     * @param id 周报主键
     * @return 周报
     */
    public WeeklyReport selectWeeklyReportById(Long id);

    /**
     * 查询周报列表
     *
     * @param weeklyReport 周报
     * @return 周报集合
     */
    public List<WeeklyReport> selectWeeklyReportList(WeeklyReport weeklyReport);

    /**
     * 新增周报
     *
     * @param weeklyReport 周报
     * @return 结果
     */
    public int insertWeeklyReport(WeeklyReport weeklyReport);

    /**
     * 修改周报
     *
     * @param weeklyReport 周报
     * @return 结果
     */
    public int updateWeeklyReport(WeeklyReport weeklyReport);

    /**
     * 删除周报
     *
     * @param id 周报主键
     * @return 结果
     */
    public int deleteWeeklyReportById(Long id);

    /**
     * 批量删除周报
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteWeeklyReportByIds(Long[] ids);

    /**
     * 查询用户指定周的周报
     *
     * @param userId 用户ID
     * @param year 年份
     * @param weekNum 周数
     * @return 周报
     */
    public WeeklyReport selectWeeklyReportByUserAndWeek(@Param("userId") Long userId,
                                                          @Param("year") Integer year,
                                                          @Param("weekNum") Integer weekNum);

    /**
     * 查询授权日报列表（根据授权配置）
     *
     * @param authUserId 授权用户ID
     * @param weeklyReport 查询条件
     * @return 周报集合
     */
    public List<WeeklyReport> selectAuthWeeklyReportList(@Param("authUserId") Long authUserId,
                                                           @Param("query") WeeklyReport weeklyReport);
}
