Files
tnsu-approval-route/backend/tests/Tnsu.ApprovalRoute.IntegrationTests/ApplicationServices/VacancyReportServiceTests.cs
T
gorbenko.pavel 24d2cd7a6a feat: отчёт по вакансиям в xlsx за период
GET api/reports/vacancies?from=&to= отдаёт лист «Список вакансий (все)»
по образцу ручного отчёта HR: те же шестнадцать колонок, разделители по
объектам, двойная нумерация, итоги формулами.

Данные — из двух форм портала: «Заявка на подбор» даёт вакансию,
«Приём на работу» — её закрытие (связь по SelectionRequestId +
SelectionRequestListId). Рекрутёр и дата закрытия берутся из фазы
«Исполнение» парного списка «— согласование»: в самой заявке их нет.

Период отбирает заявки по «Дате подачи заявки» с откатом на Created —
поле заполняется руками и часто пустое. Заявки на приём периодом не
ограничены: приём по вакансии из начала интервала мог оформляться уже
после его конца.

Колонка «Комментарии» остаётся пустой — в ручном отчёте это пометки
рекрутёра, которым в заявках пока негде храниться.

Генерация — ClosedXML (MIT): нужны стили, формулы и autofilter, а EPPlus
с v5 под Polyform Noncommercial.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-27 18:01:24 +05:00

384 lines
17 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System.Text.Json;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging.Abstractions;
using Microsoft.Extensions.Options;
using Moq;
using Shouldly;
using Tnsu.ApprovalRoute.Application.ListPartitioning;
using Tnsu.ApprovalRoute.Application.Reports;
using Tnsu.ApprovalRoute.Application.RequestTypes;
using Tnsu.ApprovalRoute.Infrastructure.Persistence;
using Tnsu.ApprovalRoute.Infrastructure.SharePoint;
using Tnsu.ApprovalRoute.IntegrationTests.Infrastructure;
namespace Tnsu.ApprovalRoute.IntegrationTests.ApplicationServices;
/// <summary>
/// Сборка отчёта по вакансиям из трёх источников: заявка на подбор, её фаза
/// исполнения (рекрутёр и дата закрытия) и связанные заявки на приём (кого и
/// когда приняли).
///
/// SharePoint подменён моком, отдающим сырой JSON ровно в том виде, в каком его
/// возвращает REST, — так тесты заодно покрывают и разбор ответа (в частности
/// дробные «1.0» у Number-колонок).
/// </summary>
public sealed class VacancyReportServiceTests : IClassFixture<PostgresDatabaseFixture>
{
private const string SiteUrl = "https://tnsukz.sharepoint.com/sites/requests";
private const string DataListTitle = "Заявка на подбор — данные";
private const string ApprovalListTitle = "Заявка на подбор — согласование";
private static readonly DateOnly From = new(2026, 7, 1);
private static readonly DateOnly To = new(2026, 8, 31);
private readonly ServiceProvider _services;
private readonly RequestTypeService _requestTypeService;
public VacancyReportServiceTests(PostgresDatabaseFixture fixture)
{
_services = TestServiceProviderFactory.Build(fixture.ConnectionString);
_requestTypeService = _services.GetRequiredService<RequestTypeService>();
}
// База у тестов класса общая, а сервис ищет тип заявки по PageUrl — поэтому
// у каждого теста свои списки и PageUrl (оба выводятся из имени теста), и
// тесты не видят записи друг друга.
private static string SelectionListUrl(string name) => $"/sites/requests/Lists/Подбор-{name}";
private static string HireListUrl(string name) => $"/sites/requests/Lists/Приём-{name}";
private async Task CreateTypeAsync(string name, string listUrl, string pageUrl) =>
await _requestTypeService.CreateAsync(
new CreateRequestTypeRequest(name, pageUrl, listUrl, SiteUrl, "General"),
CancellationToken.None);
private static JsonElement Json(object value) => JsonSerializer.SerializeToElement(value);
/// <summary>Элемент списка «Заявка на подбор — данные» в том виде, в каком его отдаёт REST.</summary>
private static object Selection(
int id,
string position,
string? objectProject = null,
double vacancies = 1,
string? submitDate = "2026-07-08T00:00:00Z",
string? created = "2026-07-08T00:00:00Z",
string? responsible = "Ким Наталья Юрьевна",
string? openReason = null,
string? openReasonDetails = null) =>
new
{
Id = id,
RequestStatus = "Выполнение",
Position = position,
DepartmentName = "офис",
ObjectProject = objectProject,
// Number-колонка приходит дробной («1.0») — тест держит её такой же.
OpenVacanciesCount = vacancies,
SubmitDate = submitDate,
Created = created,
OpenReason = openReason,
OpenReasonDetails = openReasonDetails,
Responsible = new { Title = responsible }
};
/// <summary>Строка фазы «Исполнение» из списка «Заявка на подбор — согласование».</summary>
private static object Execution(
int ticketId,
string status = "Выполнено",
string? date = "2026-07-22T10:00:00Z",
double stepOrder = 1,
string? executor = "Сергеева Надежда Ивановна") =>
new
{
Id = ticketId * 100 + (int)stepOrder,
TicketId = ticketId,
ApprovalStatus = status,
StepOrder = stepOrder,
Date = date,
TansuSiteApprover = new { Title = executor }
};
/// <summary>
/// Элемент списка «Прием на работу — данные». selectionListUrl — партиция, в
/// которой лежит заявка на подбор: связь идёт по паре (Id, партиция), а не по
/// одному Id — в разных партициях Id повторяются.
/// </summary>
private static object Hire(
int selectionId,
string selectionListUrl,
string status = "Закрыта",
string? hireDate = "2026-08-17T00:00:00Z",
string? replaced = null) =>
new
{
Id = selectionId * 10,
RequestStatus = status,
SelectionRequestId = (double)selectionId,
SelectionRequestListId = selectionListUrl,
CandidateName = "Шакенов Анель",
ReplacedEmployee = replaced,
HireDate = hireDate
};
private async Task<(VacancyReportService Service, Mock<ISharePointClient> SharePoint)> BuildAsync(
string name,
IReadOnlyList<object> selections,
IReadOnlyList<object>? executions = null,
IReadOnlyList<object>? hires = null)
{
var selectionList = SelectionListUrl(name);
var hireList = HireListUrl(name);
var selectionPage = $"/подбор-{name}";
var hirePage = $"/приём-{name}";
await CreateTypeAsync($"Подбор {name}", selectionList, selectionPage);
await CreateTypeAsync($"Приём {name}", hireList, hirePage);
var sharePoint = new Mock<ISharePointClient>();
sharePoint
.Setup(x => x.GetItemsByListUrlAsync(
SiteUrl, selectionList, It.Is<string>(q => q.Contains("OpenVacanciesCount")),
It.IsAny<CancellationToken>()))
.ReturnsAsync(selections.Select(Json).ToList());
sharePoint
.Setup(x => x.GetListTitleAsync(SiteUrl, selectionList, It.IsAny<CancellationToken>()))
.ReturnsAsync(DataListTitle);
sharePoint
.Setup(x => x.GetItemsByListTitleAsync(
SiteUrl, ApprovalListTitle, It.Is<string>(q => q.Contains("Исполнение")),
It.IsAny<CancellationToken>()))
.ReturnsAsync((executions ?? []).Select(Json).ToList());
sharePoint
.Setup(x => x.GetItemsByListUrlAsync(
SiteUrl, hireList, It.Is<string>(q => q.Contains("SelectionRequestId")),
It.IsAny<CancellationToken>()))
.ReturnsAsync((hires ?? []).Select(Json).ToList());
var service = new VacancyReportService(
_services.GetRequiredService<ApprovalRouteDbContext>(),
sharePoint.Object,
_services.GetRequiredService<ListPartitionRegistry>(),
Options.Create(new ReportsOptions
{
RecruitingSelectionPageUrl = selectionPage,
RecruitingHirePageUrl = hirePage
}),
NullLogger<VacancyReportService>.Instance);
return (service, sharePoint);
}
private static VacancyReportRow SingleRow(VacancyReport report) =>
report.Groups.ShouldHaveSingleItem().Rows.ShouldHaveSingleItem();
[Fact(DisplayName = "Закрытая вакансия: приём даёт число закрытых, «да» и дату выхода")]
public async Task ClosedVacancy_FilledFromHire()
{
const string name = "closed";
var (service, _) = await BuildAsync(
name,
[Selection(1, "Зам нач.юр.отдела")],
[Execution(1, date: "2026-07-08T10:00:00Z")],
[Hire(1, SelectionListUrl(name))]);
var result = await service.GetAsync(From, To, CancellationToken.None);
result.IsSuccess.ShouldBeTrue();
var row = SingleRow(result.Value);
row.Position.ShouldBe("Зам нач.юр.отдела");
row.Department.ShouldBe("офис");
row.VacanciesCount.ShouldBe(1);
row.ClosedCount.ShouldBe(1);
row.ClosedFlag.ShouldBe(VacancyClosedFlags.Yes);
row.SubmitDate.ShouldBe(new DateOnly(2026, 7, 8));
row.ClosingDate.ShouldBe(new DateOnly(2026, 7, 8));
row.StartDate.ShouldBe(new DateOnly(2026, 8, 17));
row.Initiator.ShouldBe("Ким Н.Ю.");
row.Recruiter.ShouldBe("Сергеева Надежда Ивановна");
}
[Fact(DisplayName = "Приём из другой партиции не считается закрытием этой вакансии")]
public async Task Hire_FromOtherPartition_NotMatched()
{
var (service, _) = await BuildAsync(
"otherPartition",
[Selection(1, "Зам нач.юр.отдела")],
[Execution(1)],
[Hire(1, "/sites/requests/Lists/СовсемДругаяПартиция")]);
var result = await service.GetAsync(From, To, CancellationToken.None);
var row = SingleRow(result.Value);
row.ClosedCount.ShouldBe(0);
row.ClosedFlag.ShouldBe(VacancyClosedFlags.No);
row.StartDate.ShouldBeNull();
}
[Fact(DisplayName = "Частично закрытая: 2 вакансии, 1 приём → «частично»")]
public async Task PartiallyClosed()
{
const string name = "partial";
var (service, _) = await BuildAsync(
name,
[Selection(1, "Логист", vacancies: 2)],
[Execution(1, status: "На исполнении", date: null)],
[Hire(1, SelectionListUrl(name))]);
var result = await service.GetAsync(From, To, CancellationToken.None);
var row = SingleRow(result.Value);
row.VacanciesCount.ShouldBe(2);
row.ClosedCount.ShouldBe(1);
row.ClosedFlag.ShouldBe(VacancyClosedFlags.Partial);
}
[Fact(DisplayName = "Незавершённая фаза исполнения — даты закрытия нет, рекрутёр есть")]
public async Task ExecutionInProgress_NoClosingDate()
{
var (service, _) = await BuildAsync(
"inprogress",
[Selection(1, "Начальник ОИД")],
[
Execution(1, status: "Выполнено", date: "2026-07-10T00:00:00Z", stepOrder: 1),
Execution(1, status: "На исполнении", date: null, stepOrder: 2, executor: "Ким Дания Сериковна")
]);
var result = await service.GetAsync(From, To, CancellationToken.None);
var row = SingleRow(result.Value);
row.ClosingDate.ShouldBeNull();
// Рекрутёр — исполнитель ПОСЛЕДНЕГО шага: вакансию доводит он.
row.Recruiter.ShouldBe("Ким Дания Сериковна");
}
[Fact(DisplayName = "Отклонённая заявка на приём вакансию не закрывает")]
public async Task RejectedHire_DoesNotClose()
{
const string name = "rejected";
var (service, _) = await BuildAsync(
name,
[Selection(1, "Юрист")],
[Execution(1)],
[Hire(1, SelectionListUrl(name), status: "Отклонено")]);
var result = await service.GetAsync(From, To, CancellationToken.None);
var row = SingleRow(result.Value);
row.ClosedCount.ShouldBe(0);
row.ClosedFlag.ShouldBe(VacancyClosedFlags.No);
}
[Fact(DisplayName = "«Дата выхода» — самая поздняя среди нескольких приёмов")]
public async Task StartDate_IsLatestHireDate()
{
const string name = "several";
var list = SelectionListUrl(name);
var (service, _) = await BuildAsync(
name,
[Selection(1, "Разнорабочий", vacancies: 2)],
[Execution(1)],
[
Hire(1, list, hireDate: "2026-08-05T00:00:00Z"),
Hire(1, list, hireDate: "2026-08-25T00:00:00Z")
]);
var result = await service.GetAsync(From, To, CancellationToken.None);
var row = SingleRow(result.Value);
row.ClosedCount.ShouldBe(2);
row.StartDate.ShouldBe(new DateOnly(2026, 8, 25));
}
[Fact(DisplayName = "Пустая «Дата подачи заявки» — берётся дата создания элемента")]
public async Task SubmitDateEmpty_FallsBackToCreated()
{
var (service, _) = await BuildAsync(
"created",
[Selection(1, "Прораб", submitDate: null, created: "2026-07-30T09:00:00Z")]);
var result = await service.GetAsync(From, To, CancellationToken.None);
SingleRow(result.Value).SubmitDate.ShouldBe(new DateOnly(2026, 7, 30));
}
[Fact(DisplayName = "Пустое «Количество открытых вакансий» — это одна вакансия")]
public async Task VacanciesCountEmpty_IsOne()
{
var (service, _) = await BuildAsync("noCount", [Selection(1, "Фельдшер", vacancies: 0)]);
var result = await service.GetAsync(From, To, CancellationToken.None);
SingleRow(result.Value).VacanciesCount.ShouldBe(1);
}
[Fact(DisplayName = "Группировка: сначала вакансии без объекта, потом объекты по алфавиту")]
public async Task Groups_UnnamedFirstThenAlphabetical()
{
var (service, _) = await BuildAsync(
"groups",
[
Selection(1, "Оператор катка", objectProject: "КЭС КУРЧАТОВ"),
Selection(2, "Логист"),
Selection(3, "Начальник участка", objectProject: "Авиа-ангар г.Атырау")
]);
var result = await service.GetAsync(From, To, CancellationToken.None);
result.Value.Groups.Select(g => g.Name).ShouldBe(["", "Авиа-ангар г.Атырау", "КЭС КУРЧАТОВ"]);
}
[Fact(DisplayName = "«Вместо сотрудника» — из причины открытия, только при замене уволенного")]
public async Task ReplacedEmployee_OnlyForReplacementReason()
{
var (service, _) = await BuildAsync(
"replaced",
[
Selection(1, "Начальник геодезии",
openReason: "Замена уволенного сотрудника", openReasonDetails: "Серик"),
Selection(2, "Инженер ВиВ",
openReason: "Новая штатная единица", openReasonDetails: "по расширению штата")
]);
var result = await service.GetAsync(From, To, CancellationToken.None);
var rows = result.Value.Groups.ShouldHaveSingleItem().Rows;
rows.Single(r => r.Position == "Начальник геодезии").ReplacedEmployee.ShouldBe("Серик");
rows.Single(r => r.Position == "Инженер ВиВ").ReplacedEmployee.ShouldBeNull();
}
[Fact(DisplayName = "Конец периода раньше начала — ошибка, а не пустой файл")]
public async Task InvertedPeriod_Fails()
{
var (service, _) = await BuildAsync("inverted", [Selection(1, "Логист")]);
var result = await service.GetAsync(To, From, CancellationToken.None);
result.IsFailed.ShouldBeTrue();
}
[Fact(DisplayName = "Фильтр периода уходит в SharePoint с откатом на Created")]
public async Task PeriodFilter_PassedToSharePoint()
{
const string name = "filter";
var (service, sharePoint) = await BuildAsync(name, [Selection(1, "Логист")]);
await service.GetAsync(From, To, CancellationToken.None);
sharePoint.Verify(
x => x.GetItemsByListUrlAsync(
SiteUrl,
SelectionListUrl(name),
It.Is<string>(q =>
q.Contains("SubmitDate ge datetime'2026-07-01T00:00:00Z'")
// Верхняя граница — начало следующего дня и строгое lt: иначе
// заявки за сам последний день периода отсеклись бы.
&& q.Contains("SubmitDate lt datetime'2026-09-01T00:00:00Z'")
&& q.Contains("SubmitDate eq null and Created ge")),
It.IsAny<CancellationToken>()),
Times.Once);
}
}