using System.Collections.Generic;
using System.Threading.Tasks;
using YhCore.Model.Dto;

namespace YhCore.Service.Interfaces
{
    /// <summary>
    /// 自由审批流服务（移植旧 BestSchool.Service.ApproveFlow）。
    /// 教师查询走教务 SDK（Yh.SchClass.OpenApi）。
    /// </summary>
    public interface IFreeApproveService
    {
        /// <summary>获取自己的自由流程节点（dataid 为空时取最大 dataid）。</summary>
        Task<List<FreeFlowNode>> GetFleeFlowAsync(int userId, int? dataid);

        /// <summary>保存自由流程审核人，返回首步骤 SerID。</summary>
        Task<int> EditFleeFlowAsync(int userId, string schSerId, int? dataid, string flowUids, bool isFlowNull);

        /// <summary>添加审核意见（写 flowtranctInfo，actionstatus=-1）。</summary>
        Task<string> AddShenheRemarkAsync(int userId, int? dataid, string remark, int freestepid);

        /// <summary>获取 freestepid 之后的自由流程节点。</summary>
        Task<List<FreeFlowNode>> GetAfterFleeFlowAsync(int? dataid, int freestepid);

        /// <summary>编辑 freestepid 之后的自由流程，返回末步骤 SerID。</summary>
        Task<int> EditAfterFleeFlowAsync(int? dataid, int freestepid, string flowUids);

        /// <summary>查看发起人 + 审核人步骤（自由 / 固定 / 仅记录）。</summary>
        Task<List<FreeShenheInfo>> ShenheFlowAsync(int uid, string ctime, int dataid, int? freestepid, int? flowid);

        /// <summary>抄送人列表（按 uids 查用户）。</summary>
        Task<List<ChaoSendUser>> ChaoSendListAsync(string uids);
    }
}