feat: 新增轮播图和资料管理模块

此提交完整实现了小程序端和管理后台的轮播图、资料管理功能:
1. 新增3个枚举类型:轮播图展示位置、跳转类型、资料文件类型
2. 新增数据库表结构SQL脚本,包含Banner、Material、MaterialFile表
3. 新增实体类定义,适配SqlSugar ORM
4. 新增服务接口与实现,包含CRUD、状态切换、列表查询等完整业务逻辑
5. 新增管理后台API控制器和小程序端API控制器
6. 新增数据传输对象,包含输入、输出、查询参数等类型
7. 实现了OSS临时文件迁移、参数校验、分页查询、软删除等基础功能
This commit is contained in:
glz
2026-07-07 15:53:25 +08:00
parent 0b829b72cb
commit 24059dfebb
16 changed files with 1534 additions and 0 deletions

View File

@ -0,0 +1,89 @@
using Microsoft.AspNetCore.Mvc;
using QYZH.InteractiveMagazine.IService;
using QYZH.InteractiveMagazine.Models.Dto;
using QYZH.InteractiveMagazine.Models.Dto.Material;
using QYZH.InteractiveMagazine.Models.Enum;
namespace QYZH.InteractiveMagazine.WebApi.Controllers;
/// <summary>
/// 资料管理控制器
/// </summary>
[Route("api/[controller]")]
[ApiController]
[ApiExplorerSettings(GroupName = nameof(ApiVersionEnum.Platform))]
public class MaterialController(IMaterialService materialService) : BaseController
{
/// <summary>
/// 创建资料
/// </summary>
/// <param name="input">资料信息</param>
/// <returns>创建后的资料信息</returns>
[HttpPost]
public async Task<BaseResponse<MaterialOutput>> CreateAsync([FromBody] MaterialInput input)
{
var result = await materialService.CreateAsync(input);
return Success(result, "创建资料成功");
}
/// <summary>
/// 更新资料
/// </summary>
/// <param name="id">资料ID</param>
/// <param name="input">资料信息</param>
/// <returns>更新后的资料信息</returns>
[HttpPut("{id}")]
public async Task<BaseResponse<MaterialOutput>> UpdateAsync(long id, [FromBody] MaterialInput input)
{
var result = await materialService.UpdateAsync(id, input);
return Success(result, "更新资料成功");
}
/// <summary>
/// 删除资料
/// </summary>
/// <param name="id">资料ID</param>
/// <returns>操作结果</returns>
[HttpDelete("{id}")]
public async Task<BaseResponse<object>> DeleteAsync(long id)
{
await materialService.DeleteAsync(id);
return Success(new object(), "删除资料成功");
}
/// <summary>
/// 根据ID获取资料
/// </summary>
/// <param name="id">资料ID</param>
/// <returns>资料信息</returns>
[HttpGet("{id}")]
public async Task<BaseResponse<MaterialOutput>> GetByIdAsync(long id)
{
var result = await materialService.GetByIdAsync(id);
return Success(result);
}
/// <summary>
/// 分页查询资料列表
/// </summary>
/// <param name="input">查询条件</param>
/// <returns>分页结果</returns>
[HttpPost("list")]
public async Task<BaseResponse<PageListModel<MaterialOutput>>> GetListAsync([FromBody] MaterialQueryInput input)
{
var result = await materialService.GetListAsync(input);
return Success(result);
}
/// <summary>
/// 更新资料启用/禁用状态
/// </summary>
/// <param name="id">资料ID</param>
/// <returns>操作结果</returns>
[HttpPut("{id}/status")]
public async Task<BaseResponse<bool>> UpdateStatusAsync(long id)
{
var result = await materialService.UpdateStatusAsync(id);
return Success(result, "更新资料状态成功");
}
}