serega404
f6aaf0b923
🚀 Create and publish a Docker image / Detect changes in backend and frontend (push) Successful in 11s
🚀 Create and publish a Docker image / Build & publish backend image (push) Successful in 1m17s
🚀 Create and publish a Docker image / Build & publish frontend image (push) Successful in 29s
🚀 Create and publish a Docker image / Update stack on Portainer (push) Successful in 9s
208 lines
12 KiB
C#
208 lines
12 KiB
C#
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
using UniVerse.Application.DTOs.Common;
|
|
using UniVerse.Application.DTOs.Lectures;
|
|
using UniVerse.Application.Interfaces;
|
|
using System.Security.Claims;
|
|
|
|
namespace UniVerse.Api.Controllers;
|
|
|
|
/// <summary>Каталог лекций — просмотр, управление, запись и отзывы.</summary>
|
|
[ApiController]
|
|
[Route("api/v1/lectures")]
|
|
[Authorize]
|
|
[Produces("application/json")]
|
|
public class LecturesController : ControllerBase
|
|
{
|
|
private readonly ILectureService _lectures;
|
|
private readonly IReviewService _reviews;
|
|
|
|
public LecturesController(ILectureService lectures, IReviewService reviews)
|
|
{
|
|
_lectures = lectures;
|
|
_reviews = reviews;
|
|
}
|
|
|
|
private int CurrentUserId => int.Parse(
|
|
User.FindFirstValue(ClaimTypes.NameIdentifier) ?? User.FindFirstValue("sub") ?? "0");
|
|
|
|
/// <summary>Получить каталог лекций с фильтрацией и пагинацией.</summary>
|
|
/// <param name="filter">
|
|
/// Фильтры: dateFrom, dateTo, courseId, teacherId, format (Online/Offline),
|
|
/// isOpen, tagId, search; параметры пагинации.
|
|
/// </param>
|
|
/// <response code="200">Список лекций (пагинированный).</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
[HttpGet]
|
|
[ProducesResponseType(typeof(PagedResult<LectureDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
public async Task<ActionResult> GetAll([FromQuery] LectureFilterRequest filter) =>
|
|
Ok(await _lectures.GetAllAsync(filter));
|
|
|
|
/// <summary>Получить детальную карточку лекции по ID.</summary>
|
|
/// <remarks>
|
|
/// Включает флаг `isEnrolled` — записан ли текущий пользователь на эту лекцию.
|
|
/// </remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <response code="200">Детальные данные лекции.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="404">Лекция не найдена.</response>
|
|
[HttpGet("{id:int}")]
|
|
[ProducesResponseType(typeof(LectureDetailDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult> Get(int id) =>
|
|
Ok(await _lectures.GetByIdAsync(id, CurrentUserId));
|
|
|
|
/// <summary>Создать новую лекцию.</summary>
|
|
/// <remarks>Только Admin. Курс задаётся при создании и не может быть изменён.</remarks>
|
|
/// <param name="req">Данные лекции: курс, преподаватель, локация, время, формат, вместимость.</param>
|
|
/// <response code="201">Лекция создана.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
[Authorize(Roles = "Admin")]
|
|
[HttpPost]
|
|
[ProducesResponseType(typeof(LectureDto), StatusCodes.Status201Created)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult<LectureDto>> Create([FromBody] CreateLectureRequest req) =>
|
|
CreatedAtAction(nameof(Get), new { id = 0 }, await _lectures.CreateAsync(req));
|
|
|
|
/// <summary>Обновить лекцию по ID.</summary>
|
|
/// <remarks>Admin или Teacher. CourseId изменить нельзя.</remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <param name="req">Обновляемые поля: преподаватель, локация, время, формат, описание.</param>
|
|
/// <response code="200">Обновлённые данные лекции.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin или Teacher.</response>
|
|
/// <response code="404">Лекция не найдена.</response>
|
|
[Authorize(Roles = "Admin,Teacher")]
|
|
[HttpPut("{id:int}")]
|
|
[ProducesResponseType(typeof(LectureDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult<LectureDto>> Update(int id, [FromBody] UpdateLectureRequest req) =>
|
|
Ok(await _lectures.UpdateAsync(id, req));
|
|
|
|
/// <summary>Удалить лекцию по ID.</summary>
|
|
/// <remarks>Только Admin. Каскадно удаляет записи и отзывы.</remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <response code="204">Лекция удалена.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
/// <response code="404">Лекция не найдена.</response>
|
|
[Authorize(Roles = "Admin")]
|
|
[HttpDelete("{id:int}")]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<IActionResult> Delete(int id)
|
|
{
|
|
await _lectures.DeleteAsync(id);
|
|
return NoContent();
|
|
}
|
|
|
|
/// <summary>Записаться на лекцию.</summary>
|
|
/// <remarks>
|
|
/// Только Student. Проверяет наличие свободных мест и отсутствие повторной записи.
|
|
/// После посещения начисляются монеты через gamification.
|
|
/// </remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <response code="204">Запись выполнена.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Student.</response>
|
|
/// <response code="404">Лекция не найдена.</response>
|
|
/// <response code="409">Студент уже записан или мест нет.</response>
|
|
[Authorize(Roles = "Student")]
|
|
[HttpPost("{id:int}/enroll")]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
[ProducesResponseType(StatusCodes.Status409Conflict)]
|
|
public async Task<IActionResult> Enroll(int id)
|
|
{
|
|
await _lectures.EnrollAsync(id, CurrentUserId);
|
|
return NoContent();
|
|
}
|
|
|
|
/// <summary>Отменить запись на лекцию.</summary>
|
|
/// <remarks>Только Student. Отменить можно только свою запись.</remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <response code="204">Запись отменена.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Student.</response>
|
|
/// <response code="404">Лекция или запись не найдена.</response>
|
|
[Authorize(Roles = "Student")]
|
|
[HttpDelete("{id:int}/enroll")]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<IActionResult> Unenroll(int id)
|
|
{
|
|
await _lectures.UnenrollAsync(id, CurrentUserId);
|
|
return NoContent();
|
|
}
|
|
|
|
/// <summary>Отметить посещение студента на лекции.</summary>
|
|
/// <remarks>
|
|
/// Admin или Teacher. При отметке `attended=true` начисляются монеты за посещение
|
|
/// через gamification service.
|
|
/// </remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <param name="userId">ID студента.</param>
|
|
/// <param name="attended">true — посетил, false — не посетил.</param>
|
|
/// <response code="204">Посещение отмечено.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin или Teacher.</response>
|
|
/// <response code="404">Лекция или запись студента не найдена.</response>
|
|
[Authorize(Roles = "Admin,Teacher")]
|
|
[HttpPatch("{id:int}/attendance/{userId:int}")]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<IActionResult> Attendance(int id, int userId, [FromBody] bool attended)
|
|
{
|
|
await _lectures.MarkAttendanceAsync(id, userId, attended);
|
|
return NoContent();
|
|
}
|
|
|
|
/// <summary>Получить список записавшихся студентов на лекцию.</summary>
|
|
/// <remarks>Только Admin или Teacher. Включает флаг посещения (`attended`).</remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <param name="pagination">Параметры пагинации.</param>
|
|
/// <response code="200">Список записей (пагинированный).</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin или Teacher.</response>
|
|
/// <response code="404">Лекция не найдена.</response>
|
|
[Authorize(Roles = "Admin,Teacher")]
|
|
[HttpGet("{id:int}/enrollments")]
|
|
[ProducesResponseType(typeof(PagedResult<EnrollmentDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult> Enrollments(int id, [FromQuery] PaginationRequest pagination) =>
|
|
Ok(await _lectures.GetEnrollmentsAsync(id, pagination));
|
|
|
|
/// <summary>Получить отзывы к лекции.</summary>
|
|
/// <remarks>Только Admin или Teacher.</remarks>
|
|
/// <param name="id">ID лекции.</param>
|
|
/// <param name="pagination">Параметры пагинации.</param>
|
|
/// <response code="200">Список отзывов (пагинированный).</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin или Teacher.</response>
|
|
/// <response code="404">Лекция не найдена.</response>
|
|
[Authorize(Roles = "Admin,Teacher")]
|
|
[HttpGet("{id:int}/reviews")]
|
|
[ProducesResponseType(typeof(PagedResult<UniVerse.Application.DTOs.Reviews.ReviewDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult> Reviews(int id, [FromQuery] PaginationRequest pagination) =>
|
|
Ok(await _reviews.GetByLectureAsync(id, pagination));
|
|
}
|