feat: add tenant content navigation management endpoints

2026-07-26 17:25:08 +08:00
parent 3c0acebbbe
commit 1d7e09b1f0
8 changed files with 2066 additions and 0 deletions
--- a/Tiku.Api/Controllers/TenantContentController.cs
+++ b/Tiku.Api/Controllers/TenantContentController.cs
@@ -3,6 +3,7 @@ using Microsoft.AspNetCore.Mvc;
 using Tiku.Api.Contracts;
 using Tiku.Application.Assets;
 using Tiku.Application.Catalog;
+using Tiku.Application.Content;
 using Tiku.Application.Security;

 namespace Tiku.Api.Controllers;
@@ -13,9 +14,145 @@ namespace Tiku.Api.Controllers;
 [Route("api/tenant-content")]
 public sealed class TenantContentController(
    IAssetManagementService assetManagementService,
+    IContentManagementService contentManagementService,
    ICurrentUser currentUser,
    ICurrentTenant currentTenant) : ControllerBase
 {
+    [HttpGet("entries")]
+    [EndpointSummary("查询租户内容入口")]
+    [ProducesResponseType<CatalogList<ContentEntryManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CatalogList<ContentEntryManagementItem>>> GetEntries(
+        [FromQuery] ContentManagementQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.GetEntriesAsync(
+            ResolveContentActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("entries")]
+    [EndpointSummary("创建或更新内容入口")]
+    [ProducesResponseType<ContentManagementResult<ContentEntryManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<ContentEntryManagementItem>>> UpsertEntry(
+        UpsertContentEntryDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.UpsertEntryAsync(
+            ResolveContentActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("nodes")]
+    [EndpointSummary("查询租户内容节点")]
+    [ProducesResponseType<CatalogList<ContentNodeManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CatalogList<ContentNodeManagementItem>>> GetNodes(
+        [FromQuery] ContentManagementQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.GetNodesAsync(
+            ResolveContentActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("nodes")]
+    [EndpointSummary("创建或更新内容节点")]
+    [ProducesResponseType<ContentManagementResult<ContentNodeManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<ContentNodeManagementItem>>> UpsertNode(
+        UpsertContentNodeDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.UpsertNodeAsync(
+            ResolveContentActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("question-collections")]
+    [EndpointSummary("查询租户题集")]
+    [ProducesResponseType<CatalogList<QuestionCollectionManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CatalogList<QuestionCollectionManagementItem>>> GetQuestionCollections(
+        [FromQuery] ContentManagementQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.GetCollectionsAsync(
+            ResolveContentActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("question-collections")]
+    [EndpointSummary("创建或更新题集")]
+    [ProducesResponseType<ContentManagementResult<QuestionCollectionManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<QuestionCollectionManagementItem>>> UpsertQuestionCollection(
+        UpsertQuestionCollectionDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.UpsertCollectionAsync(
+            ResolveContentActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpPost("question-collections/items/replace")]
+    [EndpointSummary("替换题集题目")]
+    [ProducesResponseType<CollectionItemsReplaceResult>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CollectionItemsReplaceResult>> ReplaceQuestionCollectionItems(
+        ReplaceCollectionItemsDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.ReplaceCollectionItemsAsync(
+            ResolveContentActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("practice-blueprints")]
+    [EndpointSummary("查询练习蓝图")]
+    [ProducesResponseType<CatalogList<PracticeBlueprintManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<CatalogList<PracticeBlueprintManagementItem>>> GetPracticeBlueprints(
+        [FromQuery] ContentManagementQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.GetPracticeBlueprintsAsync(
+            ResolveContentActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("practice-blueprints")]
+    [EndpointSummary("创建或更新练习蓝图")]
+    [ProducesResponseType<ContentManagementResult<PracticeBlueprintManagementItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<ContentManagementResult<PracticeBlueprintManagementItem>>> UpsertPracticeBlueprint(
+        UpsertPracticeBlueprintDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentManagementService.UpsertPracticeBlueprintAsync(
+            ResolveContentActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("imports/field-mapping")]
+    [EndpointSummary("查询导入字段映射")]
+    [ProducesResponseType<ImportFieldMappingItem>(StatusCodes.Status200OK)]
+    public ActionResult<ImportFieldMappingItem> GetImportFieldMapping([FromQuery] ImportTemplateQueryDto query)
+    {
+        _ = ResolveContentActor();
+        return Ok(contentManagementService.GetImportFieldMapping(query.ImportType));
+    }
+
+    [HttpGet("imports/templates")]
+    [EndpointSummary("获取内容导入模板")]
+    [ProducesResponseType<ImportTemplateItem>(StatusCodes.Status200OK)]
+    public ActionResult<ImportTemplateItem> GetImportTemplate([FromQuery] ImportTemplateQueryDto query)
+    {
+        _ = ResolveContentActor();
+        return Ok(contentManagementService.GetImportTemplate(query.ImportType, query.Format));
+    }
+
    [HttpGet("assets")]
    [EndpointSummary("查询租户内容资产")]
    [ProducesResponseType<CatalogList<ContentAssetManagementItem>>(StatusCodes.Status200OK)]
@@ -95,4 +232,14 @@ public sealed class TenantContentController(

        return new AssetManagementActor(currentTenant.TenantId.Value, currentUser.UserId.Value);
    }
+
+    private ContentManagementActor ResolveContentActor()
+    {
+        if (currentTenant.TenantId is null || currentUser.UserId is null)
+        {
+            throw new ContentManagementException("Tenant content actor was not resolved.", "tenant_content_access_denied");
+        }
+
+        return new ContentManagementActor(currentTenant.TenantId.Value, currentUser.UserId.Value);
+    }
 }