feat: add medal module and optimize community entities

1. 新增勋章管理全流程功能，包含实体、DTO、服务层、控制器 2. 重构DotFile实体继承基础实体类 3. 删除UserJournal的无用JournalInstanceId字段 4. 重构CommunityMessage实体字段并新增点赞数、精选标记字段 5. 新增社区点赞、评论、模板言论实体并替换旧有实体文件 6. 更新gitignore忽略PROJECT_STRUCTURE.md文件
2026-06-05 15:16:49 +08:00
parent 634c4eccfd
commit f9b79417a0
13 changed files with 1118 additions and 92 deletions
--- a/QYZH.InteractiveMagazine.WebApi/Controllers/MedalController.cs
+++ b/QYZH.InteractiveMagazine.WebApi/Controllers/MedalController.cs
@ -0,0 +1,177 @@
+using Microsoft.AspNetCore.Mvc;
+using QYZH.InteractiveMagazine.IService;
+using QYZH.InteractiveMagazine.Models.Common;
+using QYZH.InteractiveMagazine.Models.Dto;
+using QYZH.InteractiveMagazine.Models.Enum;
+
+namespace QYZH.InteractiveMagazine.WebApi.Controllers;
+
+/// <summary>
+/// 勋章管理控制器
+/// </summary>
+[Route("api/[controller]")]
+[ApiController]
+[ApiExplorerSettings(GroupName = nameof(ApiVersionEnum.Platform))]
+public class MedalController : BaseController
+{
+    private readonly IMedalService _medalService;
+    private readonly ILogger<MedalController> _logger;
+
+    public MedalController(IMedalService medalService, ILogger<MedalController> logger)
+    {
+        _medalService = medalService;
+        _logger = logger;
+    }
+
+    /// <summary>
+    /// 创建勋章
+    /// </summary>
+    /// <param name="input">勋章信息</param>
+    /// <returns>创建的勋章信息</returns>
+    [HttpPost]
+    public async Task<BaseResponse<MedalOutput>> CreateAsync([FromBody] MedalInput input)
+    {
+        try
+        {
+            var result = await _medalService.CreateAsync(input);
+            return Success(result, "创建勋章成功");
+        }
+        catch (BusinessException ex)
+        {
+            _logger.LogWarning(ex, "创建勋章业务异常: {Message}", ex.Message);
+            return BaseResponse<MedalOutput>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "创建勋章系统异常，参数：{Input}", input);
+            return BaseResponse<MedalOutput>.Fail("创建勋章失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 更新勋章
+    /// </summary>
+    /// <param name="id">勋章ID</param>
+    /// <param name="input">勋章信息</param>
+    /// <returns>更新后的勋章信息</returns>
+    [HttpPut("{id}")]
+    public async Task<BaseResponse<MedalOutput>> UpdateAsync(long id, [FromBody] MedalInput input)
+    {
+        try
+        {
+            var result = await _medalService.UpdateAsync(id, input);
+            return Success(result, "更新勋章成功");
+        }
+        catch (BusinessException ex)
+        {
+            _logger.LogWarning(ex, "更新勋章业务异常: {Message}", ex.Message);
+            return BaseResponse<MedalOutput>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "更新勋章系统异常，ID：{Id}，参数：{Input}", id, input);
+            return BaseResponse<MedalOutput>.Fail("更新勋章失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 删除勋章
+    /// </summary>
+    /// <param name="id">勋章ID</param>
+    /// <returns>操作结果</returns>
+    [HttpDelete("{id}")]
+    public async Task<BaseResponse<object>> DeleteAsync(long id)
+    {
+        try
+        {
+            await _medalService.DeleteAsync(id);
+            return Success(new object(), "删除勋章成功");
+        }
+        catch (BusinessException ex)
+        {
+            _logger.LogWarning(ex, "删除勋章业务异常: {Message}", ex.Message);
+            return BaseResponse<object>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "删除勋章系统异常，ID：{Id}", id);
+            return BaseResponse<object>.Fail("删除勋章失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 根据ID获取勋章
+    /// </summary>
+    /// <param name="id">勋章ID</param>
+    /// <returns>勋章信息</returns>
+    [HttpGet("{id}")]
+    public async Task<BaseResponse<MedalOutput>> GetByIdAsync(long id)
+    {
+        try
+        {
+            var result = await _medalService.GetByIdAsync(id);
+            return Success(result);
+        }
+        catch (BusinessException ex)
+        {
+            _logger.LogWarning(ex, "获取勋章业务异常: {Message}", ex.Message);
+            return BaseResponse<MedalOutput>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "获取勋章系统异常，ID：{Id}", id);
+            return BaseResponse<MedalOutput>.Fail("获取勋章信息失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 分页查询勋章列表
+    /// </summary>
+    /// <param name="input">查询条件</param>
+    /// <returns>分页结果</returns>
+    [HttpPost("list")]
+    public async Task<BaseResponse<PageListModel<MedalOutput>>> GetListAsync([FromBody] MedalQueryInput input)
+    {
+        try
+        {
+            var result = await _medalService.GetListAsync(input);
+            return Success(result);
+        }
+        catch (BusinessException ex)
+        {
+            _logger.LogWarning(ex, "查询勋章列表业务异常: {Message}", ex.Message);
+            return BaseResponse<PageListModel<MedalOutput>>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "查询勋章列表系统异常，参数：{Input}", input);
+            return BaseResponse<PageListModel<MedalOutput>>.Fail("查询勋章列表失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 更新勋章启用/禁用状态
+    /// </summary>
+    /// <param name="id">勋章ID</param>
+    /// <param name="status">状态: 0=禁用, 1=启用</param>
+    /// <returns>操作结果</returns>
+    [HttpPut("{id}/status")]
+    public async Task<BaseResponse<object>> UpdateStatusAsync(long id, [FromBody] int status)
+    {
+        try
+        {
+            await _medalService.UpdateStatusAsync(id, status);
+            return Success(new object(), status == 1 ? "启用勋章成功" : "禁用勋章成功");
+        }
+        catch (BusinessException ex)
+        {
+            _logger.LogWarning(ex, "更新勋章状态业务异常: {Message}", ex.Message);
+            return BaseResponse<object>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            _logger.LogError(ex, "更新勋章状态系统异常，ID：{Id}，Status：{Status}", id, status);
+            return BaseResponse<object>.Fail("更新勋章状态失败，请稍后重试");
+        }
+    }
+}
--- a/QYZH.InteractiveMagazine.WebApi/Controllers/WeChat/WeChatMedalController.cs
+++ b/QYZH.InteractiveMagazine.WebApi/Controllers/WeChat/WeChatMedalController.cs
@ -0,0 +1,99 @@
+using Microsoft.AspNetCore.Mvc;
+using QYZH.InteractiveMagazine.IService;
+using QYZH.InteractiveMagazine.Models.Common;
+using QYZH.InteractiveMagazine.Models.Dto;
+
+namespace QYZH.InteractiveMagazine.WebApi.Controllers.WeChat;
+
+/// <summary>
+/// 小程序勋章控制器
+/// </summary>
+public class WeChatMedalController(IMedalService medalService, ILogger<WeChatMedalController> logger) : WeChatBaseController
+{
+    /// <summary>
+    /// 获取所有勋章列表（含当前用户拥有状态）
+    /// </summary>
+    [HttpGet("all")]
+    public async Task<BaseResponse<List<WxMedalListOutput>>> GetAllMedals()
+    {
+        try
+        {
+            var userId = GetCurrentUserId();
+            if (userId == null)
+            {
+                return BaseResponse<List<WxMedalListOutput>>.Fail(ResultCode.DENY, "未获取到用户信息");
+            }
+
+            var result = await medalService.GetAllMedalsAsync(userId.Value);
+            return Success(result);
+        }
+        catch (BusinessException ex)
+        {
+            logger.LogWarning(ex, "获取勋章列表业务异常: {Message}", ex.Message);
+            return BaseResponse<List<WxMedalListOutput>>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "获取勋章列表系统异常");
+            return BaseResponse<List<WxMedalListOutput>>.Fail("获取勋章列表失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取用户已拥有的勋章列表
+    /// </summary>
+    [HttpGet("my")]
+    public async Task<BaseResponse<List<WxUserMedalOutput>>> GetUserMedals()
+    {
+        try
+        {
+            var userId = GetCurrentUserId();
+            if (userId == null)
+            {
+                return BaseResponse<List<WxUserMedalOutput>>.Fail(ResultCode.DENY, "未获取到用户信息");
+            }
+
+            var result = await medalService.GetUserMedalsAsync(userId.Value);
+            return Success(result);
+        }
+        catch (BusinessException ex)
+        {
+            logger.LogWarning(ex, "获取用户勋章列表业务异常: {Message}", ex.Message);
+            return BaseResponse<List<WxUserMedalOutput>>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "获取用户勋章列表系统异常");
+            return BaseResponse<List<WxUserMedalOutput>>.Fail("获取用户勋章列表失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 激活/获得勋章
+    /// </summary>
+    [HttpPost("activate")]
+    public async Task<BaseResponse<object>> ActivateMedal([FromBody] WxMedalActivateInput input)
+    {
+        try
+        {
+            var userId = GetCurrentUserId();
+            if (userId == null)
+            {
+                return BaseResponse<object>.Fail(ResultCode.DENY, "未获取到用户信息");
+            }
+
+            await medalService.ActivateMedalAsync(userId.Value, input);
+            return Success<object>(null!, "勋章激活成功");
+        }
+        catch (BusinessException ex)
+        {
+            logger.LogWarning(ex, "激活勋章业务异常: {Message}", ex.Message);
+            return BaseResponse<object>.Fail(ex.Message);
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "激活勋章系统异常，参数：{Input}", input);
+            return BaseResponse<object>.Fail("激活勋章失败，请稍后重试");
+        }
+    }
+}