using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using UniVerse.Application.DTOs.Tags;
using UniVerse.Application.Interfaces;
using UniVerse.Domain.Enums;

namespace UniVerse.Api.Controllers;

/// <summary>Управление тегами для категоризации курсов (институты, факультеты, темы и др.).</summary>
[ApiController]
[Route("api/v1/tags")]
[Authorize]
[Produces("application/json")]
public class TagsController : ControllerBase
{
    private readonly ITagService _tags;

    public TagsController(ITagService tags) => _tags = tags;

    /// <summary>Получить список тегов с опциональной фильтрацией по типу и родителю.</summary>
    /// <param name="type">Тип тега: Institute, Faculty, Subject, Organization, Topic, Other.</param>
    /// <param name="parentId">ID родительского тега (фильтрация дочерних).</param>
    /// <response code="200">Список тегов.</response>
    /// <response code="401">Требуется аутентификация.</response>
    [HttpGet]
    [ProducesResponseType(typeof(List<TagDto>), StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    public async Task<ActionResult> GetAll([FromQuery] TagType? type, [FromQuery] int? parentId) =>
        Ok(await _tags.GetAllAsync(type, parentId));

    /// <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(TagDto), StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    [ProducesResponseType(StatusCodes.Status404NotFound)]
    public async Task<ActionResult<TagDto>> Get(int id) => Ok(await _tags.GetByIdAsync(id));

    /// <summary>Получить иерархическое дерево всех тегов.</summary>
    /// <remarks>
    /// Возвращает корневые теги с вложенными дочерними тегами.
    /// Полезно для построения фильтрующих UI-компонентов.
    /// </remarks>
    /// <response code="200">Иерархический список тегов.</response>
    /// <response code="401">Требуется аутентификация.</response>
    [HttpGet("tree")]
    [ProducesResponseType(typeof(List<TagTreeDto>), StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    public async Task<ActionResult> GetTree() => Ok(await _tags.GetTreeAsync());

    /// <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(TagDto), StatusCodes.Status201Created)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    [ProducesResponseType(StatusCodes.Status403Forbidden)]
    public async Task<ActionResult<TagDto>> Create([FromBody] CreateTagRequest req) =>
        CreatedAtAction(nameof(Get), new { id = 0 }, await _tags.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(TagDto), StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    [ProducesResponseType(StatusCodes.Status403Forbidden)]
    [ProducesResponseType(StatusCodes.Status404NotFound)]
    public async Task<ActionResult<TagDto>> Update(int id, [FromBody] UpdateTagRequest req) =>
        Ok(await _tags.UpdateAsync(id, req));

    /// <summary>Удалить тег по ID.</summary>
    /// <remarks>
    /// Только Admin. Удаление тега каскадно удаляет привязки к курсам (`course_tags`).
    /// Дочерние теги остаются, но их `parentId` становится 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 _tags.DeleteAsync(id);
        return NoContent();
    }
}
