using Entities.Contracts; using Entities.DTO; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.Identity; using Microsoft.AspNetCore.Mvc; using TechHelper.Services; using TechHelper.Services.Beta; namespace TechHelper.Server.Controllers { /// /// 知识点管理控制器 /// 处理知识点相关的操作,如创建、更新、删除知识点等 /// [Route("api/keypoint")] [ApiController] public class KeyPointController : ControllerBase { private readonly IKeyPointService _keyPointService; private readonly UserManager _userManager; /// /// 初始化知识点控制器 /// /// 知识点服务 /// 用户管理服务 public KeyPointController(IKeyPointService keyPointService, UserManager userManager) { _keyPointService = keyPointService; _userManager = userManager; } #region 知识点基本信息CRUD操作 /// /// 获取知识点列表(支持搜索) /// /// 查询参数 /// 知识点列表 /// 成功获取知识点列表 /// 获取失败 [HttpGet] [Authorize(Roles = "Teacher,Admin")] public async Task GetAll([FromQuery] QueryParameter query) { var result = await _keyPointService.GetAllAsync(query); if (!result.Status) { return BadRequest(result.Message); } return Ok(result.Result); } /// /// 根据ID获取知识点详细信息 /// /// 知识点ID /// 知识点详细信息 /// 成功获取知识点信息 /// 知识点未找到或获取失败 [HttpGet("{id}")] [Authorize(Roles = "Teacher,Admin")] public async Task GetById(Guid id) { var result = await _keyPointService.GetAsync(id); if (!result.Status) { return BadRequest(result.Message); } return Ok(result.Result); } /// /// 创建新知识点 /// /// 知识点数据传输对象 /// 创建结果 /// 创建成功 /// 创建失败 [HttpPost] [Authorize(Roles = "Teacher,Admin")] public async Task Create([FromBody] KeyPointDto model) { var result = await _keyPointService.AddAsync(model); if (!result.Status) { return BadRequest(result.Message); } return Ok(result.Result); } /// /// 更新知识点信息 /// /// 知识点数据传输对象 /// 更新结果 /// 更新成功 /// 更新失败 [HttpPut] [Authorize(Roles = "Teacher,Admin")] public async Task Update([FromBody] KeyPointDto model) { var result = await _keyPointService.UpdateAsync(model); if (!result.Status) { return BadRequest(result.Message); } return Ok(result.Result); } /// /// 删除知识点 /// /// 知识点ID /// 删除结果 /// 删除成功 /// 删除失败 [HttpDelete("{id}")] [Authorize(Roles = "Teacher,Admin")] public async Task Delete(Guid id) { var result = await _keyPointService.DeleteAsync(id); if (!result.Status) { return BadRequest(result.Message); } return Ok(result.Message); } #endregion #region 知识点扩展操作 /// /// 根据课程ID获取知识点列表 /// /// 课程ID /// 知识点列表 /// 成功获取知识点列表 /// 获取失败 [HttpGet("lesson/{lessonId}")] [Authorize(Roles = "Student,Teacher,Admin")] public async Task GetByLessonId(Guid lessonId) { var result = await _keyPointService.GetKeyPointsByLessonIdAsync(lessonId); if (!result.Status) { return BadRequest(result.Message); } return Ok(result.Result); } #endregion } }