feat(content): establish v2 learning delivery foundation

Tiku.Api/Controllers/TenantClassLearningAssignmentController.cs

@@ -7,68 +7,82 @@ using Tiku.Application.Security;
 namespace Tiku.Api.Controllers;
 
 [ApiController]
-[Tags("租户端-班级学习授权")]
+[Tags("租户端-班级学习授权 V2")]
 [Authorize(Policy = BackendPermissions.TenantStudentManage)]
 [Produces("application/json")]
-[Route("api/tenant/classes/learning-assignments")]
+[Route("api/tenant/classes/{classId:guid}/learning-assignments")]
 public sealed class TenantClassLearningAssignmentController(
-    ILearningAccessAdministrationService service,
+    IV2LearningAccessAdministrationService service,
     TenantAdminActorResolver actorResolver) : ControllerBase
 {
     [HttpGet]
-    [EndpointSummary("查询班级题集和练习蓝图授权")]
-    public Task<IReadOnlyCollection<ClassContentAssignmentItem>> Get(
-        [FromQuery] Guid classId,
+    [EndpointSummary("查询班级的 V2 题集和蓝图授权")]
+    public Task<IReadOnlyCollection<ClassAssignmentGrantItem>> Get(
+        Guid classId,
         CancellationToken cancellationToken)
     {
         var actor = actorResolver.Resolve();
-        return service.GetClassAssignmentsAsync(actor.TenantId, classId, cancellationToken);
+        return service.GetClassGrantsAsync(actor.TenantId, classId, cancellationToken);
     }
 
     [HttpPut]
-    [EndpointSummary("新增或更新班级题集和练习蓝图授权")]
-    public Task<ClassContentAssignmentItem> Upsert(
-        UpsertClassContentAssignmentDto request,
+    [EndpointSummary("新增或更新班级的 V2 题集和蓝图授权")]
+    public Task<ClassAssignmentGrantItem> Upsert(
+        Guid classId,
+        UpsertClassAssignmentGrantDto request,
         CancellationToken cancellationToken)
     {
         var actor = actorResolver.Resolve();
-        return service.UpsertClassAssignmentAsync(
-            actor.TenantId, actor.UserId, request.ToCommand(), cancellationToken);
+        return service.UpsertClassGrantAsync(
+            actor.TenantId,
+            actor.UserId,
+            request.ToCommand(classId),
+            cancellationToken);
     }
 
-    [HttpPost("{assignmentId:guid}/revoke")]
-    [EndpointSummary("撤回班级学习授权并强制撤销活动会话")]
-    public Task<ClassContentAssignmentItem> Revoke(
-        Guid assignmentId,
-        RevokeClassContentAssignmentDto request,
+    [HttpPost("{grantId:guid}/revoke")]
+    [EndpointSummary("撤回班级 V2 学习授权；已开始会话继续使用锁定快照")]
+    public Task<ClassAssignmentGrantItem> Revoke(
+        Guid classId,
+        Guid grantId,
+        RevokeClassAssignmentGrantDto request,
         CancellationToken cancellationToken)
     {
         var actor = actorResolver.Resolve();
-        return service.RevokeClassAssignmentAsync(
-            actor.TenantId, actor.UserId, assignmentId, request.Reason, cancellationToken);
+        return service.RevokeClassGrantAsync(
+            actor.TenantId,
+            actor.UserId,
+            classId,
+            grantId,
+            request.Reason,
+            cancellationToken);
     }
 }
 
 [ApiController]
-[Tags("租户端-学生学习授权")]
+[Tags("租户端-学生学习目标 V2")]
 [Authorize(Policy = BackendPermissions.TenantStudentManage)]
 [Produces("application/json")]
-[Route("api/tenant/students/{userId:guid}/learning/target-region")]
+[Route("api/tenant/students/{userId:guid}/learning-targets/{businessLineId:guid}")]
 public sealed class TenantStudentLearningAccessController(
-    ILearningAccessAdministrationService service,
+    IStudentLearningTargetService service,
     TenantAdminActorResolver actorResolver) : ControllerBase
 {
     [HttpPut]
-    [EndpointSummary("管理员强制调整学生目标地区")]
-    public Task<StudentTargetRegionItem> Override(
+    [EndpointSummary("管理员带原因强制调整学生复合考试目标")]
+    public Task<LearningTargetSelectionItem> Override(
         Guid userId,
-        OverrideStudentTargetRegionDto request,
+        Guid businessLineId,
+        OverrideStudentLearningTargetsDto request,
         CancellationToken cancellationToken)
     {
         var actor = actorResolver.Resolve();
-        return service.OverrideTargetRegionAsync(
-            actor.TenantId,
-            request.ToCommand(userId, actor.UserId),
+        return service.OverrideTargetsAsync(
+            new LearningActor(actor.TenantId, userId),
+            businessLineId,
+            request.ToCommand(),
+            actor.UserId,
+            request.Reason,
             cancellationToken);
     }
 }