90 lines
4.8 KiB
C#
90 lines
4.8 KiB
C#
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
using UniVerse.Application.DTOs.Locations;
|
|
using UniVerse.Application.Interfaces;
|
|
|
|
namespace UniVerse.Api.Controllers;
|
|
|
|
/// <summary>Управление локациями проведения лекций (аудитории, онлайн-площадки).</summary>
|
|
[ApiController]
|
|
[Route("api/v1/locations")]
|
|
[Authorize]
|
|
[Produces("application/json")]
|
|
public class LocationsController : ControllerBase
|
|
{
|
|
private readonly ILocationService _locations;
|
|
|
|
public LocationsController(ILocationService locations) => _locations = locations;
|
|
|
|
/// <summary>Получить список всех локаций.</summary>
|
|
/// <response code="200">Список локаций.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
[HttpGet]
|
|
[ProducesResponseType(typeof(List<LocationDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
public async Task<ActionResult> GetAll() => Ok(await _locations.GetAllAsync());
|
|
|
|
/// <summary>Получить локацию по ID.</summary>
|
|
/// <param name="id">ID локации.</param>
|
|
/// <response code="200">Данные локации.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="404">Локация не найдена.</response>
|
|
[HttpGet("{id:int}")]
|
|
[ProducesResponseType(typeof(LocationDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult<LocationDto>> Get(int id) => Ok(await _locations.GetByIdAsync(id));
|
|
|
|
/// <summary>Создать новую локацию.</summary>
|
|
/// <remarks>Только Admin. Локации также создаются автоматически при синхронизации с Modeus.</remarks>
|
|
/// <param name="req">Название, корпус, аудитория и/или адрес.</param>
|
|
/// <response code="201">Локация создана.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
[Authorize(Roles = "Admin")]
|
|
[HttpPost]
|
|
[ProducesResponseType(typeof(LocationDto), StatusCodes.Status201Created)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult<LocationDto>> Create([FromBody] CreateLocationRequest req) =>
|
|
CreatedAtAction(nameof(Get), new { id = 0 }, await _locations.CreateAsync(req));
|
|
|
|
/// <summary>Обновить локацию по ID.</summary>
|
|
/// <remarks>Только Admin.</remarks>
|
|
/// <param name="id">ID локации.</param>
|
|
/// <param name="req">Обновляемые поля: название, корпус, аудитория, адрес.</param>
|
|
/// <response code="200">Обновлённые данные локации.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
/// <response code="404">Локация не найдена.</response>
|
|
[Authorize(Roles = "Admin")]
|
|
[HttpPut("{id:int}")]
|
|
[ProducesResponseType(typeof(LocationDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult<LocationDto>> Update(int id, [FromBody] UpdateLocationRequest req) =>
|
|
Ok(await _locations.UpdateAsync(id, req));
|
|
|
|
/// <summary>Удалить локацию по ID.</summary>
|
|
/// <remarks>
|
|
/// Только Admin. При удалении локации у связанных лекций поле `locationId` становится null.
|
|
/// </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 _locations.DeleteAsync(id);
|
|
return NoContent();
|
|
}
|
|
}
|