feat: add tenant admin direct operations endpoints

2026-07-26 18:53:01 +08:00
parent 89e1f2a4df
commit f671a7f07a
8 changed files with 1822 additions and 0 deletions
--- a/Tiku.Api/Controllers/TenantAdminDirectController.cs
+++ b/Tiku.Api/Controllers/TenantAdminDirectController.cs
@@ -0,0 +1,159 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Tiku.Api.Contracts;
+using Tiku.Application.Catalog;
+using Tiku.Application.Content;
+using Tiku.Application.Security;
+using Tiku.Application.TenantAdmin;
+
+namespace Tiku.Api.Controllers;
+
+[ApiController]
+[Authorize(Policy = TikuPolicies.TenantAdmin)]
+[Produces("application/json")]
+[Route("api/tenant-admin")]
+public sealed class TenantAdminDirectController(
+    ITenantAdminDirectService tenantAdminService,
+    ICurrentUser currentUser,
+    ICurrentTenant currentTenant) : ControllerBase
+{
+    [HttpGet("classes")]
+    [EndpointSummary("查询租户班级")]
+    [ProducesResponseType<TenantAdminClassList>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantAdminClassList>> GetClasses(
+        [FromQuery] TenantAdminClassQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.GetClassesAsync(ResolveActor(), query.ToFilter(), cancellationToken));
+    }
+
+    [HttpPut("classes")]
+    [EndpointSummary("新增或更新租户班级")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminClassItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminClassItem>>> UpsertClass(
+        UpsertTenantAdminClassDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.UpsertClassAsync(ResolveActor(), request.ToCommand(), cancellationToken));
+    }
+
+    [HttpPost("classes/disable")]
+    [EndpointSummary("停用租户班级")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminClassItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminClassItem>>> DisableClass(
+        [FromBody] Guid classId,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.DisableClassAsync(ResolveActor(), classId, cancellationToken));
+    }
+
+    [HttpGet("classes/members")]
+    [EndpointSummary("查询班级成员")]
+    [ProducesResponseType<CatalogList<TenantAdminClassMemberItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CatalogList<TenantAdminClassMemberItem>>> GetClassMembers(
+        [FromQuery] TenantAdminClassMemberQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.GetClassMembersAsync(ResolveActor(), query.ToFilter(), cancellationToken));
+    }
+
+    [HttpPut("classes/members")]
+    [EndpointSummary("新增或更新班级成员")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminClassMemberItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminClassMemberItem>>> UpsertClassMember(
+        UpsertTenantAdminClassMemberDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.UpsertClassMemberAsync(ResolveActor(), request.ToCommand(), cancellationToken));
+    }
+
+    [HttpPost("classes/members/remove")]
+    [EndpointSummary("移除班级成员")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminClassMemberItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminClassMemberItem>>> RemoveClassMember(
+        RemoveTenantAdminClassMemberDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.RemoveClassMemberAsync(ResolveActor(), request.ClassMemberId, cancellationToken));
+    }
+
+    [HttpGet("students")]
+    [EndpointSummary("查询租户学生")]
+    [ProducesResponseType<TenantAdminStudentList>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<TenantAdminStudentList>> GetStudents(
+        [FromQuery] TenantAdminStudentQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.GetStudentsAsync(ResolveActor(), query.ToFilter(), cancellationToken));
+    }
+
+    [HttpPut("students")]
+    [EndpointSummary("新增或更新租户学生档案")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminStudentItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminStudentItem>>> UpsertStudent(
+        UpsertTenantAdminStudentDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.UpsertStudentAsync(ResolveActor(), request.ToCommand(), cancellationToken));
+    }
+
+    [HttpPost("students/status")]
+    [EndpointSummary("更新租户学生状态")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminStudentStatusItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminStudentStatusItem>>> UpdateStudentStatus(
+        UpdateTenantAdminStudentStatusDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.UpdateStudentStatusAsync(ResolveActor(), request.ToCommand(), cancellationToken));
+    }
+
+    [HttpGet("student-notes")]
+    [EndpointSummary("查询学生备注")]
+    [ProducesResponseType<CatalogList<TenantAdminStudentNoteItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CatalogList<TenantAdminStudentNoteItem>>> GetStudentNotes(
+        [FromQuery] TenantAdminStudentActivityQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.GetStudentNotesAsync(ResolveActor(), query.ToFilter(), cancellationToken));
+    }
+
+    [HttpPut("student-notes")]
+    [EndpointSummary("新增或更新学生备注")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminStudentNoteItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminStudentNoteItem>>> UpsertStudentNote(
+        UpsertTenantAdminStudentNoteDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.UpsertStudentNoteAsync(ResolveActor(), request.ToCommand(), cancellationToken));
+    }
+
+    [HttpGet("student-followups")]
+    [EndpointSummary("查询学生跟进")]
+    [ProducesResponseType<CatalogList<TenantAdminStudentFollowupItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CatalogList<TenantAdminStudentFollowupItem>>> GetStudentFollowups(
+        [FromQuery] TenantAdminStudentActivityQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.GetStudentFollowupsAsync(ResolveActor(), query.ToFilter(), cancellationToken));
+    }
+
+    [HttpPut("student-followups")]
+    [EndpointSummary("新增或更新学生跟进")]
+    [ProducesResponseType<ContentManagementResult<TenantAdminStudentFollowupItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<TenantAdminStudentFollowupItem>>> UpsertStudentFollowup(
+        UpsertTenantAdminStudentFollowupDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await tenantAdminService.UpsertStudentFollowupAsync(ResolveActor(), request.ToCommand(), cancellationToken));
+    }
+
+    private TenantAdminActor ResolveActor()
+    {
+        if (currentTenant.TenantId is null || currentUser.UserId is null)
+        {
+            throw new TenantAdminDirectException("Tenant admin actor was not resolved.", "tenant_admin_access_denied");
+        }
+
+        return new TenantAdminActor(currentTenant.TenantId.Value, currentUser.UserId.Value);
+    }
+}