feat: add learning activity endpoints

2026-07-26 15:18:57 +08:00
parent b5be831749
commit db319ef5a2
8 changed files with 1158 additions and 0 deletions
--- a/Tiku.Api/Controllers/LearningController.cs
+++ b/Tiku.Api/Controllers/LearningController.cs
@@ -0,0 +1,154 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Tiku.Api.Contracts;
+using Tiku.Application.Learning;
+using Tiku.Application.Security;
+
+namespace Tiku.Api.Controllers;
+
+[ApiController]
+[Authorize(Policy = TikuPolicies.CurrentTenantMember)]
+[Produces("application/json")]
+[Route("api/learning")]
+public sealed class LearningController(
+    ILearningActivityService learningActivityService,
+    ICurrentUser currentUser,
+    ICurrentTenant currentTenant) : ControllerBase
+{
+    [HttpPost("answers")]
+    [EndpointSummary("提交题目答案")]
+    [ProducesResponseType<AnswerRecordItem>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status403Forbidden)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<AnswerRecordItem>> SubmitAnswer(
+        SubmitAnswerDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.SubmitAnswerAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("favorites/questions")]
+    [EndpointSummary("查询收藏题目")]
+    [ProducesResponseType<LearningList<FavoriteQuestionItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<LearningList<FavoriteQuestionItem>>> GetFavoriteQuestions(
+        [FromQuery] LearningLimitQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.GetFavoriteQuestionsAsync(
+            ResolveActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("favorites/questions")]
+    [EndpointSummary("收藏或取消收藏题目")]
+    [ProducesResponseType<LearningActionResult>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<LearningActionResult>> ToggleFavoriteQuestion(
+        QuestionActionDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.ToggleFavoriteQuestionAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("wrong-questions")]
+    [EndpointSummary("查询错题列表")]
+    [ProducesResponseType<LearningList<WrongQuestionItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<LearningList<WrongQuestionItem>>> GetWrongQuestions(
+        [FromQuery] LearningLimitQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.GetWrongQuestionsAsync(
+            ResolveActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("wrong-questions/resolve")]
+    [EndpointSummary("将错题标记为已解决")]
+    [ProducesResponseType<LearningActionResult>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<LearningActionResult>> ResolveWrongQuestion(
+        QuestionActionDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.ResolveWrongQuestionAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("vocabulary/progress")]
+    [EndpointSummary("查询单词学习进度")]
+    [ProducesResponseType<LearningList<WordProgressItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<LearningList<WordProgressItem>>> GetWordProgress(
+        [FromQuery] LearningLimitQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.GetWordProgressAsync(
+            ResolveActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("vocabulary/progress")]
+    [EndpointSummary("更新单词学习进度")]
+    [ProducesResponseType<WordProgressItem>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<WordProgressItem>> UpdateWordProgress(
+        WordProgressDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.UpdateWordProgressAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    [HttpGet("vocabulary/favorites")]
+    [EndpointSummary("查询收藏单词")]
+    [ProducesResponseType<LearningList<FavoriteWordItem>>(StatusCodes.Status200OK)]
+    public async Task<ActionResult<LearningList<FavoriteWordItem>>> GetFavoriteWords(
+        [FromQuery] LearningLimitQueryDto query,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.GetFavoriteWordsAsync(
+            ResolveActor(),
+            query.ToFilter(),
+            cancellationToken));
+    }
+
+    [HttpPost("vocabulary/favorites")]
+    [EndpointSummary("收藏或取消收藏单词")]
+    [ProducesResponseType<LearningActionResult>(StatusCodes.Status200OK)]
+    [ProducesResponseType<ProblemDetails>(StatusCodes.Status404NotFound)]
+    public async Task<ActionResult<LearningActionResult>> ToggleFavoriteWord(
+        FavoriteWordDto request,
+        CancellationToken cancellationToken)
+    {
+        return Ok(await learningActivityService.ToggleFavoriteWordAsync(
+            ResolveActor(),
+            request.ToCommand(),
+            cancellationToken));
+    }
+
+    private LearningActor ResolveActor()
+    {
+        if (currentTenant.TenantId is null || currentUser.UserId is null)
+        {
+            throw new LearningAccessDeniedException();
+        }
+
+        return new LearningActor(currentTenant.TenantId.Value, currentUser.UserId.Value);
+    }
+}
+
+public sealed class LearningAccessDeniedException()
+    : Exception("Learning actor was not resolved.");