package com.yunhai.acaclassassign.service;

import com.yunhai.acaclassassign.entity.AssignProject;
import com.yunhai.acaclassassign.model.assign.PushStatusVo;

/**
 * 分班结果推送班级管理（userclass /oapi/class）服务。
 * <p>链路：AddClass（同步组，返回 本地班→平台classId 映射）→ AddClassStudent（用户中心建号+sch_student 落库）。
 * 推送与提交解耦：推送异常不影响提交锁定状态。</p>
 */
public interface IPushClassService {

    /**
     * 推送分班结果（整体：全部班级 + 全部已分班学生）。
     * retry=true 时只重推 fail_json 中的失败学生（AddClass 幂等仍会整体调用）。
     */
    PushStatusVo push(AssignProject project, boolean retry);

    /** 查询推送状态（无记录返回未推送状态，不抛错） */
    PushStatusVo status(AssignProject project);
}