serega404
6824d7ce7d
🚀 Create and publish a Docker image / Detect changes in backend and frontend (push) Successful in 9s
🚀 Create and publish a Docker image / Build & publish backend image (push) Successful in 2m6s
🚀 Create and publish a Docker image / Build & publish frontend image (push) Successful in 26s
🚀 Create and publish a Docker image / Update stack on Portainer (push) Successful in 6s
183 lines
11 KiB
C#
183 lines
11 KiB
C#
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
using UniVerse.Application.DTOs.Common;
|
|
using UniVerse.Application.DTOs.Users;
|
|
using UniVerse.Application.Interfaces;
|
|
using UniVerse.Domain.Enums;
|
|
using System.Security.Claims;
|
|
|
|
namespace UniVerse.Api.Controllers;
|
|
|
|
/// <summary>Управление пользователями, профилями и геймификацией.</summary>
|
|
[ApiController]
|
|
[Route("api/v1/users")]
|
|
[Authorize]
|
|
[Produces("application/json")]
|
|
public class UsersController : ControllerBase
|
|
{
|
|
private readonly IUserService _users;
|
|
private readonly IReviewService _reviews;
|
|
private readonly IGamificationService _gamification;
|
|
|
|
public UsersController(IUserService users, IReviewService reviews, IGamificationService gamification)
|
|
{
|
|
_users = users; _reviews = reviews; _gamification = gamification;
|
|
}
|
|
|
|
private int CurrentUserId => int.Parse(User.FindFirstValue(ClaimTypes.NameIdentifier) ?? User.FindFirstValue("sub") ?? "0");
|
|
|
|
/// <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(UserDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult<UserDto>> Get(int id) => Ok(await _users.GetByIdAsync(id));
|
|
|
|
/// <summary>Обновить профиль пользователя (displayName, avatarUrl).</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>
|
|
[HttpPut("{id:int}")]
|
|
[ProducesResponseType(typeof(UserDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult<UserDto>> Update(int id, [FromBody] UpdateUserRequest req)
|
|
{
|
|
if (CurrentUserId != id && !User.IsInRole("Admin")) return Forbid();
|
|
return Ok(await _users.UpdateProfileAsync(id, req));
|
|
}
|
|
|
|
/// <summary>Получить статистику пользователя (XP, монеты, уровень, посещения).</summary>
|
|
/// <param name="id">ID пользователя.</param>
|
|
/// <response code="200">Статистика пользователя.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="404">Пользователь не найден.</response>
|
|
[HttpGet("{id:int}/stats")]
|
|
[ProducesResponseType(typeof(UserStatsDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<ActionResult<UserStatsDto>> Stats(int id) => Ok(await _users.GetStatsAsync(id));
|
|
|
|
/// <summary>Получить список записей пользователя на лекции.</summary>
|
|
/// <remarks>Разрешено только самому пользователю или Admin.</remarks>
|
|
/// <param name="id">ID пользователя.</param>
|
|
/// <param name="pagination">Параметры пагинации.</param>
|
|
/// <response code="200">Список записей (пагинированный).</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Нет прав — только владелец или Admin.</response>
|
|
[HttpGet("{id:int}/enrollments")]
|
|
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult> Enrollments(int id, [FromQuery] PaginationRequest pagination)
|
|
{
|
|
if (CurrentUserId != id && !User.IsInRole("Admin")) return Forbid();
|
|
// Delegate to lecture service would be more proper, but returning reviews for now
|
|
return Ok();
|
|
}
|
|
|
|
/// <summary>Получить отзывы пользователя.</summary>
|
|
/// <param name="id">ID пользователя.</param>
|
|
/// <param name="pagination">Параметры пагинации.</param>
|
|
/// <response code="200">Список отзывов (пагинированный).</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
[HttpGet("{id:int}/reviews")]
|
|
[ProducesResponseType(typeof(PagedResult<UniVerse.Application.DTOs.Reviews.ReviewDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
public async Task<ActionResult> Reviews(int id, [FromQuery] PaginationRequest pagination) =>
|
|
Ok(await _reviews.GetByUserAsync(id, pagination));
|
|
|
|
/// <summary>Получить достижения пользователя.</summary>
|
|
/// <param name="id">ID пользователя.</param>
|
|
/// <response code="200">Список полученных достижений.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
[HttpGet("{id:int}/achievements")]
|
|
[ProducesResponseType(typeof(List<UniVerse.Application.DTOs.Achievements.UserAchievementDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
public async Task<ActionResult> Achievements(int id) =>
|
|
Ok(await _gamification.GetUserAchievementsAsync(id));
|
|
|
|
/// <summary>Получить историю транзакций монет пользователя.</summary>
|
|
/// <remarks>Разрешено только самому пользователю или Admin.</remarks>
|
|
/// <param name="id">ID пользователя.</param>
|
|
/// <param name="pagination">Параметры пагинации.</param>
|
|
/// <response code="200">История транзакций (пагинированная).</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Нет прав — только владелец или Admin.</response>
|
|
[HttpGet("{id:int}/transactions")]
|
|
[ProducesResponseType(typeof(PagedResult<UniVerse.Application.DTOs.Gamification.CoinTransactionDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult> Transactions(int id, [FromQuery] PaginationRequest pagination)
|
|
{
|
|
if (CurrentUserId != id && !User.IsInRole("Admin")) return Forbid();
|
|
return Ok(await _gamification.GetTransactionsAsync(id, pagination));
|
|
}
|
|
|
|
/// <summary>Получить список всех пользователей с фильтрацией и пагинацией.</summary>
|
|
/// <remarks>Только Admin.</remarks>
|
|
/// <param name="filter">Параметры фильтрации (поиск, роль, активность) и пагинации.</param>
|
|
/// <response code="200">Список пользователей (пагинированный).</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
[Authorize(Roles = "Admin")]
|
|
[HttpGet]
|
|
[ProducesResponseType(typeof(PagedResult<UserDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult> GetAll([FromQuery] UserFilterRequest filter) =>
|
|
Ok(await _users.GetAllAsync(filter));
|
|
|
|
/// <summary>Изменить набор ролей пользователя.</summary>
|
|
/// <remarks>Только Admin. Доступные роли: Student, Teacher, Admin.</remarks>
|
|
/// <param name="id">ID пользователя.</param>
|
|
/// <param name="roles">Новый набор ролей пользователя.</param>
|
|
/// <response code="204">Роли успешно изменены.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
/// <response code="404">Пользователь не найден.</response>
|
|
[Authorize(Roles = "Admin")]
|
|
[HttpPatch("{id:int}/role")]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status400BadRequest)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<IActionResult> SetRole(int id, [FromBody] IReadOnlyCollection<UserRole> roles)
|
|
{
|
|
if (roles.Count == 0)
|
|
return BadRequest("At least one role is required.");
|
|
await _users.SetRolesAsync(id, roles);
|
|
return NoContent();
|
|
}
|
|
|
|
/// <summary>Активировать или деактивировать аккаунт пользователя.</summary>
|
|
/// <remarks>Только Admin. Деактивированный пользователь не может войти в систему.</remarks>
|
|
/// <param name="id">ID пользователя.</param>
|
|
/// <param name="isActive">true — активировать, false — деактивировать.</param>
|
|
/// <response code="204">Статус успешно изменён.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
/// <response code="404">Пользователь не найден.</response>
|
|
[Authorize(Roles = "Admin")]
|
|
[HttpPatch("{id:int}/active")]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<IActionResult> SetActive(int id, [FromBody] bool isActive)
|
|
{
|
|
await _users.SetActiveAsync(id, isActive);
|
|
return NoContent();
|
|
}
|
|
}
|