feat: add content navigation readonly endpoints

Tiku.Api/Controllers/CatalogController.cs

@@ -3,6 +3,7 @@ using Microsoft.AspNetCore.Mvc;
 using Microsoft.EntityFrameworkCore;
 using Tiku.Api.Contracts;
 using Tiku.Application.Catalog;
+using Tiku.Application.Content;
 using Tiku.Application.Security;
 using Tiku.Domain.Tenancy;
 using Tiku.Infrastructure.Persistence;
@@ -15,6 +16,7 @@ namespace Tiku.Api.Controllers;
 [Route("api/catalog")]
 public sealed class CatalogController(
     ICatalogQueryService catalogQueryService,
+    IContentNavigationQueryService contentNavigationQueryService,
     ICurrentTenant currentTenant,
     TikuDbContext dbContext) : ControllerBase
 {
@@ -110,6 +112,73 @@ public sealed class CatalogController(
             cancellationToken));
     }
 
+    [HttpGet("content-entries")]
+    [EndpointSummary("查询内容入口")]
+    [ProducesResponseType<CatalogList<ContentEntryCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<ContentEntryCatalogItem>>> GetContentEntries(
+        [FromQuery] ContentNavigationQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentNavigationQueryService.GetContentEntriesAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken)),
+            cancellationToken));
+    }
+
+    [HttpGet("content-nodes")]
+    [EndpointSummary("查询内容导航节点")]
+    [ProducesResponseType<CatalogList<ContentNodeCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<ContentNodeCatalogItem>>> GetContentNodes(
+        [FromQuery] ContentNavigationQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentNavigationQueryService.GetContentNodesAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken)),
+            cancellationToken));
+    }
+
+    [HttpGet("question-collections")]
+    [EndpointSummary("查询可用题集")]
+    [ProducesResponseType<CatalogList<QuestionCollectionCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<QuestionCollectionCatalogItem>>> GetQuestionCollections(
+        [FromQuery] ContentNavigationQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentNavigationQueryService.GetQuestionCollectionsAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken)),
+            cancellationToken));
+    }
+
+    [HttpGet("question-collections/questions")]
+    [EndpointSummary("查询题集内题目")]
+    [ProducesResponseType<CatalogList<CollectionQuestionCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<CollectionQuestionCatalogItem>>> GetCollectionQuestions(
+        [FromQuery] ContentNavigationQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentNavigationQueryService.GetCollectionQuestionsAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken)),
+            cancellationToken));
+    }
+
+    [HttpGet("practice-blueprints")]
+    [EndpointSummary("查询练习蓝图")]
+    [ProducesResponseType<CatalogList<PracticeBlueprintCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<PracticeBlueprintCatalogItem>>> GetPracticeBlueprints(
+        [FromQuery] ContentNavigationQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await contentNavigationQueryService.GetPracticeBlueprintsAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken)),
+            cancellationToken));
+    }
+
     private async Task<Guid> ResolveTenantIdAsync(
         CatalogQueryDto query,
         CancellationToken cancellationToken)
@@ -134,6 +203,18 @@ public sealed class CatalogController(
 
         return tenantId ?? throw new TenantNotFoundException();
     }
+
+    private Task<Guid> ResolveTenantIdAsync(
+        ContentNavigationQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return ResolveTenantIdAsync(
+            new CatalogQueryDto
+            {
+                TenantCode = query.TenantCode
+            },
+            cancellationToken);
+    }
 }
 
 public sealed class TenantNotFoundException : Exception