package jnpf.tmsService;

import jnpf.tmsEntity.task.TmsFromPlanResult;
import jnpf.tmsEntity.task.TmsTaskForm;
import jnpf.tmsEntity.task.TmsTaskQuery;

import java.util.List;

/**
 * 培训任务：草稿维护、发布落库、计划审批生成草稿。
 *
 * @see jnpf.tmsService.impl.TmsTaskServiceImpl
 */
public interface TmsTaskService {

    List<TmsTaskForm> getList(TmsTaskQuery query);

    TmsTaskForm getInfo(String id);

    String create(TmsTaskForm form);

    void update(String id, TmsTaskForm form);

    void delete(String id);

    /**
     * 发布草稿任务（仅 publish_status=draft）。
     * <p>副作用：编号 TD→TT（若仍为草稿号）；为每位学员建 {@code tms_person_task}；
     * 建/复活 {@code tms_record}(open)；同步讲义快照；考核=在线考试时预建 {@code tms_exam} 待考壳。</p>
     */
    void publish(String id);

    /** 取消/终止（有人已签到则不可） */
    void cancel(String id);

    /** 批量取消 */
    void cancelBatch(List<String> ids);

    /** 恢复为草稿 */
    void restore(String id);

    /**
     * 年计划审批通过：按子表生成未发布培训任务。
     * 已存在 source_item_id 的行跳过，可重复调用。
     */
    TmsFromPlanResult createFromAnnual(String planId);

    /**
     * 岗位培训计划审批通过：按子表生成未发布培训任务。
     * 培训对象取计划主表；已存在 source_item_id 的行跳过。
     */
    TmsFromPlanResult createFromPost(String planId);
}