feat: add question bank readonly endpoints

Tiku.Api/Controllers/CatalogController.cs

@@ -4,6 +4,7 @@ using Microsoft.EntityFrameworkCore;
 using Tiku.Api.Contracts;
 using Tiku.Application.Catalog;
 using Tiku.Application.Content;
+using Tiku.Application.QuestionBanks;
 using Tiku.Application.Security;
 using Tiku.Domain.Tenancy;
 using Tiku.Infrastructure.Persistence;
@@ -17,6 +18,7 @@ namespace Tiku.Api.Controllers;
 public sealed class CatalogController(
     ICatalogQueryService catalogQueryService,
     IContentNavigationQueryService contentNavigationQueryService,
+    IQuestionBankQueryService questionBankQueryService,
     ICurrentTenant currentTenant,
     TikuDbContext dbContext) : ControllerBase
 {
@@ -179,6 +181,61 @@ public sealed class CatalogController(
             cancellationToken));
     }
 
+    [HttpGet("question-banks")]
+    [EndpointSummary("查询题库列表")]
+    [ProducesResponseType<CatalogList<QuestionBankCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<QuestionBankCatalogItem>>> GetQuestionBanks(
+        [FromQuery] QuestionBankQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await questionBankQueryService.GetQuestionBanksAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken)),
+            cancellationToken));
+    }
+
+    [HttpGet("questions")]
+    [EndpointSummary("查询已发布题目")]
+    [EndpointDescription("支持按题库、科目、分类、模块节点、内容入口、内容节点、题集或题目 ID 列表筛选。")]
+    [ProducesResponseType<CatalogList<QuestionCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<QuestionCatalogItem>>> GetQuestions(
+        [FromQuery] QuestionBankQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await questionBankQueryService.GetQuestionsAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken)),
+            cancellationToken));
+    }
+
+    [HttpGet("questions/{questionId:guid}")]
+    [EndpointSummary("查询题目详情")]
+    [ProducesResponseType<QuestionCatalogItem>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<QuestionCatalogItem>> GetQuestion(
+        Guid questionId,
+        [FromQuery] QuestionBankQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await questionBankQueryService.GetQuestionAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken), questionId),
+            cancellationToken));
+    }
+
+    [HttpGet("questions/{questionId:guid}/versions")]
+    [EndpointSummary("查询题目版本")]
+    [ProducesResponseType<CatalogList<QuestionVersionCatalogItem>>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<CatalogList<QuestionVersionCatalogItem>>> GetQuestionVersions(
+        Guid questionId,
+        [FromQuery] QuestionBankQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await questionBankQueryService.GetQuestionVersionsAsync(
+            query.ToFilter(await ResolveTenantIdAsync(query, cancellationToken), questionId),
+            cancellationToken));
+    }
+
     private async Task<Guid> ResolveTenantIdAsync(
         CatalogQueryDto query,
         CancellationToken cancellationToken)
@@ -215,6 +272,18 @@ public sealed class CatalogController(
             },
             cancellationToken);
     }
+
+    private Task<Guid> ResolveTenantIdAsync(
+        QuestionBankQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return ResolveTenantIdAsync(
+            new CatalogQueryDto
+            {
+                TenantCode = query.TenantCode
+            },
+            cancellationToken);
+    }
 }
 
 public sealed class TenantNotFoundException : Exception