package com.ruoyi.system.service;

import java.util.List;
import com.ruoyi.system.domain.CjFillTask;

/**
 * 填表任务Service接口
 *
 * @author ruoyi
 * @date 2026-09-09
 */
public interface ICjFillTaskService
{
    /**
     * 查询填表任务
     *
     * @param taskId 填表任务主键
     * @return 填表任务
     */
    public CjFillTask selectCjFillTaskByTaskId(Long taskId);

    /**
     * 查询填表任务列表
     *
     * @param cjFillTask 填表任务
     * @return 填表任务集合
     */
    public List<CjFillTask> selectCjFillTaskList(CjFillTask cjFillTask);

    /**
     * 新增填表任务（草稿；自动做表单快照与范围人数统计）
     *
     * @param cjFillTask 填表任务
     * @return 结果
     */
    public int insertCjFillTask(CjFillTask cjFillTask);

    /**
     * 修改填表任务（仅草稿状态可改；重新刷新快照与范围人数）
     *
     * @param cjFillTask 填表任务
     * @return 结果
     */
    public int updateCjFillTask(CjFillTask cjFillTask);

    /**
     * 批量删除填表任务（仅草稿状态可删）
     *
     * @param taskIds 需要删除的填表任务主键
     * @return 结果
     */
    public int deleteCjFillTaskByTaskIds(Long[] taskIds);

    /**
     * 发布填表任务（草稿→填报中）
     *
     * @param taskId 任务主键
     * @return 结果
     */
    public int publish(Long taskId);

    /**
     * 取消发布（填报中→草稿）
     *
     * @param taskId 任务主键
     * @return 结果
     */
    public int unpublish(Long taskId);

    /**
     * 截止（填报中/草稿→已截止）
     *
     * @param taskId 任务主键
     * @return 结果
     */
    public int close(Long taskId);

    /**
     * 归档（已截止→已归档）
     *
     * @param taskId 任务主键
     * @return 结果
     */
    public int archive(Long taskId);
}