feat: эндпоинт заявок по основанию (СТ/потребность) с проверкой прав на открытие

GET /api/basis-requests?requestTypeId=&basisKey= читает заявки от имени приложения по всем партициям, а по каждой проверяет, может ли вызывающий её открыть. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Персист модалок: черновики, восстановление после F5, предупреждение при выходе (#30 )
2026-10-28 09:58:42 +05:00 · 2026-10-19 04:46:16 +00:00 · 2026-10-14 05:06:58 +00:00
32 changed files with 760 additions and 109 deletions
@@ -0,0 +1,31 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Tnsu.ApprovalRoute.Api.Auth;
+using Tnsu.ApprovalRoute.Api.Common;
+using Tnsu.ApprovalRoute.Application.BasisRequests;
+
+namespace Tnsu.ApprovalRoute.Api.Controllers;
+
+/// <summary>
+/// Заявки, поданные по одному основанию (СТ, потребность). Видны все, независимо
+/// от прав вызывающего на элементы; CanOpen говорит, может ли он открыть заявку.
+/// Только пользовательский токен: без email права проверять не для кого.
+/// </summary>
+[ApiController]
+[Authorize(Policy = AuthPolicies.Delegated)]
+[Route("api/basis-requests")]
+[Produces("application/json")]
+public sealed class BasisRequestsController(BasisRequestsService service) : ControllerBase
+{
+    /// <summary>Заявки типа requestTypeId с BasisKey = basisKey по всем партициям.</summary>
+    [HttpGet]
+    [ProducesResponseType(typeof(ApiResponse<IReadOnlyList<BasisRequestDto>>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ApiError), StatusCodes.Status404NotFound)]
+    [ProducesResponseType(typeof(ApiError), StatusCodes.Status400BadRequest)]
+    public async Task<IActionResult> Get(
+        [FromQuery] int requestTypeId,
+        // string? — пустой параметр фронтенд вырезает из URL целиком (см. RequestManageController.Search).
+        [FromQuery] string? basisKey,
+        CancellationToken ct) =>
+        (await service.GetByBasisAsync(requestTypeId, basisKey ?? string.Empty, ct)).ToActionResult();
+}
@@ -2,6 +2,7 @@ using System.Reflection;
 using FluentValidation;
 using Microsoft.Extensions.DependencyInjection;
 using Tnsu.ApprovalRoute.Application.Approvals;
+using Tnsu.ApprovalRoute.Application.BasisRequests;
 using Tnsu.ApprovalRoute.Application.Reminders;
 using Tnsu.ApprovalRoute.Application.ListPartitioning;
 using Tnsu.ApprovalRoute.Application.Reports;
@@ -21,6 +22,7 @@ public static class ApplicationServiceCollectionExtensions
        services.AddScoped<RequestTypeService>();
        services.AddScoped<RequestTypeAccessService>();
        services.AddScoped<RequestManageService>();
+        services.AddScoped<BasisRequestsService>();
        services.AddScoped<ListPartitionRegistry>();
        services.AddScoped<ListPartitionService>();
        // Джоба резолвится Hangfire'ом из scope на каждое выполнение.
@@ -0,0 +1,20 @@
+namespace Tnsu.ApprovalRoute.Application.BasisRequests;
+
+/// <summary>
+/// Заявка, поданная по тому же основанию (СТ, потребность). Номер, статус и сумму
+/// видят все: от них зависит проверка «сумма оплат не больше основания». Ссылку
+/// на саму заявку фронтенд показывает только при CanOpen.
+/// </summary>
+/// <param name="Id">Id элемента списка данных.</param>
+/// <param name="ListId">Серверный относительный URL списка партиции, где лежит заявка.</param>
+/// <param name="UniqueCode">RequestUniqueCode; null — номер ещё не присвоен.</param>
+/// <param name="Status">RequestStatus заявки.</param>
+/// <param name="Amount">Сумма заявки (PayAmount).</param>
+/// <param name="CanOpen">У вызывающего есть право просмотра элемента.</param>
+public sealed record BasisRequestDto(
+    int Id,
+    string ListId,
+    string? UniqueCode,
+    string Status,
+    double Amount,
+    bool CanOpen);
@@ -0,0 +1,116 @@
+using System.Globalization;
+using System.Text.Json;
+using FluentResults;
+using Microsoft.EntityFrameworkCore;
+using Tnsu.ApprovalRoute.Application.Common.Errors;
+using Tnsu.ApprovalRoute.Application.Common.Interfaces;
+using Tnsu.ApprovalRoute.Application.ListPartitioning;
+using Tnsu.ApprovalRoute.Infrastructure.Persistence;
+using Tnsu.ApprovalRoute.Infrastructure.SharePoint;
+
+namespace Tnsu.ApprovalRoute.Application.BasisRequests;
+
+/// <summary>
+/// Заявки, поданные по одному основанию (колонка BasisKey: «ct:&lt;Id&gt;»,
+/// «need:&lt;oid&gt;») — для таблицы прежних оплат в «Заявке на оплату».
+///
+/// Читаем от имени ПРИЛОЖЕНИЯ: права на элементы заявок разорваны поштучно, и
+/// под своей учёткой заявитель видел бы только собственные заявки — сумма
+/// прежних оплат по СТ занижалась бы, а проверка превышения пропускала бы
+/// переплату. Открыть чужую заявку при этом может только тот, у кого на неё
+/// есть права: CanOpen проверяется по каждому элементу для вызывающего.
+/// </summary>
+public sealed class BasisRequestsService(
+    ApprovalRouteDbContext db,
+    ISharePointClient sharePoint,
+    ListPartitionRegistry partitionRegistry,
+    ICurrentUser currentUser)
+{
+    private const string BasisKeyField = "BasisKey";
+    private const string AmountField = "PayAmount";
+
+    // Больше по одному основанию не бывает: СТ оплачивают частями, но не сотнями.
+    private const int MaxItemsPerPartition = 500;
+
+    // Проверка прав — отдельный запрос на элемент; ограничиваем параллельность,
+    // чтобы не упереться в троттлинг SharePoint (429).
+    private const int MaxParallelPermissionChecks = 4;
+
+    public async Task<Result<IReadOnlyList<BasisRequestDto>>> GetByBasisAsync(
+        int requestTypeId, string basisKey, CancellationToken cancellationToken)
+    {
+        if (string.IsNullOrWhiteSpace(basisKey))
+            return Result.Fail<IReadOnlyList<BasisRequestDto>>(new ValidationError("Не указано основание (basisKey)."));
+
+        var requestType = await db.RequestTypes.AsNoTracking()
+            .FirstOrDefaultAsync(x => x.Id == requestTypeId, cancellationToken);
+        if (requestType is null)
+            return Result.Fail<IReadOnlyList<BasisRequestDto>>(new NotFoundError("Тип заявки", requestTypeId));
+
+        if (string.IsNullOrWhiteSpace(requestType.ListId) || string.IsNullOrWhiteSpace(requestType.SiteUrl))
+            return Result.Ok<IReadOnlyList<BasisRequestDto>>([]);
+
+        var siteUrl = requestType.SiteUrl;
+        var archived = await partitionRegistry.GetArchivedAsync(requestType, cancellationToken);
+        var current = await partitionRegistry.BuildCurrentAsync(requestType, archived, cancellationToken);
+        var listIds = archived.Select(x => x.ListId).Append(current.ListId).ToList();
+
+        // Кавычка в OData-литерале удваивается; сам литерал кодируем — в ключе бывают «:» и прочее.
+        var literal = Uri.EscapeDataString(basisKey.Trim().Replace("'", "''"));
+        var query = $"$select=Id,RequestUniqueCode,RequestStatus,{AmountField}" +
+                    $"&$filter={BasisKeyField} eq '{literal}'&$orderby=Id&$top={MaxItemsPerPartition}";
+
+        var found = new List<(JsonElement Item, string ListId)>();
+        foreach (var listId in listIds)
+        {
+            var items = await sharePoint.GetItemsByListUrlAsync(siteUrl, listId, query, cancellationToken);
+            found.AddRange(items.Select(i => (i, listId)));
+        }
+
+        var email = currentUser.Email;
+        using var gate = new SemaphoreSlim(MaxParallelPermissionChecks);
+        var result = await Task.WhenAll(found.Select(async x =>
+        {
+            var id = GetInt(x.Item, "Id") ?? 0;
+            var canOpen = false;
+            if (!string.IsNullOrWhiteSpace(email) && id > 0)
+            {
+                await gate.WaitAsync(cancellationToken);
+                try
+                {
+                    canOpen = await sharePoint.CanUserViewItemAsync(siteUrl, x.ListId, id, email, cancellationToken);
+                }
+                finally
+                {
+                    gate.Release();
+                }
+            }
+
+            return new BasisRequestDto(
+                id,
+                x.ListId,
+                GetString(x.Item, "RequestUniqueCode"),
+                GetString(x.Item, "RequestStatus") ?? string.Empty,
+                GetDouble(x.Item, AmountField) ?? 0,
+                canOpen);
+        }));
+
+        return Result.Ok<IReadOnlyList<BasisRequestDto>>(result);
+    }
+
+    private static string? GetString(JsonElement e, string name) =>
+        e.TryGetProperty(name, out var v) && v.ValueKind == JsonValueKind.String ? v.GetString() : null;
+
+    private static int? GetInt(JsonElement e, string name) =>
+        e.TryGetProperty(name, out var v) && v.ValueKind == JsonValueKind.Number && v.TryGetInt32(out var i) ? i : null;
+
+    private static double? GetDouble(JsonElement e, string name)
+    {
+        if (!e.TryGetProperty(name, out var v)) return null;
+        if (v.ValueKind == JsonValueKind.Number && v.TryGetDouble(out var d)) return d;
+        if (v.ValueKind == JsonValueKind.String &&
+            double.TryParse(v.GetString(), NumberStyles.Float, CultureInfo.InvariantCulture, out var parsed))
+            return parsed;
+        return null;
+    }
+}
@@ -0,0 +1,44 @@
+using Tnsu.ApprovalRoute.Domain.Enums;
+
+namespace Tnsu.ApprovalRoute.Application.Common;
+
+/// <summary>
+/// Русские названия типов руководителя и ролей в проекте — для всего, что видит
+/// человек: предупреждения резолва, ошибки валидации, выгрузка маршрутов. Имя
+/// enum'а («DirectionHead») в тексте для пользователя недопустимо.
+/// </summary>
+public static class StepLabels
+{
+    public static string Of(HeadType headType) => headType switch
+    {
+        HeadType.Chief => "Непосредственный руководитель",
+        HeadType.DirectionHead => "Руководитель направления",
+        HeadType.DirectorTansu => "Директор Tansu",
+        HeadType.ManagingDirectorTansu => "Управляющий директор Tansu",
+        HeadType.DepartmentHead => "Руководитель указанного отдела",
+        HeadType.CompanyDirectors => "Директора компаний инициатора",
+        _ => headType.ToString()
+    };
+
+    /// <summary>Название с маленькой буквы — для середины фразы («Не найден руководитель направления»).</summary>
+    public static string InSentence(HeadType headType) => Lower(Of(headType));
+
+    /// <summary>
+    /// Все названия мужского рода («найден руководитель проекта»), кроме «Безопасность» —
+    /// для неё нужна отдельная формулировка, иначе выйдет «найден безопасность».
+    /// </summary>
+    public static string InSentence(ProjectRole projectRole) =>
+        projectRole == ProjectRole.Security ? "сотрудник службы безопасности" : Lower(Of(projectRole));
+
+    private static string Lower(string label) => char.ToLowerInvariant(label[0]) + label[1..];
+
+    public static string Of(ProjectRole projectRole) => projectRole switch
+    {
+        ProjectRole.ProjectManager => "Руководитель проекта",
+        ProjectRole.Planner => "Планировщик",
+        ProjectRole.ManagerHSE => "Менеджер HSE",
+        ProjectRole.Security => "Безопасность",
+        ProjectRole.Keeper => "Заведующий склада",
+        _ => projectRole.ToString()
+    };
+}
@@ -1,6 +1,7 @@
 using FluentResults;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Options;
+using Tnsu.ApprovalRoute.Application.Common;
 using Tnsu.ApprovalRoute.Domain.Entities;
 using Tnsu.ApprovalRoute.Domain.Enums;
 using Tnsu.ApprovalRoute.Infrastructure.Persistence;
@@ -44,25 +45,6 @@ public sealed class RouteExportService(
        ["CompaniesJson"] = "организация"
    };

-    private static readonly Dictionary<ProjectRole, string> ProjectRoleLabels = new()
-    {
-        [ProjectRole.ProjectManager] = "Руководитель проекта",
-        [ProjectRole.Planner] = "Планировщик",
-        [ProjectRole.ManagerHSE] = "Менеджер HSE",
-        [ProjectRole.Security] = "Безопасность",
-        [ProjectRole.Keeper] = "Заведующий склада"
-    };
-
-    private static readonly Dictionary<HeadType, string> HeadTypeLabels = new()
-    {
-        [HeadType.Chief] = "Непосредственный руководитель",
-        [HeadType.DirectionHead] = "Руководитель направления",
-        [HeadType.DirectorTansu] = "Директор Tansu",
-        [HeadType.ManagingDirectorTansu] = "Управляющий директор Tansu",
-        [HeadType.DepartmentHead] = "Руководитель указанного отдела",
-        [HeadType.CompanyDirectors] = "Директора компаний инициатора"
-    };
-
    private static readonly Dictionary<ComparisonOperator, string> OperatorSymbols = new()
    {
        [ComparisonOperator.GreaterThan] = ">",
@@ -228,7 +210,7 @@ public sealed class RouteExportService(
        }

        if (step.ProjectRole is { } projectRole && projectRole != ProjectRole.None)
-            return (ProjectRoleLabels[projectRole], ByRequest, Empty);
+            return (StepLabels.Of(projectRole), ByRequest, Empty);

        if (step.HeadType is { } headType && headType != HeadType.None)
        {
@@ -240,9 +222,9 @@ public sealed class RouteExportService(
            };
            if (fixedEmail is not null)
                // Нет в справочнике — лучше показать email, чем пустую ячейку.
-                return (HeadTypeLabels[headType], directory.FindByEmail(fixedEmail)?.Fio ?? fixedEmail, directory.CompaniesOf(fixedEmail));
+                return (StepLabels.Of(headType), directory.FindByEmail(fixedEmail)?.Fio ?? fixedEmail, directory.CompaniesOf(fixedEmail));

-            return (HeadTypeLabels[headType], ByRequest, Empty);
+            return (StepLabels.Of(headType), ByRequest, Empty);
        }

        return (Empty, Empty, Empty);
@@ -1,6 +1,7 @@
 using FluentResults;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Logging;
+using Tnsu.ApprovalRoute.Application.Common;
 using Tnsu.ApprovalRoute.Application.Common.Errors;
 using Tnsu.ApprovalRoute.Application.Common.Interfaces;
 using Tnsu.ApprovalRoute.Domain.Entities;
@@ -82,7 +83,7 @@ public sealed class TemplateRouteStepService(

        if (await HasDuplicateHeadTypeAsync(route.Id, r.HeadType, r.Conditions, r.ConditionsLogic, excludeId: null, cancellationToken))
            return Result.Fail<TemplateRouteStepDto>(new ConflictError(
-                $"В маршруте уже есть шаг с типом руководителя «{r.HeadType}» и таким же условием появления — второй такой шаг недопустим."));
+                $"В маршруте уже есть шаг с типом руководителя «{StepLabels.Of(r.HeadType!.Value)}» и таким же условием появления — второй такой шаг недопустим."));

        var entity = new TemplateRouteStep
        {
@@ -141,7 +142,7 @@ public sealed class TemplateRouteStepService(

        if (await HasDuplicateHeadTypeAsync(route.Id, r.HeadType, r.Conditions, r.ConditionsLogic, excludeId: entity.Id, cancellationToken))
            return Result.Fail<TemplateRouteStepDto>(new ConflictError(
-                $"В маршруте уже есть шаг с типом руководителя «{r.HeadType}» и таким же условием появления — второй такой шаг недопустим."));
+                $"В маршруте уже есть шаг с типом руководителя «{StepLabels.Of(r.HeadType!.Value)}» и таким же условием появления — второй такой шаг недопустим."));

        entity.OrderNo = r.OrderNo;
        entity.ExecutorEmail = r.ExecutorEmail;
@@ -210,7 +211,7 @@ public sealed class TemplateRouteStepService(

        if (await HasDuplicateHeadTypeAsync(route.Id, headType, conditions, conditionsLogic, excludeId: entity.Id, cancellationToken))
            return Result.Fail<TemplateRouteStepDto>(new ConflictError(
-                $"В маршруте уже есть шаг с типом руководителя «{headType}» и таким же условием появления — второй такой шаг недопустим."));
+                $"В маршруте уже есть шаг с типом руководителя «{StepLabels.Of(headType!.Value)}» и таким же условием появления — второй такой шаг недопустим."));

        entity.OrderNo = r.OrderNo ?? entity.OrderNo;
        entity.ExecutorEmail = executorEmail;
@@ -3,6 +3,7 @@ using FluentResults;
 using Microsoft.EntityFrameworkCore;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
+using Tnsu.ApprovalRoute.Application.Common;
 using Tnsu.ApprovalRoute.Application.Common.Errors;
 using Tnsu.ApprovalRoute.Application.Common.Interfaces;
 using Tnsu.ApprovalRoute.Domain.Entities;
@@ -437,7 +438,7 @@ public sealed class TemplateRouteService(
        {
            resolvedEmail = projectExecutors.FirstOrDefault(e => e.ProjectRole == step.ProjectRole)?.Email;
            if (string.IsNullOrWhiteSpace(resolvedEmail))
-                warning = $"Не найден исполнитель с ролью в проекте «{step.ProjectRole}».";
+                warning = $"В проекте не найден {StepLabels.InSentence(step.ProjectRole.Value)}.";
        }
        // DepartmentHead — единственный HeadType, который резолвится НЕ по цепочке
        // подчинённости инициатора, а по отделу, переданному явно в запросе (см.
@@ -469,7 +470,14 @@ public sealed class TemplateRouteService(
                _ => null
            };
            if (string.IsNullOrWhiteSpace(resolvedEmail))
-                warning = $"Не найден руководитель типа «{step.HeadType}».";
+            {
+                var headLabel = StepLabels.InSentence(step.HeadType.Value);
+                // Директор Tansu и управляющий директор берутся из настроек сервиса, а не из
+                // справочника сотрудников — там email не «не найден», а «не проставлен».
+                warning = step.HeadType is HeadType.DirectorTansu or HeadType.ManagingDirectorTansu
+                    ? $"Не проставлен {headLabel}."
+                    : $"Не найден {headLabel}.";
+            }
        }
        else
        {
@@ -612,7 +620,7 @@ public sealed class TemplateRouteService(
            else if (existing.PositionCode is not null && step.PositionCode is not null && existing.PositionCode != step.PositionCode)
            {
                var conflictWarning =
-                    $"Исполнитель «{step.ExecutorEmail}» получен через разные роли шага ({existing.PositionCode} и {step.PositionCode}) — оставлен {existing.PositionCode}.";
+                    $"Исполнитель «{step.ExecutorEmail}» получен через разные роли шага ({StepLabels.Of(existing.PositionCode.Value)} и {StepLabels.Of(step.PositionCode.Value)}) — оставлен «{StepLabels.Of(existing.PositionCode.Value)}».";
                var combinedWarning = string.Join(" ", new[] { existing.Warning, conflictWarning }
                    .Where(w => !string.IsNullOrWhiteSpace(w)));
                result[index] = existing with { Warning = combinedWarning };
@@ -54,6 +54,14 @@ public interface ISharePointClient
    Task<IReadOnlyList<JsonElement>> GetItemsByListTitleAsync(
        string siteUrl, string listTitle, string odataQuery, CancellationToken cancellationToken);

+    /// <summary>
+    /// Может ли пользователь (по email) открыть элемент списка: эффективные права
+    /// человека на элемент с учётом разорванного наследования, флаг ViewListItems.
+    /// Неизвестный SharePoint логин — не ошибка, а «прав нет».
+    /// </summary>
+    Task<bool> CanUserViewItemAsync(
+        string siteUrl, string listServerRelativeUrl, int itemId, string userEmail, CancellationToken cancellationToken);
+
    /// <summary>
    /// Запрос в SharePoint Search (postquery) от имени приложения — видит ВСЕ
    /// элементы, а не только доступные пользователю. Возвращает строки результата
@@ -229,6 +237,22 @@ public sealed class SharePointClient(
            $"{siteUrl.TrimEnd('/')}/_api/web/lists/getByTitle('{Escape(listTitle)}')/items?{odataQuery}",
            cancellationToken);

+    public async Task<bool> CanUserViewItemAsync(
+        string siteUrl, string listServerRelativeUrl, int itemId, string userEmail, CancellationToken cancellationToken)
+    {
+        // Claims-логин Entra ID в SharePoint Online. Передаём через параметр-псевдоним
+        // @u: в пути функции «|» и «#» SharePoint не разбирает.
+        var login = Uri.EscapeDataString($"i:0#.f|membership|{userEmail.Trim().ToLowerInvariant()}");
+        var url = $"{siteUrl.TrimEnd('/')}/_api/web/getList('{Escape(listServerRelativeUrl)}')/items({itemId})" +
+                  $"/getUserEffectivePermissions(@u)?@u='{login}'";
+        var json = await GetAsync(siteUrl, url, cancellationToken);
+
+        // BasePermissions приходит как {High, Low} — числа строками. ViewListItems — бит 0x1 в Low.
+        return json.TryGetProperty("Low", out var low)
+               && ulong.TryParse(low.ValueKind == JsonValueKind.String ? low.GetString() : low.GetRawText(), out var bits)
+               && (bits & ViewListItemsMask) != 0;
+    }
+
    public async Task<IReadOnlyList<IReadOnlyDictionary<string, string?>>> SearchAsync(
        string siteUrl, string queryText, IReadOnlyList<string> selectProperties, CancellationToken cancellationToken)
    {
@@ -426,6 +450,8 @@ public sealed class SharePointClient(
        }
    }

+    private const ulong ViewListItemsMask = 0x1;
+
    // Одинарная кавычка в OData-литерале экранируется её удвоением. Заголовки
    // списков содержат тире и кириллицу, но кавычка теоретически возможна —
    // без экранирования она сломала бы запрос.
@@ -0,0 +1,91 @@
+using System.Text.Json;
+using Microsoft.Extensions.DependencyInjection;
+using Moq;
+using Shouldly;
+using Tnsu.ApprovalRoute.Application.BasisRequests;
+using Tnsu.ApprovalRoute.Application.ListPartitioning;
+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>
+/// Заявки по одному основанию: видны все (чтение от имени приложения), а
+/// CanOpen — только там, где у вызывающего есть права на элемент.
+/// </summary>
+public sealed class BasisRequestsServiceTests : IClassFixture<PostgresDatabaseFixture>
+{
+    private const string SiteUrl = "https://tnsukz.sharepoint.com/sites/requests";
+    private const string CallerEmail = "initiator@tnsu.kz";
+    private const string BasisKey = "need:8028c7ac-ac23-8dd8-11f0-946facc42464";
+
+    private readonly ServiceProvider _services;
+
+    public BasisRequestsServiceTests(PostgresDatabaseFixture fixture)
+    {
+        _services = TestServiceProviderFactory.Build(fixture.ConnectionString, CallerEmail);
+    }
+
+    private static JsonElement Json(object value) => JsonSerializer.SerializeToElement(value);
+
+    private async Task<(BasisRequestsService Service, Mock<ISharePointClient> SharePoint, int TypeId)> BuildAsync(
+        string name, string listUrl, IReadOnlyList<object> items, IReadOnlySet<int> openableIds)
+    {
+        var type = await _services.GetRequiredService<RequestTypeService>().CreateAsync(
+            new CreateRequestTypeRequest($"Оплата {name}", $"/оплата-{name}", listUrl, SiteUrl, "General"),
+            CancellationToken.None);
+
+        var sharePoint = new Mock<ISharePointClient>();
+        sharePoint
+            .Setup(x => x.GetItemsByListUrlAsync(SiteUrl, listUrl, It.IsAny<string>(), It.IsAny<CancellationToken>()))
+            .ReturnsAsync(items.Select(Json).ToList());
+        sharePoint
+            .Setup(x => x.CanUserViewItemAsync(SiteUrl, listUrl, It.IsAny<int>(), CallerEmail, It.IsAny<CancellationToken>()))
+            .ReturnsAsync((string _, string _, int id, string _, CancellationToken _) => openableIds.Contains(id));
+
+        var service = new BasisRequestsService(
+            _services.GetRequiredService<ApprovalRouteDbContext>(),
+            sharePoint.Object,
+            _services.GetRequiredService<ListPartitionRegistry>(),
+            new TestCurrentUser(CallerEmail));
+
+        return (service, sharePoint, type.Value.Id);
+    }
+
+    [Fact]
+    public async Task Returns_all_requests_and_marks_only_permitted_as_openable()
+    {
+        const string list = "/sites/requests/Lists/Оплата-all";
+        var (service, sharePoint, typeId) = await BuildAsync("all", list,
+        [
+            // Number-колонка приходит дробной («50000.0») — тест держит её такой же.
+            new { Id = 1, RequestUniqueCode = "24-2610-1", RequestStatus = "Согласовано", PayAmount = 50000.0 },
+            new { Id = 2, RequestUniqueCode = "24-2610-2", RequestStatus = "На согласовании", PayAmount = 35000.5 }
+        ], new HashSet<int> { 2 });
+
+        var result = await service.GetByBasisAsync(typeId, BasisKey, CancellationToken.None);
+
+        result.IsSuccess.ShouldBeTrue();
+        result.Value.Count.ShouldBe(2);
+        result.Value.Single(x => x.Id == 1).ShouldBe(new BasisRequestDto(1, list, "24-2610-1", "Согласовано", 50000, false));
+        result.Value.Single(x => x.Id == 2).ShouldBe(new BasisRequestDto(2, list, "24-2610-2", "На согласовании", 35000.5, true));
+
+        // Фильтр по основанию уходит в SharePoint, а не применяется в памяти.
+        sharePoint.Verify(x => x.GetItemsByListUrlAsync(
+            SiteUrl, list,
+            It.Is<string>(q => q.Contains("BasisKey eq 'need%3A8028c7ac-ac23-8dd8-11f0-946facc42464'")),
+            It.IsAny<CancellationToken>()), Times.Once);
+    }
+
+    [Fact]
+    public async Task Empty_basis_key_is_a_validation_error()
+    {
+        var (service, _, typeId) = await BuildAsync("empty", "/sites/requests/Lists/Оплата-empty", [], new HashSet<int>());
+
+        var result = await service.GetByBasisAsync(typeId, "  ", CancellationToken.None);
+
+        result.IsFailed.ShouldBeTrue();
+    }
+}
@@ -361,8 +361,9 @@ public sealed class TemplateRouteServiceTests : IClassFixture<PostgresDatabaseFi
        resolved.Value.Steps[0].PositionCode.ShouldBe(HeadType.Chief);
        var warning = resolved.Value.Steps[0].Warning;
        warning.ShouldNotBeNull();
-        warning.ShouldContain("Chief");
-        warning.ShouldContain("DirectionHead");
+        warning.ShouldContain("Непосредственный руководитель");
+        warning.ShouldContain("Руководитель направления");
+        warning.ShouldNotContain("DirectionHead");
    }

    [Fact(DisplayName = "Резолв маршрута с шагом «Руководитель указанного отдела» без departmentId в запросе — маршрут формируется, шаг с предупреждением")]
@@ -1050,7 +1051,7 @@ public sealed class TemplateRouteServiceTests : IClassFixture<PostgresDatabaseFi
        resolved.Value.Steps[0].ExecutorEmail.ShouldBeNull();
        var warning = resolved.Value.Steps[0].Warning;
        warning.ShouldNotBeNull();
-        warning.ShouldContain("руководитель");
+        warning.ShouldBe("Не найден непосредственный руководитель.");
    }

    [Fact(DisplayName = "Резолв шага с должностью возвращает warning, если сотрудник по должности не найден")]
@@ -1108,7 +1109,7 @@ public sealed class TemplateRouteServiceTests : IClassFixture<PostgresDatabaseFi
        resolved.Value.Steps[0].ExecutorEmail.ShouldBeNull();
        var warning = resolved.Value.Steps[0].Warning;
        warning.ShouldNotBeNull();
-        warning.ShouldContain("роль");
+        warning.ShouldBe("В проекте не найден сотрудник службы безопасности.");
    }

    [Fact(DisplayName = "Резолв маршрута откатывается на маршрут без отдела, если точного совпадения по отделу нет")]
@@ -74,6 +74,11 @@ export const ManageRequestsApproverModal: React.FC<IManageRequestsApproverModalP
  const excludedSet = new Set(excludedEmails.map(e => e.toLowerCase()));
  const selectableEmployees = employees.filter(e => !excludedSet.has(e.email.toLowerCase()));

+  const isDirty =
+    email !== initialEmail ||
+    slaHours !== slaHoursToInput(initialSlaHours) ||
+    askOverdueReason !== boolToTriState(initialAskOverdueReason);
+
  const handleSubmit = (): void => {
    const trimmedEmail = email.trim();
    if (!trimmedEmail) {
@@ -95,7 +100,7 @@ export const ManageRequestsApproverModal: React.FC<IManageRequestsApproverModalP
  };

  return (
-    <FormModal title={title} error={submit.error} isSaving={submit.isBusy} onSubmit={handleSubmit} onClose={onClose}>
+    <FormModal title={title} error={submit.error} isSaving={submit.isBusy} onSubmit={handleSubmit} onClose={onClose} isDirty={isDirty}>
      <FormGrid>
        <Field label={texts.manageRequests.approverLabel} required full>
          <SearchableSelect
@@ -9,6 +9,8 @@ import { usePortalEmployees } from '../../hooks/usePortalEmployees';
 import { useAsyncSubmit } from '../../hooks/useAsyncSubmit';
 import { useDeleteTarget } from '../../hooks/useDeleteTarget';
 import { useLocalStorageState } from '../../hooks/useLocalStorageState';
+import { useFormDraft } from '../../hooks/useFormDraft';
+import { usePersistedOpen } from '../../hooks/usePersistedOpen';
 import { toEmployeeOption } from '../../utils/employee';
 import { replaceRoute } from '../../routing';
 import { RequestTypeAccess } from '../../models';
@@ -41,6 +43,17 @@ export interface IRequestTypeAccessScreenProps {
 const ACCESS_FILTER_TYPE_STORAGE_KEY = 'approvalAdmin.accessFilterRequestTypeId';
 const ACCESS_FILTER_EMAIL_STORAGE_KEY = 'approvalAdmin.accessFilterEmail';

+/** Черновик формы выдачи доступа — переживает закрытие модалки, см. useFormDraft. */
+const CREATE_DRAFT_STORAGE_KEY = 'approvalAdmin.draft.requestTypeAccess';
+const CREATE_OPEN_STORAGE_KEY = 'approvalAdmin.draftOpen.requestTypeAccess';
+
+interface IFormState {
+  requestTypeId: string;
+  emails: string[];
+}
+
+const EMPTY_FORM: IFormState = { requestTypeId: '', emails: [] };
+
 export const RequestTypeAccessScreen: React.FC<IRequestTypeAccessScreenProps> = ({
  api,
  dictionary,
@@ -51,9 +64,11 @@ export const RequestTypeAccessScreen: React.FC<IRequestTypeAccessScreenProps> =
  const access = useRequestTypeAccess(api);
  const employees = usePortalEmployees(dictionary);

-  const [showForm, setShowForm] = React.useState(false);
-  const [requestTypeId, setRequestTypeId] = React.useState('');
-  const [emails, setEmails] = React.useState<string[]>([]);
+  const createOpen = usePersistedOpen(CREATE_OPEN_STORAGE_KEY);
+  const draft = useFormDraft<IFormState>(CREATE_DRAFT_STORAGE_KEY, EMPTY_FORM);
+  const { requestTypeId, emails } = draft.value;
+  const setEmails = (update: (current: string[]) => string[]): void =>
+    draft.setValue(f => ({ ...f, emails: update(f.emails) }));
  const submit = useAsyncSubmit();

  const [filterRequestTypeId, setFilterRequestTypeId] = useLocalStorageState(ACCESS_FILTER_TYPE_STORAGE_KEY, '');
@@ -96,9 +111,7 @@ export const RequestTypeAccessScreen: React.FC<IRequestTypeAccessScreenProps> =
      : item.sharePointLists.map(l => l.title ?? l.listId).join(', ');

  const openCreate = (): void => {
-    setRequestTypeId('');
-    setEmails([]);
-    setShowForm(true);
+    createOpen.open();
  };

  const submitForm = (): void => {
@@ -128,10 +141,11 @@ export const RequestTypeAccessScreen: React.FC<IRequestTypeAccessScreenProps> =

      if (failedEmails.length < emails.length) access.reload();
      if (failures.length === 0) {
-        setShowForm(false);
+        draft.reset();
+        createOpen.close();
        return;
      }
-      setEmails(failedEmails);
+      setEmails(() => failedEmails);
      throw new Error(texts.requestTypeAccess.createFailed(failures));
    });
  };
@@ -228,13 +242,15 @@ export const RequestTypeAccessScreen: React.FC<IRequestTypeAccessScreenProps> =
        }
      />

-      {showForm && (
+      {createOpen.isOpen && (
        <FormModal
          title={texts.requestTypeAccess.createTitle}
          error={submit.error}
          isSaving={submit.isBusy}
          onSubmit={submitForm}
-          onClose={() => setShowForm(false)}
+          onClose={createOpen.close}
+          onReset={draft.reset}
+          canReset={draft.isDirty}
        >
          <FormGrid>
            <Field label={texts.requestTypeAccess.requestTypeLabel} required full>
@@ -242,7 +258,7 @@ export const RequestTypeAccessScreen: React.FC<IRequestTypeAccessScreenProps> =
                options={requestTypes.items.map(rt => ({ value: String(rt.id), label: rt.name }))}
                placeholder={texts.requestTypeAccess.requestTypePlaceholder}
                value={requestTypeId}
-                onChange={e => setRequestTypeId(e.target.value)}
+                onChange={e => draft.setValue(f => ({ ...f, requestTypeId: e.target.value }))}
              />
            </Field>
            <Field label={texts.requestTypeAccess.emailLabel} required full>
@@ -19,6 +19,8 @@ import { useSharePointSiteTitle } from '../../hooks/useSharePointSiteTitle';
 import { useSharePointListTitle } from '../../hooks/useSharePointListTitle';
 import { useAsyncSubmit } from '../../hooks/useAsyncSubmit';
 import { useDeleteTarget } from '../../hooks/useDeleteTarget';
+import { useFormDraft } from '../../hooks/useFormDraft';
+import { usePersistedOpen } from '../../hooks/usePersistedOpen';
 import {
  ActionsCell,
  Alert,
@@ -57,6 +59,22 @@ const EMPTY_FORM: IFormState = {
  name: '', pageUrl: '', section: '', siteUrl: '', listId: '', slaHours: '', askOverdueReason: ''
 };

+/** Черновик формы создания — переживает закрытие модалки, см. useFormDraft. */
+const CREATE_DRAFT_STORAGE_KEY = 'approvalAdmin.draft.requestType';
+const CREATE_OPEN_STORAGE_KEY = 'approvalAdmin.draftOpen.requestType';
+
+function toFormState(item: RequestType): IFormState {
+  return {
+    name: item.name,
+    pageUrl: item.pageUrl,
+    section: item.section,
+    siteUrl: item.siteUrl ?? '',
+    listId: item.listId ?? '',
+    slaHours: slaHoursToInput(item.slaHours),
+    askOverdueReason: boolToTriState(item.askOverdueReason)
+  };
+}
+
 // siteUrl/listId — поля RequestType, зеркалящие nullable JSON-контракт бэкенда
 // (см. models/requestTypes.ts) — здесь сразу приводим null к undefined,
 // внутренний код (хуки/кэш SharePointListsClient) с null не работает нигде.
@@ -78,8 +96,18 @@ export const RequestTypesScreen: React.FC<IRequestTypesScreenProps> = ({ api, sh
  const list = useRequestTypes(api);

  const [editing, setEditing] = React.useState<RequestType | undefined>();
+  // showForm — только редактирование; окно создания восстанавливается после F5 (usePersistedOpen).
  const [showForm, setShowForm] = React.useState(false);
-  const [form, setForm] = React.useState<IFormState>(EMPTY_FORM);
+  const createOpen = usePersistedOpen(CREATE_OPEN_STORAGE_KEY);
+  const closeForm = (): void => {
+    setShowForm(false);
+    createOpen.close();
+  };
+  const draft = useFormDraft<IFormState>(CREATE_DRAFT_STORAGE_KEY, EMPTY_FORM);
+  const [editForm, setEditForm] = React.useState<IFormState>(EMPTY_FORM);
+  const form = editing ? editForm : draft.value;
+  const isEditDirty = Boolean(editing) && JSON.stringify(editForm) !== JSON.stringify(toFormState(editing as RequestType));
+  const setForm = editing ? setEditForm : draft.setValue;
  const submit = useAsyncSubmit();
  const sharePointLists = useSharePointLists(sharePoint, form.siteUrl);
  const siteTitle = useSharePointSiteTitle(sharePoint, form.siteUrl);
@@ -92,21 +120,14 @@ export const RequestTypesScreen: React.FC<IRequestTypesScreenProps> = ({ api, sh

  const openCreate = (): void => {
    setEditing(undefined);
-    setForm(EMPTY_FORM);
-    setShowForm(true);
+    setShowForm(false);
+    createOpen.open();
  };

  const openEdit = (item: RequestType): void => {
    setEditing(item);
-    setForm({
-      name: item.name,
-      pageUrl: item.pageUrl,
-      section: item.section,
-      siteUrl: item.siteUrl ?? '',
-      listId: item.listId ?? '',
-      slaHours: slaHoursToInput(item.slaHours),
-      askOverdueReason: boolToTriState(item.askOverdueReason)
-    });
+    setEditForm(toFormState(item));
+    createOpen.close();
    setShowForm(true);
  };

@@ -143,7 +164,8 @@ export const RequestTypesScreen: React.FC<IRequestTypesScreenProps> = ({ api, sh

    submit.run(() =>
      request.then(() => {
-        setShowForm(false);
+        if (!editing) draft.reset();
+        closeForm();
        list.reload();
      })
    );
@@ -192,13 +214,16 @@ export const RequestTypesScreen: React.FC<IRequestTypesScreenProps> = ({ api, sh
        emptyMessage={list.isLoading ? texts.common.loading : texts.requestTypes.emptyList}
      />

-      {showForm && (
+      {(showForm || createOpen.isOpen) && (
        <FormModal
          title={editing ? texts.requestTypes.editTitle : texts.requestTypes.createTitle}
          error={submit.error}
          isSaving={submit.isBusy}
          onSubmit={submitForm}
-          onClose={() => setShowForm(false)}
+          onClose={closeForm}
+          onReset={editing ? undefined : draft.reset}
+          canReset={draft.isDirty}
+          isDirty={isEditDirty}
        >
          <FormGrid>
            <Field label={texts.requestTypes.nameLabel} required full>
@@ -2,6 +2,7 @@ import * as React from 'react';
 import { Company, Department, RequestType, TemplateRoute } from '../../models';
 import { texts } from '../../texts';
 import { useAsyncSubmit } from '../../hooks/useAsyncSubmit';
+import { useFormDraft } from '../../hooks/useFormDraft';
 import { ApprovalRouteApi } from '../../services/api';
 import { Checkbox, Field, FormGrid, FormModal, SearchableSelect, Select } from '../ui';

@@ -27,6 +28,9 @@ interface IFormState {
  requiresControl: boolean;
 }

+/** Черновик формы создания — переживает закрытие модалки, см. useFormDraft. */
+const CREATE_DRAFT_STORAGE_KEY = 'approvalAdmin.draft.route';
+
 function toFormState(editing: TemplateRoute | undefined, initialRequestTypeId: string): IFormState {
  if (!editing) {
    return {
@@ -58,7 +62,10 @@ export const RouteFormModal: React.FC<IRouteFormModalProps> = ({
  onSaved,
  onClose
 }) => {
-  const [form, setForm] = React.useState<IFormState>(() => toFormState(editing, initialRequestTypeId));
+  // Редактирование не персистим — форма всегда открывается с данными маршрута с сервера.
+  const draft = useFormDraft<IFormState>(editing ? undefined : CREATE_DRAFT_STORAGE_KEY, toFormState(editing, initialRequestTypeId));
+  const form = draft.value;
+  const setForm = draft.setValue;
  const submit = useAsyncSubmit();

  // Отдел принадлежит компании, поэтому список сужаем под выбранную:
@@ -93,6 +100,7 @@ export const RouteFormModal: React.FC<IRouteFormModalProps> = ({

    submit.run(() =>
      request.then(() => {
+        draft.reset();
        onSaved();
        onClose();
      })
@@ -106,6 +114,9 @@ export const RouteFormModal: React.FC<IRouteFormModalProps> = ({
      isSaving={submit.isBusy}
      onSubmit={submitForm}
      onClose={onClose}
+      onReset={editing ? undefined : draft.reset}
+      canReset={draft.isDirty}
+      isDirty={Boolean(editing) && draft.isDirty}
    >
      <FormGrid>
        <Field label={texts.routes.requestTypeLabel} required full>
@@ -24,6 +24,7 @@ import {
 import { detectExecutorKind } from '../../utils/stepExecutor';
 import { matchEmployeesByPosition, toEmployeeOption } from '../../utils/employee';
 import { useAsyncSubmit } from '../../hooks/useAsyncSubmit';
+import { useFormDraft } from '../../hooks/useFormDraft';
 import { useSharePointFields } from '../../hooks/useSharePointFields';
 import { ApprovalRouteApi } from '../../services/api';
 import { isNumericFieldType, SharePointListsClient } from '../../services/sharePointLists';
@@ -119,6 +120,9 @@ const IS_MANAGER_VALUE_OPTIONS = [
  { value: 'false', label: texts.common.no }
 ];

+/** Черновик формы создания шага — свой у каждого маршрута, переживает закрытие модалки (см. useFormDraft). */
+const createDraftStorageKey = (routeId: number): string => `approvalAdmin.draft.routeStep.${routeId}`;
+
 function toFormState(editing: TemplateRouteStep | undefined, nextOrderNo: number): IFormState {
  if (!editing) {
    return {
@@ -170,7 +174,10 @@ export const RouteStepFormModal: React.FC<IRouteStepFormModalProps> = ({
  onSaved,
  onClose
 }) => {
-  const [form, setForm] = React.useState<IFormState>(() => toFormState(editing, nextOrderNo));
+  // Редактирование не персистим — форма всегда открывается с данными шага с сервера.
+  const draft = useFormDraft<IFormState>(editing ? undefined : createDraftStorageKey(route.id), toFormState(editing, nextOrderNo));
+  const form = draft.value;
+  const setForm = draft.setValue;
  const submit = useAsyncSubmit();
  const hasListId = Boolean(requestType?.listId);
  const sharePointFields = useSharePointFields(sharePoint, requestType?.siteUrl ?? undefined, requestType?.listId ?? undefined);
@@ -400,6 +407,7 @@ export const RouteStepFormModal: React.FC<IRouteStepFormModalProps> = ({

    submit.run(() =>
      request.then(step => {
+        draft.reset();
        onSaved(step);
        onClose();
      })
@@ -413,6 +421,9 @@ export const RouteStepFormModal: React.FC<IRouteStepFormModalProps> = ({
      isSaving={submit.isBusy}
      onSubmit={submitForm}
      onClose={onClose}
+      onReset={editing ? undefined : draft.reset}
+      canReset={draft.isDirty}
+      isDirty={Boolean(editing) && draft.isDirty}
    >
      <FormGrid>
        <Field label={texts.routeSteps.orderNoLabel} required>
@@ -13,6 +13,7 @@ import { blockIndexOf, blockRanges, markParallel, withOrdersFrom } from '../../u
 import { reportError } from '../../utils/errors';
 import { useRouteSteps } from '../../hooks/useRouteSteps';
 import { useDeleteTarget } from '../../hooks/useDeleteTarget';
+import { usePersistedOpen } from '../../hooks/usePersistedOpen';
 import { usePortalEmployees } from '../../hooks/usePortalEmployees';
 import { usePortalDictionaries } from '../../hooks/usePortalDictionaries';
 import {
@@ -53,7 +54,14 @@ export const RouteStepsScreen: React.FC<IRouteStepsScreenProps> = ({ api, route,
  const requestTypeName = requestType?.name ?? `#${route.requestTypeId}`;

  const [editing, setEditing] = React.useState<TemplateRouteStep | undefined>();
+  // showForm — только редактирование; окно создания восстанавливается после F5 (usePersistedOpen),
+  // ключ свой у каждого маршрута — как и у черновика (см. RouteStepFormModal).
  const [showForm, setShowForm] = React.useState(false);
+  const createOpen = usePersistedOpen(`approvalAdmin.draftOpen.routeStep.${route.id}`);
+  const closeForm = (): void => {
+    setShowForm(false);
+    createOpen.close();
+  };

  const deleteTarget = useDeleteTarget<TemplateRouteStep>(
    item => api.templateRouteSteps.remove(route.id, item.id),
@@ -71,11 +79,13 @@ export const RouteStepsScreen: React.FC<IRouteStepsScreenProps> = ({ api, route,

  const openCreate = (): void => {
    setEditing(undefined);
-    setShowForm(true);
+    setShowForm(false);
+    createOpen.open();
  };

  const openEdit = (item: TemplateRouteStep): void => {
    setEditing(item);
+    createOpen.close();
    setShowForm(true);
  };

@@ -278,7 +288,7 @@ export const RouteStepsScreen: React.FC<IRouteStepsScreenProps> = ({ api, route,
        </div>
      )}

-      {showForm && (
+      {(showForm || createOpen.isOpen) && (
        <RouteStepFormModal
          // Undefined, если у маршрута компания не задана (запасной маршрут,
          // применяется к любой компании инициатора) — тогда подсказка
@@ -293,7 +303,7 @@ export const RouteStepsScreen: React.FC<IRouteStepsScreenProps> = ({ api, route,
          employees={employees.items}
          employeesLoading={employees.isLoading}
          onSaved={handleSaved}
-          onClose={() => setShowForm(false)}
+          onClose={closeForm}
        />
      )}

@@ -11,6 +11,7 @@ import { useRequestTypes } from '../../hooks/useRequestTypes';
 import { useTemplateRoutes } from '../../hooks/useTemplateRoutes';
 import { usePortalDictionaries } from '../../hooks/usePortalDictionaries';
 import { useDeleteTarget } from '../../hooks/useDeleteTarget';
+import { usePersistedOpen } from '../../hooks/usePersistedOpen';
 import { useLocalStorageState } from '../../hooks/useLocalStorageState';
 import { replaceRoute } from '../../routing';
 import {
@@ -39,6 +40,8 @@ export interface IRoutesScreenProps {
 // Фильтр по типу заявки переживает перезагрузку: администратор обычно работает
 // с одним типом заявок подряд, и сбрасывать выбор на каждый заход неудобно.
 const ROUTES_FILTER_STORAGE_KEY = 'approvalAdmin.routesFilter';
+/** Окно создания маршрута переживает F5 — поля подставляются из черновика (см. RouteFormModal). */
+const CREATE_OPEN_STORAGE_KEY = 'approvalAdmin.draftOpen.route';

 export const RoutesScreen: React.FC<IRoutesScreenProps> = ({
  api,
@@ -69,7 +72,13 @@ export const RoutesScreen: React.FC<IRoutesScreenProps> = ({
  const routes = useTemplateRoutes(api, filterRequestTypeId ? Number(filterRequestTypeId) : undefined);

  const [editing, setEditing] = React.useState<TemplateRoute | undefined>();
+  // showForm — только редактирование; окно создания восстанавливается после F5 (usePersistedOpen).
  const [showForm, setShowForm] = React.useState(false);
+  const createOpen = usePersistedOpen(CREATE_OPEN_STORAGE_KEY);
+  const closeForm = (): void => {
+    setShowForm(false);
+    createOpen.close();
+  };
  const [copying, setCopying] = React.useState<TemplateRoute | undefined>();

  const deleteTarget = useDeleteTarget<TemplateRoute>(item => api.templateRoutes.remove(item.id), routes.reload);
@@ -83,11 +92,13 @@ export const RoutesScreen: React.FC<IRoutesScreenProps> = ({

  const openCreate = (): void => {
    setEditing(undefined);
-    setShowForm(true);
+    setShowForm(false);
+    createOpen.open();
  };

  const openEdit = (item: TemplateRoute): void => {
    setEditing(item);
+    createOpen.close();
    setShowForm(true);
  };

@@ -159,7 +170,7 @@ export const RoutesScreen: React.FC<IRoutesScreenProps> = ({
        emptyMessage={routes.isLoading ? texts.common.loading : texts.routes.emptyList}
      />

-      {showForm && (
+      {(showForm || createOpen.isOpen) && (
        <RouteFormModal
          api={api}
          editing={editing}
@@ -169,7 +180,7 @@ export const RoutesScreen: React.FC<IRoutesScreenProps> = ({
          departments={portalDictionaries.departments}
          dictionaryLoading={portalDictionaries.isLoading}
          onSaved={routes.reload}
-          onClose={() => setShowForm(false)}
+          onClose={closeForm}
        />
      )}

@@ -16,12 +16,13 @@
  gap: 16px;
  box-shadow: $sh-1;
  cursor: pointer;
-  @include card-hover-gold;
  border: 1px solid $gray-200;
  text-decoration: none;
  color: inherit;
  position: relative;
  overflow: hidden;
+  // Миксин с вложенным &:hover — после всех объявлений, иначе Sass ругается mixed-decls.
+  @include card-hover-gold;

  &::before {
    content: '';
@@ -1,12 +1,15 @@
 import * as React from 'react';
 import styles from './Modal.module.scss';
 import { Button } from './Button';
+import { ModalOverlay } from './ModalOverlay';
 import { texts } from '../../texts';

 export interface IConfirmDialogProps {
  title: string;
  text: string;
  confirmLabel: string;
+  /** Подпись кнопки отказа — по умолчанию «Отмена». */
+  cancelLabel?: string;
  onConfirm: () => void;
  onCancel: () => void;
  busy?: boolean;
@@ -16,18 +19,19 @@ export const ConfirmDialog: React.FC<IConfirmDialogProps> = ({
  title,
  text,
  confirmLabel,
+  cancelLabel = texts.common.cancel,
  onConfirm,
  onCancel,
  busy
 }) => (
-  <div className={styles.overlay} onClick={e => { if (e.target === e.currentTarget) onCancel(); }}>
+  <ModalOverlay onBackdropClick={onCancel}>
    <div className={`${styles.box} ${styles.narrow}`}>
      <div className={styles.title}>{title}</div>
      <p className={styles.text}>{text}</p>
      <div className={styles.narrowFooter}>
-        <Button variant="secondary" onClick={onCancel} disabled={busy}>{texts.common.cancel}</Button>
+        <Button variant="secondary" onClick={onCancel} disabled={busy}>{cancelLabel}</Button>
        <Button variant="danger" icon="trash" onClick={onConfirm} disabled={busy}>{confirmLabel}</Button>
      </div>
    </div>
-  </div>
+  </ModalOverlay>
 );
@@ -1,7 +1,9 @@
 import * as React from 'react';
 import { Alert } from './Alert';
 import { Button } from './Button';
+import { ConfirmDialog } from './ConfirmDialog';
 import { Modal } from './Modal';
+import styles from './Modal.module.scss';
 import { texts } from '../../texts';

 export interface IFormModalProps {
@@ -15,6 +17,18 @@ export interface IFormModalProps {
  savingLabel?: string;
  onSubmit: () => void;
  onClose: () => void;
+  /**
+   * Сбросить черновик формы (см. useFormDraft). Кнопка «Очистить» показывается,
+   * только если передан и canReset — «Отмена» и клик мимо окна черновик не трогают.
+   */
+  onReset?: () => void;
+  canReset?: boolean;
+  /**
+   * В форме есть несохранённые правки существующей записи: выход (крестик,
+   * «Отмена», клик мимо окна) сначала спрашивает подтверждение. Для форм создания
+   * не нужен — их черновик сохраняется сам (см. useFormDraft).
+   */
+  isDirty?: boolean;
  children: React.ReactNode;
 }

@@ -30,21 +44,51 @@ export const FormModal: React.FC<IFormModalProps> = ({
  savingLabel = texts.common.saving,
  onSubmit,
  onClose,
+  onReset,
+  canReset,
+  isDirty,
  children
-}) => (
-  <Modal
-    title={title}
-    onClose={onClose}
-    footer={
-      <>
-        <Button variant="secondary" onClick={onClose} disabled={isSaving}>{texts.common.cancel}</Button>
-        <Button variant="accent" icon="check" onClick={onSubmit} disabled={isSaving}>
-          {isSaving ? savingLabel : submitLabel}
-        </Button>
-      </>
-    }
-  >
-    {error && <Alert kind="err">{error}</Alert>}
-    {children}
-  </Modal>
-);
+}) => {
+  const [confirmingClose, setConfirmingClose] = React.useState(false);
+  // Во время сохранения не закрываем и не спрашиваем: запрос уже ушёл.
+  const requestClose = (): void => {
+    if (isSaving) return;
+    if (isDirty) setConfirmingClose(true);
+    else onClose();
+  };
+
+  return (
+    <>
+      <Modal
+        title={title}
+        onClose={requestClose}
+        footer={
+          <>
+            {onReset && canReset && (
+              <span className={styles.footerStart}>
+                <Button variant="ghost" icon="refresh" onClick={onReset} disabled={isSaving}>{texts.common.resetDraft}</Button>
+              </span>
+            )}
+            <Button variant="secondary" onClick={requestClose} disabled={isSaving}>{texts.common.cancel}</Button>
+            <Button variant="accent" icon="check" onClick={onSubmit} disabled={isSaving}>
+              {isSaving ? savingLabel : submitLabel}
+            </Button>
+          </>
+        }
+      >
+        {error && <Alert kind="err">{error}</Alert>}
+        {children}
+      </Modal>
+      {confirmingClose && (
+        <ConfirmDialog
+          title={texts.common.discardTitle}
+          text={texts.common.discardText}
+          confirmLabel={texts.common.discardConfirm}
+          cancelLabel={texts.common.discardKeepEditing}
+          onConfirm={onClose}
+          onCancel={() => setConfirmingClose(false)}
+        />
+      )}
+    </>
+  );
+};
@@ -7,9 +7,17 @@
  display: flex;
  align-items: center;
  justify-content: center;
-  z-index: 300;
+  // Выше шапки SharePoint, но ниже слоёв Fluent UI (1000000). Оверлей рендерится
+  // порталом в body (см. ModalOverlay), поэтому сравнивается с шапкой напрямую.
+  z-index: 100000;
  backdrop-filter: blur(6px);
  padding: 20px;
+  // Портал вне корня веб-части — шрифт и метрики .shell (AdminApp.module.scss)
+  // сюда не наследуются, задаём заново.
+  font-family: $font-sans;
+  font-size: $fs-body;
+  line-height: 1.55;
+  box-sizing: border-box;
 }

 .box {
@@ -63,4 +71,7 @@
  padding: 16px 26px 22px;
 }

+/** Кнопка в подвале, прижатая влево, подальше от «Отмена/Сохранить» (см. «Очистить» в FormModal). */
+.footerStart { margin-right: auto; }
+
 .narrowFooter { justify-content: center; padding: 0; margin-top: 24px; }
@@ -1,6 +1,7 @@
 import * as React from 'react';
 import styles from './Modal.module.scss';
 import { IconButton } from './IconButton';
+import { ModalOverlay } from './ModalOverlay';
 import { texts } from '../../texts';

 export interface IModalProps {
@@ -11,8 +12,7 @@ export interface IModalProps {
 }

 export const Modal: React.FC<IModalProps> = ({ title, onClose, footer, children }) => (
-  // Клик по подложке закрывает окно, клик внутри — нет (проверяем сам currentTarget).
-  <div className={styles.overlay} onClick={e => { if (e.target === e.currentTarget) onClose(); }}>
+  <ModalOverlay onBackdropClick={onClose}>
    <div className={styles.box}>
      <div className={styles.header}>
        <div className={styles.title}>{title}</div>
@@ -21,5 +21,5 @@ export const Modal: React.FC<IModalProps> = ({ title, onClose, footer, children
      <div className={styles.body}>{children}</div>
      {footer && <div className={styles.footer}>{footer}</div>}
    </div>
-  </div>
+  </ModalOverlay>
 );
@@ -0,0 +1,25 @@
+import * as React from 'react';
+import * as ReactDOM from 'react-dom';
+import styles from './Modal.module.scss';
+
+export interface IModalOverlayProps {
+  /** Клик по подложке (не по содержимому окна). */
+  onBackdropClick: () => void;
+  children: React.ReactNode;
+}
+
+/**
+ * Затемнение под модалкой — порталом в document.body, а не внутри веб-части.
+ * На живой странице SharePoint канва веб-части лежит в своём контексте наложения
+ * ниже шапки (suite bar), и position: fixed-оверлей изнутри неё оказывался ПОД
+ * шапкой: верх окна, центрированного по высоте экрана, уезжал за неё. В workbench
+ * шапки нет — там было незаметно.
+ */
+export const ModalOverlay: React.FC<IModalOverlayProps> = ({ onBackdropClick, children }) =>
+  ReactDOM.createPortal(
+    // Клик по подложке закрывает окно, клик внутри — нет (проверяем сам currentTarget).
+    <div className={styles.overlay} onClick={e => { if (e.target === e.currentTarget) onBackdropClick(); }}>
+      {children}
+    </div>,
+    document.body
+  );
@@ -1,6 +1,6 @@
@import '../../../../styles/design-tokens';

-// Ниже Modal.module.scss/.overlay (z-index 300) — диалоги, которые может
+// Ниже Modal.module.scss/.overlay (z-index 100000) — диалоги, которые может
 // открыть сама длительная операция (например, разрешение конфликта), должны
 // быть ПОВЕРХ этой подложки, а не под ней.
 .overlay {
@@ -73,7 +73,7 @@
  box-shadow: $sh-modal;
  border: 1px solid $gray-200;
  padding: 6px;
-  z-index: 400;
+  z-index: 100001; // над оверлеем модалки (Modal.module.scss)
  max-height: 320px;
  display: flex;
  flex-direction: column;
@@ -17,6 +17,7 @@ export * from './PrimaryCell';
 export * from './ActionsCell';
 export * from './CellNote';
 export * from './Modal';
+export * from './ModalOverlay';
 export * from './ConfirmDialog';
 export * from './FormModal';
 export * from './FormGrid';
@@ -0,0 +1,58 @@
+import * as React from 'react';
+import { readLocalStorage } from './useLocalStorageState';
+
+export interface IFormDraft<T> {
+  value: T;
+  setValue: React.Dispatch<React.SetStateAction<T>>;
+  /** Форма отличается от initial — есть что сбрасывать. */
+  isDirty: boolean;
+  /** Вернуть initial и забыть черновик (кнопка «Очистить», успешное сохранение). */
+  reset: () => void;
+}
+
+function removeDraft(key: string): void {
+  try {
+    window.localStorage.removeItem(key);
+  } catch {
+    // приватный режим — черновика и не было
+  }
+}
+
+/**
+ * Состояние формы создания, которое переживает закрытие модалки (случайный клик
+ * по подложке, «Отмена», F5): черновик лежит в localStorage под key, пока его
+ * не сбросят явно — reset() после успешного сохранения или по кнопке «Очистить».
+ *
+ * key === undefined — обычный useState без персиста: так форма редактирования
+ * существующей записи всегда открывается с актуальными данными с сервера, а не
+ * с устаревшей правкой.
+ */
+export function useFormDraft<T>(key: string | undefined, initial: T): IFormDraft<T> {
+  const [value, setValue] = React.useState<T>(() => (key ? readLocalStorage(key, initial) : initial));
+
+  // initial у вызывающих — литерал, пересоздаётся каждый рендер; сравниваем по содержимому.
+  const initialJson = JSON.stringify(initial);
+  const isDirty = JSON.stringify(value) !== initialJson;
+
+  React.useEffect(() => {
+    if (!key) return;
+    if (!isDirty) {
+      removeDraft(key);
+      return;
+    }
+    try {
+      window.localStorage.setItem(key, JSON.stringify(value));
+    } catch {
+      // приватный режим / переполненная квота — не критично, просто не персистим
+    }
+  }, [key, value, isDirty]);
+
+  // Ключ удаляем синхронно, а не через эффект: после успешного сохранения модалка
+  // тут же размонтируется, и эффект на новое значение уже не отработает.
+  const reset = (): void => {
+    if (key) removeDraft(key);
+    setValue(JSON.parse(initialJson) as T);
+  };
+
+  return { value, setValue, isDirty, reset };
+}
@@ -0,0 +1,44 @@
+import { coerceStored } from './useLocalStorageState';
+
+describe('coerceStored', () => {
+  const initial = { name: '', count: 0, flag: false, tags: [] as string[], nested: { a: '' } };
+
+  it('подставляет дефолт для полей, добавленных после сохранения', () => {
+    expect(coerceStored(initial, { name: 'x' })).toEqual({ ...initial, name: 'x' });
+  });
+
+  it('отбрасывает ключи, которых в форме больше нет', () => {
+    expect(coerceStored(initial, { name: 'x', removed: 1 })).not.toHaveProperty('removed');
+  });
+
+  it('заменяет значение другого типа дефолтом', () => {
+    expect(coerceStored(initial, { name: 5, tags: { a: 1 }, flag: 'yes', nested: 'oops' }))
+      .toEqual(initial);
+  });
+
+  it('принимает массив нужного типа и мёржит вложенный объект', () => {
+    expect(coerceStored(initial, { tags: ['a'], nested: {} }))
+      .toEqual({ ...initial, tags: ['a'] });
+  });
+
+  it('не падает на null и примитиве вместо объекта', () => {
+    expect(coerceStored(initial, null)).toEqual(initial);
+    expect(coerceStored(initial, 'x')).toEqual(initial);
+  });
+
+  it('для примитивного initial проверяет тип', () => {
+    expect(coerceStored('', 5)).toBe('');
+    expect(coerceStored('', 'abc')).toBe('abc');
+    expect(coerceStored<number[]>([], [1, 2])).toEqual([1, 2]);
+  });
+
+  it('для boolean-флага отбрасывает значение другого типа', () => {
+    expect(coerceStored(false, true)).toBe(true);
+    expect(coerceStored(false, 'true')).toBe(false);
+  });
+
+  it('при initial === undefined принимает сохранённое как есть', () => {
+    expect(coerceStored<string | undefined>(undefined, 'a')).toBe('a');
+    expect(coerceStored({ x: undefined as string | undefined }, { x: 'a' })).toEqual({ x: 'a' });
+  });
+});
@@ -4,28 +4,56 @@ function isPlainObject(value: unknown): value is Record<string, unknown> {
  return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

+/**
+ * Сохранённое значение, приведённое к форме initial. Запись могла быть сделана
+ * старой версией формы, поэтому ей нельзя доверять слепо:
+ * - объект мёржится с initial — добавленные с тех пор поля получают дефолт;
+ * - ключи, которых в initial нет (поле удалили), отбрасываются;
+ * - значение, чей тип не совпал с initial (было число — стала строка, было
+ *   [] — стал объект), заменяется дефолтом: иначе .map/.trim по нему уронил бы рендер;
+ * - null/undefined в initial типа не задают — там принимаем любое сохранённое.
+ */
+export function coerceStored<T>(initial: T, stored: unknown): T {
+  if (initial === null || initial === undefined) return stored as T;
+  if (Array.isArray(initial)) return (Array.isArray(stored) ? stored : initial) as unknown as T;
+  if (isPlainObject(initial)) {
+    if (!isPlainObject(stored)) return initial;
+    const result: Record<string, unknown> = { ...initial };
+    Object.keys(initial).forEach(k => {
+      if (k in stored) result[k] = coerceStored(initial[k], stored[k]);
+    });
+    return result as T;
+  }
+  return (typeof stored === typeof initial ? stored : initial) as T;
+}
+
+/**
+ * Значение из localStorage под key, приведённое к форме initial (см. coerceStored),
+ * или initial, если записи нет / она битая / localStorage недоступен.
+ */
+export function readLocalStorage<T>(key: string, initial: T): T {
+  try {
+    const raw = window.localStorage.getItem(key);
+    if (!raw) return initial;
+
+    return coerceStored(initial, JSON.parse(raw));
+  } catch {
+    return initial;
+  }
+}
+
 /**
 * Как React.useState, но значение переживает перезагрузку страницы — хранится
 * в localStorage под key. Падение доступа к localStorage (приватный режим,
 * квота) не ломает форму — просто не персистит.
 *
- * Сохранённое значение мелко мёржится с initial (для объектных T): если после
- * обновления в форму добавили новое поле, у пользователей со старой записью в
- * localStorage оно не потеряется как undefined (что уронило бы рендер на
- * первом же .map/.trim по этому полю), а подставится дефолт из initial.
+ * Сохранённое значение приводится к форме initial (см. coerceStored): новое поле
+ * получает дефолт, удалённое отбрасывается, значение не того типа заменяется
+ * дефолтом — иначе старая запись в localStorage уронила бы рендер на первом же
+ * .map/.trim по этому полю.
 */
 export function useLocalStorageState<T>(key: string, initial: T): [T, React.Dispatch<React.SetStateAction<T>>] {
-  const [value, setValue] = React.useState<T>(() => {
-    try {
-      const raw = window.localStorage.getItem(key);
-      if (!raw) return initial;
-
-      const parsed = JSON.parse(raw) as T;
-      return isPlainObject(initial) && isPlainObject(parsed) ? { ...initial, ...parsed } as T : parsed;
-    } catch {
-      return initial;
-    }
-  });
+  const [value, setValue] = React.useState<T>(() => readLocalStorage(key, initial));

  React.useEffect(() => {
    try {
@@ -0,0 +1,17 @@
+import { useLocalStorageState } from './useLocalStorageState';
+
+export interface IPersistedOpen {
+  isOpen: boolean;
+  open: () => void;
+  close: () => void;
+}
+
+/**
+ * Признак «модалка создания открыта», переживающий F5: после перезагрузки окно
+ * открывается снова, а поля подставляются из черновика (см. useFormDraft).
+ * close() сбрасывает только признак — черновик остаётся до сохранения или «Очистить».
+ */
+export function usePersistedOpen(key: string): IPersistedOpen {
+  const [isOpen, setIsOpen] = useLocalStorageState<boolean>(key, false);
+  return { isOpen, open: () => setIsOpen(true), close: () => setIsOpen(false) };
+}
@@ -76,6 +76,13 @@ export const texts = {
    remove: 'Удалить',
    edit: 'Редактировать',
    close: 'Закрыть',
+    /** Сброс черновика формы создания — сам черновик переживает закрытие окна. */
+    resetDraft: 'Очистить',
+    /** Предупреждение при выходе из формы редактирования с несохранёнными правками. */
+    discardTitle: 'Закрыть без сохранения?',
+    discardText: 'Внесённые изменения не сохранятся.',
+    discardConfirm: 'Закрыть без сохранения',
+    discardKeepEditing: 'Продолжить редактирование',
    loading: 'Загрузка...',
    yes: 'Да',
    no: 'Нет',