feat(автосогласование): флаг на шаге маршрута и фоновая задача по SLA

Шаг маршрута получает флаг «Автосогласование» (AutoApprove). Когда у активной
строки такого шага истекает SLA, часовая задача Hangfire принимает за
согласующего положительное решение: помечает строку, двигает очередь и
пересчитывает статус заявки — тем же набором правил, что и портал, когда решение
принимает человек (зеркало approverDecision.service.ts/decide).

Флаг не nullable, в отличие от SLA рядом: наследовать его неоткуда — у типа
заявки такого поля нет и быть не должно.

- ApprovalRow и константы статусов переехали в общий Approvals: их теперь читают
  и напоминания, и автосогласование, разъезжаться разбору одного и того же
  списка нельзя;
- SharePointClient научился MERGE'ить элементы (раньше умел только читать).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
gorbenko.pavel
2026-09-11 18:08:41 +05:00
parent e2b6227015
commit ad62ac96ac
19 changed files with 1400 additions and 25 deletions
@@ -53,6 +53,18 @@ public interface ISharePointClient
/// <summary>Элементы списка, найденного по заголовку (списки согласования ищутся именно так).</summary>
Task<IReadOnlyList<JsonElement>> GetItemsByListTitleAsync(
string siteUrl, string listTitle, string odataQuery, CancellationToken cancellationToken);
/// <summary>
/// Обновить поля элемента списка, найденного по заголовку. fields — анонимный
/// объект «внутреннее имя колонки → значение»; перечисленные колонки
/// перезаписываются, остальные остаются как были.
/// </summary>
Task UpdateItemByListTitleAsync(
string siteUrl, string listTitle, int itemId, object fields, CancellationToken cancellationToken);
/// <summary>То же по серверному относительному url списка (см. RequestType.ListId).</summary>
Task UpdateItemByListUrlAsync(
string siteUrl, string listServerRelativeUrl, int itemId, object fields, CancellationToken cancellationToken);
}
/// <summary>
@@ -208,6 +220,38 @@ public sealed class SharePointClient(
$"{siteUrl.TrimEnd('/')}/_api/web/lists/getByTitle('{Escape(listTitle)}')/items?{odataQuery}",
cancellationToken);
public Task UpdateItemByListTitleAsync(
string siteUrl, string listTitle, int itemId, object fields, CancellationToken cancellationToken) =>
MergeAsync(
siteUrl,
$"{siteUrl.TrimEnd('/')}/_api/web/lists/getByTitle('{Escape(listTitle)}')/items({itemId})",
fields,
cancellationToken);
public Task UpdateItemByListUrlAsync(
string siteUrl, string listServerRelativeUrl, int itemId, object fields, CancellationToken cancellationToken) =>
MergeAsync(
siteUrl,
$"{siteUrl.TrimEnd('/')}/_api/web/getList('{Escape(listServerRelativeUrl)}')/items({itemId})",
fields,
cancellationToken);
/// <summary>
/// Частичное обновление элемента: у SharePoint REST это POST с заголовком
/// X-HTTP-Method: MERGE (PATCH он не понимает), и обязательным If-Match.
///
/// If-Match: * — намеренно «перезаписать, чей бы ни был последний етаг», а не
/// оптимистичная блокировка по конкретной версии. Пишем мы точечно, по
/// отдельным колонкам, а единственный конкурент — человек, принявший решение
/// по тому же шагу вручную; его защищает не етаг, а проверка статуса строки
/// перед записью (см. AutoApproveService). Реальный етаг пришлось бы читать
/// отдельным запросом, и он всё равно устаревал бы к моменту записи.
/// </summary>
private Task MergeAsync(string siteUrl, string url, object fields, CancellationToken cancellationToken) =>
SendAsync(
HttpMethod.Post, siteUrl, url, JsonSerializer.Serialize(fields),
allowNotFound: false, cancellationToken, merge: true);
private async Task<IReadOnlyList<JsonElement>> GetItemsAsync(
string siteUrl, string url, CancellationToken cancellationToken)
{
@@ -240,9 +284,16 @@ public sealed class SharePointClient(
string url,
string? body,
bool allowNotFound,
CancellationToken cancellationToken)
CancellationToken cancellationToken,
bool merge = false)
{
using var request = new HttpRequestMessage(method, url);
if (merge)
{
request.Headers.Add("X-HTTP-Method", "MERGE");
request.Headers.Add("If-Match", "*");
}
request.Headers.Authorization = new AuthenticationHeaderValue(
"Bearer", await GetTokenAsync(siteUrl, cancellationToken));
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json")