79 lines
4.8 KiB
C#
79 lines
4.8 KiB
C#
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
using UniVerse.Application.DTOs.Sync;
|
|
using UniVerse.Application.Interfaces;
|
|
|
|
namespace UniVerse.Api.Controllers;
|
|
|
|
/// <summary>Синхронизация данных из внешней системы расписания Modeus (только Admin).</summary>
|
|
[ApiController]
|
|
[Route("api/v1/sync")]
|
|
[Authorize(Roles = "Admin")]
|
|
[Produces("application/json")]
|
|
public class SyncController : ControllerBase
|
|
{
|
|
private readonly IScheduleSyncService _sync;
|
|
|
|
public SyncController(IScheduleSyncService sync) => _sync = sync;
|
|
|
|
/// <summary>Запустить синхронизацию расписания лекций из Modeus.</summary>
|
|
/// <remarks>
|
|
/// Только Admin. Выполняет upsert лекций и связанных курсов на основе данных
|
|
/// из внешнего API `schedule.rdcenter.ru`. Поддерживает фильтрацию по специальности,
|
|
/// периоду и типу занятий.
|
|
/// </remarks>
|
|
/// <param name="req">Параметры синхронизации: specialtyCode, timeMin/timeMax, typeId.</param>
|
|
/// <response code="200">Результат синхронизации: кол-во созданных, обновлённых и пропущенных записей.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
[HttpPost("schedule")]
|
|
[ProducesResponseType(typeof(SyncResultDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult<SyncResultDto>> SyncSchedule([FromBody] SyncScheduleRequest req) =>
|
|
Ok(await _sync.SyncScheduleAsync(req));
|
|
|
|
/// <summary>Получить статус последней синхронизации.</summary>
|
|
/// <remarks>Только Admin. Возвращает время и результат последней успешной синхронизации.</remarks>
|
|
/// <response code="200">Статус синхронизации.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
[HttpGet("status")]
|
|
[ProducesResponseType(typeof(SyncStatusDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult<SyncStatusDto>> Status() =>
|
|
Ok(await _sync.GetLastSyncStatusAsync());
|
|
|
|
/// <summary>Синхронизировать аудитории (локации) из Modeus.</summary>
|
|
/// <remarks>
|
|
/// Только Admin. Импортирует аудитории из `schedule.rdcenter.ru` и создаёт
|
|
/// соответствующие записи в таблице locations.
|
|
/// </remarks>
|
|
/// <response code="200">Результат синхронизации аудиторий.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
[HttpPost("rooms")]
|
|
[ProducesResponseType(typeof(SyncResultDto), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult<SyncResultDto>> SyncRooms() =>
|
|
Ok(await _sync.SyncRoomsAsync());
|
|
|
|
/// <summary>Поиск преподавателей в Modeus по ФИО.</summary>
|
|
/// <remarks>
|
|
/// Только Admin. Ищет преподавателей через внешнее API и возвращает список
|
|
/// для ручного импорта. Найденные преподаватели не создаются автоматически.
|
|
/// </remarks>
|
|
/// <param name="fullname">Полное имя или часть имени преподавателя для поиска.</param>
|
|
/// <response code="200">Список найденных преподавателей.</response>
|
|
/// <response code="401">Требуется аутентификация.</response>
|
|
/// <response code="403">Требуется роль Admin.</response>
|
|
[HttpPost("employees")]
|
|
[ProducesResponseType(typeof(List<EmployeeDto>), StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status401Unauthorized)]
|
|
[ProducesResponseType(StatusCodes.Status403Forbidden)]
|
|
public async Task<ActionResult> SearchEmployees([FromQuery] string fullname) =>
|
|
Ok(await _sync.SearchEmployeesAsync(fullname));
|
|
}
|