commit

src/main/java/com/yunhai/acaclassassign/service/IPushClassService.java

@@ -0,0 +1,21 @@
+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);
+}