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
}
}