Убрать неиспользуемые using по код-стайлу

Прогон dotnet format (IDE0005) по 4 решениям: удалены лишние using,
оставшиеся после миграции namespace (676 файлов).

src/ai-service/Deal.Ai.Tests/Ai/AiRpcTests.cs

@@ -1,10 +1,8 @@
+using System.Text.Json.Nodes;
 using Deal.Ai.Llm;
 using Deal.Grpc.Ai;
 using Grpc.Core;
-using Grpc.Net.Client;
 using Microsoft.Extensions.DependencyInjection;
-using System.Text.Json.Nodes;
-using Deal.Ai.Tests.Support;
 
 namespace Deal.Ai.Tests.Ai;
 

src/ai-service/Deal.Ai.Tests/Ai/AiTestHost.cs

@@ -1,13 +1,11 @@
-using Deal.Ai;
+using System.Net;
+using System.Net.Sockets;
 using Deal.Ai.Llm;
 using Deal.Grpc.Hosting;
 using Grpc.Core;
 using Grpc.Net.Client;
 using Microsoft.AspNetCore.Builder;
 using Microsoft.Extensions.DependencyInjection;
-using System.Net;
-using System.Net.Sockets;
-using Deal.Ai.Tests.Support;
 
 namespace Deal.Ai.Tests.Ai;
 

src/ai-service/Deal.Ai.Tests/Ai/FakeProviderClient.cs

@@ -1,5 +1,4 @@
 using Deal.Ai.Llm;
-using Deal.Ai.Tests.Support;
 
 namespace Deal.Ai.Tests.Ai;
 

src/ai-service/Deal.Ai.Tests/Ai/ProviderCallerTests.cs

@@ -1,6 +1,5 @@
 using Deal.Ai.Llm;
 using Microsoft.Extensions.Logging.Abstractions;
-using Deal.Ai.Tests.Support;
 
 namespace Deal.Ai.Tests.Ai;
 

src/ai-service/Deal.Ai.Tests/Ai/TokenEstimatorTests.cs

@@ -1,5 +1,4 @@
 using Deal.Ai.Llm;
-using Deal.Ai.Tests.Support;
 
 namespace Deal.Ai.Tests.Ai;
 

src/ai-service/Deal.Ai.Tests/AssemblyInfo.cs

@@ -1,5 +1,3 @@
-using Xunit;
-
 // In-proc gRPC-тесты ai-service поднимают реальные Kestrel-хосты и меняют процесс-глобальную
 // env-переменную DEAL_SERVICE_TOKEN на время сценария (AiTestHost и AiServiceHostTests).
 // Параллельный прогон классов дал бы гонки на env — тесты сериализованы (тот же шаблон, что

src/ai-service/Deal.Ai.Tests/Grpc/AiServiceHostTests.cs

@@ -1,13 +1,10 @@
+using System.Net;
+using System.Net.Sockets;
 using Deal.Grpc.Ai;
-using Deal.Ai;
-using Microsoft.AspNetCore.Builder;
 using Grpc.Core;
 using Grpc.Health.V1;
 using Grpc.Net.Client;
-using System.Net;
+using Microsoft.AspNetCore.Builder;
-using System.Net.Sockets;
-using Xunit;
-using Deal.Ai.Tests.Support;
 
 namespace Deal.Ai.Tests.Grpc;
 

src/ai-service/Deal.Ai.Tests/Support/StubHttpMessageHandler.cs

@@ -1,7 +1,6 @@
 using System.Net;
 using System.Text;
 using System.Text.Json.Nodes;
-using Deal.Ai.Llm;
 
 namespace Deal.Ai.Tests.Support;
 

src/core/Deal.Api/Configuration/CookieOptions.cs

@@ -1,39 +1,33 @@
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+
-using Deal.Modules.Tenants.Application.Models;
+namespace Deal.Api.Configuration;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+/// <summary>
-using Deal.Api.Services;
+/// Настройки httpOnly-куки сессии. Привязываются из секции "Cookies" конфигурации (IOptions).
-using Deal.Api.Dtos;
+/// </summary>
-
+/// <remarks>
-namespace Deal.Api.Configuration;
+/// Источник значений — конфигурация: секция <c>Cookies</c> в appsettings.json /
-
+/// appsettings.Development.json и переменные окружения <c>Cookies__*</c> (имя, срок, Secure).
-/// <summary>
+/// <para>
-/// Настройки httpOnly-куки сессии. Привязываются из секции "Cookies" конфигурации (IOptions).
+/// Срок жизни по умолчанию — единый источник числа «30 дней»: константа модуля
-/// </summary>
+/// <see cref="AuthService.SessionLifetimeDays"/>, на которую ссылается код-дефолт свойства
-/// <remarks>
+/// <see cref="Days"/>. Значение из конфигурации (<c>Cookies__Days</c>) при необходимости перекрывает его.
-/// Источник значений — конфигурация: секция <c>Cookies</c> в appsettings.json /
+/// </para>
-/// appsettings.Development.json и переменные окружения <c>Cookies__*</c> (имя, срок, Secure).
+/// </remarks>
-/// <para>
+public sealed class CookieOptions
-/// Срок жизни по умолчанию — единый источник числа «30 дней»: константа модуля
+{
-/// <see cref="AuthService.SessionLifetimeDays"/>, на которую ссылается код-дефолт свойства
+    /// <summary>
-/// <see cref="Days"/>. Значение из конфигурации (<c>Cookies__Days</c>) при необходимости перекрывает его.
+    /// Имя куки (Ruling 6: <c>deal_session</c>).
-/// </para>
+    /// </summary>
-/// </remarks>
+    public string Name { get; set; } = "deal_session";
-public sealed class CookieOptions
+
-{
+    /// <summary>
-    /// <summary>
+    /// Срок жизни куки в днях; совпадает со сроком жизни сессии (Ruling 6).
-    /// Имя куки (Ruling 6: <c>deal_session</c>).
+    /// </summary>
-    /// </summary>
+    public int Days { get; set; } = AuthService.SessionLifetimeDays;
-    public string Name { get; set; } = "deal_session";
+
-
+    /// <summary>
-    /// <summary>
+    /// Флаг Secure куки (dev=false; включается при HTTPS-проксировании, Ruling 6).
-    /// Срок жизни куки в днях; совпадает со сроком жизни сессии (Ruling 6).
+    /// </summary>
-    /// </summary>
+    public bool Secure { get; set; }
-    public int Days { get; set; } = AuthService.SessionLifetimeDays;
+}
-
-    /// <summary>
-    /// Флаг Secure куки (dev=false; включается при HTTPS-проксировании, Ruling 6).
-    /// </summary>
-    public bool Secure { get; set; }
-}

src/core/Deal.Api/Configuration/DataRetentionOptions.cs

@@ -1,6 +1,3 @@
-using Deal.Api.Services;
-using Deal.Api.Dtos;
-
 namespace Deal.Api.Configuration;
 
 /// <summary>

src/core/Deal.Api/Configuration/ForwardedHeadersConfig.cs

@@ -1,42 +1,39 @@
-using Deal.Api.Services;
+namespace Deal.Api.Configuration;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Configuration;
+/// Настройки доверия прокси-заголовкам (план Task 12; замечание ревью T4/T11 к Ruling 5/10): секция
-
+/// <c>ForwardedHeaders</c> конфигурации (appsettings.json + переменные окружения <c>ForwardedHeaders__*</c>).
-/// <summary>
+/// </summary>
-/// Настройки доверия прокси-заголовкам (план Task 12; замечание ревью T4/T11 к Ruling 5/10): секция
+/// <remarks>
-/// <c>ForwardedHeaders</c> конфигурации (appsettings.json + переменные окружения <c>ForwardedHeaders__*</c>).
+/// В PROD наружу смотрит только Caddy (compose-prod, Task 14), core принимает соединения от него:
-/// </summary>
+/// без обработки X-Forwarded-For/X-Forwarded-Proto RemoteIpAddress (HttpContext.Connection)
-/// <remarks>
+/// всех запросов — адрес Caddy, и audit-IP (ClientIp эндпоинтов, Ruling 4) и rate-limit-по-IP
-/// В PROD наружу смотрит только Caddy (compose-prod, Task 14), core принимает соединения от него:
+/// (политики Ruling 5, LoginAttemptGuard) схлопываются в один бакет прокси. UseForwardedHeaders
-/// без обработки X-Forwarded-For/X-Forwarded-Proto RemoteIpAddress (HttpContext.Connection)
+/// доверяет заголовкам только клиентов из <see cref="KnownProxies"/> (IP-адреса) и
-/// всех запросов — адрес Caddy, и audit-IP (ClientIp эндпоинтов, Ruling 4) и rate-limit-по-IP
+/// <see cref="KnownNetworks"/> (подсети CIDR).
-/// (политики Ruling 5, LoginAttemptGuard) схлопываются в один бакет прокси. UseForwardedHeaders
+/// <para>
-/// доверяет заголовкам только клиентов из <see cref="KnownProxies"/> (IP-адреса) и
+/// <c>Enabled=false</c> — код-дефолт и значение dev/тестов: прокси в dev-стеке нет (compose.dev —
-/// <see cref="KnownNetworks"/> (подсети CIDR).
+/// core наружу напрямую :5080), curl-приёмки от заголовков не зависят. PROD включает env
-/// <para>
+/// (<c>ForwardedHeaders__Enabled=true</c>) и перечисляет Caddy: KnownProxies (его IP) либо KnownNetworks
-/// <c>Enabled=false</c> — код-дефолт и значение dev/тестов: прокси в dev-стеке нет (compose.dev —
+/// (узкий CIDR compose-сети). Пустые KnownProxies/KnownNetworks у ForwardedHeadersMiddleware означают
-/// core наружу напрямую :5080), curl-приёмки от заголовков не зависят. PROD включает env
+/// «доверять любому клиенту» — Program.BuildForwardedHeadersOptions не допускает пустоту и добавляет
-/// (<c>ForwardedHeaders__Enabled=true</c>) и перечисляет Caddy: KnownProxies (его IP) либо KnownNetworks
+/// loopback-фолбэк (dev-прокси на хосте: vite/локальный Caddy); явное перечисление в конфиге замещает его.
-/// (узкий CIDR compose-сети). Пустые KnownProxies/KnownNetworks у ForwardedHeadersMiddleware означают
+/// </para>
-/// «доверять любому клиенту» — Program.BuildForwardedHeadersOptions не допускает пустоту и добавляет
+/// </remarks>
-/// loopback-фолбэк (dev-прокси на хосте: vite/локальный Caddy); явное перечисление в конфиге замещает его.
+public sealed class ForwardedHeadersConfig
-/// </para>
+{
-/// </remarks>
+    /// <summary>
-public sealed class ForwardedHeadersConfig
+    /// Включена ли обработка прокси-заголовков (dev/тесты — false; PROD за Caddy — true).
-{
+    /// </summary>
-    /// <summary>
+    public bool Enabled { get; set; }
-    /// Включена ли обработка прокси-заголовков (dev/тесты — false; PROD за Caddy — true).
+
-    /// </summary>
+    /// <summary>
-    public bool Enabled { get; set; }
+    /// Доверенные прокси-адреса: IP клиентов, которым можно верить в X-Forwarded-For/Proto.
-
+    /// </summary>
-    /// <summary>
+    public string[] KnownProxies { get; set; } = [];
-    /// Доверенные прокси-адреса: IP клиентов, которым можно верить в X-Forwarded-For/Proto.
+
-    /// </summary>
+    /// <summary>
-    public string[] KnownProxies { get; set; } = [];
+    /// Доверенные подсети прокси в CIDR (например "172.16.0.0/12" — compose-сеть PROD).
-
+    /// </summary>
-    /// <summary>
+    public string[] KnownNetworks { get; set; } = [];
-    /// Доверенные подсети прокси в CIDR (например "172.16.0.0/12" — compose-сеть PROD).
+}
-    /// </summary>
-    public string[] KnownNetworks { get; set; } = [];
-}

src/core/Deal.Api/Configuration/OperatorCookieOptions.cs

@@ -1,41 +1,35 @@
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+
-using Deal.Modules.Tenants.Application.Models;
+namespace Deal.Api.Configuration;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+/// <summary>
-using Deal.Api.Services;
+/// Настройки httpOnly-куки сессии оператора. Привязываются из секции "OperatorCookies" конфигурации (IOptions).
-using Deal.Api.Dtos;
+/// </summary>
-
+/// <remarks>
-namespace Deal.Api.Configuration;
+/// Источник значений — конфигурация: секция <c>OperatorCookies</c> в appsettings.json и переменные
-
+/// окружения <c>OperatorCookies__*</c> (имя, срок, Secure). Имя по умолчанию — <c>deal_operator_session</c>:
-/// <summary>
+/// отдельная от тенантной <c>deal_session</c> кука (Ruling 1 этапа 7) — операторская сессия не может быть
-/// Настройки httpOnly-куки сессии оператора. Привязываются из секции "OperatorCookies" конфигурации (IOptions).
+/// подменена тенантной и наоборот (сессии разрешаются разными middleware).
-/// </summary>
+/// <para>
-/// <remarks>
+/// Срок жизни по умолчанию — единый источник числа «12 часов»: константа модуля
-/// Источник значений — конфигурация: секция <c>OperatorCookies</c> в appsettings.json и переменные
+/// <see cref="OperatorAuthService.SessionLifetimeHours"/>, на которую ссылается код-дефолт свойства
-/// окружения <c>OperatorCookies__*</c> (имя, срок, Secure). Имя по умолчанию — <c>deal_operator_session</c>:
+/// <see cref="Hours"/>. Значение из конфигурации (<c>OperatorCookies__Hours</c>) при необходимости перекрывает его.
-/// отдельная от тенантной <c>deal_session</c> кука (Ruling 1 этапа 7) — операторская сессия не может быть
+/// </para>
-/// подменена тенантной и наоборот (сессии разрешаются разными middleware).
+/// </remarks>
-/// <para>
+public sealed class OperatorCookieOptions
-/// Срок жизни по умолчанию — единый источник числа «12 часов»: константа модуля
+{
-/// <see cref="OperatorAuthService.SessionLifetimeHours"/>, на которую ссылается код-дефолт свойства
+    /// <summary>
-/// <see cref="Hours"/>. Значение из конфигурации (<c>OperatorCookies__Hours</c>) при необходимости перекрывает его.
+    /// Имя куки (Ruling 1: <c>deal_operator_session</c>).
-/// </para>
+    /// </summary>
-/// </remarks>
+    public string Name { get; set; } = "deal_operator_session";
-public sealed class OperatorCookieOptions
+
-{
+    /// <summary>
-    /// <summary>
+    /// Срок жизни куки в часах; совпадает со сроком жизни сессии оператора (Ruling 1: 12).
-    /// Имя куки (Ruling 1: <c>deal_operator_session</c>).
+    /// </summary>
-    /// </summary>
+    public int Hours { get; set; } = OperatorAuthService.SessionLifetimeHours;
-    public string Name { get; set; } = "deal_operator_session";
+
-
+    /// <summary>
-    /// <summary>
+    /// Флаг Secure куки (dev=false; включается при HTTPS-проксировании, Ruling 1).
-    /// Срок жизни куки в часах; совпадает со сроком жизни сессии оператора (Ruling 1: 12).
+    /// </summary>
-    /// </summary>
+    public bool Secure { get; set; }
-    public int Hours { get; set; } = OperatorAuthService.SessionLifetimeHours;
+}
-
-    /// <summary>
-    /// Флаг Secure куки (dev=false; включается при HTTPS-проксировании, Ruling 1).
-    /// </summary>
-    public bool Secure { get; set; }
-}

src/core/Deal.Api/Configuration/RateLimitOptions.cs

@@ -1,46 +1,43 @@
-using Deal.Api.Services;
+namespace Deal.Api.Configuration;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Configuration;
+/// Настройки rate limiting и защиты входа (план Task 11, Ruling 5): секция <c>RateLimit</c> конфигурации
-
+/// (appsettings.json + переменные окружения <c>RateLimit__*</c>).
-/// <summary>
+/// </summary>
-/// Настройки rate limiting и защиты входа (план Task 11, Ruling 5): секция <c>RateLimit</c> конфигурации
+/// <remarks>
-/// (appsettings.json + переменные окружения <c>RateLimit__*</c>).
+/// <c>Enabled=false</c> — код-дефолт и значение dev/тестов: политики и middleware не регистрируются вовсе,
-/// </summary>
+/// curl-приёмки и unit-хосты не режутся. PROD включает env-переопределением (<c>RateLimit__Enabled=true</c>
-/// <remarks>
+/// в compose-prod, Task 14). Все окна политик — фиксированные, 1 минута (имена свойств — «PerMinute»).
-/// <c>Enabled=false</c> — код-дефолт и значение dev/тестов: политики и middleware не регистрируются вовсе,
+/// </remarks>
-/// curl-приёмки и unit-хосты не режутся. PROD включает env-переопределением (<c>RateLimit__Enabled=true</c>
+public sealed class RateLimitOptions
-/// в compose-prod, Task 14). Все окна политик — фиксированные, 1 минута (имена свойств — «PerMinute»).
+{
-/// </remarks>
+    /// <summary>
-public sealed class RateLimitOptions
+    /// Включены ли rate limiting и LoginAttemptGuard (dev/тесты — false, Ruling 5).
-{
+    /// </summary>
-    /// <summary>
+    public bool Enabled { get; set; }
-    /// Включены ли rate limiting и LoginAttemptGuard (dev/тесты — false, Ruling 5).
+
-    /// </summary>
+    /// <summary>
-    public bool Enabled { get; set; }
+    /// Лимит политики "auth" (фиксированное окно в минуту на IP) для /api/auth/login и /api/operator/auth/login.
-
+    /// </summary>
-    /// <summary>
+    public int AuthPerMinute { get; set; } = 10;
-    /// Лимит политики "auth" (фиксированное окно в минуту на IP) для /api/auth/login и /api/operator/auth/login.
+
-    /// </summary>
+    /// <summary>
-    public int AuthPerMinute { get; set; } = 10;
+    /// Лимит политики "api" (в минуту на тенанта либо IP анонима) для остальных /api-эндпоинтов.
-
+    /// </summary>
-    /// <summary>
+    public int ApiPerMinute { get; set; } = 600;
-    /// Лимит политики "api" (в минуту на тенанта либо IP анонима) для остальных /api-эндпоинтов.
+
-    /// </summary>
+    /// <summary>
-    public int ApiPerMinute { get; set; } = 600;
+    /// Лимит gRPC-ингресса (в минуту на tenant-id из metadata; интерцептор IngressRateLimitInterceptor).
-
+    /// </summary>
-    /// <summary>
+    public int GrpcIngressPerMinute { get; set; } = 600;
-    /// Лимит gRPC-ингресса (в минуту на tenant-id из metadata; интерцептор IngressRateLimitInterceptor).
+
-    /// </summary>
+    /// <summary>
-    public int GrpcIngressPerMinute { get; set; } = 600;
+    /// Порог неудачных попыток входа ключа ip|login до блокировки (LoginAttemptGuard).
-
+    /// </summary>
-    /// <summary>
+    public int LoginAttemptsMax { get; set; } = 5;
-    /// Порог неудачных попыток входа ключа ip|login до блокировки (LoginAttemptGuard).
+
-    /// </summary>
+    /// <summary>
-    public int LoginAttemptsMax { get; set; } = 5;
+    /// Окно учёта неудачных попыток входа в минутах (LoginAttemptGuard; текст 429 — фиксированный «15 минут»).
-
+    /// </summary>
-    /// <summary>
+    public int LoginAttemptWindowMin { get; set; } = 15;
-    /// Окно учёта неудачных попыток входа в минутах (LoginAttemptGuard; текст 429 — фиксированный «15 минут»).
+}
-    /// </summary>
-    public int LoginAttemptWindowMin { get; set; } = 15;
-}

src/core/Deal.Api/Configuration/SecurityOptions.cs

@@ -1,28 +1,25 @@
-using Deal.Api.Services;
+namespace Deal.Api.Configuration;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Configuration;
+/// Настройки безопасности HTTP (план Task 12, Ruling 10(2)/9): секция <c>Security</c> конфигурации
-
+/// (appsettings.json + переменные окружения <c>Security__*</c>).
-/// <summary>
+/// </summary>
-/// Настройки безопасности HTTP (план Task 12, Ruling 10(2)/9): секция <c>Security</c> конфигурации
+/// <remarks>
-/// (appsettings.json + переменные окружения <c>Security__*</c>).
+/// <see cref="AllowedOrigins"/> — единый явный allowlist для Origin-проверки мутаций
-/// </summary>
+/// (<see cref="Deal.Api.Middleware.OriginGuardMiddleware"/>) и CORS-политики. Пустой список — dev-режим:
-/// <remarks>
+/// OriginGuard принимает только «свой» origin запроса (схема + Host, для не-GET запросов /api),
-/// <see cref="AllowedOrigins"/> — единый явный allowlist для Origin-проверки мутаций
+/// CORS разрешает любой origin (текущее поведение «как в прототипе»). Непустой список (PROD,
-/// (<see cref="Deal.Api.Middleware.OriginGuardMiddleware"/>) и CORS-политики. Пустой список — dev-режим:
+/// compose-prod, Ruling 9) — CORS становится строгим allowlist + credentials; OriginGuard дополнительно
-/// OriginGuard принимает только «свой» origin запроса (схема + Host, для не-GET запросов /api),
+/// принимает перечисленные origin'ы (в т.ч. когда запрос идёт не от «своего» Host — фронт за прокси).
-/// CORS разрешает любой origin (текущее поведение «как в прототипе»). Непустой список (PROD,
+/// <para>
-/// compose-prod, Ruling 9) — CORS становится строгим allowlist + credentials; OriginGuard дополнительно
+/// Записи — полные origin'ы в том виде, в каком их шлёт браузер: схема://хост[:порт], без завершающего
-/// принимает перечисленные origin'ы (в т.ч. когда запрос идёт не от «своего» Host — фронт за прокси).
+/// слэша (например <c>https://deal.example</c>, <c>http://localhost:5173</c>). Сравнение регистронезависимо.
-/// <para>
+/// </para>
-/// Записи — полные origin'ы в том виде, в каком их шлёт браузер: схема://хост[:порт], без завершающего
+/// </remarks>
-/// слэша (например <c>https://deal.example</c>, <c>http://localhost:5173</c>). Сравнение регистронезависимо.
+public sealed class SecurityOptions
-/// </para>
+{
-/// </remarks>
+    /// <summary>
-public sealed class SecurityOptions
+    /// Явный allowlist Origin/CORS (схема://хост[:порт]); пусто — dev-режим «любой origin + свой Host».
-{
+    /// </summary>
-    /// <summary>
+    public string[] AllowedOrigins { get; set; } = [];
-    /// Явный allowlist Origin/CORS (схема://хост[:порт]); пусто — dev-режим «любой origin + свой Host».
+}
-    /// </summary>
-    public string[] AllowedOrigins { get; set; } = [];
-}

src/core/Deal.Api/Dtos/AdminTickResultDto.cs

@@ -1,29 +1,26 @@
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Api.Services;
+
-using Deal.Api;
+namespace Deal.Api.Dtos;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Dtos;
+/// Ответ POST /api/admin/tick — форма {storage, reminders, pipeline, queue} (dashboard_routes.py admin_tick L327–337, план Task 10).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Ответ POST /api/admin/tick — форма {storage, reminders, pipeline, queue} (dashboard_routes.py admin_tick L327–337, план Task 10).
+/// Поля 1:1 с прототипом: storage — статистика тика правил хранения с очисткой отсева
-/// </summary>
+/// (<see cref="StorageTickStatsDto"/>, purgedRejected объединяет purge пайплайна — Ruling 9, tick_storage
-/// <remarks>
+/// L485–493); reminders — «выстрелившие» напоминания «Отложено» этапа 5 (план Task 11, Ruling 3/8): те же
-/// Поля 1:1 с прототипом: storage — статистика тика правил хранения с очисткой отсева
+/// записи {id,title,containerId}, что ушли SSE-событиями reminder_due (check_reminders admin_tick L334/L337),
-/// (<see cref="StorageTickStatsDto"/>, purgedRejected объединяет purge пайплайна — Ruling 9, tick_storage
+/// пусто — сработавших нет либо проверка недоступна; pipeline — счётчики одного прохода pump (ключи словаря
-/// L485–493); reminders — «выстрелившие» напоминания «Отложено» этапа 5 (план Task 11, Ruling 3/8): те же
+/// python L921: staged/rulesStored/mlStored/mlDrop/typeDrop/aiStored/aiDrop/aiFail/noBudget; пусто — pump не
-/// записи {id,title,containerId}, что ушли SSE-событиями reminder_due (check_reminders admin_tick L334/L337),
+/// выполнялся/сбой, как {} при занятом локе прототипа); queue — число строк очереди входящих после pump
-/// пусто — сработавших нет либо проверка недоступна; pipeline — счётчики одного прохода pump (ключи словаря
+/// (queue_len L337). Наружу сериализуется в camelCase (storage/reminders/pipeline/queue).
-/// python L921: staged/rulesStored/mlStored/mlDrop/typeDrop/aiStored/aiDrop/aiFail/noBudget; пусто — pump не
+/// </remarks>
-/// выполнялся/сбой, как {} при занятом локе прототипа); queue — число строк очереди входящих после pump
+/// <param name="Storage">Статистика тика правил хранения (включая purgedRejected — очистку отсева 3 суток).</param>
-/// (queue_len L337). Наружу сериализуется в camelCase (storage/reminders/pipeline/queue).
+/// <param name="Reminders">«Выстрелившие» напоминания {id,title,containerId} — список SSE reminder_due тика.</param>
-/// </remarks>
+/// <param name="Pipeline">Счётчики pump: словарь ключей прототипа; пуст, если pump не дал результата.</param>
-/// <param name="Storage">Статистика тика правил хранения (включая purgedRejected — очистку отсева 3 суток).</param>
+/// <param name="Queue">Строк очереди входящих после прохода pump (queue_len).</param>
-/// <param name="Reminders">«Выстрелившие» напоминания {id,title,containerId} — список SSE reminder_due тика.</param>
+public sealed record AdminTickResultDto(
-/// <param name="Pipeline">Счётчики pump: словарь ключей прототипа; пуст, если pump не дал результата.</param>
+    StorageTickStatsDto Storage,
-/// <param name="Queue">Строк очереди входящих после прохода pump (queue_len).</param>
+    IReadOnlyList<CardReminderDueDto> Reminders,
-public sealed record AdminTickResultDto(
+    IReadOnlyDictionary<string, int> Pipeline,
-    StorageTickStatsDto Storage,
+    int Queue);
-    IReadOnlyList<CardReminderDueDto> Reminders,
-    IReadOnlyDictionary<string, int> Pipeline,
-    int Queue);

src/core/Deal.Api/Endpoints/AiCheckEndpoint.cs

@@ -1,176 +1,172 @@
-using System.Text.Json;
+using System.Text.Json;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Settings.Application.Abstractions;
-using Deal.Modules.Settings.Application.Abstractions;
+using Deal.Modules.Settings.Application.Models;
-using Deal.Modules.Settings.Application.Models;
+
-using Deal.Modules.Settings.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Settings.Application.Services;
+
-using Deal.Api.Dtos;
+/// <summary>
-
+/// Эндпоинт проверки подключения AI-провайдера: POST /api/ai/check (Ruling 7/8, api-map §4.10).
-namespace Deal.Api.Endpoints;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// «Только для Settings-экрана» (Ruling 8): фронт жмёт «Проверить подключение» (store.js
-/// Эндпоинт проверки подключения AI-провайдера: POST /api/ai/check (Ruling 7/8, api-map §4.10).
+/// checkAiConnection) БЕЗ тела — сервер читает АКТИВНУЮ конфигурацию провайдера тенанта
-/// </summary>
+/// (настройки <c>aiProvider</c> + <c>aiConfigs</c> с расшифровкой ключа через <see cref="ISecretCipher"/>;
-/// <remarks>
+/// 1:1 с ai_svc._cfg(), ai.py L25–33), вызывает порт <see cref="IAiConnectionChecker"/> и отдаёт
-/// «Только для Settings-экрана» (Ruling 8): фронт жмёт «Проверить подключение» (store.js
+/// {ok, message} + статус провайдера. Требует сессию: 401 {detail} (формат прототипа).
-/// checkAiConnection) БЕЗ тела — сервер читает АКТИВНУЮ конфигурацию провайдера тенанта
+/// Резолв scoped-зависимостей — через RequestServices ПОСЛЕ проверки сессии (как SettingsEndpoints:
-/// (настройки <c>aiProvider</c> + <c>aiConfigs</c> с расшифровкой ключа через <see cref="ISecretCipher"/>;
+/// DI-биндинг параметров выполняется до тела, а ISettingsStore требует tenant-контекст запроса).
-/// 1:1 с ai_svc._cfg(), ai.py L25–33), вызывает порт <see cref="IAiConnectionChecker"/> и отдаёт
+/// </remarks>
-/// {ok, message} + статус провайдера. Требует сессию: 401 {detail} (формат прототипа).
+public static class AiCheckEndpoint
-/// Резолв scoped-зависимостей — через RequestServices ПОСЛЕ проверки сессии (как SettingsEndpoints:
+{
-/// DI-биндинг параметров выполняется до тела, а ISettingsStore требует tenant-контекст запроса).
+    // Префикс группы API (общий для эндпоинтов этапа, Ruling 8).
-/// </remarks>
+    private const string ApiGroupPrefix = "/api";
-public static class AiCheckEndpoint
+
-{
+    // Путь проверки подключения AI-провайдера.
-    // Префикс группы API (общий для эндпоинтов этапа, Ruling 8).
+    private const string AiCheckPath = "/ai/check";
-    private const string ApiGroupPrefix = "/api";
+
-
+    // OpenAPI-тег группы (в прототипе роутер settings — settings_routes.py).
-    // Путь проверки подключения AI-провайдера.
+    private const string OpenApiTag = "settings";
-    private const string AiCheckPath = "/ai/check";
+
-
+    /// <summary>
-    // OpenAPI-тег группы (в прототипе роутер settings — settings_routes.py).
+    /// Регистрирует POST /api/ai/check.
-    private const string OpenApiTag = "settings";
+    /// </summary>
-
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// <summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// Регистрирует POST /api/ai/check.
+    public static IEndpointRouteBuilder MapAiCheckEndpoint(this IEndpointRouteBuilder app)
-    /// </summary>
+    {
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        var group = app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        group.MapPost(AiCheckPath, CheckAsync);
-    public static IEndpointRouteBuilder MapAiCheckEndpoint(this IEndpointRouteBuilder app)
+        return app;
-    {
+    }
-        var group = app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag);
+
-        group.MapPost(AiCheckPath, CheckAsync);
+    // POST /api/ai/check: проверка соединения с активным AI-провайдером тенанта.
-        return app;
+    private static async Task<IResult> CheckAsync(HttpContext context, CancellationToken ct)
-    }
+    {
-
+        if (context.GetCurrentUser() is null)
-    // POST /api/ai/check: проверка соединения с активным AI-провайдером тенанта.
+        {
-    private static async Task<IResult> CheckAsync(HttpContext context, CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (context.GetCurrentUser() is null)
+
-        {
+        // Резолв после 401-гейта: ISettingsStore — scoped на TenantDbContext (tenant-контекст запроса).
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        ISettingsStore store = context.RequestServices.GetRequiredService<ISettingsStore>();
-        }
+        ISecretCipher secretCipher = context.RequestServices.GetRequiredService<ISecretCipher>();
-
+        IAiConnectionChecker checker = context.RequestServices.GetRequiredService<IAiConnectionChecker>();
-        // Резолв после 401-гейта: ISettingsStore — scoped на TenantDbContext (tenant-контекст запроса).
+
-        ISettingsStore store = context.RequestServices.GetRequiredService<ISettingsStore>();
+        AiCheckRequest checkRequest = await BuildActiveCheckRequestAsync(store, secretCipher, ct);
-        ISecretCipher secretCipher = context.RequestServices.GetRequiredService<ISecretCipher>();
+        AiCheckResultDto result = await checker.CheckAsync(checkRequest, ct);
-        IAiConnectionChecker checker = context.RequestServices.GetRequiredService<IAiConnectionChecker>();
+        return Results.Ok(result);
-
+    }
-        AiCheckRequest checkRequest = await BuildActiveCheckRequestAsync(store, secretCipher, ct);
+
-        AiCheckResultDto result = await checker.CheckAsync(checkRequest, ct);
+    // Собирает запрос проверки из активной конфигурации провайдера (1:1 с ai_svc._cfg()).
-        return Results.Ok(result);
+    // store: KV-хранилище настроек тенанта.
-    }
+    // secretCipher: Шифр секретов (расшифровка apiKey).
-
+    // ct: Токен отмены.
-    // Собирает запрос проверки из активной конфигурации провайдера (1:1 с ai_svc._cfg()).
+    // Возвращает: Запрос проверки: id провайдера + эффективные base/model + расшифрованный ключ.
-    // store: KV-хранилище настроек тенанта.
+    // Эффективные значения = дефолты SettingsDefaults, перекрытые сохранёнными
-    // secretCipher: Шифр секретов (расшифровка apiKey).
+    // переопределениями (Ruling 1); пустое переопределение base/model → дефолт каталога
-    // ct: Токен отмены.
+    // (семантика «cfg.get(...) or meta[...]» прототипа).
-    // Возвращает: Запрос проверки: id провайдера + эффективные base/model + расшифрованный ключ.
+    private static async Task<AiCheckRequest> BuildActiveCheckRequestAsync(
-    // Эффективные значения = дефолты SettingsDefaults, перекрытые сохранёнными
+        ISettingsStore store,
-    // переопределениями (Ruling 1); пустое переопределение base/model → дефолт каталога
+        ISecretCipher secretCipher,
-    // (семантика «cfg.get(...) or meta[...]» прототипа).
+        CancellationToken ct)
-    private static async Task<AiCheckRequest> BuildActiveCheckRequestAsync(
+    {
-        ISettingsStore store,
+        string providerId = await ReadActiveProviderIdAsync(store, ct);
-        ISecretCipher secretCipher,
+        AiProviderDefinition? meta = AiProviders.All.FirstOrDefault(provider => provider.Id == providerId);
-        CancellationToken ct)
+
-    {
+        // Неизвестный id (ручное вмешательство в БД — PATCH-гейт SettingsService не даёт сохранить):
-        string providerId = await ReadActiveProviderIdAsync(store, ct);
+        // HTTP не выполняется — ответит SSRF-гейт checker (allowlist).
-        AiProviderDefinition? meta = AiProviders.All.FirstOrDefault(provider => provider.Id == providerId);
+        if (meta is null)
-
+        {
-        // Неизвестный id (ручное вмешательство в БД — PATCH-гейт SettingsService не даёт сохранить):
+            return new AiCheckRequest(providerId, string.Empty, string.Empty, string.Empty, IsLocal: false, ApiStyle: null);
-        // HTTP не выполняется — ответит SSRF-гейт checker (allowlist).
+        }
-        if (meta is null)
+
-        {
+        AiConfigSetting config = await ReadEffectiveConfigAsync(store, providerId, ct);
-            return new AiCheckRequest(providerId, string.Empty, string.Empty, string.Empty, IsLocal: false, ApiStyle: null);
+        string apiKey = secretCipher.Decrypt(config.ApiKey);
-        }
+        string baseUrl = string.IsNullOrEmpty(config.BaseUrl) ? meta.Base : config.BaseUrl;
-
+        string model = string.IsNullOrEmpty(config.Model)
-        AiConfigSetting config = await ReadEffectiveConfigAsync(store, providerId, ct);
+            ? meta.Models.FirstOrDefault() ?? string.Empty
-        string apiKey = secretCipher.Decrypt(config.ApiKey);
+            : config.Model;
-        string baseUrl = string.IsNullOrEmpty(config.BaseUrl) ? meta.Base : config.BaseUrl;
+
-        string model = string.IsNullOrEmpty(config.Model)
+        return new AiCheckRequest(providerId, baseUrl, model, apiKey, meta.Local, meta.ApiStyle);
-            ? meta.Models.FirstOrDefault() ?? string.Empty
+    }
-            : config.Model;
+
-
+    // Читает активный провайдер: сохранённый aiProvider или дефолт (повреждённое значение — дефолт).
-        return new AiCheckRequest(providerId, baseUrl, model, apiKey, meta.Local, meta.ApiStyle);
+    // store: KV-хранилище настроек тенанта.
-    }
+    // ct: Токен отмены.
-
+    // Возвращает: id провайдера.
-    // Читает активный провайдер: сохранённый aiProvider или дефолт (повреждённое значение — дефолт).
+    private static async Task<string> ReadActiveProviderIdAsync(ISettingsStore store, CancellationToken ct)
-    // store: KV-хранилище настроек тенанта.
+    {
-    // ct: Токен отмены.
+        SettingValue? row = await store.GetAsync(SettingsKeys.AiProvider, ct);
-    // Возвращает: id провайдера.
+        if (row is null)
-    private static async Task<string> ReadActiveProviderIdAsync(ISettingsStore store, CancellationToken ct)
+        {
-    {
+            return SettingsDefaults.AiProvider;
-        SettingValue? row = await store.GetAsync(SettingsKeys.AiProvider, ct);
+        }
-        if (row is null)
+
-        {
+        try
-            return SettingsDefaults.AiProvider;
+        {
-        }
+            using JsonDocument document = JsonDocument.Parse(row.ValueJson);
-
+            if (document.RootElement.ValueKind == JsonValueKind.String)
-        try
+            {
-        {
+                return document.RootElement.GetString() ?? SettingsDefaults.AiProvider;
-            using JsonDocument document = JsonDocument.Parse(row.ValueJson);
+            }
-            if (document.RootElement.ValueKind == JsonValueKind.String)
+        }
-            {
+        catch (JsonException)
-                return document.RootElement.GetString() ?? SettingsDefaults.AiProvider;
+        {
-            }
+            // Повреждённая строка — дефолт (мягкая семантика, как в SettingsService).
-        }
+        }
-        catch (JsonException)
+
-        {
+        return SettingsDefaults.AiProvider;
-            // Повреждённая строка — дефолт (мягкая семантика, как в SettingsService).
+    }
-        }
+
-
+    // Эффективный конфиг провайдера: дефолт SettingsDefaults, перекрытый сохранённым aiConfigs.
-        return SettingsDefaults.AiProvider;
+    // store: KV-хранилище настроек тенанта.
-    }
+    // providerId: Активный провайдер (id из каталога).
-
+    // ct: Токен отмены.
-    // Эффективный конфиг провайдера: дефолт SettingsDefaults, перекрытый сохранённым aiConfigs.
+    // Возвращает: Конфиг {apiKey, baseUrl, model}; повреждённая строка aiConfigs — дефолт.
-    // store: KV-хранилище настроек тенанта.
+    private static async Task<AiConfigSetting> ReadEffectiveConfigAsync(
-    // providerId: Активный провайдер (id из каталога).
+        ISettingsStore store,
-    // ct: Токен отмены.
+        string providerId,
-    // Возвращает: Конфиг {apiKey, baseUrl, model}; повреждённая строка aiConfigs — дефолт.
+        CancellationToken ct)
-    private static async Task<AiConfigSetting> ReadEffectiveConfigAsync(
+    {
-        ISettingsStore store,
+        AiConfigSetting defaults = SettingsDefaults.AiConfigs[providerId];
-        string providerId,
+        SettingValue? row = await store.GetAsync(SettingsKeys.AiConfigs, ct);
-        CancellationToken ct)
+        if (row is null)
-    {
+        {
-        AiConfigSetting defaults = SettingsDefaults.AiConfigs[providerId];
+            return defaults;
-        SettingValue? row = await store.GetAsync(SettingsKeys.AiConfigs, ct);
+        }
-        if (row is null)
+
-        {
+        try
-            return defaults;
+        {
-        }
+            using JsonDocument document = JsonDocument.Parse(row.ValueJson);
-
+            JsonElement root = document.RootElement;
-        try
+            if (root.ValueKind == JsonValueKind.Object
-        {
+                && root.TryGetProperty(providerId, out JsonElement entry)
-            using JsonDocument document = JsonDocument.Parse(row.ValueJson);
+                && entry.ValueKind == JsonValueKind.Object)
-            JsonElement root = document.RootElement;
+            {
-            if (root.ValueKind == JsonValueKind.Object
+                return new AiConfigSetting(
-                && root.TryGetProperty(providerId, out JsonElement entry)
+                    ApiKey: ReadField(entry, "apiKey") ?? defaults.ApiKey,
-                && entry.ValueKind == JsonValueKind.Object)
+                    BaseUrl: ReadField(entry, "baseUrl") ?? defaults.BaseUrl,
-            {
+                    Model: ReadField(entry, "model") ?? defaults.Model);
-                return new AiConfigSetting(
+            }
-                    ApiKey: ReadField(entry, "apiKey") ?? defaults.ApiKey,
+        }
-                    BaseUrl: ReadField(entry, "baseUrl") ?? defaults.BaseUrl,
+        catch (JsonException)
-                    Model: ReadField(entry, "model") ?? defaults.Model);
+        {
-            }
+            // Повреждённая строка — дефолт (не роняем проверку).
-        }
+        }
-        catch (JsonException)
+
-        {
+        return defaults;
-            // Повреждённая строка — дефолт (не роняем проверку).
+    }
-        }
+
-
+    // Читает строковое поле объекта конфигурации (имена полей camelCase, как пишет SettingsService).
-        return defaults;
+    // entry: JSON-объект конфигурации провайдера.
-    }
+    // field: Имя поля (apiKey/baseUrl/model).
-
+    // Возвращает: Значение или null, если поле отсутствует/не строка.
-    // Читает строковое поле объекта конфигурации (имена полей camelCase, как пишет SettingsService).
+    private static string? ReadField(JsonElement entry, string field)
-    // entry: JSON-объект конфигурации провайдера.
+    {
-    // field: Имя поля (apiKey/baseUrl/model).
+        return entry.TryGetProperty(field, out JsonElement value) && value.ValueKind == JsonValueKind.String
-    // Возвращает: Значение или null, если поле отсутствует/не строка.
+            ? value.GetString()
-    private static string? ReadField(JsonElement entry, string field)
+            : null;
-    {
+    }
-        return entry.TryGetProperty(field, out JsonElement value) && value.ValueKind == JsonValueKind.String
+}
-            ? value.GetString()
-            : null;
-    }
-}

src/core/Deal.Api/Endpoints/AiSuggestEndpoints.cs

@@ -1,99 +1,97 @@
-using Deal.Api.Events;
+using Deal.Api.Events;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Contracts.Integrations.Abstractions;
-using Deal.Contracts.Integrations.Abstractions;
+using Deal.Contracts.Integrations.Models;
-using Deal.Contracts.Integrations.Models;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Endpoints;
-
+
-namespace Deal.Api.Endpoints;
+/// <summary>
-
+/// Эндпоинты ИИ-предложений: POST /api/ai/suggest-columns и POST /api/ai/suggest-keywords
-/// <summary>
+/// (план Task 14 L476–479; прототип dashboard_routes.py L395–409).
-/// Эндпоинты ИИ-предложений: POST /api/ai/suggest-columns и POST /api/ai/suggest-keywords
+/// </summary>
-/// (план Task 14 L476–479; прототип dashboard_routes.py L395–409).
+/// <remarks>
-/// </summary>
+/// Контракт 1:1 с прототипом и api-map §3.2 L120–121: suggest-columns → <c>{ok:true, created:N}</c>
-/// <remarks>
+/// либо <c>{ok:false, reason, cooldown?}</c>; suggest-keywords → <c>{ok:true, keywords:[…]}</c> либо
-/// Контракт 1:1 с прототипом и api-map §3.2 L120–121: suggest-columns → <c>{ok:true, created:N}</c>
+/// <c>{ok:false, reason}</c>. Причины — мягкие ошибки (HTTP 200 с ok:false + reason), статусы 4xx/5xx
-/// либо <c>{ok:false, reason, cooldown?}</c>; suggest-keywords → <c>{ok:true, keywords:[…]}</c> либо
+/// не мапятся. Оба требуют сессию: 401 {detail} без куки (как остальные эндпоинты контейнеров); порт
-/// <c>{ok:false, reason}</c>. Причины — мягкие ошибки (HTTP 200 с ok:false + reason), статусы 4xx/5xx
+/// IColumnSuggester резолвится из RequestServices ПОСЛЕ проверки сессии (scoped на tenant-контекст
-/// не мапятся. Оба требуют сессию: 401 {detail} без куки (как остальные эндпоинты контейнеров); порт
+/// запроса). При успехе suggest-columns публикуется SSE-toast «ИИ предложил колонок: N — откройте и
-/// IColumnSuggester резолвится из RequestServices ПОСЛЕ проверки сессии (scoped на tenant-контекст
+/// решите» (sparkles, 1:1 с suggest.py L162); boards_changed НЕ шлём (Ruling 5: фронт перечитывает
-/// запроса). При успехе suggest-columns публикуется SSE-toast «ИИ предложил колонок: N — откройте и
+/// доски сам после ok). Публикации — из эндпоинта (Ruling 5): без подписчиков — no-op.
-/// решите» (sparkles, 1:1 с suggest.py L162); boards_changed НЕ шлём (Ruling 5: фронт перечитывает
+/// </remarks>
-/// доски сам после ok). Публикации — из эндпоинта (Ruling 5): без подписчиков — no-op.
+public static class AiSuggestEndpoints
-/// </remarks>
+{
-public static class AiSuggestEndpoints
+    // Префикс группы AI-эндпоинтов этапа (роутер dashboard, prefix="/api"; пути L395/L406).
-{
+    private const string AiGroupPrefix = "/api/ai";
-    // Префикс группы AI-эндпоинтов этапа (роутер dashboard, prefix="/api"; пути L395/L406).
+
-    private const string AiGroupPrefix = "/api/ai";
+    // Путь предложения колонок (dashboard_routes.py L395).
-
+    private const string SuggestColumnsPath = "/suggest-columns";
-    // Путь предложения колонок (dashboard_routes.py L395).
+
-    private const string SuggestColumnsPath = "/suggest-columns";
+    // Путь предложения ключевых слов (dashboard_routes.py L404).
-
+    private const string SuggestKeywordsPath = "/suggest-keywords";
-    // Путь предложения ключевых слов (dashboard_routes.py L404).
+
-    private const string SuggestKeywordsPath = "/suggest-keywords";
+    // OpenAPI-тег группы (в прототипе роутер dashboard — dashboard_routes.py).
-
+    private const string OpenApiTag = "dashboard";
-    // OpenAPI-тег группы (в прототипе роутер dashboard — dashboard_routes.py).
+
-    private const string OpenApiTag = "dashboard";
+    // SSE-тип события тоста (Ruling 5; api.js слушает 'toast').
-
+    private const string ToastEventType = "toast";
-    // SSE-тип события тоста (Ruling 5; api.js слушает 'toast').
+
-    private const string ToastEventType = "toast";
+    // Текст тоста после успешных предложений колонок (suggest.py L162, 1:1).
-
+    private const string SuggestToastTextFormat = "ИИ предложил колонок: {0} — откройте и решите";
-    // Текст тоста после успешных предложений колонок (suggest.py L162, 1:1).
+
-    private const string SuggestToastTextFormat = "ИИ предложил колонок: {0} — откройте и решите";
+    // Иконка тоста предложений колонок (sparkles, 1:1 с прототипом).
-
+    private const string SparklesIcon = "sparkles";
-    // Иконка тоста предложений колонок (sparkles, 1:1 с прототипом).
+
-    private const string SparklesIcon = "sparkles";
+    /// <summary>
-
+    /// Регистрирует POST /api/ai/suggest-columns и POST /api/ai/suggest-keywords.
-    /// <summary>
+    /// </summary>
-    /// Регистрирует POST /api/ai/suggest-columns и POST /api/ai/suggest-keywords.
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// </summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <param name="app">Построитель маршрутов приложения.</param>
+    public static IEndpointRouteBuilder MapAiSuggestEndpoints(this IEndpointRouteBuilder app)
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+    {
-    public static IEndpointRouteBuilder MapAiSuggestEndpoints(this IEndpointRouteBuilder app)
+        var group = app.MapGroup(AiGroupPrefix).WithTags(OpenApiTag);
-    {
+        group.MapPost(SuggestColumnsPath, SuggestColumnsAsync);
-        var group = app.MapGroup(AiGroupPrefix).WithTags(OpenApiTag);
+        group.MapPost(SuggestKeywordsPath, SuggestKeywordsAsync);
-        group.MapPost(SuggestColumnsPath, SuggestColumnsAsync);
+        return app;
-        group.MapPost(SuggestKeywordsPath, SuggestKeywordsAsync);
+    }
-        return app;
+
-    }
+    // POST /api/ai/suggest-columns: анализ «Неразобранного» и создание колонок-предложений.
-
+    // Ответ — результат порта 1:1: {ok:true, created:N} — доски suggested=true созданы (эндпоинт шлёт
-    // POST /api/ai/suggest-columns: анализ «Неразобранного» и создание колонок-предложений.
+    // SSE-toast), {ok:false, reason} (+ cooldown) — мягкая причина (HTTP 200). Кулдаун/«мало карточек»/
-    // Ответ — результат порта 1:1: {ok:true, created:N} — доски suggested=true созданы (эндпоинт шлёт
+    // «похожие колонки уже есть» — за адаптером LocalColumnSuggester (Ruling 3).
-    // SSE-toast), {ok:false, reason} (+ cooldown) — мягкая причина (HTTP 200). Кулдаун/«мало карточек»/
+    private static async Task<IResult> SuggestColumnsAsync(HttpContext context, CancellationToken ct)
-    // «похожие колонки уже есть» — за адаптером LocalColumnSuggester (Ruling 3).
+    {
-    private static async Task<IResult> SuggestColumnsAsync(HttpContext context, CancellationToken ct)
+        if (!context.HasUser())
-    {
+        {
-        if (!context.HasUser())
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        IColumnSuggester suggester = context.RequestServices.GetRequiredService<IColumnSuggester>();
-
+        SuggestColumnsResultDto result = await suggester.SuggestColumnsAsync(ct);
-        IColumnSuggester suggester = context.RequestServices.GetRequiredService<IColumnSuggester>();
+        if (result.Ok)
-        SuggestColumnsResultDto result = await suggester.SuggestColumnsAsync(ct);
+        {
-        if (result.Ok)
+            SseBroker broker = context.RequestServices.GetRequiredService<SseBroker>();
-        {
+            broker.Publish(
-            SseBroker broker = context.RequestServices.GetRequiredService<SseBroker>();
+                context.GetCurrentUser()!.TenantId,
-            broker.Publish(
+                ToastEventType,
-                context.GetCurrentUser()!.TenantId,
+                new { text = string.Format(SuggestToastTextFormat, result.Created), icon = SparklesIcon });
-                ToastEventType,
+        }
-                new { text = string.Format(SuggestToastTextFormat, result.Created), icon = SparklesIcon });
+
-        }
+        return Results.Ok(result);
-
+    }
-        return Results.Ok(result);
+
-    }
+    // POST /api/ai/suggest-keywords: слова-маркеры сферы по карточкам (настройки «Сфера и ключи»).
-
+    // Ответ — результат порта 1:1: {ok:true, keywords:[…]} (≤60) либо {ok:false, reason} (HTTP 200).
-    // POST /api/ai/suggest-keywords: слова-маркеры сферы по карточкам (настройки «Сфера и ключи»).
+    private static async Task<IResult> SuggestKeywordsAsync(HttpContext context, CancellationToken ct)
-    // Ответ — результат порта 1:1: {ok:true, keywords:[…]} (≤60) либо {ok:false, reason} (HTTP 200).
+    {
-    private static async Task<IResult> SuggestKeywordsAsync(HttpContext context, CancellationToken ct)
+        if (!context.HasUser())
-    {
+        {
-        if (!context.HasUser())
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        IColumnSuggester suggester = context.RequestServices.GetRequiredService<IColumnSuggester>();
-
+        SuggestKeywordsResultDto result = await suggester.SuggestKeywordsAsync(ct);
-        IColumnSuggester suggester = context.RequestServices.GetRequiredService<IColumnSuggester>();
+        return Results.Ok(result);
-        SuggestKeywordsResultDto result = await suggester.SuggestKeywordsAsync(ct);
+    }
-        return Results.Ok(result);
+}
-    }
-}

src/core/Deal.Api/Endpoints/AuthEndpoints.cs

@@ -1,217 +1,213 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Middleware;
-using Deal.Api.Services;
+using Deal.Api.Models;
-using Deal.Api.Middleware;
+using Deal.Api.Services;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Extensions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Models;
+using Microsoft.Extensions.Options;
-using Deal.Modules.Tenants.Application.Registrars;
+// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
-using Deal.Modules.Tenants.Application.Services;
+using CookieOptions = Deal.Api.Configuration.CookieOptions;
-using Microsoft.Extensions.Options;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Endpoints;
-// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
+
-using CookieOptions = Deal.Api.Configuration.CookieOptions;
+/// <summary>
-
+/// HTTP-эндпоинты аутентификации (группа /api/auth). Контракт 1:1 с прототипом auth_routes.py.
-namespace Deal.Api.Endpoints;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// Успех-ответы — <c>{ok:true,...}</c>, ошибки — HTTP-код + <c>{"detail":"..."}</c> (Ruling 10).
-/// HTTP-эндпоинты аутентификации (группа /api/auth). Контракт 1:1 с прототипом auth_routes.py.
+/// Кука сессии выставляется на login и change-password (свежий токен). Сообщения об ошибках —
-/// </summary>
+/// фиксированные строки прототипа.
-/// <remarks>
+/// </remarks>
-/// Успех-ответы — <c>{ok:true,...}</c>, ошибки — HTTP-код + <c>{"detail":"..."}</c> (Ruling 10).
+public static class AuthEndpoints
-/// Кука сессии выставляется на login и change-password (свежий токен). Сообщения об ошибках —
+{
-/// фиксированные строки прототипа.
+    private const string InvalidCredentialsDetail = "Неверный логин или пароль";
-/// </remarks>
+    private const string WrongOldPasswordDetail = "Текущий пароль неверен";
-public static class AuthEndpoints
+    private const string PasswordTooShortDetail = "Пароль слишком короткий (минимум 8 символов)";
-{
+    private const string TenantSuspendedDetail = "Учётная запись приостановлена. Обратитесь к оператору";
-    private const string InvalidCredentialsDetail = "Неверный логин или пароль";
+    private const string AuthGroupPrefix = "/api/auth";
-    private const string WrongOldPasswordDetail = "Текущий пароль неверен";
+    private const string AuthOpenApiTag = "auth";
-    private const string PasswordTooShortDetail = "Пароль слишком короткий (минимум 8 символов)";
+
-    private const string TenantSuspendedDetail = "Учётная запись приостановлена. Обратитесь к оператору";
+    /// <summary>
-    private const string AuthGroupPrefix = "/api/auth";
+    /// Регистрирует группу /api/auth: login, logout, me, change-password.
-    private const string AuthOpenApiTag = "auth";
+    /// </summary>
-
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// <summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// Регистрирует группу /api/auth: login, logout, me, change-password.
+    public static IEndpointRouteBuilder MapAuthEndpoints(this IEndpointRouteBuilder app)
-    /// </summary>
+    {
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        var group = app.MapGroup(AuthGroupPrefix).WithTags(AuthOpenApiTag);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+
-    public static IEndpointRouteBuilder MapAuthEndpoints(this IEndpointRouteBuilder app)
+        // Политика "auth" rate limiter (план Task 11, Ruling 5): фиксированное окно 10/мин на IP
-    {
+        // ручки входа; остальные ручки группы — под глобальной API-политикой (по тенанту/IP).
-        var group = app.MapGroup(AuthGroupPrefix).WithTags(AuthOpenApiTag);
+        group.MapPost("/login", LoginAsync).RequireRateLimiting(RateLimitPolicies.AuthPolicy);
-
+        group.MapPost("/logout", LogoutAsync);
-        // Политика "auth" rate limiter (план Task 11, Ruling 5): фиксированное окно 10/мин на IP
+        group.MapGet("/me", MeAsync);
-        // ручки входа; остальные ручки группы — под глобальной API-политикой (по тенанту/IP).
+        group.MapPost("/change-password", ChangePasswordAsync);
-        group.MapPost("/login", LoginAsync).RequireRateLimiting(RateLimitPolicies.AuthPolicy);
+
-        group.MapPost("/logout", LogoutAsync);
+        return app;
-        group.MapGet("/me", MeAsync);
+    }
-        group.MapPost("/change-password", ChangePasswordAsync);
+
-
+    // POST /api/auth/login: проверка учётных данных, выдача куки сессии; результат пишется в аудит (Task 4/7).
-        return app;
+    // До AuthService отрабатывает LoginAttemptGuard (5 неудач ip|login за 15 мин → 429, Ruling 5).
-    }
+    private static async Task<IResult> LoginAsync(
-
+        LoginRequest body,
-    // POST /api/auth/login: проверка учётных данных, выдача куки сессии; результат пишется в аудит (Task 4/7).
+        AuthService authService,
-    // До AuthService отрабатывает LoginAttemptGuard (5 неудач ip|login за 15 мин → 429, Ruling 5).
+        AuditService auditService,
-    private static async Task<IResult> LoginAsync(
+        IOptions<CookieOptions> cookieOptions,
-        LoginRequest body,
+        HttpContext context,
-        AuthService authService,
+        CancellationToken ct,
-        AuditService auditService,
+        LoginAttemptGuard loginAttemptGuard)
-        IOptions<CookieOptions> cookieOptions,
+    {
-        HttpContext context,
+        string? attemptedLogin = NormalizeLogin(body.Login);
-        CancellationToken ct,
+
-        LoginAttemptGuard loginAttemptGuard)
+        // Защита входа (план Task 11, Ruling 5): блокировка ключа ip|login до проверки учётных данных —
-    {
+        // 429 «Слишком много попыток входа…» (в dev при RateLimit:Enabled=false гвард выключен).
-        string? attemptedLogin = NormalizeLogin(body.Login);
+        if (await loginAttemptGuard.IsBlockedAsync(ClientIp(context), attemptedLogin, ct))
-
+        {
-        // Защита входа (план Task 11, Ruling 5): блокировка ключа ip|login до проверки учётных данных —
+            return EndpointResults.TooManyRequests(LoginAttemptGuard.BlockedDetail);
-        // 429 «Слишком много попыток входа…» (в dev при RateLimit:Enabled=false гвард выключен).
+        }
-        if (await loginAttemptGuard.IsBlockedAsync(ClientIp(context), attemptedLogin, ct))
+
-        {
+        var result = await authService.LoginAsync(body.Login, body.Password, ct);
-            return EndpointResults.TooManyRequests(LoginAttemptGuard.BlockedDetail);
+
-        }
+        // Приостановленный тенант: вход заблокирован (Ruling 10(5)). Отдельный текст от «неверных учётных
-
+        // данных»; tenant_login_failed пишется с tenantId и ActorId (ревью Task 4: failed-логины suspended-тенанта).
-        var result = await authService.LoginAsync(body.Login, body.Password, ct);
+        // Решение Task 7: HTTP-код 403 (а не 401) — учётка существует, доступ запрещён; приёмочный текст плана
-
+        // Task 16 формулирует «login 401» — отклонение зафиксировано для api-map/техдок в task-7-report.md.
-        // Приостановленный тенант: вход заблокирован (Ruling 10(5)). Отдельный текст от «неверных учётных
+        if (result.Error == LoginResultDto.ErrorTenantSuspended)
-        // данных»; tenant_login_failed пишется с tenantId и ActorId (ревью Task 4: failed-логины suspended-тенанта).
+        {
-        // Решение Task 7: HTTP-код 403 (а не 401) — учётка существует, доступ запрещён; приёмочный текст плана
+            await auditService.AppendAsync(new AuditRecordDto(
-        // Task 16 формулирует «login 401» — отклонение зафиксировано для api-map/техдок в task-7-report.md.
+                AuditEvents.TenantLoginFailed,
-        if (result.Error == LoginResultDto.ErrorTenantSuspended)
+                AuditActorTypes.Tenant,
-        {
+                ActorId: result.UserId,
-            await auditService.AppendAsync(new AuditRecordDto(
+                TenantId: result.TenantId,
-                AuditEvents.TenantLoginFailed,
+                Ip: ClientIp(context),
-                AuditActorTypes.Tenant,
+                DetailJson: AuditService.ToDetailJson(new { login = NormalizeLogin(body.Login) })), ct);
-                ActorId: result.UserId,
+
-                TenantId: result.TenantId,
+            return EndpointResults.Forbidden(TenantSuspendedDetail);
-                Ip: ClientIp(context),
+        }
-                DetailJson: AuditService.ToDetailJson(new { login = NormalizeLogin(body.Login) })), ct);
+
-
+        if (result.Login is null || result.Token is null)
-            return EndpointResults.Forbidden(TenantSuspendedDetail);
+        {
-        }
+            // Пустой/пробельный login и неверные учётные данные — одно сообщение (семантика прототипа).
-
+            // Аудит tenant_login_failed пишем только для реальной попытки (непустой логин), без пароля (Ruling 4);
-        if (result.Login is null || result.Token is null)
+            // счётчик неудач гварда растёт там же — пустые логины ключа не имеют (блокирует только auth-политика).
-        {
+            if (attemptedLogin is not null)
-            // Пустой/пробельный login и неверные учётные данные — одно сообщение (семантика прототипа).
+            {
-            // Аудит tenant_login_failed пишем только для реальной попытки (непустой логин), без пароля (Ruling 4);
+                await loginAttemptGuard.RecordFailureAsync(ClientIp(context), attemptedLogin, ct);
-            // счётчик неудач гварда растёт там же — пустые логины ключа не имеют (блокирует только auth-политика).
+                await auditService.AppendAsync(new AuditRecordDto(
-            if (attemptedLogin is not null)
+                    AuditEvents.TenantLoginFailed,
-            {
+                    AuditActorTypes.Tenant,
-                await loginAttemptGuard.RecordFailureAsync(ClientIp(context), attemptedLogin, ct);
+                    ActorId: null,
-                await auditService.AppendAsync(new AuditRecordDto(
+                    TenantId: null,
-                    AuditEvents.TenantLoginFailed,
+                    Ip: ClientIp(context),
-                    AuditActorTypes.Tenant,
+                    DetailJson: AuditService.ToDetailJson(new { login = attemptedLogin })), ct);
-                    ActorId: null,
+            }
-                    TenantId: null,
+
-                    Ip: ClientIp(context),
+            return EndpointResults.Unauthorized(InvalidCredentialsDetail);
-                    DetailJson: AuditService.ToDetailJson(new { login = attemptedLogin })), ct);
+        }
-            }
+
-
+        // Успешный вход сбрасывает счётчик неудач ключа ip|login (Ruling 5).
-            return EndpointResults.Unauthorized(InvalidCredentialsDetail);
+        await loginAttemptGuard.ResetAsync(ClientIp(context), result.Login, ct);
-        }
+
-
+        await auditService.AppendAsync(new AuditRecordDto(
-        // Успешный вход сбрасывает счётчик неудач ключа ip|login (Ruling 5).
+            AuditEvents.TenantLoginOk,
-        await loginAttemptGuard.ResetAsync(ClientIp(context), result.Login, ct);
+            AuditActorTypes.Tenant,
-
+            ActorId: result.UserId,
-        await auditService.AppendAsync(new AuditRecordDto(
+            TenantId: result.TenantId,
-            AuditEvents.TenantLoginOk,
+            Ip: ClientIp(context),
-            AuditActorTypes.Tenant,
+            DetailJson: AuditService.ToDetailJson(new { login = result.Login })), ct);
-            ActorId: result.UserId,
+
-            TenantId: result.TenantId,
+        SessionCookieWriter.Append(context, cookieOptions.Value, result.Token);
-            Ip: ClientIp(context),
+        return Results.Ok(new { ok = true, login = result.Login });
-            DetailJson: AuditService.ToDetailJson(new { login = result.Login })), ct);
+    }
-
+
-        SessionCookieWriter.Append(context, cookieOptions.Value, result.Token);
+    // POST /api/auth/logout: удаление сессии по токену из куки и очистка куки (всегда ok).
-        return Results.Ok(new { ok = true, login = result.Login });
+    // Если удалённая сессия была impersonation — пишется аудит impersonation_stopped (Task 7, ревью: полный аудит).
-    }
+    private static async Task<IResult> LogoutAsync(
-
+        AuthService authService,
-    // POST /api/auth/logout: удаление сессии по токену из куки и очистка куки (всегда ok).
+        AuditService auditService,
-    // Если удалённая сессия была impersonation — пишется аудит impersonation_stopped (Task 7, ревью: полный аудит).
+        IOptions<CookieOptions> cookieOptions,
-    private static async Task<IResult> LogoutAsync(
+        HttpContext context,
-        AuthService authService,
+        CancellationToken ct)
-        AuditService auditService,
+    {
-        IOptions<CookieOptions> cookieOptions,
+        var cookieName = cookieOptions.Value.Name;
-        HttpContext context,
+        var rawToken = context.Request.Cookies[cookieName];
-        CancellationToken ct)
+        // Пользователь разрешённой сессии — до её удаления (SessionMiddleware наполнил Items на старте запроса).
-    {
+        CurrentUser? user = context.GetCurrentUser();
-        var cookieName = cookieOptions.Value.Name;
+        var logout = await authService.LogoutAsync(rawToken, ct);
-        var rawToken = context.Request.Cookies[cookieName];
+        if (logout is not null)
-        // Пользователь разрешённой сессии — до её удаления (SessionMiddleware наполнил Items на старте запроса).
+        {
-        CurrentUser? user = context.GetCurrentUser();
+            // Актор — оператор, начавший impersonation (маркер сессии); тенант — для фильтра TenantId.
-        var logout = await authService.LogoutAsync(rawToken, ct);
+            await auditService.AppendAsync(new AuditRecordDto(
-        if (logout is not null)
+                AuditEvents.ImpersonationStopped,
-        {
+                AuditActorTypes.Operator,
-            // Актор — оператор, начавший impersonation (маркер сессии); тенант — для фильтра TenantId.
+                ActorId: logout.OperatorId,
-            await auditService.AppendAsync(new AuditRecordDto(
+                TenantId: logout.TenantId,
-                AuditEvents.ImpersonationStopped,
+                Ip: ClientIp(context),
-                AuditActorTypes.Operator,
+                DetailJson: AuditService.ToDetailJson(new { login = logout.Login })), ct);
-                ActorId: logout.OperatorId,
+        }
-                TenantId: logout.TenantId,
+
-                Ip: ClientIp(context),
+        // Выход пользователя тенанта (этап 10, T1): событие пишется при живой разрешённой сессии.
-                DetailJson: AuditService.ToDetailJson(new { login = logout.Login })), ct);
+        if (user is not null)
-        }
+        {
-
+            await AuditAppender.AppendTenantAsync(context, AuditEvents.TenantLogout, new { login = user.Login }, ct);
-        // Выход пользователя тенанта (этап 10, T1): событие пишется при живой разрешённой сессии.
+        }
-        if (user is not null)
+
-        {
+        context.Response.Cookies.Delete(cookieName);
-            await AuditAppender.AppendTenantAsync(context, AuditEvents.TenantLogout, new { login = user.Login }, ct);
+        return Results.Ok(new { ok = true });
-        }
+    }
-
+
-        context.Response.Cookies.Delete(cookieName);
+    // GET /api/auth/me: проверка живой сессии.
-        return Results.Ok(new { ok = true });
+    private static IResult MeAsync(HttpContext context)
-    }
+    {
-
+        var user = context.GetCurrentUser();
-    // GET /api/auth/me: проверка живой сессии.
+        if (user is null)
-    private static IResult MeAsync(HttpContext context)
+        {
-    {
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        var user = context.GetCurrentUser();
+        }
-        if (user is null)
+
-        {
+        return Results.Ok(new { login = user.Login, ok = true });
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    }
-        }
+
-
+    // POST /api/auth/change-password: смена пароля и перевыпуск куки (свежая сессия).
-        return Results.Ok(new { login = user.Login, ok = true });
+    private static async Task<IResult> ChangePasswordAsync(
-    }
+        ChangePasswordRequest body,
-
+        AuthService authService,
-    // POST /api/auth/change-password: смена пароля и перевыпуск куки (свежая сессия).
+        IOptions<CookieOptions> cookieOptions,
-    private static async Task<IResult> ChangePasswordAsync(
+        HttpContext context,
-        ChangePasswordRequest body,
+        CancellationToken ct)
-        AuthService authService,
+    {
-        IOptions<CookieOptions> cookieOptions,
+        var user = context.GetCurrentUser();
-        HttpContext context,
+        if (user is null)
-        CancellationToken ct)
+        {
-    {
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        var user = context.GetCurrentUser();
+        }
-        if (user is null)
+
-        {
+        var result = await authService.ChangePasswordAsync(user.Login, body.OldPassword, body.NewPassword, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        if (!result.Ok || result.NewToken is null)
-        }
+        {
-
+            // Семантика прототипа: код ошибки различает «старый пароль неверен» и «слишком короткий».
-        var result = await authService.ChangePasswordAsync(user.Login, body.OldPassword, body.NewPassword, ct);
+            var detail = result.Error == ChangePasswordResultDto.ErrorTooShort
-        if (!result.Ok || result.NewToken is null)
+                ? PasswordTooShortDetail
-        {
+                : WrongOldPasswordDetail;
-            // Семантика прототипа: код ошибки различает «старый пароль неверен» и «слишком короткий».
+            return EndpointResults.BadRequest(detail);
-            var detail = result.Error == ChangePasswordResultDto.ErrorTooShort
+        }
-                ? PasswordTooShortDetail
+
-                : WrongOldPasswordDetail;
+        // Старые сессии удалены внутри сервиса; выдаём клиенту свежую куку.
-            return EndpointResults.BadRequest(detail);
+        SessionCookieWriter.Append(context, cookieOptions.Value, result.NewToken);
-        }
+        return Results.Ok(new { ok = true });
-
+    }
-        // Старые сессии удалены внутри сервиса; выдаём клиенту свежую куку.
+
-        SessionCookieWriter.Append(context, cookieOptions.Value, result.NewToken);
+    // Нормализованная попытка логина для аудита (нижний регистр/обрезка, как AuthService); null — писать нечего.
-        return Results.Ok(new { ok = true });
+    // login: Логин из тела запроса.
-    }
+    // Возвращает: Нормализованный логин или null при пустом/пробельном входе.
-
+    private static string? NormalizeLogin(string? login)
-    // Нормализованная попытка логина для аудита (нижний регистр/обрезка, как AuthService); null — писать нечего.
+    {
-    // login: Логин из тела запроса.
+        string? normalized = login?.Trim().ToLowerInvariant();
-    // Возвращает: Нормализованный логин или null при пустом/пробельном входе.
+        return string.IsNullOrEmpty(normalized) ? null : normalized;
-    private static string? NormalizeLogin(string? login)
+    }
-    {
+
-        string? normalized = login?.Trim().ToLowerInvariant();
+    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-        return string.IsNullOrEmpty(normalized) ? null : normalized;
+    // context: Контекст запроса.
-    }
+    // Возвращает: Строковое представление IP или null.
-
+    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-    // IP-адрес клиента для аудита (без порта; null, если недоступен).
+}
-    // context: Контекст запроса.
-    // Возвращает: Строковое представление IP или null.
-    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-}

src/core/Deal.Api/Endpoints/CardDetailsEndpoints.cs

@@ -1,478 +1,469 @@
-using System.Text.Json;
+using System.Text.Json;
-using Deal.Api.Endpoints.RequestModels;
+using Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Contracts.Integrations.Abstractions;
-using Deal.Contracts.Integrations.Abstractions;
+using Deal.Contracts.Integrations.Models;
-using Deal.Contracts.Integrations.Models;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Modules.Kanban.Application.Abstractions;
+using Deal.Modules.Kanban.Application.Services;
-using Deal.Modules.Kanban.Application.Extensions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Kanban.Application.Models;
+
-using Deal.Modules.Kanban.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Kanban.Application.Services;
+
-using Deal.Modules.Tenants.Application.Abstractions;
+/// <summary>
-using Deal.Modules.Tenants.Application.Extensions;
+/// Детальные операции карточки: создание локальной, «взять в работу», патч, ссылки, файлы,
-using Deal.Modules.Tenants.Application.Models;
+/// напоминания, очистка «Отклонено» — продолжение группы /api/cards (этап 9, T6).
-using Deal.Modules.Tenants.Application.Registrars;
+/// </summary>
-using Deal.Modules.Tenants.Application.Services;
+/// <remarks>
-using Deal.Api.Dtos;
+/// Единый контракт /api/cards (R5): операции проектной карточки (патч полей, ссылки, файлы, напоминания)
-
+/// теперь живут на том же ресурсе карточки. Список/чтение/перенос/комментарии/корзина — в
-namespace Deal.Api.Endpoints;
+/// <see cref="CardsEndpoints"/>; здесь — уникальные подпути. Все мутации возвращают обновлённую
-
+/// единую карточку (чтение после записи через <see cref="CardsService"/>). Все эндпоинты требуют сессию.
-/// <summary>
+/// </remarks>
-/// Детальные операции карточки: создание локальной, «взять в работу», патч, ссылки, файлы,
+public static class CardDetailsEndpoints
-/// напоминания, очистка «Отклонено» — продолжение группы /api/cards (этап 9, T6).
+{
-/// </summary>
+    // Префикс группы (общий с CardsEndpoints).
-/// <remarks>
+    private const string CardsGroupPrefix = "/api/cards";
-/// Единый контракт /api/cards (R5): операции проектной карточки (патч полей, ссылки, файлы, напоминания)
+
-/// теперь живут на том же ресурсе карточки. Список/чтение/перенос/комментарии/корзина — в
+    // Статический сегмент «взять в работу» (регистрируется до /{cardId}).
-/// <see cref="CardsEndpoints"/>; здесь — уникальные подпути. Все мутации возвращают обновлённую
+    private const string TakePath = "/take";
-/// единую карточку (чтение после записи через <see cref="CardsService"/>). Все эндпоинты требуют сессию.
+
-/// </remarks>
+    // Статический сегмент очистки «Отклонено» (регистрируется до /{cardId}).
-public static class CardDetailsEndpoints
+    private const string ClearRejectedPath = "/clear-rejected";
-{
+
-    // Префикс группы (общий с CardsEndpoints).
+    // Параметрический сегмент карточки (PATCH /{cardId}).
-    private const string CardsGroupPrefix = "/api/cards";
+    private const string CardIdPath = "/{cardId}";
-
+
-    // Статический сегмент «взять в работу» (регистрируется до /{cardId}).
+    // Вложенный путь добавления ссылки.
-    private const string TakePath = "/take";
+    private const string LinksPath = "/{cardId}/links";
-
+
-    // Статический сегмент очистки «Отклонено» (регистрируется до /{cardId}).
+    // Вложенный путь удаления ссылки.
-    private const string ClearRejectedPath = "/clear-rejected";
+    private const string LinkItemPath = "/{cardId}/links/{linkId}";
-
+
-    // Параметрический сегмент карточки (PATCH /{cardId}).
+    // Вложенный путь загрузки вложений (multipart, поле files).
-    private const string CardIdPath = "/{cardId}";
+    private const string FilesPath = "/{cardId}/files";
-
+
-    // Вложенный путь добавления ссылки.
+    // Вложенный путь скачивания вложения (поток + attachment).
-    private const string LinksPath = "/{cardId}/links";
+    private const string FileDownloadPath = "/{cardId}/files/{fileId}/download";
-
+
-    // Вложенный путь удаления ссылки.
+    // Вложенный путь удаления вложения.
-    private const string LinkItemPath = "/{cardId}/links/{linkId}";
+    private const string FileItemPath = "/{cardId}/files/{fileId}";
-
+
-    // Вложенный путь загрузки вложений (multipart, поле files).
+    // Вложенный путь установки/снятия напоминания.
-    private const string FilesPath = "/{cardId}/files";
+    private const string ReminderPath = "/{cardId}/reminder";
-
+
-    // Вложенный путь скачивания вложения (поток + attachment).
+    // Вложенный путь «напомнить позже».
-    private const string FileDownloadPath = "/{cardId}/files/{fileId}/download";
+    private const string ReminderSnoozePath = "/{cardId}/reminder/snooze";
-
+
-    // Вложенный путь удаления вложения.
+    // OpenAPI-тег группы.
-    private const string FileItemPath = "/{cardId}/files/{fileId}";
+    private const string OpenApiTag = "cards";
-
+
-    // Вложенный путь установки/снятия напоминания.
+    // 404: карточка не найдена.
-    private const string ReminderPath = "/{cardId}/reminder";
+    private const string CardNotFoundDetail = "Карточка не найдена";
-
+
-    // Вложенный путь «напомнить позже».
+    // 400: тело PATCH не JSON-объект.
-    private const string ReminderSnoozePath = "/{cardId}/reminder/snooze";
+    private const string InvalidBodyDetail = "Тело запроса должно быть JSON-объектом";
-
+
-    // OpenAPI-тег группы.
+    // 400: POST файлов без multipart/form-data.
-    private const string OpenApiTag = "cards";
+    private const string FormExpectedDetail = "Ожидается multipart/form-data";
-
+
-    // 404: карточка не найдена.
+    // 400: POST напоминания без поля at.
-    private const string CardNotFoundDetail = "Карточка не найдена";
+    private const string ReminderAtMissingDetail = "Поле at (epoch-ms) обязательно";
-
+
-    // 400: тело PATCH не JSON-объект.
+    // 404 download: объекта нет в хранилище.
-    private const string InvalidBodyDetail = "Тело запроса должно быть JSON-объектом";
+    private const string FileNotFoundInStorageDetail = "Файл не найден в MinIO";
-
+
-    // 400: POST файлов без multipart/form-data.
+    // 410 download: у записи файла нет objectKey.
-    private const string FormExpectedDetail = "Ожидается multipart/form-data";
+    private const string FileNotSavedDetail = "Файл не сохранён в объектном хранилище";
-
+
-    // 400: POST напоминания без поля at.
+    // Content-Type скачивания по умолчанию.
-    private const string ReminderAtMissingDetail = "Поле at (epoch-ms) обязательно";
+    private const string DownloadContentTypeFallback = "application/octet-stream";
-
+
-    // 404 download: объекта нет в хранилище.
+    // Символ, убираемый из имени файла для Content-Disposition.
-    private const string FileNotFoundInStorageDetail = "Файл не найден в MinIO";
+    private const string FileNameQuoteCharacter = "\"";
-
+
-    // 410 download: у записи файла нет objectKey.
+    /// <summary>
-    private const string FileNotSavedDetail = "Файл не сохранён в объектном хранилище";
+    /// Регистрирует уникальные подпути /api/cards (создание, take, патч, ссылки, файлы, напоминания).
-
+    /// </summary>
-    // Content-Type скачивания по умолчанию.
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    private const string DownloadContentTypeFallback = "application/octet-stream";
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-
+    public static IEndpointRouteBuilder MapCardDetailsEndpoints(this IEndpointRouteBuilder app)
-    // Символ, убираемый из имени файла для Content-Disposition.
+    {
-    private const string FileNameQuoteCharacter = "\"";
+        var cards = app.MapGroup(CardsGroupPrefix).WithTags(OpenApiTag);
-
+
-    /// <summary>
+        // Статические сегменты (/take, /clear-rejected) ДО /{cardId}; вложенные — за /{cardId}.
-    /// Регистрирует уникальные подпути /api/cards (создание, take, патч, ссылки, файлы, напоминания).
+        cards.MapPost("", CreateCardAsync);
-    /// </summary>
+        cards.MapPost(TakePath, TakeCardAsync);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        cards.MapPost(ClearRejectedPath, ClearRejectedAsync);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        cards.MapPatch(CardIdPath, PatchCardAsync);
-    public static IEndpointRouteBuilder MapCardDetailsEndpoints(this IEndpointRouteBuilder app)
+        cards.MapPost(LinksPath, AddLinkAsync);
-    {
+        cards.MapDelete(LinkItemPath, RemoveLinkAsync);
-        var cards = app.MapGroup(CardsGroupPrefix).WithTags(OpenApiTag);
+        cards.MapPost(FilesPath, UploadFilesAsync);
-
+        cards.MapGet(FileDownloadPath, DownloadFileAsync);
-        // Статические сегменты (/take, /clear-rejected) ДО /{cardId}; вложенные — за /{cardId}.
+        cards.MapDelete(FileItemPath, RemoveFileAsync);
-        cards.MapPost("", CreateCardAsync);
+        cards.MapPost(ReminderPath, SetReminderAsync);
-        cards.MapPost(TakePath, TakeCardAsync);
+        cards.MapDelete(ReminderPath, ClearReminderAsync);
-        cards.MapPost(ClearRejectedPath, ClearRejectedAsync);
+        cards.MapPost(ReminderSnoozePath, SnoozeReminderAsync);
-        cards.MapPatch(CardIdPath, PatchCardAsync);
+
-        cards.MapPost(LinksPath, AddLinkAsync);
+        return app;
-        cards.MapDelete(LinkItemPath, RemoveLinkAsync);
+    }
-        cards.MapPost(FilesPath, UploadFilesAsync);
+
-        cards.MapGet(FileDownloadPath, DownloadFileAsync);
+    // POST /api/cards: ручное создание «локальной» карточки. Ответ — созданная карточка.
-        cards.MapDelete(FileItemPath, RemoveFileAsync);
+    private static async Task<IResult> CreateCardAsync(
-        cards.MapPost(ReminderPath, SetReminderAsync);
+        CreateCardRequest body,
-        cards.MapDelete(ReminderPath, ClearReminderAsync);
+        HttpContext context,
-        cards.MapPost(ReminderSnoozePath, SnoozeReminderAsync);
+        CancellationToken ct)
-
+    {
-        return app;
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // POST /api/cards: ручное создание «локальной» карточки. Ответ — созданная карточка.
+        }
-    private static async Task<IResult> CreateCardAsync(
+
-        CreateCardRequest body,
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        CardDto created = await service.CreateLocalCardAsync(ToCreateLocalDto(body), ct);
-        CancellationToken ct)
+
-    {
+        // Аудит создания карточки (этап 10, T1).
-        if (!context.HasUser())
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardCreated, new { cardId = created.Id }, ct);
-        {
+        return await ReadCardAsync(context, created.Id, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    }
-        }
+
-
+    // POST /api/cards/take {cardId}: «взять в работу» — перенос карточки в planned. Ответ — карточка.
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+    private static async Task<IResult> TakeCardAsync(
-        CardDto created = await service.CreateLocalCardAsync(ToCreateLocalDto(body), ct);
+        TakeCardRequest body,
-
+        HttpContext context,
-        // Аудит создания карточки (этап 10, T1).
+        CancellationToken ct)
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardCreated, new { cardId = created.Id }, ct);
+    {
-        return await ReadCardAsync(context, created.Id, ct);
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // POST /api/cards/take {cardId}: «взять в работу» — перенос карточки в planned. Ответ — карточка.
+        }
-    private static async Task<IResult> TakeCardAsync(
+
-        TakeCardRequest body,
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        CardDto? card = await service.TakeCardAsync(body.CardId ?? body.LeadId ?? string.Empty, ct);
-        CancellationToken ct)
+        return card is null
-    {
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-        if (!context.HasUser())
+            : await ReadCardAsync(context, card.Id, ct);
-        {
+    }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+    // POST /api/cards/clear-rejected: полная очистка терминальной стадии «Отклонено».
-
+    private static async Task<IResult> ClearRejectedAsync(HttpContext context, CancellationToken ct)
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+    {
-        CardDto? card = await service.TakeCardAsync(body.CardId ?? body.LeadId ?? string.Empty, ct);
+        if (!context.HasUser())
-        return card is null
+        {
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-            : await ReadCardAsync(context, card.Id, ct);
+        }
-    }
+
-
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-    // POST /api/cards/clear-rejected: полная очистка терминальной стадии «Отклонено».
+        int cleared = await service.ClearRejectedAsync(ct);
-    private static async Task<IResult> ClearRejectedAsync(HttpContext context, CancellationToken ct)
+        return Results.Ok(new { ok = true, cleared });
-    {
+    }
-        if (!context.HasUser())
+
-        {
+    // PATCH /api/cards/{cardId}: точечная правка полей (title/summary/contact/tzText/stack/budget).
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    // Тело читается как произвольный JSON-объект (presence-aware): явный null чистящих полей
-        }
+    // (budget:null, stack:null) не теряется типизированным биндингом. Ответ — обновлённая карточка.
-
+    private static async Task<IResult> PatchCardAsync(
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+        string cardId,
-        int cleared = await service.ClearRejectedAsync(ct);
+        HttpContext context,
-        return Results.Ok(new { ok = true, cleared });
+        CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // PATCH /api/cards/{cardId}: точечная правка полей (title/summary/contact/tzText/stack/budget).
+        {
-    // Тело читается как произвольный JSON-объект (presence-aware): явный null чистящих полей
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // (budget:null, stack:null) не теряется типизированным биндингом. Ответ — обновлённая карточка.
+        }
-    private static async Task<IResult> PatchCardAsync(
+
-        string cardId,
+        IReadOnlyDictionary<string, JsonElement>? body = await ReadPatchBodyAsync(context, ct);
-        HttpContext context,
+        if (body is null)
-        CancellationToken ct)
+        {
-    {
+            return EndpointResults.BadRequest(InvalidBodyDetail);
-        if (!context.HasUser())
+        }
-        {
+
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-        }
+        CardDto? card = await service.PatchCardAsync(cardId, body, ct);
-
+        return card is null
-        IReadOnlyDictionary<string, JsonElement>? body = await ReadPatchBodyAsync(context, ct);
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-        if (body is null)
+            : await ReadCardAsync(context, cardId, ct);
-        {
+    }
-            return EndpointResults.BadRequest(InvalidBodyDetail);
+
-        }
+    // POST /api/cards/{cardId}/links {name?,url}: добавить ссылку. Ответ — карточка.
-
+    private static async Task<IResult> AddLinkAsync(
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+        string cardId,
-        CardDto? card = await service.PatchCardAsync(cardId, body, ct);
+        CardLinkRequest body,
-        return card is null
+        HttpContext context,
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+        CancellationToken ct)
-            : await ReadCardAsync(context, cardId, ct);
+    {
-    }
+        if (!context.HasUser())
-
+        {
-    // POST /api/cards/{cardId}/links {name?,url}: добавить ссылку. Ответ — карточка.
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    private static async Task<IResult> AddLinkAsync(
+        }
-        string cardId,
+
-        CardLinkRequest body,
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        CardResultDto result = await service.AddLinkAsync(
-        CancellationToken ct)
+            cardId,
-    {
+            body.Name ?? string.Empty,
-        if (!context.HasUser())
+            body.Url ?? string.Empty,
-        {
+            ct);
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        if (result.Error is not null)
-        }
+        {
-
+            return EndpointResults.BadRequest(result.Error);
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+        }
-        CardResultDto result = await service.AddLinkAsync(
+
-            cardId,
+        return result.Card is null
-            body.Name ?? string.Empty,
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-            body.Url ?? string.Empty,
+            : await ReadCardAsync(context, cardId, ct);
-            ct);
+    }
-        if (result.Error is not null)
+
-        {
+    // DELETE /api/cards/{cardId}/links/{linkId}: удалить ссылку. Ответ — карточка.
-            return EndpointResults.BadRequest(result.Error);
+    private static async Task<IResult> RemoveLinkAsync(
-        }
+        string cardId,
-
+        string linkId,
-        return result.Card is null
+        HttpContext context,
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+        CancellationToken ct)
-            : await ReadCardAsync(context, cardId, ct);
+    {
-    }
+        if (!context.HasUser())
-
+        {
-    // DELETE /api/cards/{cardId}/links/{linkId}: удалить ссылку. Ответ — карточка.
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    private static async Task<IResult> RemoveLinkAsync(
+        }
-        string cardId,
+
-        string linkId,
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        CardResultDto result = await service.RemoveLinkAsync(cardId, linkId, ct);
-        CancellationToken ct)
+        return result.Card is null
-    {
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-        if (!context.HasUser())
+            : await ReadCardAsync(context, cardId, ct);
-        {
+    }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+    // POST /api/cards/{cardId}/files: загрузка вложений (multipart/form-data, поле files).
-
+    // Ответ — обновлённая карточка (с новыми files). Карточки нет → 404 до записи объектов. Каждый файл:
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+    // имя/ContentType/поток/длина → CardsService.AddFileAsync. Ранний null — гонка (404).
-        CardResultDto result = await service.RemoveLinkAsync(cardId, linkId, ct);
+    private static async Task<IResult> UploadFilesAsync(
-        return result.Card is null
+        string cardId,
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+        HttpContext context,
-            : await ReadCardAsync(context, cardId, ct);
+        CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // POST /api/cards/{cardId}/files: загрузка вложений (multipart/form-data, поле files).
+        {
-    // Ответ — обновлённая карточка (с новыми files). Карточки нет → 404 до записи объектов. Каждый файл:
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // имя/ContentType/поток/длина → CardsService.AddFileAsync. Ранний null — гонка (404).
+        }
-    private static async Task<IResult> UploadFilesAsync(
+
-        string cardId,
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        if (await cardsService.GetCardAsync(cardId, ct) is null)
-        CancellationToken ct)
+        {
-    {
+            return EndpointResults.NotFound(CardNotFoundDetail);
-        if (!context.HasUser())
+        }
-        {
+
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        IFormCollection form;
-        }
+        try
-
+        {
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+            form = await context.Request.ReadFormAsync(ct);
-        if (await cardsService.GetCardAsync(cardId, ct) is null)
+        }
-        {
+        catch (InvalidOperationException)
-            return EndpointResults.NotFound(CardNotFoundDetail);
+        {
-        }
+            // Тело не multipart/form-data — ReadFormAsync бросает; фронт так не шлёт.
-
+            return EndpointResults.BadRequest(FormExpectedDetail);
-        IFormCollection form;
+        }
-        try
+
-        {
+        foreach (IFormFile file in form.Files)
-            form = await context.Request.ReadFormAsync(ct);
+        {
-        }
+            await using Stream content = file.OpenReadStream();
-        catch (InvalidOperationException)
+            CardFileDto? entry = await cardsService.AddFileAsync(cardId, file.FileName, file.ContentType, content, file.Length, ct);
-        {
+            if (entry is null)
-            // Тело не multipart/form-data — ReadFormAsync бросает; фронт так не шлёт.
+            {
-            return EndpointResults.BadRequest(FormExpectedDetail);
+                return EndpointResults.NotFound(CardNotFoundDetail);
-        }
+            }
-
+        }
-        foreach (IFormFile file in form.Files)
+
-        {
+        return await ReadCardAsync(context, cardId, ct);
-            await using Stream content = file.OpenReadStream();
+    }
-            CardFileDto? entry = await cardsService.AddFileAsync(cardId, file.FileName, file.ContentType, content, file.Length, ct);
+
-            if (entry is null)
+    // GET /api/cards/{cardId}/files/{fileId}/download: поток содержимого вложения.
-            {
+    // Карточки/записи нет → 404; пустой objectKey → 410; объекта нет в хранилище/сбой → 404. Ответ — поток
-                return EndpointResults.NotFound(CardNotFoundDetail);
+    // с Content-Length/Content-Type из дескриптора; Content-Disposition attachment, имя без кавычек.
-            }
+    private static async Task<IResult> DownloadFileAsync(
-        }
+        string cardId,
-
+        string fileId,
-        return await ReadCardAsync(context, cardId, ct);
+        HttpContext context,
-    }
+        CancellationToken ct)
-
+    {
-    // GET /api/cards/{cardId}/files/{fileId}/download: поток содержимого вложения.
+        if (!context.HasUser())
-    // Карточки/записи нет → 404; пустой objectKey → 410; объекта нет в хранилище/сбой → 404. Ответ — поток
+        {
-    // с Content-Length/Content-Type из дескриптора; Content-Disposition attachment, имя без кавычек.
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    private static async Task<IResult> DownloadFileAsync(
+        }
-        string cardId,
+
-        string fileId,
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        CardFileDto? entry = await cardsService.GetFileEntryAsync(cardId, fileId, ct);
-        CancellationToken ct)
+        if (entry is null)
-    {
+        {
-        if (!context.HasUser())
+            return EndpointResults.NotFound(CardNotFoundDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        if (string.IsNullOrWhiteSpace(entry.ObjectKey))
-
+        {
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+            return EndpointResults.Gone(FileNotSavedDetail);
-        CardFileDto? entry = await cardsService.GetFileEntryAsync(cardId, fileId, ct);
+        }
-        if (entry is null)
+
-        {
+        IFileStorage storage = context.RequestServices.GetRequiredService<IFileStorage>();
-            return EndpointResults.NotFound(CardNotFoundDetail);
+        FileMeta? meta;
-        }
+        Stream? stream;
-
+        try
-        if (string.IsNullOrWhiteSpace(entry.ObjectKey))
+        {
-        {
+            meta = await storage.StatAsync(entry.ObjectKey, ct);
-            return EndpointResults.Gone(FileNotSavedDetail);
+            stream = meta is null ? null : await storage.GetAsync(entry.ObjectKey, ct);
-        }
+        }
-
+        catch (OperationCanceledException) when (ct.IsCancellationRequested)
-        IFileStorage storage = context.RequestServices.GetRequiredService<IFileStorage>();
+        {
-        FileMeta? meta;
+            throw;
-        Stream? stream;
+        }
-        try
+        catch (Exception)
-        {
+        {
-            meta = await storage.StatAsync(entry.ObjectKey, ct);
+            return EndpointResults.NotFound(FileNotFoundInStorageDetail);
-            stream = meta is null ? null : await storage.GetAsync(entry.ObjectKey, ct);
+        }
-        }
+
-        catch (OperationCanceledException) when (ct.IsCancellationRequested)
+        if (meta is null || stream is null)
-        {
+        {
-            throw;
+            return EndpointResults.NotFound(FileNotFoundInStorageDetail);
-        }
+        }
-        catch (Exception)
+
-        {
+        context.Response.ContentLength = meta.Size;
-            return EndpointResults.NotFound(FileNotFoundInStorageDetail);
+        string contentType = string.IsNullOrWhiteSpace(meta.ContentType)
-        }
+            ? DownloadContentTypeFallback
-
+            : meta.ContentType;
-        if (meta is null || stream is null)
+        return Results.Stream(stream, contentType, fileDownloadName: ToDownloadFileName(entry.Name));
-        {
+    }
-            return EndpointResults.NotFound(FileNotFoundInStorageDetail);
+
-        }
+    // DELETE /api/cards/{cardId}/files/{fileId}: открепить файл. Ответ — карточка.
-
+    private static async Task<IResult> RemoveFileAsync(
-        context.Response.ContentLength = meta.Size;
+        string cardId,
-        string contentType = string.IsNullOrWhiteSpace(meta.ContentType)
+        string fileId,
-            ? DownloadContentTypeFallback
+        HttpContext context,
-            : meta.ContentType;
+        CancellationToken ct)
-        return Results.Stream(stream, contentType, fileDownloadName: ToDownloadFileName(entry.Name));
+    {
-    }
+        if (!context.HasUser())
-
+        {
-    // DELETE /api/cards/{cardId}/files/{fileId}: открепить файл. Ответ — карточка.
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    private static async Task<IResult> RemoveFileAsync(
+        }
-        string cardId,
+
-        string fileId,
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        CardDto? card = await cardsService.RemoveFileAsync(cardId, fileId, ct);
-        CancellationToken ct)
+        return card is null
-    {
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-        if (!context.HasUser())
+            : await ReadCardAsync(context, cardId, ct);
-        {
+    }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+    // POST /api/cards/{cardId}/reminder {at: epoch-ms}: установить напоминание. Ответ — карточка.
-
+    private static async Task<IResult> SetReminderAsync(
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        string cardId,
-        CardDto? card = await cardsService.RemoveFileAsync(cardId, fileId, ct);
+        ReminderSetRequest body,
-        return card is null
+        HttpContext context,
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+        CancellationToken ct)
-            : await ReadCardAsync(context, cardId, ct);
+    {
-    }
+        if (!context.HasUser())
-
+        {
-    // POST /api/cards/{cardId}/reminder {at: epoch-ms}: установить напоминание. Ответ — карточка.
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    private static async Task<IResult> SetReminderAsync(
+        }
-        string cardId,
+
-        ReminderSetRequest body,
+        if (body.At is null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.BadRequest(ReminderAtMissingDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        CardResultDto result = await service.SetReminderAsync(cardId, body.At.Value, ct);
-        }
+        if (result.Error is not null)
-
+        {
-        if (body.At is null)
+            return EndpointResults.BadRequest(result.Error);
-        {
+        }
-            return EndpointResults.BadRequest(ReminderAtMissingDetail);
+
-        }
+        return result.Card is null
-
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+            : await ReadCardAsync(context, cardId, ct);
-        CardResultDto result = await service.SetReminderAsync(cardId, body.At.Value, ct);
+    }
-        if (result.Error is not null)
+
-        {
+    // DELETE /api/cards/{cardId}/reminder: снять напоминание. Ответ — карточка.
-            return EndpointResults.BadRequest(result.Error);
+    private static async Task<IResult> ClearReminderAsync(
-        }
+        string cardId,
-
+        HttpContext context,
-        return result.Card is null
+        CancellationToken ct)
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+    {
-            : await ReadCardAsync(context, cardId, ct);
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // DELETE /api/cards/{cardId}/reminder: снять напоминание. Ответ — карточка.
+        }
-    private static async Task<IResult> ClearReminderAsync(
+
-        string cardId,
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        return await service.ClearReminderAsync(cardId, ct)
-        CancellationToken ct)
+            ? await ReadCardAsync(context, cardId, ct)
-    {
+            : EndpointResults.NotFound(CardNotFoundDetail);
-        if (!context.HasUser())
+    }
-        {
+
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    // POST /api/cards/{cardId}/reminder/snooze: «напомнить позже» (now + 24 ч). Ответ — карточка.
-        }
+    private static async Task<IResult> SnoozeReminderAsync(
-
+        string cardId,
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+        HttpContext context,
-        return await service.ClearReminderAsync(cardId, ct)
+        CancellationToken ct)
-            ? await ReadCardAsync(context, cardId, ct)
+    {
-            : EndpointResults.NotFound(CardNotFoundDetail);
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // POST /api/cards/{cardId}/reminder/snooze: «напомнить позже» (now + 24 ч). Ответ — карточка.
+        }
-    private static async Task<IResult> SnoozeReminderAsync(
+
-        string cardId,
+        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
-        HttpContext context,
+        return await service.SnoozeReminderAsync(cardId, ct)
-        CancellationToken ct)
+            ? await ReadCardAsync(context, cardId, ct)
-    {
+            : EndpointResults.NotFound(CardNotFoundDetail);
-        if (!context.HasUser())
+    }
-        {
+
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    // Читает карточку через единый сервис и возвращает её как ответ (404 — карточки нет).
-        }
+    // context: Контекст запроса (для резолва CardsService).
-
+    // cardId: Id карточки.
-        CardsService service = context.RequestServices.GetRequiredService<CardsService>();
+    // ct: Токен отмены.
-        return await service.SnoozeReminderAsync(cardId, ct)
+    // Возвращает: 200 с единой карточкой либо 404.
-            ? await ReadCardAsync(context, cardId, ct)
+    private static async Task<IResult> ReadCardAsync(
-            : EndpointResults.NotFound(CardNotFoundDetail);
+        HttpContext context,
-    }
+        string cardId,
-
+        CancellationToken ct)
-    // Читает карточку через единый сервис и возвращает её как ответ (404 — карточки нет).
+    {
-    // context: Контекст запроса (для резолва CardsService).
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    // cardId: Id карточки.
+        CardDto? card = await cardsService.GetCardAsync(cardId, ct);
-    // ct: Токен отмены.
+        return card is null
-    // Возвращает: 200 с единой карточкой либо 404.
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-    private static async Task<IResult> ReadCardAsync(
+            : Results.Ok(card);
-        HttpContext context,
+    }
-        string cardId,
+
-        CancellationToken ct)
+    // Имя файла для Content-Disposition без кавычек «"».
-    {
+    // name: Имя файла как в метаданных записи.
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+    // Возвращает: Имя, безопасное для заголовка.
-        CardDto? card = await cardsService.GetCardAsync(cardId, ct);
+    private static string ToDownloadFileName(string name) => name.Replace(FileNameQuoteCharacter, string.Empty);
-        return card is null
+
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+    // Переводит тело POST /api/cards в начальные поля сервиса (поля 1:1 с CardLocalCreateDto).
-            : Results.Ok(card);
+    // body: Тело запроса.
-    }
+    // Возвращает: DTO модуля для CardsService.CreateLocalCardAsync.
-
+    private static CardLocalCreateDto ToCreateLocalDto(CreateCardRequest body)
-    // Имя файла для Content-Disposition без кавычек «"».
+    {
-    // name: Имя файла как в метаданных записи.
+        return new CardLocalCreateDto(
-    // Возвращает: Имя, безопасное для заголовка.
+            Title: body.Title,
-    private static string ToDownloadFileName(string name) => name.Replace(FileNameQuoteCharacter, string.Empty);
+            Summary: body.Summary,
-
+            Stack: body.Stack,
-    // Переводит тело POST /api/cards в начальные поля сервиса (поля 1:1 с CardLocalCreateDto).
+            Budget: body.Budget,
-    // body: Тело запроса.
+            Contact: body.Contact,
-    // Возвращает: DTO модуля для CardsService.CreateLocalCardAsync.
+            TzText: body.TzText,
-    private static CardLocalCreateDto ToCreateLocalDto(CreateCardRequest body)
+            ContainerId: body.ContainerId ?? body.Stage);
-    {
+    }
-        return new CardLocalCreateDto(
+
-            Title: body.Title,
+    // Читает тело PATCH как произвольный JSON-объект: ключ → JsonElement (presence-aware).
-            Summary: body.Summary,
+    // context: Контекст запроса.
-            Stack: body.Stack,
+    // ct: Токен отмены.
-            Budget: body.Budget,
+    // Возвращает: Словарь ключей тела либо null — тело не JSON-объект.
-            Contact: body.Contact,
+    private static async Task<IReadOnlyDictionary<string, JsonElement>?> ReadPatchBodyAsync(HttpContext context, CancellationToken ct)
-            TzText: body.TzText,
+    {
-            ContainerId: body.ContainerId ?? body.Stage);
+        try
-    }
+        {
-
+            return await JsonSerializer.DeserializeAsync<Dictionary<string, JsonElement>>(
-    // Читает тело PATCH как произвольный JSON-объект: ключ → JsonElement (presence-aware).
+                context.Request.Body,
-    // context: Контекст запроса.
+                options: null,
-    // ct: Токен отмены.
+                cancellationToken: ct);
-    // Возвращает: Словарь ключей тела либо null — тело не JSON-объект.
+        }
-    private static async Task<IReadOnlyDictionary<string, JsonElement>?> ReadPatchBodyAsync(HttpContext context, CancellationToken ct)
+        catch (JsonException)
-    {
+        {
-        try
+            return null;
-        {
+        }
-            return await JsonSerializer.DeserializeAsync<Dictionary<string, JsonElement>>(
+    }
-                context.Request.Body,
+}
-                options: null,
-                cancellationToken: ct);
-        }
-        catch (JsonException)
-        {
-            return null;
-        }
-    }
-}

src/core/Deal.Api/Endpoints/CardsEndpoints.cs

@@ -1,502 +1,491 @@
-using Deal.Api.Endpoints.RequestModels;
+using Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Events;
+using Deal.Api.Events;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Cards.Application.Abstractions;
-using Deal.Modules.Cards.Application.Abstractions;
+using Deal.Modules.Cards.Application.Dtos;
-using Deal.Modules.Cards.Application.Dtos;
+using Deal.Modules.Cards.Application.Models;
-using Deal.Modules.Cards.Application.Models;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Modules.Kanban.Application.Abstractions;
+using Deal.Modules.Kanban.Application.Services;
-using Deal.Modules.Kanban.Application.Extensions;
+using Deal.Modules.Pipeline.Application.Models;
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Pipeline.Application.Services;
-using Deal.Modules.Kanban.Application.Registrars;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Kanban.Application.Services;
+
-using Deal.Modules.Pipeline.Application.Abstractions;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Pipeline.Application.Models;
+
-using Deal.Modules.Pipeline.Application.Registrars;
+/// <summary>
-using Deal.Modules.Pipeline.Application.Services;
+/// Эндпоинты карточек и поиска: GET /api/cards[?containerId=], /cards/counts, /cards/{id},
-using Deal.Modules.Tenants.Application.Abstractions;
+/// mark-all-seen/mark-col-seen, move/trash/restore/DELETE, clear-col, comments, reclassify (batch + {id}),
-using Deal.Modules.Tenants.Application.Extensions;
+/// GET /api/search (этап 9, T6).
-using Deal.Modules.Tenants.Application.Models;
+/// </summary>
-using Deal.Modules.Tenants.Application.Registrars;
+/// <remarks>
-using Deal.Modules.Tenants.Application.Services;
+/// Единый контракт /api/cards (R5): старые ручки /api/leads, /api/projects, /api/boards и /api/columns
-using Deal.Api.Dtos;
+/// упразднены. GET /cards →
-
+/// {items}; counts — плоская wire-форма {new, &lt;col&gt;: {count, new}, learning, ml, ai}; move → обновлённая
-namespace Deal.Api.Endpoints;
+/// карточка; restore → {ok, col}; clear-col → {ok, cleared}; comments → {comments}; search →
-
+/// {cards, messages: []}. 400 «Неизвестный контейнер» при несуществующем containerId; 404 «Карточка не
-/// <summary>
+/// найдена» — null-результаты сервисов, 400-тексты — константы CardsService.
-/// Эндпоинты карточек и поиска: GET /api/cards[?containerId=], /cards/counts, /cards/{id},
+/// ⚠ Статические сегменты (counts, mark-all-seen, mark-col-seen, clear-col, reclassify) регистрируются ДО
-/// mark-all-seen/mark-col-seen, move/trash/restore/DELETE, clear-col, comments, reclassify (batch + {id}),
+/// /cards/{cardId}. Все эндпоинты требуют сессию: 401 {detail}; сервисы резолвятся из RequestServices
-/// GET /api/search (этап 9, T6).
+/// ПОСЛЕ проверки сессии.
-/// </summary>
+/// </remarks>
-/// <remarks>
+public static class CardsEndpoints
-/// Единый контракт /api/cards (R5): старые ручки /api/leads, /api/projects, /api/boards и /api/columns
+{
-/// упразднены. GET /cards →
+    // Префикс группы карточек.
-/// {items}; counts — плоская wire-форма {new, &lt;col&gt;: {count, new}, learning, ml, ai}; move → обновлённая
+    private const string CardsGroupPrefix = "/api/cards";
-/// карточка; restore → {ok, col}; clear-col → {ok, cleared}; comments → {comments}; search →
+
-/// {cards, messages: []}. 400 «Неизвестный контейнер» при несуществующем containerId; 404 «Карточка не
+    // Префикс группы поиска (единственный эндпоинт группы — /api/search).
-/// найдена» — null-результаты сервисов, 400-тексты — константы CardsService.
+    private const string ApiGroupPrefix = "/api";
-/// ⚠ Статические сегменты (counts, mark-all-seen, mark-col-seen, clear-col, reclassify) регистрируются ДО
+
-/// /cards/{cardId}. Все эндпоинты требуют сессию: 401 {detail}; сервисы резолвятся из RequestServices
+    // Путь поиска (GET).
-/// ПОСЛЕ проверки сессии.
+    private const string SearchPath = "/search";
-/// </remarks>
+
-public static class CardsEndpoints
+    // OpenAPI-тег группы (в прототипе роутер dashboard — dashboard_routes.py).
-{
+    private const string OpenApiTag = "dashboard";
-    // Префикс группы карточек.
+
-    private const string CardsGroupPrefix = "/api/cards";
+    // 404: карточка не найдена (dashboard_routes.py _lead_or_404 L92–96).
-
+    private const string CardNotFoundDetail = "Карточка не найдена";
-    // Префикс группы поиска (единственный эндпоинт группы — /api/search).
+
-    private const string ApiGroupPrefix = "/api";
+    // 400 GET /cards: containerId не существует.
-
+    private const string UnknownColumnDetail = "Неизвестный контейнер";
-    // Путь поиска (GET).
+
-    private const string SearchPath = "/search";
+    // Инициатор перехода при ручном переносе — действие пользователя (R4 этапа 9).
-
+    private const string UserActor = "user";
-    // OpenAPI-тег группы (в прототипе роутер dashboard — dashboard_routes.py).
+
-    private const string OpenApiTag = "dashboard";
+    // SSE-тип события завершения переклассификации (этап 12, остаток 2; api.js слушает 'cards_reclassified').
-
+    private const string ReclassifiedEventType = "cards_reclassified";
-    // 404: карточка не найдена (dashboard_routes.py _lead_or_404 L92–96).
+
-    private const string CardNotFoundDetail = "Карточка не найдена";
+    // Контекст ручного перехода карточки: пользователь, обучение ML по цели переноса.
-
+    private static readonly TransitionContext UserMoveContext = new() { Actor = UserActor, Learn = true };
-    // 400 GET /cards: containerId не существует.
+
-    private const string UnknownColumnDetail = "Неизвестный контейнер";
+    /// <summary>
-
+    /// Регистрирует группы /api/cards и /api (карточки + поиск). Статические сегменты — до /cards/{cardId}.
-    // Инициатор перехода при ручном переносе — действие пользователя (R4 этапа 9).
+    /// </summary>
-    private const string UserActor = "user";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    // SSE-тип события завершения переклассификации (этап 12, остаток 2; api.js слушает 'cards_reclassified').
+    public static IEndpointRouteBuilder MapCardsEndpoints(this IEndpointRouteBuilder app)
-    private const string ReclassifiedEventType = "cards_reclassified";
+    {
-
+        var leads = app.MapGroup(CardsGroupPrefix).WithTags(OpenApiTag);
-    // Контекст ручного перехода карточки: пользователь, обучение ML по цели переноса.
+
-    private static readonly TransitionContext UserMoveContext = new() { Actor = UserActor, Learn = true };
+        // Статические сегменты ДО /cards/{cardId}: ASP.NET Core отдаёт приоритет литералам, порядок регистрации
-
+        // сохранён для читаемости.
-    /// <summary>
+        leads.MapGet("", ListCardsAsync);
-    /// Регистрирует группы /api/cards и /api (карточки + поиск). Статические сегменты — до /cards/{cardId}.
+        leads.MapGet("/counts", CountsAsync);
-    /// </summary>
+        leads.MapPost("/mark-all-seen", MarkAllSeenAsync);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        leads.MapPost("/mark-col-seen", MarkColSeenAsync);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        leads.MapPost("/clear-col", ClearColAsync);
-    public static IEndpointRouteBuilder MapCardsEndpoints(this IEndpointRouteBuilder app)
+        leads.MapPost("/reclassify", ReclassifyAsync);
-    {
+        leads.MapGet("/{cardId}", GetCardAsync);
-        var leads = app.MapGroup(CardsGroupPrefix).WithTags(OpenApiTag);
+        leads.MapPost("/{cardId}/reclassify", ReclassifyOneAsync);
-
+        leads.MapPost("/{cardId}/move", MoveAsync);
-        // Статические сегменты ДО /cards/{cardId}: ASP.NET Core отдаёт приоритет литералам, порядок регистрации
+        leads.MapPost("/{cardId}/trash", TrashAsync);
-        // сохранён для читаемости.
+        leads.MapPost("/{cardId}/restore", RestoreAsync);
-        leads.MapGet("", ListCardsAsync);
+        leads.MapDelete("/{cardId}", DeleteAsync);
-        leads.MapGet("/counts", CountsAsync);
+        leads.MapPost("/{cardId}/comments", AddCommentAsync);
-        leads.MapPost("/mark-all-seen", MarkAllSeenAsync);
+
-        leads.MapPost("/mark-col-seen", MarkColSeenAsync);
+        app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag).MapGet(SearchPath, SearchAsync);
-        leads.MapPost("/clear-col", ClearColAsync);
+
-        leads.MapPost("/reclassify", ReclassifyAsync);
+        return app;
-        leads.MapGet("/{cardId}", GetCardAsync);
+    }
-        leads.MapPost("/{cardId}/reclassify", ReclassifyOneAsync);
+
-        leads.MapPost("/{cardId}/move", MoveAsync);
+    // GET /api/cards?containerId=: карточки контейнера (или все карточки дашборда); 400 «Неизвестный контейнер».
-        leads.MapPost("/{cardId}/trash", TrashAsync);
+    // Параметр col принят как алиас containerId (совместимость со старым фронтом).
-        leads.MapPost("/{cardId}/restore", RestoreAsync);
+    private static async Task<IResult> ListCardsAsync(
-        leads.MapDelete("/{cardId}", DeleteAsync);
+        string? containerId,
-        leads.MapPost("/{cardId}/comments", AddCommentAsync);
+        string? col,
-
+        HttpContext context,
-        app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag).MapGet(SearchPath, SearchAsync);
+        CancellationToken ct)
-
+    {
-        return app;
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // GET /api/cards?containerId=: карточки контейнера (или все карточки дашборда); 400 «Неизвестный контейнер».
+        }
-    // Параметр col принят как алиас containerId (совместимость со старым фронтом).
+
-    private static async Task<IResult> ListCardsAsync(
+        string? target = string.IsNullOrEmpty(containerId) ? col : containerId;
-        string? containerId,
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-        string? col,
+        if (!string.IsNullOrEmpty(target) && !await IsKnownContainerAsync(target, context, ct))
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.BadRequest(UnknownColumnDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        IReadOnlyList<CardDto> cards = await cardsService.ListCardsAsync(target, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        return Results.Ok(new { items = cards });
-        }
+    }
-
+
-        string? target = string.IsNullOrEmpty(containerId) ? col : containerId;
+    // GET /api/cards/counts: плоская wire-форма счётчиков {new, &lt;col&gt;:{count,new}, learning, ml, ai} (L161–163, §4.1 L257).
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+    private static async Task<IResult> CountsAsync(HttpContext context, CancellationToken ct)
-        if (!string.IsNullOrEmpty(target) && !await IsKnownContainerAsync(target, context, ct))
+    {
-        {
+        if (!context.HasUser())
-            return EndpointResults.BadRequest(UnknownColumnDetail);
+        {
-        }
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-
+        }
-        IReadOnlyList<CardDto> cards = await cardsService.ListCardsAsync(target, ct);
+
-        return Results.Ok(new { items = cards });
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    }
+        CardCountsDto counts = await cardsService.CountsAsync(ct);
-
+
-    // GET /api/cards/counts: плоская wire-форма счётчиков {new, &lt;col&gt;:{count,new}, learning, ml, ai} (L161–163, §4.1 L257).
+        // Разворачивание CardCountsDto: колонки — корневые ключи (counts L268–279), служебные — фиксированные.
-    private static async Task<IResult> CountsAsync(HttpContext context, CancellationToken ct)
+        var wire = new Dictionary<string, object> { ["new"] = counts.New };
-    {
+        foreach ((string col, CardColumnCountDto column) in counts.Columns)
-        if (!context.HasUser())
+        {
-        {
+            wire[col] = column;
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        }
-        }
+
-
+        wire["learning"] = counts.Learning;
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        wire["ml"] = counts.Ml;
-        CardCountsDto counts = await cardsService.CountsAsync(ct);
+        wire["ai"] = counts.Ai;
-
+        return Results.Ok(wire);
-        // Разворачивание CardCountsDto: колонки — корневые ключи (counts L268–279), служебные — фиксированные.
+    }
-        var wire = new Dictionary<string, object> { ["new"] = counts.New };
+
-        foreach ((string col, CardColumnCountDto column) in counts.Columns)
+    // GET /api/cards/{cardId}: одна карточка; 404 «Карточка не найдена» (L166–168).
-        {
+    private static async Task<IResult> GetCardAsync(
-            wire[col] = column;
+        string cardId,
-        }
+        HttpContext context,
-
+        CancellationToken ct)
-        wire["learning"] = counts.Learning;
+    {
-        wire["ml"] = counts.Ml;
+        if (!context.HasUser())
-        wire["ai"] = counts.Ai;
+        {
-        return Results.Ok(wire);
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // GET /api/cards/{cardId}: одна карточка; 404 «Карточка не найдена» (L166–168).
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    private static async Task<IResult> GetCardAsync(
+        CardDto? card = await cardsService.GetCardAsync(cardId, ct);
-        string cardId,
+        return card is null
-        HttpContext context,
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-        CancellationToken ct)
+            : Results.Ok(card);
-    {
+    }
-        if (!context.HasUser())
+
-        {
+    // POST /api/cards/mark-all-seen: снять «новое» со всех карточек (L177–180); ответ {ok:true}.
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    private static async Task<IResult> MarkAllSeenAsync(HttpContext context, CancellationToken ct)
-        }
+    {
-
+        if (!context.HasUser())
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        {
-        CardDto? card = await cardsService.GetCardAsync(cardId, ct);
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        return card is null
+        }
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+
-            : Results.Ok(card);
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    }
+        await cardsService.MarkSeenAsync(cardId: null, col: null, ct);
-
+        return Results.Ok(new { ok = true });
-    // POST /api/cards/mark-all-seen: снять «новое» со всех карточек (L177–180); ответ {ok:true}.
+    }
-    private static async Task<IResult> MarkAllSeenAsync(HttpContext context, CancellationToken ct)
+
-    {
+    // POST /api/cards/mark-col-seen: снять «новое» с колонки (L187–191); ответ {ok:true}.
-        if (!context.HasUser())
+    private static async Task<IResult> MarkColSeenAsync(
-        {
+        MarkColBody body,
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        HttpContext context,
-        }
+        CancellationToken ct)
-
+    {
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        if (!context.HasUser())
-        await cardsService.MarkSeenAsync(cardId: null, col: null, ct);
+        {
-        return Results.Ok(new { ok = true });
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // POST /api/cards/mark-col-seen: снять «новое» с колонки (L187–191); ответ {ok:true}.
+        if (body.Col is null)
-    private static async Task<IResult> MarkColSeenAsync(
+        {
-        MarkColBody body,
+            // Пустая/отсутствующая col попала бы в mark_seen как «не задана» и сняла бы «новое» со ВСЕХ
-        HttpContext context,
+            // карточек (truthiness python, L250–256) — эндпоинт защищает от вызова с null (прототип: 422).
-        CancellationToken ct)
+            return EndpointResults.BadRequest(UnknownColumnDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        await cardsService.MarkSeenAsync(cardId: null, col: body.Col, ct);
-        }
+        return Results.Ok(new { ok = true });
-
+    }
-        if (body.Col is null)
+
-        {
+    // POST /api/cards/{cardId}/move {to}: перенос карточки между контейнерами (этап 9, R4).
-            // Пустая/отсутствующая col попала бы в mark_seen как «не задана» и сняла бы «новое» со ВСЕХ
+    // Маршрутизацию цели (стадия «Выбранных» vs дашборд-контейнер) и побочные эффекты выполняет единый
-            // карточек (truthiness python, L250–256) — эндпоинт защищает от вызова с null (прототип: 422).
+    // доменный механизм перехода ICardMover: стадия — запись истории и сброс напоминания
-            return EndpointResults.BadRequest(UnknownColumnDetail);
+    // (move_stage), дашборд-контейнер — журнал/обучение ML. Ответ — обновлённая карточка; 400 при
-        }
+    // несуществующем контейнере, 404 — карточки нет.
-
+    private static async Task<IResult> MoveAsync(
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        string cardId,
-        await cardsService.MarkSeenAsync(cardId: null, col: body.Col, ct);
+        MoveBody body,
-        return Results.Ok(new { ok = true });
+        HttpContext context,
-    }
+        CancellationToken ct)
-
+    {
-    // POST /api/cards/{cardId}/move {to}: перенос карточки между контейнерами (этап 9, R4).
+        if (!context.HasUser())
-    // Маршрутизацию цели (стадия «Выбранных» vs дашборд-контейнер) и побочные эффекты выполняет единый
+        {
-    // доменный механизм перехода ICardMover: стадия — запись истории и сброс напоминания
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // (move_stage), дашборд-контейнер — журнал/обучение ML. Ответ — обновлённая карточка; 400 при
+        }
-    // несуществующем контейнере, 404 — карточки нет.
+
-    private static async Task<IResult> MoveAsync(
+        ICardMover mover = context.RequestServices.GetRequiredService<ICardMover>();
-        string cardId,
+        CardMoveResultDto outcome = await mover.MoveAsync(cardId, body.To ?? string.Empty, UserMoveContext, ct);
-        MoveBody body,
+        if (outcome.Error is not null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.BadRequest(outcome.Error);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        if (!outcome.Exists)
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        {
-        }
+            return EndpointResults.NotFound(CardNotFoundDetail);
-
+        }
-        ICardMover mover = context.RequestServices.GetRequiredService<ICardMover>();
+
-        CardMoveResultDto outcome = await mover.MoveAsync(cardId, body.To ?? string.Empty, UserMoveContext, ct);
+        // Аудит переноса карточки (этап 10, T1): цель — минимальный безопасный идентификатор.
-        if (outcome.Error is not null)
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardMoved, new { cardId, to = body.To }, ct);
-        {
+
-            return EndpointResults.BadRequest(outcome.Error);
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-        }
+        CardDto? unified = await cardsService.GetCardAsync(cardId, ct);
-
+        return unified is null
-        if (!outcome.Exists)
+            ? EndpointResults.NotFound(CardNotFoundDetail)
-        {
+            : Results.Ok(unified);
-            return EndpointResults.NotFound(CardNotFoundDetail);
+    }
-        }
+
-
+    // POST /api/cards/{cardId}/trash: в корзину + обучение ML spam (L203–207); ответ {ok:true}; 404.
-        // Аудит переноса карточки (этап 10, T1): цель — минимальный безопасный идентификатор.
+    private static async Task<IResult> TrashAsync(
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardMoved, new { cardId, to = body.To }, ct);
+        string cardId,
-
+        HttpContext context,
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        CancellationToken ct)
-        CardDto? unified = await cardsService.GetCardAsync(cardId, ct);
+    {
-        return unified is null
+        if (!context.HasUser())
-            ? EndpointResults.NotFound(CardNotFoundDetail)
+        {
-            : Results.Ok(unified);
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // POST /api/cards/{cardId}/trash: в корзину + обучение ML spam (L203–207); ответ {ok:true}; 404.
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    private static async Task<IResult> TrashAsync(
+        CardDto? card = await cardsService.TrashCardAsync(cardId, ct);
-        string cardId,
+        if (card is null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.NotFound(CardNotFoundDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        // Аудит отправки карточки в корзину (этап 10, T1).
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardTrashed, new { cardId }, ct);
-        }
+        return Results.Ok(new { ok = true });
-
+    }
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+
-        CardDto? card = await cardsService.TrashCardAsync(cardId, ct);
+    // POST /api/cards/{cardId}/restore: возврат из архив/корзины на канбан (L210–214); ответ {ok, col}; 404.
-        if (card is null)
+    private static async Task<IResult> RestoreAsync(
-        {
+        string cardId,
-            return EndpointResults.NotFound(CardNotFoundDetail);
+        HttpContext context,
-        }
+        CancellationToken ct)
-
+    {
-        // Аудит отправки карточки в корзину (этап 10, T1).
+        if (!context.HasUser())
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardTrashed, new { cardId }, ct);
+        {
-        return Results.Ok(new { ok = true });
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // POST /api/cards/{cardId}/restore: возврат из архив/корзины на канбан (L210–214); ответ {ok, col}; 404.
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    private static async Task<IResult> RestoreAsync(
+        string? col = await cardsService.RestoreCardAsync(cardId, ct);
-        string cardId,
+        if (col is null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.NotFound(CardNotFoundDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        // Аудит возврата карточки из корзины/архива (этап 10, T1).
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardRestored, new { cardId, col }, ct);
-        }
+        return Results.Ok(new { ok = true, col });
-
+    }
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+
-        string? col = await cardsService.RestoreCardAsync(cardId, ct);
+    // DELETE /api/cards/{cardId}: удалить навсегда (Cards + комментарии; L217–221); ответ {ok:true}; 404.
-        if (col is null)
+    private static async Task<IResult> DeleteAsync(
-        {
+        string cardId,
-            return EndpointResults.NotFound(CardNotFoundDetail);
+        HttpContext context,
-        }
+        CancellationToken ct)
-
+    {
-        // Аудит возврата карточки из корзины/архива (этап 10, T1).
+        if (!context.HasUser())
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardRestored, new { cardId, col }, ct);
+        {
-        return Results.Ok(new { ok = true, col });
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // DELETE /api/cards/{cardId}: удалить навсегда (Cards + комментарии; L217–221); ответ {ok:true}; 404.
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    private static async Task<IResult> DeleteAsync(
+        bool deleted = await cardsService.DeleteForeverAsync(cardId, ct);
-        string cardId,
+        if (!deleted)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.NotFound(CardNotFoundDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        // Аудит удаления карточки навсегда (этап 10, T1).
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardDeleted, new { cardId }, ct);
-        }
+        return Results.Ok(new { ok = true });
-
+    }
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+
-        bool deleted = await cardsService.DeleteForeverAsync(cardId, ct);
+    // POST /api/cards/clear-col {col}: очистить корзину/архив (L228–235); ответ {ok, cleared}; 400.
-        if (!deleted)
+    private static async Task<IResult> ClearColAsync(
-        {
+        ClearColBody body,
-            return EndpointResults.NotFound(CardNotFoundDetail);
+        HttpContext context,
-        }
+        CancellationToken ct)
-
+    {
-        // Аудит удаления карточки навсегда (этап 10, T1).
+        if (!context.HasUser())
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardDeleted, new { cardId }, ct);
+        {
-        return Results.Ok(new { ok = true });
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // POST /api/cards/clear-col {col}: очистить корзину/архив (L228–235); ответ {ok, cleared}; 400.
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    private static async Task<IResult> ClearColAsync(
+        ClearColResultDto result = await cardsService.ClearColAsync(body.Col ?? string.Empty, ct);
-        ClearColBody body,
+        return result.Error is not null
-        HttpContext context,
+            ? EndpointResults.BadRequest(result.Error)
-        CancellationToken ct)
+            : Results.Ok(new { ok = true, cleared = result.Cleared });
-    {
+    }
-        if (!context.HasUser())
+
-        {
+    // POST /api/cards/{cardId}/comments {text}: добавить комментарий (L238–242); ответ {comments}; 400 «Пустой комментарий»; 404.
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    private static async Task<IResult> AddCommentAsync(
-        }
+        string cardId,
-
+        CommentBody body,
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        HttpContext context,
-        ClearColResultDto result = await cardsService.ClearColAsync(body.Col ?? string.Empty, ct);
+        CancellationToken ct)
-        return result.Error is not null
+    {
-            ? EndpointResults.BadRequest(result.Error)
+        if (!context.HasUser())
-            : Results.Ok(new { ok = true, cleared = result.Cleared });
+        {
-    }
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-
+        }
-    // POST /api/cards/{cardId}/comments {text}: добавить комментарий (L238–242); ответ {comments}; 400 «Пустой комментарий»; 404.
+
-    private static async Task<IResult> AddCommentAsync(
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-        string cardId,
+        AddCommentResultDto result = await cardsService.AddCommentAsync(cardId, body.Text ?? string.Empty, ct);
-        CommentBody body,
+        if (result.Error is not null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.BadRequest(result.Error);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        if (result.Comments is null)
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        {
-        }
+            return EndpointResults.NotFound(CardNotFoundDetail);
-
+        }
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+
-        AddCommentResultDto result = await cardsService.AddCommentAsync(cardId, body.Text ?? string.Empty, ct);
+        // Аудит добавления комментария (этап 10, T1): текст комментария в детали не пишется.
-        if (result.Error is not null)
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardCommentAdded, new { cardId }, ct);
-        {
+        return Results.Ok(new { comments = result.Comments });
-            return EndpointResults.BadRequest(result.Error);
+    }
-        }
+
-
+    // POST /api/cards/reclassify: переклассификация «Неразобранного» (все карточки либо ids).
-        if (result.Comments is null)
+    // Тело ids опционально (фронт шлёт запрос без тела — все карточки inbox). Проход синхронный; при занятом
-        {
+    // проходе ответ {started:false, busy:true}. Поля started/busy/attempted сохранены ради совместимости,
-            return EndpointResults.NotFound(CardNotFoundDetail);
+    // добавлены reclassified/moved/kept/trashed/skipped/usedAi/reason. Аудит — card_reclassified; после
-        }
+    // успешного прохода (reclassified &gt; 0) публикуется SSE cards_reclassified {reclassified,moved}.
-
+    // body: Тело запроса (ids — опционально).
-        // Аудит добавления комментария (этап 10, T1): текст комментария в детали не пишется.
+    // context: Контекст запроса.
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.CardCommentAdded, new { cardId }, ct);
+    // ct: Токен отмены.
-        return Results.Ok(new { comments = result.Comments });
+    private static async Task<IResult> ReclassifyAsync(
-    }
+        ReclassifyBody? body,
-
+        HttpContext context,
-    // POST /api/cards/reclassify: переклассификация «Неразобранного» (все карточки либо ids).
+        CancellationToken ct)
-    // Тело ids опционально (фронт шлёт запрос без тела — все карточки inbox). Проход синхронный; при занятом
+    {
-    // проходе ответ {started:false, busy:true}. Поля started/busy/attempted сохранены ради совместимости,
+        if (!context.HasUser())
-    // добавлены reclassified/moved/kept/trashed/skipped/usedAi/reason. Аудит — card_reclassified; после
+        {
-    // успешного прохода (reclassified &gt; 0) публикуется SSE cards_reclassified {reclassified,moved}.
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // body: Тело запроса (ids — опционально).
+        }
-    // context: Контекст запроса.
+
-    // ct: Токен отмены.
+        CardReclassifier reclassifier = context.RequestServices.GetRequiredService<CardReclassifier>();
-    private static async Task<IResult> ReclassifyAsync(
+        ReclassifyResultDto result = await reclassifier.ReclassifyInboxAsync(body?.Ids, ct);
-        ReclassifyBody? body,
+        await AppendReclassifyAuditAsync(context, result, ct);
-        HttpContext context,
+        PublishReclassified(context, result);
-        CancellationToken ct)
+        return Results.Ok(ToReclassifyWire(result));
-    {
+    }
-        if (!context.HasUser())
+
-        {
+    // POST /api/cards/{cardId}/reclassify: переклассификация одной карточки; 404 «Карточка не найдена».
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    // cardId: Id карточки (c_...).
-        }
+    // context: Контекст запроса.
-
+    // ct: Токен отмены.
-        CardReclassifier reclassifier = context.RequestServices.GetRequiredService<CardReclassifier>();
+    private static async Task<IResult> ReclassifyOneAsync(
-        ReclassifyResultDto result = await reclassifier.ReclassifyInboxAsync(body?.Ids, ct);
+        string cardId,
-        await AppendReclassifyAuditAsync(context, result, ct);
+        HttpContext context,
-        PublishReclassified(context, result);
+        CancellationToken ct)
-        return Results.Ok(ToReclassifyWire(result));
+    {
-    }
+        if (!context.HasUser())
-
+        {
-    // POST /api/cards/{cardId}/reclassify: переклассификация одной карточки; 404 «Карточка не найдена».
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // cardId: Id карточки (c_...).
+        }
-    // context: Контекст запроса.
+
-    // ct: Токен отмены.
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    private static async Task<IResult> ReclassifyOneAsync(
+        CardDto? card = await cardsService.GetCardAsync(cardId, ct);
-        string cardId,
+        if (card is null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.NotFound(CardNotFoundDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        CardReclassifier reclassifier = context.RequestServices.GetRequiredService<CardReclassifier>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        ReclassifyResultDto result = await reclassifier.ReclassifyCardAsync(card, ct);
-        }
+        await AppendReclassifyAuditAsync(context, result, ct);
-
+        PublishReclassified(context, result);
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+        return Results.Ok(ToReclassifyWire(result));
-        CardDto? card = await cardsService.GetCardAsync(cardId, ct);
+    }
-        if (card is null)
+
-        {
+    // Wire-форма итога переклассификации (camelCase; сохранены started/busy/attempted).
-            return EndpointResults.NotFound(CardNotFoundDetail);
+    // result: Итог прохода.
-        }
+    // Возвращает: Объект ответа эндпоинта.
-
+    private static object ToReclassifyWire(ReclassifyResultDto result) => new
-        CardReclassifier reclassifier = context.RequestServices.GetRequiredService<CardReclassifier>();
+    {
-        ReclassifyResultDto result = await reclassifier.ReclassifyCardAsync(card, ct);
+        started = result.Started,
-        await AppendReclassifyAuditAsync(context, result, ct);
+        busy = result.Busy,
-        PublishReclassified(context, result);
+        attempted = result.Attempted,
-        return Results.Ok(ToReclassifyWire(result));
+        reclassified = result.Reclassified,
-    }
+        moved = result.Moved,
-
+        kept = result.Kept,
-    // Wire-форма итога переклассификации (camelCase; сохранены started/busy/attempted).
+        trashed = result.Trashed,
-    // result: Итог прохода.
+        skipped = result.Skipped,
-    // Возвращает: Объект ответа эндпоинта.
+        usedAi = result.UsedAi,
-    private static object ToReclassifyWire(ReclassifyResultDto result) => new
+        reason = result.Reason,
-    {
+    };
-        started = result.Started,
+
-        busy = result.Busy,
+    // Публикует SSE cards_reclassified после успешного прохода (Ruling 5: публикации — из Api).
-        attempted = result.Attempted,
+    // Публикуется только когда проход реально выполнен и что-то изменил (started и
-        reclassified = result.Reclassified,
+    // reclassified &gt; 0): пустой inbox/всё пропущено не меняют доску — событие не шлём. Нагрузка
-        moved = result.Moved,
+    // минимальная: сколько обработано и перемещено (фронт перечитывает доску). Без подписчиков — no-op.
-        kept = result.Kept,
+    // context: Контекст запроса (тенант-канал сессии).
-        trashed = result.Trashed,
+    // result: Итог прохода.
-        skipped = result.Skipped,
+    private static void PublishReclassified(HttpContext context, ReclassifyResultDto result)
-        usedAi = result.UsedAi,
+    {
-        reason = result.Reason,
+        if (!result.Started || result.Reclassified == 0)
-    };
+        {
-
+            return;
-    // Публикует SSE cards_reclassified после успешного прохода (Ruling 5: публикации — из Api).
+        }
-    // Публикуется только когда проход реально выполнен и что-то изменил (started и
+
-    // reclassified &gt; 0): пустой inbox/всё пропущено не меняют доску — событие не шлём. Нагрузка
+        SseBroker broker = context.RequestServices.GetRequiredService<SseBroker>();
-    // минимальная: сколько обработано и перемещено (фронт перечитывает доску). Без подписчиков — no-op.
+        broker.Publish(
-    // context: Контекст запроса (тенант-канал сессии).
+            context.GetCurrentUser()!.TenantId,
-    // result: Итог прохода.
+            ReclassifiedEventType,
-    private static void PublishReclassified(HttpContext context, ReclassifyResultDto result)
+            new { reclassified = result.Reclassified, moved = result.Moved });
-    {
+    }
-        if (!result.Started || result.Reclassified == 0)
+
-        {
+    // Аудит переклассификации: пишется только когда проход реально что-то изменил.
-            return;
+    // context: Контекст запроса.
-        }
+    // result: Итог прохода.
-
+    // ct: Токен отмены.
-        SseBroker broker = context.RequestServices.GetRequiredService<SseBroker>();
+    private static Task AppendReclassifyAuditAsync(
-        broker.Publish(
+        HttpContext context,
-            context.GetCurrentUser()!.TenantId,
+        ReclassifyResultDto result,
-            ReclassifiedEventType,
+        CancellationToken ct)
-            new { reclassified = result.Reclassified, moved = result.Moved });
+    {
-    }
+        if (result.Reclassified == 0)
-
+        {
-    // Аудит переклассификации: пишется только когда проход реально что-то изменил.
+            return Task.CompletedTask;
-    // context: Контекст запроса.
+        }
-    // result: Итог прохода.
+
-    // ct: Токен отмены.
+        return AuditAppender.AppendTenantAsync(
-    private static Task AppendReclassifyAuditAsync(
+            context,
-        HttpContext context,
+            AuditEvents.CardReclassified,
-        ReclassifyResultDto result,
+            new { attempted = result.Attempted, reclassified = result.Reclassified, moved = result.Moved, trashed = result.Trashed },
-        CancellationToken ct)
+            ct);
-    {
+    }
-        if (result.Reclassified == 0)
+
-        {
+    // GET /api/search?q=: поиск карточек (FTS + LIKE, Ruling 6/Task 12; dashboard_routes L254–256). Ответ {leads, messages: []}.
-            return Task.CompletedTask;
+    private static async Task<IResult> SearchAsync(
-        }
+        string? q,
-
+        HttpContext context,
-        return AuditAppender.AppendTenantAsync(
+        CancellationToken ct)
-            context,
+    {
-            AuditEvents.CardReclassified,
+        if (!context.HasUser())
-            new { attempted = result.Attempted, reclassified = result.Reclassified, moved = result.Moved, trashed = result.Trashed },
+        {
-            ct);
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // GET /api/search?q=: поиск карточек (FTS + LIKE, Ruling 6/Task 12; dashboard_routes L254–256). Ответ {leads, messages: []}.
+        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
-    private static async Task<IResult> SearchAsync(
+        IReadOnlyList<CardDto> leads = await cardsService.SearchCardsAsync(q, ct);
-        string? q,
+
-        HttpContext context,
+        // messages всегда []: telegram-сообщений здесь нет, фронт их не читает.
-        CancellationToken ct)
+        return Results.Ok(new { cards = leads, messages = Array.Empty<object>() });
-    {
+    }
-        if (!context.HasUser())
+
-        {
+    // ── Внутреннее ─────────────────────────────────────────────────────────
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+    // Существует ли контейнер с таким id (служебная зона/стадия/доска).
-
+    // col: Значение query-параметра containerId (непустое).
-        CardsService cardsService = context.RequestServices.GetRequiredService<CardsService>();
+    // context: Контекст запроса (для резолва ContainersService).
-        IReadOnlyList<CardDto> leads = await cardsService.SearchCardsAsync(q, ct);
+    // ct: Токен отмены.
-
+    // Возвращает: True — контейнер допустим для фильтра.
-        // messages всегда []: telegram-сообщений здесь нет, фронт их не читает.
+    private static async Task<bool> IsKnownContainerAsync(
-        return Results.Ok(new { cards = leads, messages = Array.Empty<object>() });
+        string col,
-    }
+        HttpContext context,
-
+        CancellationToken ct)
-    // ── Внутреннее ─────────────────────────────────────────────────────────
+    {
-
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-    // Существует ли контейнер с таким id (служебная зона/стадия/доска).
+        return await containers.GetAsync(col, ct) is not null;
-    // col: Значение query-параметра containerId (непустое).
+    }
-    // context: Контекст запроса (для резолва ContainersService).
+}
-    // ct: Токен отмены.
-    // Возвращает: True — контейнер допустим для фильтра.
-    private static async Task<bool> IsKnownContainerAsync(
-        string col,
-        HttpContext context,
-        CancellationToken ct)
-    {
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-        return await containers.GetAsync(col, ct) is not null;
-    }
-}

src/core/Deal.Api/Endpoints/ChangePasswordRequest.cs

@@ -1,11 +1,8 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/auth/change-password. Входящий JSON — camelCase (oldPassword, newPassword).
-
+/// </summary>
-/// <summary>
+/// <param name="OldPassword">Текущий пароль.</param>
-/// Тело POST /api/auth/change-password. Входящий JSON — camelCase (oldPassword, newPassword).
+/// <param name="NewPassword">Новый пароль (минимум 8 символов).</param>
-/// </summary>
+public sealed record ChangePasswordRequest(string OldPassword, string NewPassword);
-/// <param name="OldPassword">Текущий пароль.</param>
-/// <param name="NewPassword">Новый пароль (минимум 8 символов).</param>
-public sealed record ChangePasswordRequest(string OldPassword, string NewPassword);

src/core/Deal.Api/Endpoints/CheckMessageRequest.cs

@@ -1,10 +1,7 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/admin/check-message (1:1 с CheckMessageBody, dashboard_routes.py L72–73).
-
+/// </summary>
-/// <summary>
+/// <param name="Text">Текст сообщения для проверки фильтром (этап 1 + этап 2 тестера).</param>
-/// Тело POST /api/admin/check-message (1:1 с CheckMessageBody, dashboard_routes.py L72–73).
+public sealed record CheckMessageRequest(string Text);
-/// </summary>
-/// <param name="Text">Текст сообщения для проверки фильтром (этап 1 + этап 2 тестера).</param>
-public sealed record CheckMessageRequest(string Text);

src/core/Deal.Api/Endpoints/ContainersEndpoints.cs

@@ -1,332 +1,323 @@
-using System.Text.Json;
+using System.Text.Json;
-using Deal.Api.Endpoints.RequestModels;
+using Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Modules.Kanban.Application.Abstractions;
+using Deal.Modules.Kanban.Application.Services;
-using Deal.Modules.Kanban.Application.Extensions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Kanban.Application.Models;
+
-using Deal.Modules.Kanban.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Kanban.Application.Services;
+
-using Deal.Modules.Tenants.Application.Abstractions;
+/// <summary>
-using Deal.Modules.Tenants.Application.Extensions;
+/// Эндпоинты контейнеров (колонок/стадий/зон) и состояния колонок: GET/POST /api/containers,
-using Deal.Modules.Tenants.Application.Models;
+/// PATCH /{id}/accept, PATCH/DELETE /{id}, POST /reorder, GET/PATCH state (этап 9, T4/T6).
-using Deal.Modules.Tenants.Application.Registrars;
+/// </summary>
-using Deal.Modules.Tenants.Application.Services;
+/// <remarks>
-using Deal.Api.Dtos;
+/// Единый реестр контейнеров приходит на смену /api/boards + /api/columns (R5): список, создание,
-
+/// частичное обновление, принятие ИИ-предложения, удаление с переносом карточек в inbox, reorder и
-namespace Deal.Api.Endpoints;
+/// состояние колонок (colState). Все эндпоинты требуют сессию: 401 {detail}. ContainersService
-
+/// резолвится из RequestServices ПОСЛЕ проверки сессии.
-/// <summary>
+/// </remarks>
-/// Эндпоинты контейнеров (колонок/стадий/зон) и состояния колонок: GET/POST /api/containers,
+public static class ContainersEndpoints
-/// PATCH /{id}/accept, PATCH/DELETE /{id}, POST /reorder, GET/PATCH state (этап 9, T4/T6).
+{
-/// </summary>
+    // Префикс группы контейнеров.
-/// <remarks>
+    private const string ContainersGroupPrefix = "/api/containers";
-/// Единый реестр контейнеров приходит на смену /api/boards + /api/columns (R5): список, создание,
+
-/// частичное обновление, принятие ИИ-предложения, удаление с переносом карточек в inbox, reorder и
+    // OpenAPI-тег группы.
-/// состояние колонок (colState). Все эндпоинты требуют сессию: 401 {detail}. ContainersService
+    private const string OpenApiTag = "containers";
-/// резолвится из RequestServices ПОСЛЕ проверки сессии.
+
-/// </remarks>
+    // 404 PATCH/accept: контейнер не найден.
-public static class ContainersEndpoints
+    private const string ContainerNotFoundDetail = "Контейнер не найден";
-{
+
-    // Префикс группы контейнеров.
+    // 400: отсутствующий/явный null name контейнера.
-    private const string ContainersGroupPrefix = "/api/containers";
+    private const string ContainerNameRequiredDetail = "Укажите название колонки";
-
+
-    // OpenAPI-тег группы.
+    // 400 reorder: отсутствующий/явный null order.
-    private const string OpenApiTag = "containers";
+    private const string ContainerOrderRequiredDetail = "Не указан порядок колонок";
-
+
-    // 404 PATCH/accept: контейнер не найден.
+    // 400 PATCH: тело не JSON-объект.
-    private const string ContainerNotFoundDetail = "Контейнер не найден";
+    private const string InvalidBodyDetail = "Тело запроса должно быть JSON-объектом";
-
+
-    // 400: отсутствующий/явный null name контейнера.
+    // Опции разбора PATCH-тела: web-дефолты (camelCase + регистронезависимость).
-    private const string ContainerNameRequiredDetail = "Укажите название колонки";
+    private static readonly JsonSerializerOptions RequestJsonOptions = new(JsonSerializerDefaults.Web);
-
+
-    // 400 reorder: отсутствующий/явный null order.
+    /// <summary>
-    private const string ContainerOrderRequiredDetail = "Не указан порядок колонок";
+    /// Регистрирует группы /api/containers (контейнеры + состояние колонок).
-
+    /// </summary>
-    // 400 PATCH: тело не JSON-объект.
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    private const string InvalidBodyDetail = "Тело запроса должно быть JSON-объектом";
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-
+    public static IEndpointRouteBuilder MapContainersEndpoints(this IEndpointRouteBuilder app)
-    // Опции разбора PATCH-тела: web-дефолты (camelCase + регистронезависимость).
+    {
-    private static readonly JsonSerializerOptions RequestJsonOptions = new(JsonSerializerDefaults.Web);
+        var containers = app.MapGroup(ContainersGroupPrefix).WithTags(OpenApiTag);
-
+        containers.MapGet("", ListContainersAsync);
-    /// <summary>
+        containers.MapPost("", CreateContainerAsync);
-    /// Регистрирует группы /api/containers (контейнеры + состояние колонок).
+        containers.MapPost("/reorder", ReorderContainersAsync);
-    /// </summary>
+        containers.MapGet("/state", GetColumnsStateAsync);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        containers.MapPatch("/{containerId}/state", PatchColumnStateAsync);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        containers.MapPost("/{containerId}/accept", AcceptSuggestedAsync);
-    public static IEndpointRouteBuilder MapContainersEndpoints(this IEndpointRouteBuilder app)
+        containers.MapPatch("/{containerId}", PatchContainerAsync);
-    {
+        containers.MapDelete("/{containerId}", DeleteContainerAsync);
-        var containers = app.MapGroup(ContainersGroupPrefix).WithTags(OpenApiTag);
+        return app;
-        containers.MapGet("", ListContainersAsync);
+    }
-        containers.MapPost("", CreateContainerAsync);
+
-        containers.MapPost("/reorder", ReorderContainersAsync);
+    // GET /api/containers?space=: список контейнеров пространства (или всех) со счётчиками.
-        containers.MapGet("/state", GetColumnsStateAsync);
+    private static async Task<IResult> ListContainersAsync(
-        containers.MapPatch("/{containerId}/state", PatchColumnStateAsync);
+        string? space,
-        containers.MapPost("/{containerId}/accept", AcceptSuggestedAsync);
+        HttpContext context,
-        containers.MapPatch("/{containerId}", PatchContainerAsync);
+        CancellationToken ct)
-        containers.MapDelete("/{containerId}", DeleteContainerAsync);
+    {
-        return app;
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // GET /api/containers?space=: список контейнеров пространства (или всех) со счётчиками.
+        }
-    private static async Task<IResult> ListContainersAsync(
+
-        string? space,
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-        HttpContext context,
+        return Results.Ok(new { items = await containers.ListAsync(space, ct) });
-        CancellationToken ct)
+    }
-    {
+
-        if (!context.HasUser())
+    // POST /api/containers: создать контейнер; ответ {id}.
-        {
+    private static async Task<IResult> CreateContainerAsync(
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        ContainerCreateRequest body,
-        }
+        HttpContext context,
-
+        CancellationToken ct)
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+    {
-        return Results.Ok(new { items = await containers.ListAsync(space, ct) });
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // POST /api/containers: создать контейнер; ответ {id}.
+        }
-    private static async Task<IResult> CreateContainerAsync(
+
-        ContainerCreateRequest body,
+        if (body.Name is null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.BadRequest(ContainerNameRequiredDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        ContainerDto created = await containers.CreateAsync(
-        }
+            new ContainerCreateDto(
-
+                Name: body.Name,
-        if (body.Name is null)
+                Description: body.Description ?? string.Empty,
-        {
+                Color: body.Color,
-            return EndpointResults.BadRequest(ContainerNameRequiredDetail);
+                Space: body.Space ?? ContainerSpaces.Dashboard,
-        }
+                Kind: body.Kind ?? ContainerKinds.Board,
-
+                Suggested: body.Suggested ?? false,
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+                Rules: NormalizeWireRules(body.Rules),
-        ContainerDto created = await containers.CreateAsync(
+                Note: body.Note ?? string.Empty),
-            new ContainerCreateDto(
+            ct);
-                Name: body.Name,
+
-                Description: body.Description ?? string.Empty,
+        // Аудит создания контейнера (этап 10, T1).
-                Color: body.Color,
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerCreated, new { id = created.Id, name = created.Name }, ct);
-                Space: body.Space ?? ContainerSpaces.Dashboard,
+        return Results.Ok(new { id = created.Id });
-                Kind: body.Kind ?? ContainerKinds.Board,
+    }
-                Suggested: body.Suggested ?? false,
+
-                Rules: NormalizeWireRules(body.Rules),
+    // PATCH /api/containers/{id}: частичное обновление; ответ {id}; 404 «Контейнер не найден».
-                Note: body.Note ?? string.Empty),
+    private static async Task<IResult> PatchContainerAsync(
-            ct);
+        string containerId,
-
+        JsonElement body,
-        // Аудит создания контейнера (этап 10, T1).
+        HttpContext context,
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerCreated, new { id = created.Id, name = created.Name }, ct);
+        CancellationToken ct)
-        return Results.Ok(new { id = created.Id });
+    {
-    }
+        if (!context.HasUser())
-
+        {
-    // PATCH /api/containers/{id}: частичное обновление; ответ {id}; 404 «Контейнер не найден».
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    private static async Task<IResult> PatchContainerAsync(
+        }
-        string containerId,
+
-        JsonElement body,
+        if (body.ValueKind != JsonValueKind.Object)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.BadRequest(InvalidBodyDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        foreach (JsonProperty property in body.EnumerateObject())
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        {
-        }
+            if (string.Equals(property.Name, "name", StringComparison.OrdinalIgnoreCase)
-
+                && property.Value.ValueKind == JsonValueKind.Null)
-        if (body.ValueKind != JsonValueKind.Object)
+            {
-        {
+                return EndpointResults.BadRequest(ContainerNameRequiredDetail);
-            return EndpointResults.BadRequest(InvalidBodyDetail);
+            }
-        }
+        }
-
+
-        foreach (JsonProperty property in body.EnumerateObject())
+        ContainerPatchRequest? patchBody;
-        {
+        try
-            if (string.Equals(property.Name, "name", StringComparison.OrdinalIgnoreCase)
+        {
-                && property.Value.ValueKind == JsonValueKind.Null)
+            patchBody = body.Deserialize<ContainerPatchRequest>(RequestJsonOptions);
-            {
+        }
-                return EndpointResults.BadRequest(ContainerNameRequiredDetail);
+        catch (JsonException)
-            }
+        {
-        }
+            return EndpointResults.BadRequest(InvalidBodyDetail);
-
+        }
-        ContainerPatchRequest? patchBody;
+
-        try
+        if (patchBody is null)
-        {
+        {
-            patchBody = body.Deserialize<ContainerPatchRequest>(RequestJsonOptions);
+            return EndpointResults.BadRequest(InvalidBodyDetail);
-        }
+        }
-        catch (JsonException)
+
-        {
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-            return EndpointResults.BadRequest(InvalidBodyDetail);
+        ContainerDto? updated = await containers.PatchAsync(
-        }
+            containerId,
-
+            new ContainerPatchDto(
-        if (patchBody is null)
+                patchBody.Name,
-        {
+                patchBody.Description,
-            return EndpointResults.BadRequest(InvalidBodyDetail);
+                patchBody.Color,
-        }
+                patchBody.Collapsed,
-
+                patchBody.Suggested,
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+                patchBody.Note,
-        ContainerDto? updated = await containers.PatchAsync(
+                NormalizeWireRules(patchBody.Rules),
-            containerId,
+                patchBody.Policy),
-            new ContainerPatchDto(
+            ct);
-                patchBody.Name,
+        if (updated is null)
-                patchBody.Description,
+        {
-                patchBody.Color,
+            return EndpointResults.NotFound(ContainerNotFoundDetail);
-                patchBody.Collapsed,
+        }
-                patchBody.Suggested,
+
-                patchBody.Note,
+        // Аудит изменения контейнера (этап 10, T1).
-                NormalizeWireRules(patchBody.Rules),
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerUpdated, new { id = updated.Id }, ct);
-                patchBody.Policy),
+        return Results.Ok(new { id = updated.Id });
-            ct);
+    }
-        if (updated is null)
+
-        {
+    // POST /api/containers/{id}/accept: принять ИИ-предложение (suggested=false).
-            return EndpointResults.NotFound(ContainerNotFoundDetail);
+    private static async Task<IResult> AcceptSuggestedAsync(
-        }
+        string containerId,
-
+        HttpContext context,
-        // Аудит изменения контейнера (этап 10, T1).
+        CancellationToken ct)
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerUpdated, new { id = updated.Id }, ct);
+    {
-        return Results.Ok(new { id = updated.Id });
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // POST /api/containers/{id}/accept: принять ИИ-предложение (suggested=false).
+        }
-    private static async Task<IResult> AcceptSuggestedAsync(
+
-        string containerId,
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-        HttpContext context,
+        ContainerDto? accepted = await containers.AcceptSuggestedAsync(containerId, ct);
-        CancellationToken ct)
+        if (accepted is null)
-    {
+        {
-        if (!context.HasUser())
+            return EndpointResults.NotFound(ContainerNotFoundDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        // Аудит изменения контейнера (принятие ИИ-предложения) — этап 10, T1.
-
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerUpdated, new { id = accepted.Id }, ct);
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+        return Results.Ok(accepted);
-        ContainerDto? accepted = await containers.AcceptSuggestedAsync(containerId, ct);
+    }
-        if (accepted is null)
+
-        {
+    // DELETE /api/containers/{id}: удалить контейнер; карточки → «Неразобранное» новыми.
-            return EndpointResults.NotFound(ContainerNotFoundDetail);
+    private static async Task<IResult> DeleteContainerAsync(
-        }
+        string containerId,
-
+        HttpContext context,
-        // Аудит изменения контейнера (принятие ИИ-предложения) — этап 10, T1.
+        CancellationToken ct)
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerUpdated, new { id = accepted.Id }, ct);
+    {
-        return Results.Ok(accepted);
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // DELETE /api/containers/{id}: удалить контейнер; карточки → «Неразобранное» новыми.
+        }
-    private static async Task<IResult> DeleteContainerAsync(
+
-        string containerId,
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-        HttpContext context,
+        int moved = await containers.DeleteAsync(containerId, ct);
-        CancellationToken ct)
+
-    {
+        // Аудит удаления контейнера (этап 10, T1).
-        if (!context.HasUser())
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerDeleted, new { id = containerId }, ct);
-        {
+        return Results.Ok(new { ok = true, movedToInbox = moved });
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    }
-        }
+
-
+    // POST /api/containers/reorder: порядок контейнеров пространства; ответ {ok:true}.
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+    private static async Task<IResult> ReorderContainersAsync(
-        int moved = await containers.DeleteAsync(containerId, ct);
+        OrderBody body,
-
+        HttpContext context,
-        // Аудит удаления контейнера (этап 10, T1).
+        CancellationToken ct)
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.ContainerDeleted, new { id = containerId }, ct);
+    {
-        return Results.Ok(new { ok = true, movedToInbox = moved });
+        if (!context.HasUser())
-    }
+        {
-
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    // POST /api/containers/reorder: порядок контейнеров пространства; ответ {ok:true}.
+        }
-    private static async Task<IResult> ReorderContainersAsync(
+
-        OrderBody body,
+        if (body.Order is null)
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.BadRequest(ContainerOrderRequiredDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        await containers.ReorderAsync(body.Space ?? ContainerSpaces.Dashboard, body.Order, ct);
-        }
+        return Results.Ok(new { ok = true });
-
+    }
-        if (body.Order is null)
+
-        {
+    // GET /api/containers/state: свёрнутость/ширина всех колонок (colState).
-            return EndpointResults.BadRequest(ContainerOrderRequiredDetail);
+    private static async Task<IResult> GetColumnsStateAsync(HttpContext context, CancellationToken ct)
-        }
+    {
-
+        if (!context.HasUser())
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+        {
-        await containers.ReorderAsync(body.Space ?? ContainerSpaces.Dashboard, body.Order, ct);
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        return Results.Ok(new { ok = true });
+        }
-    }
+
-
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-    // GET /api/containers/state: свёрнутость/ширина всех колонок (colState).
+        IReadOnlyDictionary<string, ColumnStateDto> state = await containers.GetColStateAsync(ct);
-    private static async Task<IResult> GetColumnsStateAsync(HttpContext context, CancellationToken ct)
+
-    {
+        var wire = new Dictionary<string, object>(StringComparer.Ordinal);
-        if (!context.HasUser())
+        foreach ((string colId, ColumnStateDto colState) in state)
-        {
+        {
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+            wire[colId] = ToWireState(colState);
-        }
+        }
-
+
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+        return Results.Ok(wire);
-        IReadOnlyDictionary<string, ColumnStateDto> state = await containers.GetColStateAsync(ct);
+    }
-
+
-        var wire = new Dictionary<string, object>(StringComparer.Ordinal);
+    // PATCH /api/containers/{id}/state: merge патча в состояние колонки; ответ — состояние этой колонки.
-        foreach ((string colId, ColumnStateDto colState) in state)
+    private static async Task<IResult> PatchColumnStateAsync(
-        {
+        string containerId,
-            wire[colId] = ToWireState(colState);
+        ColStateBody body,
-        }
+        HttpContext context,
-
+        CancellationToken ct)
-        return Results.Ok(wire);
+    {
-    }
+        if (!context.HasUser())
-
+        {
-    // PATCH /api/containers/{id}/state: merge патча в состояние колонки; ответ — состояние этой колонки.
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    private static async Task<IResult> PatchColumnStateAsync(
+        }
-        string containerId,
+
-        ColStateBody body,
+        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
-        HttpContext context,
+        ColumnStateDto merged = await containers.PatchColStateAsync(
-        CancellationToken ct)
+            containerId,
-    {
+            new ColumnStateDto(body.Collapsed, body.Width),
-        if (!context.HasUser())
+            ct);
-        {
+        return Results.Ok(ToWireState(merged));
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    }
-        }
+
-
+    // Правила из wire → каноничный ContainerRulesDto: отсутствующие группы становятся пустыми списками.
-        ContainersService containers = context.RequestServices.GetRequiredService<ContainersService>();
+    // rules: Правила из тела запроса (null — «не меняются/нет правил»).
-        ColumnStateDto merged = await containers.PatchColStateAsync(
+    // Возвращает: Каноничные правила с не-null группами; null — правил в теле нет.
-            containerId,
+    private static ContainerRulesDto? NormalizeWireRules(ContainerRulesDto? rules)
-            new ColumnStateDto(body.Collapsed, body.Width),
+    {
-            ct);
+        if (rules is null)
-        return Results.Ok(ToWireState(merged));
+        {
-    }
+            return null;
-
+        }
-    // Правила из wire → каноничный ContainerRulesDto: отсутствующие группы становятся пустыми списками.
+
-    // rules: Правила из тела запроса (null — «не меняются/нет правил»).
+        return rules with
-    // Возвращает: Каноничные правила с не-null группами; null — правил в теле нет.
+        {
-    private static ContainerRulesDto? NormalizeWireRules(ContainerRulesDto? rules)
+            Mode = rules.Mode ?? string.Empty,
-    {
+            Direction = rules.Direction ?? Array.Empty<string>(),
-        if (rules is null)
+            Keywords = rules.Keywords ?? Array.Empty<string>(),
-        {
+            Stack = rules.Stack ?? Array.Empty<string>(),
-            return null;
+            Grade = rules.Grade ?? Array.Empty<string>(),
-        }
+            Exclude = rules.Exclude ?? Array.Empty<string>(),
-
+            Budget = rules.Budget is null ? null : rules.Budget with { Cur = rules.Budget.Cur ?? string.Empty },
-        return rules with
+            Levels = rules.Levels ?? Array.Empty<string>(),
-        {
+            Locations = rules.Locations ?? Array.Empty<string>(),
-            Mode = rules.Mode ?? string.Empty,
+            Types = rules.Types ?? Array.Empty<string>(),
-            Direction = rules.Direction ?? Array.Empty<string>(),
+            Prices = rules.Prices is null ? null : rules.Prices with { Cur = rules.Prices.Cur ?? string.Empty },
-            Keywords = rules.Keywords ?? Array.Empty<string>(),
+        };
-            Stack = rules.Stack ?? Array.Empty<string>(),
+    }
-            Grade = rules.Grade ?? Array.Empty<string>(),
+
-            Exclude = rules.Exclude ?? Array.Empty<string>(),
+    // Состояние колонки → wire-объект только с заданными полями (collapsed/width), без null.
-            Budget = rules.Budget is null ? null : rules.Budget with { Cur = rules.Budget.Cur ?? string.Empty },
+    // state: Состояние колонки (могут быть null-поля).
-            Levels = rules.Levels ?? Array.Empty<string>(),
+    // Возвращает: Словарь из не-null полей состояния.
-            Locations = rules.Locations ?? Array.Empty<string>(),
+    private static Dictionary<string, object> ToWireState(ColumnStateDto state)
-            Types = rules.Types ?? Array.Empty<string>(),
+    {
-            Prices = rules.Prices is null ? null : rules.Prices with { Cur = rules.Prices.Cur ?? string.Empty },
+        var wire = new Dictionary<string, object>();
-        };
+        if (state.Collapsed is { } collapsed)
-    }
+        {
-
+            wire["collapsed"] = collapsed;
-    // Состояние колонки → wire-объект только с заданными полями (collapsed/width), без null.
+        }
-    // state: Состояние колонки (могут быть null-поля).
+
-    // Возвращает: Словарь из не-null полей состояния.
+        if (state.Width is not null)
-    private static Dictionary<string, object> ToWireState(ColumnStateDto state)
+        {
-    {
+            wire["width"] = state.Width;
-        var wire = new Dictionary<string, object>();
+        }
-        if (state.Collapsed is { } collapsed)
+
-        {
+        return wire;
-            wire["collapsed"] = collapsed;
+    }
-        }
+}
-
-        if (state.Width is not null)
-        {
-            wire["width"] = state.Width;
-        }
-
-        return wire;
-    }
-}

src/core/Deal.Api/Endpoints/EventsEndpoint.cs

@@ -1,122 +1,121 @@
-using Deal.Api.Events;
+using Deal.Api.Events;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Models;
-using Deal.Api.Services;
+using Deal.Api.Services;
-using Deal.Api.Dtos;
+
-
+namespace Deal.Api.Endpoints;
-namespace Deal.Api.Endpoints;
+
-
+/// <summary>
-/// <summary>
+/// SSE-поток событий канбана: GET /api/events (Ruling 5; прототип events_routes.py L15–38).
-/// SSE-поток событий канбана: GET /api/events (Ruling 5; прототип events_routes.py L15–38).
+/// </summary>
-/// </summary>
+/// <remarks>
-/// <remarks>
+/// Открывает <c>text/event-stream</c> с подпиской на канал тенанта сессии (singleton SseBroker).
-/// Открывает <c>text/event-stream</c> с подпиской на канал тенанта сессии (singleton SseBroker).
+/// События пишутся по мере поступления; при тишине 15 с отправляется ping-комментарий ": ping" —
-/// События пишутся по мере поступления; при тишине 15 с отправляется ping-комментарий ": ping" —
+/// соединение держится (переподключение EventSource, api.js L62–104). Завершение — по отвалу клиента
-/// соединение держится (переподключение EventSource, api.js L62–104). Завершение — по отвалу клиента
+/// (CancellationToken = RequestAborted); отписка — в finally. Без сессии — 401 {detail} (Ruling 10,
-/// (CancellationToken = RequestAborted); отписка — в finally. Без сессии — 401 {detail} (Ruling 10,
+/// паттерн остальных эндпоинтов). Заголовки: Content-Type text/event-stream, Cache-Control: no-cache,
-/// паттерн остальных эндпоинтов). Заголовки: Content-Type text/event-stream, Cache-Control: no-cache,
+/// X-Accel-Buffering: no (запрет буферизации прокси, иначе ping/события задерживаются).
-/// X-Accel-Buffering: no (запрет буферизации прокси, иначе ping/события задерживаются).
+/// </remarks>
-/// </remarks>
+public static class EventsEndpoint
-public static class EventsEndpoint
+{
-{
+    // Путь потока (роутер events, events_routes.py L12: prefix="/api").
-    // Путь потока (роутер events, events_routes.py L12: prefix="/api").
+    private const string EventsPath = "/api/events";
-    private const string EventsPath = "/api/events";
+
-
+    // OpenAPI-тег группы (в прототипе — роутер events_routes.py).
-    // OpenAPI-тег группы (в прототипе — роутер events_routes.py).
+    private const string OpenApiTag = "events";
-    private const string OpenApiTag = "events";
+
-
+    // Тип контента потока (events_routes.py L32).
-    // Тип контента потока (events_routes.py L32).
+    private const string EventStreamContentType = "text/event-stream";
-    private const string EventStreamContentType = "text/event-stream";
+
-
+    // Директива кеширования: поток не кешируется (events_routes.py L34).
-    // Директива кеширования: поток не кешируется (events_routes.py L34).
+    private const string NoCacheHeaderValue = "no-cache";
-    private const string NoCacheHeaderValue = "no-cache";
+
-
+    // Отключение буферизации ответа nginx-прокси (events_routes.py L35).
-    // Отключение буферизации ответа nginx-прокси (events_routes.py L35).
+    private const string NoBufferingHeaderValue = "no";
-    private const string NoBufferingHeaderValue = "no";
+
-
+    // Ping-комментарий: строки протокола SSE, начинающиеся с ':', клиент игнорирует.
-    // Ping-комментарий: строки протокола SSE, начинающиеся с ':', клиент игнорирует.
+    private const string PingComment = ": ping\n\n";
-    private const string PingComment = ": ping\n\n";
+
-
+    // Интервал ping при тишине: держим соединение (events_routes.py L24: timeout=15).
-    // Интервал ping при тишине: держим соединение (events_routes.py L24: timeout=15).
+    private static readonly TimeSpan PingInterval = TimeSpan.FromSeconds(15);
-    private static readonly TimeSpan PingInterval = TimeSpan.FromSeconds(15);
+
-
+    /// <summary>
-    /// <summary>
+    /// Регистрирует GET /api/events.
-    /// Регистрирует GET /api/events.
+    /// </summary>
-    /// </summary>
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// <param name="app">Построитель маршрутов приложения.</param>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+    public static IEndpointRouteBuilder MapEventsEndpoint(this IEndpointRouteBuilder app)
-    public static IEndpointRouteBuilder MapEventsEndpoint(this IEndpointRouteBuilder app)
+    {
-    {
+        app.MapGet(EventsPath, StreamEventsAsync).WithTags(OpenApiTag);
-        app.MapGet(EventsPath, StreamEventsAsync).WithTags(OpenApiTag);
+        return app;
-        return app;
+    }
-    }
+
-
+    // GET /api/events: поток text/event-stream канала тенанта сессии.
-    // GET /api/events: поток text/event-stream канала тенанта сессии.
+    // context: Контекст запроса (сессия — HttpContext.Items).
-    // context: Контекст запроса (сессия — HttpContext.Items).
+    // ct: Отмена запроса: клиент отвалился — завершаем поток и отписываемся.
-    // ct: Отмена запроса: клиент отвалился — завершаем поток и отписываемся.
+    private static async Task StreamEventsAsync(HttpContext context, CancellationToken ct)
-    private static async Task StreamEventsAsync(HttpContext context, CancellationToken ct)
+    {
-    {
+        CurrentUser? user = context.GetCurrentUser();
-        CurrentUser? user = context.GetCurrentUser();
+        if (user is null)
-        if (user is null)
+        {
-        {
+            await EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail).ExecuteAsync(context);
-            await EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail).ExecuteAsync(context);
+            return;
-            return;
+        }
-        }
+
-
+        SseBroker broker = context.RequestServices.GetRequiredService<SseBroker>();
-        SseBroker broker = context.RequestServices.GetRequiredService<SseBroker>();
+        SseSubscription subscription = broker.Subscribe(user.TenantId);
-        SseSubscription subscription = broker.Subscribe(user.TenantId);
+        try
-        try
+        {
-        {
+            HttpResponse response = context.Response;
-            HttpResponse response = context.Response;
+            response.ContentType = EventStreamContentType;
-            response.ContentType = EventStreamContentType;
+            response.Headers["Cache-Control"] = NoCacheHeaderValue;
-            response.Headers["Cache-Control"] = NoCacheHeaderValue;
+            response.Headers["X-Accel-Buffering"] = NoBufferingHeaderValue;
-            response.Headers["X-Accel-Buffering"] = NoBufferingHeaderValue;
+
-
+            while (true)
-            while (true)
+            {
-            {
+                using var pingTimeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
-                using var pingTimeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
+                pingTimeout.CancelAfter(PingInterval);
-                pingTimeout.CancelAfter(PingInterval);
+                try
-                try
+                {
-                {
+                    await subscription.Events.WaitToReadAsync(pingTimeout.Token);
-                    await subscription.Events.WaitToReadAsync(pingTimeout.Token);
+                }
-                }
+                catch (OperationCanceledException) when (!ct.IsCancellationRequested)
-                catch (OperationCanceledException) when (!ct.IsCancellationRequested)
+                {
-                {
+                    // Тишина 15 с — ping держит соединение; отмену клиента ловит внешний catch.
-                    // Тишина 15 с — ping держит соединение; отмену клиента ловит внешний catch.
+                    await WriteFrameAsync(response, PingComment, ct);
-                    await WriteFrameAsync(response, PingComment, ct);
+                    continue;
-                    continue;
+                }
-                }
+
-
+                while (subscription.Events.TryRead(out SseEvent? sseEvent))
-                while (subscription.Events.TryRead(out SseEvent? sseEvent))
+                {
-                {
+                    await WriteFrameAsync(response, sseEvent.RenderFrame(), ct);
-                    await WriteFrameAsync(response, sseEvent.RenderFrame(), ct);
+                }
-                }
+            }
-            }
+        }
-        }
+        catch (OperationCanceledException) when (ct.IsCancellationRequested)
-        catch (OperationCanceledException) when (ct.IsCancellationRequested)
+        {
-        {
+            // Клиент закрыл соединение — штатное завершение потока.
-            // Клиент закрыл соединение — штатное завершение потока.
+        }
-        }
+        catch (IOException)
-        catch (IOException)
+        {
-        {
+            // Сброс соединения клиентом (закрытая вкладка/обрыв сети): ответ уже не доставить.
-            // Сброс соединения клиентом (закрытая вкладка/обрыв сети): ответ уже не доставить.
+        }
-        }
+        finally
-        finally
+        {
-        {
+            broker.Unsubscribe(user.TenantId, subscription.Id);
-            broker.Unsubscribe(user.TenantId, subscription.Id);
+        }
-        }
+    }
-    }
+
-
+    // Пишет frame в поток ответа и сбрасывает буфер — события уходят сразу (не пачкой).
-    // Пишет frame в поток ответа и сбрасывает буфер — события уходят сразу (не пачкой).
+    // response: Ответ (stream уже начат).
-    // response: Ответ (stream уже начат).
+    // frame: Frame протокола SSE.
-    // frame: Frame протокола SSE.
+    // ct: Токен отмены запроса.
-    // ct: Токен отмены запроса.
+    private static async Task WriteFrameAsync(
-    private static async Task WriteFrameAsync(
+        HttpResponse response,
-        HttpResponse response,
+        string frame,
-        string frame,
+        CancellationToken ct)
-        CancellationToken ct)
+    {
-    {
+        await response.WriteAsync(frame, ct);
-        await response.WriteAsync(frame, ct);
+        await response.Body.FlushAsync(ct);
-        await response.Body.FlushAsync(ct);
+    }
-    }
+}
-}

src/core/Deal.Api/Endpoints/FilterTesterEndpoints.cs

@@ -1,83 +1,78 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Settings.Application.Models;
-using Deal.Modules.Settings.Application.Abstractions;
+
-using Deal.Modules.Settings.Application.Models;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Settings.Application.Registrars;
+
-using Deal.Modules.Settings.Application.Services;
+/// <summary>
-using Deal.Api.Dtos;
+/// Тестер фильтра входящих: POST /api/admin/check-message (Ruling 8, api-map §3.2 L109, §4.10 L364).
-
+/// </summary>
-namespace Deal.Api.Endpoints;
+/// <remarks>
-
+/// Имитация этапов пайплайна для тестера в настройках — 1:1 с <c>dashboard_routes.py</c> L267–284:
-/// <summary>
+/// этап 1 считают детерминированные правила <see cref="IncomingRules"/> (<c>stage1_plain</c>, pipeline.py
-/// Тестер фильтра входящих: POST /api/admin/check-message (Ruling 8, api-map §3.2 L109, §4.10 L364).
+/// L94–124) по настройкам тенанта; ответ — <c>{stage1:{pass,reason}, stage2:{pass,reason,skipped}, passed}</c>.
-/// </summary>
+/// ИИ-фильтр этапа 2 на этапе 2 ВСЕГДА skipped (Ruling 4/8, план Task 10 L377–380): если этап-1 не прошёл —
-/// <remarks>
+/// <c>stage2={pass:false,reason:null,skipped:true}, passed:false</c>; иначе — <c>stage2={pass:true,reason:null,
-/// Имитация этапов пайплайна для тестера в настройках — 1:1 с <c>dashboard_routes.py</c> L267–284:
+/// skipped:true}, passed:true</c> (реальный ИИ-фильтр — этап 6, ветка ошибки ИИ прототипа L281 к skipped
-/// этап 1 считают детерминированные правила <see cref="IncomingRules"/> (<c>stage1_plain</c>, pipeline.py
+/// не относится — там ИИ реально зовётся). kind/kw результата правил наружу НЕ отдаются (в ответе только
-/// L94–124) по настройкам тенанта; ответ — <c>{stage1:{pass,reason}, stage2:{pass,reason,skipped}, passed}</c>.
+/// pass/reason — как в прототипе); они нужны мониторингу отсева этапа 4.
-/// ИИ-фильтр этапа 2 на этапе 2 ВСЕГДА skipped (Ruling 4/8, план Task 10 L377–380): если этап-1 не прошёл —
+/// Эндпоинт требует сессию: 401 {detail} (Ruling 10). IncomingRules резолвится из RequestServices ПОСЛЕ
-/// <c>stage2={pass:false,reason:null,skipped:true}, passed:false</c>; иначе — <c>stage2={pass:true,reason:null,
+/// проверки сессии (scoped на TenantDbContext — паттерн SettingsEndpoints/MlEndpoints).
-/// skipped:true}, passed:true</c> (реальный ИИ-фильтр — этап 6, ветка ошибки ИИ прототипа L281 к skipped
+/// </remarks>
-/// не относится — там ИИ реально зовётся). kind/kw результата правил наружу НЕ отдаются (в ответе только
+public static class FilterTesterEndpoints
-/// pass/reason — как в прототипе); они нужны мониторингу отсева этапа 4.
+{
-/// Эндпоинт требует сессию: 401 {detail} (Ruling 10). IncomingRules резолвится из RequestServices ПОСЛЕ
+    // Префикс группы API (общий для эндпоинтов этапа, Ruling 8).
-/// проверки сессии (scoped на TenantDbContext — паттерн SettingsEndpoints/MlEndpoints).
+    private const string ApiGroupPrefix = "/api";
-/// </remarks>
+
-public static class FilterTesterEndpoints
+    // Путь тестера фильтра входящих (dashboard_routes.py L267).
-{
+    private const string CheckMessagePath = "/admin/check-message";
-    // Префикс группы API (общий для эндпоинтов этапа, Ruling 8).
+
-    private const string ApiGroupPrefix = "/api";
+    // OpenAPI-тег группы (эндпоинт Settings-экрана, Ruling 8).
-
+    private const string OpenApiTag = "settings";
-    // Путь тестера фильтра входящих (dashboard_routes.py L267).
+
-    private const string CheckMessagePath = "/admin/check-message";
+    /// <summary>
-
+    /// Регистрирует POST /api/admin/check-message.
-    // OpenAPI-тег группы (эндпоинт Settings-экрана, Ruling 8).
+    /// </summary>
-    private const string OpenApiTag = "settings";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <summary>
+    public static IEndpointRouteBuilder MapFilterTesterEndpoints(this IEndpointRouteBuilder app)
-    /// Регистрирует POST /api/admin/check-message.
+    {
-    /// </summary>
+        var group = app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        group.MapPost(CheckMessagePath, CheckAsync);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        return app;
-    public static IEndpointRouteBuilder MapFilterTesterEndpoints(this IEndpointRouteBuilder app)
+    }
-    {
+
-        var group = app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag);
+    // POST /api/admin/check-message: этап-1 правила + этап-2 (skipped) для тестера (dashboard_routes.py L267–284).
-        group.MapPost(CheckMessagePath, CheckAsync);
+    private static async Task<IResult> CheckAsync(
-        return app;
+        CheckMessageRequest body,
-    }
+        HttpContext context,
-
+        CancellationToken ct)
-    // POST /api/admin/check-message: этап-1 правила + этап-2 (skipped) для тестера (dashboard_routes.py L267–284).
+    {
-    private static async Task<IResult> CheckAsync(
+        if (!context.HasUser())
-        CheckMessageRequest body,
+        {
-        HttpContext context,
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        if (!context.HasUser())
+        // Резолв после 401-гейта: IncomingRules — scoped на TenantDbContext (tenant-контекст запроса).
-        {
+        IncomingRules incomingRules = context.RequestServices.GetRequiredService<IncomingRules>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        IncomingRulesResult stage1 = await incomingRules.CheckAsync(body.Text, ct);
-        }
+
-
+        // Ответ 1:1 с прототипом: stage2 на этапе 2 всегда skipped (Ruling 4/8, план L377–380).
-        // Резолв после 401-гейта: IncomingRules — scoped на TenantDbContext (tenant-контекст запроса).
+        if (!stage1.Pass)
-        IncomingRules incomingRules = context.RequestServices.GetRequiredService<IncomingRules>();
+        {
-        IncomingRulesResult stage1 = await incomingRules.CheckAsync(body.Text, ct);
+            return Results.Ok(new
-
+            {
-        // Ответ 1:1 с прототипом: stage2 на этапе 2 всегда skipped (Ruling 4/8, план L377–380).
+                stage1 = new { pass = stage1.Pass, reason = stage1.Reason },
-        if (!stage1.Pass)
+                stage2 = new { pass = false, reason = (string?)null, skipped = true },
-        {
+                passed = false,
-            return Results.Ok(new
+            });
-            {
+        }
-                stage1 = new { pass = stage1.Pass, reason = stage1.Reason },
+
-                stage2 = new { pass = false, reason = (string?)null, skipped = true },
+        return Results.Ok(new
-                passed = false,
+        {
-            });
+            stage1 = new { pass = stage1.Pass, reason = stage1.Reason },
-        }
+            stage2 = new { pass = true, reason = (string?)null, skipped = true },
-
+            passed = true,
-        return Results.Ok(new
+        });
-        {
+    }
-            stage1 = new { pass = stage1.Pass, reason = stage1.Reason },
+}
-            stage2 = new { pass = true, reason = (string?)null, skipped = true },
-            passed = true,
-        });
-    }
-}

src/core/Deal.Api/Endpoints/JoinEndpoint.cs

@@ -1,118 +1,112 @@
-using Deal.Api.Extensions;
+using Deal.Api.Services;
-using Deal.Api.Models;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Api.Services;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Abstractions;
+
-using Deal.Modules.Tenants.Application.Extensions;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Tenants.Application.Models;
+
-using Deal.Modules.Tenants.Application.Registrars;
+/// <summary>
-using Deal.Modules.Tenants.Application.Services;
+/// Публичный эндпоинт активации инвайта: POST /api/join (Ruling 2/11 этапа 7).
-using Deal.Api.Dtos;
+/// </summary>
-
+/// <remarks>
-namespace Deal.Api.Endpoints;
+/// Ручка не требует сессии (публичная; фронт её не вызывает — API-only, curl/будущий UI). Тело
-
+/// {code, email, name?, password} → JoinService: валидация кода/email/пароля, CAS-резервирование инвайта,
-/// <summary>
+/// создание тенанта (при пустом TenantId — с провижинингом схемы) и пользователя. Кука НЕ ставится: после
-/// Публичный эндпоинт активации инвайта: POST /api/join (Ruling 2/11 этапа 7).
+/// активации клиент входит обычным /api/auth/login (план Task 6). Успех — {ok:true, login}; ошибки — 400
-/// </summary>
+/// {detail} с фиксированным текстом причины (все отказы активации — 400, включая истёкший инвайт: слой
-/// <remarks>
+/// эндпоинта, см. Task 6; Ruling 2 называет это «410-семантикой» — ресурс больше недоступен). Результат
-/// Ручка не требует сессии (публичная; фронт её не вызывает — API-only, curl/будущий UI). Тело
+/// пишется в аудит — invite_joined (актор — новый пользователь тенанта, детали email+codeHash).
-/// {code, email, name?, password} → JoinService: валидация кода/email/пароля, CAS-резервирование инвайта,
+/// </remarks>
-/// создание тенанта (при пустом TenantId — с провижинингом схемы) и пользователя. Кука НЕ ставится: после
+public static class JoinEndpoint
-/// активации клиент входит обычным /api/auth/login (план Task 6). Успех — {ok:true, login}; ошибки — 400
+{
-/// {detail} с фиксированным текстом причины (все отказы активации — 400, включая истёкший инвайт: слой
+    // Путь ручки (вне группы /api/operator — публичная).
-/// эндпоинта, см. Task 6; Ruling 2 называет это «410-семантикой» — ресурс больше недоступен). Результат
+    private const string JoinPath = "/api/join";
-/// пишется в аудит — invite_joined (актор — новый пользователь тенанта, детали email+codeHash).
+
-/// </remarks>
+    // OpenAPI-тег.
-public static class JoinEndpoint
+    private const string JoinOpenApiTag = "join";
-{
+
-    // Путь ручки (вне группы /api/operator — публичная).
+    // Текст 400: приглашение с таким кодом не найдено.
-    private const string JoinPath = "/api/join";
+    private const string InviteNotFoundDetail = "Приглашение не найдено";
-
+
-    // OpenAPI-тег.
+    // Текст 400: срок действия приглашения истёк (план Task 6, Ruling 2).
-    private const string JoinOpenApiTag = "join";
+    private const string InviteExpiredDetail = "Срок действия приглашения истёк";
-
+
-    // Текст 400: приглашение с таким кодом не найдено.
+    // Текст 400: приглашение уже активировано (повторная активация тем же кодом).
-    private const string InviteNotFoundDetail = "Приглашение не найдено";
+    private const string InviteUsedDetail = "Приглашение уже использовано";
-
+
-    // Текст 400: срок действия приглашения истёк (план Task 6, Ruling 2).
+    // Текст 400: приглашение отозвано оператором.
-    private const string InviteExpiredDetail = "Срок действия приглашения истёк";
+    private const string InviteRevokedDetail = "Приглашение отозвано";
-
+
-    // Текст 400: приглашение уже активировано (повторная активация тем же кодом).
+    // Текст 400: email запроса не совпадает с email приглашения (Ruling 2).
-    private const string InviteUsedDetail = "Приглашение уже использовано";
+    private const string EmailMismatchDetail = "Email не совпадает с приглашением";
-
+
-    // Текст 400: приглашение отозвано оператором.
+    // Текст 400: пользователь с таким email уже зарегистрирован (users.login unique, Ruling 2).
-    private const string InviteRevokedDetail = "Приглашение отозвано";
+    private const string EmailTakenDetail = "Этот email уже зарегистрирован";
-
+
-    // Текст 400: email запроса не совпадает с email приглашения (Ruling 2).
+    // Текст 400: пароль короче минимума (текст как в AuthEndpoints, план Task 6).
-    private const string EmailMismatchDetail = "Email не совпадает с приглашением";
+    private const string PasswordTooShortDetail = "Пароль слишком короткий (минимум 8 символов)";
-
+
-    // Текст 400: пользователь с таким email уже зарегистрирован (users.login unique, Ruling 2).
+    // Текст 400: целевой тенант инвайта не существует (Security review).
-    private const string EmailTakenDetail = "Этот email уже зарегистрирован";
+    private const string TenantNotFoundDetail = "Тенант приглашения не найден";
-
+
-    // Текст 400: пароль короче минимума (текст как в AuthEndpoints, план Task 6).
+    // Текст 400: целевой тенант инвайта приостановлен (Security review).
-    private const string PasswordTooShortDetail = "Пароль слишком короткий (минимум 8 символов)";
+    private const string TenantSuspendedDetail = "Тенант приглашения приостановлен";
-
+
-    // Текст 400: целевой тенант инвайта не существует (Security review).
+    /// <summary>
-    private const string TenantNotFoundDetail = "Тенант приглашения не найден";
+    /// Регистрирует POST /api/join.
-
+    /// </summary>
-    // Текст 400: целевой тенант инвайта приостановлен (Security review).
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    private const string TenantSuspendedDetail = "Тенант приглашения приостановлен";
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-
+    public static IEndpointRouteBuilder MapJoinEndpoint(this IEndpointRouteBuilder app)
-    /// <summary>
+    {
-    /// Регистрирует POST /api/join.
+        app.MapPost(JoinPath, JoinAsync).WithTags(JoinOpenApiTag);
-    /// </summary>
+        return app;
-    /// <param name="app">Построитель маршрутов приложения.</param>
+    }
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+
-    public static IEndpointRouteBuilder MapJoinEndpoint(this IEndpointRouteBuilder app)
+    // POST /api/join: активация инвайта; успех пишется в аудит (invite_activated, Task 6/Ruling 4).
-    {
+    private static async Task<IResult> JoinAsync(
-        app.MapPost(JoinPath, JoinAsync).WithTags(JoinOpenApiTag);
+        JoinRequest body,
-        return app;
+        JoinService joinService,
-    }
+        AuditService auditService,
-
+        HttpContext context,
-    // POST /api/join: активация инвайта; успех пишется в аудит (invite_activated, Task 6/Ruling 4).
+        CancellationToken ct)
-    private static async Task<IResult> JoinAsync(
+    {
-        JoinRequest body,
+        var result = await joinService.ActivateAsync(body.Code, body.Email, body.Name, body.Password, ct);
-        JoinService joinService,
+        if (!result.Ok || result.Login is null || result.UserId is null || result.TenantId is null)
-        AuditService auditService,
+        {
-        HttpContext context,
+            return EndpointResults.BadRequest(DetailFor(result.Error));
-        CancellationToken ct)
+        }
-    {
+
-        var result = await joinService.ActivateAsync(body.Code, body.Email, body.Name, body.Password, ct);
+        await auditService.AppendAsync(new AuditRecordDto(
-        if (!result.Ok || result.Login is null || result.UserId is null || result.TenantId is null)
+            AuditEvents.InviteJoined,
-        {
+            AuditActorTypes.Tenant,
-            return EndpointResults.BadRequest(DetailFor(result.Error));
+            ActorId: result.UserId,
-        }
+            TenantId: result.TenantId,
-
+            Ip: ClientIp(context),
-        await auditService.AppendAsync(new AuditRecordDto(
+            // Код инвайта — capability-токен: в аудит пишется только SHA-256-хэш (Security review).
-            AuditEvents.InviteJoined,
+            DetailJson: AuditService.ToDetailJson(new { email = result.Login, codeHash = SessionTokens.HashToken(body.Code?.Trim() ?? string.Empty) })), ct);
-            AuditActorTypes.Tenant,
+
-            ActorId: result.UserId,
+        return Results.Ok(new { ok = true, login = result.Login });
-            TenantId: result.TenantId,
+    }
-            Ip: ClientIp(context),
+
-            // Код инвайта — capability-токен: в аудит пишется только SHA-256-хэш (Security review).
+    // Фиксированный текст 400 по коду ошибки JoinService (все отказы активации — 400).
-            DetailJson: AuditService.ToDetailJson(new { email = result.Login, codeHash = SessionTokens.HashToken(body.Code?.Trim() ?? string.Empty) })), ct);
+    // error: Код ошибки JoinResultDto.
-
+    // Возвращает: Текст детали ошибки.
-        return Results.Ok(new { ok = true, login = result.Login });
+    private static string DetailFor(string? error) =>
-    }
+        error switch
-
+        {
-    // Фиксированный текст 400 по коду ошибки JoinService (все отказы активации — 400).
+            JoinResultDto.ErrorExpired => InviteExpiredDetail,
-    // error: Код ошибки JoinResultDto.
+            JoinResultDto.ErrorUsed => InviteUsedDetail,
-    // Возвращает: Текст детали ошибки.
+            JoinResultDto.ErrorRevoked => InviteRevokedDetail,
-    private static string DetailFor(string? error) =>
+            JoinResultDto.ErrorEmailMismatch => EmailMismatchDetail,
-        error switch
+            JoinResultDto.ErrorEmailTaken => EmailTakenDetail,
-        {
+            JoinResultDto.ErrorPasswordTooShort => PasswordTooShortDetail,
-            JoinResultDto.ErrorExpired => InviteExpiredDetail,
+            JoinResultDto.ErrorTenantNotFound => TenantNotFoundDetail,
-            JoinResultDto.ErrorUsed => InviteUsedDetail,
+            JoinResultDto.ErrorTenantSuspended => TenantSuspendedDetail,
-            JoinResultDto.ErrorRevoked => InviteRevokedDetail,
+            _ => InviteNotFoundDetail,
-            JoinResultDto.ErrorEmailMismatch => EmailMismatchDetail,
+        };
-            JoinResultDto.ErrorEmailTaken => EmailTakenDetail,
+
-            JoinResultDto.ErrorPasswordTooShort => PasswordTooShortDetail,
+    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-            JoinResultDto.ErrorTenantNotFound => TenantNotFoundDetail,
+    // context: Контекст запроса.
-            JoinResultDto.ErrorTenantSuspended => TenantSuspendedDetail,
+    // Возвращает: Строковое представление IP или null.
-            _ => InviteNotFoundDetail,
+    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-        };
+}
-
-    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-    // context: Контекст запроса.
-    // Возвращает: Строковое представление IP или null.
-    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-}

src/core/Deal.Api/Endpoints/JoinRequest.cs

@@ -1,13 +1,10 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/join — активация инвайта (Ruling 2, Task 6 этапа 7). Входящий JSON — camelCase (code, email, name?, password).
-
+/// </summary>
-/// <summary>
+/// <param name="Code">Код приглашения (16 url-safe символов).</param>
-/// Тело POST /api/join — активация инвайта (Ruling 2, Task 6 этапа 7). Входящий JSON — camelCase (code, email, name?, password).
+/// <param name="Email">Email активирующего; обязан совпасть с email приглашения (нормализует JoinService).</param>
-/// </summary>
+/// <param name="Name">Имя нового тенанта (только когда у инвайта нет целевого тенанта); null — имя = email.</param>
-/// <param name="Code">Код приглашения (16 url-safe символов).</param>
+/// <param name="Password">Пароль пользователя (минимум 8 символов).</param>
-/// <param name="Email">Email активирующего; обязан совпасть с email приглашения (нормализует JoinService).</param>
+public sealed record JoinRequest(string? Code, string? Email, string? Name, string? Password);
-/// <param name="Name">Имя нового тенанта (только когда у инвайта нет целевого тенанта); null — имя = email.</param>
-/// <param name="Password">Пароль пользователя (минимум 8 символов).</param>
-public sealed record JoinRequest(string? Code, string? Email, string? Name, string? Password);

src/core/Deal.Api/Endpoints/LoginRequest.cs

@@ -1,11 +1,8 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/auth/login. Входящий JSON — camelCase (login, password).
-
+/// </summary>
-/// <summary>
+/// <param name="Login">Логин пользователя.</param>
-/// Тело POST /api/auth/login. Входящий JSON — camelCase (login, password).
+/// <param name="Password">Пароль в открытом виде.</param>
-/// </summary>
+public sealed record LoginRequest(string Login, string Password);
-/// <param name="Login">Логин пользователя.</param>
-/// <param name="Password">Пароль в открытом виде.</param>
-public sealed record LoginRequest(string Login, string Password);

src/core/Deal.Api/Endpoints/MlApplyRequest.cs

@@ -1,12 +1,9 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/ml/apply. Входящий JSON — camelCase (dialogId, msgId, action).
-
+/// </summary>
-/// <summary>
+/// <param name="DialogId">Id диалога/канала Telegram, где лежит исходное сообщение.</param>
-/// Тело POST /api/ml/apply. Входящий JSON — camelCase (dialogId, msgId, action).
+/// <param name="MsgId">Id сообщения внутри диалога.</param>
-/// </summary>
+/// <param name="Action">Ручное решение: spam | board:&lt;id&gt; | skip (api-map §3.7 L197).</param>
-/// <param name="DialogId">Id диалога/канала Telegram, где лежит исходное сообщение.</param>
+public sealed record MlApplyRequest(string DialogId, int MsgId, string Action);
-/// <param name="MsgId">Id сообщения внутри диалога.</param>
-/// <param name="Action">Ручное решение: spam | board:&lt;id&gt; | skip (api-map §3.7 L197).</param>
-public sealed record MlApplyRequest(string DialogId, int MsgId, string Action);

src/core/Deal.Api/Endpoints/MlCandidatesRequest.cs

@@ -1,11 +1,8 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/ml/candidates. Входящий JSON — camelCase (dialogId, limit).
-
+/// </summary>
-/// <summary>
+/// <param name="DialogId">Id диалога/канала Telegram; пусто — выборка по всем источникам тенанта (§8).</param>
-/// Тело POST /api/ml/candidates. Входящий JSON — camelCase (dialogId, limit).
+/// <param name="Limit">Сколько последних сообщений вернуть (кламп 1..60, дефолт 10).</param>
-/// </summary>
+public sealed record MlCandidatesRequest(string DialogId, int Limit);
-/// <param name="DialogId">Id диалога/канала Telegram; пусто — выборка по всем источникам тенанта (§8).</param>
-/// <param name="Limit">Сколько последних сообщений вернуть (кламп 1..60, дефолт 10).</param>
-public sealed record MlCandidatesRequest(string DialogId, int Limit);

src/core/Deal.Api/Endpoints/MlEndpoints.cs

@@ -1,192 +1,188 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Contracts.Integrations.Abstractions;
-using Deal.Contracts.Integrations.Abstractions;
+using Deal.Contracts.Integrations.Models;
-using Deal.Contracts.Integrations.Models;
+using Deal.Modules.Pipeline.Application.Models;
-using Deal.Modules.Pipeline.Application.Abstractions;
+using Deal.Modules.Pipeline.Application.Services;
-using Deal.Modules.Pipeline.Application.Models;
+
-using Deal.Modules.Pipeline.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Pipeline.Application.Services;
+
-using Deal.Api.Dtos;
+/// <summary>
-
+/// Эндпоинты ML-панели: GET /api/ml/status, POST /api/ml/reset, /predict, /candidates, /apply (Ruling 8, api-map §3.7).
-namespace Deal.Api.Endpoints;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// Тела ответов 1:1 с прототипом <c>backend/app/routers/ml_routes.py</c> (L66–91, L112–171):
-/// Эндпоинты ML-панели: GET /api/ml/status, POST /api/ml/reset, /predict, /candidates, /apply (Ruling 8, api-map §3.7).
+/// <c>status</c> — MlStatusResponseDto (enabled/service/reachable/stats, §4.10 L363); <c>reset</c> —
-/// </summary>
+/// <c>{ok:true}</c> (мягкая ошибка {ok:false,error} зарезервирована — заглушка всегда успешна);
-/// <remarks>
+/// <c>predict</c> — <c>{text: первые 200, take, label, scores, hits, ready, margin, terms, type}</c>
-/// Тела ответов 1:1 с прототипом <c>backend/app/routers/ml_routes.py</c> (L66–91, L112–171):
+/// (текст короче 2 символов после trim → 400 «Введите текст»); <c>candidates</c> — <c>{items}</c> реальных
-/// <c>status</c> — MlStatusResponseDto (enabled/service/reachable/stats, §4.10 L363); <c>reset</c> —
+/// сообщений-кандидатов канала/выборки (очередь/отсев/карточки + мнение ML, §8; MlReviewService);
-/// <c>{ok:true}</c> (мягкая ошибка {ok:false,error} зарезервирована — заглушка всегда успешна);
+/// <c>apply</c> — 404 «Исходное сообщение не найдено» либо результат ручной разметки
-/// <c>predict</c> — <c>{text: первые 200, take, label, scores, hits, ready, margin, terms, type}</c>
+/// <c>{ok, learned, moved, leadId}</c> (обучение ML + перенос/корзина/отсев). ml/learn и ml/flush
-/// (текст короче 2 символов после trim → 400 «Введите текст»); <c>candidates</c> — <c>{items}</c> реальных
+/// НЕ реализуются (фронт не вызывает, api-map п.9 L399). Все эндпоинты требуют сессию: 401 {detail}
-/// сообщений-кандидатов канала/выборки (очередь/отсев/карточки + мнение ML, §8; MlReviewService);
+/// (Ruling 10). IMlClient/MlReviewService резолвятся из RequestServices ПОСЛЕ проверки сессии (scoped
-/// <c>apply</c> — 404 «Исходное сообщение не найдено» либо результат ручной разметки
+/// на tenant-запрос — вне него не разрешимы, паттерн SettingsEndpoints/AiCheckEndpoint).
-/// <c>{ok, learned, moved, leadId}</c> (обучение ML + перенос/корзина/отсев). ml/learn и ml/flush
+/// </remarks>
-/// НЕ реализуются (фронт не вызывает, api-map п.9 L399). Все эндпоинты требуют сессию: 401 {detail}
+public static class MlEndpoints
-/// (Ruling 10). IMlClient/MlReviewService резолвятся из RequestServices ПОСЛЕ проверки сессии (scoped
+{
-/// на tenant-запрос — вне него не разрешимы, паттерн SettingsEndpoints/AiCheckEndpoint).
+    // Префикс группы /api/ml (Ruling 8: MapMlEndpoints).
-/// </remarks>
+    private const string MlGroupPrefix = "/api/ml";
-public static class MlEndpoints
+
-{
+    // OpenAPI-тег группы (в прототипе роутер ml — ml_routes.py).
-    // Префикс группы /api/ml (Ruling 8: MapMlEndpoints).
+    private const string MlOpenApiTag = "ml";
-    private const string MlGroupPrefix = "/api/ml";
+
-
+    // Путь статуса ML (GET).
-    // OpenAPI-тег группы (в прототипе роутер ml — ml_routes.py).
+    private const string StatusPath = "/status";
-    private const string MlOpenApiTag = "ml";
+
-
+    // Путь сброса модели (POST).
-    // Путь статуса ML (GET).
+    private const string ResetPath = "/reset";
-    private const string StatusPath = "/status";
+
-
+    // Путь проверки ML на тексте (POST).
-    // Путь сброса модели (POST).
+    private const string PredictPath = "/predict";
-    private const string ResetPath = "/reset";
+
-
+    // Путь разбора сообщений канала (POST).
-    // Путь проверки ML на тексте (POST).
+    private const string CandidatesPath = "/candidates";
-    private const string PredictPath = "/predict";
+
-
+    // Путь ручного решения по сообщению (POST).
-    // Путь разбора сообщений канала (POST).
+    private const string ApplyPath = "/apply";
-    private const string CandidatesPath = "/candidates";
+
-
+    // Минимальная длина текста для проверки (ml_routes.py L87: len(text) &lt; 2 → 400).
-    // Путь ручного решения по сообщению (POST).
+    private const int MinPredictTextLength = 2;
-    private const string ApplyPath = "/apply";
+
-
+    // Длина текста в ответе predict: первые 200 символов (ml_routes.py L90 text[:200]).
-    // Минимальная длина текста для проверки (ml_routes.py L87: len(text) &lt; 2 → 400).
+    private const int PredictTextPreviewLength = 200;
-    private const int MinPredictTextLength = 2;
+
-
+    // Сообщение 400 для слишком короткого текста (ml_routes.py L88, план Task 9 L348).
-    // Длина текста в ответе predict: первые 200 символов (ml_routes.py L90 text[:200]).
+    private const string EnterTextDetail = "Введите текст";
-    private const int PredictTextPreviewLength = 200;
+
-
+    // Сообщение 404 apply: исходное сообщение не найдено (ml_routes.py L142, план Task 9 L352).
-    // Сообщение 400 для слишком короткого текста (ml_routes.py L88, план Task 9 L348).
+    private const string MessageNotFoundDetail = "Исходное сообщение не найдено";
-    private const string EnterTextDetail = "Введите текст";
+
-
+    /// <summary>
-    // Сообщение 404 apply: исходное сообщение не найдено (ml_routes.py L142, план Task 9 L352).
+    /// Регистрирует группу /api/ml: status/reset/predict/candidates/apply.
-    private const string MessageNotFoundDetail = "Исходное сообщение не найдено";
+    /// </summary>
-
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// <summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// Регистрирует группу /api/ml: status/reset/predict/candidates/apply.
+    public static IEndpointRouteBuilder MapMlEndpoints(this IEndpointRouteBuilder app)
-    /// </summary>
+    {
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        var group = app.MapGroup(MlGroupPrefix).WithTags(MlOpenApiTag);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+
-    public static IEndpointRouteBuilder MapMlEndpoints(this IEndpointRouteBuilder app)
+        group.MapGet(StatusPath, StatusAsync);
-    {
+        group.MapPost(ResetPath, ResetAsync);
-        var group = app.MapGroup(MlGroupPrefix).WithTags(MlOpenApiTag);
+        group.MapPost(PredictPath, PredictAsync);
-
+        group.MapPost(CandidatesPath, CandidatesAsync);
-        group.MapGet(StatusPath, StatusAsync);
+        group.MapPost(ApplyPath, ApplyAsync);
-        group.MapPost(ResetPath, ResetAsync);
+
-        group.MapPost(PredictPath, PredictAsync);
+        return app;
-        group.MapPost(CandidatesPath, CandidatesAsync);
+    }
-        group.MapPost(ApplyPath, ApplyAsync);
+
-
+    // GET /api/ml/status: статус ML-сервиса + локальная статистика (ml_routes.py L66–75).
-        return app;
+    private static async Task<IResult> StatusAsync(HttpContext context, CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // GET /api/ml/status: статус ML-сервиса + локальная статистика (ml_routes.py L66–75).
+        {
-    private static async Task<IResult> StatusAsync(HttpContext context, CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        IMlClient mlClient = context.RequestServices.GetRequiredService<IMlClient>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        return Results.Ok(await mlClient.StatusAsync(ct));
-        }
+    }
-
+
-        IMlClient mlClient = context.RequestServices.GetRequiredService<IMlClient>();
+    // POST /api/ml/reset: полный сброс модели + очистка очереди обучения (ml_routes.py L78–81).
-        return Results.Ok(await mlClient.StatusAsync(ct));
+    private static async Task<IResult> ResetAsync(HttpContext context, CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // POST /api/ml/reset: полный сброс модели + очистка очереди обучения (ml_routes.py L78–81).
+        {
-    private static async Task<IResult> ResetAsync(HttpContext context, CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        IMlClient mlClient = context.RequestServices.GetRequiredService<IMlClient>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        return Results.Ok(await mlClient.ResetAsync(ct));
-        }
+    }
-
+
-        IMlClient mlClient = context.RequestServices.GetRequiredService<IMlClient>();
+    // POST /api/ml/predict: проверка ML на тексте (ml_routes.py L84–90).
-        return Results.Ok(await mlClient.ResetAsync(ct));
+    private static async Task<IResult> PredictAsync(
-    }
+        MlPredictRequest body,
-
+        HttpContext context,
-    // POST /api/ml/predict: проверка ML на тексте (ml_routes.py L84–90).
+        CancellationToken ct)
-    private static async Task<IResult> PredictAsync(
+    {
-        MlPredictRequest body,
+        if (!context.HasUser())
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        string text = (body.Text ?? string.Empty).Trim();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        if (text.Length < MinPredictTextLength)
-        }
+        {
-
+            return EndpointResults.BadRequest(EnterTextDetail);
-        string text = (body.Text ?? string.Empty).Trim();
+        }
-        if (text.Length < MinPredictTextLength)
+
-        {
+        IMlClient mlClient = context.RequestServices.GetRequiredService<IMlClient>();
-            return EndpointResults.BadRequest(EnterTextDetail);
+        MlPredictResultDto result = await mlClient.PredictAsync(text, ct);
-        }
+
-
+        // Ответ 1:1 с ml_routes.py L90: {"text": <первые 200>, **результат предсказания}.
-        IMlClient mlClient = context.RequestServices.GetRequiredService<IMlClient>();
+        string preview = text.Length <= PredictTextPreviewLength
-        MlPredictResultDto result = await mlClient.PredictAsync(text, ct);
+            ? text
-
+            : text[..PredictTextPreviewLength];
-        // Ответ 1:1 с ml_routes.py L90: {"text": <первые 200>, **результат предсказания}.
+        return Results.Ok(new
-        string preview = text.Length <= PredictTextPreviewLength
+        {
-            ? text
+            text = preview,
-            : text[..PredictTextPreviewLength];
+            take = result.Take,
-        return Results.Ok(new
+            label = result.Label,
-        {
+            scores = result.Scores,
-            text = preview,
+            hits = result.Hits,
-            take = result.Take,
+            ready = result.Ready,
-            label = result.Label,
+            margin = result.Margin,
-            scores = result.Scores,
+            terms = result.Terms,
-            hits = result.Hits,
+            type = result.Type,
-            ready = result.Ready,
+        });
-            margin = result.Margin,
+    }
-            terms = result.Terms,
+
-            type = result.Type,
+    // POST /api/ml/candidates: последние сообщения канала + мнение ML (ml_routes.py L112–134).
-        });
+    private static async Task<IResult> CandidatesAsync(
-    }
+        MlCandidatesRequest body,
-
+        HttpContext context,
-    // POST /api/ml/candidates: последние сообщения канала + мнение ML (ml_routes.py L112–134).
+        CancellationToken ct)
-    private static async Task<IResult> CandidatesAsync(
+    {
-        MlCandidatesRequest body,
+        if (!context.HasUser())
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        MlReviewService review = context.RequestServices.GetRequiredService<MlReviewService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        IReadOnlyList<MlCandidateDto> items = await review.CandidatesAsync(body.DialogId, body.Limit, ct);
-        }
+        return Results.Ok(new { items });
-
+    }
-        MlReviewService review = context.RequestServices.GetRequiredService<MlReviewService>();
+
-        IReadOnlyList<MlCandidateDto> items = await review.CandidatesAsync(body.DialogId, body.Limit, ct);
+    // POST /api/ml/apply: ручное решение по сообщению (ml_routes.py L137–171).
-        return Results.Ok(new { items });
+    private static async Task<IResult> ApplyAsync(
-    }
+        MlApplyRequest body,
-
+        HttpContext context,
-    // POST /api/ml/apply: ручное решение по сообщению (ml_routes.py L137–171).
+        CancellationToken ct)
-    private static async Task<IResult> ApplyAsync(
+    {
-        MlApplyRequest body,
+        if (!context.HasUser())
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        MlReviewService review = context.RequestServices.GetRequiredService<MlReviewService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        MlApplyResult? result = await review.ApplyAsync(body.DialogId, body.MsgId, body.Action, ct);
-        }
+        if (result is null)
-
+        {
-        MlReviewService review = context.RequestServices.GetRequiredService<MlReviewService>();
+            return EndpointResults.NotFound(MessageNotFoundDetail);
-        MlApplyResult? result = await review.ApplyAsync(body.DialogId, body.MsgId, body.Action, ct);
+        }
-        if (result is null)
+
-        {
+        if (result.Error is not null)
-            return EndpointResults.NotFound(MessageNotFoundDetail);
+        {
-        }
+            return EndpointResults.BadRequest(result.Error);
-
+        }
-        if (result.Error is not null)
+
-        {
+        return Results.Ok(new
-            return EndpointResults.BadRequest(result.Error);
+        {
-        }
+            ok = result.Ok,
-
+            learned = result.Learned,
-        return Results.Ok(new
+            moved = result.Moved,
-        {
+            leadId = result.LeadId,
-            ok = result.Ok,
+        });
-            learned = result.Learned,
+    }
-            moved = result.Moved,
+}
-            leadId = result.LeadId,
-        });
-    }
-}

src/core/Deal.Api/Endpoints/MlPredictRequest.cs

@@ -1,10 +1,7 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/ml/predict. Входящий JSON — camelCase (text).
-
+/// </summary>
-/// <summary>
+/// <param name="Text">Текст сообщения для проверки ML (обрезается/тримится обработчиком, как ml_routes.py L86).</param>
-/// Тело POST /api/ml/predict. Входящий JSON — camelCase (text).
+public sealed record MlPredictRequest(string Text);
-/// </summary>
-/// <param name="Text">Текст сообщения для проверки ML (обрезается/тримится обработчиком, как ml_routes.py L86).</param>
-public sealed record MlPredictRequest(string Text);

src/core/Deal.Api/Endpoints/OperatorAnalyticsEndpoints.cs

@@ -1,174 +1,169 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+
-using Deal.Modules.Tenants.Application.Models;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+/// <summary>
-using Deal.Api.Dtos;
+/// Операторские read-only эндпоинты аналитики: /api/operator/analytics/{overview,tokens,activity} (этап 10, T3).
-
+/// </summary>
-namespace Deal.Api.Endpoints;
+/// <remarks>
-
+/// Только под операторской сессией: без неё 401 «Требуется вход оператора» (как прочие /api/operator/*).
-/// <summary>
+/// Ничего не меняет (read-only). groupBy — day|tenant|provider|model (неизвестное — 400 {detail}); from/to —
-/// Операторские read-only эндпоинты аналитики: /api/operator/analytics/{overview,tokens,activity} (этап 10, T3).
+/// ISO-8601 (включительно), как у аудита; activity поддерживает фильтры eventType/actorType/actorId/tenantId,
-/// </summary>
+/// limit (1..500) и offset. Все ответы — camelCase (контракт: docs/architecture/2026-09-10-operator-analytics-contract.md).
-/// <remarks>
+/// </remarks>
-/// Только под операторской сессией: без неё 401 «Требуется вход оператора» (как прочие /api/operator/*).
+public static class OperatorAnalyticsEndpoints
-/// Ничего не меняет (read-only). groupBy — day|tenant|provider|model (неизвестное — 400 {detail}); from/to —
+{
-/// ISO-8601 (включительно), как у аудита; activity поддерживает фильтры eventType/actorType/actorId/tenantId,
+    // Префикс группы аналитики (Ruling 4 этапа 10).
-/// limit (1..500) и offset. Все ответы — camelCase (контракт: docs/architecture/2026-09-10-operator-analytics-contract.md).
+    private const string AnalyticsGroupPrefix = "/api/operator/analytics";
-/// </remarks>
+
-public static class OperatorAnalyticsEndpoints
+    // OpenAPI-тег группы.
-{
+    private const string OperatorOpenApiTag = "operator";
-    // Префикс группы аналитики (Ruling 4 этапа 10).
+
-    private const string AnalyticsGroupPrefix = "/api/operator/analytics";
+    // Группировка расхода токенов по умолчанию (сутки).
-
+    private const string DefaultGroupBy = TokenUsageGroupBys.Day;
-    // OpenAPI-тег группы.
+
-    private const string OperatorOpenApiTag = "operator";
+    // 400 tokens: неизвестная группировка.
-
+    private const string InvalidGroupByDetail = "Неизвестная группировка (day|tenant|provider|model)";
-    // Группировка расхода токенов по умолчанию (сутки).
+
-    private const string DefaultGroupBy = TokenUsageGroupBys.Day;
+    /// <summary>
-
+    /// Регистрирует группу /api/operator/analytics: overview/tokens/activity.
-    // 400 tokens: неизвестная группировка.
+    /// </summary>
-    private const string InvalidGroupByDetail = "Неизвестная группировка (day|tenant|provider|model)";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <summary>
+    public static IEndpointRouteBuilder MapOperatorAnalyticsEndpoints(this IEndpointRouteBuilder app)
-    /// Регистрирует группу /api/operator/analytics: overview/tokens/activity.
+    {
-    /// </summary>
+        var group = app.MapGroup(AnalyticsGroupPrefix).WithTags(OperatorOpenApiTag);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        group.MapGet("/overview", OverviewAsync);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        group.MapGet("/tokens", TokensAsync);
-    public static IEndpointRouteBuilder MapOperatorAnalyticsEndpoints(this IEndpointRouteBuilder app)
+        group.MapGet("/activity", ActivityAsync);
-    {
+        group.MapGet("/suspicious", SuspiciousAsync);
-        var group = app.MapGroup(AnalyticsGroupPrefix).WithTags(OperatorOpenApiTag);
+        return app;
-        group.MapGet("/overview", OverviewAsync);
+    }
-        group.MapGet("/tokens", TokensAsync);
+
-        group.MapGet("/activity", ActivityAsync);
+    // GET /api/operator/analytics/suspicious?from=&amp;to=: находки детектора подозрительной активности (§10.5).
-        group.MapGet("/suspicious", SuspiciousAsync);
+    // from: Начало окна анализа (включительно; ISO-8601); null — последние 24 часа.
-        return app;
+    // to: Конец окна анализа (включительно; ISO-8601); null — «сейчас».
-    }
+    // context: Контекст запроса.
-
+    // suspiciousService: Детектор подозрительной активности (scoped).
-    // GET /api/operator/analytics/suspicious?from=&amp;to=: находки детектора подозрительной активности (§10.5).
+    // ct: Токен отмены.
-    // from: Начало окна анализа (включительно; ISO-8601); null — последние 24 часа.
+    // Возвращает: 200 сводка находок или 401 без операторской сессии.
-    // to: Конец окна анализа (включительно; ISO-8601); null — «сейчас».
+    private static async Task<IResult> SuspiciousAsync(
-    // context: Контекст запроса.
+        DateTimeOffset? from,
-    // suspiciousService: Детектор подозрительной активности (scoped).
+        DateTimeOffset? to,
-    // ct: Токен отмены.
+        HttpContext context,
-    // Возвращает: 200 сводка находок или 401 без операторской сессии.
+        SuspiciousActivityService suspiciousService,
-    private static async Task<IResult> SuspiciousAsync(
+        CancellationToken ct)
-        DateTimeOffset? from,
+    {
-        DateTimeOffset? to,
+        if (context.GetCurrentOperator() is null)
-        HttpContext context,
+        {
-        SuspiciousActivityService suspiciousService,
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        if (context.GetCurrentOperator() is null)
+        SuspiciousActivityDto report = await suspiciousService.AnalyzeAsync(from, to, ct);
-        {
+        return Results.Ok(report);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+    }
-        }
+
-
+    // GET /api/operator/analytics/overview?from=&amp;to=: сводка (тенанты, токены, события, входы/выходы).
-        SuspiciousActivityDto report = await suspiciousService.AnalyzeAsync(from, to, ct);
+    // from: Начало периода (включительно; ISO-8601).
-        return Results.Ok(report);
+    // to: Конец периода (включительно; ISO-8601).
-    }
+    // context: Контекст запроса.
-
+    // analyticsService: Сервис аналитики (scoped).
-    // GET /api/operator/analytics/overview?from=&amp;to=: сводка (тенанты, токены, события, входы/выходы).
+    // ct: Токен отмены.
-    // from: Начало периода (включительно; ISO-8601).
+    // Возвращает: 200 сводка или 401 без операторской сессии.
-    // to: Конец периода (включительно; ISO-8601).
+    private static async Task<IResult> OverviewAsync(
-    // context: Контекст запроса.
+        DateTimeOffset? from,
-    // analyticsService: Сервис аналитики (scoped).
+        DateTimeOffset? to,
-    // ct: Токен отмены.
+        HttpContext context,
-    // Возвращает: 200 сводка или 401 без операторской сессии.
+        AnalyticsService analyticsService,
-    private static async Task<IResult> OverviewAsync(
+        CancellationToken ct)
-        DateTimeOffset? from,
+    {
-        DateTimeOffset? to,
+        if (context.GetCurrentOperator() is null)
-        HttpContext context,
+        {
-        AnalyticsService analyticsService,
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        if (context.GetCurrentOperator() is null)
+        AnalyticsOverviewDto overview = await analyticsService.OverviewAsync(from, to, ct);
-        {
+        return Results.Ok(overview);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+    }
-        }
+
-
+    // GET /api/operator/analytics/tokens?groupBy=&amp;tenantId=&amp;from=&amp;to=: агрегаты расхода токенов.
-        AnalyticsOverviewDto overview = await analyticsService.OverviewAsync(from, to, ct);
+    // groupBy: Группировка day|tenant|provider|model (дефолт day).
-        return Results.Ok(overview);
+    // tenantId: Тенант (равенство; пусто — все тенанты).
-    }
+    // from: Начало периода (включительно; ISO-8601).
-
+    // to: Конец периода (включительно; ISO-8601).
-    // GET /api/operator/analytics/tokens?groupBy=&amp;tenantId=&amp;from=&amp;to=: агрегаты расхода токенов.
+    // context: Контекст запроса.
-    // groupBy: Группировка day|tenant|provider|model (дефолт day).
+    // analyticsService: Сервис аналитики (scoped).
-    // tenantId: Тенант (равенство; пусто — все тенанты).
+    // ct: Токен отмены.
-    // from: Начало периода (включительно; ISO-8601).
+    // Возвращает: 200 агрегаты, 400 неизвестная группировка или 401 без операторской сессии.
-    // to: Конец периода (включительно; ISO-8601).
+    private static async Task<IResult> TokensAsync(
-    // context: Контекст запроса.
+        string? groupBy,
-    // analyticsService: Сервис аналитики (scoped).
+        Guid? tenantId,
-    // ct: Токен отмены.
+        DateTimeOffset? from,
-    // Возвращает: 200 агрегаты, 400 неизвестная группировка или 401 без операторской сессии.
+        DateTimeOffset? to,
-    private static async Task<IResult> TokensAsync(
+        HttpContext context,
-        string? groupBy,
+        AnalyticsService analyticsService,
-        Guid? tenantId,
+        CancellationToken ct)
-        DateTimeOffset? from,
+    {
-        DateTimeOffset? to,
+        if (context.GetCurrentOperator() is null)
-        HttpContext context,
+        {
-        AnalyticsService analyticsService,
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        if (context.GetCurrentOperator() is null)
+        string normalizedGroupBy = string.IsNullOrWhiteSpace(groupBy) ? DefaultGroupBy : groupBy;
-        {
+        if (!IsKnownGroupBy(normalizedGroupBy))
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        {
-        }
+            return EndpointResults.BadRequest(InvalidGroupByDetail);
-
+        }
-        string normalizedGroupBy = string.IsNullOrWhiteSpace(groupBy) ? DefaultGroupBy : groupBy;
+
-        if (!IsKnownGroupBy(normalizedGroupBy))
+        AnalyticsTokensDto tokens = await analyticsService.TokensAsync(normalizedGroupBy, tenantId, from, to, ct);
-        {
+        return Results.Ok(tokens);
-            return EndpointResults.BadRequest(InvalidGroupByDetail);
+    }
-        }
+
-
+    // GET /api/operator/analytics/activity?eventType=&amp;actorType=&amp;actorId=&amp;tenantId=&amp;from=&amp;to=&amp;limit=&amp;offset=: лента действий.
-        AnalyticsTokensDto tokens = await analyticsService.TokensAsync(normalizedGroupBy, tenantId, from, to, ct);
+    // eventType: Тип события (равенство; пусто — без фильтра).
-        return Results.Ok(tokens);
+    // actorType: Тип актора operator|tenant|system (равенство).
-    }
+    // actorId: Идентификатор актора (равенство).
-
+    // tenantId: Тенант (равенство).
-    // GET /api/operator/analytics/activity?eventType=&amp;actorType=&amp;actorId=&amp;tenantId=&amp;from=&amp;to=&amp;limit=&amp;offset=: лента действий.
+    // from: Нижняя граница At (включительно; ISO-8601).
-    // eventType: Тип события (равенство; пусто — без фильтра).
+    // to: Верхняя граница At (включительно; ISO-8601).
-    // actorType: Тип актора operator|tenant|system (равенство).
+    // limit: Размер страницы (дефолт 100, кламп 1..500).
-    // actorId: Идентификатор актора (равенство).
+    // offset: Смещение страницы (≥0).
-    // tenantId: Тенант (равенство).
+    // context: Контекст запроса.
-    // from: Нижняя граница At (включительно; ISO-8601).
+    // analyticsService: Сервис аналитики (scoped).
-    // to: Верхняя граница At (включительно; ISO-8601).
+    // ct: Токен отмены.
-    // limit: Размер страницы (дефолт 100, кламп 1..500).
+    // Возвращает: 200 {items, total, limit, offset} или 401 без операторской сессии.
-    // offset: Смещение страницы (≥0).
+    private static async Task<IResult> ActivityAsync(
-    // context: Контекст запроса.
+        string? eventType,
-    // analyticsService: Сервис аналитики (scoped).
+        string? actorType,
-    // ct: Токен отмены.
+        Guid? actorId,
-    // Возвращает: 200 {items, total, limit, offset} или 401 без операторской сессии.
+        Guid? tenantId,
-    private static async Task<IResult> ActivityAsync(
+        DateTimeOffset? from,
-        string? eventType,
+        DateTimeOffset? to,
-        string? actorType,
+        int? limit,
-        Guid? actorId,
+        int? offset,
-        Guid? tenantId,
+        HttpContext context,
-        DateTimeOffset? from,
+        AnalyticsService analyticsService,
-        DateTimeOffset? to,
+        CancellationToken ct)
-        int? limit,
+    {
-        int? offset,
+        if (context.GetCurrentOperator() is null)
-        HttpContext context,
+        {
-        AnalyticsService analyticsService,
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        if (context.GetCurrentOperator() is null)
+        AnalyticsActivityDto activity = await analyticsService.ActivityAsync(
-        {
+            eventType, actorType, actorId, tenantId, from, to, limit, offset, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        return Results.Ok(activity);
-        }
+    }
-
+
-        AnalyticsActivityDto activity = await analyticsService.ActivityAsync(
+    /// <summary>
-            eventType, actorType, actorId, tenantId, from, to, limit, offset, ct);
+    /// Известна ли группировка расхода токенов (day|tenant|provider|model).
-        return Results.Ok(activity);
+    /// </summary>
-    }
+    /// <param name="groupBy">Значение группировки.</param>
-
+    /// <returns>True — поддерживаемая группировка.</returns>
-    /// <summary>
+    public static bool IsKnownGroupBy(string groupBy) =>
-    /// Известна ли группировка расхода токенов (day|tenant|provider|model).
+        groupBy is TokenUsageGroupBys.Day or TokenUsageGroupBys.Tenant
-    /// </summary>
+            or TokenUsageGroupBys.Provider or TokenUsageGroupBys.Model;
-    /// <param name="groupBy">Значение группировки.</param>
+}
-    /// <returns>True — поддерживаемая группировка.</returns>
-    public static bool IsKnownGroupBy(string groupBy) =>
-        groupBy is TokenUsageGroupBys.Day or TokenUsageGroupBys.Tenant
-            or TokenUsageGroupBys.Provider or TokenUsageGroupBys.Model;
-}

src/core/Deal.Api/Endpoints/OperatorAuditEndpoints.cs

@@ -1,100 +1,95 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+
-using Deal.Modules.Tenants.Application.Models;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+/// <summary>
-using Deal.Api.Dtos;
+/// Операторский эндпоинт чтения аудита: GET /api/operator/audit (Ruling 4 этапа 7).
-
+/// </summary>
-namespace Deal.Api.Endpoints;
+/// <remarks>
-
+/// Чтение — только оператору: без операторской сессии 401 «Требуется вход оператора» (как /api/operator/auth/me).
-/// <summary>
+/// Фильтры-query: eventType, actorType, tenantId, from, to, limit (At DESC, limit клампится в
-/// Операторский эндпоинт чтения аудита: GET /api/operator/audit (Ruling 4 этапа 7).
+/// 1..<see cref="AuditService.MaxQueryLimit"/>, дефолт — <see cref="AuditService.DefaultQueryLimit"/>).
-/// </summary>
+/// Ответ — {items: [...], total}: total — полное число записей по фильтру (без учёта limit). Запись событий —
-/// <remarks>
+/// только через <see cref="AuditService"/> (append-only); этот эндпоинт лишь читает.
-/// Чтение — только оператору: без операторской сессии 401 «Требуется вход оператора» (как /api/operator/auth/me).
+/// </remarks>
-/// Фильтры-query: eventType, actorType, tenantId, from, to, limit (At DESC, limit клампится в
+public static class OperatorAuditEndpoints
-/// 1..<see cref="AuditService.MaxQueryLimit"/>, дефолт — <see cref="AuditService.DefaultQueryLimit"/>).
+{
-/// Ответ — {items: [...], total}: total — полное число записей по фильтру (без учёта limit). Запись событий —
+    // Префикс группы операторских ручек /api/operator (Ruling 11).
-/// только через <see cref="AuditService"/> (append-only); этот эндпоинт лишь читает.
+    private const string OperatorGroupPrefix = "/api/operator";
-/// </remarks>
+
-public static class OperatorAuditEndpoints
+    // Путь ленты аудита относительно группы.
-{
+    private const string AuditPath = "/audit";
-    // Префикс группы операторских ручек /api/operator (Ruling 11).
+
-    private const string OperatorGroupPrefix = "/api/operator";
+    // OpenAPI-тег группы (Ruling 11: операторская админка — API-only).
-
+    private const string OperatorOpenApiTag = "operator";
-    // Путь ленты аудита относительно группы.
+
-    private const string AuditPath = "/audit";
+    /// <summary>
-
+    /// Регистрирует группу /api/operator: GET /audit (лента аудита; другие ручки — задачи 5/7/10).
-    // OpenAPI-тег группы (Ruling 11: операторская админка — API-only).
+    /// </summary>
-    private const string OperatorOpenApiTag = "operator";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <summary>
+    public static IEndpointRouteBuilder MapOperatorAuditEndpoints(this IEndpointRouteBuilder app)
-    /// Регистрирует группу /api/operator: GET /audit (лента аудита; другие ручки — задачи 5/7/10).
+    {
-    /// </summary>
+        app.MapGroup(OperatorGroupPrefix).WithTags(OperatorOpenApiTag).MapGet(AuditPath, ListAsync);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        return app;
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+    }
-    public static IEndpointRouteBuilder MapOperatorAuditEndpoints(this IEndpointRouteBuilder app)
+
-    {
+    // GET /api/operator/audit?eventType=&amp;actorType=&amp;actorId=&amp;tenantId=&amp;from=&amp;to=&amp;limit=&amp;offset=: лента аудита.
-        app.MapGroup(OperatorGroupPrefix).WithTags(OperatorOpenApiTag).MapGet(AuditPath, ListAsync);
+    // eventType: Фильтр по типу события (равенство; пусто — без фильтра).
-        return app;
+    // actorType: Фильтр по типу актора operator|tenant|system (равенство).
-    }
+    // actorId: Фильтр по идентификатору актора (равенство).
-
+    // tenantId: Фильтр по тенанту (равенство).
-    // GET /api/operator/audit?eventType=&amp;actorType=&amp;actorId=&amp;tenantId=&amp;from=&amp;to=&amp;limit=&amp;offset=: лента аудита.
+    // from: Нижняя граница At (включительно; ISO-8601).
-    // eventType: Фильтр по типу события (равенство; пусто — без фильтра).
+    // to: Верхняя граница At (включительно; ISO-8601).
-    // actorType: Фильтр по типу актора operator|tenant|system (равенство).
+    // limit: Размер выборки (дефолт 100, клампится 1..500).
-    // actorId: Фильтр по идентификатору актора (равенство).
+    // offset: Смещение страницы (≥0; этап 10, T3).
-    // tenantId: Фильтр по тенанту (равенство).
+    // context: Контекст запроса.
-    // from: Нижняя граница At (включительно; ISO-8601).
+    // auditService: Сервис аудита (scoped).
-    // to: Верхняя граница At (включительно; ISO-8601).
+    // ct: Токен отмены.
-    // limit: Размер выборки (дефолт 100, клампится 1..500).
+    // Возвращает: 200 {items:[...], total} или 401 без операторской сессии.
-    // offset: Смещение страницы (≥0; этап 10, T3).
+    private static async Task<IResult> ListAsync(
-    // context: Контекст запроса.
+        string? eventType,
-    // auditService: Сервис аудита (scoped).
+        string? actorType,
-    // ct: Токен отмены.
+        Guid? actorId,
-    // Возвращает: 200 {items:[...], total} или 401 без операторской сессии.
+        Guid? tenantId,
-    private static async Task<IResult> ListAsync(
+        DateTimeOffset? from,
-        string? eventType,
+        DateTimeOffset? to,
-        string? actorType,
+        int? limit,
-        Guid? actorId,
+        int? offset,
-        Guid? tenantId,
+        HttpContext context,
-        DateTimeOffset? from,
+        AuditService auditService,
-        DateTimeOffset? to,
+        CancellationToken ct)
-        int? limit,
+    {
-        int? offset,
+        var operatorIdentity = context.GetCurrentOperator();
-        HttpContext context,
+        if (operatorIdentity is null)
-        AuditService auditService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        var filter = new AuditQueryDto(
-        {
+            eventType, actorType, tenantId, from, to, NormalizeLimit(limit), actorId, NormalizeOffset(offset));
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        IReadOnlyList<AuditRecordDto> items = await auditService.QueryAsync(filter, ct);
-        }
+        int total = await auditService.CountAsync(filter, ct);
-
+        return Results.Ok(new { items, total });
-        var filter = new AuditQueryDto(
+    }
-            eventType, actorType, tenantId, from, to, NormalizeLimit(limit), actorId, NormalizeOffset(offset));
+
-        IReadOnlyList<AuditRecordDto> items = await auditService.QueryAsync(filter, ct);
+    /// <summary>
-        int total = await auditService.CountAsync(filter, ct);
+    /// Нормализует limit запроса: дефолт <see cref="AuditService.DefaultQueryLimit"/>, кламп 1..500 (Ruling 4).
-        return Results.Ok(new { items, total });
+    /// </summary>
-    }
+    /// <param name="limit">Запрошенный размер выборки (null — не задан).</param>
-
+    /// <returns>Значение для фильтра.</returns>
-    /// <summary>
+    public static int NormalizeLimit(int? limit) =>
-    /// Нормализует limit запроса: дефолт <see cref="AuditService.DefaultQueryLimit"/>, кламп 1..500 (Ruling 4).
+        limit is null
-    /// </summary>
+            ? AuditService.DefaultQueryLimit
-    /// <param name="limit">Запрошенный размер выборки (null — не задан).</param>
+            : Math.Max(1, Math.Min(AuditService.MaxQueryLimit, limit.Value));
-    /// <returns>Значение для фильтра.</returns>
+
-    public static int NormalizeLimit(int? limit) =>
+    /// <summary>
-        limit is null
+    /// Нормализует offset запроса: отрицательное/отсутствующее — 0 (этап 10, T3).
-            ? AuditService.DefaultQueryLimit
+    /// </summary>
-            : Math.Max(1, Math.Min(AuditService.MaxQueryLimit, limit.Value));
+    /// <param name="offset">Запрошенное смещение (null — не задано).</param>
-
+    /// <returns>Неотрицательное смещение.</returns>
-    /// <summary>
+    public static int NormalizeOffset(int? offset) => Math.Max(0, offset ?? 0);
-    /// Нормализует offset запроса: отрицательное/отсутствующее — 0 (этап 10, T3).
+}
-    /// </summary>
-    /// <param name="offset">Запрошенное смещение (null — не задано).</param>
-    /// <returns>Неотрицательное смещение.</returns>
-    public static int NormalizeOffset(int? offset) => Math.Max(0, offset ?? 0);
-}

src/core/Deal.Api/Endpoints/OperatorAuthEndpoints.cs

@@ -1,180 +1,176 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Middleware;
-using Deal.Api.Services;
+using Deal.Api.Models;
-using Deal.Api.Middleware;
+using Deal.Api.Services;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Extensions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Models;
+using Microsoft.Extensions.Options;
-using Deal.Modules.Tenants.Application.Registrars;
+using AspNetCoreCookieOptions = Microsoft.AspNetCore.Http.CookieOptions;
-using Deal.Modules.Tenants.Application.Services;
+// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасами.
-using Microsoft.Extensions.Options;
+using OperatorCookieOptions = Deal.Api.Configuration.OperatorCookieOptions;
-using Deal.Api.Dtos;
+
-using AspNetCoreCookieOptions = Microsoft.AspNetCore.Http.CookieOptions;
+namespace Deal.Api.Endpoints;
-// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасами.
+
-using OperatorCookieOptions = Deal.Api.Configuration.OperatorCookieOptions;
+/// <summary>
-
+/// HTTP-эндпоинты аутентификации оператора (группа /api/operator/auth). Зеркало AuthEndpoints для операторов (Ruling 1).
-namespace Deal.Api.Endpoints;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// Оператор ≠ пользователь тенанта: вход по отдельным public-таблицам (OperatorAuthService/IOperatorAuthStore),
-/// HTTP-эндпоинты аутентификации оператора (группа /api/operator/auth). Зеркало AuthEndpoints для операторов (Ruling 1).
+/// сессия — в куке deal_operator_session (отдельная от deal_session; 12 ч, httpOnly, SameSite=Lax).
-/// </summary>
+/// Успех-ответы — <c>{ok:true,...}</c>, ошибки — HTTP-код + <c>{"detail":"..."}</c> (Ruling 10). Защищённые
-/// <remarks>
+/// ручки (me) требуют операторскую сессию (401 «Требуется вход оператора») — тенантная кука не проходит.
-/// Оператор ≠ пользователь тенанта: вход по отдельным public-таблицам (OperatorAuthService/IOperatorAuthStore),
+/// Результаты входа пишутся в аудит (operator_login_ok/failed, Task 4/Ruling 4).
-/// сессия — в куке deal_operator_session (отдельная от deal_session; 12 ч, httpOnly, SameSite=Lax).
+/// </remarks>
-/// Успех-ответы — <c>{ok:true,...}</c>, ошибки — HTTP-код + <c>{"detail":"..."}</c> (Ruling 10). Защищённые
+public static class OperatorAuthEndpoints
-/// ручки (me) требуют операторскую сессию (401 «Требуется вход оператора») — тенантная кука не проходит.
+{
-/// Результаты входа пишутся в аудит (operator_login_ok/failed, Task 4/Ruling 4).
+    private const string InvalidCredentialsDetail = "Неверный логин или пароль оператора";
-/// </remarks>
+    private const string OperatorAuthGroupPrefix = "/api/operator/auth";
-public static class OperatorAuthEndpoints
+    private const string OperatorAuthOpenApiTag = "operator-auth";
-{
+
-    private const string InvalidCredentialsDetail = "Неверный логин или пароль оператора";
+    /// <summary>
-    private const string OperatorAuthGroupPrefix = "/api/operator/auth";
+    /// Регистрирует группу /api/operator/auth: login, logout, me.
-    private const string OperatorAuthOpenApiTag = "operator-auth";
+    /// </summary>
-
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// <summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// Регистрирует группу /api/operator/auth: login, logout, me.
+    public static IEndpointRouteBuilder MapOperatorAuthEndpoints(this IEndpointRouteBuilder app)
-    /// </summary>
+    {
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        var group = app.MapGroup(OperatorAuthGroupPrefix).WithTags(OperatorAuthOpenApiTag);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+
-    public static IEndpointRouteBuilder MapOperatorAuthEndpoints(this IEndpointRouteBuilder app)
+        // Политика "auth" rate limiter (план Task 11, Ruling 5): фиксированное окно 10/мин на IP ручки
-    {
+        // входа оператора; остальные ручки группы — под глобальной API-политикой (по тенанту/IP).
-        var group = app.MapGroup(OperatorAuthGroupPrefix).WithTags(OperatorAuthOpenApiTag);
+        group.MapPost("/login", LoginAsync).RequireRateLimiting(RateLimitPolicies.AuthPolicy);
-
+        group.MapPost("/logout", LogoutAsync);
-        // Политика "auth" rate limiter (план Task 11, Ruling 5): фиксированное окно 10/мин на IP ручки
+        group.MapGet("/me", MeAsync);
-        // входа оператора; остальные ручки группы — под глобальной API-политикой (по тенанту/IP).
+
-        group.MapPost("/login", LoginAsync).RequireRateLimiting(RateLimitPolicies.AuthPolicy);
+        return app;
-        group.MapPost("/logout", LogoutAsync);
+    }
-        group.MapGet("/me", MeAsync);
+
-
+    // POST /api/operator/auth/login: проверка учётных данных оператора, выдача куки сессии; результат пишется в аудит (Task 4).
-        return app;
+    // До OperatorAuthService отрабатывает LoginAttemptGuard (5 неудач ip|login за 15 мин → 429, Ruling 5).
-    }
+    private static async Task<IResult> LoginAsync(
-
+        LoginRequest body,
-    // POST /api/operator/auth/login: проверка учётных данных оператора, выдача куки сессии; результат пишется в аудит (Task 4).
+        OperatorAuthService operatorAuthService,
-    // До OperatorAuthService отрабатывает LoginAttemptGuard (5 неудач ip|login за 15 мин → 429, Ruling 5).
+        AuditService auditService,
-    private static async Task<IResult> LoginAsync(
+        IOptions<OperatorCookieOptions> cookieOptions,
-        LoginRequest body,
+        HttpContext context,
-        OperatorAuthService operatorAuthService,
+        CancellationToken ct,
-        AuditService auditService,
+        LoginAttemptGuard loginAttemptGuard)
-        IOptions<OperatorCookieOptions> cookieOptions,
+    {
-        HttpContext context,
+        string? attemptedLogin = NormalizeLogin(body.Login);
-        CancellationToken ct,
+
-        LoginAttemptGuard loginAttemptGuard)
+        // Защита входа оператора (план Task 11, Ruling 5): зеркало AuthEndpoints — блокировка ключа
-    {
+        // ip|login до проверки учётных данных (в dev при RateLimit:Enabled=false гвард выключен).
-        string? attemptedLogin = NormalizeLogin(body.Login);
+        if (await loginAttemptGuard.IsBlockedAsync(ClientIp(context), attemptedLogin, ct))
-
+        {
-        // Защита входа оператора (план Task 11, Ruling 5): зеркало AuthEndpoints — блокировка ключа
+            return EndpointResults.TooManyRequests(LoginAttemptGuard.BlockedDetail);
-        // ip|login до проверки учётных данных (в dev при RateLimit:Enabled=false гвард выключен).
+        }
-        if (await loginAttemptGuard.IsBlockedAsync(ClientIp(context), attemptedLogin, ct))
+
-        {
+        var result = await operatorAuthService.LoginAsync(body.Login, body.Password, ct);
-            return EndpointResults.TooManyRequests(LoginAttemptGuard.BlockedDetail);
+        if (result.Login is null || result.Token is null)
-        }
+        {
-
+            // Неверные учётные данные оператора — одно сообщение (зеркало AuthEndpoints).
-        var result = await operatorAuthService.LoginAsync(body.Login, body.Password, ct);
+            // Аудит operator_login_failed — только для реальной попытки (непустой логин), без пароля (Ruling 4);
-        if (result.Login is null || result.Token is null)
+            // счётчик неудач гварда растёт там же (пустые логины ключа не имеют).
-        {
+            if (attemptedLogin is not null)
-            // Неверные учётные данные оператора — одно сообщение (зеркало AuthEndpoints).
+            {
-            // Аудит operator_login_failed — только для реальной попытки (непустой логин), без пароля (Ruling 4);
+                await loginAttemptGuard.RecordFailureAsync(ClientIp(context), attemptedLogin, ct);
-            // счётчик неудач гварда растёт там же (пустые логины ключа не имеют).
+                await auditService.AppendAsync(new AuditRecordDto(
-            if (attemptedLogin is not null)
+                    AuditEvents.OperatorLoginFailed,
-            {
+                    AuditActorTypes.Operator,
-                await loginAttemptGuard.RecordFailureAsync(ClientIp(context), attemptedLogin, ct);
+                    ActorId: null,
-                await auditService.AppendAsync(new AuditRecordDto(
+                    TenantId: null,
-                    AuditEvents.OperatorLoginFailed,
+                    Ip: ClientIp(context),
-                    AuditActorTypes.Operator,
+                    DetailJson: AuditService.ToDetailJson(new { login = attemptedLogin })), ct);
-                    ActorId: null,
+            }
-                    TenantId: null,
+
-                    Ip: ClientIp(context),
+            return EndpointResults.Unauthorized(InvalidCredentialsDetail);
-                    DetailJson: AuditService.ToDetailJson(new { login = attemptedLogin })), ct);
+        }
-            }
+
-
+        // Успешный вход оператора сбрасывает счётчик неудач ключа ip|login (Ruling 5).
-            return EndpointResults.Unauthorized(InvalidCredentialsDetail);
+        await loginAttemptGuard.ResetAsync(ClientIp(context), result.Login, ct);
-        }
+
-
+        await auditService.AppendAsync(new AuditRecordDto(
-        // Успешный вход оператора сбрасывает счётчик неудач ключа ip|login (Ruling 5).
+            AuditEvents.OperatorLoginOk,
-        await loginAttemptGuard.ResetAsync(ClientIp(context), result.Login, ct);
+            AuditActorTypes.Operator,
-
+            ActorId: result.OperatorId,
-        await auditService.AppendAsync(new AuditRecordDto(
+            TenantId: null,
-            AuditEvents.OperatorLoginOk,
+            Ip: ClientIp(context),
-            AuditActorTypes.Operator,
+            DetailJson: AuditService.ToDetailJson(new { login = result.Login })), ct);
-            ActorId: result.OperatorId,
+
-            TenantId: null,
+        SetOperatorSessionCookie(context, cookieOptions.Value, result.Token);
-            Ip: ClientIp(context),
+        return Results.Ok(new { ok = true, login = result.Login });
-            DetailJson: AuditService.ToDetailJson(new { login = result.Login })), ct);
+    }
-
+
-        SetOperatorSessionCookie(context, cookieOptions.Value, result.Token);
+    // POST /api/operator/auth/logout: удаление операторской сессии по токену из куки и очистка куки (всегда ok).
-        return Results.Ok(new { ok = true, login = result.Login });
+    private static async Task<IResult> LogoutAsync(
-    }
+        OperatorAuthService operatorAuthService,
-
+        IOptions<OperatorCookieOptions> cookieOptions,
-    // POST /api/operator/auth/logout: удаление операторской сессии по токену из куки и очистка куки (всегда ok).
+        HttpContext context,
-    private static async Task<IResult> LogoutAsync(
+        CancellationToken ct)
-        OperatorAuthService operatorAuthService,
+    {
-        IOptions<OperatorCookieOptions> cookieOptions,
+        var cookieName = cookieOptions.Value.Name;
-        HttpContext context,
+        var rawToken = context.Request.Cookies[cookieName];
-        CancellationToken ct)
+        // Оператор разрешённой сессии — до её удаления (OperatorSessionMiddleware наполнил Items).
-    {
+        CurrentOperator? operatorIdentity = context.GetCurrentOperator();
-        var cookieName = cookieOptions.Value.Name;
+        await operatorAuthService.LogoutAsync(rawToken, ct);
-        var rawToken = context.Request.Cookies[cookieName];
+        context.Response.Cookies.Delete(cookieName);
-        // Оператор разрешённой сессии — до её удаления (OperatorSessionMiddleware наполнил Items).
+
-        CurrentOperator? operatorIdentity = context.GetCurrentOperator();
+        // Выход оператора (этап 10, T1): событие пишется при живой разрешённой сессии.
-        await operatorAuthService.LogoutAsync(rawToken, ct);
+        if (operatorIdentity is not null)
-        context.Response.Cookies.Delete(cookieName);
+        {
-
+            await AuditAppender.AppendOperatorAsync(context, AuditEvents.OperatorLogout, new { login = operatorIdentity.Login }, ct);
-        // Выход оператора (этап 10, T1): событие пишется при живой разрешённой сессии.
+        }
-        if (operatorIdentity is not null)
+
-        {
+        return Results.Ok(new { ok = true });
-            await AuditAppender.AppendOperatorAsync(context, AuditEvents.OperatorLogout, new { login = operatorIdentity.Login }, ct);
+    }
-        }
+
-
+    // GET /api/operator/auth/me: проверка живой операторской сессии (401 без неё, Ruling 1).
-        return Results.Ok(new { ok = true });
+    private static IResult MeAsync(HttpContext context)
-    }
+    {
-
+        var operatorIdentity = context.GetCurrentOperator();
-    // GET /api/operator/auth/me: проверка живой операторской сессии (401 без неё, Ruling 1).
+        if (operatorIdentity is null)
-    private static IResult MeAsync(HttpContext context)
+        {
-    {
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        var operatorIdentity = context.GetCurrentOperator();
+        }
-        if (operatorIdentity is null)
+
-        {
+        return Results.Ok(new { login = operatorIdentity.Login, ok = true });
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+    }
-        }
+
-
+    // Выставляет httpOnly-куку сессии оператора: SameSite=Lax, Path=/, MaxAge=Hours, Secure — из конфига.
-        return Results.Ok(new { login = operatorIdentity.Login, ok = true });
+    // context: Контекст запроса.
-    }
+    // options: Настройки куки из конфигурации (секция OperatorCookies).
-
+    // rawToken: Raw-токен операторской сессии.
-    // Выставляет httpOnly-куку сессии оператора: SameSite=Lax, Path=/, MaxAge=Hours, Secure — из конфига.
+    private static void SetOperatorSessionCookie(
-    // context: Контекст запроса.
+        HttpContext context,
-    // options: Настройки куки из конфигурации (секция OperatorCookies).
+        OperatorCookieOptions options,
-    // rawToken: Raw-токен операторской сессии.
+        string rawToken)
-    private static void SetOperatorSessionCookie(
+    {
-        HttpContext context,
+        // MaxAge — OperatorCookies:Hours; код-дефолт значения ссылается на
-        OperatorCookieOptions options,
+        // OperatorAuthService.SessionLifetimeHours (единый источник «12 часов», см. OperatorCookieOptions).
-        string rawToken)
+        context.Response.Cookies.Append(
-    {
+            options.Name,
-        // MaxAge — OperatorCookies:Hours; код-дефолт значения ссылается на
+            rawToken,
-        // OperatorAuthService.SessionLifetimeHours (единый источник «12 часов», см. OperatorCookieOptions).
+            new AspNetCoreCookieOptions
-        context.Response.Cookies.Append(
+            {
-            options.Name,
+                HttpOnly = true,
-            rawToken,
+                SameSite = SameSiteMode.Lax,
-            new AspNetCoreCookieOptions
+                Path = "/",
-            {
+                MaxAge = TimeSpan.FromHours(options.Hours),
-                HttpOnly = true,
+                Secure = options.Secure,
-                SameSite = SameSiteMode.Lax,
+            });
-                Path = "/",
+    }
-                MaxAge = TimeSpan.FromHours(options.Hours),
+
-                Secure = options.Secure,
+    // Нормализованная попытка логина для аудита (нижний регистр/обрезка); null — писать нечего.
-            });
+    // login: Логин из тела запроса.
-    }
+    // Возвращает: Нормализованный логин или null при пустом/пробельном входе.
-
+    private static string? NormalizeLogin(string? login)
-    // Нормализованная попытка логина для аудита (нижний регистр/обрезка); null — писать нечего.
+    {
-    // login: Логин из тела запроса.
+        string? normalized = login?.Trim().ToLowerInvariant();
-    // Возвращает: Нормализованный логин или null при пустом/пробельном входе.
+        return string.IsNullOrEmpty(normalized) ? null : normalized;
-    private static string? NormalizeLogin(string? login)
+    }
-    {
+
-        string? normalized = login?.Trim().ToLowerInvariant();
+    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-        return string.IsNullOrEmpty(normalized) ? null : normalized;
+    // context: Контекст запроса.
-    }
+    // Возвращает: Строковое представление IP или null.
-
+    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-    // IP-адрес клиента для аудита (без порта; null, если недоступен).
+}
-    // context: Контекст запроса.
-    // Возвращает: Строковое представление IP или null.
-    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-}

src/core/Deal.Api/Endpoints/OperatorHealthEndpoints.cs

@@ -1,204 +1,198 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Observability;
-using Deal.Api.Services;
+using Deal.Api.Services;
-using Deal.Api.Observability;
+using Deal.Infrastructure.Integrations.Models;
-using Deal.Infrastructure.Integrations.Abstractions;
+using Deal.Infrastructure.Integrations.Options;
-using Deal.Infrastructure.Integrations.Exceptions;
+using Deal.Infrastructure.Integrations.Services;
-using Deal.Infrastructure.Integrations.Extensions;
+using Deal.Infrastructure.Persistence;
-using Deal.Infrastructure.Integrations.Models;
+using Microsoft.EntityFrameworkCore;
-using Deal.Infrastructure.Integrations.Options;
+
-using Deal.Infrastructure.Integrations.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Infrastructure.Persistence;
+
-using Deal.Infrastructure.Persistence.Configurations;
+/// <summary>
-using Microsoft.EntityFrameworkCore;
+/// Операторский health: GET /api/operator/health (план Task 10, Ruling 3/6/9/11) — ядро/БД и
-using Deal.Api.Dtos;
+/// автономные сервисы ml/ai/telegram.
-
+/// </summary>
-namespace Deal.Api.Endpoints;
+/// <remarks>
-
+/// Ручка — только оператору (401 «Требуется вход оператора» без операторской сессии). Ответ всегда 200
-/// <summary>
+/// (информационный операторский обзор, как /api/health) с полями состояния:
-/// Операторский health: GET /api/operator/health (план Task 10, Ruling 3/6/9/11) — ядро/БД и
+/// <c>{ok, core:{db:"ok"|"down"}, services:[{name, mode:"grpc"|"local", status, reachable}],
-/// автономные сервисы ml/ai/telegram.
+/// queues:{pipeline, mlOutbox}, sessions:{active}}</c>. Глубины очередей обработки/ML-outbox и число
-/// </summary>
+/// активных сессий (§10.2) собирает общий <see cref="RuntimeDepthsCollector"/> (тот же путь, что метрики).
-/// <remarks>
+/// Проверка БД — <c>SELECT 1</c> через DealDbContext (public-схема) с таймаутом 5 с; сбой (контейнер не поднят/
-/// Ручка — только оператору (401 «Требуется вход оператора» без операторской сессии). Ответ всегда 200
+/// сеть) → core.db=down без падения ручки. Сервисы: при <c>Services:*:UseLocal=true</c> — <c>{mode:"local",
-/// (информационный операторский обзор, как /api/health) с полями состояния:
+/// reachable:false, status:"local"}</c> (Local-адаптеры, реальный сервис не поднят — Ruling 6; dev-приёмка);
-/// <c>{ok, core:{db:"ok"|"down"}, services:[{name, mode:"grpc"|"local", status, reachable}],
+/// в gRPC-режиме — <see cref="ServiceHealthProbe"/> к <c>Services:*:Endpoint</c> (grpc.health.v1, таймаут 3 с):
-/// queues:{pipeline, mlOutbox}, sessions:{active}}</c>. Глубины очередей обработки/ML-outbox и число
+/// SERVING → status=ok, иной статус → unhealthy, недоступен → down. <c>ok</c> сводки — БД доступна и все
-/// активных сессий (§10.2) собирает общий <see cref="RuntimeDepthsCollector"/> (тот же путь, что метрики).
+/// сервисы в порядке (Local-режим не считается сбоем).
-/// Проверка БД — <c>SELECT 1</c> через DealDbContext (public-схема) с таймаутом 5 с; сбой (контейнер не поднят/
+/// </remarks>
-/// сеть) → core.db=down без падения ручки. Сервисы: при <c>Services:*:UseLocal=true</c> — <c>{mode:"local",
+public static class OperatorHealthEndpoints
-/// reachable:false, status:"local"}</c> (Local-адаптеры, реальный сервис не поднят — Ruling 6; dev-приёмка);
+{
-/// в gRPC-режиме — <see cref="ServiceHealthProbe"/> к <c>Services:*:Endpoint</c> (grpc.health.v1, таймаут 3 с):
+    // Префикс группы операторских ручек health (Ruling 11).
-/// SERVING → status=ok, иной статус → unhealthy, недоступен → down. <c>ok</c> сводки — БД доступна и все
+    private const string OperatorGroupPrefix = "/api/operator";
-/// сервисы в порядке (Local-режим не считается сбоем).
+
-/// </remarks>
+    // Путь health-ручки.
-public static class OperatorHealthEndpoints
+    private const string HealthPath = "/health";
-{
+
-    // Префикс группы операторских ручек health (Ruling 11).
+    // OpenAPI-тег группы.
-    private const string OperatorGroupPrefix = "/api/operator";
+    private const string OperatorOpenApiTag = "operator-health";
-
+
-    // Путь health-ручки.
+    // Статус БД/сервиса: доступна/здоров (ok).
-    private const string HealthPath = "/health";
+    private const string StatusOk = "ok";
-
+
-    // OpenAPI-тег группы.
+    // Статус сервиса: БД/сервис недоступен (down).
-    private const string OperatorOpenApiTag = "operator-health";
+    private const string StatusDown = "down";
-
+
-    // Статус БД/сервиса: доступна/здоров (ok).
+    // Статус сервиса: ответил, но не SERVING (grpc NOT_SERVING/SERVICE_UNKNOWN).
-    private const string StatusOk = "ok";
+    private const string StatusUnhealthy = "unhealthy";
-
+
-    // Статус сервиса: БД/сервис недоступен (down).
+    // Статус сервиса в Local-режиме: реальный сервис не подключён (UseLocal=true, Ruling 6).
-    private const string StatusDown = "down";
+    private const string StatusLocal = "local";
-
+
-    // Статус сервиса: ответил, но не SERVING (grpc NOT_SERVING/SERVICE_UNKNOWN).
+    // Режим сервиса: Local-адаптеры (UseLocal=true).
-    private const string StatusUnhealthy = "unhealthy";
+    private const string ModeLocal = "local";
-
+
-    // Статус сервиса в Local-режиме: реальный сервис не подключён (UseLocal=true, Ruling 6).
+    // Режим сервиса: gRPC-клиент (UseLocal=false).
-    private const string StatusLocal = "local";
+    private const string ModeGrpc = "grpc";
-
+
-    // Режим сервиса: Local-адаптеры (UseLocal=true).
+    // Имя ml-service в ответе (порядок секций — как в стартовых логах Program.cs).
-    private const string ModeLocal = "local";
+    private const string MlServiceName = "ml";
-
+
-    // Режим сервиса: gRPC-клиент (UseLocal=false).
+    // Имя ai-service в ответе.
-    private const string ModeGrpc = "grpc";
+    private const string AiServiceName = "ai";
-
+
-    // Имя ml-service в ответе (порядок секций — как в стартовых логах Program.cs).
+    // Имя telegram-service в ответе.
-    private const string MlServiceName = "ml";
+    private const string TelegramServiceName = "telegram";
-
+
-    // Имя ai-service в ответе.
+    // Таймаут проверки БД, миллисекунд (health не должен висеть на мёртвом хосте Postgres).
-    private const string AiServiceName = "ai";
+    private const int DatabaseProbeTimeoutMilliseconds = 5000;
-
+
-    // Имя telegram-service в ответе.
+    /// <summary>
-    private const string TelegramServiceName = "telegram";
+    /// Регистрирует GET /api/operator/health (health ядра/БД и автономных сервисов).
-
+    /// </summary>
-    // Таймаут проверки БД, миллисекунд (health не должен висеть на мёртвом хосте Postgres).
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    private const int DatabaseProbeTimeoutMilliseconds = 5000;
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-
+    public static IEndpointRouteBuilder MapOperatorHealthEndpoints(this IEndpointRouteBuilder app)
-    /// <summary>
+    {
-    /// Регистрирует GET /api/operator/health (health ядра/БД и автономных сервисов).
+        app.MapGroup(OperatorGroupPrefix).WithTags(OperatorOpenApiTag).MapGet(HealthPath, GetAsync);
-    /// </summary>
+        return app;
-    /// <param name="app">Построитель маршрутов приложения.</param>
+    }
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+
-    public static IEndpointRouteBuilder MapOperatorHealthEndpoints(this IEndpointRouteBuilder app)
+    // GET /api/operator/health: {ok, core:{db}, services:[{name,mode,status,reachable}]} (всегда 200).
-    {
+    private static async Task<IResult> GetAsync(
-        app.MapGroup(OperatorGroupPrefix).WithTags(OperatorOpenApiTag).MapGet(HealthPath, GetAsync);
+        HttpContext context,
-        return app;
+        DealDbContext dbContext,
-    }
+        ServiceHealthProbe healthProbe,
-
+        RuntimeDepthsCollector depthsCollector,
-    // GET /api/operator/health: {ok, core:{db}, services:[{name,mode,status,reachable}]} (всегда 200).
+        MlServiceOptions mlOptions,
-    private static async Task<IResult> GetAsync(
+        AiServiceOptions aiOptions,
-        HttpContext context,
+        TelegramServiceOptions telegramOptions,
-        DealDbContext dbContext,
+        CancellationToken ct)
-        ServiceHealthProbe healthProbe,
+    {
-        RuntimeDepthsCollector depthsCollector,
+        var operatorIdentity = context.GetCurrentOperator();
-        MlServiceOptions mlOptions,
+        if (operatorIdentity is null)
-        AiServiceOptions aiOptions,
+        {
-        TelegramServiceOptions telegramOptions,
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        var operatorIdentity = context.GetCurrentOperator();
+        // Параллельно: БД (SELECT 1), health-пробы сервисов (до 3 с на сервис) и снимок глубин очередей/сессий.
-        if (operatorIdentity is null)
+        Task<string> databaseTask = ProbeDatabaseAsync(dbContext, ct);
-        {
+        Task<List<ServiceEntryDto>> servicesTask = ProbeServicesAsync(healthProbe, mlOptions, aiOptions, telegramOptions, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        Task<RuntimeDepthsDto> depthsTask = depthsCollector.CollectAsync(ct);
-        }
+        await Task.WhenAll(databaseTask, servicesTask, depthsTask);
-
+
-        // Параллельно: БД (SELECT 1), health-пробы сервисов (до 3 с на сервис) и снимок глубин очередей/сессий.
+        string databaseStatus = await databaseTask;
-        Task<string> databaseTask = ProbeDatabaseAsync(dbContext, ct);
+        List<ServiceEntryDto> services = await servicesTask;
-        Task<List<ServiceEntryDto>> servicesTask = ProbeServicesAsync(healthProbe, mlOptions, aiOptions, telegramOptions, ct);
+        RuntimeDepthsDto depths = await depthsTask;
-        Task<RuntimeDepthsDto> depthsTask = depthsCollector.CollectAsync(ct);
+        bool ok = databaseStatus == StatusOk
-        await Task.WhenAll(databaseTask, servicesTask, depthsTask);
+            && services.All(service => service.Mode == ModeLocal || service.Status == StatusOk);
-
+        return Results.Ok(new
-        string databaseStatus = await databaseTask;
+        {
-        List<ServiceEntryDto> services = await servicesTask;
+            ok,
-        RuntimeDepthsDto depths = await depthsTask;
+            core = new { db = databaseStatus },
-        bool ok = databaseStatus == StatusOk
+            services,
-            && services.All(service => service.Mode == ModeLocal || service.Status == StatusOk);
+            queues = new { pipeline = depths.PipelineQueue, mlOutbox = depths.MlOutbox },
-        return Results.Ok(new
+            sessions = new { active = depths.ActiveSessions },
-        {
+        });
-            ok,
+    }
-            core = new { db = databaseStatus },
+
-            services,
+    // Проверяет доступность БД core: SELECT 1 через DealDbContext (public-схема) с таймаутом 5 с.
-            queues = new { pipeline = depths.PipelineQueue, mlOutbox = depths.MlOutbox },
+    // dbContext: Системный контекст.
-            sessions = new { active = depths.ActiveSessions },
+    // ct: Токен отмены.
-        });
+    // Возвращает: Статус БД: ok/down (сбой не роняет ручку).
-    }
+    private static async Task<string> ProbeDatabaseAsync(DealDbContext dbContext, CancellationToken ct)
-
+    {
-    // Проверяет доступность БД core: SELECT 1 через DealDbContext (public-схема) с таймаутом 5 с.
+        try
-    // dbContext: Системный контекст.
+        {
-    // ct: Токен отмены.
+            using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
-    // Возвращает: Статус БД: ok/down (сбой не роняет ручку).
+            timeout.CancelAfter(DatabaseProbeTimeoutMilliseconds);
-    private static async Task<string> ProbeDatabaseAsync(DealDbContext dbContext, CancellationToken ct)
+            await dbContext.Database.ExecuteSqlRawAsync("SELECT 1", timeout.Token);
-    {
+            return StatusOk;
-        try
+        }
-        {
+        catch (Exception)
-            using var timeout = CancellationTokenSource.CreateLinkedTokenSource(ct);
+        {
-            timeout.CancelAfter(DatabaseProbeTimeoutMilliseconds);
+            // Postgres недоступен (контейнер не поднят/сеть) — оператор видит core.db=down, ручка жива.
-            await dbContext.Database.ExecuteSqlRawAsync("SELECT 1", timeout.Token);
+            return StatusDown;
-            return StatusOk;
+        }
-        }
+    }
-        catch (Exception)
+
-        {
+    // Пробы сервисов ml/ai/telegram по их конфигурации: Local-режим — пометка local без вызова;
-            // Postgres недоступен (контейнер не поднят/сеть) — оператор видит core.db=down, ручка жива.
+    // gRPC-режим — health-проба к Services:*:Endpoint (ServiceHealthProbe).
-            return StatusDown;
+    // healthProbe: Проба grpc.health.v1.
-        }
+    // mlOptions: Конфигурация ml-service.
-    }
+    // aiOptions: Конфигурация ai-service.
-
+    // telegramOptions: Конфигурация telegram-service.
-    // Пробы сервисов ml/ai/telegram по их конфигурации: Local-режим — пометка local без вызова;
+    // ct: Токен отмены.
-    // gRPC-режим — health-проба к Services:*:Endpoint (ServiceHealthProbe).
+    // Возвращает: Записи состояния сервисов в порядке ml → ai → telegram.
-    // healthProbe: Проба grpc.health.v1.
+    private static async Task<List<ServiceEntryDto>> ProbeServicesAsync(
-    // mlOptions: Конфигурация ml-service.
+        ServiceHealthProbe healthProbe,
-    // aiOptions: Конфигурация ai-service.
+        MlServiceOptions mlOptions,
-    // telegramOptions: Конфигурация telegram-service.
+        AiServiceOptions aiOptions,
-    // ct: Токен отмены.
+        TelegramServiceOptions telegramOptions,
-    // Возвращает: Записи состояния сервисов в порядке ml → ai → telegram.
+        CancellationToken ct)
-    private static async Task<List<ServiceEntryDto>> ProbeServicesAsync(
+    {
-        ServiceHealthProbe healthProbe,
+        var services = new List<ServiceEntryDto>(capacity: 3);
-        MlServiceOptions mlOptions,
+        await ProbeServiceAsync(services, healthProbe, MlServiceName, mlOptions.UseLocal, mlOptions.Endpoint, ct);
-        AiServiceOptions aiOptions,
+        await ProbeServiceAsync(services, healthProbe, AiServiceName, aiOptions.UseLocal, aiOptions.Endpoint, ct);
-        TelegramServiceOptions telegramOptions,
+        await ProbeServiceAsync(services, healthProbe, TelegramServiceName, telegramOptions.UseLocal, telegramOptions.Endpoint, ct);
-        CancellationToken ct)
+        return services;
-    {
+    }
-        var services = new List<ServiceEntryDto>(capacity: 3);
+
-        await ProbeServiceAsync(services, healthProbe, MlServiceName, mlOptions.UseLocal, mlOptions.Endpoint, ct);
+    // Одна запись состояния сервиса в списке services (см. ProbeServicesAsync).
-        await ProbeServiceAsync(services, healthProbe, AiServiceName, aiOptions.UseLocal, aiOptions.Endpoint, ct);
+    // services: Куда добавить запись.
-        await ProbeServiceAsync(services, healthProbe, TelegramServiceName, telegramOptions.UseLocal, telegramOptions.Endpoint, ct);
+    // healthProbe: Проба grpc.health.v1.
-        return services;
+    // name: Имя сервиса в ответе.
-    }
+    // useLocal: True — Local-режим (UseLocal=true): реальный сервис не подключён.
-
+    // endpoint: Базовый адрес сервиса (для gRPC-режима).
-    // Одна запись состояния сервиса в списке services (см. ProbeServicesAsync).
+    // ct: Токен отмены.
-    // services: Куда добавить запись.
+    private static async Task ProbeServiceAsync(
-    // healthProbe: Проба grpc.health.v1.
+        List<ServiceEntryDto> services,
-    // name: Имя сервиса в ответе.
+        ServiceHealthProbe healthProbe,
-    // useLocal: True — Local-режим (UseLocal=true): реальный сервис не подключён.
+        string name,
-    // endpoint: Базовый адрес сервиса (для gRPC-режима).
+        bool useLocal,
-    // ct: Токен отмены.
+        string endpoint,
-    private static async Task ProbeServiceAsync(
+        CancellationToken ct)
-        List<ServiceEntryDto> services,
+    {
-        ServiceHealthProbe healthProbe,
+        if (useLocal)
-        string name,
+        {
-        bool useLocal,
+            services.Add(new ServiceEntryDto(name, ModeLocal, StatusLocal, Reachable: false));
-        string endpoint,
+            return;
-        CancellationToken ct)
+        }
-    {
+
-        if (useLocal)
+        ServiceHealthResult result = await healthProbe.ProbeAsync(endpoint, ct);
-        {
+        string status = (result.Reachable, result.Serving) switch
-            services.Add(new ServiceEntryDto(name, ModeLocal, StatusLocal, Reachable: false));
+        {
-            return;
+            (true, true) => StatusOk,
-        }
+            (true, false) => StatusUnhealthy,
-
+            _ => StatusDown,
-        ServiceHealthResult result = await healthProbe.ProbeAsync(endpoint, ct);
+        };
-        string status = (result.Reachable, result.Serving) switch
+        services.Add(new ServiceEntryDto(name, ModeGrpc, status, result.Reachable));
-        {
+    }
-            (true, true) => StatusOk,
+
-            (true, false) => StatusUnhealthy,
+    // Запись состояния сервиса в ответе /api/operator/health (приватная форма сериализации).
-            _ => StatusDown,
+    // Name: Имя сервиса (ml/ai/telegram).
-        };
+    // Mode: Режим: local (UseLocal=true) | grpc (UseLocal=false).
-        services.Add(new ServiceEntryDto(name, ModeGrpc, status, result.Reachable));
+    // Status: Состояние: ok | unhealthy | down (в Local-режиме — local).
-    }
+    // Reachable: True — сервис ответил на health-пробу (в Local-режиме всегда false).
-
+    private sealed record ServiceEntryDto(string Name, string Mode, string Status, bool Reachable);
-    // Запись состояния сервиса в ответе /api/operator/health (приватная форма сериализации).
+}
-    // Name: Имя сервиса (ml/ai/telegram).
-    // Mode: Режим: local (UseLocal=true) | grpc (UseLocal=false).
-    // Status: Состояние: ok | unhealthy | down (в Local-режиме — local).
-    // Reachable: True — сервис ответил на health-пробу (в Local-режиме всегда false).
-    private sealed record ServiceEntryDto(string Name, string Mode, string Status, bool Reachable);
-}

src/core/Deal.Api/Endpoints/OperatorInviteCreateRequest.cs

@@ -1,11 +1,8 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/operator/invites: email приглашённого и опциональный целевой тенант (Ruling 2 этапа 7).
-
+/// </summary>
-/// <summary>
+/// <param name="Email">Email приглашённого (регистр/пробелы не важны — нормализует InvitesService).</param>
-/// Тело POST /api/operator/invites: email приглашённого и опциональный целевой тенант (Ruling 2 этапа 7).
+/// <param name="TenantId">Целевой тенант; null — при активации будет создан новый тенант (Task 6).</param>
-/// </summary>
+public sealed record OperatorInviteCreateRequest(string? Email, Guid? TenantId);
-/// <param name="Email">Email приглашённого (регистр/пробелы не важны — нормализует InvitesService).</param>
-/// <param name="TenantId">Целевой тенант; null — при активации будет создан новый тенант (Task 6).</param>
-public sealed record OperatorInviteCreateRequest(string? Email, Guid? TenantId);

src/core/Deal.Api/Endpoints/OperatorInvitesEndpoints.cs

@@ -1,152 +1,147 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+
-using Deal.Modules.Tenants.Application.Models;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+/// <summary>
-using Deal.Api.Dtos;
+/// Операторские эндпоинты приглашений: GET /api/operator/invites, POST (создание), POST {code}/revoke (Ruling 2/11 этапа 7).
-
+/// </summary>
-namespace Deal.Api.Endpoints;
+/// <remarks>
-
+/// Создание/отзыв/чтение — только оператор: без операторской сессии 401 «Требуется вход оператора»
-/// <summary>
+/// (как /api/operator/auth/me). Создание возвращает {code, email, tenantId, expiresAt, status} (план Task 5),
-/// Операторские эндпоинты приглашений: GET /api/operator/invites, POST (создание), POST {code}/revoke (Ruling 2/11 этапа 7).
+/// список — {items:[...]} (полные строки; форма как у GET /api/operator/audit), отзыв — {ok:true}. Результаты
-/// </summary>
+/// пишутся в аудит — invite_created/invite_revoked с email и codeHash в DetailJson (Ruling 4; операторские события,
-/// <remarks>
+/// TenantId null; хэш кода — Security review). Тексты ошибок — фиксированные строки HTTP-слоя (паттерн AuthEndpoints).
-/// Создание/отзыв/чтение — только оператор: без операторской сессии 401 «Требуется вход оператора»
+/// </remarks>
-/// (как /api/operator/auth/me). Создание возвращает {code, email, tenantId, expiresAt, status} (план Task 5),
+public static class OperatorInvitesEndpoints
-/// список — {items:[...]} (полные строки; форма как у GET /api/operator/audit), отзыв — {ok:true}. Результаты
+{
-/// пишутся в аудит — invite_created/invite_revoked с email и codeHash в DetailJson (Ruling 4; операторские события,
+    // Текст 400: email пустой/некорректного формата.
-/// TenantId null; хэш кода — Security review). Тексты ошибок — фиксированные строки HTTP-слоя (паттерн AuthEndpoints).
+    private const string InvalidEmailDetail = "Некорректный email";
-/// </remarks>
+
-public static class OperatorInvitesEndpoints
+    // Текст 400: на email уже есть активное приглашение (план Task 5, Ruling 2).
-{
+    private const string DuplicateActiveDetail = "Для этого email уже есть активное приглашение";
-    // Текст 400: email пустой/некорректного формата.
+
-    private const string InvalidEmailDetail = "Некорректный email";
+    // Текст 404: приглашение с таким кодом не найдено.
-
+    private const string InviteNotFoundDetail = "Приглашение не найдено";
-    // Текст 400: на email уже есть активное приглашение (план Task 5, Ruling 2).
+
-    private const string DuplicateActiveDetail = "Для этого email уже есть активное приглашение";
+    // Текст 400: отзыв приглашения не в статусе pending (уже отозвано/использовано/истекло).
-
+    private const string InviteNotPendingDetail = "Отозвать можно только ожидающее активации приглашение";
-    // Текст 404: приглашение с таким кодом не найдено.
+
-    private const string InviteNotFoundDetail = "Приглашение не найдено";
+    // Префикс группы операторских ручек приглашений (Ruling 11).
-
+    private const string InvitesGroupPrefix = "/api/operator/invites";
-    // Текст 400: отзыв приглашения не в статусе pending (уже отозвано/использовано/истекло).
+
-    private const string InviteNotPendingDetail = "Отозвать можно только ожидающее активации приглашение";
+    // Относительный путь отзыва приглашения.
-
+    private const string RevokePath = "/{code}/revoke";
-    // Префикс группы операторских ручек приглашений (Ruling 11).
+
-    private const string InvitesGroupPrefix = "/api/operator/invites";
+    // OpenAPI-тег группы.
-
+    private const string InvitesOpenApiTag = "operator-invites";
-    // Относительный путь отзыва приглашения.
+
-    private const string RevokePath = "/{code}/revoke";
+    /// <summary>
-
+    /// Регистрирует группу /api/operator/invites: GET (список), POST (создание), POST {code}/revoke (отзыв).
-    // OpenAPI-тег группы.
+    /// </summary>
-    private const string InvitesOpenApiTag = "operator-invites";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <summary>
+    public static IEndpointRouteBuilder MapOperatorInvitesEndpoints(this IEndpointRouteBuilder app)
-    /// Регистрирует группу /api/operator/invites: GET (список), POST (создание), POST {code}/revoke (отзыв).
+    {
-    /// </summary>
+        var group = app.MapGroup(InvitesGroupPrefix).WithTags(InvitesOpenApiTag);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        group.MapGet("", ListAsync);
-    public static IEndpointRouteBuilder MapOperatorInvitesEndpoints(this IEndpointRouteBuilder app)
+        group.MapPost("", CreateAsync);
-    {
+        group.MapPost(RevokePath, RevokeAsync);
-        var group = app.MapGroup(InvitesGroupPrefix).WithTags(InvitesOpenApiTag);
+
-
+        return app;
-        group.MapGet("", ListAsync);
+    }
-        group.MapPost("", CreateAsync);
+
-        group.MapPost(RevokePath, RevokeAsync);
+    // GET /api/operator/invites: список приглашений (новые сверху, со статусами; expired проставляется лениво).
-
+    private static async Task<IResult> ListAsync(
-        return app;
+        HttpContext context,
-    }
+        InvitesService invitesService,
-
+        CancellationToken ct)
-    // GET /api/operator/invites: список приглашений (новые сверху, со статусами; expired проставляется лениво).
+    {
-    private static async Task<IResult> ListAsync(
+        if (context.GetCurrentOperator() is null)
-        HttpContext context,
+        {
-        InvitesService invitesService,
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        if (context.GetCurrentOperator() is null)
+        IReadOnlyList<InviteDto> items = await invitesService.ListAsync(ct);
-        {
+        return Results.Ok(new { items });
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+    }
-        }
+
-
+    // POST /api/operator/invites: создание приглашения; результат пишется в аудит (invite_created).
-        IReadOnlyList<InviteDto> items = await invitesService.ListAsync(ct);
+    private static async Task<IResult> CreateAsync(
-        return Results.Ok(new { items });
+        OperatorInviteCreateRequest body,
-    }
+        HttpContext context,
-
+        InvitesService invitesService,
-    // POST /api/operator/invites: создание приглашения; результат пишется в аудит (invite_created).
+        AuditService auditService,
-    private static async Task<IResult> CreateAsync(
+        CancellationToken ct)
-        OperatorInviteCreateRequest body,
+    {
-        HttpContext context,
+        var operatorIdentity = context.GetCurrentOperator();
-        InvitesService invitesService,
+        if (operatorIdentity is null)
-        AuditService auditService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        InviteCreateResultDto result = await invitesService.CreateInviteAsync(
-        {
+            operatorIdentity.OperatorId, body.Email, body.TenantId, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        if (!result.Ok || result.Invite is null)
-        }
+        {
-
+            string detail = result.Error == InviteCreateResultDto.ErrorDuplicateActive
-        InviteCreateResultDto result = await invitesService.CreateInviteAsync(
+                ? DuplicateActiveDetail
-            operatorIdentity.OperatorId, body.Email, body.TenantId, ct);
+                : InvalidEmailDetail;
-        if (!result.Ok || result.Invite is null)
+            return EndpointResults.BadRequest(detail);
-        {
+        }
-            string detail = result.Error == InviteCreateResultDto.ErrorDuplicateActive
+
-                ? DuplicateActiveDetail
+        await auditService.AppendAsync(new AuditRecordDto(
-                : InvalidEmailDetail;
+            AuditEvents.InviteCreated,
-            return EndpointResults.BadRequest(detail);
+            AuditActorTypes.Operator,
-        }
+            ActorId: operatorIdentity.OperatorId,
-
+            TenantId: null,
-        await auditService.AppendAsync(new AuditRecordDto(
+            Ip: ClientIp(context),
-            AuditEvents.InviteCreated,
+            // Код инвайта — capability-токен (по нему активируется приглашение): в аудит пишется
-            AuditActorTypes.Operator,
+            // только его SHA-256-хэш, чтобы утечка ленты не давала рабочие коды (Security review).
-            ActorId: operatorIdentity.OperatorId,
+            DetailJson: AuditService.ToDetailJson(new { email = result.Invite.Email, codeHash = SessionTokens.HashToken(result.Invite.Code) })), ct);
-            TenantId: null,
+
-            Ip: ClientIp(context),
+        InviteDto invite = result.Invite;
-            // Код инвайта — capability-токен (по нему активируется приглашение): в аудит пишется
+        return Results.Ok(new { invite.Code, invite.Email, invite.TenantId, invite.ExpiresAt, invite.Status });
-            // только его SHA-256-хэш, чтобы утечка ленты не давала рабочие коды (Security review).
+    }
-            DetailJson: AuditService.ToDetailJson(new { email = result.Invite.Email, codeHash = SessionTokens.HashToken(result.Invite.Code) })), ct);
+
-
+    // POST /api/operator/invites/{code}/revoke: отзыв ожидающего приглашения; результат пишется в аудит (invite_revoked).
-        InviteDto invite = result.Invite;
+    private static async Task<IResult> RevokeAsync(
-        return Results.Ok(new { invite.Code, invite.Email, invite.TenantId, invite.ExpiresAt, invite.Status });
+        string code,
-    }
+        HttpContext context,
-
+        InvitesService invitesService,
-    // POST /api/operator/invites/{code}/revoke: отзыв ожидающего приглашения; результат пишется в аудит (invite_revoked).
+        AuditService auditService,
-    private static async Task<IResult> RevokeAsync(
+        CancellationToken ct)
-        string code,
+    {
-        HttpContext context,
+        var operatorIdentity = context.GetCurrentOperator();
-        InvitesService invitesService,
+        if (operatorIdentity is null)
-        AuditService auditService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        InviteRevokeResultDto result = await invitesService.RevokeAsync(code, ct);
-        {
+        if (!result.Ok)
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        {
-        }
+            return result.Error == InviteRevokeResultDto.ErrorNotFound
-
+                ? EndpointResults.NotFound(InviteNotFoundDetail)
-        InviteRevokeResultDto result = await invitesService.RevokeAsync(code, ct);
+                : EndpointResults.BadRequest(InviteNotPendingDetail);
-        if (!result.Ok)
+        }
-        {
+
-            return result.Error == InviteRevokeResultDto.ErrorNotFound
+        await auditService.AppendAsync(new AuditRecordDto(
-                ? EndpointResults.NotFound(InviteNotFoundDetail)
+            AuditEvents.InviteRevoked,
-                : EndpointResults.BadRequest(InviteNotPendingDetail);
+            AuditActorTypes.Operator,
-        }
+            ActorId: operatorIdentity.OperatorId,
-
+            TenantId: null,
-        await auditService.AppendAsync(new AuditRecordDto(
+            Ip: ClientIp(context),
-            AuditEvents.InviteRevoked,
+            DetailJson: AuditService.ToDetailJson(new { email = result.Invite!.Email, codeHash = SessionTokens.HashToken(result.Invite.Code) })), ct);
-            AuditActorTypes.Operator,
+
-            ActorId: operatorIdentity.OperatorId,
+        return Results.Ok(new { ok = true });
-            TenantId: null,
+    }
-            Ip: ClientIp(context),
+
-            DetailJson: AuditService.ToDetailJson(new { email = result.Invite!.Email, codeHash = SessionTokens.HashToken(result.Invite.Code) })), ct);
+    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-
+    // context: Контекст запроса.
-        return Results.Ok(new { ok = true });
+    // Возвращает: Строковое представление IP или null.
-    }
+    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-
+}
-    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-    // context: Контекст запроса.
-    // Возвращает: Строковое представление IP или null.
-    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-}

src/core/Deal.Api/Endpoints/OperatorLimitUpdateRequest.cs

@@ -1,13 +1,10 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело PATCH /api/operator/tenants/{id}/limit: смена лимитов ИИ-бюджета тенанта (план Task 10, Ruling 3).
-
+/// Оба поля опциональны — меняется только заданное; смена бюджета/периода сбрасывает флаги Warned80/
-/// <summary>
+/// NotifiedExhausted (новый период открывает пороги тостов, один тост на период на порог, Ruling 3).
-/// Тело PATCH /api/operator/tenants/{id}/limit: смена лимитов ИИ-бюджета тенанта (план Task 10, Ruling 3).
+/// </summary>
-/// Оба поля опциональны — меняется только заданное; смена бюджета/периода сбрасывает флаги Warned80/
+/// <param name="Budget">Новый бюджет периода в токенах (≥0; 0 — ИИ запрещён); null — оставить текущий.</param>
-/// NotifiedExhausted (новый период открывает пороги тостов, один тост на период на порог, Ruling 3).
+/// <param name="Period">Новый тип периода (константа <c>TenantLimitPeriods</c>: month|day); null — оставить текущий.</param>
-/// </summary>
+public sealed record OperatorLimitUpdateRequest(long? Budget, string? Period);
-/// <param name="Budget">Новый бюджет периода в токенах (≥0; 0 — ИИ запрещён); null — оставить текущий.</param>
-/// <param name="Period">Новый тип периода (константа <c>TenantLimitPeriods</c>: month|day); null — оставить текущий.</param>
-public sealed record OperatorLimitUpdateRequest(long? Budget, string? Period);

src/core/Deal.Api/Endpoints/OperatorLimitsEndpoints.cs

@@ -1,251 +1,247 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Extensions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Models;
+
-using Deal.Modules.Tenants.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Tenants.Application.Services;
+
-using Deal.Api.Dtos;
+/// <summary>
-
+/// Операторские эндпоинты лимитов ИИ-бюджета: сводка по всем тенантам и просмотр/смена лимита тенанта
-namespace Deal.Api.Endpoints;
+/// (план Task 10, Ruling 3/11).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Операторские эндпоинты лимитов ИИ-бюджета: сводка по всем тенантам и просмотр/смена лимита тенанта
+/// Все ручки — только оператору: без операторской сессии 401 «Требуется вход оператора» (как остальные
-/// (план Task 10, Ruling 3/11).
+/// /api/operator/*). GET /api/operator/limits — сводка {items:[{tenantId, name, budget, period, used, percent,
-/// </summary>
+/// status}]} по реестру тенантов (Ruling 3: строка лимита на путь чтения заводится лениво с дефолт-бюджетом —
-/// <remarks>
+/// тенант без расхода виден как «дефолт, 0»). GET/PATCH /api/operator/tenants/{id}/limit — детали/смена лимита:
-/// Все ручки — только оператору: без операторской сессии 401 «Требуется вход оператора» (как остальные
+/// PATCH принимает {budget?, period?} (оба опциональны — меняется только заданное; null-тело/без полей → 400),
-/// /api/operator/*). GET /api/operator/limits — сводка {items:[{tenantId, name, budget, period, used, percent,
+/// сбрасывает Warned80/NotifiedExhausted через UpdateBudgetAsync (Ruling 3: смена бюджета открывает пороги
-/// status}]} по реестру тенантов (Ruling 3: строка лимита на путь чтения заводится лениво с дефолт-бюджетом —
+/// тостов заново) и пишет аудит tenant_limit_changed (только при реальном изменении — повторный PATCH с теми же
-/// тенант без расхода виден как «дефолт, 0»). GET/PATCH /api/operator/tenants/{id}/limit — детали/смена лимита:
+/// значениями идемпотентен, аудит не дублируется). Отрицательный бюджет/чужой период отсекаются 400 до вызова
-/// PATCH принимает {budget?, period?} (оба опциональны — меняется только заданное; null-тело/без полей → 400),
+/// хранилища; тенант проверяется по реестру (404 «Тенант не найден»). Ответы деталей — единая форма
-/// сбрасывает Warned80/NotifiedExhausted через UpdateBudgetAsync (Ruling 3: смена бюджета открывает пороги
+/// (см. <see cref="BuildDetailDto"/>) — статус тенанта, флаги порогов и процент расхода.
-/// тостов заново) и пишет аудит tenant_limit_changed (только при реальном изменении — повторный PATCH с теми же
+/// </remarks>
-/// значениями идемпотентен, аудит не дублируется). Отрицательный бюджет/чужой период отсекаются 400 до вызова
+public static class OperatorLimitsEndpoints
-/// хранилища; тенант проверяется по реестру (404 «Тенант не найден»). Ответы деталей — единая форма
+{
-/// (см. <see cref="BuildDetailDto"/>) — статус тенанта, флаги порогов и процент расхода.
+    // Текст 400: PATCH без полей (null-тело/пустой объект).
-/// </remarks>
+    private const string EmptyUpdateDetail = "Укажите новый бюджет или период";
-public static class OperatorLimitsEndpoints
+
-{
+    // Текст 400: бюджет отрицательный (порог лимита не позволяет).
-    // Текст 400: PATCH без полей (null-тело/пустой объект).
+    private const string NegativeBudgetDetail = "Бюджет должен быть неотрицательным";
-    private const string EmptyUpdateDetail = "Укажите новый бюджет или период";
+
-
+    // Текст 400: период не month и не day (константы TenantLimitPeriods).
-    // Текст 400: бюджет отрицательный (порог лимита не позволяет).
+    private const string InvalidPeriodDetail = "Период должен быть month или day";
-    private const string NegativeBudgetDetail = "Бюджет должен быть неотрицательным";
+
-
+    // Текст 404: тенант с таким id не найден в реестре.
-    // Текст 400: период не month и не day (константы TenantLimitPeriods).
+    private const string TenantNotFoundDetail = "Тенант не найден";
-    private const string InvalidPeriodDetail = "Период должен быть month или day";
+
-
+    // Верхняя граница процента расхода (диапазон 0..100) — константа расчёта CalculatePercent.
-    // Текст 404: тенант с таким id не найден в реестре.
+    private const int PercentMax = 100;
-    private const string TenantNotFoundDetail = "Тенант не найден";
+
-
+    // Префикс сводки лимитов (Ruling 11: /api/operator/*).
-    // Верхняя граница процента расхода (диапазон 0..100) — константа расчёта CalculatePercent.
+    private const string OperatorGroupPrefix = "/api/operator";
-    private const int PercentMax = 100;
+
-
+    // Префикс группы операторских ручек тенантов (общий с Task 7).
-    // Префикс сводки лимитов (Ruling 11: /api/operator/*).
+    private const string TenantsGroupPrefix = "/api/operator/tenants";
-    private const string OperatorGroupPrefix = "/api/operator";
+
-
+    // Путь сводки лимитов по всем тенантам.
-    // Префикс группы операторских ручек тенантов (общий с Task 7).
+    private const string SummaryPath = "/limits";
-    private const string TenantsGroupPrefix = "/api/operator/tenants";
+
-
+    // Относительный путь лимита тенанта (просмотр/смена).
-    // Путь сводки лимитов по всем тенантам.
+    private const string TenantLimitPath = "/{id:guid}/limit";
-    private const string SummaryPath = "/limits";
+
-
+    // OpenAPI-тег группы сводки лимитов.
-    // Относительный путь лимита тенанта (просмотр/смена).
+    private const string LimitsOpenApiTag = "operator-limits";
-    private const string TenantLimitPath = "/{id:guid}/limit";
+
-
+    // Без состояния, поэтому безопасен как статический экземпляр (период-математика Task 8).
-    // OpenAPI-тег группы сводки лимитов.
+    private static readonly TokenBudgetService BudgetService = new();
-    private const string LimitsOpenApiTag = "operator-limits";
+
-
+    /// <summary>
-    // Без состояния, поэтому безопасен как статический экземпляр (период-математика Task 8).
+    /// Регистрирует ручки лимитов: GET /api/operator/limits (сводка) и GET/PATCH
-    private static readonly TokenBudgetService BudgetService = new();
+    /// /api/operator/tenants/{id}/limit (детали/смена).
-
+    /// </summary>
-    /// <summary>
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// Регистрирует ручки лимитов: GET /api/operator/limits (сводка) и GET/PATCH
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// /api/operator/tenants/{id}/limit (детали/смена).
+    public static IEndpointRouteBuilder MapOperatorLimitsEndpoints(this IEndpointRouteBuilder app)
-    /// </summary>
+    {
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        app.MapGroup(OperatorGroupPrefix).WithTags(LimitsOpenApiTag).MapGet(SummaryPath, ListSummaryAsync);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        var tenantsGroup = app.MapGroup(TenantsGroupPrefix).WithTags(LimitsOpenApiTag);
-    public static IEndpointRouteBuilder MapOperatorLimitsEndpoints(this IEndpointRouteBuilder app)
+        tenantsGroup.MapGet(TenantLimitPath, GetLimitAsync);
-    {
+        tenantsGroup.MapPatch(TenantLimitPath, PatchLimitAsync);
-        app.MapGroup(OperatorGroupPrefix).WithTags(LimitsOpenApiTag).MapGet(SummaryPath, ListSummaryAsync);
+        return app;
-        var tenantsGroup = app.MapGroup(TenantsGroupPrefix).WithTags(LimitsOpenApiTag);
+    }
-        tenantsGroup.MapGet(TenantLimitPath, GetLimitAsync);
+
-        tenantsGroup.MapPatch(TenantLimitPath, PatchLimitAsync);
+    // GET /api/operator/limits: сводка бюджета/расхода по всем тенантам (план Task 10).
-        return app;
+    private static async Task<IResult> ListSummaryAsync(
-    }
+        HttpContext context,
-
+        ITenantRepository tenantRepository,
-    // GET /api/operator/limits: сводка бюджета/расхода по всем тенантам (план Task 10).
+        ITenantLimitStore limitStore,
-    private static async Task<IResult> ListSummaryAsync(
+        CancellationToken ct)
-        HttpContext context,
+    {
-        ITenantRepository tenantRepository,
+        var operatorIdentity = context.GetCurrentOperator();
-        ITenantLimitStore limitStore,
+        if (operatorIdentity is null)
-        CancellationToken ct)
+        {
-    {
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        var operatorIdentity = context.GetCurrentOperator();
+        }
-        if (operatorIdentity is null)
+
-        {
+        IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        var items = new List<object>(tenants.Count);
-        }
+        foreach (TenantRecordDto tenant in tenants)
-
+        {
-        IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
+            // Ленивый reset периода внутри GetStateAsync (Ruling 3): сводка всегда про текущий период.
-        var items = new List<object>(tenants.Count);
+            BudgetStateDto state = await limitStore.GetStateAsync(tenant.Id, ct);
-        foreach (TenantRecordDto tenant in tenants)
+            items.Add(new
-        {
+            {
-            // Ленивый reset периода внутри GetStateAsync (Ruling 3): сводка всегда про текущий период.
+                tenantId = tenant.Id,
-            BudgetStateDto state = await limitStore.GetStateAsync(tenant.Id, ct);
+                name = tenant.Name,
-            items.Add(new
+                budget = state.BudgetTokens,
-            {
+                period = state.Period,
-                tenantId = tenant.Id,
+                used = state.UsedTokens,
-                name = tenant.Name,
+                percent = CalculatePercent(state.UsedTokens, state.BudgetTokens),
-                budget = state.BudgetTokens,
+                status = state.Status,
-                period = state.Period,
+            });
-                used = state.UsedTokens,
+        }
-                percent = CalculatePercent(state.UsedTokens, state.BudgetTokens),
+
-                status = state.Status,
+        return Results.Ok(new { items });
-            });
+    }
-        }
+
-
+    // GET /api/operator/tenants/{id}/limit: детали лимита тенанта (форма BuildDetailDto).
-        return Results.Ok(new { items });
+    private static async Task<IResult> GetLimitAsync(
-    }
+        Guid id,
-
+        HttpContext context,
-    // GET /api/operator/tenants/{id}/limit: детали лимита тенанта (форма BuildDetailDto).
+        ITenantRepository tenantRepository,
-    private static async Task<IResult> GetLimitAsync(
+        ITenantLimitStore limitStore,
-        Guid id,
+        CancellationToken ct)
-        HttpContext context,
+    {
-        ITenantRepository tenantRepository,
+        var operatorIdentity = context.GetCurrentOperator();
-        ITenantLimitStore limitStore,
+        if (operatorIdentity is null)
-        CancellationToken ct)
+        {
-    {
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        var operatorIdentity = context.GetCurrentOperator();
+        }
-        if (operatorIdentity is null)
+
-        {
+        TenantRecordDto? tenant = await tenantRepository.FindByIdAsync(id, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        if (tenant is null)
-        }
+        {
-
+            return EndpointResults.NotFound(TenantNotFoundDetail);
-        TenantRecordDto? tenant = await tenantRepository.FindByIdAsync(id, ct);
+        }
-        if (tenant is null)
+
-        {
+        BudgetStateDto state = await limitStore.GetStateAsync(id, ct);
-            return EndpointResults.NotFound(TenantNotFoundDetail);
+        return Results.Ok(BuildDetailDto(tenant.Name, state));
-        }
+    }
-
+
-        BudgetStateDto state = await limitStore.GetStateAsync(id, ct);
+    // PATCH /api/operator/tenants/{id}/limit: смена бюджета/периода (сброс флагов + аудит tenant_limit_changed).
-        return Results.Ok(BuildDetailDto(tenant.Name, state));
+    private static async Task<IResult> PatchLimitAsync(
-    }
+        Guid id,
-
+        OperatorLimitUpdateRequest? body,
-    // PATCH /api/operator/tenants/{id}/limit: смена бюджета/периода (сброс флагов + аудит tenant_limit_changed).
+        HttpContext context,
-    private static async Task<IResult> PatchLimitAsync(
+        ITenantRepository tenantRepository,
-        Guid id,
+        ITenantLimitStore limitStore,
-        OperatorLimitUpdateRequest? body,
+        AuditService auditService,
-        HttpContext context,
+        CancellationToken ct)
-        ITenantRepository tenantRepository,
+    {
-        ITenantLimitStore limitStore,
+        var operatorIdentity = context.GetCurrentOperator();
-        AuditService auditService,
+        if (operatorIdentity is null)
-        CancellationToken ct)
+        {
-    {
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        var operatorIdentity = context.GetCurrentOperator();
+        }
-        if (operatorIdentity is null)
+
-        {
+        if (body is null || (body.Budget is null && string.IsNullOrWhiteSpace(body.Period)))
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        {
-        }
+            return EndpointResults.BadRequest(EmptyUpdateDetail);
-
+        }
-        if (body is null || (body.Budget is null && string.IsNullOrWhiteSpace(body.Period)))
+
-        {
+        if (body.Budget is < 0)
-            return EndpointResults.BadRequest(EmptyUpdateDetail);
+        {
-        }
+            return EndpointResults.BadRequest(NegativeBudgetDetail);
-
+        }
-        if (body.Budget is < 0)
+
-        {
+        if (body.Period is not null
-            return EndpointResults.BadRequest(NegativeBudgetDetail);
+            && body.Period != TenantLimitPeriods.Month
-        }
+            && body.Period != TenantLimitPeriods.Day)
-
+        {
-        if (body.Period is not null
+            return EndpointResults.BadRequest(InvalidPeriodDetail);
-            && body.Period != TenantLimitPeriods.Month
+        }
-            && body.Period != TenantLimitPeriods.Day)
+
-        {
+        TenantRecordDto? tenant = await tenantRepository.FindByIdAsync(id, ct);
-            return EndpointResults.BadRequest(InvalidPeriodDetail);
+        if (tenant is null)
-        }
+        {
-
+            return EndpointResults.NotFound(TenantNotFoundDetail);
-        TenantRecordDto? tenant = await tenantRepository.FindByIdAsync(id, ct);
+        }
-        if (tenant is null)
+
-        {
+        // Текущее состояние — источник значений не заданных в PATCH полей (период/бюджет меняются по отдельности).
-            return EndpointResults.NotFound(TenantNotFoundDetail);
+        BudgetStateDto current = await limitStore.GetStateAsync(id, ct);
-        }
+        long newBudget = body.Budget ?? current.BudgetTokens;
-
+        string newPeriod = body.Period ?? current.Period;
-        // Текущее состояние — источник значений не заданных в PATCH полей (период/бюджет меняются по отдельности).
+        if (newBudget == current.BudgetTokens && newPeriod == current.Period)
-        BudgetStateDto current = await limitStore.GetStateAsync(id, ct);
+        {
-        long newBudget = body.Budget ?? current.BudgetTokens;
+            // Идемпотентный повторный PATCH: без изменения хранилища и без дубля аудита.
-        string newPeriod = body.Period ?? current.Period;
+            return Results.Ok(BuildDetailDto(tenant.Name, current));
-        if (newBudget == current.BudgetTokens && newPeriod == current.Period)
+        }
-        {
+
-            // Идемпотентный повторный PATCH: без изменения хранилища и без дубля аудита.
+        BudgetStateDto updated = await limitStore.UpdateBudgetAsync(id, newBudget, newPeriod, ct);
-            return Results.Ok(BuildDetailDto(tenant.Name, current));
+        await auditService.AppendAsync(new AuditRecordDto(
-        }
+            AuditEvents.TenantLimitChanged,
-
+            AuditActorTypes.Operator,
-        BudgetStateDto updated = await limitStore.UpdateBudgetAsync(id, newBudget, newPeriod, ct);
+            ActorId: operatorIdentity.OperatorId,
-        await auditService.AppendAsync(new AuditRecordDto(
+            TenantId: id,
-            AuditEvents.TenantLimitChanged,
+            Ip: ClientIp(context),
-            AuditActorTypes.Operator,
+            DetailJson: AuditService.ToDetailJson(new
-            ActorId: operatorIdentity.OperatorId,
+            {
-            TenantId: id,
+                tenantId = id,
-            Ip: ClientIp(context),
+                oldBudget = current.BudgetTokens,
-            DetailJson: AuditService.ToDetailJson(new
+                oldPeriod = current.Period,
-            {
+                budgetTokens = newBudget,
-                tenantId = id,
+                period = newPeriod,
-                oldBudget = current.BudgetTokens,
+            })), ct);
-                oldPeriod = current.Period,
+
-                budgetTokens = newBudget,
+        return Results.Ok(BuildDetailDto(tenant.Name, updated));
-                period = newPeriod,
+    }
-            })), ct);
+
-
+    /// <summary>
-        return Results.Ok(BuildDetailDto(tenant.Name, updated));
+    /// Процент расхода бюджета для операторской сводки/деталей (0..100, floor).
-    }
+    /// </summary>
-
+    /// <remarks>
-    /// <summary>
+    /// Бюджет ≤0 трактуется как исчерпанный (лимит 0 запрещает ИИ, Ruling 3) → 100%; расход ≥ бюджета также
-    /// Процент расхода бюджета для операторской сводки/деталей (0..100, floor).
+    /// показывается как 100 (потолок индикатора). Расчёт — в double: диапазон long (до ~9.2·10¹⁸ токенов)
-    /// </summary>
+    /// не переполняет double, floor-ошибка возможна только на границе целого при масштабах, нереальных для
-    /// <remarks>
+    /// бюджета токенов (целочисленный used·100/budget переполнялся бы при used &gt; ~9.2·10¹⁶).
-    /// Бюджет ≤0 трактуется как исчерпанный (лимит 0 запрещает ИИ, Ruling 3) → 100%; расход ≥ бюджета также
+    /// </remarks>
-    /// показывается как 100 (потолок индикатора). Расчёт — в double: диапазон long (до ~9.2·10¹⁸ токенов)
+    /// <param name="usedTokens">Использовано токенов с начала периода.</param>
-    /// не переполняет double, floor-ошибка возможна только на границе целого при масштабах, нереальных для
+    /// <param name="budgetTokens">Бюджет периода.</param>
-    /// бюджета токенов (целочисленный used·100/budget переполнялся бы при used &gt; ~9.2·10¹⁶).
+    /// <returns>Процент в диапазоне 0..100 (расход сверх бюджета показывается как 100).</returns>
-    /// </remarks>
+    public static int CalculatePercent(long usedTokens, long budgetTokens)
-    /// <param name="usedTokens">Использовано токенов с начала периода.</param>
+    {
-    /// <param name="budgetTokens">Бюджет периода.</param>
+        if (budgetTokens <= 0 || usedTokens >= budgetTokens)
-    /// <returns>Процент в диапазоне 0..100 (расход сверх бюджета показывается как 100).</returns>
+        {
-    public static int CalculatePercent(long usedTokens, long budgetTokens)
+            return PercentMax;
-    {
+        }
-        if (budgetTokens <= 0 || usedTokens >= budgetTokens)
+
-        {
+        return (int)(usedTokens * (double)PercentMax / budgetTokens);
-            return PercentMax;
+    }
-        }
+
-
+    // Форма деталей лимита тенанта (GET и ответ PATCH — единая).
-        return (int)(usedTokens * (double)PercentMax / budgetTokens);
+    // name: Имя тенанта (реестр).
-    }
+    // state: Состояние бюджета (после ленивого reset).
-
+    // Возвращает: Объект ответа: лимит + расход + флаги порогов + статус тенанта.
-    // Форма деталей лимита тенанта (GET и ответ PATCH — единая).
+    private static object BuildDetailDto(string name, BudgetStateDto state) => new
-    // name: Имя тенанта (реестр).
+    {
-    // state: Состояние бюджета (после ленивого reset).
+        tenantId = state.TenantId,
-    // Возвращает: Объект ответа: лимит + расход + флаги порогов + статус тенанта.
+        name,
-    private static object BuildDetailDto(string name, BudgetStateDto state) => new
+        status = state.Status,
-    {
+        allowed = state.Allowed,
-        tenantId = state.TenantId,
+        budget = state.BudgetTokens,
-        name,
+        period = state.Period,
-        status = state.Status,
+        periodStart = state.PeriodStart,
-        allowed = state.Allowed,
+        used = state.UsedTokens,
-        budget = state.BudgetTokens,
+        remaining = BudgetService.RemainingTokens(state.UsedTokens, state.BudgetTokens),
-        period = state.Period,
+        percent = CalculatePercent(state.UsedTokens, state.BudgetTokens),
-        periodStart = state.PeriodStart,
+        warned80 = state.Warned80,
-        used = state.UsedTokens,
+        notifiedExhausted = state.NotifiedExhausted,
-        remaining = BudgetService.RemainingTokens(state.UsedTokens, state.BudgetTokens),
+    };
-        percent = CalculatePercent(state.UsedTokens, state.BudgetTokens),
+
-        warned80 = state.Warned80,
+    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-        notifiedExhausted = state.NotifiedExhausted,
+    // context: Контекст запроса.
-    };
+    // Возвращает: Строковое представление IP или null.
-
+    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-    // IP-адрес клиента для аудита (без порта; null, если недоступен).
+}
-    // context: Контекст запроса.
-    // Возвращает: Строковое представление IP или null.
-    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-}

src/core/Deal.Api/Endpoints/OperatorMaintenanceEndpoints.cs

@@ -1,67 +1,65 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Infrastructure.Tenancy;
-using Deal.Infrastructure.Tenancy;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Endpoints;
-
+
-namespace Deal.Api.Endpoints;
+/// <summary>
-
+/// Операторские maintenance-ручки (этап 12, пакет C): пакетная миграция схем всех тенантов.
-/// <summary>
+/// </summary>
-/// Операторские maintenance-ручки (этап 12, пакет C): пакетная миграция схем всех тенантов.
+/// <remarks>
-/// </summary>
+/// Ручка — только оператору (401 «Требуется вход оператора» без операторской сессии).
-/// <remarks>
+/// POST /api/operator/maintenance/tenants/migrate — идемпотентно проводит провижининг/миграции схем ВСЕХ
-/// Ручка — только оператору (401 «Требуется вход оператора» без операторской сессии).
+/// тенантов реестра (CREATE SCHEMA IF NOT EXISTS + EF Migrate, применяющий только неприменённые миграции)
-/// POST /api/operator/maintenance/tenants/migrate — идемпотентно проводит провижининг/миграции схем ВСЕХ
+/// с ограниченным параллелизмом и логированием прогресса (<see cref="TenantSchemaMigrationService"/>).
-/// тенантов реестра (CREATE SCHEMA IF NOT EXISTS + EF Migrate, применяющий только неприменённые миграции)
+/// Ответ <c>{ok, total, migrated, failed, failedSchemas, durationMs}</c>; ok=false, если хотя бы одна схема
-/// с ограниченным параллелизмом и логированием прогресса (<see cref="TenantSchemaMigrationService"/>).
+/// не мигрирована (сбой одной не прерывает остальные — оператор видит список проблемных схем).
-/// Ответ <c>{ok, total, migrated, failed, failedSchemas, durationMs}</c>; ok=false, если хотя бы одна схема
+/// </remarks>
-/// не мигрирована (сбой одной не прерывает остальные — оператор видит список проблемных схем).
+public static class OperatorMaintenanceEndpoints
-/// </remarks>
+{
-public static class OperatorMaintenanceEndpoints
+    // Префикс группы операторских maintenance-ручек.
-{
+    private const string MaintenanceGroupPrefix = "/api/operator/maintenance";
-    // Префикс группы операторских maintenance-ручек.
+
-    private const string MaintenanceGroupPrefix = "/api/operator/maintenance";
+    // Относительный путь пакетной миграции схем тенантов.
-
+    private const string MigrateTenantsPath = "/tenants/migrate";
-    // Относительный путь пакетной миграции схем тенантов.
+
-    private const string MigrateTenantsPath = "/tenants/migrate";
+    // OpenAPI-тег группы.
-
+    private const string MaintenanceOpenApiTag = "operator-maintenance";
-    // OpenAPI-тег группы.
+
-    private const string MaintenanceOpenApiTag = "operator-maintenance";
+    /// <summary>
-
+    /// Регистрирует группу /api/operator/maintenance: пакетная миграция схем тенантов.
-    /// <summary>
+    /// </summary>
-    /// Регистрирует группу /api/operator/maintenance: пакетная миграция схем тенантов.
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// </summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <param name="app">Построитель маршрутов приложения.</param>
+    public static IEndpointRouteBuilder MapOperatorMaintenanceEndpoints(this IEndpointRouteBuilder app)
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+    {
-    public static IEndpointRouteBuilder MapOperatorMaintenanceEndpoints(this IEndpointRouteBuilder app)
+        app.MapGroup(MaintenanceGroupPrefix)
-    {
+            .WithTags(MaintenanceOpenApiTag)
-        app.MapGroup(MaintenanceGroupPrefix)
+            .MapPost(MigrateTenantsPath, MigrateTenantsAsync);
-            .WithTags(MaintenanceOpenApiTag)
+        return app;
-            .MapPost(MigrateTenantsPath, MigrateTenantsAsync);
+    }
-        return app;
+
-    }
+    // POST /api/operator/maintenance/tenants/migrate: миграция схем всех тенантов (сводка прогресса).
-
+    private static async Task<IResult> MigrateTenantsAsync(
-    // POST /api/operator/maintenance/tenants/migrate: миграция схем всех тенантов (сводка прогресса).
+        HttpContext context,
-    private static async Task<IResult> MigrateTenantsAsync(
+        TenantSchemaMigrationService migrationService,
-        HttpContext context,
+        CancellationToken ct)
-        TenantSchemaMigrationService migrationService,
+    {
-        CancellationToken ct)
+        var operatorIdentity = context.GetCurrentOperator();
-    {
+        if (operatorIdentity is null)
-        var operatorIdentity = context.GetCurrentOperator();
+        {
-        if (operatorIdentity is null)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+
-        }
+        TenantMigrationSummary summary = await migrationService.MigrateAllAsync(ct);
-
+        return Results.Ok(new
-        TenantMigrationSummary summary = await migrationService.MigrateAllAsync(ct);
+        {
-        return Results.Ok(new
+            ok = summary.Ok,
-        {
+            total = summary.Total,
-            ok = summary.Ok,
+            migrated = summary.Migrated,
-            total = summary.Total,
+            failed = summary.Failed,
-            migrated = summary.Migrated,
+            failedSchemas = summary.FailedSchemas,
-            failed = summary.Failed,
+            durationMs = summary.DurationMs,
-            failedSchemas = summary.FailedSchemas,
+        });
-            durationMs = summary.DurationMs,
+    }
-        });
+}
-    }
-}

src/core/Deal.Api/Endpoints/OperatorSettingsEndpoints.cs

@@ -1,160 +1,155 @@
-using Deal.Api.Endpoints.RequestModels;
+using Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Api.Telegram;
-using Deal.Api.Telegram;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+
-using Deal.Modules.Tenants.Application.Models;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+/// <summary>
-using Deal.Api.Dtos;
+/// Операторские ручки глобальных (системных) настроек: ключи приложения Telegram
-
+/// (ТЗ §4.1/§8.1).
-namespace Deal.Api.Endpoints;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// Все ручки — только под операторской сессией: без неё 401 «Требуется вход оператора». Ключи Telegram
-/// Операторские ручки глобальных (системных) настроек: ключи приложения Telegram
+/// задаёт оператор глобально (едины для всех тенантов), тенант их не видит и не задаёт.
-/// (ТЗ §4.1/§8.1).
+/// <list type="bullet">
-/// </summary>
+/// <item>GET /api/operator/settings/telegram-keys — маскированный снимок: apiId (не секрет, открыт),
-/// <remarks>
+/// apiHash (маска) и keysSet;</item>
-/// Все ручки — только под операторской сессией: без неё 401 «Требуется вход оператора». Ключи Telegram
+/// <item>PUT /api/operator/settings/telegram-keys {apiId?, apiHash?} — частичное сохранение (можно
-/// задаёт оператор глобально (едины для всех тенантов), тенант их не видит и не задаёт.
+/// передать только одно поле, второе сохраняется); валидация (api_id 5..9 цифр, api_hash непустой),
-/// <list type="bullet">
+/// шифрование секрета и аудит telegram_keys_changed (без секретов в деталях).</item>
-/// <item>GET /api/operator/settings/telegram-keys — маскированный снимок: apiId (не секрет, открыт),
+/// </list>
-/// apiHash (маска) и keysSet;</item>
+/// Ошибки — 400/401 <c>{detail}</c> (формат прототипа, Ruling 10).
-/// <item>PUT /api/operator/settings/telegram-keys {apiId?, apiHash?} — частичное сохранение (можно
+/// </remarks>
-/// передать только одно поле, второе сохраняется); валидация (api_id 5..9 цифр, api_hash непустой),
+public static class OperatorSettingsEndpoints
-/// шифрование секрета и аудит telegram_keys_changed (без секретов в деталях).</item>
+{
-/// </list>
+    // Префикс группы операторских настроек.
-/// Ошибки — 400/401 <c>{detail}</c> (формат прототипа, Ruling 10).
+    private const string SettingsGroupPrefix = "/api/operator/settings";
-/// </remarks>
+
-public static class OperatorSettingsEndpoints
+    // OpenAPI-тег группы.
-{
+    private const string SettingsOpenApiTag = "operator-settings";
-    // Префикс группы операторских настроек.
+
-    private const string SettingsGroupPrefix = "/api/operator/settings";
+    // Относительный путь глобальных ключей Telegram (GET/PUT).
-
+    private const string TelegramKeysPath = "/telegram-keys";
-    // OpenAPI-тег группы.
+
-    private const string SettingsOpenApiTag = "operator-settings";
+    // Текст 400: пустое тело PUT (ни одного поля).
-
+    private const string EmptyBodyDetail = "Укажите api_id и api_hash";
-    // Относительный путь глобальных ключей Telegram (GET/PUT).
+
-    private const string TelegramKeysPath = "/telegram-keys";
+    // Текст 400: частичное обновление, но ключей ещё нет — нужны оба поля.
-
+    private const string MissingKeysDetail = "Ключи ещё не заданы — укажите и api_id, и api_hash";
-    // Текст 400: пустое тело PUT (ни одного поля).
+
-    private const string EmptyBodyDetail = "Укажите api_id и api_hash";
+    // Текст 400: api_id не 5..9 цифр.
-
+    private const string InvalidApiIdDetail = "api_id должен состоять из 5–9 цифр";
-    // Текст 400: частичное обновление, но ключей ещё нет — нужны оба поля.
+
-    private const string MissingKeysDetail = "Ключи ещё не заданы — укажите и api_id, и api_hash";
+    // Текст 400: api_hash пустой/маска/с префиксом enc:.
-
+    private const string InvalidApiHashDetail = "Укажите непустой api_hash";
-    // Текст 400: api_id не 5..9 цифр.
+
-    private const string InvalidApiIdDetail = "api_id должен состоять из 5–9 цифр";
+    /// <summary>
-
+    /// Регистрирует группу /api/operator/settings: telegram-keys (GET/PUT).
-    // Текст 400: api_hash пустой/маска/с префиксом enc:.
+    /// </summary>
-    private const string InvalidApiHashDetail = "Укажите непустой api_hash";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <summary>
+    public static IEndpointRouteBuilder MapOperatorSettingsEndpoints(this IEndpointRouteBuilder app)
-    /// Регистрирует группу /api/operator/settings: telegram-keys (GET/PUT).
+    {
-    /// </summary>
+        var group = app.MapGroup(SettingsGroupPrefix).WithTags(SettingsOpenApiTag);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        group.MapGet(TelegramKeysPath, GetTelegramKeysAsync);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        group.MapPut(TelegramKeysPath, PutTelegramKeysAsync);
-    public static IEndpointRouteBuilder MapOperatorSettingsEndpoints(this IEndpointRouteBuilder app)
+        return app;
-    {
+    }
-        var group = app.MapGroup(SettingsGroupPrefix).WithTags(SettingsOpenApiTag);
+
-        group.MapGet(TelegramKeysPath, GetTelegramKeysAsync);
+    // GET /api/operator/settings/telegram-keys: маскированные глобальные ключи Telegram.
-        group.MapPut(TelegramKeysPath, PutTelegramKeysAsync);
+    // context: Контекст запроса.
-        return app;
+    // keys: Сервис глобальных ключей Telegram (scoped).
-    }
+    // ct: Токен отмены.
-
+    // Возвращает: 200 маскированный снимок или 401 без операторской сессии.
-    // GET /api/operator/settings/telegram-keys: маскированные глобальные ключи Telegram.
+    private static async Task<IResult> GetTelegramKeysAsync(
-    // context: Контекст запроса.
+        HttpContext context,
-    // keys: Сервис глобальных ключей Telegram (scoped).
+        TelegramKeysService keys,
-    // ct: Токен отмены.
+        CancellationToken ct)
-    // Возвращает: 200 маскированный снимок или 401 без операторской сессии.
+    {
-    private static async Task<IResult> GetTelegramKeysAsync(
+        if (context.GetCurrentOperator() is null)
-        HttpContext context,
+        {
-        TelegramKeysService keys,
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-        CancellationToken ct)
+        }
-    {
+
-        if (context.GetCurrentOperator() is null)
+        TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
-        {
+        return Results.Ok(snapshot);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+    }
-        }
+
-
+    // PUT /api/operator/settings/telegram-keys: частичное сохранение глобальных ключей Telegram
-        TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
+    // оператором.
-        return Results.Ok(snapshot);
+    // Поля можно передавать по отдельности: непереданное поле (null) сохраняет текущее значение,
-    }
+    // явное значение (в т.ч. пустая строка) валидируется. Если ключей ещё нет, оба поля обязательны.
-
+    // body: Тело {apiId?, apiHash?} (хотя бы одно поле).
-    // PUT /api/operator/settings/telegram-keys: частичное сохранение глобальных ключей Telegram
+    // context: Контекст запроса.
-    // оператором.
+    // keys: Сервис глобальных ключей Telegram (scoped).
-    // Поля можно передавать по отдельности: непереданное поле (null) сохраняет текущее значение,
+    // auditService: Сервис аудита (событие telegram_keys_changed).
-    // явное значение (в т.ч. пустая строка) валидируется. Если ключей ещё нет, оба поля обязательны.
+    // ct: Токен отмены.
-    // body: Тело {apiId?, apiHash?} (хотя бы одно поле).
+    // Возвращает: 200 маскированный снимок, 400 при невалидных/недостающих полях или 401 без операторской сессии.
-    // context: Контекст запроса.
+    private static async Task<IResult> PutTelegramKeysAsync(
-    // keys: Сервис глобальных ключей Telegram (scoped).
+        OperatorTelegramKeysRequest? body,
-    // auditService: Сервис аудита (событие telegram_keys_changed).
+        HttpContext context,
-    // ct: Токен отмены.
+        TelegramKeysService keys,
-    // Возвращает: 200 маскированный снимок, 400 при невалидных/недостающих полях или 401 без операторской сессии.
+        AuditService auditService,
-    private static async Task<IResult> PutTelegramKeysAsync(
+        CancellationToken ct)
-        OperatorTelegramKeysRequest? body,
+    {
-        HttpContext context,
+        var operatorIdentity = context.GetCurrentOperator();
-        TelegramKeysService keys,
+        if (operatorIdentity is null)
-        AuditService auditService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        if (body is null)
-        {
+        {
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+            return EndpointResults.BadRequest(EmptyBodyDetail);
-        }
+        }
-
+
-        if (body is null)
+        // null — поле не передано (сохраняем текущее); непустая строка/плейсхолдер — валидируем явно.
-        {
+        string? apiId = body.ApiId?.Trim();
-            return EndpointResults.BadRequest(EmptyBodyDetail);
+        string? apiHash = body.ApiHash?.Trim();
-        }
+        if (apiId is null && apiHash is null)
-
+        {
-        // null — поле не передано (сохраняем текущее); непустая строка/плейсхолдер — валидируем явно.
+            return EndpointResults.BadRequest(EmptyBodyDetail);
-        string? apiId = body.ApiId?.Trim();
+        }
-        string? apiHash = body.ApiHash?.Trim();
+
-        if (apiId is null && apiHash is null)
+        if (apiId is not null && !TelegramKeysService.IsValidApiId(apiId))
-        {
+        {
-            return EndpointResults.BadRequest(EmptyBodyDetail);
+            return EndpointResults.BadRequest(InvalidApiIdDetail);
-        }
+        }
-
+
-        if (apiId is not null && !TelegramKeysService.IsValidApiId(apiId))
+        if (apiHash is not null && !TelegramKeysService.IsValidApiHash(apiHash))
-        {
+        {
-            return EndpointResults.BadRequest(InvalidApiIdDetail);
+            return EndpointResults.BadRequest(InvalidApiHashDetail);
-        }
+        }
-
+
-        if (apiHash is not null && !TelegramKeysService.IsValidApiHash(apiHash))
+        // Частичное обновление: недостающее поле берём из текущих ключей; если ключей ещё нет — нужны оба.
-        {
+        TgKeysSnapshot current = await keys.GetAsync(ct);
-            return EndpointResults.BadRequest(InvalidApiHashDetail);
+        string effectiveApiId = apiId ?? current.ApiId;
-        }
+        string effectiveApiHash = apiHash ?? current.ApiHash;
-
+        if (effectiveApiId.Length == 0 || effectiveApiHash.Length == 0)
-        // Частичное обновление: недостающее поле берём из текущих ключей; если ключей ещё нет — нужны оба.
+        {
-        TgKeysSnapshot current = await keys.GetAsync(ct);
+            return EndpointResults.BadRequest(MissingKeysDetail);
-        string effectiveApiId = apiId ?? current.ApiId;
+        }
-        string effectiveApiHash = apiHash ?? current.ApiHash;
+
-        if (effectiveApiId.Length == 0 || effectiveApiHash.Length == 0)
+        await keys.SaveAsync(effectiveApiId, effectiveApiHash, ct);
-        {
+
-            return EndpointResults.BadRequest(MissingKeysDetail);
+        // Аудит смены глобальных ключей: apiId — не секрет, apiHash в детали не пишется (Ruling 4).
-        }
+        await auditService.AppendAsync(new AuditRecordDto(
-
+            AuditEvents.TelegramKeysChanged,
-        await keys.SaveAsync(effectiveApiId, effectiveApiHash, ct);
+            AuditActorTypes.Operator,
-
+            ActorId: operatorIdentity.OperatorId,
-        // Аудит смены глобальных ключей: apiId — не секрет, apiHash в детали не пишется (Ruling 4).
+            TenantId: null,
-        await auditService.AppendAsync(new AuditRecordDto(
+            Ip: ClientIp(context),
-            AuditEvents.TelegramKeysChanged,
+            DetailJson: AuditService.ToDetailJson(new { apiId = effectiveApiId, apiHashSet = true })), ct);
-            AuditActorTypes.Operator,
+
-            ActorId: operatorIdentity.OperatorId,
+        TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
-            TenantId: null,
+        return Results.Ok(snapshot);
-            Ip: ClientIp(context),
+    }
-            DetailJson: AuditService.ToDetailJson(new { apiId = effectiveApiId, apiHashSet = true })), ct);
+
-
+    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-        TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
+    // context: Контекст запроса.
-        return Results.Ok(snapshot);
+    // Возвращает: Строковое представление IP или null.
-    }
+    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-
+}
-    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-    // context: Контекст запроса.
-    // Возвращает: Строковое представление IP или null.
-    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-}

src/core/Deal.Api/Endpoints/OperatorTenantCreateRequest.cs

@@ -1,12 +1,9 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/operator/tenants: создание тенанта оператором (план Task 7, Ruling 11).
-
+/// </summary>
-/// <summary>
+/// <param name="Name">Имя тенанта (обязательно; пробелы по краям обрезаются).</param>
-/// Тело POST /api/operator/tenants: создание тенанта оператором (план Task 7, Ruling 11).
+/// <param name="Email">Email владельца (опционально): создаёт сразу пользователя-владельца с одноразовым
-/// </summary>
+/// паролем (иначе владелец заводится инвайтом, Ruling 2).</param>
-/// <param name="Name">Имя тенанта (обязательно; пробелы по краям обрезаются).</param>
+public sealed record OperatorTenantCreateRequest(string? Name, string? Email);
-/// <param name="Email">Email владельца (опционально): создаёт сразу пользователя-владельца с одноразовым
-/// паролем (иначе владелец заводится инвайтом, Ruling 2).</param>
-public sealed record OperatorTenantCreateRequest(string? Name, string? Email);

src/core/Deal.Api/Endpoints/OperatorTenantImpersonateRequest.cs

@@ -1,11 +1,8 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints;
+/// Тело POST /api/operator/tenants/{id}/impersonate: опциональный логин пользователя тенанта (план Task 7).
-
+/// </summary>
-/// <summary>
+/// <param name="Login">Логин пользователя, под которым оператор входит (impersonation); null/пустой —
-/// Тело POST /api/operator/tenants/{id}/impersonate: опциональный логин пользователя тенанта (план Task 7).
+/// берётся первый пользователь тенанта (по времени создания).</param>
-/// </summary>
+public sealed record OperatorTenantImpersonateRequest(string? Login);
-/// <param name="Login">Логин пользователя, под которым оператор входит (impersonation); null/пустой —
-/// берётся первый пользователь тенанта (по времени создания).</param>
-public sealed record OperatorTenantImpersonateRequest(string? Login);

src/core/Deal.Api/Endpoints/OperatorTenantsEndpoints.cs

@@ -1,296 +1,291 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+using Microsoft.Extensions.Options;
-using Deal.Modules.Tenants.Application.Models;
+using CookieOptions = Deal.Api.Configuration.CookieOptions;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+namespace Deal.Api.Endpoints;
-using Microsoft.Extensions.Options;
+
-using Deal.Api.Dtos;
+/// <summary>
-using CookieOptions = Deal.Api.Configuration.CookieOptions;
+/// Операторские эндпоинты тенантов: create/список/детали, suspend/unsuspend, impersonation (план Task 7, Ruling 1/4/10/11).
-
+/// </summary>
-namespace Deal.Api.Endpoints;
+/// <remarks>
-
+/// Все ручки — только оператору: без операторской сессии 401 «Требуется вход оператора» (как остальные
-/// <summary>
+/// /api/operator/*). POST "" (create {name, email?}) — тенант (Status active) + провижининг схемы + аудит
-/// Операторские эндпоинты тенантов: create/список/детали, suspend/unsuspend, impersonation (план Task 7, Ruling 1/4/10/11).
+/// tenant_created; список — {items:[...]} (реестр + счётчик пользователей; поля лимитов добавит Task 8),
-/// </summary>
+/// детали — {id,name,status,createdAt,users:[...]}. Suspend/unsuspend меняют Status тенанта
-/// <remarks>
+/// (TenantAdminService) и пишут аудит tenant_status_changed (только при реальном изменении — повторный
-/// Все ручки — только оператору: без операторской сессии 401 «Требуется вход оператора» (как остальные
+/// suspend идемпотентен). Impersonation выпускает tenant-сессию целевого пользователя
-/// /api/operator/*). POST "" (create {name, email?}) — тенант (Status active) + провижининг схемы + аудит
+/// (AuthService, механизм обычного входа; пароль не меняется) и возвращает {sessionToken, expiresAt,
-/// tenant_created; список — {items:[...]} (реестр + счётчик пользователей; поля лимитов добавит Task 8),
+/// tenantId, login} — токен используется как значение куки deal_session; аудит impersonation_started
-/// детали — {id,name,status,createdAt,users:[...]}. Suspend/unsuspend меняют Status тенанта
+/// (DetailJson: targetLogin, tenantId), завершение — logout'ом пользователя (impersonation_stopped в
-/// (TenantAdminService) и пишут аудит tenant_status_changed (только при реальном изменении — повторный
+/// AuthEndpoints). Зафиксированные решения Task 7: suspend-гейт отвечает 403 (не 401; см. AuthEndpoints),
-/// suspend идемпотентен). Impersonation выпускает tenant-сессию целевого пользователя
+/// impersonation suspended-тенанта разрешён (аудируется; ИИ заморожен гейтом Task 9), PATCH {status} плана
-/// (AuthService, механизм обычного входа; пароль не меняется) и возвращает {sessionToken, expiresAt,
+/// заменён на явные POST /suspend|/unsuspend, budget? при create не принимается до Task 8/10 — отклонения
-/// tenantId, login} — токен используется как значение куки deal_session; аудит impersonation_started
+/// для api-map/техдок Task 16 зафиксированы в task-7-report.md. Тексты ошибок — фиксированные строки
-/// (DetailJson: targetLogin, tenantId), завершение — logout'ом пользователя (impersonation_stopped в
+/// HTTP-слоя (паттерн OperatorInvitesEndpoints).
-/// AuthEndpoints). Зафиксированные решения Task 7: suspend-гейт отвечает 403 (не 401; см. AuthEndpoints),
+/// </remarks>
-/// impersonation suspended-тенанта разрешён (аудируется; ИИ заморожен гейтом Task 9), PATCH {status} плана
+public static class OperatorTenantsEndpoints
-/// заменён на явные POST /suspend|/unsuspend, budget? при create не принимается до Task 8/10 — отклонения
+{
-/// для api-map/техдок Task 16 зафиксированы в task-7-report.md. Тексты ошибок — фиксированные строки
+    // Текст 400: имя тенанта пустое/пробельное (create).
-/// HTTP-слоя (паттерн OperatorInvitesEndpoints).
+    private const string TenantNameRequiredDetail = "Имя тенанта обязательно";
-/// </remarks>
+
-public static class OperatorTenantsEndpoints
+    // Текст 400: email пустой/некорректного формата (create с владельцем).
-{
+    private const string InvalidEmailDetail = "Некорректный email";
-    // Текст 400: имя тенанта пустое/пробельное (create).
+
-    private const string TenantNameRequiredDetail = "Имя тенанта обязательно";
+    // Текст 400: пользователь с таким email уже зарегистрирован (users.login unique, create с владельцем).
-
+    private const string EmailTakenDetail = "Этот email уже зарегистрирован";
-    // Текст 400: email пустой/некорректного формата (create с владельцем).
+
-    private const string InvalidEmailDetail = "Некорректный email";
+    // Текст 404: тенант с таким id не найден.
-
+    private const string TenantNotFoundDetail = "Тенант не найден";
-    // Текст 400: пользователь с таким email уже зарегистрирован (users.login unique, create с владельцем).
+
-    private const string EmailTakenDetail = "Этот email уже зарегистрирован";
+    // Текст 404: пользователь с таким login не найден в тенанте.
-
+    private const string UserNotFoundInTenantDetail = "Пользователь не найден в тенанте";
-    // Текст 404: тенант с таким id не найден.
+
-    private const string TenantNotFoundDetail = "Тенант не найден";
+    // Текст 400: в тенанте нет пользователей, а login не указан (impersonation без выбора).
-
+    private const string TenantHasNoUsersDetail = "В тенанте нет пользователей для входа";
-    // Текст 404: пользователь с таким login не найден в тенанте.
+
-    private const string UserNotFoundInTenantDetail = "Пользователь не найден в тенанте";
+    // Префикс группы операторских ручек тенантов (Ruling 11).
-
+    private const string TenantsGroupPrefix = "/api/operator/tenants";
-    // Текст 400: в тенанте нет пользователей, а login не указан (impersonation без выбора).
+
-    private const string TenantHasNoUsersDetail = "В тенанте нет пользователей для входа";
+    // Относительный путь деталей тенанта.
-
+    private const string TenantByIdPath = "/{id:guid}";
-    // Префикс группы операторских ручек тенантов (Ruling 11).
+
-    private const string TenantsGroupPrefix = "/api/operator/tenants";
+    // Относительный путь приостановки тенанта.
-
+    private const string SuspendPath = "/{id:guid}/suspend";
-    // Относительный путь деталей тенанта.
+
-    private const string TenantByIdPath = "/{id:guid}";
+    // Относительный путь возобновления тенанта.
-
+    private const string UnsuspendPath = "/{id:guid}/unsuspend";
-    // Относительный путь приостановки тенанта.
+
-    private const string SuspendPath = "/{id:guid}/suspend";
+    // Относительный путь impersonation пользователя тенанта.
-
+    private const string ImpersonatePath = "/{id:guid}/impersonate";
-    // Относительный путь возобновления тенанта.
+
-    private const string UnsuspendPath = "/{id:guid}/unsuspend";
+    // OpenAPI-тег группы.
-
+    private const string TenantsOpenApiTag = "operator-tenants";
-    // Относительный путь impersonation пользователя тенанта.
+
-    private const string ImpersonatePath = "/{id:guid}/impersonate";
+    /// <summary>
-
+    /// Регистрирует группу /api/operator/tenants: список, create, детали, suspend/unsuspend, impersonate.
-    // OpenAPI-тег группы.
+    /// </summary>
-    private const string TenantsOpenApiTag = "operator-tenants";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <summary>
+    public static IEndpointRouteBuilder MapOperatorTenantsEndpoints(this IEndpointRouteBuilder app)
-    /// Регистрирует группу /api/operator/tenants: список, create, детали, suspend/unsuspend, impersonate.
+    {
-    /// </summary>
+        var group = app.MapGroup(TenantsGroupPrefix).WithTags(TenantsOpenApiTag);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        group.MapGet("", ListAsync);
-    public static IEndpointRouteBuilder MapOperatorTenantsEndpoints(this IEndpointRouteBuilder app)
+        group.MapPost("", CreateAsync);
-    {
+        group.MapGet(TenantByIdPath, GetByIdAsync);
-        var group = app.MapGroup(TenantsGroupPrefix).WithTags(TenantsOpenApiTag);
+        group.MapPost(SuspendPath, SuspendAsync);
-
+        group.MapPost(UnsuspendPath, UnsuspendAsync);
-        group.MapGet("", ListAsync);
+        group.MapPost(ImpersonatePath, ImpersonateAsync);
-        group.MapPost("", CreateAsync);
+
-        group.MapGet(TenantByIdPath, GetByIdAsync);
+        return app;
-        group.MapPost(SuspendPath, SuspendAsync);
+    }
-        group.MapPost(UnsuspendPath, UnsuspendAsync);
+
-        group.MapPost(ImpersonatePath, ImpersonateAsync);
+    // GET /api/operator/tenants: список тенантов со счётчиками пользователей (план Task 7).
-
+    private static async Task<IResult> ListAsync(
-        return app;
+        HttpContext context,
-    }
+        TenantAdminService tenantAdminService,
-
+        CancellationToken ct)
-    // GET /api/operator/tenants: список тенантов со счётчиками пользователей (план Task 7).
+    {
-    private static async Task<IResult> ListAsync(
+        var operatorIdentity = context.GetCurrentOperator();
-        HttpContext context,
+        if (operatorIdentity is null)
-        TenantAdminService tenantAdminService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        IReadOnlyList<TenantListItemDto> items = await tenantAdminService.ListAsync(ct);
-        {
+        return Results.Ok(new { items });
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+    }
-        }
+
-
+    // POST /api/operator/tenants: создание тенанта (Status active + провижининг схемы); аудит tenant_created.
-        IReadOnlyList<TenantListItemDto> items = await tenantAdminService.ListAsync(ct);
+    // Решение Task 7: PATCH {status} заменён на явные POST /suspend и /unsuspend — create принимает только
-        return Results.Ok(new { items });
+    // {name, email?}; budget?/лимиты — зона Task 8/10 (прецедент: join-строка лимитов отложена в Task 6).
-    }
+    private static async Task<IResult> CreateAsync(
-
+        OperatorTenantCreateRequest body,
-    // POST /api/operator/tenants: создание тенанта (Status active + провижининг схемы); аудит tenant_created.
+        HttpContext context,
-    // Решение Task 7: PATCH {status} заменён на явные POST /suspend и /unsuspend — create принимает только
+        TenantAdminService tenantAdminService,
-    // {name, email?}; budget?/лимиты — зона Task 8/10 (прецедент: join-строка лимитов отложена в Task 6).
+        AuditService auditService,
-    private static async Task<IResult> CreateAsync(
+        CancellationToken ct)
-        OperatorTenantCreateRequest body,
+    {
-        HttpContext context,
+        var operatorIdentity = context.GetCurrentOperator();
-        TenantAdminService tenantAdminService,
+        if (operatorIdentity is null)
-        AuditService auditService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        TenantCreateResultDto result = await tenantAdminService.CreateAsync(body.Name, body.Email, ct);
-        {
+        if (!result.Ok || result.Tenant is null)
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        {
-        }
+            return result.Error switch
-
+            {
-        TenantCreateResultDto result = await tenantAdminService.CreateAsync(body.Name, body.Email, ct);
+                TenantCreateResultDto.ErrorInvalidEmail => EndpointResults.BadRequest(InvalidEmailDetail),
-        if (!result.Ok || result.Tenant is null)
+                TenantCreateResultDto.ErrorEmailTaken => EndpointResults.BadRequest(EmailTakenDetail),
-        {
+                _ => EndpointResults.BadRequest(TenantNameRequiredDetail),
-            return result.Error switch
+            };
-            {
+        }
-                TenantCreateResultDto.ErrorInvalidEmail => EndpointResults.BadRequest(InvalidEmailDetail),
+
-                TenantCreateResultDto.ErrorEmailTaken => EndpointResults.BadRequest(EmailTakenDetail),
+        // Одноразовый пароль владельца в аудит/логи не пишется (правило секретов); raw — только в ответе ниже.
-                _ => EndpointResults.BadRequest(TenantNameRequiredDetail),
+        TenantRecordDto createdTenant = result.Tenant;
-            };
+        await auditService.AppendAsync(new AuditRecordDto(
-        }
+            AuditEvents.TenantCreated,
-
+            AuditActorTypes.Operator,
-        // Одноразовый пароль владельца в аудит/логи не пишется (правило секретов); raw — только в ответе ниже.
+            ActorId: operatorIdentity.OperatorId,
-        TenantRecordDto createdTenant = result.Tenant;
+            TenantId: createdTenant.Id,
-        await auditService.AppendAsync(new AuditRecordDto(
+            Ip: ClientIp(context),
-            AuditEvents.TenantCreated,
+            DetailJson: AuditService.ToDetailJson(new { tenantId = createdTenant.Id, name = createdTenant.Name, email = result.OwnerLogin })), ct);
-            AuditActorTypes.Operator,
+
-            ActorId: operatorIdentity.OperatorId,
+        if (result.OwnerLogin is not null)
-            TenantId: createdTenant.Id,
+        {
-            Ip: ClientIp(context),
+            return Results.Ok(new
-            DetailJson: AuditService.ToDetailJson(new { tenantId = createdTenant.Id, name = createdTenant.Name, email = result.OwnerLogin })), ct);
+            {
-
+                createdTenant.Id,
-        if (result.OwnerLogin is not null)
+                createdTenant.Name,
-        {
+                createdTenant.Status,
-            return Results.Ok(new
+                createdTenant.CreatedAt,
-            {
+                ownerEmail = result.OwnerLogin,
-                createdTenant.Id,
+                initialPassword = result.InitialPassword,
-                createdTenant.Name,
+            });
-                createdTenant.Status,
+        }
-                createdTenant.CreatedAt,
+
-                ownerEmail = result.OwnerLogin,
+        return Results.Ok(new { createdTenant.Id, createdTenant.Name, createdTenant.Status, createdTenant.CreatedAt });
-                initialPassword = result.InitialPassword,
+    }
-            });
+
-        }
+    // GET /api/operator/tenants/{id}: детали тенанта и его пользователи.
-
+    private static async Task<IResult> GetByIdAsync(
-        return Results.Ok(new { createdTenant.Id, createdTenant.Name, createdTenant.Status, createdTenant.CreatedAt });
+        Guid id,
-    }
+        HttpContext context,
-
+        TenantAdminService tenantAdminService,
-    // GET /api/operator/tenants/{id}: детали тенанта и его пользователи.
+        CancellationToken ct)
-    private static async Task<IResult> GetByIdAsync(
+    {
-        Guid id,
+        var operatorIdentity = context.GetCurrentOperator();
-        HttpContext context,
+        if (operatorIdentity is null)
-        TenantAdminService tenantAdminService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        TenantDetailDto? tenant = await tenantAdminService.GetAsync(id, ct);
-        {
+        if (tenant is null)
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        {
-        }
+            return EndpointResults.NotFound(TenantNotFoundDetail);
-
+        }
-        TenantDetailDto? tenant = await tenantAdminService.GetAsync(id, ct);
+
-        if (tenant is null)
+        return Results.Ok(tenant);
-        {
+    }
-            return EndpointResults.NotFound(TenantNotFoundDetail);
+
-        }
+    // POST /api/operator/tenants/{id}/suspend: приостановка тенанта; аудит tenant_status_changed.
-
+    private static Task<IResult> SuspendAsync(
-        return Results.Ok(tenant);
+        Guid id,
-    }
+        HttpContext context,
-
+        TenantAdminService tenantAdminService,
-    // POST /api/operator/tenants/{id}/suspend: приостановка тенанта; аудит tenant_status_changed.
+        AuditService auditService,
-    private static Task<IResult> SuspendAsync(
+        CancellationToken ct) =>
-        Guid id,
+        ApplyStatusAsync(id, TenantStatuses.Suspended, context, tenantAdminService, auditService, ct);
-        HttpContext context,
+
-        TenantAdminService tenantAdminService,
+    // POST /api/operator/tenants/{id}/unsuspend: возобновление тенанта; аудит tenant_status_changed.
-        AuditService auditService,
+    private static Task<IResult> UnsuspendAsync(
-        CancellationToken ct) =>
+        Guid id,
-        ApplyStatusAsync(id, TenantStatuses.Suspended, context, tenantAdminService, auditService, ct);
+        HttpContext context,
-
+        TenantAdminService tenantAdminService,
-    // POST /api/operator/tenants/{id}/unsuspend: возобновление тенанта; аудит tenant_status_changed.
+        AuditService auditService,
-    private static Task<IResult> UnsuspendAsync(
+        CancellationToken ct) =>
-        Guid id,
+        ApplyStatusAsync(id, TenantStatuses.Active, context, tenantAdminService, auditService, ct);
-        HttpContext context,
+
-        TenantAdminService tenantAdminService,
+    // Общая логика suspend/unsuspend: проверка оператора, смена статуса, аудит при реальном изменении.
-        AuditService auditService,
+    // id: Идентификатор тенанта.
-        CancellationToken ct) =>
+    // status: Новый статус — константа TenantStatuses.
-        ApplyStatusAsync(id, TenantStatuses.Active, context, tenantAdminService, auditService, ct);
+    // context: Контекст запроса (операторская сессия, IP).
-
+    // tenantAdminService: Сервис реестра тенантов.
-    // Общая логика suspend/unsuspend: проверка оператора, смена статуса, аудит при реальном изменении.
+    // auditService: Сервис аудита (запись tenant_status_changed при изменении).
-    // id: Идентификатор тенанта.
+    // ct: Токен отмены.
-    // status: Новый статус — константа TenantStatuses.
+    // Возвращает: 200 {ok,status} или 401/404 {detail}.
-    // context: Контекст запроса (операторская сессия, IP).
+    private static async Task<IResult> ApplyStatusAsync(
-    // tenantAdminService: Сервис реестра тенантов.
+        Guid id,
-    // auditService: Сервис аудита (запись tenant_status_changed при изменении).
+        string status,
-    // ct: Токен отмены.
+        HttpContext context,
-    // Возвращает: 200 {ok,status} или 401/404 {detail}.
+        TenantAdminService tenantAdminService,
-    private static async Task<IResult> ApplyStatusAsync(
+        AuditService auditService,
-        Guid id,
+        CancellationToken ct)
-        string status,
+    {
-        HttpContext context,
+        var operatorIdentity = context.GetCurrentOperator();
-        TenantAdminService tenantAdminService,
+        if (operatorIdentity is null)
-        AuditService auditService,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        TenantStatusChangeResultDto result = await tenantAdminService.ChangeStatusAsync(id, status, ct);
-        {
+        if (!result.Ok || result.Tenant is null)
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        {
-        }
+            return EndpointResults.NotFound(TenantNotFoundDetail);
-
+        }
-        TenantStatusChangeResultDto result = await tenantAdminService.ChangeStatusAsync(id, status, ct);
+
-        if (!result.Ok || result.Tenant is null)
+        if (result.Changed)
-        {
+        {
-            return EndpointResults.NotFound(TenantNotFoundDetail);
+            await auditService.AppendAsync(new AuditRecordDto(
-        }
+                AuditEvents.TenantStatusChanged,
-
+                AuditActorTypes.Operator,
-        if (result.Changed)
+                ActorId: operatorIdentity.OperatorId,
-        {
+                TenantId: result.Tenant.Id,
-            await auditService.AppendAsync(new AuditRecordDto(
+                Ip: ClientIp(context),
-                AuditEvents.TenantStatusChanged,
+                DetailJson: AuditService.ToDetailJson(new { tenantId = result.Tenant.Id, status = result.Tenant.Status })), ct);
-                AuditActorTypes.Operator,
+        }
-                ActorId: operatorIdentity.OperatorId,
+
-                TenantId: result.Tenant.Id,
+        return Results.Ok(new { ok = true, status = result.Tenant.Status });
-                Ip: ClientIp(context),
+    }
-                DetailJson: AuditService.ToDetailJson(new { tenantId = result.Tenant.Id, status = result.Tenant.Status })), ct);
+
-        }
+    // POST /api/operator/tenants/{id}/impersonate: tenant-сессия пользователя тенанта; аудит impersonation_started.
-
+    private static async Task<IResult> ImpersonateAsync(
-        return Results.Ok(new { ok = true, status = result.Tenant.Status });
+        Guid id,
-    }
+        OperatorTenantImpersonateRequest? body,
-
+        HttpContext context,
-    // POST /api/operator/tenants/{id}/impersonate: tenant-сессия пользователя тенанта; аудит impersonation_started.
+        AuthService authService,
-    private static async Task<IResult> ImpersonateAsync(
+        AuditService auditService,
-        Guid id,
+        IOptions<CookieOptions> cookieOptions,
-        OperatorTenantImpersonateRequest? body,
+        CancellationToken ct)
-        HttpContext context,
+    {
-        AuthService authService,
+        var operatorIdentity = context.GetCurrentOperator();
-        AuditService auditService,
+        if (operatorIdentity is null)
-        IOptions<CookieOptions> cookieOptions,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
-    {
+        }
-        var operatorIdentity = context.GetCurrentOperator();
+
-        if (operatorIdentity is null)
+        ImpersonationResultDto result = await authService.ImpersonateAsync(
-        {
+            id, body?.Login, operatorIdentity.OperatorId, ct);
-            return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
+        if (!result.Ok || result.SessionToken is null || result.Login is null || result.TenantId is null)
-        }
+        {
-
+            return result.Error switch
-        ImpersonationResultDto result = await authService.ImpersonateAsync(
+            {
-            id, body?.Login, operatorIdentity.OperatorId, ct);
+                ImpersonationResultDto.ErrorTenantNotFound => EndpointResults.NotFound(TenantNotFoundDetail),
-        if (!result.Ok || result.SessionToken is null || result.Login is null || result.TenantId is null)
+                ImpersonationResultDto.ErrorUserNotFound => EndpointResults.NotFound(UserNotFoundInTenantDetail),
-        {
+                _ => EndpointResults.BadRequest(TenantHasNoUsersDetail),
-            return result.Error switch
+            };
-            {
+        }
-                ImpersonationResultDto.ErrorTenantNotFound => EndpointResults.NotFound(TenantNotFoundDetail),
+
-                ImpersonationResultDto.ErrorUserNotFound => EndpointResults.NotFound(UserNotFoundInTenantDetail),
+        await auditService.AppendAsync(new AuditRecordDto(
-                _ => EndpointResults.BadRequest(TenantHasNoUsersDetail),
+            AuditEvents.ImpersonationStarted,
-            };
+            AuditActorTypes.Operator,
-        }
+            ActorId: operatorIdentity.OperatorId,
-
+            TenantId: result.TenantId,
-        await auditService.AppendAsync(new AuditRecordDto(
+            Ip: ClientIp(context),
-            AuditEvents.ImpersonationStarted,
+            DetailJson: AuditService.ToDetailJson(new { targetLogin = result.Login, tenantId = result.TenantId })), ct);
-            AuditActorTypes.Operator,
+
-            ActorId: operatorIdentity.OperatorId,
+        // Токен — это tenant-сессия (как после /api/auth/login): СТАВИМ ту же httpOnly-куку deal_session
-            TenantId: result.TenantId,
+        // на ответ, чтобы браузер оператора сразу получил tenant-сессию (JS не может записать httpOnly-куку).
-            Ip: ClientIp(context),
+        // Завершение — POST /api/auth/logout (пишет impersonation_stopped).
-            DetailJson: AuditService.ToDetailJson(new { targetLogin = result.Login, tenantId = result.TenantId })), ct);
+        SessionCookieWriter.Append(context, cookieOptions.Value, result.SessionToken);
-
+
-        // Токен — это tenant-сессия (как после /api/auth/login): СТАВИМ ту же httpOnly-куку deal_session
+        return Results.Ok(new
-        // на ответ, чтобы браузер оператора сразу получил tenant-сессию (JS не может записать httpOnly-куку).
+        {
-        // Завершение — POST /api/auth/logout (пишет impersonation_stopped).
+            sessionToken = result.SessionToken,
-        SessionCookieWriter.Append(context, cookieOptions.Value, result.SessionToken);
+            expiresAt = result.ExpiresAt,
-
+            tenantId = result.TenantId,
-        return Results.Ok(new
+            login = result.Login,
-        {
+        });
-            sessionToken = result.SessionToken,
+    }
-            expiresAt = result.ExpiresAt,
+
-            tenantId = result.TenantId,
+    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-            login = result.Login,
+    // context: Контекст запроса.
-        });
+    // Возвращает: Строковое представление IP или null.
-    }
+    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-
+}
-    // IP-адрес клиента для аудита (без порта; null, если недоступен).
-    // context: Контекст запроса.
-    // Возвращает: Строковое представление IP или null.
-    private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
-}

src/core/Deal.Api/Endpoints/PipelineEndpoints.cs

@@ -1,190 +1,186 @@
-using Deal.Api.Endpoints.RequestModels;
+using Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Pipeline.Application.Models;
-using Deal.Modules.Pipeline.Application.Abstractions;
+using Deal.Modules.Pipeline.Application.Services;
-using Deal.Modules.Pipeline.Application.Models;
+
-using Deal.Modules.Pipeline.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Pipeline.Application.Services;
+
-using Deal.Api.Dtos;
+/// <summary>
-
+/// Эндпоинты вкладки «Обработка»: GET /api/pipeline/stats|queue|rejected, POST /api/pipeline/rejected/clear,
-namespace Deal.Api.Endpoints;
+/// DELETE /api/pipeline/rejected/{rejId}, POST /api/pipeline/rejected/{rejId}/return (план Task 9 L437–460,
-
+/// Rulings 6/10; прототип processing_routes.py L17–74).
-/// <summary>
+/// </summary>
-/// Эндпоинты вкладки «Обработка»: GET /api/pipeline/stats|queue|rejected, POST /api/pipeline/rejected/clear,
+/// <remarks>
-/// DELETE /api/pipeline/rejected/{rejId}, POST /api/pipeline/rejected/{rejId}/return (план Task 9 L437–460,
+/// Контракт 1:1 с прототипом и api-map §3.6 L178–186, §4.5: /stats → {queue:{new,ai,total}, rejected};
-/// Rulings 6/10; прототип processing_routes.py L17–74).
+/// /queue?limit= → {items, counts:{new,ai,total}, rejected} (limit ≤500, дефолт 100, фронт шлёт 120);
-/// </summary>
+/// /rejected?q=&amp;offset=&amp;limit= → {items, total, offset, limit} (q — FTS ∪ LIKE-поиск, Ruling 6);
-/// <remarks>
+/// /rejected/clear → {ok, cleared}; DELETE /rejected/{rejId} → {ok:true} всегда (delete_one L196–198, 404 не
-/// Контракт 1:1 с прототипом и api-map §3.6 L178–186, §4.5: /stats → {queue:{new,ai,total}, rejected};
+/// шлём — Ruling 10); /rejected/{rejId}/return {reason=""} → {id, returned:true, returnedAt} | 400 (строки
-/// /queue?limit= → {items, counts:{new,ai,total}, rejected} (limit ≤500, дефолт 100, фронт шлёт 120);
+/// Ruling 10) | 404 «Запись не найдена» (текст 404 — слой эндпоинтов, паттерн CardsService → LeadsEndpoints).
-/// /rejected?q=&amp;offset=&amp;limit= → {items, total, offset, limit} (q — FTS ∪ LIKE-поиск, Ruling 6);
+/// Все эндпоинты требуют сессию: 401 {detail} без куки (Ruling 10); сервисы модуля резолвятся из
-/// /rejected/clear → {ok, cleared}; DELETE /rejected/{rejId} → {ok:true} всегда (delete_one L196–198, 404 не
+/// RequestServices ПОСЛЕ проверки сессии (scoped на tenant-контекст запроса, паттерн SettingsEndpoints).
-/// шлём — Ruling 10); /rejected/{rejId}/return {reason=""} → {id, returned:true, returnedAt} | 400 (строки
+/// Статические сегменты (/stats, /queue, /rejected/clear) до параметризованного /rejected/{rejId} — порядок
-/// Ruling 10) | 404 «Запись не найдена» (текст 404 — слой эндпоинтов, паттерн CardsService → LeadsEndpoints).
+/// как в прототипе (api-map L19), хотя литералы имеют приоритет в ASP.NET Core.
-/// Все эндпоинты требуют сессию: 401 {detail} без куки (Ruling 10); сервисы модуля резолвятся из
+/// </remarks>
-/// RequestServices ПОСЛЕ проверки сессии (scoped на tenant-контекст запроса, паттерн SettingsEndpoints).
+public static class PipelineEndpoints
-/// Статические сегменты (/stats, /queue, /rejected/clear) до параметризованного /rejected/{rejId} — порядок
+{
-/// как в прототипе (api-map L19), хотя литералы имеют приоритет в ASP.NET Core.
+    // Префикс группы (роутер processing, prefix="/api/pipeline" — processing_routes.py L10).
-/// </remarks>
+    private const string PipelineGroupPrefix = "/api/pipeline";
-public static class PipelineEndpoints
+
-{
+    // OpenAPI-тег группы (в прототипе роутер processing — processing_routes.py L10).
-    // Префикс группы (роутер processing, prefix="/api/pipeline" — processing_routes.py L10).
+    private const string OpenApiTag = "processing";
-    private const string PipelineGroupPrefix = "/api/pipeline";
+
-
+    // Путь сводки вкладки «Обработка» (GET).
-    // OpenAPI-тег группы (в прототипе роутер processing — processing_routes.py L10).
+    private const string StatsPath = "/stats";
-    private const string OpenApiTag = "processing";
+
-
+    // Путь сырых сообщений очереди (GET).
-    // Путь сводки вкладки «Обработка» (GET).
+    private const string QueuePath = "/queue";
-    private const string StatsPath = "/stats";
+
-
+    // Путь страницы отсева (GET).
-    // Путь сырых сообщений очереди (GET).
+    private const string RejectedPath = "/rejected";
-    private const string QueuePath = "/queue";
+
-
+    // Путь полной очистки отсева (POST).
-    // Путь страницы отсева (GET).
+    private const string RejectedClearPath = "/rejected/clear";
-    private const string RejectedPath = "/rejected";
+
-
+    // Путь удаления одной записи отсева (DELETE).
-    // Путь полной очистки отсева (POST).
+    private const string RejectedIdPath = "/rejected/{rejId}";
-    private const string RejectedClearPath = "/rejected/clear";
+
-
+    // Путь возврата записи отсева в обработку (POST).
-    // Путь удаления одной записи отсева (DELETE).
+    private const string RejectedReturnPath = "/rejected/{rejId}/return";
-    private const string RejectedIdPath = "/rejected/{rejId}";
+
-
+    // 404 return: записи отсева нет (processing_routes.py L71: KeyError → 404, Ruling 10).
-    // Путь возврата записи отсева в обработку (POST).
+    private const string RejectedNotFoundDetail = "Запись не найдена";
-    private const string RejectedReturnPath = "/rejected/{rejId}/return";
+
-
+    // Размер страницы по умолчанию списков очереди/отсева (processing.DEFAULT_LIMIT L48; фронт шлёт 120/80).
-    // 404 return: записи отсева нет (processing_routes.py L71: KeyError → 404, Ruling 10).
+    private const int DefaultPageSize = 100;
-    private const string RejectedNotFoundDetail = "Запись не найдена";
+
-
+    /// <summary>
-    // Размер страницы по умолчанию списков очереди/отсева (processing.DEFAULT_LIMIT L48; фронт шлёт 120/80).
+    /// Регистрирует группу /api/pipeline: stats/queue/rejected/clear/{rejId}/return.
-    private const int DefaultPageSize = 100;
+    /// </summary>
-
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// <summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// Регистрирует группу /api/pipeline: stats/queue/rejected/clear/{rejId}/return.
+    public static IEndpointRouteBuilder MapPipelineEndpoints(this IEndpointRouteBuilder app)
-    /// </summary>
+    {
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        var pipeline = app.MapGroup(PipelineGroupPrefix).WithTags(OpenApiTag);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+
-    public static IEndpointRouteBuilder MapPipelineEndpoints(this IEndpointRouteBuilder app)
+        // Статические сегменты до /rejected/{rejId} (Ruling 10, api-map L19; порядок 1:1 с прототипом).
-    {
+        pipeline.MapGet(StatsPath, StatsAsync);
-        var pipeline = app.MapGroup(PipelineGroupPrefix).WithTags(OpenApiTag);
+        pipeline.MapGet(QueuePath, QueueAsync);
-
+        pipeline.MapGet(RejectedPath, RejectedAsync);
-        // Статические сегменты до /rejected/{rejId} (Ruling 10, api-map L19; порядок 1:1 с прототипом).
+        pipeline.MapPost(RejectedClearPath, ClearAsync);
-        pipeline.MapGet(StatsPath, StatsAsync);
+        pipeline.MapDelete(RejectedIdPath, DeleteAsync);
-        pipeline.MapGet(QueuePath, QueueAsync);
+        pipeline.MapPost(RejectedReturnPath, ReturnAsync);
-        pipeline.MapGet(RejectedPath, RejectedAsync);
+
-        pipeline.MapPost(RejectedClearPath, ClearAsync);
+        return app;
-        pipeline.MapDelete(RejectedIdPath, DeleteAsync);
+    }
-        pipeline.MapPost(RejectedReturnPath, ReturnAsync);
+
-
+    // GET /api/pipeline/stats: сводка вкладки {queue:{new,ai,total}, rejected} (processing_routes.py L17–20, stats L315–320).
-        return app;
+    private static async Task<IResult> StatsAsync(HttpContext context, CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // GET /api/pipeline/stats: сводка вкладки {queue:{new,ai,total}, rejected} (processing_routes.py L17–20, stats L315–320).
+        {
-    private static async Task<IResult> StatsAsync(HttpContext context, CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        return Results.Ok(await processing.StatsAsync(ct));
-        }
+    }
-
+
-        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
+    // GET /api/pipeline/queue?limit=: сырые сообщения очереди + счётчики + число отсева (processing_routes.py L23–31).
-        return Results.Ok(await processing.StatsAsync(ct));
+    // Ответ {items, counts:{new,ai,total}, rejected} 1:1 с list_queue L218–241 + queue_counts L207–215 +
-    }
+    // rejected_count L201–202. limit — дефолт 100, clamp 1..500 делает сервис (ListQueueAsync).
-
+    private static async Task<IResult> QueueAsync(
-    // GET /api/pipeline/queue?limit=: сырые сообщения очереди + счётчики + число отсева (processing_routes.py L23–31).
+        int? limit,
-    // Ответ {items, counts:{new,ai,total}, rejected} 1:1 с list_queue L218–241 + queue_counts L207–215 +
+        HttpContext context,
-    // rejected_count L201–202. limit — дефолт 100, clamp 1..500 делает сервис (ListQueueAsync).
+        CancellationToken ct)
-    private static async Task<IResult> QueueAsync(
+    {
-        int? limit,
+        if (!context.HasUser())
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        IReadOnlyList<QueueItemDto> items = await processing.ListQueueAsync(limit ?? DefaultPageSize, ct);
-        }
+        QueueCountsDto counts = await processing.QueueCountsAsync(ct);
-
+        int rejected = await processing.RejectedCountAsync(ct);
-        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
+        return Results.Ok(new { items, counts, rejected });
-        IReadOnlyList<QueueItemDto> items = await processing.ListQueueAsync(limit ?? DefaultPageSize, ct);
+    }
-        QueueCountsDto counts = await processing.QueueCountsAsync(ct);
+
-        int rejected = await processing.RejectedCountAsync(ct);
+    // GET /api/pipeline/rejected?q=&amp;offset=&amp;limit=: страница отсева (processing_routes.py L34–42, list_rejected L246–312).
-        return Results.Ok(new { items, counts, rejected });
+    // q — поиск по тексту/причине/фразе/имени канала (FTS ∪ LIKE, Ruling 6), пустой q — весь отсев свежими
-    }
+    // первыми; offset ≥ 0, limit 1..500 (clamp в сервисе), значения эхом в ответе {items,total,offset,limit}.
-
+    private static async Task<IResult> RejectedAsync(
-    // GET /api/pipeline/rejected?q=&amp;offset=&amp;limit=: страница отсева (processing_routes.py L34–42, list_rejected L246–312).
+        string? q,
-    // q — поиск по тексту/причине/фразе/имени канала (FTS ∪ LIKE, Ruling 6), пустой q — весь отсев свежими
+        int? offset,
-    // первыми; offset ≥ 0, limit 1..500 (clamp в сервисе), значения эхом в ответе {items,total,offset,limit}.
+        int? limit,
-    private static async Task<IResult> RejectedAsync(
+        HttpContext context,
-        string? q,
+        CancellationToken ct)
-        int? offset,
+    {
-        int? limit,
+        if (!context.HasUser())
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        RejectedPageDto page = await processing.ListRejectedAsync(q ?? string.Empty, offset ?? 0, limit ?? DefaultPageSize, ct);
-        }
+        return Results.Ok(page);
-
+    }
-        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
+
-        RejectedPageDto page = await processing.ListRejectedAsync(q ?? string.Empty, offset ?? 0, limit ?? DefaultPageSize, ct);
+    // POST /api/pipeline/rejected/clear: полная безвозвратная очистка отсева (processing_routes.py L45–49, clear_all L120–125).
-        return Results.Ok(page);
+    private static async Task<IResult> ClearAsync(HttpContext context, CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // POST /api/pipeline/rejected/clear: полная безвозвратная очистка отсева (processing_routes.py L45–49, clear_all L120–125).
+        {
-    private static async Task<IResult> ClearAsync(HttpContext context, CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        int cleared = await processing.ClearAsync(ct);
-        }
+        return Results.Ok(new { ok = true, cleared });
-
+    }
-        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
+
-        int cleared = await processing.ClearAsync(ct);
+    // DELETE /api/pipeline/rejected/{rejId}: удалить запись отсева; ответ {ok:true} всегда (delete_one L196–198, Ruling 10).
-        return Results.Ok(new { ok = true, cleared });
+    // Прототип не проверяет наличие записи — 404 не шлём (план Task 9 L444; Ruling 10 «always ok»).
-    }
+    private static async Task<IResult> DeleteAsync(
-
+        string rejId,
-    // DELETE /api/pipeline/rejected/{rejId}: удалить запись отсева; ответ {ok:true} всегда (delete_one L196–198, Ruling 10).
+        HttpContext context,
-    // Прототип не проверяет наличие записи — 404 не шлём (план Task 9 L444; Ruling 10 «always ok»).
+        CancellationToken ct)
-    private static async Task<IResult> DeleteAsync(
+    {
-        string rejId,
+        if (!context.HasUser())
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        await processing.DeleteAsync(rejId, ct);
-        }
+        return Results.Ok(new { ok = true });
-
+    }
-        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
+
-        await processing.DeleteAsync(rejId, ct);
+    // POST /api/pipeline/rejected/{rejId}/return {reason=""}: вернуть отсеянное в обработку (return_to_queue L128–193).
-        return Results.Ok(new { ok = true });
+    // Успех — {id, returned:true, returnedAt} (запись помечается returned, НЕ удаляется — аудит Ruling 10);
-    }
+    // причины 400 (уже возвращено/повтор-dup/нет текста) — константы PipelineProcessingService (строки 1:1 с
-
+    // прототипом); записи нет — 404 «Запись не найдена» (текст 404 — слой эндпоинтов).
-    // POST /api/pipeline/rejected/{rejId}/return {reason=""}: вернуть отсеянное в обработку (return_to_queue L128–193).
+    private static async Task<IResult> ReturnAsync(
-    // Успех — {id, returned:true, returnedAt} (запись помечается returned, НЕ удаляется — аудит Ruling 10);
+        string rejId,
-    // причины 400 (уже возвращено/повтор-dup/нет текста) — константы PipelineProcessingService (строки 1:1 с
+        ReturnReasonRequest body,
-    // прототипом); записи нет — 404 «Запись не найдена» (текст 404 — слой эндпоинтов).
+        HttpContext context,
-    private static async Task<IResult> ReturnAsync(
+        CancellationToken ct)
-        string rejId,
+    {
-        ReturnReasonRequest body,
+        if (!context.HasUser())
-        HttpContext context,
+        {
-        CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        RejectReturnResultDto? result = await processing.ReturnAsync(rejId, body.Reason ?? string.Empty, ct);
-        }
+        if (result is null)
-
+        {
-        PipelineProcessingService processing = context.RequestServices.GetRequiredService<PipelineProcessingService>();
+            return EndpointResults.NotFound(RejectedNotFoundDetail);
-        RejectReturnResultDto? result = await processing.ReturnAsync(rejId, body.Reason ?? string.Empty, ct);
+        }
-        if (result is null)
+
-        {
+        return result.Error is not null
-            return EndpointResults.NotFound(RejectedNotFoundDetail);
+            ? EndpointResults.BadRequest(result.Error)
-        }
+            : Results.Ok(new { id = result.Id, returned = result.Returned, returnedAt = result.ReturnedAtMs });
-
+    }
-        return result.Error is not null
+}
-            ? EndpointResults.BadRequest(result.Error)
-            : Results.Ok(new { id = result.Id, returned = result.Returned, returnedAt = result.ReturnedAtMs });
-    }
-}

src/core/Deal.Api/Endpoints/RatesEndpoints.cs

@@ -1,90 +1,86 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Settings.Application.Models;
-using Deal.Modules.Settings.Application.Abstractions;
+using Deal.Modules.Settings.Application.Services;
-using Deal.Modules.Settings.Application.Models;
+
-using Deal.Modules.Settings.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Settings.Application.Services;
+
-using Deal.Api.Dtos;
+/// <summary>
-
+/// HTTP-эндпоинты курсов валют: GET /api/rates, POST /api/rates/refresh (Ruling 8, api-map §3.4 L149–150).
-namespace Deal.Api.Endpoints;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// «Только для Settings-экрана» (Ruling 8): фронт читает курсы на boot (store.js L571–581) и обновляет
-/// HTTP-эндпоинты курсов валют: GET /api/rates, POST /api/rates/refresh (Ruling 8, api-map §3.4 L149–150).
+/// по кнопке (refreshRates L1843–1848). GET — текущий кэш (ratesCache) или дефолт-мок; при протухании/
-/// </summary>
+/// смене источника/отсутствии кэша (Ruling 6) фоново запускает RefreshAsync через
-/// <remarks>
+/// <see cref="RatesRefreshScheduler"/> и отвечает текущим кэшем (план Task 8 L317–318). POST — синхронный
-/// «Только для Settings-экрана» (Ruling 8): фронт читает курсы на boot (store.js L571–581) и обновляет
+/// refresh 1:1 с прототипом: <c>{ok: bool, rates: {base, rates, source, updatedAt}}</c> (ok=false при сбое
-/// по кнопке (refreshRates L1843–1848). GET — текущий кэш (ratesCache) или дефолт-мок; при протухании/
+/// ЦБ, кэш не тронут). Оба требуют сессию: 401 {detail} (Ruling 10). Резолв scoped-зависимостей — через
-/// смене источника/отсутствии кэша (Ruling 6) фоново запускает RefreshAsync через
+/// RequestServices ПОСЛЕ проверки сессии (как SettingsEndpoints/AiCheckEndpoint: ISettingsStore требует
-/// <see cref="RatesRefreshScheduler"/> и отвечает текущим кэшем (план Task 8 L317–318). POST — синхронный
+/// tenant-контекст запроса).
-/// refresh 1:1 с прототипом: <c>{ok: bool, rates: {base, rates, source, updatedAt}}</c> (ok=false при сбое
+/// </remarks>
-/// ЦБ, кэш не тронут). Оба требуют сессию: 401 {detail} (Ruling 10). Резолв scoped-зависимостей — через
+public static class RatesEndpoints
-/// RequestServices ПОСЛЕ проверки сессии (как SettingsEndpoints/AiCheckEndpoint: ISettingsStore требует
+{
-/// tenant-контекст запроса).
+    // Префикс группы API (общий для эндпоинтов этапа, Ruling 8).
-/// </remarks>
+    private const string ApiGroupPrefix = "/api";
-public static class RatesEndpoints
+
-{
+    // Путь текущих курсов (GET).
-    // Префикс группы API (общий для эндпоинтов этапа, Ruling 8).
+    private const string RatesPath = "/rates";
-    private const string ApiGroupPrefix = "/api";
+
-
+    // Путь принудительного обновления (POST).
-    // Путь текущих курсов (GET).
+    private const string RatesRefreshPath = "/rates/refresh";
-    private const string RatesPath = "/rates";
+
-
+    // OpenAPI-тег группы (в прототипе роутер settings — settings_routes.py).
-    // Путь принудительного обновления (POST).
+    private const string OpenApiTag = "settings";
-    private const string RatesRefreshPath = "/rates/refresh";
+
-
+    /// <summary>
-    // OpenAPI-тег группы (в прототипе роутер settings — settings_routes.py).
+    /// Регистрирует GET /api/rates и POST /api/rates/refresh.
-    private const string OpenApiTag = "settings";
+    /// </summary>
-
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// <summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// Регистрирует GET /api/rates и POST /api/rates/refresh.
+    public static IEndpointRouteBuilder MapRatesEndpoints(this IEndpointRouteBuilder app)
-    /// </summary>
+    {
-    /// <param name="app">Построитель маршрутов приложения.</param>
+        var group = app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag);
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        group.MapGet(RatesPath, GetRatesAsync);
-    public static IEndpointRouteBuilder MapRatesEndpoints(this IEndpointRouteBuilder app)
+        group.MapPost(RatesRefreshPath, RefreshRatesAsync);
-    {
+        return app;
-        var group = app.MapGroup(ApiGroupPrefix).WithTags(OpenApiTag);
+    }
-        group.MapGet(RatesPath, GetRatesAsync);
+
-        group.MapPost(RatesRefreshPath, RefreshRatesAsync);
+    // GET /api/rates: текущий кэш курсов тенанта (+ ленивый фоновый refresh при необходимости).
-        return app;
+    private static async Task<IResult> GetRatesAsync(HttpContext context, CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // GET /api/rates: текущий кэш курсов тенанта (+ ленивый фоновый refresh при необходимости).
+        {
-    private static async Task<IResult> GetRatesAsync(HttpContext context, CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        // Резолв после 401-гейта: RatesService — scoped на TenantDbContext (tenant-контекст запроса).
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+        RatesService ratesService = context.RequestServices.GetRequiredService<RatesService>();
-        }
+
-
+        RatesDto current = await ratesService.GetAsync(ct);
-        // Резолв после 401-гейта: RatesService — scoped на TenantDbContext (tenant-контекст запроса).
+
-        RatesService ratesService = context.RequestServices.GetRequiredService<RatesService>();
+        // Ленивое обновление (Ruling 6, план Task 8): протухший кэш / смена источника / нет кэша —
-
+        // фоновый RefreshAsync в отдельном scope; ответ — текущий кэш.
-        RatesDto current = await ratesService.GetAsync(ct);
+        if (await ratesService.ShouldFetchAsync(ct))
-
+        {
-        // Ленивое обновление (Ruling 6, план Task 8): протухший кэш / смена источника / нет кэша —
+            context.RequestServices.GetRequiredService<RatesRefreshScheduler>().Schedule();
-        // фоновый RefreshAsync в отдельном scope; ответ — текущий кэш.
+        }
-        if (await ratesService.ShouldFetchAsync(ct))
+
-        {
+        return Results.Ok(current);
-            context.RequestServices.GetRequiredService<RatesRefreshScheduler>().Schedule();
+    }
-        }
+
-
+    // POST /api/rates/refresh: принудительное обновление; ответ {ok, rates} (1:1 settings_routes.py L229–232).
-        return Results.Ok(current);
+    private static async Task<IResult> RefreshRatesAsync(HttpContext context, CancellationToken ct)
-    }
+    {
-
+        if (!context.HasUser())
-    // POST /api/rates/refresh: принудительное обновление; ответ {ok, rates} (1:1 settings_routes.py L229–232).
+        {
-    private static async Task<IResult> RefreshRatesAsync(HttpContext context, CancellationToken ct)
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    {
+        }
-        if (!context.HasUser())
+
-        {
+        RatesService ratesService = context.RequestServices.GetRequiredService<RatesService>();
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        // Синхронно: refresh по текущей настройке rateSource; при сбое ЦБ ok=false и кэш не тронут.
-
+        bool ok = await ratesService.RefreshAsync(ct);
-        RatesService ratesService = context.RequestServices.GetRequiredService<RatesService>();
+        RatesDto current = await ratesService.GetAsync(ct);
-
+        return Results.Ok(new { ok, rates = current });
-        // Синхронно: refresh по текущей настройке rateSource; при сбое ЦБ ok=false и кэш не тронут.
+    }
-        bool ok = await ratesService.RefreshAsync(ct);
+}
-        RatesDto current = await ratesService.GetAsync(ct);
-        return Results.Ok(new { ok, rates = current });
-    }
-}

src/core/Deal.Api/Endpoints/RequestModels/CardLinkRequest.cs

@@ -1,6 +1,3 @@
-using Deal.Api.Services;
-using Deal.Api.Dtos;
-
 namespace Deal.Api.Endpoints.RequestModels;
 
 /// <summary>

src/core/Deal.Api/Endpoints/RequestModels/ClearColBody.cs

@@ -1,13 +1,10 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/cards/clear-col — полная очистка служебной колонки (dashboard_routes.py ClearColBody L224–225, api-map §3.2 L93).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/cards/clear-col — полная очистка служебной колонки (dashboard_routes.py ClearColBody L224–225, api-map §3.2 L93).
+/// Wire-имя — camelCase: col — "trash" | "archive" (другие колонки/отсутствие значения → 400
-/// </summary>
+/// «Очищать можно только корзину или архив», валидация CardsService.ClearColAsync L237–247).
-/// <remarks>
+/// </remarks>
-/// Wire-имя — camelCase: col — "trash" | "archive" (другие колонки/отсутствие значения → 400
+public sealed record ClearColBody(string? Col);
-/// «Очищать можно только корзину или архив», валидация CardsService.ClearColAsync L237–247).
-/// </remarks>
-public sealed record ClearColBody(string? Col);

src/core/Deal.Api/Endpoints/RequestModels/ColStateBody.cs

@@ -1,14 +1,11 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело PATCH /api/containers/{containerId}/state — смена состояния колонки (этап 9, T4).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело PATCH /api/containers/{containerId}/state — смена состояния колонки (этап 9, T4).
+/// Wire-имена — camelCase: collapsed (bool) / width ("sm"|"md"|"lg"). Поле со значением null (либо
-/// </summary>
+/// отсутствующее) текущее значение не меняет (прототип model_dump(exclude_none=True) + merge в текущее
-/// <remarks>
+/// состояние колонки, L146–149). Пустой патч {} сохраняет текущее состояние (для новой колонки — {}).
-/// Wire-имена — camelCase: collapsed (bool) / width ("sm"|"md"|"lg"). Поле со значением null (либо
+/// </remarks>
-/// отсутствующее) текущее значение не меняет (прототип model_dump(exclude_none=True) + merge в текущее
+public sealed record ColStateBody(bool? Collapsed, string? Width);
-/// состояние колонки, L146–149). Пустой патч {} сохраняет текущее состояние (для новой колонки — {}).
-/// </remarks>
-public sealed record ColStateBody(bool? Collapsed, string? Width);

src/core/Deal.Api/Endpoints/RequestModels/CommentBody.cs

@@ -1,13 +1,10 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/cards/{cardId}/comments — добавление комментария (dashboard_routes.py CommentBody L60–61).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/cards/{cardId}/comments — добавление комментария (dashboard_routes.py CommentBody L60–61).
+/// Wire-имя — camelCase: text. Пустой/пробельный текст либо явный null → 400 «Пустой комментарий»
-/// </summary>
+/// (валидация CardsService.AddCommentAsync, 1:1 с dashboard_routes L240–241).
-/// <remarks>
+/// </remarks>
-/// Wire-имя — camelCase: text. Пустой/пробельный текст либо явный null → 400 «Пустой комментарий»
+public sealed record CommentBody(string? Text);
-/// (валидация CardsService.AddCommentAsync, 1:1 с dashboard_routes L240–241).
-/// </remarks>
-public sealed record CommentBody(string? Text);

src/core/Deal.Api/Endpoints/RequestModels/ContainerCreateRequest.cs

@@ -1,32 +1,30 @@
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Endpoints.RequestModels;
-
+
-namespace Deal.Api.Endpoints.RequestModels;
+/// <summary>
-
+/// Тело POST /api/containers — создание контейнера (этап 9, T4).
-/// <summary>
+/// </summary>
-/// Тело POST /api/containers — создание контейнера (этап 9, T4).
+/// <remarks>
-/// </summary>
+/// Wire-имена — camelCase: name/description/color/space/kind/suggested/note/rules. Name — обязательное:
-/// <remarks>
+/// отсутствие либо явный null → 400 «Укажите название колонки»; пустая строка допустима — сервис
-/// Wire-имена — camelCase: name/description/color/space/kind/suggested/note/rules. Name — обязательное:
+/// подставит «Новая колонка». Description/Note имеют дефолт "". Отсутствующие группы правил
-/// отсутствие либо явный null → 400 «Укажите название колонки»; пустая строка допустима — сервис
+/// трактуются как пустые (null-устойчивость).
-/// подставит «Новая колонка». Description/Note имеют дефолт "". Отсутствующие группы правил
+/// </remarks>
-/// трактуются как пустые (null-устойчивость).
+/// <param name="Name">Имя контейнера (обязательно).</param>
-/// </remarks>
+/// <param name="Description">Описание (опционально).</param>
-/// <param name="Name">Имя контейнера (обязательно).</param>
+/// <param name="Color">Цвет (опционально; null — палитра).</param>
-/// <param name="Description">Описание (опционально).</param>
+/// <param name="Space">Пространство (dashboard/selected; по умолчанию dashboard).</param>
-/// <param name="Color">Цвет (опционально; null — палитра).</param>
+/// <param name="Kind">Вид (board/stage/service/terminal; по умолчанию board).</param>
-/// <param name="Space">Пространство (dashboard/selected; по умолчанию dashboard).</param>
+/// <param name="Suggested">Признак ИИ-предложения.</param>
-/// <param name="Kind">Вид (board/stage/service/terminal; по умолчанию board).</param>
+/// <param name="Rules">Правила попадания.</param>
-/// <param name="Suggested">Признак ИИ-предложения.</param>
+/// <param name="Note">Заметка/обоснование.</param>
-/// <param name="Rules">Правила попадания.</param>
+public sealed record ContainerCreateRequest(
-/// <param name="Note">Заметка/обоснование.</param>
+    string? Name,
-public sealed record ContainerCreateRequest(
+    string? Description,
-    string? Name,
+    string? Color,
-    string? Description,
+    string? Space,
-    string? Color,
+    string? Kind,
-    string? Space,
+    bool? Suggested,
-    string? Kind,
+    ContainerRulesDto? Rules,
-    bool? Suggested,
+    string? Note);
-    ContainerRulesDto? Rules,
-    string? Note);

src/core/Deal.Api/Endpoints/RequestModels/ContainerPatchRequest.cs

@@ -1,31 +1,29 @@
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Endpoints.RequestModels;
-
+
-namespace Deal.Api.Endpoints.RequestModels;
+/// <summary>
-
+/// Тело PATCH /api/containers/{id} — частичное обновление контейнера (этап 9, T4).
-/// <summary>
+/// </summary>
-/// Тело PATCH /api/containers/{id} — частичное обновление контейнера (этап 9, T4).
+/// <remarks>
-/// </summary>
+/// Wire-имена — camelCase: name/description/color/collapsed/suggested/note/rules/policy. Поле со
-/// <remarks>
+/// значением null означает «не менять»; исключение — ЯВНЫЙ null у name → 400 «Укажите название колонки».
-/// Wire-имена — camelCase: name/description/color/collapsed/suggested/note/rules/policy. Поле со
+/// JSON-объекты rules/policy заменяются целиком.
-/// значением null означает «не менять»; исключение — ЯВНЫЙ null у name → 400 «Укажите название колонки».
+/// </remarks>
-/// JSON-объекты rules/policy заменяются целиком.
+/// <param name="Name">Новое имя (null — не менять).</param>
-/// </remarks>
+/// <param name="Description">Новое описание (null — не менять).</param>
-/// <param name="Name">Новое имя (null — не менять).</param>
+/// <param name="Color">Новый цвет (null — не менять).</param>
-/// <param name="Description">Новое описание (null — не менять).</param>
+/// <param name="Collapsed">Новая свёрнутость (null — не менять).</param>
-/// <param name="Color">Новый цвет (null — не менять).</param>
+/// <param name="Suggested">Признак ИИ-предложения (null — не менять).</param>
-/// <param name="Collapsed">Новая свёрнутость (null — не менять).</param>
+/// <param name="Note">Новая заметка (null — не менять).</param>
-/// <param name="Suggested">Признак ИИ-предложения (null — не менять).</param>
+/// <param name="Rules">Новые правила (null — не менять).</param>
-/// <param name="Note">Новая заметка (null — не менять).</param>
+/// <param name="Policy">Новая политика (null — не менять).</param>
-/// <param name="Rules">Новые правила (null — не менять).</param>
+public sealed record ContainerPatchRequest(
-/// <param name="Policy">Новая политика (null — не менять).</param>
+    string? Name,
-public sealed record ContainerPatchRequest(
+    string? Description,
-    string? Name,
+    string? Color,
-    string? Description,
+    bool? Collapsed,
-    string? Color,
+    bool? Suggested,
-    bool? Collapsed,
+    string? Note,
-    bool? Suggested,
+    ContainerRulesDto? Rules,
-    string? Note,
+    ContainerPolicyDto? Policy);
-    ContainerRulesDto? Rules,
-    ContainerPolicyDto? Policy);

src/core/Deal.Api/Endpoints/RequestModels/CreateCardRequest.cs

@@ -1,6 +1,4 @@
 using Deal.Modules.Kanban.Application.Models;
-using Deal.Api.Services;
-using Deal.Api.Dtos;
 
 namespace Deal.Api.Endpoints.RequestModels;
 

src/core/Deal.Api/Endpoints/RequestModels/DiscoveryTaskCreateBody.cs

@@ -1,61 +1,58 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/discovery/tasks (TaskCreate discovery_routes.py L50–60; api-map §3.8 L204).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/discovery/tasks (TaskCreate discovery_routes.py L50–60; api-map §3.8 L204).
+/// Wire-имена — camelCase: name/description/keywords/minSubscribers/lang/threshold/sampleSize/planJoins/autoJoin.
-/// </summary>
+/// Значения-дефолты pydantic повторяет сервис DiscoveryTasksService: description/keywords — пустые, lang — «ru»,
-/// <remarks>
+/// minSubscribers — 0, planJoins — 1, autoJoin — false; threshold/sampleSize — из настроек (null → дефолт).
-/// Wire-имена — camelCase: name/description/keywords/minSubscribers/lang/threshold/sampleSize/planJoins/autoJoin.
+/// name — единственное поле без дефолта: пустое/пробельное значение → 400 «Укажите название задачи».
-/// Значения-дефолты pydantic повторяет сервис DiscoveryTasksService: description/keywords — пустые, lang — «ru»,
+/// </remarks>
-/// minSubscribers — 0, planJoins — 1, autoJoin — false; threshold/sampleSize — из настроек (null → дефолт).
+public sealed record DiscoveryTaskCreateBody
-/// name — единственное поле без дефолта: пустое/пробельное значение → 400 «Укажите название задачи».
+{
-/// </remarks>
+    /// <summary>
-public sealed record DiscoveryTaskCreateBody
+    /// Название задачи (обязательное; Trim, пустое → 400).
-{
+    /// </summary>
-    /// <summary>
+    public string Name { get; init; } = string.Empty;
-    /// Название задачи (обязательное; Trim, пустое → 400).
+
-    /// </summary>
+    /// <summary>
-    public string Name { get; init; } = string.Empty;
+    /// Описание ниши/цели (источник для generate-keywords); null → пустая строка.
-
+    /// </summary>
-    /// <summary>
+    public string? Description { get; init; }
-    /// Описание ниши/цели (источник для generate-keywords); null → пустая строка.
+
-    /// </summary>
+    /// <summary>
-    public string? Description { get; init; }
+    /// Ключевые слова поиска; null/пусто — список пуст (start до добавления ключей → 400).
-
+    /// </summary>
-    /// <summary>
+    public IReadOnlyList<string>? Keywords { get; init; }
-    /// Ключевые слова поиска; null/пусто — список пуст (start до добавления ключей → 400).
+
-    /// </summary>
+    /// <summary>
-    public IReadOnlyList<string>? Keywords { get; init; }
+    /// Минимальное число участников источника; null → 0.
-
+    /// </summary>
-    /// <summary>
+    public int? MinSubscribers { get; init; }
-    /// Минимальное число участников источника; null → 0.
+
-    /// </summary>
+    /// <summary>
-    public int? MinSubscribers { get; init; }
+    /// Язык источников: «ru»|«any»; null/иное → «ru» (нормализует сервис).
-
+    /// </summary>
-    /// <summary>
+    public string? Lang { get; init; }
-    /// Язык источников: «ru»|«any»; null/иное → «ru» (нормализует сервис).
+
-    /// </summary>
+    /// <summary>
-    public string? Lang { get; init; }
+    /// Порог подходящих сообщений оценки, % (кламп 1..100); null → discEvalThreshold.
-
+    /// </summary>
-    /// <summary>
+    public int? Threshold { get; init; }
-    /// Порог подходящих сообщений оценки, % (кламп 1..100); null → discEvalThreshold.
+
-    /// </summary>
+    /// <summary>
-    public int? Threshold { get; init; }
+    /// Размер выборки сообщений оценки (кламп ≥1); null → discEvalSample.
-
+    /// </summary>
-    /// <summary>
+    public int? SampleSize { get; init; }
-    /// Размер выборки сообщений оценки (кламп ≥1); null → discEvalSample.
+
-    /// </summary>
+    /// <summary>
-    public int? SampleSize { get; init; }
+    /// План авто-вступлений (1..discJoinLimit + бюджет); null → 1.
-
+    /// </summary>
-    /// <summary>
+    public int? PlanJoins { get; init; }
-    /// План авто-вступлений (1..discJoinLimit + бюджет); null → 1.
+
-    /// </summary>
+    /// <summary>
-    public int? PlanJoins { get; init; }
+    /// Авто-вступления воркером; null → false.
-
+    /// </summary>
-    /// <summary>
+    public bool? AutoJoin { get; init; }
-    /// Авто-вступления воркером; null → false.
+}
-    /// </summary>
-    public bool? AutoJoin { get; init; }
-}

src/core/Deal.Api/Endpoints/RequestModels/DiscoveryTaskPatchBody.cs

@@ -1,60 +1,57 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело PATCH /api/discovery/tasks/{task_id} (TaskPatch discovery_routes.py L62–71; api-map §3.8 L205).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело PATCH /api/discovery/tasks/{task_id} (TaskPatch discovery_routes.py L62–71; api-map §3.8 L205).
+/// Wire-имена — camelCase; все поля optional: null/отсутствующее поле не меняется (в DiscoveryTaskPatch
-/// </summary>
+/// пробрасываются только не-null значения, как python model_dump(exclude_none=True)). keywords — полная замена
-/// <remarks>
+/// списка (пустой список очищает ключи); увеличение planJoins проверяется план-бюджетом.
-/// Wire-имена — camelCase; все поля optional: null/отсутствующее поле не меняется (в DiscoveryTaskPatch
+/// </remarks>
-/// пробрасываются только не-null значения, как python model_dump(exclude_none=True)). keywords — полная замена
+public sealed record DiscoveryTaskPatchBody
-/// списка (пустой список очищает ключи); увеличение planJoins проверяется план-бюджетом.
+{
-/// </remarks>
+    /// <summary>
-public sealed record DiscoveryTaskPatchBody
+    /// Новое название (после Trim; пустое допустимо на patch — 1:1 прототип).
-{
+    /// </summary>
-    /// <summary>
+    public string? Name { get; init; }
-    /// Новое название (после Trim; пустое допустимо на patch — 1:1 прототип).
+
-    /// </summary>
+    /// <summary>
-    public string? Name { get; init; }
+    /// Новое описание (пустая строка очищает).
-
+    /// </summary>
-    /// <summary>
+    public string? Description { get; init; }
-    /// Новое описание (пустая строка очищает).
+
-    /// </summary>
+    /// <summary>
-    public string? Description { get; init; }
+    /// Новые ключевые слова (полная замена; null — не менять).
-
+    /// </summary>
-    /// <summary>
+    public IReadOnlyList<string>? Keywords { get; init; }
-    /// Новые ключевые слова (полная замена; null — не менять).
+
-    /// </summary>
+    /// <summary>
-    public IReadOnlyList<string>? Keywords { get; init; }
+    /// Новый минимум участников (кламп ≥0).
-
+    /// </summary>
-    /// <summary>
+    public int? MinSubscribers { get; init; }
-    /// Новый минимум участников (кламп ≥0).
+
-    /// </summary>
+    /// <summary>
-    public int? MinSubscribers { get; init; }
+    /// Новый язык: «ru»|«any» (иное → «ru»).
-
+    /// </summary>
-    /// <summary>
+    public string? Lang { get; init; }
-    /// Новый язык: «ru»|«any» (иное → «ru»).
+
-    /// </summary>
+    /// <summary>
-    public string? Lang { get; init; }
+    /// Новый порог оценки, % (кламп 1..100).
-
+    /// </summary>
-    /// <summary>
+    public int? Threshold { get; init; }
-    /// Новый порог оценки, % (кламп 1..100).
+
-    /// </summary>
+    /// <summary>
-    public int? Threshold { get; init; }
+    /// Новый размер выборки (кламп ≥1).
-
+    /// </summary>
-    /// <summary>
+    public int? SampleSize { get; init; }
-    /// Новый размер выборки (кламп ≥1).
+
-    /// </summary>
+    /// <summary>
-    public int? SampleSize { get; init; }
+    /// Новый план авто-вступлений (рост — с проверкой бюджета).
-
+    /// </summary>
-    /// <summary>
+    public int? PlanJoins { get; init; }
-    /// Новый план авто-вступлений (рост — с проверкой бюджета).
+
-    /// </summary>
+    /// <summary>
-    public int? PlanJoins { get; init; }
+    /// Новый флаг авто-вступлений (false — выключить).
-
+    /// </summary>
-    /// <summary>
+    public bool? AutoJoin { get; init; }
-    /// Новый флаг авто-вступлений (false — выключить).
+}
-    /// </summary>
-    public bool? AutoJoin { get; init; }
-}

src/core/Deal.Api/Endpoints/RequestModels/MarkColBody.cs

@@ -1,15 +1,12 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/cards/mark-col-seen — снять «новое» с колонки (dashboard_routes.py MarkColBody L183–184, api-map §3.2 L88).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/cards/mark-col-seen — снять «новое» с колонки (dashboard_routes.py MarkColBody L183–184, api-map §3.2 L88).
+/// Wire-имя — camelCase: col — колонка (inbox/archive/trash/доска). Отсутствие/null col → 400
-/// </summary>
+/// «Неизвестная колонка»: иначе пустой col попал бы в CardsService.MarkSeenAsync и снял «новое» со ВСЕХ
-/// <remarks>
+/// карточек (truthiness-семантика прототипа: пустая строка = параметр не задан, mark_seen L250–256) —
-/// Wire-имя — camelCase: col — колонка (inbox/archive/trash/доска). Отсутствие/null col → 400
+/// эндпоинт защищает от такого вызова (прототип: pydantic required 422).
-/// «Неизвестная колонка»: иначе пустой col попал бы в CardsService.MarkSeenAsync и снял «новое» со ВСЕХ
+/// </remarks>
-/// карточек (truthiness-семантика прототипа: пустая строка = параметр не задан, mark_seen L250–256) —
+public sealed record MarkColBody(string? Col);
-/// эндпоинт защищает от такого вызова (прототип: pydantic required 422).
-/// </remarks>
-public sealed record MarkColBody(string? Col);

src/core/Deal.Api/Endpoints/RequestModels/MoveBody.cs

@@ -1,14 +1,11 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/cards/{lead_id}/move — перенос карточки (dashboard_routes.py MoveBody L56–57, api-map §3.2 L89).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/cards/{lead_id}/move — перенос карточки (dashboard_routes.py MoveBody L56–57, api-map §3.2 L89).
+/// Wire-имя — camelCase: to — колонка назначения: "inbox" либо id доски (<c>b_...</c>). Цель валидирует
-/// </summary>
+/// CardsService (400 «Переносить можно только на доски или в «Неразобранное»»); отсутствующий/null to
-/// <remarks>
+/// трактуются той же валидацией (прототип — pydantic required 422).
-/// Wire-имя — camelCase: to — колонка назначения: "inbox" либо id доски (<c>b_...</c>). Цель валидирует
+/// </remarks>
-/// CardsService (400 «Переносить можно только на доски или в «Неразобранное»»); отсутствующий/null to
+public sealed record MoveBody(string? To);
-/// трактуются той же валидацией (прототип — pydantic required 422).
-/// </remarks>
-public sealed record MoveBody(string? To);

src/core/Deal.Api/Endpoints/RequestModels/OperatorTelegramKeysRequest.cs

@@ -1,6 +1,3 @@
-using Deal.Api.Services;
-using Deal.Api.Dtos;
-
 namespace Deal.Api.Endpoints.RequestModels;
 
 /// <summary>

src/core/Deal.Api/Endpoints/RequestModels/OrderBody.cs

@@ -1,15 +1,12 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/containers/reorder — новый порядок контейнеров пространства (этап 9, T4).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/containers/reorder — новый порядок контейнеров пространства (этап 9, T4).
+/// Wire-имена — camelCase: space (пространство dashboard/selected; отсутствие — dashboard) и order
-/// </summary>
+/// (список id контейнеров в новом порядке). Отсутствие/явный null у order — 400 «Не указан порядок колонок».
-/// <remarks>
+/// </remarks>
-/// Wire-имена — camelCase: space (пространство dashboard/selected; отсутствие — dashboard) и order
+/// <param name="Space">Пространство (dashboard/selected); null — dashboard.</param>
-/// (список id контейнеров в новом порядке). Отсутствие/явный null у order — 400 «Не указан порядок колонок».
+/// <param name="Order">Id контейнеров в новом порядке.</param>
-/// </remarks>
+public sealed record OrderBody(string? Space, IReadOnlyList<string>? Order);
-/// <param name="Space">Пространство (dashboard/selected); null — dashboard.</param>
-/// <param name="Order">Id контейнеров в новом порядке.</param>
-public sealed record OrderBody(string? Space, IReadOnlyList<string>? Order);

src/core/Deal.Api/Endpoints/RequestModels/ReclassifyBody.cs

@@ -1,14 +1,11 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/cards/reclassify — ИИ-переклассификация «Неразобранного» (dashboard_routes.py ReclassifyBody L64–65, api-map §3.2 L95).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/cards/reclassify — ИИ-переклассификация «Неразобранного» (dashboard_routes.py ReclassifyBody L64–65, api-map §3.2 L95).
+/// Wire-имя — camelCase: ids (опциональный список id карточек). Тело опционально (фронт вызывает без
-/// </summary>
+/// тела — reclassifyInbox, store.js L1115–1133; параметр эндпоинта nullable). В этапе 3 — заглушка
-/// <remarks>
+/// Ruling 11: тело не используется, ответ всегда {started:false, busy:false, attempted:0, reason}.
-/// Wire-имя — camelCase: ids (опциональный список id карточек). Тело опционально (фронт вызывает без
+/// </remarks>
-/// тела — reclassifyInbox, store.js L1115–1133; параметр эндпоинта nullable). В этапе 3 — заглушка
+public sealed record ReclassifyBody(IReadOnlyList<string>? Ids);
-/// Ruling 11: тело не используется, ответ всегда {started:false, busy:false, attempted:0, reason}.
-/// </remarks>
-public sealed record ReclassifyBody(IReadOnlyList<string>? Ids);

src/core/Deal.Api/Endpoints/RequestModels/ReminderSetRequest.cs

@@ -1,20 +1,17 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/cards/{cardId}/reminder — установка напоминания hold-карточке
-
+/// (projects_routes.py ReminderBody L52–53, api-map §3.5 L172; Ruling 3).
-/// <summary>
+/// </summary>
-/// Тело POST /api/cards/{cardId}/reminder — установка напоминания hold-карточке
+/// <remarks>
-/// (projects_routes.py ReminderBody L52–53, api-map §3.5 L172; Ruling 3).
+/// Wire-имя — camelCase: at — время напоминания в epoch-мс (рассчитывает фронт HoldReminderDialog:
-/// </summary>
+/// «через N дней (1–30)» или «дата+время» локального времени; store.js setHoldReminder L2060–2086).
-/// <remarks>
+/// Стадия карточки/будущность at сервисом НЕ проверяются (1:1 прототип: фронт шлёт только для hold;
-/// Wire-имя — camelCase: at — время напоминания в epoch-мс (рассчитывает фронт HoldReminderDialog:
+/// прошлое at допустимо — приёмка Tasks 11/13 «выстреливает» его ручным тиком). Ответ — полная карточка
-/// «через N дней (1–30)» или «дата+время» локального времени; store.js setHoldReminder L2060–2086).
+/// с напоминанием {at}; 400 «Напоминания об отложенных выключены в настройках» при выключенном
-/// Стадия карточки/будущность at сервисом НЕ проверяются (1:1 прототип: фронт шлёт только для hold;
+/// remindersEnabled; 404 «Карточка не найдена». Отсутствующий/JSON-null at (клиентский баг; pydantic на
-/// прошлое at допустимо — приёмка Tasks 11/13 «выстреливает» его ручным тиком). Ответ — полная карточка
+/// такое — 422) эндпоинт отвергает 400 — у напоминания без времени нет осмысленной семантики.
-/// с напоминанием {at}; 400 «Напоминания об отложенных выключены в настройках» при выключенном
+/// </remarks>
-/// remindersEnabled; 404 «Карточка не найдена». Отсутствующий/JSON-null at (клиентский баг; pydantic на
+/// <param name="At">Время напоминания, epoch-ms.</param>
-/// такое — 422) эндпоинт отвергает 400 — у напоминания без времени нет осмысленной семантики.
+public sealed record ReminderSetRequest(long? At);
-/// </remarks>
-/// <param name="At">Время напоминания, epoch-ms.</param>
-public sealed record ReminderSetRequest(long? At);

src/core/Deal.Api/Endpoints/RequestModels/ReturnReasonRequest.cs

@@ -1,14 +1,11 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/pipeline/rejected/{rejId}/return — причина возврата в обработку (processing_routes.py ReturnBody L13–15, api-map §3.6 L185).
-
+/// </summary>
-/// <summary>
+/// <remarks>
-/// Тело POST /api/pipeline/rejected/{rejId}/return — причина возврата в обработку (processing_routes.py ReturnBody L13–15, api-map §3.6 L185).
+/// Wire-имя — camelCase: reason (опциональна, дефолт "" — как pydantic reason: str = ""; фронт шлёт
-/// </summary>
+/// {reason} всегда). Пустая причина допустима: сервис тримит и кладёт на запись для аудита
-/// <remarks>
+/// (return_to_queue L158, Ruling 10).
-/// Wire-имя — camelCase: reason (опциональна, дефолт "" — как pydantic reason: str = ""; фронт шлёт
+/// </remarks>
-/// {reason} всегда). Пустая причина допустима: сервис тримит и кладёт на запись для аудита
+public sealed record ReturnReasonRequest(string? Reason);
-/// (return_to_queue L158, Ruling 10).
-/// </remarks>
-public sealed record ReturnReasonRequest(string? Reason);

src/core/Deal.Api/Endpoints/RequestModels/TakeCardRequest.cs

@@ -1,6 +1,3 @@
-using Deal.Api.Services;
-using Deal.Api.Dtos;
-
 namespace Deal.Api.Endpoints.RequestModels;
 
 /// <summary>

src/core/Deal.Api/Endpoints/RequestModels/TgMonitorBody.cs

@@ -1,10 +1,7 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/tg/dialogs/{dialog_id}/monitor и /monitor-all (tg_routes.py MonitorBody L54–56).
-
+/// </summary>
-/// <summary>
+/// <param name="Enabled">True — мониторить (сообщения → PushMessage в ядро), false — выключить.</param>
-/// Тело POST /api/tg/dialogs/{dialog_id}/monitor и /monitor-all (tg_routes.py MonitorBody L54–56).
+public sealed record TgMonitorBody(bool Enabled);
-/// </summary>
-/// <param name="Enabled">True — мониторить (сообщения → PushMessage в ядро), false — выключить.</param>
-public sealed record TgMonitorBody(bool Enabled);

src/core/Deal.Api/Endpoints/RequestModels/TgPreviewBody.cs

@@ -1,11 +1,8 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/tg/dialogs/preview — последние сообщения диалога (tg_routes.py PreviewBody L58–60).
-
+/// </summary>
-/// <summary>
+/// <param name="DialogId">Id диалога (подписанный).</param>
-/// Тело POST /api/tg/dialogs/preview — последние сообщения диалога (tg_routes.py PreviewBody L58–60).
+/// <param name="Limit">Сколько последних сообщений; дефолт 24, кламп 1..50 (python L153).</param>
-/// </summary>
+public sealed record TgPreviewBody(string DialogId, int? Limit);
-/// <param name="DialogId">Id диалога (подписанный).</param>
-/// <param name="Limit">Сколько последних сообщений; дефолт 24, кламп 1..50 (python L153).</param>
-public sealed record TgPreviewBody(string DialogId, int? Limit);

src/core/Deal.Api/Endpoints/RequestModels/TgSendCodeRequest.cs

@@ -1,10 +1,7 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/tg/send-code — SMS-код входа (tg_routes.py CodeBody L46–48).
-
+/// </summary>
-/// <summary>
+/// <param name="Code">Код из SMS/Telegram-сообщения (trim перед отправкой, python L89).</param>
-/// Тело POST /api/tg/send-code — SMS-код входа (tg_routes.py CodeBody L46–48).
+public sealed record TgSendCodeRequest(string Code);
-/// </summary>
-/// <param name="Code">Код из SMS/Telegram-сообщения (trim перед отправкой, python L89).</param>
-public sealed record TgSendCodeRequest(string Code);

src/core/Deal.Api/Endpoints/RequestModels/TgSendPasswordRequest.cs

@@ -1,10 +1,7 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/tg/send-password — облачный пароль 2FA (tg_routes.py PasswordBody L50–52).
-
+/// </summary>
-/// <summary>
+/// <param name="Password">Пароль облачной защиты (как ввёл пользователь, без trim — python L100).</param>
-/// Тело POST /api/tg/send-password — облачный пароль 2FA (tg_routes.py PasswordBody L50–52).
+public sealed record TgSendPasswordRequest(string Password);
-/// </summary>
-/// <param name="Password">Пароль облачной защиты (как ввёл пользователь, без trim — python L100).</param>
-public sealed record TgSendPasswordRequest(string Password);

src/core/Deal.Api/Endpoints/RequestModels/TgStartPhoneRequest.cs

@@ -1,10 +1,7 @@
-using Deal.Api.Services;
+namespace Deal.Api.Endpoints.RequestModels;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Endpoints.RequestModels;
+/// Тело POST /api/tg/start-phone — вход по номеру телефона (tg_routes.py PhoneBody L42–44).
-
+/// </summary>
-/// <summary>
+/// <param name="Phone">Номер в международном формате (как ввёл пользователь; обрезается обработчиком, python L71).</param>
-/// Тело POST /api/tg/start-phone — вход по номеру телефона (tg_routes.py PhoneBody L42–44).
+public sealed record TgStartPhoneRequest(string Phone);
-/// </summary>
-/// <param name="Phone">Номер в международном формате (как ввёл пользователь; обрезается обработчиком, python L71).</param>
-public sealed record TgStartPhoneRequest(string Phone);

src/core/Deal.Api/Endpoints/SettingsEndpoints.cs

@@ -1,137 +1,129 @@
-using System.Text.Json;
+using System.Text.Json;
-using Deal.Api;
+using Deal.Api.Extensions;
-using Deal.Api.Dtos;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Modules.Settings.Application.Abstractions;
-using Deal.Api.Extensions;
+using Deal.Modules.Settings.Application.Models;
-using Deal.Api.Models;
+using Deal.Modules.Settings.Application.Services;
-using Deal.Modules.Settings.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Settings.Application.Models;
+
-using Deal.Modules.Settings.Application.Registrars;
+namespace Deal.Api.Endpoints;
-using Deal.Modules.Settings.Application.Services;
+
-using Deal.Modules.Tenants.Application.Abstractions;
+/// <summary>
-using Deal.Modules.Tenants.Application.Extensions;
+/// HTTP-эндпоинты настроек тенанта: GET/PATCH /api/settings (api-map §3.4 L146–147, §4.6).
-using Deal.Modules.Tenants.Application.Models;
+/// </summary>
-using Deal.Modules.Tenants.Application.Registrars;
+/// <remarks>
-using Deal.Modules.Tenants.Application.Services;
+/// GET — публичный снимок настроек (дефолты + переопределения, маски секретов, providers — Ruling 3);
-
+/// PATCH — произвольный JSON-объект публичных полей §4.6, ответ — полный снимок после применения
-namespace Deal.Api.Endpoints;
+/// (фронт затирает локальный state ответом — store.js). Оба эндпоинта требуют сессию:
-
+/// 401 {"detail":"Требуется авторизация"} (Ruling 10). Мягкая семантика: невалидное поле PATCH
-/// <summary>
+/// просто не применяется; жёсткая ошибка — только тело не JSON-объект (400).
-/// HTTP-эндпоинты настроек тенанта: GET/PATCH /api/settings (api-map §3.4 L146–147, §4.6).
+/// Побочные эффекты прототипа L186–192: PATCH с полем rateSource запускает фоновое
-/// </summary>
+/// обновление кэша курсов (<see cref="RatesRefreshScheduler"/>, Ruling 6); пересчёт карточек при смене
-/// <remarks>
+/// targetCurrency/conversionOn выполняет сам SettingsService через порт <see cref="IRatesChangedListener"/>
-/// GET — публичный снимок настроек (дефолты + переопределения, маски секретов, providers — Ruling 3);
+/// (реализация — ConversionRecomputer модуля Kanban, Ruling 7, Task 12).
-/// PATCH — произвольный JSON-объект публичных полей §4.6, ответ — полный снимок после применения
+/// <para>
-/// (фронт затирает локальный state ответом — store.js). Оба эндпоинта требуют сессию:
+/// SettingsService резолвится из RequestServices ВНУТРИ обработчика после проверки сессии, а не
-/// 401 {"detail":"Требуется авторизация"} (Ruling 10). Мягкая семантика: невалидное поле PATCH
+/// параметром эндпоинта: DI-биндинг параметров выполняется до тела обработчика, а зависимость
-/// просто не применяется; жёсткая ошибка — только тело не JSON-объект (400).
+/// сервиса — scoped TenantDbContext, опции которого строятся по tenant-контексту запроса
-/// Побочные эффекты прототипа L186–192: PATCH с полем rateSource запускает фоновое
+/// (без сессии контекст не разрешим — ошибка конфигурации). Так запрос без сессии получает 401,
-/// обновление кэша курсов (<see cref="RatesRefreshScheduler"/>, Ruling 6); пересчёт карточек при смене
+/// а не 500 при резолве.
-/// targetCurrency/conversionOn выполняет сам SettingsService через порт <see cref="IRatesChangedListener"/>
+/// </para>
-/// (реализация — ConversionRecomputer модуля Kanban, Ruling 7, Task 12).
+/// </remarks>
-/// <para>
+public static class SettingsEndpoints
-/// SettingsService резолвится из RequestServices ВНУТРИ обработчика после проверки сессии, а не
+{
-/// параметром эндпоинта: DI-биндинг параметров выполняется до тела обработчика, а зависимость
+    private const string ApiGroupPrefix = "/api";
-/// сервиса — scoped TenantDbContext, опции которого строятся по tenant-контексту запроса
+    private const string SettingsPath = "/settings";
-/// (без сессии контекст не разрешим — ошибка конфигурации). Так запрос без сессии получает 401,
+    private const string SettingsOpenApiTag = "settings";
-/// а не 500 при резолве.
+    private const string InvalidBodyDetail = "Тело запроса должно быть JSON-объектом";
-/// </para>
+
-/// </remarks>
+    /// <summary>
-public static class SettingsEndpoints
+    /// Регистрирует GET/PATCH /api/settings.
-{
+    /// </summary>
-    private const string ApiGroupPrefix = "/api";
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    private const string SettingsPath = "/settings";
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    private const string SettingsOpenApiTag = "settings";
+    public static IEndpointRouteBuilder MapSettingsEndpoints(this IEndpointRouteBuilder app)
-    private const string InvalidBodyDetail = "Тело запроса должно быть JSON-объектом";
+    {
-
+        var group = app.MapGroup(ApiGroupPrefix).WithTags(SettingsOpenApiTag);
-    /// <summary>
+
-    /// Регистрирует GET/PATCH /api/settings.
+        group.MapGet(SettingsPath, GetSettingsAsync);
-    /// </summary>
+        group.MapPatch(SettingsPath, PatchSettingsAsync);
-    /// <param name="app">Построитель маршрутов приложения.</param>
+
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+        return app;
-    public static IEndpointRouteBuilder MapSettingsEndpoints(this IEndpointRouteBuilder app)
+    }
-    {
+
-        var group = app.MapGroup(ApiGroupPrefix).WithTags(SettingsOpenApiTag);
+    // GET /api/settings: публичный снимок настроек текущего тенанта.
-
+    private static async Task<IResult> GetSettingsAsync(HttpContext context, CancellationToken ct)
-        group.MapGet(SettingsPath, GetSettingsAsync);
+    {
-        group.MapPatch(SettingsPath, PatchSettingsAsync);
+        if (!context.HasUser())
-
+        {
-        return app;
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // GET /api/settings: публичный снимок настроек текущего тенанта.
+        SettingsService settingsService = context.RequestServices.GetRequiredService<SettingsService>();
-    private static async Task<IResult> GetSettingsAsync(HttpContext context, CancellationToken ct)
+        return Results.Ok(await settingsService.GetPublicAsync(ct));
-    {
+    }
-        if (!context.HasUser())
+
-        {
+    // PATCH /api/settings: частичное обновление настроек; ответ — полный снимок после применения.
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+    private static async Task<IResult> PatchSettingsAsync(HttpContext context, CancellationToken ct)
-        }
+    {
-
+        if (!context.HasUser())
-        SettingsService settingsService = context.RequestServices.GetRequiredService<SettingsService>();
+        {
-        return Results.Ok(await settingsService.GetPublicAsync(ct));
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-    }
+        }
-
+
-    // PATCH /api/settings: частичное обновление настроек; ответ — полный снимок после применения.
+        // Произвольный JSON-объект: ключи тела — публичные ключи §4.6 (как их шлёт фронт).
-    private static async Task<IResult> PatchSettingsAsync(HttpContext context, CancellationToken ct)
+        Dictionary<string, JsonElement>? body;
-    {
+        try
-        if (!context.HasUser())
+        {
-        {
+            body = await JsonSerializer.DeserializeAsync<Dictionary<string, JsonElement>>(
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+                context.Request.Body,
-        }
+                options: null,
-
+                cancellationToken: ct);
-        // Произвольный JSON-объект: ключи тела — публичные ключи §4.6 (как их шлёт фронт).
+        }
-        Dictionary<string, JsonElement>? body;
+        catch (JsonException)
-        try
+        {
-        {
+            // Не-JSON или не-объект целиком — ошибка запроса: 400 + detail
-            body = await JsonSerializer.DeserializeAsync<Dictionary<string, JsonElement>>(
+            // (в прототипе FastAPI на такое тело — 422).
-                context.Request.Body,
+            return EndpointResults.BadRequest(InvalidBodyDetail);
-                options: null,
+        }
-                cancellationToken: ct);
+
-        }
+        if (body is null)
-        catch (JsonException)
+        {
-        {
+            return EndpointResults.BadRequest(InvalidBodyDetail);
-            // Не-JSON или не-объект целиком — ошибка запроса: 400 + detail
+        }
-            // (в прототипе FastAPI на такое тело — 422).
+
-            return EndpointResults.BadRequest(InvalidBodyDetail);
+        SettingsService settingsService = context.RequestServices.GetRequiredService<SettingsService>();
-        }
+        PublicSettingsDto result = await settingsService.ApplyPatchAsync(body, ct);
-
+
-        if (body is null)
+        // Аудит сохранения настроек (этап 10, T1): только имена полей — значения (в т.ч. секреты) не пишутся.
-        {
+        await AuditAppender.AppendTenantAsync(context, AuditEvents.SettingsUpdated, new { fields = body.Keys }, ct);
-            return EndpointResults.BadRequest(InvalidBodyDetail);
+
-        }
+        // Смена источника курсов в PATCH (settings_routes.py L188–189) — фоновое обновление кэша
-
+        // курсов (Ruling 6, Task 8). RefreshAsync читает уже сохранённую настройку rateSource.
-        SettingsService settingsService = context.RequestServices.GetRequiredService<SettingsService>();
+        if (ShouldScheduleRatesRefresh(body))
-        PublicSettingsDto result = await settingsService.ApplyPatchAsync(body, ct);
+        {
-
+            context.RequestServices.GetRequiredService<RatesRefreshScheduler>().Schedule();
-        // Аудит сохранения настроек (этап 10, T1): только имена полей — значения (в т.ч. секреты) не пишутся.
+        }
-        await AuditAppender.AppendTenantAsync(context, AuditEvents.SettingsUpdated, new { fields = body.Keys }, ct);
+
-
+        return Results.Ok(result);
-        // Смена источника курсов в PATCH (settings_routes.py L188–189) — фоновое обновление кэша
+    }
-        // курсов (Ruling 6, Task 8). RefreshAsync читает уже сохранённую настройку rateSource.
+
-        if (ShouldScheduleRatesRefresh(body))
+    // Запускать ли фоновый refresh курсов после PATCH (семантика if body.get("rateSource") L188).
-        {
+    // body: Тело PATCH — публичные ключи §4.6.
-            context.RequestServices.GetRequiredService<RatesRefreshScheduler>().Schedule();
+    // Возвращает: True — поле rateSource передано «правдивым» значением (не null/пустая строка).
-        }
+    private static bool ShouldScheduleRatesRefresh(Dictionary<string, JsonElement> body)
-
+    {
-        return Results.Ok(result);
+        if (!body.TryGetValue(SettingsKeys.RateSource, out JsonElement element))
-    }
+        {
-
+            return false;
-    // Запускать ли фоновый refresh курсов после PATCH (семантика if body.get("rateSource") L188).
+        }
-    // body: Тело PATCH — публичные ключи §4.6.
+
-    // Возвращает: True — поле rateSource передано «правдивым» значением (не null/пустая строка).
+        // JSON-булево/число в python «правдивы» и запускают refresh; пустая строка/null — нет.
-    private static bool ShouldScheduleRatesRefresh(Dictionary<string, JsonElement> body)
+        return element.ValueKind switch
-    {
+        {
-        if (!body.TryGetValue(SettingsKeys.RateSource, out JsonElement element))
+            JsonValueKind.String => !string.IsNullOrEmpty(element.GetString()),
-        {
+            JsonValueKind.Null => false,
-            return false;
+            _ => true,
-        }
+        };
-
+    }
-        // JSON-булево/число в python «правдивы» и запускают refresh; пустая строка/null — нет.
+}
-        return element.ValueKind switch
-        {
-            JsonValueKind.String => !string.IsNullOrEmpty(element.GetString()),
-            JsonValueKind.Null => false,
-            _ => true,
-        };
-    }
-}

src/core/Deal.Api/Endpoints/StorageEndpoints.cs

@@ -1,90 +1,88 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Infrastructure.Services;
-using Deal.Infrastructure.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Endpoints;
-
+
-namespace Deal.Api.Endpoints;
+/// <summary>
-
+/// Служебные storage-эндпоинты: POST /api/admin/tick и POST /api/admin/fts/rebuild (план Tasks 10–11,
-/// <summary>
+/// Rulings 6/8/11; прототип dashboard_routes.py L261–264, L327–337).
-/// Служебные storage-эндпоинты: POST /api/admin/tick и POST /api/admin/fts/rebuild (план Tasks 10–11,
+/// </summary>
-/// Rulings 6/8/11; прототип dashboard_routes.py L261–264, L327–337).
+/// <remarks>
-/// </summary>
+/// Контракт 1:1 с прототипом и api-map §3.2 L103–112: POST /admin/tick = тик правил хранения текущего
-/// <remarks>
+/// тенанта + очистка отсева пайплайна (3 суток) + проверка напоминаний «Отложено» (план Task 11, Ruling 3/8)
-/// Контракт 1:1 с прототипом и api-map §3.2 L103–112: POST /admin/tick = тик правил хранения текущего
+/// + один проход pump очереди входящих (этап 4, Ruling 8/9);
-/// тенанта + очистка отсева пайплайна (3 суток) + проверка напоминаний «Отложено» (план Task 11, Ruling 3/8)
+/// ответ {storage, reminders, pipeline: {…}, queue: N} (dashboard_routes.py L327–337; storage.purgedRejected
-/// + один проход pump очереди входящих (этап 4, Ruling 8/9);
+/// объединяет очистку отсева — Ruling 9; reminders — «выстрелившие» напоминания {id,title,stage}, пусто —
-/// ответ {storage, reminders, pipeline: {…}, queue: N} (dashboard_routes.py L327–337; storage.purgedRejected
+/// сработавших нет). SSE-публикации (тосты статистики notify_tick_stats L496–504, new_card по созданным
-/// объединяет очистку отсева — Ruling 9; reminders — «выстрелившие» напоминания {id,title,stage}, пусто —
+/// карточкам и reminder_due по «выстрелившим» напоминаниям) выполняет <see cref="AdminTickOrchestrator"/> из
-/// сработавших нет). SSE-публикации (тосты статистики notify_tick_stats L496–504, new_card по созданным
+/// Api-слоя — модули остаются чистыми (Ruling 5/8); без подписчиков публикация — no-op. Сбой проверки
-/// карточкам и reminder_due по «выстрелившим» напоминаниям) выполняет <see cref="AdminTickOrchestrator"/> из
+/// напоминаний/pump не роняет тик: reminders/pipeline ответа пусты, очередь ждёт следующего тика/фонового
-/// Api-слоя — модули остаются чистыми (Ruling 5/8); без подписчиков публикация — no-op. Сбой проверки
+/// цикла (Task 11). POST /admin/fts/rebuild —
-/// напоминаний/pump не роняет тик: reminders/pipeline ответа пусты, очередь ждёт следующего тика/фонового
+/// реальная идемпотентная пересборка FTS-индексов <see cref="FtsMaintenance"/> (CREATE INDEX IF NOT EXISTS +
-/// цикла (Task 11). POST /admin/fts/rebuild —
+/// ANALYZE, Ruling 6), ответ {ok:true, ready:true} (при сбое {ok:false, ready:false} — 1:1 с fts_rebuild L261–264,
-/// реальная идемпотентная пересборка FTS-индексов <see cref="FtsMaintenance"/> (CREATE INDEX IF NOT EXISTS +
+/// кнопка Settings «Пересобрать индекс» store.js L1883–1889). Оба эндпоинта требуют сессию: 401 {detail} без
-/// ANALYZE, Ruling 6), ответ {ok:true, ready:true} (при сбое {ok:false, ready:false} — 1:1 с fts_rebuild L261–264,
+/// куки (Ruling 10); сервисы резолвятся из RequestServices ПОСЛЕ проверки сессии (паттерн BoardsEndpoints).
-/// кнопка Settings «Пересобрать индекс» store.js L1883–1889). Оба эндпоинта требуют сессию: 401 {detail} без
+/// </remarks>
-/// куки (Ruling 10); сервисы резолвятся из RequestServices ПОСЛЕ проверки сессии (паттерн BoardsEndpoints).
+public static class StorageEndpoints
-/// </remarks>
+{
-public static class StorageEndpoints
+    // Префикс группы (роутер dashboard, prefix="/api"; admin-пути прототипа L261/L327).
-{
+    private const string AdminGroupPrefix = "/api";
-    // Префикс группы (роутер dashboard, prefix="/api"; admin-пути прототипа L261/L327).
+
-    private const string AdminGroupPrefix = "/api";
+    // Путь ручного тика правил хранения (dashboard_routes.py L327).
-
+    private const string TickPath = "/admin/tick";
-    // Путь ручного тика правил хранения (dashboard_routes.py L327).
+
-    private const string TickPath = "/admin/tick";
+    // Путь пересборки поискового индекса (dashboard_routes.py L261; Ruling 6).
-
+    private const string FtsRebuildPath = "/admin/fts/rebuild";
-    // Путь пересборки поискового индекса (dashboard_routes.py L261; Ruling 6).
+
-    private const string FtsRebuildPath = "/admin/fts/rebuild";
+    // OpenAPI-тег группы (в прототипе роутер dashboard — dashboard_routes.py).
-
+    private const string OpenApiTag = "dashboard";
-    // OpenAPI-тег группы (в прототипе роутер dashboard — dashboard_routes.py).
+
-    private const string OpenApiTag = "dashboard";
+    /// <summary>
-
+    /// Регистрирует POST /api/admin/tick и POST /api/admin/fts/rebuild.
-    /// <summary>
+    /// </summary>
-    /// Регистрирует POST /api/admin/tick и POST /api/admin/fts/rebuild.
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// </summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <param name="app">Построитель маршрутов приложения.</param>
+    public static IEndpointRouteBuilder MapStorageEndpoints(this IEndpointRouteBuilder app)
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+    {
-    public static IEndpointRouteBuilder MapStorageEndpoints(this IEndpointRouteBuilder app)
+        var admin = app.MapGroup(AdminGroupPrefix).WithTags(OpenApiTag);
-    {
+        admin.MapPost(TickPath, AdminTickAsync);
-        var admin = app.MapGroup(AdminGroupPrefix).WithTags(OpenApiTag);
+        admin.MapPost(FtsRebuildPath, FtsRebuildAsync);
-        admin.MapPost(TickPath, AdminTickAsync);
+        return app;
-        admin.MapPost(FtsRebuildPath, FtsRebuildAsync);
+    }
-        return app;
+
-    }
+    // POST /api/admin/tick: правила хранения + очистка отсева + напоминания + pump + SSE-тосты/new_card/reminder_due (admin_tick L327–337).
-
+    // Весь состав тика — AdminTickOrchestrator (вынесен из эндпоинта для unit-тестов логики и
-    // POST /api/admin/tick: правила хранения + очистка отсева + напоминания + pump + SSE-тосты/new_card/reminder_due (admin_tick L327–337).
+    // переиспользования): тик StorageTickService (Kanban) → PurgeExpiredAsync (отсев 3 суток, merge в
-    // Весь состав тика — AdminTickOrchestrator (вынесен из эндпоинта для unit-тестов логики и
+    // storage.purgedRejected) → тосты статистики (включая «Отсев очищен: N записей (3 дн.)») → CheckDueAsync
-    // переиспользования): тик StorageTickService (Kanban) → PurgeExpiredAsync (отсев 3 суток, merge в
+    // (напоминания «Отложено»: reminders ответа + SSE reminder_due, план Task 11; сбой не роняет тик) →
-    // storage.purgedRejected) → тосты статистики (включая «Отсев очищен: N записей (3 дн.)») → CheckDueAsync
+    // PumpOnceAsync (сбой не роняет тик) → SSE new_card по созданным карточкам → queue. Формы — 1:1 с прототипом.
-    // (напоминания «Отложено»: reminders ответа + SSE reminder_due, план Task 11; сбой не роняет тик) →
+    private static async Task<IResult> AdminTickAsync(HttpContext context, CancellationToken ct)
-    // PumpOnceAsync (сбой не роняет тик) → SSE new_card по созданным карточкам → queue. Формы — 1:1 с прототипом.
+    {
-    private static async Task<IResult> AdminTickAsync(HttpContext context, CancellationToken ct)
+        if (!context.HasUser())
-    {
+        {
-        if (!context.HasUser())
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        AdminTickOrchestrator orchestrator = context.RequestServices.GetRequiredService<AdminTickOrchestrator>();
-
+        Guid tenantId = context.GetCurrentUser()!.TenantId;
-        AdminTickOrchestrator orchestrator = context.RequestServices.GetRequiredService<AdminTickOrchestrator>();
+        return Results.Ok(await orchestrator.TickAsync(tenantId, ct));
-        Guid tenantId = context.GetCurrentUser()!.TenantId;
+    }
-        return Results.Ok(await orchestrator.TickAsync(tenantId, ct));
+
-    }
+    // POST /api/admin/fts/rebuild: пересборка FTS-индексов тенанта; ответ {ok:true, ready:true} (Ruling 6).
-
+    // SearchTsv — генерируемые STORED-колонки Cards/RejectedItems: авто-актуальны, «пересборка» = создание
-    // POST /api/admin/fts/rebuild: пересборка FTS-индексов тенанта; ответ {ok:true, ready:true} (Ruling 6).
+    // отсутствующих GIN-индексов (CREATE INDEX IF NOT EXISTS) + ANALYZE таблиц (FtsMaintenance.RebuildAsync).
-    // SearchTsv — генерируемые STORED-колонки Cards/RejectedItems: авто-актуальны, «пересборка» = создание
+    // Сбой обслуживания возвращает {ok:false, ready:false} (прототип fts_rebuild L261–264: rebuild() → ok,
-    // отсутствующих GIN-индексов (CREATE INDEX IF NOT EXISTS) + ANALYZE таблиц (FtsMaintenance.RebuildAsync).
+    // is_ready() → ready) — кнопка Settings фронта показывает ошибку по ready (store.js L1883–1889).
-    // Сбой обслуживания возвращает {ok:false, ready:false} (прототип fts_rebuild L261–264: rebuild() → ok,
+    private static async Task<IResult> FtsRebuildAsync(HttpContext context, CancellationToken ct)
-    // is_ready() → ready) — кнопка Settings фронта показывает ошибку по ready (store.js L1883–1889).
+    {
-    private static async Task<IResult> FtsRebuildAsync(HttpContext context, CancellationToken ct)
+        if (!context.HasUser())
-    {
+        {
-        if (!context.HasUser())
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        FtsMaintenance fts = context.RequestServices.GetRequiredService<FtsMaintenance>();
-
+        bool ok = await fts.RebuildAsync(ct);
-        FtsMaintenance fts = context.RequestServices.GetRequiredService<FtsMaintenance>();
+        return Results.Ok(new { ok, ready = ok });
-        bool ok = await fts.RebuildAsync(ct);
+    }
-        return Results.Ok(new { ok, ready = ok });
+}
-    }
-}

src/core/Deal.Api/Endpoints/TelegramQrImageEndpoint.cs

@@ -1,87 +1,85 @@
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Services;
-using Deal.Api.Services;
+using Deal.Contracts.Integrations.Abstractions;
-using Deal.Contracts.Integrations.Abstractions;
+using Deal.Contracts.Integrations.Models;
-using Deal.Contracts.Integrations.Models;
+using Net.Codecrete.QrCodeGenerator;
-using Net.Codecrete.QrCodeGenerator;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Endpoints;
-
+
-namespace Deal.Api.Endpoints;
+/// <summary>
-
+/// GET /api/tg/qr-image: SVG QR-кода входа (tg_routes.py L30–39; Ruling 8).
-/// <summary>
+/// </summary>
-/// GET /api/tg/qr-image: SVG QR-кода входа (tg_routes.py L30–39; Ruling 8).
+/// <remarks>
-/// </summary>
+/// Фронт рисует QR картинкой: <c>&lt;img src="/api/tg/qr-image?t=N"&gt;</c> (store.js tg-флоу; api-map §3.3 L133).
-/// <remarks>
+/// Активен только в фазе входа «qr» (живой статус гейта); иначе — 404 «QR не активен — начните вход по QR»
-/// Фронт рисует QR картинкой: <c>&lt;img src="/api/tg/qr-image?t=N"&gt;</c> (store.js tg-флоу; api-map §3.3 L133).
+/// (глобальная строка контракта, python L34). SVG генерирует Net.Codecrete.QrCodeGenerator (SVG-first, без
-/// Активен только в фазе входа «qr» (живой статус гейта); иначе — 404 «QR не активен — начните вход по QR»
+/// внешних растровых зависимостей — план Task 14/Tech Stack); border=1 как python (border=1, L22). Заголовки —
-/// (глобальная строка контракта, python L34). SVG генерирует Net.Codecrete.QrCodeGenerator (SVG-first, без
+/// no-store + Content-Disposition: inline (python L37–38: свежий QR на каждый запрос, не кэшировать). Сессия
-/// внешних растровых зависимостей — план Task 14/Tech Stack); border=1 как python (border=1, L22). Заголовки —
+/// обязательна: 401 {detail} (Ruling 10).
-/// no-store + Content-Disposition: inline (python L37–38: свежий QR на каждый запрос, не кэшировать). Сессия
+/// </remarks>
-/// обязательна: 401 {detail} (Ruling 10).
+public static class TelegramQrImageEndpoint
-/// </remarks>
+{
-public static class TelegramQrImageEndpoint
+    // Префикс группы /api/tg (общий с TelegramEndpoints).
-{
+    private const string QrGroupPrefix = "/api/tg";
-    // Префикс группы /api/tg (общий с TelegramEndpoints).
+
-    private const string QrGroupPrefix = "/api/tg";
+    // Путь SVG QR-кода (GET; фронт добавляет ?t=N от кэша).
-
+    private const string QrImagePath = "/qr-image";
-    // Путь SVG QR-кода (GET; фронт добавляет ?t=N от кэша).
+
-    private const string QrImagePath = "/qr-image";
+    // OpenAPI-тег группы (в прототипе роутер tg — tg_routes.py).
-
+    private const string QrImageOpenApiTag = "telegram";
-    // OpenAPI-тег группы (в прототипе роутер tg — tg_routes.py).
+
-    private const string QrImageOpenApiTag = "telegram";
+    // Деталь 404: QR не активен (python L34, глобальная строка контракта).
-
+    private const string QrNotActiveDetail = "QR не активен — начните вход по QR";
-    // Деталь 404: QR не активен (python L34, глобальная строка контракта).
+
-    private const string QrNotActiveDetail = "QR не активен — начните вход по QR";
+    // Media-type SVG-ответа (python L37: image/svg+xml).
-
+    private const string SvgMediaType = "image/svg+xml";
-    // Media-type SVG-ответа (python L37: image/svg+xml).
+
-    private const string SvgMediaType = "image/svg+xml";
+    // Ширина рамки (quiet zone) QR в модулях (python L22: qrcode border=1).
-
+    private const int QrBorderModules = 1;
-    // Ширина рамки (quiet zone) QR в модулях (python L22: qrcode border=1).
+
-    private const int QrBorderModules = 1;
+    /// <summary>
-
+    /// Регистрирует GET /api/tg/qr-image.
-    /// <summary>
+    /// </summary>
-    /// Регистрирует GET /api/tg/qr-image.
+    /// <param name="app">Построитель маршрутов приложения.</param>
-    /// </summary>
+    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
-    /// <param name="app">Построитель маршрутов приложения.</param>
+    public static IEndpointRouteBuilder MapTelegramQrImageEndpoint(this IEndpointRouteBuilder app)
-    /// <returns>Построитель маршрутов для цепочки вызовов.</returns>
+    {
-    public static IEndpointRouteBuilder MapTelegramQrImageEndpoint(this IEndpointRouteBuilder app)
+        var group = app.MapGroup(QrGroupPrefix).WithTags(QrImageOpenApiTag);
-    {
+        group.MapGet(QrImagePath, QrImageAsync);
-        var group = app.MapGroup(QrGroupPrefix).WithTags(QrImageOpenApiTag);
+        return app;
-        group.MapGet(QrImagePath, QrImageAsync);
+    }
-        return app;
+
-    }
+    // GET /api/tg/qr-image: SVG QR-кода фазы входа «qr» (tg_routes.py L30–39).
-
+    private static async Task<IResult> QrImageAsync(HttpContext context, CancellationToken ct)
-    // GET /api/tg/qr-image: SVG QR-кода фазы входа «qr» (tg_routes.py L30–39).
+    {
-    private static async Task<IResult> QrImageAsync(HttpContext context, CancellationToken ct)
+        if (!context.HasUser())
-    {
+        {
-        if (!context.HasUser())
+            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
-        {
+        }
-            return EndpointResults.Unauthorized(AuthHelpers.UnauthorizedDetail);
+
-        }
+        // Активен только в фазе «qr» живого статуса telegram-service; сервис недоступен/фаза иная — 404 (python L33–34).
-
+        TelegramAccountStatusDto live;
-        // Активен только в фазе «qr» живого статуса telegram-service; сервис недоступен/фаза иная — 404 (python L33–34).
+        try
-        TelegramAccountStatusDto live;
+        {
-        try
+            ITelegramGateway gateway = context.RequestServices.GetRequiredService<ITelegramGateway>();
-        {
+            live = await gateway.StatusAsync(ct);
-            ITelegramGateway gateway = context.RequestServices.GetRequiredService<ITelegramGateway>();
+        }
-            live = await gateway.StatusAsync(ct);
+        catch (Exception exception) when (exception is not OperationCanceledException)
-        }
+        {
-        catch (Exception exception) when (exception is not OperationCanceledException)
+            return EndpointResults.NotFound(QrNotActiveDetail);
-        {
+        }
-            return EndpointResults.NotFound(QrNotActiveDetail);
+
-        }
+        if (!string.Equals(live.Phase, "qr", StringComparison.Ordinal) || string.IsNullOrEmpty(live.QrUrl))
-
+        {
-        if (!string.Equals(live.Phase, "qr", StringComparison.Ordinal) || string.IsNullOrEmpty(live.QrUrl))
+            return EndpointResults.NotFound(QrNotActiveDetail);
-        {
+        }
-            return EndpointResults.NotFound(QrNotActiveDetail);
+
-        }
+        QrCode qr = QrCode.EncodeText(live.QrUrl, QrCode.Ecc.Medium);
-
+        string svg = qr.ToSvgString(QrBorderModules);
-        QrCode qr = QrCode.EncodeText(live.QrUrl, QrCode.Ecc.Medium);
+
-        string svg = qr.ToSvgString(QrBorderModules);
+        // Свежий QR на каждый запрос (не кэшировать); inline — как python L37–38.
-
+        context.Response.Headers.CacheControl = "no-store";
-        // Свежий QR на каждый запрос (не кэшировать); inline — как python L37–38.
+        context.Response.Headers.ContentDisposition = "inline";
-        context.Response.Headers.CacheControl = "no-store";
+        return Results.Text(svg, SvgMediaType);
-        context.Response.Headers.ContentDisposition = "inline";
+    }
-        return Results.Text(svg, SvgMediaType);
+}
-    }
-}

src/core/Deal.Api/Events/SseBroker.cs

@@ -1,129 +1,127 @@
-using System.Text.Encodings.Web;
+using System.Text.Encodings.Web;
-using System.Text.Json;
+using System.Text.Json;
-using System.Threading.Channels;
+using System.Threading.Channels;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Events;
-
+
-namespace Deal.Api.Events;
+/// <summary>
-
+/// Singleton SSE-брокер этапа: per-tenant каналы событий (Ruling 5, план Task 9).
-/// <summary>
+/// </summary>
-/// Singleton SSE-брокер этапа: per-tenant каналы событий (Ruling 5, план Task 9).
+/// <remarks>
-/// </summary>
+/// Канал заводится на тенанта при подписке (тенант сессии — CurrentUser.TenantId), публикация идёт
-/// <remarks>
+/// в канал тенанта по явному идентификатору — её делают ТОЛЬКО эндпоинты Api после вызова сервисов
-/// Канал заводится на тенанта при подписке (тенант сессии — CurrentUser.TenantId), публикация идёт
+/// модулей (Task 10/13/14); фоновые задачи вне tenant-запроса публикуют со своим scope + ITenantContext
-/// в канал тенанта по явному идентификатору — её делают ТОЛЬКО эндпоинты Api после вызова сервисов
+/// (Task 11). Публикация без подписчиков канала — no-op, не падает (Ruling 5). Очередь подписчика —
-/// модулей (Task 10/13/14); фоновые задачи вне tenant-запроса публикуют со своим scope + ITenantContext
+/// bounded ≤200 с вытеснением старых, как прототип sse.py (maxsize=200, при переполнении get_nowait →
-/// (Task 11). Публикация без подписчиков канала — no-op, не падает (Ruling 5). Очередь подписчика —
+/// put_nowait текущего события). Потокобезопасен: словарь защищён гейтом; запись в каналы —
-/// bounded ≤200 с вытеснением старых, как прототип sse.py (maxsize=200, при переполнении get_nowait →
+/// неблокирующий TryWrite (DropOldest) вне гейта, подписки/отписки конкурентны публикациям.
-/// put_nowait текущего события). Потокобезопасен: словарь защищён гейтом; запись в каналы —
+/// </remarks>
-/// неблокирующий TryWrite (DropOldest) вне гейта, подписки/отписки конкурентны публикациям.
+public sealed class SseBroker
-/// </remarks>
+{
-public sealed class SseBroker
+    /// <summary>
-{
+    /// Ёмкость очереди подписчика (sse.py L20: <c>asyncio.Queue(maxsize=200)</c>).
-    /// <summary>
+    /// </summary>
-    /// Ёмкость очереди подписчика (sse.py L20: <c>asyncio.Queue(maxsize=200)</c>).
+    public const int SubscriberQueueCapacity = 200;
-    /// </summary>
+
-    public const int SubscriberQueueCapacity = 200;
+    // Опции сериализации полезной нагрузки в data: — как у HTTP-ответов приложения:
-
+    // web-дефолты (camelCase) и без \u-экранирования не-ASCII (Program.cs ConfigureHttpJsonOptions).
-    // Опции сериализации полезной нагрузки в data: — как у HTTP-ответов приложения:
+    private static readonly JsonSerializerOptions PublishJsonOptions = new(JsonSerializerDefaults.Web)
-    // web-дефолты (camelCase) и без \u-экранирования не-ASCII (Program.cs ConfigureHttpJsonOptions).
+    {
-    private static readonly JsonSerializerOptions PublishJsonOptions = new(JsonSerializerDefaults.Web)
+        Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
-    {
+    };
-        Encoder = JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
+
-    };
+    private readonly object _gate = new();
-
+
-    private readonly object _gate = new();
+    // Подписчики по тенантам: tenantId → (subscriptionId → канал).
-
+    private readonly Dictionary<Guid, Dictionary<Guid, Channel<SseEvent>>> _subscribersByTenant = new();
-    // Подписчики по тенантам: tenantId → (subscriptionId → канал).
+
-    private readonly Dictionary<Guid, Dictionary<Guid, Channel<SseEvent>>> _subscribersByTenant = new();
+    /// <summary>
-
+    /// Подписывает клиента на канал тенанта: новая bounded-очередь (≤200, DropOldest).
-    /// <summary>
+    /// </summary>
-    /// Подписывает клиента на канал тенанта: новая bounded-очередь (≤200, DropOldest).
+    /// <param name="tenantId">Тенант сессии запроса (Ruling 5: канал по TenantId при подписке).</param>
-    /// </summary>
+    /// <returns>Подписка: идентификатор для отписки и читатель канала событий.</returns>
-    /// <param name="tenantId">Тенант сессии запроса (Ruling 5: канал по TenantId при подписке).</param>
+    public SseSubscription Subscribe(Guid tenantId)
-    /// <returns>Подписка: идентификатор для отписки и читатель канала событий.</returns>
+    {
-    public SseSubscription Subscribe(Guid tenantId)
+        var channel = Channel.CreateBounded<SseEvent>(new BoundedChannelOptions(SubscriberQueueCapacity)
-    {
+        {
-        var channel = Channel.CreateBounded<SseEvent>(new BoundedChannelOptions(SubscriberQueueCapacity)
+            // Вытеснение старых при переполнении (sse.py L36–44): TryWrite не блокирует и не падает.
-        {
+            FullMode = BoundedChannelFullMode.DropOldest,
-            // Вытеснение старых при переполнении (sse.py L36–44): TryWrite не блокирует и не падает.
+            SingleReader = true,
-            FullMode = BoundedChannelFullMode.DropOldest,
+            SingleWriter = false,
-            SingleReader = true,
+        });
-            SingleWriter = false,
+
-        });
+        var subscription = new SseSubscription(Guid.NewGuid(), tenantId, channel.Reader);
-
+        lock (_gate)
-        var subscription = new SseSubscription(Guid.NewGuid(), tenantId, channel.Reader);
+        {
-        lock (_gate)
+            if (!_subscribersByTenant.TryGetValue(tenantId, out Dictionary<Guid, Channel<SseEvent>>? subscribers))
-        {
+            {
-            if (!_subscribersByTenant.TryGetValue(tenantId, out Dictionary<Guid, Channel<SseEvent>>? subscribers))
+                subscribers = new Dictionary<Guid, Channel<SseEvent>>();
-            {
+                _subscribersByTenant.Add(tenantId, subscribers);
-                subscribers = new Dictionary<Guid, Channel<SseEvent>>();
+            }
-                _subscribersByTenant.Add(tenantId, subscribers);
+
-            }
+            subscribers.Add(subscription.Id, channel);
-
+        }
-            subscribers.Add(subscription.Id, channel);
+
-        }
+        return subscription;
-
+    }
-        return subscription;
+
-    }
+    /// <summary>
-
+    /// Отписывает клиента по завершении SSE-соединения (events_routes.py L27–28).
-    /// <summary>
+    /// </summary>
-    /// Отписывает клиента по завершении SSE-соединения (events_routes.py L27–28).
+    /// <param name="tenantId">Тенант канала подписки.</param>
-    /// </summary>
+    /// <param name="subscriptionId">Идентификатор подписки из <see cref="Subscribe"/>.</param>
-    /// <param name="tenantId">Тенант канала подписки.</param>
+    public void Unsubscribe(Guid tenantId, Guid subscriptionId)
-    /// <param name="subscriptionId">Идентификатор подписки из <see cref="Subscribe"/>.</param>
+    {
-    public void Unsubscribe(Guid tenantId, Guid subscriptionId)
+        lock (_gate)
-    {
+        {
-        lock (_gate)
+            if (!_subscribersByTenant.TryGetValue(tenantId, out Dictionary<Guid, Channel<SseEvent>>? subscribers))
-        {
+            {
-            if (!_subscribersByTenant.TryGetValue(tenantId, out Dictionary<Guid, Channel<SseEvent>>? subscribers))
+                return;
-            {
+            }
-                return;
+
-            }
+            subscribers.Remove(subscriptionId);
-
+            if (subscribers.Count == 0)
-            subscribers.Remove(subscriptionId);
+            {
-            if (subscribers.Count == 0)
+                // Пустой канал тенанта убираем — публикации без подписчиков становятся no-op.
-            {
+                _subscribersByTenant.Remove(tenantId);
-                // Пустой канал тенанта убираем — публикации без подписчиков становятся no-op.
+            }
-                _subscribersByTenant.Remove(tenantId);
+        }
-            }
+    }
-        }
+
-    }
+    /// <summary>
-
+    /// Публикует событие в канал тенанта (Ruling 5: публикации — из эндпоинтов Api).
-    /// <summary>
+    /// </summary>
-    /// Публикует событие в канал тенанта (Ruling 5: публикации — из эндпоинтов Api).
+    /// <param name="tenantId">Тенант-получатель; без подписчиков — no-op, не падает.</param>
-    /// </summary>
+    /// <param name="eventType">Тип события (new_card/toast этапа 3; api.js L78–79).</param>
-    /// <param name="tenantId">Тенант-получатель; без подписчиков — no-op, не падает.</param>
+    /// <param name="payload">Полезная нагрузка — сериализуется в JSON (camelCase, без \u).</param>
-    /// <param name="eventType">Тип события (new_card/toast этапа 3; api.js L78–79).</param>
+    public void Publish(
-    /// <param name="payload">Полезная нагрузка — сериализуется в JSON (camelCase, без \u).</param>
+        Guid tenantId,
-    public void Publish(
+        string eventType,
-        Guid tenantId,
+        object payload) =>
-        string eventType,
+        Publish(tenantId, new SseEvent(eventType, JsonSerializer.Serialize(payload, PublishJsonOptions)));
-        object payload) =>
+
-        Publish(tenantId, new SseEvent(eventType, JsonSerializer.Serialize(payload, PublishJsonOptions)));
+    /// <summary>
-
+    /// Публикует готовое событие (тип + JSON) в канал тенанта.
-    /// <summary>
+    /// </summary>
-    /// Публикует готовое событие (тип + JSON) в канал тенанта.
+    /// <param name="tenantId">Тенант-получатель; без подписчиков — no-op, не падает.</param>
-    /// </summary>
+    /// <param name="sseEvent">Событие с уже сериализованной нагрузкой.</param>
-    /// <param name="tenantId">Тенант-получатель; без подписчиков — no-op, не падает.</param>
+    public void Publish(Guid tenantId, SseEvent sseEvent)
-    /// <param name="sseEvent">Событие с уже сериализованной нагрузкой.</param>
+    {
-    public void Publish(Guid tenantId, SseEvent sseEvent)
+        Channel<SseEvent>[] channels;
-    {
+        lock (_gate)
-        Channel<SseEvent>[] channels;
+        {
-        lock (_gate)
+            if (!_subscribersByTenant.TryGetValue(tenantId, out Dictionary<Guid, Channel<SseEvent>>? subscribers))
-        {
+            {
-            if (!_subscribersByTenant.TryGetValue(tenantId, out Dictionary<Guid, Channel<SseEvent>>? subscribers))
+                return;
-            {
+            }
-                return;
+
-            }
+            channels = subscribers.Values.ToArray();
-
+        }
-            channels = subscribers.Values.ToArray();
+
-        }
+        foreach (Channel<SseEvent> channel in channels)
-
+        {
-        foreach (Channel<SseEvent> channel in channels)
+            // DropOldest + bounded: TryWrite всегда завершается успешно (кроме закрытого канала).
-        {
+            channel.Writer.TryWrite(sseEvent);
-            // DropOldest + bounded: TryWrite всегда завершается успешно (кроме закрытого канала).
+        }
-            channel.Writer.TryWrite(sseEvent);
+    }
-        }
+}
-    }
-}

src/core/Deal.Api/Events/SseEvent.cs

@@ -1,19 +1,16 @@
-using Deal.Api.Services;
+namespace Deal.Api.Events;
-using Deal.Api.Dtos;
+
-
+/// <summary>
-namespace Deal.Api.Events;
+/// Событие SSE-потока: тип + JSON-полезная нагрузка (Ruling 5; прототип sse.py L29–30).
-
+/// </summary>
-/// <summary>
+/// <param name="Type">Тип события — фронт слушает <c>addEventListener</c> по имени
-/// Событие SSE-потока: тип + JSON-полезная нагрузка (Ruling 5; прототип sse.py L29–30).
+/// (api.js L78–81): на этапе 3 — <c>new_card</c> (полный объект карточки) и <c>toast</c> {text, icon}.</param>
-/// </summary>
+/// <param name="Json">Полезная нагрузка, сериализованная в JSON (camelCase, без \u-экранирования).</param>
-/// <param name="Type">Тип события — фронт слушает <c>addEventListener</c> по имени
+public sealed record SseEvent(string Type, string Json)
-/// (api.js L78–81): на этапе 3 — <c>new_card</c> (полный объект карточки) и <c>toast</c> {text, icon}.</param>
+{
-/// <param name="Json">Полезная нагрузка, сериализованная в JSON (camelCase, без \u-экранирования).</param>
+    /// <summary>
-public sealed record SseEvent(string Type, string Json)
+    /// Отрисовывает frame протокола SSE: <c>event: &lt;type&gt;\ndata: &lt;json&gt;\n\n</c> (sse.py L30).
-{
+    /// </summary>
-    /// <summary>
+    /// <returns>Готовый frame для отправки в поток ответа.</returns>
-    /// Отрисовывает frame протокола SSE: <c>event: &lt;type&gt;\ndata: &lt;json&gt;\n\n</c> (sse.py L30).
+    public string RenderFrame() => $"event: {Type}\ndata: {Json}\n\n";
-    /// </summary>
+}
-    /// <returns>Готовый frame для отправки в поток ответа.</returns>
-    public string RenderFrame() => $"event: {Type}\ndata: {Json}\n\n";
-}

src/core/Deal.Api/Events/SseSubscription.cs

@@ -1,14 +1,12 @@
-using System.Threading.Channels;
+using System.Threading.Channels;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Events;
-
+
-namespace Deal.Api.Events;
+/// <summary>
-
+/// Активная подписка на канал SSE тенанта (прототип sse.py — очередь подписчика L19–20).
-/// <summary>
+/// </summary>
-/// Активная подписка на канал SSE тенанта (прототип sse.py — очередь подписчика L19–20).
+/// <param name="Id">Идентификатор подписки — передаётся в <see cref="SseBroker.Unsubscribe"/>.</param>
-/// </summary>
+/// <param name="TenantId">Тенант канала: тенант сессии при подписке (Ruling 5).</param>
-/// <param name="Id">Идентификатор подписки — передаётся в <see cref="SseBroker.Unsubscribe"/>.</param>
+/// <param name="Events">Канал событий подписчика: bounded-очередь ≤200 с вытеснением старых
-/// <param name="TenantId">Тенант канала: тенант сессии при подписке (Ruling 5).</param>
+/// (DropOldest, как get_nowait+put_nowait прототипа L36–44).</param>
-/// <param name="Events">Канал событий подписчика: bounded-очередь ≤200 с вытеснением старых
+public sealed record SseSubscription(Guid Id, Guid TenantId, ChannelReader<SseEvent> Events);
-/// (DropOldest, как get_nowait+put_nowait прототипа L36–44).</param>
-public sealed record SseSubscription(Guid Id, Guid TenantId, ChannelReader<SseEvent> Events);

src/core/Deal.Api/Events/StorageToastPublisher.cs

@@ -1,84 +1,82 @@
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Events;
-
+
-namespace Deal.Api.Events;
+/// <summary>
-
+/// Публикация SSE-тостов статистики тика правил хранения в канал тенанта (Ruling 8; notify_tick_stats L496–504).
-/// <summary>
+/// </summary>
-/// Публикация SSE-тостов статистики тика правил хранения в канал тенанта (Ruling 8; notify_tick_stats L496–504).
+/// <remarks>
-/// </summary>
+/// Единый хелпер Api-слоя для POST /api/admin/tick (StorageEndpoints/AdminTickOrchestrator, Task 10) и
-/// <remarks>
+/// фонового StorageTickScheduler (Task 11): публикует тосты только по ненулевым счётчикам, тексты и иконки
-/// Единый хелпер Api-слоя для POST /api/admin/tick (StorageEndpoints/AdminTickOrchestrator, Task 10) и
+/// 1:1 с прототипом; без подписчиков канала публикация — no-op (Ruling 5). Вынесен из StorageEndpoints,
-/// фонового StorageTickScheduler (Task 11): публикует тосты только по ненулевым счётчикам, тексты и иконки
+/// чтобы ручной и фоновый тики не дублировали логику. Модуль Kanban тосты не публикует (Ruling 5:
-/// 1:1 с прототипом; без подписчиков канала публикация — no-op (Ruling 5). Вынесен из StorageEndpoints,
+/// публикации SSE — обязанность Api-слоя).
-/// чтобы ручной и фоновый тики не дублировали логику. Модуль Kanban тосты не публикует (Ruling 5:
+/// </remarks>
-/// публикации SSE — обязанность Api-слоя).
+public sealed class StorageToastPublisher
-/// </remarks>
+{
-public sealed class StorageToastPublisher
+    // Тип SSE-события тоста (Ruling 5; api.js L79 слушает 'toast').
-{
+    private const string ToastEventType = "toast";
-    // Тип SSE-события тоста (Ruling 5; api.js L79 слушает 'toast').
+
-    private const string ToastEventType = "toast";
+    // Текст тоста автоархива: N карточек ушло в архив (notify_tick_stats L498).
-
+    private const string AutoArchiveToastText = "Автоархив: {0} карточек";
-    // Текст тоста автоархива: N карточек ушло в архив (notify_tick_stats L498).
+
-    private const string AutoArchiveToastText = "Автоархив: {0} карточек";
+    // Текст тоста очистки архива: N карточек удалено из архива (notify_tick_stats L500).
-
+    private const string ArchiveClearedToastText = "Архив очищен: {0} (90 дн.)";
-    // Текст тоста очистки архива: N карточек удалено из архива (notify_tick_stats L500).
+
-    private const string ArchiveClearedToastText = "Архив очищен: {0} (90 дн.)";
+    // Текст тоста очистки корзины: N карточек удалено из корзины (notify_tick_stats L502).
-
+    private const string TrashClearedToastText = "Корзина очищена: {0} (7 дн.)";
-    // Текст тоста очистки корзины: N карточек удалено из корзины (notify_tick_stats L502).
+
-    private const string TrashClearedToastText = "Корзина очищена: {0} (7 дн.)";
+    // Текст тоста автоочистки отсева пайплайна: N записей старше 3 суток (notify_tick_stats L503–504).
-
+    private const string RejectedPurgedToastText = "Отсев очищен: {0} записей (3 дн.)";
-    // Текст тоста автоочистки отсева пайплайна: N записей старше 3 суток (notify_tick_stats L503–504).
+
-    private const string RejectedPurgedToastText = "Отсев очищен: {0} записей (3 дн.)";
+    // Иконка тоста автоархива (Ruling 8, 1:1 с прототипом).
-
+    private const string ClockIcon = "clock";
-    // Иконка тоста автоархива (Ruling 8, 1:1 с прототипом).
+
-    private const string ClockIcon = "clock";
+    // Иконка тостов очисток архива/корзины (Ruling 8, 1:1 с прототипом).
-
+    private const string TrashIcon = "trash";
-    // Иконка тостов очисток архива/корзины (Ruling 8, 1:1 с прототипом).
+
-    private const string TrashIcon = "trash";
+    private readonly SseBroker _broker;
-
+
-    private readonly SseBroker _broker;
+    /// <summary>
-
+    /// Создаёт публикатора тостов тика.
-    /// <summary>
+    /// </summary>
-    /// Создаёт публикатора тостов тика.
+    /// <param name="broker">SSE-брокер каналов тенантов (singleton).</param>
-    /// </summary>
+    public StorageToastPublisher(SseBroker broker)
-    /// <param name="broker">SSE-брокер каналов тенантов (singleton).</param>
+    {
-    public StorageToastPublisher(SseBroker broker)
+        ArgumentNullException.ThrowIfNull(broker);
-    {
+        _broker = broker;
-        ArgumentNullException.ThrowIfNull(broker);
+    }
-        _broker = broker;
+
-    }
+    /// <summary>
-
+    /// Публикует тосты статистики тика по ненулевым счётчикам (notify_tick_stats L496–504).
-    /// <summary>
+    /// </summary>
-    /// Публикует тосты статистики тика по ненулевым счётчикам (notify_tick_stats L496–504).
+    /// <remarks>Тексты и иконки 1:1 с прототипом; дни в скобках («90 дн.»/«7 дн.»/«3 дн.») — фиксированные
-    /// </summary>
+    /// строки прототипа (не пересчитываются от настроек). Ветка purgedRejected («Отсев очищен: N записей
-    /// <remarks>Тексты и иконки 1:1 с прототипом; дни в скобках («90 дн.»/«7 дн.»/«3 дн.») — фиксированные
+    /// (3 дн.)») — план Task 10: счётчик наполняет оркестратор тика (AdminTickOrchestrator) очисткой отсева
-    /// строки прототипа (не пересчитываются от настроек). Ветка purgedRejected («Отсев очищен: N записей
+    /// PipelineProcessingService.PurgeExpiredAsync; фоновый цикл Task 11 публикует ту же ветку по своему тику.
-    /// (3 дн.)») — план Task 10: счётчик наполняет оркестратор тика (AdminTickOrchestrator) очисткой отсева
+    /// Публикация в канал тенанта; без подписчиков — no-op (Ruling 5).</remarks>
-    /// PipelineProcessingService.PurgeExpiredAsync; фоновый цикл Task 11 публикует ту же ветку по своему тику.
+    /// <param name="tenantId">Тенант-получатель тостов (сессия запроса / канал тенанта цикла).</param>
-    /// Публикация в канал тенанта; без подписчиков — no-op (Ruling 5).</remarks>
+    /// <param name="stats">Статистика только что выполненного тика.</param>
-    /// <param name="tenantId">Тенант-получатель тостов (сессия запроса / канал тенанта цикла).</param>
+    public void PublishTickToasts(Guid tenantId, StorageTickStatsDto stats)
-    /// <param name="stats">Статистика только что выполненного тика.</param>
+    {
-    public void PublishTickToasts(Guid tenantId, StorageTickStatsDto stats)
+        if (stats.Archived > 0)
-    {
+        {
-        if (stats.Archived > 0)
+            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(AutoArchiveToastText, stats.Archived), icon = ClockIcon });
-        {
+        }
-            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(AutoArchiveToastText, stats.Archived), icon = ClockIcon });
+
-        }
+        if (stats.PurgedArchive > 0)
-
+        {
-        if (stats.PurgedArchive > 0)
+            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(ArchiveClearedToastText, stats.PurgedArchive), icon = TrashIcon });
-        {
+        }
-            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(ArchiveClearedToastText, stats.PurgedArchive), icon = TrashIcon });
+
-        }
+        if (stats.PurgedTrash > 0)
-
+        {
-        if (stats.PurgedTrash > 0)
+            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(TrashClearedToastText, stats.PurgedTrash), icon = TrashIcon });
-        {
+        }
-            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(TrashClearedToastText, stats.PurgedTrash), icon = TrashIcon });
+
-        }
+        if (stats.PurgedRejected > 0)
-
+        {
-        if (stats.PurgedRejected > 0)
+            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(RejectedPurgedToastText, stats.PurgedRejected), icon = TrashIcon });
-        {
+        }
-            _broker.Publish(tenantId, ToastEventType, new { text = string.Format(RejectedPurgedToastText, stats.PurgedRejected), icon = TrashIcon });
+    }
-        }
+}
-    }
-}

src/core/Deal.Api/Extensions/AuthHelpers.cs

@@ -1,70 +1,68 @@
-using Deal.Api.Services;
+using Deal.Api.Models;
-using Deal.Api.Dtos;
+
-using Deal.Api.Models;
+namespace Deal.Api.Extensions;
-
+
-namespace Deal.Api.Extensions;
+/// <summary>
-
+/// Хелперы доступа к текущему пользователю запроса (минимальные API).
-/// <summary>
+/// </summary>
-/// Хелперы доступа к текущему пользователю запроса (минимальные API).
+public static class AuthHelpers
-/// </summary>
+{
-public static class AuthHelpers
+    /// <summary>
-{
+    /// Ключ в <c>HttpContext.Items</c>, по которому SessionMiddleware хранит CurrentUser.
-    /// <summary>
+    /// </summary>
-    /// Ключ в <c>HttpContext.Items</c>, по которому SessionMiddleware хранит CurrentUser.
+    public const string CurrentUserItemKey = "CurrentUser";
-    /// </summary>
+
-    public const string CurrentUserItemKey = "CurrentUser";
+    /// <summary>
-
+    /// Ключ в <c>HttpContext.Items</c>, по которому OperatorSessionMiddleware хранит CurrentOperator.
-    /// <summary>
+    /// </summary>
-    /// Ключ в <c>HttpContext.Items</c>, по которому OperatorSessionMiddleware хранит CurrentOperator.
+    public const string CurrentOperatorItemKey = "CurrentOperator";
-    /// </summary>
+
-    public const string CurrentOperatorItemKey = "CurrentOperator";
+    /// <summary>
-
+    /// Сообщение 401 для эндпоинтов, требующих авторизации (семантика прототипа, Ruling 10).
-    /// <summary>
+    /// </summary>
-    /// Сообщение 401 для эндпоинтов, требующих авторизации (семантика прототипа, Ruling 10).
+    public const string UnauthorizedDetail = "Требуется авторизация";
-    /// </summary>
+
-    public const string UnauthorizedDetail = "Требуется авторизация";
+    /// <summary>
-
+    /// Сообщение 401 для ручек /api/operator/* без разрешённой операторской сессии (Ruling 1).
-    /// <summary>
+    /// </summary>
-    /// Сообщение 401 для ручек /api/operator/* без разрешённой операторской сессии (Ruling 1).
+    public const string OperatorUnauthorizedDetail = "Требуется вход оператора";
-    /// </summary>
+
-    public const string OperatorUnauthorizedDetail = "Требуется вход оператора";
+    /// <summary>
-
+    /// Кладёт пользователя в <c>HttpContext.Items</c>.
-    /// <summary>
+    /// </summary>
-    /// Кладёт пользователя в <c>HttpContext.Items</c>.
+    /// <param name="context">Контекст запроса.</param>
-    /// </summary>
+    /// <param name="user">Пользователь, разрешённый по сессии.</param>
-    /// <param name="context">Контекст запроса.</param>
+    public static void SetCurrentUser(this HttpContext context, CurrentUser user) =>
-    /// <param name="user">Пользователь, разрешённый по сессии.</param>
+        context.Items[CurrentUserItemKey] = user;
-    public static void SetCurrentUser(this HttpContext context, CurrentUser user) =>
+
-        context.Items[CurrentUserItemKey] = user;
+    /// <summary>
-
+    /// Возвращает текущего пользователя запроса или null, если сессия не разрешена.
-    /// <summary>
+    /// </summary>
-    /// Возвращает текущего пользователя запроса или null, если сессия не разрешена.
+    /// <param name="context">Контекст запроса.</param>
-    /// </summary>
+    /// <returns>Пользователь или null.</returns>
-    /// <param name="context">Контекст запроса.</param>
+    public static CurrentUser? GetCurrentUser(this HttpContext context) =>
-    /// <returns>Пользователь или null.</returns>
+        context.Items[CurrentUserItemKey] as CurrentUser;
-    public static CurrentUser? GetCurrentUser(this HttpContext context) =>
+
-        context.Items[CurrentUserItemKey] as CurrentUser;
+    /// <summary>
-
+    /// Проверяет, разрешена ли для запроса пользовательская сессия.
-    /// <summary>
+    /// </summary>
-    /// Проверяет, разрешена ли для запроса пользовательская сессия.
+    /// <param name="context">Контекст запроса.</param>
-    /// </summary>
+    /// <returns>True — текущий пользователь установлен.</returns>
-    /// <param name="context">Контекст запроса.</param>
+    public static bool HasUser(this HttpContext context) => context.GetCurrentUser() is not null;
-    /// <returns>True — текущий пользователь установлен.</returns>
+
-    public static bool HasUser(this HttpContext context) => context.GetCurrentUser() is not null;
+    /// <summary>
-
+    /// Кладёт оператора в <c>HttpContext.Items</c>.
-    /// <summary>
+    /// </summary>
-    /// Кладёт оператора в <c>HttpContext.Items</c>.
+    /// <param name="context">Контекст запроса.</param>
-    /// </summary>
+    /// <param name="operatorIdentity">Оператор, разрешённый по операторской сессии.</param>
-    /// <param name="context">Контекст запроса.</param>
+    public static void SetCurrentOperator(this HttpContext context, CurrentOperator operatorIdentity) =>
-    /// <param name="operatorIdentity">Оператор, разрешённый по операторской сессии.</param>
+        context.Items[CurrentOperatorItemKey] = operatorIdentity;
-    public static void SetCurrentOperator(this HttpContext context, CurrentOperator operatorIdentity) =>
+
-        context.Items[CurrentOperatorItemKey] = operatorIdentity;
+    /// <summary>
-
+    /// Возвращает текущего оператора запроса или null, если операторская сессия не разрешена.
-    /// <summary>
+    /// </summary>
-    /// Возвращает текущего оператора запроса или null, если операторская сессия не разрешена.
+    /// <param name="context">Контекст запроса.</param>
-    /// </summary>
+    /// <returns>Оператор или null (ручка /api/operator/* отвечает 401).</returns>
-    /// <param name="context">Контекст запроса.</param>
+    public static CurrentOperator? GetCurrentOperator(this HttpContext context) =>
-    /// <returns>Оператор или null (ручка /api/operator/* отвечает 401).</returns>
+        context.Items[CurrentOperatorItemKey] as CurrentOperator;
-    public static CurrentOperator? GetCurrentOperator(this HttpContext context) =>
+}
-        context.Items[CurrentOperatorItemKey] as CurrentOperator;
-}

src/core/Deal.Api/Hosting/BudgetAlertScheduler.cs

@@ -1,220 +1,215 @@
-using Deal.Api.Events;
+using Deal.Api.Events;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Modules.Tenants.Application.Extensions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Models;
+
-using Deal.Modules.Tenants.Application.Registrars;
+namespace Deal.Api.Hosting;
-using Deal.Modules.Tenants.Application.Services;
+
-using Deal.Api.Services;
+/// <summary>
-using Deal.Api.Dtos;
+/// Фоновый цикл SSE-алертов ИИ-бюджета (Ruling 3, Task 9; эталон StorageTickScheduler): каждые 60 с
-
+/// обходит ВСЕ тенанты реестра и публикует в канал тенанта тост при пересечении порогов бюджета 80%/100%.
-namespace Deal.Api.Hosting;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// Пересечение порога детектируется CAS-установкой флагов Warned80/NotifiedExhausted
-/// Фоновый цикл SSE-алертов ИИ-бюджета (Ruling 3, Task 9; эталон StorageTickScheduler): каждые 60 с
+/// (<see cref="ITenantLimitStore.TryMarkWarnedAsync"/> / <see cref="ITenantLimitStore.TryMarkNotifiedExhaustedAsync"/>, Task 8): метод возвращает
-/// обходит ВСЕ тенанты реестра и публикует в канал тенанта тост при пересечении порогов бюджета 80%/100%.
+/// true только в момент «флаг ещё не стоял и порог достигнут» — публикация выполняется ровно один раз на порог
-/// </summary>
+/// за период (флаги сбрасываются ленивым reset периода и сменой бюджета оператором, Task 8/10). Флаги выставляет
-/// <remarks>
+/// ТОЛЬКО TryMark* (review-fix Task 9): AddUsage только инкрементирует UsedTokens, поэтому естественный расход,
-/// Пересечение порога детектируется CAS-установкой флагов Warned80/NotifiedExhausted
+/// пересекший порог, планировщик видит на ближайшем проходе как непомеченный переход — TryMark* возвращает true
-/// (<see cref="ITenantLimitStore.TryMarkWarnedAsync"/> / <see cref="ITenantLimitStore.TryMarkNotifiedExhaustedAsync"/>, Task 8): метод возвращает
+/// ровно один раз, и тост не теряется и не задваивается.
-/// true только в момент «флаг ещё не стоял и порог достигнут» — публикация выполняется ровно один раз на порог
+/// Тексты и иконка
-/// за период (флаги сбрасываются ленивым reset периода и сменой бюджета оператором, Task 8/10). Флаги выставляет
+/// 1:1 с Ruling 3 («ИИ-бюджет израсходован на 80%» / «ИИ-бюджет исчерпан — обработка в локальном режиме», icon
-/// ТОЛЬКО TryMark* (review-fix Task 9): AddUsage только инкрементирует UsedTokens, поэтому естественный расход,
+/// bell); SSE-тип — существующий 'toast' (Ruling 11: новых SSE-типов нет). Списывание usage выполняется в
-/// пересекший порог, планировщик видит на ближайшем проходе как непомеченный переход — TryMark* возвращает true
+/// gRPC-адаптерах (TokenUsageRecorder) и флаги при пересечении уже могут стоять — TryMark*-CAS не даёт
-/// ровно один раз, и тост не теряется и не задваивается.
+/// задвоить тост. Публикация в канал тенанта; без подписчиков — no-op, не падает (Ruling 5).
-/// Тексты и иконка
+/// <para>
-/// 1:1 с Ruling 3 («ИИ-бюджет израсходован на 80%» / «ИИ-бюджет исчерпан — обработка в локальном режиме», icon
+/// Лимиты живут в публичной схеме (ITenantLimitStore → DealDbContext) — в отличие от StorageTickScheduler
-/// bell); SSE-тип — существующий 'toast' (Ruling 11: новых SSE-типов нет). Списывание usage выполняется в
+/// tenant-контекст проходу не нужен (SetTenant не выполняется); проверка каждого тенанта — в собственном scope
-/// gRPC-адаптерах (TokenUsageRecorder) и флаги при пересечении уже могут стоять — TryMark*-CAS не даёт
+/// (scoped-хранилище лимитов). Первый проход — сразу после старта, далее по таймеру; перекрывающиеся проходы
-/// задвоить тост. Публикация в канал тенанта; без подписчиков — no-op, не падает (Ruling 5).
+/// исключены in-flight guard (Interlocked, как RatesRefreshScheduler). Ошибки логируются и наружу не выбрасываются
-/// <para>
+/// (проверка одного тенанта не валит проход); при остановке хоста таймер останавливается и текущий проход
-/// Лимиты живут в публичной схеме (ITenantLimitStore → DealDbContext) — в отличие от StorageTickScheduler
+/// отменяется (graceful).
-/// tenant-контекст проходу не нужен (SetTenant не выполняется); проверка каждого тенанта — в собственном scope
+/// </para>
-/// (scoped-хранилище лимитов). Первый проход — сразу после старта, далее по таймеру; перекрывающиеся проходы
+/// </remarks>
-/// исключены in-flight guard (Interlocked, как RatesRefreshScheduler). Ошибки логируются и наружу не выбрасываются
+public sealed class BudgetAlertScheduler : IHostedService
-/// (проверка одного тенанта не валит проход); при остановке хоста таймер останавливается и текущий проход
+{
-/// отменяется (graceful).
+    /// <summary>
-/// </para>
+    /// Период проходов цикла — 60 с (план Task 9: фоновая проверка порогов бюджета).
-/// </remarks>
+    /// </summary>
-public sealed class BudgetAlertScheduler : IHostedService
+    public const int AlertPeriodSeconds = 60;
-{
+
-    /// <summary>
+    // Тип SSE-события тоста (Ruling 5/11; api.js слушает 'toast', новых типов не вводим).
-    /// Период проходов цикла — 60 с (план Task 9: фоновая проверка порогов бюджета).
+    private const string ToastEventType = "toast";
-    /// </summary>
+
-    public const int AlertPeriodSeconds = 60;
+    // Текст тоста пересечения порога 80% (Ruling 3).
-
+    private const string Warned80ToastText = "ИИ-бюджет израсходован на 80%";
-    // Тип SSE-события тоста (Ruling 5/11; api.js слушает 'toast', новых типов не вводим).
+
-    private const string ToastEventType = "toast";
+    // Текст тоста исчерпания бюджета (Ruling 3).
-
+    private const string ExhaustedToastText = "ИИ-бюджет исчерпан — обработка в локальном режиме";
-    // Текст тоста пересечения порога 80% (Ruling 3).
+
-    private const string Warned80ToastText = "ИИ-бюджет израсходован на 80%";
+    // Иконка тостов бюджета (Ruling 3: bell).
-
+    private const string BellIcon = "bell";
-    // Текст тоста исчерпания бюджета (Ruling 3).
+
-    private const string ExhaustedToastText = "ИИ-бюджет исчерпан — обработка в локальном режиме";
+    private static readonly TimeSpan AlertPeriod = TimeSpan.FromSeconds(AlertPeriodSeconds);
-
+
-    // Иконка тостов бюджета (Ruling 3: bell).
+    private readonly IServiceScopeFactory _scopeFactory;
-    private const string BellIcon = "bell";
+    private readonly SseBroker _broker;
-
+    private readonly ILogger<BudgetAlertScheduler> _logger;
-    private static readonly TimeSpan AlertPeriod = TimeSpan.FromSeconds(AlertPeriodSeconds);
+
-
+    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы наблюдают токен).
-    private readonly IServiceScopeFactory _scopeFactory;
+    private readonly CancellationTokenSource _shutdownCts = new();
-    private readonly SseBroker _broker;
+
-    private readonly ILogger<BudgetAlertScheduler> _logger;
+    private Timer? _timer;
-
+    private Task? _currentIteration;
-    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы наблюдают токен).
+    private int _iterationInProgress;
-    private readonly CancellationTokenSource _shutdownCts = new();
+
-
+    /// <summary>
-    private Timer? _timer;
+    /// Создаёт планировщик фоновых алертов ИИ-бюджета.
-    private Task? _currentIteration;
+    /// </summary>
-    private int _iterationInProgress;
+    /// <param name="scopeFactory">Фабрика scope: проход цикла и проверка каждого тенанта — в собственных scope.</param>
-
+    /// <param name="broker">SSE-брокер каналов тенантов (публикация тостов; без подписчиков — no-op).</param>
-    /// <summary>
+    /// <param name="logger">Логгер ошибок цикла.</param>
-    /// Создаёт планировщик фоновых алертов ИИ-бюджета.
+    public BudgetAlertScheduler(
-    /// </summary>
+        IServiceScopeFactory scopeFactory,
-    /// <param name="scopeFactory">Фабрика scope: проход цикла и проверка каждого тенанта — в собственных scope.</param>
+        SseBroker broker,
-    /// <param name="broker">SSE-брокер каналов тенантов (публикация тостов; без подписчиков — no-op).</param>
+        ILogger<BudgetAlertScheduler> logger)
-    /// <param name="logger">Логгер ошибок цикла.</param>
+    {
-    public BudgetAlertScheduler(
+        ArgumentNullException.ThrowIfNull(scopeFactory);
-        IServiceScopeFactory scopeFactory,
+        ArgumentNullException.ThrowIfNull(broker);
-        SseBroker broker,
+        ArgumentNullException.ThrowIfNull(logger);
-        ILogger<BudgetAlertScheduler> logger)
+        _scopeFactory = scopeFactory;
-    {
+        _broker = broker;
-        ArgumentNullException.ThrowIfNull(scopeFactory);
+        _logger = logger;
-        ArgumentNullException.ThrowIfNull(broker);
+    }
-        ArgumentNullException.ThrowIfNull(logger);
+
-        _scopeFactory = scopeFactory;
+    /// <inheritdoc />
-        _broker = broker;
+    public Task StartAsync(CancellationToken ct)
-        _logger = logger;
+    {
-    }
+        // Первый проход — сразу после старта (как StorageTickScheduler), далее каждые 60 с.
-
+        _timer = new Timer(
-    /// <inheritdoc />
+            static state => ((BudgetAlertScheduler)state!).RunIteration(),
-    public Task StartAsync(CancellationToken ct)
+            this,
-    {
+            TimeSpan.Zero,
-        // Первый проход — сразу после старта (как StorageTickScheduler), далее каждые 60 с.
+            AlertPeriod);
-        _timer = new Timer(
+        return Task.CompletedTask;
-            static state => ((BudgetAlertScheduler)state!).RunIteration(),
+    }
-            this,
+
-            TimeSpan.Zero,
+    /// <inheritdoc />
-            AlertPeriod);
+    public async Task StopAsync(CancellationToken ct)
-        return Task.CompletedTask;
+    {
-    }
+        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
-
+        // остановки хоста (HostOptions.ShutdownTimeout).
-    /// <inheritdoc />
+        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
-    public async Task StopAsync(CancellationToken ct)
+        _timer?.Dispose();
-    {
+        _timer = null;
-        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
+
-        // остановки хоста (HostOptions.ShutdownTimeout).
+        _shutdownCts.Cancel();
-        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
+        Task? iteration = Volatile.Read(ref _currentIteration);
-        _timer?.Dispose();
+        if (iteration is not null)
-        _timer = null;
+        {
-
+            try
-        _shutdownCts.Cancel();
+            {
-        Task? iteration = Volatile.Read(ref _currentIteration);
+                await iteration.WaitAsync(ct);
-        if (iteration is not null)
+            }
-        {
+            catch (OperationCanceledException)
-            try
+            {
-            {
+                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
-                await iteration.WaitAsync(ct);
+                // RunCycleCoreAsync, незавершённый проход безопасно завершится на отменённом токене.
-            }
+            }
-            catch (OperationCanceledException)
+        }
-            {
+    }
-                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
+
-                // RunCycleCoreAsync, незавершённый проход безопасно завершится на отменённом токене.
+    /// <summary>
-            }
+    /// Один проход цикла: список тенантов реестра и проверка порогов каждого (no-op, если проход идёт).
-        }
+    /// </summary>
-    }
+    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются); таймер
-
+    /// вызывает этот же метод. Ошибки и отмена токена наружу не выбрасываются: сбои логируются (цикл живёт),
-    /// <summary>
+    /// отмена по токену останова завершает проход штатно.</remarks>
-    /// Один проход цикла: список тенантов реестра и проверка порогов каждого (no-op, если проход идёт).
+    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
-    /// </summary>
+    /// <returns>Задача прохода (завершается без исключений).</returns>
-    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются); таймер
+    public Task RunCycleAsync(CancellationToken ct)
-    /// вызывает этот же метод. Ошибки и отмена токена наружу не выбрасываются: сбои логируются (цикл живёт),
+    {
-    /// отмена по токену останова завершает проход штатно.</remarks>
+        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
-    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
+        {
-    /// <returns>Задача прохода (завершается без исключений).</returns>
+            return Task.CompletedTask;
-    public Task RunCycleAsync(CancellationToken ct)
+        }
-    {
+
-        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
+        Task iteration = RunCycleCoreAsync(ct);
-        {
+        Volatile.Write(ref _currentIteration, iteration);
-            return Task.CompletedTask;
+        return iteration;
-        }
+    }
-
+
-        Task iteration = RunCycleCoreAsync(ct);
+    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
-        Volatile.Write(ref _currentIteration, iteration);
+    private void RunIteration()
-        return iteration;
+    {
-    }
+        _ = RunCycleAsync(_shutdownCts.Token);
-
+    }
-    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
+
-    private void RunIteration()
+    // Тело прохода: проверка порогов каждого тенанта реестра; guard сбрасывается в finally.
-    {
+    // ct: Токен отмены (остановка хоста).
-        _ = RunCycleAsync(_shutdownCts.Token);
+    private async Task RunCycleCoreAsync(CancellationToken ct)
-    }
+    {
-
+        try
-    // Тело прохода: проверка порогов каждого тенанта реестра; guard сбрасывается в finally.
+        {
-    // ct: Токен отмены (остановка хоста).
+            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
-    private async Task RunCycleCoreAsync(CancellationToken ct)
+            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
-    {
+            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
-        try
+
-        {
+            foreach (TenantRecordDto tenant in tenants)
-            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
+            {
-            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
+                await CheckTenantAsync(tenant, ct);
-            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
+            }
-
+        }
-            foreach (TenantRecordDto tenant in tenants)
+        catch (OperationCanceledException)
-            {
+        {
-                await CheckTenantAsync(tenant, ct);
+            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
-            }
+        }
-        }
+        catch (Exception exception)
-        catch (OperationCanceledException)
+        {
-        {
+            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
-            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
+            _logger.LogError(exception, "Цикл бюджет-алертов: проход по тенантам не удался");
-        }
+        }
-        catch (Exception exception)
+        finally
-        {
+        {
-            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
+            Interlocked.Exchange(ref _iterationInProgress, 0);
-            _logger.LogError(exception, "Цикл бюджет-алертов: проход по тенантам не удался");
+        }
-        }
+    }
-        finally
+
-        {
+    // Проверка порогов одного тенанта в собственном scope: TryMark* (CAS) → тост в канал тенанта.
-            Interlocked.Exchange(ref _iterationInProgress, 0);
+    // Список тенантов и лимиты живут в публичной схеме — tenant-контекст не заполняется (в отличие от
-        }
+    // тиков StorageTickScheduler, работающих со схемой тенанта). Порядок: сначала 80% (Warned80), затем 100%
-    }
+    // (NotifiedExhausted) — при скачке через оба порога за период выходят оба тоста по одному разу. Сбой одного
-
+    // тенанта не валит проход: ошибка логируется, остальные тенанты обрабатываются; отмена (OCE) пробрасывается
-    // Проверка порогов одного тенанта в собственном scope: TryMark* (CAS) → тост в канал тенанта.
+    // наверх — проход завершается.
-    // Список тенантов и лимиты живут в публичной схеме — tenant-контекст не заполняется (в отличие от
+    // tenant: Тенант реестра (Id в формате Guid).
-    // тиков StorageTickScheduler, работающих со схемой тенанта). Порядок: сначала 80% (Warned80), затем 100%
+    // ct: Токен отмены прохода.
-    // (NotifiedExhausted) — при скачке через оба порога за период выходят оба тоста по одному разу. Сбой одного
+    private async Task CheckTenantAsync(TenantRecordDto tenant, CancellationToken ct)
-    // тенанта не валит проход: ошибка логируется, остальные тенанты обрабатываются; отмена (OCE) пробрасывается
+    {
-    // наверх — проход завершается.
+        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
-    // tenant: Тенант реестра (Id в формате Guid).
+        try
-    // ct: Токен отмены прохода.
+        {
-    private async Task CheckTenantAsync(TenantRecordDto tenant, CancellationToken ct)
+            ITenantLimitStore limitStore = tenantScope.ServiceProvider.GetRequiredService<ITenantLimitStore>();
-    {
+
-        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
+            // TryMark* — атомарная установка флага: true только в момент первого наблюдения порога за период
-        try
+            // (Task 8/9). Тост публикуется ровно один раз на порог; повторные проходы — false → no-op.
-        {
+            if (await limitStore.TryMarkWarnedAsync(tenant.Id, ct))
-            ITenantLimitStore limitStore = tenantScope.ServiceProvider.GetRequiredService<ITenantLimitStore>();
+            {
-
+                _logger.LogDebug("Бюджет тенанта {TenantId}: порог 80% пересечён — SSE-тост", tenant.Id);
-            // TryMark* — атомарная установка флага: true только в момент первого наблюдения порога за период
+                _broker.Publish(tenant.Id, ToastEventType, new { text = Warned80ToastText, icon = BellIcon });
-            // (Task 8/9). Тост публикуется ровно один раз на порог; повторные проходы — false → no-op.
+            }
-            if (await limitStore.TryMarkWarnedAsync(tenant.Id, ct))
+
-            {
+            if (await limitStore.TryMarkNotifiedExhaustedAsync(tenant.Id, ct))
-                _logger.LogDebug("Бюджет тенанта {TenantId}: порог 80% пересечён — SSE-тост", tenant.Id);
+            {
-                _broker.Publish(tenant.Id, ToastEventType, new { text = Warned80ToastText, icon = BellIcon });
+                _logger.LogDebug("Бюджет тенанта {TenantId}: исчерпан — SSE-тост", tenant.Id);
-            }
+                _broker.Publish(tenant.Id, ToastEventType, new { text = ExhaustedToastText, icon = BellIcon });
-
+            }
-            if (await limitStore.TryMarkNotifiedExhaustedAsync(tenant.Id, ct))
+        }
-            {
+        catch (OperationCanceledException)
-                _logger.LogDebug("Бюджет тенанта {TenantId}: исчерпан — SSE-тост", tenant.Id);
+        {
-                _broker.Publish(tenant.Id, ToastEventType, new { text = ExhaustedToastText, icon = BellIcon });
+            throw;
-            }
+        }
-        }
+        catch (Exception exception)
-        catch (OperationCanceledException)
+        {
-        {
+            _logger.LogWarning(exception, "Цикл бюджет-алертов: проверка тенанта {TenantId} не удалась", tenant.Id);
-            throw;
+        }
-        }
+    }
-        catch (Exception exception)
+}
-        {
-            _logger.LogWarning(exception, "Цикл бюджет-алертов: проверка тенанта {TenantId} не удалась", tenant.Id);
-        }
-    }
-}

src/core/Deal.Api/Hosting/DataRetentionScheduler.cs

@@ -1,11 +1,5 @@
 using Deal.Api.Configuration;
 using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Modules.Tenants.Application.Extensions;
-using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Registrars;
-using Deal.Modules.Tenants.Application.Services;
-using Deal.Api.Services;
-using Deal.Api.Dtos;
 
 namespace Deal.Api.Hosting;
 

src/core/Deal.Api/Hosting/DiscoveryWorkerScheduler.cs

@@ -1,196 +1,187 @@
-using Deal.Modules.Discovery.Application.Abstractions;
+using Deal.Modules.Discovery.Application.Models;
-using Deal.Modules.Discovery.Application.Exceptions;
+using Deal.Modules.Discovery.Application.Services;
-using Deal.Modules.Discovery.Application.Extensions;
+using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Modules.Discovery.Application.Models;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Discovery.Application.Registrars;
+using Deal.SharedKernel.Tenants.Abstractions;
-using Deal.Modules.Discovery.Application.Services;
+using Deal.SharedKernel.Tenants.Models;
-using Deal.Modules.Tenants.Application.Abstractions;
+
-using Deal.Modules.Tenants.Application.Extensions;
+namespace Deal.Api.Hosting;
-using Deal.Modules.Tenants.Application.Models;
+
-using Deal.Modules.Tenants.Application.Registrars;
+/// <summary>
-using Deal.Modules.Tenants.Application.Services;
+/// Фоновый цикл Discovery-воркера по всем тенантам (план Task 18, Ruling 10; эталон PipelineWorkerScheduler/StorageTickScheduler).
-using Deal.SharedKernel.Tenants.Abstractions;
+/// </summary>
-using Deal.SharedKernel.Tenants.Models;
+/// <remarks>
-using Deal.Api.Services;
+/// Каждые 5 с (в прототипе — <c>_discovery_loop</c> main.py: tick раз в ~5 секунд) обходит ВСЕ тенанты
-using Deal.Api.Dtos;
+/// системного реестра и для каждого выполняет один тик <see cref="DiscoveryWorkerService.TickOnceAsync"/> в
-
+/// собственном scope с <c>ITenantContext.SetTenant</c> (эталон StorageTickScheduler). Тик делает ОДНО действие
-namespace Deal.Api.Hosting;
+/// (поиск/оценка/вступление/done) для самой старой running-задачи тенанта — 1:1 с discovery_worker.tick L444–484.
-
+/// Как StorageTickScheduler: первый проход — сразу после старта, далее по таймеру; перекрывающиеся проходы
-/// <summary>
+/// исключены in-flight guard (Interlocked) — следующее срабатывание пропускается, если проход длится дольше
-/// Фоновый цикл Discovery-воркера по всем тенантам (план Task 18, Ruling 10; эталон PipelineWorkerScheduler/StorageTickScheduler).
+/// периода (в частности, при паузах авто-вступлений 50–70 с внутри тика). Ошибки логируются и наружу не
-/// </summary>
+/// выбрасываются (тик одного тенанта не валит проход); при остановке хоста таймер останавливается и текущий
-/// <remarks>
+/// проход отменяется (graceful). Пустой проход (нет running-задач/пауза/flood) — тихий no-op (action none).
-/// Каждые 5 с (в прототипе — <c>_discovery_loop</c> main.py: tick раз в ~5 секунд) обходит ВСЕ тенанты
+/// </remarks>
-/// системного реестра и для каждого выполняет один тик <see cref="DiscoveryWorkerService.TickOnceAsync"/> в
+public sealed class DiscoveryWorkerScheduler : IHostedService
-/// собственном scope с <c>ITenantContext.SetTenant</c> (эталон StorageTickScheduler). Тик делает ОДНО действие
+{
-/// (поиск/оценка/вступление/done) для самой старой running-задачи тенанта — 1:1 с discovery_worker.tick L444–484.
+    // Период тиков цикла — 5 с (в прототипе _discovery_loop: tick каждые ~5 секунд).
-/// Как StorageTickScheduler: первый проход — сразу после старта, далее по таймеру; перекрывающиеся проходы
+    private const int DiscoveryPeriodSeconds = 5;
-/// исключены in-flight guard (Interlocked) — следующее срабатывание пропускается, если проход длится дольше
+
-/// периода (в частности, при паузах авто-вступлений 50–70 с внутри тика). Ошибки логируются и наружу не
+    private static readonly TimeSpan DiscoveryPeriod = TimeSpan.FromSeconds(DiscoveryPeriodSeconds);
-/// выбрасываются (тик одного тенанта не валит проход); при остановке хоста таймер останавливается и текущий
+
-/// проход отменяется (graceful). Пустой проход (нет running-задач/пауза/flood) — тихий no-op (action none).
+    private readonly IServiceScopeFactory _scopeFactory;
-/// </remarks>
+    private readonly ILogger<DiscoveryWorkerScheduler> _logger;
-public sealed class DiscoveryWorkerScheduler : IHostedService
+
-{
+    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы тика наблюдают токен).
-    // Период тиков цикла — 5 с (в прототипе _discovery_loop: tick каждые ~5 секунд).
+    private readonly CancellationTokenSource _shutdownCts = new();
-    private const int DiscoveryPeriodSeconds = 5;
+
-
+    private Timer? _timer;
-    private static readonly TimeSpan DiscoveryPeriod = TimeSpan.FromSeconds(DiscoveryPeriodSeconds);
+    private Task? _currentIteration;
-
+    private int _iterationInProgress;
-    private readonly IServiceScopeFactory _scopeFactory;
+
-    private readonly ILogger<DiscoveryWorkerScheduler> _logger;
+    /// <summary>
-
+    /// Создаёт планировщик фонового цикла Discovery.
-    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы тика наблюдают токен).
+    /// </summary>
-    private readonly CancellationTokenSource _shutdownCts = new();
+    /// <param name="scopeFactory">Фабрика scope: проход цикла и тик каждого тенанта — в собственных scope.</param>
-
+    /// <param name="logger">Логгер ошибок цикла.</param>
-    private Timer? _timer;
+    public DiscoveryWorkerScheduler(IServiceScopeFactory scopeFactory, ILogger<DiscoveryWorkerScheduler> logger)
-    private Task? _currentIteration;
+    {
-    private int _iterationInProgress;
+        ArgumentNullException.ThrowIfNull(scopeFactory);
-
+        ArgumentNullException.ThrowIfNull(logger);
-    /// <summary>
+        _scopeFactory = scopeFactory;
-    /// Создаёт планировщик фонового цикла Discovery.
+        _logger = logger;
-    /// </summary>
+    }
-    /// <param name="scopeFactory">Фабрика scope: проход цикла и тик каждого тенанта — в собственных scope.</param>
+
-    /// <param name="logger">Логгер ошибок цикла.</param>
+    /// <inheritdoc />
-    public DiscoveryWorkerScheduler(IServiceScopeFactory scopeFactory, ILogger<DiscoveryWorkerScheduler> logger)
+    public Task StartAsync(CancellationToken ct)
-    {
+    {
-        ArgumentNullException.ThrowIfNull(scopeFactory);
+        // Первый проход — сразу после старта (как StorageTickScheduler), далее каждые 5 с.
-        ArgumentNullException.ThrowIfNull(logger);
+        _timer = new Timer(
-        _scopeFactory = scopeFactory;
+            static state => ((DiscoveryWorkerScheduler)state!).RunIteration(),
-        _logger = logger;
+            this,
-    }
+            TimeSpan.Zero,
-
+            DiscoveryPeriod);
-    /// <inheritdoc />
+        return Task.CompletedTask;
-    public Task StartAsync(CancellationToken ct)
+    }
-    {
+
-        // Первый проход — сразу после старта (как StorageTickScheduler), далее каждые 5 с.
+    /// <inheritdoc />
-        _timer = new Timer(
+    public async Task StopAsync(CancellationToken ct)
-            static state => ((DiscoveryWorkerScheduler)state!).RunIteration(),
+    {
-            this,
+        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
-            TimeSpan.Zero,
+        // остановки хоста (HostOptions.ShutdownTimeout).
-            DiscoveryPeriod);
+        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
-        return Task.CompletedTask;
+        _timer?.Dispose();
-    }
+        _timer = null;
-
+
-    /// <inheritdoc />
+        _shutdownCts.Cancel();
-    public async Task StopAsync(CancellationToken ct)
+        Task? iteration = Volatile.Read(ref _currentIteration);
-    {
+        if (iteration is not null)
-        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
+        {
-        // остановки хоста (HostOptions.ShutdownTimeout).
+            try
-        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
+            {
-        _timer?.Dispose();
+                await iteration.WaitAsync(ct);
-        _timer = null;
+            }
-
+            catch (OperationCanceledException)
-        _shutdownCts.Cancel();
+            {
-        Task? iteration = Volatile.Read(ref _currentIteration);
+                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
-        if (iteration is not null)
+                // RunCycleAsync, незавершённый проход безопасно завершится на отменённом токене.
-        {
+            }
-            try
+        }
-            {
+    }
-                await iteration.WaitAsync(ct);
+
-            }
+    /// <summary>
-            catch (OperationCanceledException)
+    /// Один проход цикла: список тенантов реестра и тик каждого (no-op, если проход уже идёт).
-            {
+    /// </summary>
-                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
+    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются) и
-                // RunCycleAsync, незавершённый проход безопасно завершится на отменённом токене.
+    /// ручного вызова при отладке; таймер вызывает этот же метод. Ошибки и отмена токена наружу не
-            }
+    /// выбрасываются: сбои логируются (цикл живёт), отмена по токену останова завершает проход штатно.</remarks>
-        }
+    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
-    }
+    /// <returns>Задача прохода (завершается без исключений).</returns>
-
+    public Task RunCycleAsync(CancellationToken ct)
-    /// <summary>
+    {
-    /// Один проход цикла: список тенантов реестра и тик каждого (no-op, если проход уже идёт).
+        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
-    /// </summary>
+        {
-    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются) и
+            return Task.CompletedTask;
-    /// ручного вызова при отладке; таймер вызывает этот же метод. Ошибки и отмена токена наружу не
+        }
-    /// выбрасываются: сбои логируются (цикл живёт), отмена по токену останова завершает проход штатно.</remarks>
+
-    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
+        Task iteration = RunCycleCoreAsync(ct);
-    /// <returns>Задача прохода (завершается без исключений).</returns>
+        Volatile.Write(ref _currentIteration, iteration);
-    public Task RunCycleAsync(CancellationToken ct)
+        return iteration;
-    {
+    }
-        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
+
-        {
+    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
-            return Task.CompletedTask;
+    private void RunIteration()
-        }
+    {
-
+        _ = RunCycleAsync(_shutdownCts.Token);
-        Task iteration = RunCycleCoreAsync(ct);
+    }
-        Volatile.Write(ref _currentIteration, iteration);
+
-        return iteration;
+    // Тело прохода: тик Discovery каждого тенанта реестра; guard сбрасывается в finally.
-    }
+    // ct: Токен отмены (остановка хоста).
-
+    private async Task RunCycleCoreAsync(CancellationToken ct)
-    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
+    {
-    private void RunIteration()
+        try
-    {
+        {
-        _ = RunCycleAsync(_shutdownCts.Token);
+            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
-    }
+            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
-
+            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
-    // Тело прохода: тик Discovery каждого тенанта реестра; guard сбрасывается в finally.
+
-    // ct: Токен отмены (остановка хоста).
+            foreach (TenantRecordDto tenant in tenants)
-    private async Task RunCycleCoreAsync(CancellationToken ct)
+            {
-    {
+                await TickTenantAsync(tenant, ct);
-        try
+            }
-        {
+        }
-            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
+        catch (OperationCanceledException)
-            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
+        {
-            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
+            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
-
+        }
-            foreach (TenantRecordDto tenant in tenants)
+        catch (Exception exception)
-            {
+        {
-                await TickTenantAsync(tenant, ct);
+            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
-            }
+            _logger.LogError(exception, "Цикл Discovery: проход по тенантам не удался");
-        }
+        }
-        catch (OperationCanceledException)
+        finally
-        {
+        {
-            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
+            Interlocked.Exchange(ref _iterationInProgress, 0);
-        }
+        }
-        catch (Exception exception)
+    }
-        {
+
-            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
+    // Тик одного тенанта в собственном scope: SetTenant → один тик воркера; Reset в finally.
-            _logger.LogError(exception, "Цикл Discovery: проход по тенантам не удался");
+    // Контекст AsyncLocal сбрасывается в finally, чтобы не переживать scope тенанта (как
-        }
+    // SessionMiddleware). Тик одного тенанта не валит проход: ошибка логируется, остальные тенанты
-        finally
+    // обрабатываются; отмена (OCE) пробрасывается наверх — проход завершается. Результат «none» — тихий
-        {
+    // no-op (пауза/нет работы); прочие действия логируются в Debug (рабочие события — в DiscLog задачи).
-            Interlocked.Exchange(ref _iterationInProgress, 0);
+    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
-        }
+    // ct: Токен отмены прохода.
-    }
+    private async Task TickTenantAsync(TenantRecordDto tenant, CancellationToken ct)
-
+    {
-    // Тик одного тенанта в собственном scope: SetTenant → один тик воркера; Reset в finally.
+        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
-    // Контекст AsyncLocal сбрасывается в finally, чтобы не переживать scope тенанта (как
+        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
-    // SessionMiddleware). Тик одного тенанта не валит проход: ошибка логируется, остальные тенанты
+        try
-    // обрабатываются; отмена (OCE) пробрасывается наверх — проход завершается. Результат «none» — тихий
+        {
-    // no-op (пауза/нет работы); прочие действия логируются в Debug (рабочие события — в DiscLog задачи).
+            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
-    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
+
-    // ct: Токен отмены прохода.
+            // Resolve ПОСЛЕ SetTenant: TenantDbContext (и его адаптеры) строятся от схемы текущего тенанта.
-    private async Task TickTenantAsync(TenantRecordDto tenant, CancellationToken ct)
+            DiscoveryWorkerService worker = tenantScope.ServiceProvider.GetRequiredService<DiscoveryWorkerService>();
-    {
+            DiscoveryWorkerOutcome outcome = await worker.TickOnceAsync(ct);
-        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
+            if (outcome.Action != DiscoveryWorkerService.ActionNone)
-        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
+            {
-        try
+                _logger.LogDebug(
-        {
+                    "Discovery-тик {TenantId}: {Action} (задача {TaskId})",
-            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
+                    tenant.Id,
-
+                    outcome.Action,
-            // Resolve ПОСЛЕ SetTenant: TenantDbContext (и его адаптеры) строятся от схемы текущего тенанта.
+                    outcome.TaskId ?? "-");
-            DiscoveryWorkerService worker = tenantScope.ServiceProvider.GetRequiredService<DiscoveryWorkerService>();
+            }
-            DiscoveryWorkerOutcome outcome = await worker.TickOnceAsync(ct);
+        }
-            if (outcome.Action != DiscoveryWorkerService.ActionNone)
+        catch (OperationCanceledException)
-            {
+        {
-                _logger.LogDebug(
+            throw;
-                    "Discovery-тик {TenantId}: {Action} (задача {TaskId})",
+        }
-                    tenant.Id,
+        catch (Exception exception)
-                    outcome.Action,
+        {
-                    outcome.TaskId ?? "-");
+            _logger.LogWarning(exception, "Цикл Discovery: тик тенанта {TenantId} не удался", tenant.Id);
-            }
+        }
-        }
+        finally
-        catch (OperationCanceledException)
+        {
-        {
+            tenantContext.Reset();
-            throw;
+        }
-        }
+    }
-        catch (Exception exception)
+}
-        {
-            _logger.LogWarning(exception, "Цикл Discovery: тик тенанта {TenantId} не удался", tenant.Id);
-        }
-        finally
-        {
-            tenantContext.Reset();
-        }
-    }
-}

src/core/Deal.Api/Hosting/MlOutboxFlushScheduler.cs

@@ -1,245 +1,232 @@
-using Deal.Infrastructure.Integrations.Abstractions;
+using Deal.Infrastructure.Integrations.Abstractions;
-using Deal.Infrastructure.Integrations.Exceptions;
+using Deal.Modules.Kanban.Application.Abstractions;
-using Deal.Infrastructure.Integrations.Extensions;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Infrastructure.Integrations.Models;
+using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Infrastructure.Integrations.Options;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Infrastructure.Integrations.Services;
+using Deal.SharedKernel.Tenants.Abstractions;
-using Deal.Modules.Kanban.Application.Abstractions;
+using Deal.SharedKernel.Tenants.Models;
-using Deal.Modules.Kanban.Application.Extensions;
+
-using Deal.Modules.Kanban.Application.Models;
+namespace Deal.Api.Hosting;
-using Deal.Modules.Kanban.Application.Registrars;
+
-using Deal.Modules.Kanban.Application.Services;
+/// <summary>
-using Deal.Modules.Tenants.Application.Abstractions;
+/// Фоновый флашер очереди обучения ML — выгрузка MlOutbox в ml-service батчами (план Task 16, Ruling 6).
-using Deal.Modules.Tenants.Application.Extensions;
+/// </summary>
-using Deal.Modules.Tenants.Application.Models;
+/// <remarks>
-using Deal.Modules.Tenants.Application.Registrars;
+/// Аналог <c>_ml_sync_loop</c> python-прототипа и <c>flush_outbox</c> (ml_client.py L56–82): каждые 10 с
-using Deal.Modules.Tenants.Application.Services;
+/// обходит ВСЕ тенанты реестра и в собственном scope с <c>ITenantContext.SetTenant</c> (эталон
-using Deal.SharedKernel.Tenants.Abstractions;
+/// PipelineWorkerScheduler/StorageTickScheduler) отправляет накопленное обучение RPC TrainBatch порциями по
-using Deal.SharedKernel.Tenants.Models;
+/// 10 строк, ≤100 за цикл. Строки удаляются ТОЛЬКО после успешного батча (python L78–79); при недоступности
-using Deal.Api.Services;
+/// ml-service порция остаётся и уходит в следующий цикл (ретрай на каждом тике, «строки остаются» — Ruling 6).
-using Deal.Api.Dtos;
+/// <para>
-
+/// Регистрируется в Deal.Api только при <c>Services:Ml:UseLocal=false</c> (gRPC-режим): Local-режиму
-namespace Deal.Api.Hosting;
+/// ml-service не нужен — очередь копится (этап 3), а при «поднятом сервисе» флашер выгружает её сразу.
-
+/// Первый проход — сразу после старта (как PipelineWorkerScheduler); перекрывающиеся проходы исключены
-/// <summary>
+/// in-flight guard (Interlocked). Ошибки логируются и наружу не выбрасываются (флаш одного тенанта не
-/// Фоновый флашер очереди обучения ML — выгрузка MlOutbox в ml-service батчами (план Task 16, Ruling 6).
+/// валит цикл — остальные тенанты обрабатываются); при остановке хоста таймер останавливается и текущий
-/// </summary>
+/// проход отменяется (graceful). Пустая очередь — тихий no-op.
-/// <remarks>
+/// </para>
-/// Аналог <c>_ml_sync_loop</c> python-прототипа и <c>flush_outbox</c> (ml_client.py L56–82): каждые 10 с
+/// </remarks>
-/// обходит ВСЕ тенанты реестра и в собственном scope с <c>ITenantContext.SetTenant</c> (эталон
+public sealed class MlOutboxFlushScheduler : IHostedService
-/// PipelineWorkerScheduler/StorageTickScheduler) отправляет накопленное обучение RPC TrainBatch порциями по
+{
-/// 10 строк, ≤100 за цикл. Строки удаляются ТОЛЬКО после успешного батча (python L78–79); при недоступности
+    /// <summary>
-/// ml-service порция остаётся и уходит в следующий цикл (ретрай на каждом тике, «строки остаются» — Ruling 6).
+    /// Период циклов выгрузки — 10 с (Ruling 6).
-/// <para>
+    /// </summary>
-/// Регистрируется в Deal.Api только при <c>Services:Ml:UseLocal=false</c> (gRPC-режим): Local-режиму
+    public const int FlushPeriodSeconds = 10;
-/// ml-service не нужен — очередь копится (этап 3), а при «поднятом сервисе» флашер выгружает её сразу.
+
-/// Первый проход — сразу после старта (как PipelineWorkerScheduler); перекрывающиеся проходы исключены
+    /// <summary>
-/// in-flight guard (Interlocked). Ошибки логируются и наружу не выбрасываются (флаш одного тенанта не
+    /// Размер порции за один TrainBatch — 10 строк (ml_client.flush_outbox L63: chunk=10).
-/// валит цикл — остальные тенанты обрабатываются); при остановке хоста таймер останавливается и текущий
+    /// </summary>
-/// проход отменяется (graceful). Пустая очередь — тихий no-op.
+    public const int BatchSize = 10;
-/// </para>
+
-/// </remarks>
+    /// <summary>
-public sealed class MlOutboxFlushScheduler : IHostedService
+    /// Потолок выгрузки за один цикл тенанта — 100 строк (ml_client.flush_outbox L56: batch=100).
-{
+    /// </summary>
-    /// <summary>
+    public const int MaxPerCycle = 100;
-    /// Период циклов выгрузки — 10 с (Ruling 6).
+
-    /// </summary>
+    private readonly IServiceScopeFactory _scopeFactory;
-    public const int FlushPeriodSeconds = 10;
+    private readonly ILogger<MlOutboxFlushScheduler> _logger;
-
+
-    /// <summary>
+    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы наблюдают токен).
-    /// Размер порции за один TrainBatch — 10 строк (ml_client.flush_outbox L63: chunk=10).
+    private readonly CancellationTokenSource _shutdownCts = new();
-    /// </summary>
+
-    public const int BatchSize = 10;
+    private Timer? _timer;
-
+    private Task? _currentIteration;
-    /// <summary>
+    private int _iterationInProgress;
-    /// Потолок выгрузки за один цикл тенанта — 100 строк (ml_client.flush_outbox L56: batch=100).
+
-    /// </summary>
+    /// <summary>
-    public const int MaxPerCycle = 100;
+    /// Создаёт планировщик фоновой выгрузки очереди обучения ML.
-
+    /// </summary>
-    private readonly IServiceScopeFactory _scopeFactory;
+    /// <param name="scopeFactory">Фабрика scope: проход цикла и флаш каждого тенанта — в собственных scope.</param>
-    private readonly ILogger<MlOutboxFlushScheduler> _logger;
+    /// <param name="logger">Логгер сбоев цикла.</param>
-
+    public MlOutboxFlushScheduler(IServiceScopeFactory scopeFactory, ILogger<MlOutboxFlushScheduler> logger)
-    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы наблюдают токен).
+    {
-    private readonly CancellationTokenSource _shutdownCts = new();
+        ArgumentNullException.ThrowIfNull(scopeFactory);
-
+        ArgumentNullException.ThrowIfNull(logger);
-    private Timer? _timer;
+        _scopeFactory = scopeFactory;
-    private Task? _currentIteration;
+        _logger = logger;
-    private int _iterationInProgress;
+    }
-
+
-    /// <summary>
+    /// <inheritdoc />
-    /// Создаёт планировщик фоновой выгрузки очереди обучения ML.
+    public Task StartAsync(CancellationToken ct)
-    /// </summary>
+    {
-    /// <param name="scopeFactory">Фабрика scope: проход цикла и флаш каждого тенанта — в собственных scope.</param>
+        // Первый проход — сразу после старта (как PipelineWorkerScheduler), далее каждые 10 с.
-    /// <param name="logger">Логгер сбоев цикла.</param>
+        _timer = new Timer(
-    public MlOutboxFlushScheduler(IServiceScopeFactory scopeFactory, ILogger<MlOutboxFlushScheduler> logger)
+            static state => ((MlOutboxFlushScheduler)state!).RunIteration(),
-    {
+            this,
-        ArgumentNullException.ThrowIfNull(scopeFactory);
+            TimeSpan.Zero,
-        ArgumentNullException.ThrowIfNull(logger);
+            TimeSpan.FromSeconds(FlushPeriodSeconds));
-        _scopeFactory = scopeFactory;
+        return Task.CompletedTask;
-        _logger = logger;
+    }
-    }
+
-
+    /// <inheritdoc />
-    /// <inheritdoc />
+    public async Task StopAsync(CancellationToken ct)
-    public Task StartAsync(CancellationToken ct)
+    {
-    {
+        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
-        // Первый проход — сразу после старта (как PipelineWorkerScheduler), далее каждые 10 с.
+        // остановки хоста (HostOptions.ShutdownTimeout).
-        _timer = new Timer(
+        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
-            static state => ((MlOutboxFlushScheduler)state!).RunIteration(),
+        _timer?.Dispose();
-            this,
+        _timer = null;
-            TimeSpan.Zero,
+
-            TimeSpan.FromSeconds(FlushPeriodSeconds));
+        _shutdownCts.Cancel();
-        return Task.CompletedTask;
+        Task? iteration = Volatile.Read(ref _currentIteration);
-    }
+        if (iteration is not null)
-
+        {
-    /// <inheritdoc />
+            try
-    public async Task StopAsync(CancellationToken ct)
+            {
-    {
+                await iteration.WaitAsync(ct);
-        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
+            }
-        // остановки хоста (HostOptions.ShutdownTimeout).
+            catch (OperationCanceledException)
-        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
+            {
-        _timer?.Dispose();
+                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
-        _timer = null;
+                // FlushCycleCoreAsync, незавершённый проход безопасно завершится на отменённом токене.
-
+            }
-        _shutdownCts.Cancel();
+        }
-        Task? iteration = Volatile.Read(ref _currentIteration);
+    }
-        if (iteration is not null)
+
-        {
+    /// <summary>
-            try
+    /// Один проход цикла: список тенантов реестра и выгрузка каждого (no-op, если проход уже идёт).
-            {
+    /// </summary>
-                await iteration.WaitAsync(ct);
+    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются);
-            }
+    /// таймер вызывает этот же метод. Ошибки и отмена токена наружу не выбрасываются: сбои логируются
-            catch (OperationCanceledException)
+    /// (цикл живёт), отмена по токену останова завершает проход штатно.</remarks>
-            {
+    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
-                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
+    /// <returns>Задача прохода (завершается без исключений).</returns>
-                // FlushCycleCoreAsync, незавершённый проход безопасно завершится на отменённом токене.
+    public Task RunCycleAsync(CancellationToken ct)
-            }
+    {
-        }
+        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
-    }
+        {
-
+            return Task.CompletedTask;
-    /// <summary>
+        }
-    /// Один проход цикла: список тенантов реестра и выгрузка каждого (no-op, если проход уже идёт).
+
-    /// </summary>
+        Task iteration = FlushCycleCoreAsync(ct);
-    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются);
+        Volatile.Write(ref _currentIteration, iteration);
-    /// таймер вызывает этот же метод. Ошибки и отмена токена наружу не выбрасываются: сбои логируются
+        return iteration;
-    /// (цикл живёт), отмена по токену останова завершает проход штатно.</remarks>
+    }
-    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
+
-    /// <returns>Задача прохода (завершается без исключений).</returns>
+    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
-    public Task RunCycleAsync(CancellationToken ct)
+    private void RunIteration()
-    {
+    {
-        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
+        _ = RunCycleAsync(_shutdownCts.Token);
-        {
+    }
-            return Task.CompletedTask;
+
-        }
+    // Тело прохода: выгрузка очереди каждого тенанта реестра; guard сбрасывается в finally.
-
+    // ct: Токен отмены (остановка хоста).
-        Task iteration = FlushCycleCoreAsync(ct);
+    private async Task FlushCycleCoreAsync(CancellationToken ct)
-        Volatile.Write(ref _currentIteration, iteration);
+    {
-        return iteration;
+        try
-    }
+        {
-
+            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
-    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
+            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
-    private void RunIteration()
+            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
-    {
+
-        _ = RunCycleAsync(_shutdownCts.Token);
+            foreach (TenantRecordDto tenant in tenants)
-    }
+            {
-
+                await FlushTenantAsync(tenant, ct);
-    // Тело прохода: выгрузка очереди каждого тенанта реестра; guard сбрасывается в finally.
+            }
-    // ct: Токен отмены (остановка хоста).
+        }
-    private async Task FlushCycleCoreAsync(CancellationToken ct)
+        catch (OperationCanceledException)
-    {
+        {
-        try
+            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
-        {
+        }
-            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
+        catch (Exception exception)
-            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
+        {
-            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
+            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
-
+            _logger.LogError(exception, "Флашер ML-outbox: проход по тенантам не удался");
-            foreach (TenantRecordDto tenant in tenants)
+        }
-            {
+        finally
-                await FlushTenantAsync(tenant, ct);
+        {
-            }
+            Interlocked.Exchange(ref _iterationInProgress, 0);
-        }
+        }
-        catch (OperationCanceledException)
+    }
-        {
+
-            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
+    // Выгрузка очереди одного тенанта в собственном scope: SetTenant → порции по 10 до ≤100/цикл.
-        }
+    // Строки удаляются только после успешного TrainBatch (Ruling 6); сбой батча — порция остаётся,
-        catch (Exception exception)
+    // цикл тенанта завершается (следующая попытка — следующий тик). Сбой хранилища тенанта не валит проход:
-        {
+    // ошибка логируется, остальные тенанты обрабатываются; отмена (OCE) пробрасывается наверх.
-            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
+    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
-            _logger.LogError(exception, "Флашер ML-outbox: проход по тенантам не удался");
+    // ct: Токен отмены прохода.
-        }
+    private async Task FlushTenantAsync(TenantRecordDto tenant, CancellationToken ct)
-        finally
+    {
-        {
+        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
-            Interlocked.Exchange(ref _iterationInProgress, 0);
+        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
-        }
+        try
-    }
+        {
-
+            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
-    // Выгрузка очереди одного тенанта в собственном scope: SetTenant → порции по 10 до ≤100/цикл.
+
-    // Строки удаляются только после успешного TrainBatch (Ruling 6); сбой батча — порция остаётся,
+            // Resolve ПОСЛЕ SetTenant: IMlLearningStore строится от схемы текущего тенанта (как в цикле pump).
-    // цикл тенанта завершается (следующая попытка — следующий тик). Сбой хранилища тенанта не валит проход:
+            IMlLearningStore learningStore = tenantScope.ServiceProvider.GetRequiredService<IMlLearningStore>();
-    // ошибка логируется, остальные тенанты обрабатываются; отмена (OCE) пробрасывается наверх.
+            IMlTrainClient trainClient = tenantScope.ServiceProvider.GetRequiredService<IMlTrainClient>();
-    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
+
-    // ct: Токен отмены прохода.
+            int total = 0;
-    private async Task FlushTenantAsync(TenantRecordDto tenant, CancellationToken ct)
+            while (total < MaxPerCycle)
-    {
+            {
-        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
+                IReadOnlyList<MlOutboxEntryDto> rows = await learningStore.TakeOutboxBatchAsync(BatchSize, ct);
-        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
+                if (rows.Count == 0)
-        try
+                {
-        {
+                    break;
-            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
+                }
-
+
-            // Resolve ПОСЛЕ SetTenant: IMlLearningStore строится от схемы текущего тенанта (как в цикле pump).
+                try
-            IMlLearningStore learningStore = tenantScope.ServiceProvider.GetRequiredService<IMlLearningStore>();
+                {
-            IMlTrainClient trainClient = tenantScope.ServiceProvider.GetRequiredService<IMlTrainClient>();
+                    await trainClient.TrainBatchAsync(rows, ct);
-
+                }
-            int total = 0;
+                catch (OperationCanceledException)
-            while (total < MaxPerCycle)
+                {
-            {
+                    throw;
-                IReadOnlyList<MlOutboxEntryDto> rows = await learningStore.TakeOutboxBatchAsync(BatchSize, ct);
+                }
-                if (rows.Count == 0)
+                catch (Exception exception)
-                {
+                {
-                    break;
+                    // Недоступность/сбой ml-service: порция остаётся в очереди (python L75–77), следующая
-                }
+                    // попытка — на следующем тике; флашер не роняет проход цикла.
-
+                    _logger.LogWarning(
-                try
+                        exception,
-                {
+                        "Флашер ML-outbox: отправка {RowCount} строк тенанта {TenantId} не удалась — строки остались",
-                    await trainClient.TrainBatchAsync(rows, ct);
+                        rows.Count,
-                }
+                        tenant.Id);
-                catch (OperationCanceledException)
+                    break;
-                {
+                }
-                    throw;
+
-                }
+                // Удаление только после успеха (python L78–79): отправленные строки больше не нужны.
-                catch (Exception exception)
+                await learningStore.DeleteOutboxAsync(rows.Select(row => row.Id).ToList(), ct);
-                {
+                total += rows.Count;
-                    // Недоступность/сбой ml-service: порция остаётся в очереди (python L75–77), следующая
+            }
-                    // попытка — на следующем тике; флашер не роняет проход цикла.
+
-                    _logger.LogWarning(
+            if (total > 0)
-                        exception,
+            {
-                        "Флашер ML-outbox: отправка {RowCount} строк тенанта {TenantId} не удалась — строки остались",
+                _logger.LogInformation("Флашер ML-outbox: выгружено {RowCount} строк тенанта {TenantId}", total, tenant.Id);
-                        rows.Count,
+            }
-                        tenant.Id);
+        }
-                    break;
+        catch (OperationCanceledException)
-                }
+        {
-
+            throw;
-                // Удаление только после успеха (python L78–79): отправленные строки больше не нужны.
+        }
-                await learningStore.DeleteOutboxAsync(rows.Select(row => row.Id).ToList(), ct);
+        catch (Exception exception)
-                total += rows.Count;
+        {
-            }
+            _logger.LogWarning(exception, "Флашер ML-outbox: выгрузка тенанта {TenantId} не удалась", tenant.Id);
-
+        }
-            if (total > 0)
+        finally
-            {
+        {
-                _logger.LogInformation("Флашер ML-outbox: выгружено {RowCount} строк тенанта {TenantId}", total, tenant.Id);
+            tenantContext.Reset();
-            }
+        }
-        }
+    }
-        catch (OperationCanceledException)
+}
-        {
-            throw;
-        }
-        catch (Exception exception)
-        {
-            _logger.LogWarning(exception, "Флашер ML-outbox: выгрузка тенанта {TenantId} не удалась", tenant.Id);
-        }
-        finally
-        {
-            tenantContext.Reset();
-        }
-    }
-}

src/core/Deal.Api/Hosting/OperatorBootstrapHostedService.cs

@@ -1,102 +1,96 @@
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Extensions;
+
-using Deal.Modules.Tenants.Application.Models;
+namespace Deal.Api.Hosting;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+/// <summary>
-using Deal.Api.Services;
+/// Hosted-шаг bootstrap оператора при старте (Ruling 1 этапа 7): env DEAL_OPERATOR_* → OperatorBootstrapService.EnsureOperatorAsync.
-using Deal.Api.Dtos;
+/// </summary>
-
+/// <remarks>
-namespace Deal.Api.Hosting;
+/// Регистрируется после <see cref="TenantBootstrapService"/> и работает тем же паттерном: OperatorBootstrapService —
-
+/// scoped (его IOperatorAuthStore живёт на scoped DealDbContext), поэтому резолвится в собственном scope из
-/// <summary>
+/// IServiceScopeFactory (как TenantService в TenantBootstrapService). Идемпотентен: существующего оператора
-/// Hosted-шаг bootstrap оператора при старте (Ruling 1 этапа 7): env DEAL_OPERATOR_* → OperatorBootstrapService.EnsureOperatorAsync.
+/// не пересоздаёт и пароль не перезаписывает. В Development без env-кред используется dev-дефолт
-/// </summary>
+/// operator/operator (зеркало dev-seed admin/admin, логируется как dev-режим); в Production без env-кред
-/// <remarks>
+/// шаг пропускается с warning — оператора заводит админ позже через env и рестарт хоста (кода регистрации
-/// Регистрируется после <see cref="TenantBootstrapService"/> и работает тем же паттерном: OperatorBootstrapService —
+/// оператора нет). Частичная конфигурация (задана ровно одна из DEAL_OPERATOR_LOGIN/DEAL_OPERATOR_PASSWORD)
-/// scoped (его IOperatorAuthStore живёт на scoped DealDbContext), поэтому резолвится в собственном scope из
+/// логируется warning — не молчаливый дефолт (решение ревью Task 2): в Development используются dev-дефолты,
-/// IServiceScopeFactory (как TenantService в TenantBootstrapService). Идемпотентен: существующего оператора
+/// в Production шаг пропускается. Секреты (пароли) в логи не пишутся (правило этапов 1–6).
-/// не пересоздаёт и пароль не перезаписывает. В Development без env-кред используется dev-дефолт
+/// </remarks>
-/// operator/operator (зеркало dev-seed admin/admin, логируется как dev-режим); в Production без env-кред
+public sealed class OperatorBootstrapHostedService(
-/// шаг пропускается с warning — оператора заводит админ позже через env и рестарт хоста (кода регистрации
+    IServiceScopeFactory scopeFactory,
-/// оператора нет). Частичная конфигурация (задана ровно одна из DEAL_OPERATOR_LOGIN/DEAL_OPERATOR_PASSWORD)
+    IConfiguration configuration,
-/// логируется warning — не молчаливый дефолт (решение ревью Task 2): в Development используются dev-дефолты,
+    IHostEnvironment environment,
-/// в Production шаг пропускается. Секреты (пароли) в логи не пишутся (правило этапов 1–6).
+    ILogger<OperatorBootstrapHostedService> logger) : IHostedService
-/// </remarks>
+{
-public sealed class OperatorBootstrapHostedService(
+    /// <inheritdoc />
-    IServiceScopeFactory scopeFactory,
+    public async Task StartAsync(CancellationToken ct)
-    IConfiguration configuration,
+    {
-    IHostEnvironment environment,
+        await using var scope = scopeFactory.CreateAsyncScope();
-    ILogger<OperatorBootstrapHostedService> logger) : IHostedService
+        var operatorBootstrapService = scope.ServiceProvider.GetRequiredService<OperatorBootstrapService>();
-{
+
-    /// <inheritdoc />
+        var login = configuration[OperatorBootstrapService.LoginEnvKey];
-    public async Task StartAsync(CancellationToken ct)
+        var password = configuration[OperatorBootstrapService.PasswordEnvKey];
-    {
+        bool hasLogin = !string.IsNullOrWhiteSpace(login);
-        await using var scope = scopeFactory.CreateAsyncScope();
+        bool hasPassword = !string.IsNullOrWhiteSpace(password);
-        var operatorBootstrapService = scope.ServiceProvider.GetRequiredService<OperatorBootstrapService>();
+        bool allowDevelopmentDefaults = environment.IsDevelopment();
-
+
-        var login = configuration[OperatorBootstrapService.LoginEnvKey];
+        // Предупреждения о пропуске/частичной конфигурации логируются ДО вызова шага — сам шаг
-        var password = configuration[OperatorBootstrapService.PasswordEnvKey];
+        // в этих случаях ничего не создаёт (EnsureOperatorAsync возвращает null, хранилище не тронуто).
-        bool hasLogin = !string.IsNullOrWhiteSpace(login);
+        if (!hasLogin || !hasPassword)
-        bool hasPassword = !string.IsNullOrWhiteSpace(password);
+        {
-        bool allowDevelopmentDefaults = environment.IsDevelopment();
+            if (hasLogin != hasPassword)
-
+            {
-        // Предупреждения о пропуске/частичной конфигурации логируются ДО вызова шага — сам шаг
+                LogPartialConfigurationWarning(hasLogin, allowDevelopmentDefaults);
-        // в этих случаях ничего не создаёт (EnsureOperatorAsync возвращает null, хранилище не тронуто).
+            }
-        if (!hasLogin || !hasPassword)
+            else if (!allowDevelopmentDefaults)
-        {
+            {
-            if (hasLogin != hasPassword)
+                // Production без кред: пропуск с warning (Ruling 1) — кода регистрации оператора нет.
-            {
+                logger.LogWarning(
-                LogPartialConfigurationWarning(hasLogin, allowDevelopmentDefaults);
+                    "DEAL_OPERATOR_LOGIN/DEAL_OPERATOR_PASSWORD не заданы (Production) — bootstrap оператора "
-            }
+                    + "пропущен. Оператор заводится позже: задайте env DEAL_OPERATOR_* и перезапустите хост.");
-            else if (!allowDevelopmentDefaults)
+            }
-            {
+            else
-                // Production без кред: пропуск с warning (Ruling 1) — кода регистрации оператора нет.
+            {
-                logger.LogWarning(
+                // Development без кред: штатный dev-дефолт (зеркало dev-seed admin/admin).
-                    "DEAL_OPERATOR_LOGIN/DEAL_OPERATOR_PASSWORD не заданы (Production) — bootstrap оператора "
+                logger.LogInformation(
-                    + "пропущен. Оператор заводится позже: задайте env DEAL_OPERATOR_* и перезапустите хост.");
+                    "DEAL_OPERATOR_LOGIN/DEAL_OPERATOR_PASSWORD не заданы (Development) — используется "
-            }
+                    + "dev-дефолт оператора {DefaultLogin}.",
-            else
+                    OperatorBootstrapService.DefaultOperatorLogin);
-            {
+            }
-                // Development без кред: штатный dev-дефолт (зеркало dev-seed admin/admin).
+        }
-                logger.LogInformation(
+
-                    "DEAL_OPERATOR_LOGIN/DEAL_OPERATOR_PASSWORD не заданы (Development) — используется "
+        var ensuredLogin = await operatorBootstrapService.EnsureOperatorAsync(
-                    + "dev-дефолт оператора {DefaultLogin}.",
+            login, password, allowDevelopmentDefaults, ct);
-                    OperatorBootstrapService.DefaultOperatorLogin);
+        if (ensuredLogin is not null)
-            }
+        {
-        }
+            logger.LogInformation("Bootstrap оператора: оператор {Login} присутствует.", ensuredLogin);
-
+        }
-        var ensuredLogin = await operatorBootstrapService.EnsureOperatorAsync(
+    }
-            login, password, allowDevelopmentDefaults, ct);
+
-        if (ensuredLogin is not null)
+    /// <inheritdoc />
-        {
+    public Task StopAsync(CancellationToken ct) => Task.CompletedTask;
-            logger.LogInformation("Bootstrap оператора: оператор {Login} присутствует.", ensuredLogin);
+
-        }
+    // Логирует warning о неполной env-конфигурации (задана одна из двух переменных).
-    }
+    // hasLogin: Задан ли логин (пароль при этом пуст).
-
+    // allowDevelopmentDefaults: Разрешены ли dev-дефолты (Development).
-    /// <inheritdoc />
+    private void LogPartialConfigurationWarning(bool hasLogin, bool allowDevelopmentDefaults)
-    public Task StopAsync(CancellationToken ct) => Task.CompletedTask;
+    {
-
+        string missingEnv = hasLogin
-    // Логирует warning о неполной env-конфигурации (задана одна из двух переменных).
+            ? OperatorBootstrapService.PasswordEnvKey
-    // hasLogin: Задан ли логин (пароль при этом пуст).
+            : OperatorBootstrapService.LoginEnvKey;
-    // allowDevelopmentDefaults: Разрешены ли dev-дефолты (Development).
+        if (allowDevelopmentDefaults)
-    private void LogPartialConfigurationWarning(bool hasLogin, bool allowDevelopmentDefaults)
+        {
-    {
+            logger.LogWarning(
-        string missingEnv = hasLogin
+                "Env-конфигурация оператора неполна: не задан {MissingEnv}. В Development используются "
-            ? OperatorBootstrapService.PasswordEnvKey
+                + "dev-дефолты оператора {DefaultLogin}.",
-            : OperatorBootstrapService.LoginEnvKey;
+                missingEnv, OperatorBootstrapService.DefaultOperatorLogin);
-        if (allowDevelopmentDefaults)
+        }
-        {
+        else
-            logger.LogWarning(
+        {
-                "Env-конфигурация оператора неполна: не задан {MissingEnv}. В Development используются "
+            logger.LogWarning(
-                + "dev-дефолты оператора {DefaultLogin}.",
+                "Env-конфигурация оператора неполна: не задан {MissingEnv}. Bootstrap оператора в Production "
-                missingEnv, OperatorBootstrapService.DefaultOperatorLogin);
+                + "пропущен — оператор заводится позже через env DEAL_OPERATOR_* и рестарт хоста.",
-        }
+                missingEnv);
-        else
+        }
-        {
+    }
-            logger.LogWarning(
+}
-                "Env-конфигурация оператора неполна: не задан {MissingEnv}. Bootstrap оператора в Production "
-                + "пропущен — оператор заводится позже через env DEAL_OPERATOR_* и рестарт хоста.",
-                missingEnv);
-        }
-    }
-}

src/core/Deal.Api/Hosting/StorageTickScheduler.cs

@@ -1,252 +1,241 @@
-using Deal.Api.Events;
+using Deal.Api.Events;
-using Deal.Modules.Kanban.Application.Abstractions;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Modules.Kanban.Application.Extensions;
+using Deal.Modules.Kanban.Application.Services;
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Pipeline.Application.Services;
-using Deal.Modules.Kanban.Application.Registrars;
+using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Modules.Kanban.Application.Services;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Pipeline.Application.Abstractions;
+using Deal.SharedKernel.Tenants.Abstractions;
-using Deal.Modules.Pipeline.Application.Models;
+using Deal.SharedKernel.Tenants.Models;
-using Deal.Modules.Pipeline.Application.Registrars;
+
-using Deal.Modules.Pipeline.Application.Services;
+namespace Deal.Api.Hosting;
-using Deal.Modules.Tenants.Application.Abstractions;
+
-using Deal.Modules.Tenants.Application.Extensions;
+/// <summary>
-using Deal.Modules.Tenants.Application.Models;
+/// Фоновый цикл правил хранения по всем тенантам (план Tasks 11–12, Rulings 3/8; аналог _storage_loop main.py L43–53).
-using Deal.Modules.Tenants.Application.Registrars;
+/// </summary>
-using Deal.Modules.Tenants.Application.Services;
+/// <remarks>
-using Deal.SharedKernel.Tenants.Abstractions;
+/// Каждые 30 с (в прототипе — <c>asyncio.sleep(30)</c>, main.py L53) обходит ВСЕ тенанты системного
-using Deal.SharedKernel.Tenants.Models;
+/// реестра. Проход открывает собственный scope (реестр живёт в публичной схеме — ITenantRepository вне
-using Deal.Api.Services;
+/// tenant-контекста, паттерн TenantBootstrapService), на каждый тенант — вложенный scope с
-using Deal.Api.Dtos;
+/// ITenantContext.SetTenant (эталон SessionMiddleware/TenantBootstrapService) и StorageTickService.TickAsync,
-
+/// после чего — автоочистка отсева пайплайна (<see cref="PipelineProcessingService.PurgeExpiredAsync"/>, 3 суток;
-namespace Deal.Api.Hosting;
+/// Task 11, Ruling 8/9: фоновый аналог тика AdminTickOrchestrator, tick_storage L485–493), SSE-тосты
-
+/// статистики в канал тенанта (StorageToastPublisher; без подписчиков — no-op, Ruling 5) и проверка
-/// <summary>
+/// наступивших напоминаний «Отложено» (CardsService.CheckDueRemindersAsync + SSE reminder_due, Task 12,
-/// Фоновый цикл правил хранения по всем тенантам (план Tasks 11–12, Rulings 3/8; аналог _storage_loop main.py L43–53).
+/// Ruling 3/8 — фоновый аналог ветки AdminTickOrchestrator, check_reminders из _storage_loop main.py L49).
-/// </summary>
+/// Порядок тика тенанта 1:1 с _storage_loop main.py L47–53: тик → тосты → напоминания. Как в прототипе,
-/// <remarks>
+/// первый проход выполняется сразу после старта (тик до первого sleep), далее — по таймеру. Параллельные
-/// Каждые 30 с (в прототипе — <c>asyncio.sleep(30)</c>, main.py L53) обходит ВСЕ тенанты системного
+/// проходы исключены in-flight guard (Interlocked, как RatesRefreshScheduler): если проход длится дольше
-/// реестра. Проход открывает собственный scope (реестр живёт в публичной схеме — ITenantRepository вне
+/// периода, следующее срабатывание таймера пропускается. Ошибки логируются и наружу не выбрасываются
-/// tenant-контекста, паттерн TenantBootstrapService), на каждый тенант — вложенный scope с
+/// (тик одного тенанта не валит проход); при остановке хоста таймер останавливается и текущий проход
-/// ITenantContext.SetTenant (эталон SessionMiddleware/TenantBootstrapService) и StorageTickService.TickAsync,
+/// отменяется (graceful).
-/// после чего — автоочистка отсева пайплайна (<see cref="PipelineProcessingService.PurgeExpiredAsync"/>, 3 суток;
+/// </remarks>
-/// Task 11, Ruling 8/9: фоновый аналог тика AdminTickOrchestrator, tick_storage L485–493), SSE-тосты
+public sealed class StorageTickScheduler : IHostedService
-/// статистики в канал тенанта (StorageToastPublisher; без подписчиков — no-op, Ruling 5) и проверка
+{
-/// наступивших напоминаний «Отложено» (CardsService.CheckDueRemindersAsync + SSE reminder_due, Task 12,
+    // Период проходов цикла — 30 с, 1:1 с _storage_loop main.py L53 (asyncio.sleep(30)).
-/// Ruling 3/8 — фоновый аналог ветки AdminTickOrchestrator, check_reminders из _storage_loop main.py L49).
+    private const int TickPeriodSeconds = 30;
-/// Порядок тика тенанта 1:1 с _storage_loop main.py L47–53: тик → тосты → напоминания. Как в прототипе,
+
-/// первый проход выполняется сразу после старта (тик до первого sleep), далее — по таймеру. Параллельные
+    // SSE-тип события «выстрелившего» напоминания «Отложено» (Ruling 8, api-map §2: {id,title,containerId}).
-/// проходы исключены in-flight guard (Interlocked, как RatesRefreshScheduler): если проход длится дольше
+    private const string ReminderDueEventType = "reminder_due";
-/// периода, следующее срабатывание таймера пропускается. Ошибки логируются и наружу не выбрасываются
+
-/// (тик одного тенанта не валит проход); при остановке хоста таймер останавливается и текущий проход
+    private static readonly TimeSpan TickPeriod = TimeSpan.FromSeconds(TickPeriodSeconds);
-/// отменяется (graceful).
+
-/// </remarks>
+    private readonly IServiceScopeFactory _scopeFactory;
-public sealed class StorageTickScheduler : IHostedService
+    private readonly StorageToastPublisher _toastPublisher;
-{
+    private readonly SseBroker _broker;
-    // Период проходов цикла — 30 с, 1:1 с _storage_loop main.py L53 (asyncio.sleep(30)).
+    private readonly ILogger<StorageTickScheduler> _logger;
-    private const int TickPeriodSeconds = 30;
+
-
+    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы тика наблюдают токен).
-    // SSE-тип события «выстрелившего» напоминания «Отложено» (Ruling 8, api-map §2: {id,title,containerId}).
+    private readonly CancellationTokenSource _shutdownCts = new();
-    private const string ReminderDueEventType = "reminder_due";
+
-
+    private Timer? _timer;
-    private static readonly TimeSpan TickPeriod = TimeSpan.FromSeconds(TickPeriodSeconds);
+    private Task? _currentIteration;
-
+    private int _iterationInProgress;
-    private readonly IServiceScopeFactory _scopeFactory;
+
-    private readonly StorageToastPublisher _toastPublisher;
+    /// <summary>
-    private readonly SseBroker _broker;
+    /// Создаёт планировщик фонового цикла правил хранения.
-    private readonly ILogger<StorageTickScheduler> _logger;
+    /// </summary>
-
+    /// <param name="scopeFactory">Фабрика scope: проход цикла и тик каждого тенанта — в собственных scope.</param>
-    // Отмена при остановке хоста: прерывает текущий проход (EF-запросы тика наблюдают токен).
+    /// <param name="toastPublisher">Публикатор SSE-тостов статистики тика (общий с POST /api/admin/tick).</param>
-    private readonly CancellationTokenSource _shutdownCts = new();
+    /// <param name="broker">SSE-брокер каналов тенантов: reminder_due «выстреливших» напоминаний в канал тенанта
-
+    /// (как StorageToastPublisher; без подписчиков публикация — no-op, Ruling 5).</param>
-    private Timer? _timer;
+    /// <param name="logger">Логгер ошибок цикла.</param>
-    private Task? _currentIteration;
+    public StorageTickScheduler(
-    private int _iterationInProgress;
+        IServiceScopeFactory scopeFactory,
-
+        StorageToastPublisher toastPublisher,
-    /// <summary>
+        SseBroker broker,
-    /// Создаёт планировщик фонового цикла правил хранения.
+        ILogger<StorageTickScheduler> logger)
-    /// </summary>
+    {
-    /// <param name="scopeFactory">Фабрика scope: проход цикла и тик каждого тенанта — в собственных scope.</param>
+        ArgumentNullException.ThrowIfNull(scopeFactory);
-    /// <param name="toastPublisher">Публикатор SSE-тостов статистики тика (общий с POST /api/admin/tick).</param>
+        ArgumentNullException.ThrowIfNull(toastPublisher);
-    /// <param name="broker">SSE-брокер каналов тенантов: reminder_due «выстреливших» напоминаний в канал тенанта
+        ArgumentNullException.ThrowIfNull(broker);
-    /// (как StorageToastPublisher; без подписчиков публикация — no-op, Ruling 5).</param>
+        ArgumentNullException.ThrowIfNull(logger);
-    /// <param name="logger">Логгер ошибок цикла.</param>
+        _scopeFactory = scopeFactory;
-    public StorageTickScheduler(
+        _toastPublisher = toastPublisher;
-        IServiceScopeFactory scopeFactory,
+        _broker = broker;
-        StorageToastPublisher toastPublisher,
+        _logger = logger;
-        SseBroker broker,
+    }
-        ILogger<StorageTickScheduler> logger)
+
-    {
+    /// <inheritdoc />
-        ArgumentNullException.ThrowIfNull(scopeFactory);
+    public Task StartAsync(CancellationToken ct)
-        ArgumentNullException.ThrowIfNull(toastPublisher);
+    {
-        ArgumentNullException.ThrowIfNull(broker);
+        // Первый проход — сразу после старта (в прототипе тик выполняется до первого sleep); далее каждые 30 с.
-        ArgumentNullException.ThrowIfNull(logger);
+        _timer = new Timer(
-        _scopeFactory = scopeFactory;
+            static state => ((StorageTickScheduler)state!).RunIteration(),
-        _toastPublisher = toastPublisher;
+            this,
-        _broker = broker;
+            TimeSpan.Zero,
-        _logger = logger;
+            TickPeriod);
-    }
+        return Task.CompletedTask;
-
+    }
-    /// <inheritdoc />
+
-    public Task StartAsync(CancellationToken ct)
+    /// <inheritdoc />
-    {
+    public async Task StopAsync(CancellationToken ct)
-        // Первый проход — сразу после старта (в прототипе тик выполняется до первого sleep); далее каждые 30 с.
+    {
-        _timer = new Timer(
+        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
-            static state => ((StorageTickScheduler)state!).RunIteration(),
+        // остановки хоста (HostOptions.ShutdownTimeout).
-            this,
+        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
-            TimeSpan.Zero,
+        _timer?.Dispose();
-            TickPeriod);
+        _timer = null;
-        return Task.CompletedTask;
+
-    }
+        _shutdownCts.Cancel();
-
+        Task? iteration = Volatile.Read(ref _currentIteration);
-    /// <inheritdoc />
+        if (iteration is not null)
-    public async Task StopAsync(CancellationToken ct)
+        {
-    {
+            try
-        // Новые проходы не запускаем; текущий отменяем и ждём его завершения — не дольше лимита
+            {
-        // остановки хоста (HostOptions.ShutdownTimeout).
+                await iteration.WaitAsync(ct);
-        _timer?.Change(Timeout.InfiniteTimeSpan, Timeout.InfiniteTimeSpan);
+            }
-        _timer?.Dispose();
+            catch (OperationCanceledException)
-        _timer = null;
+            {
-
+                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
-        _shutdownCts.Cancel();
+                // RunCycleAsync, незавершённый проход безопасно завершится на отменённом токене.
-        Task? iteration = Volatile.Read(ref _currentIteration);
+            }
-        if (iteration is not null)
+        }
-        {
+    }
-            try
+
-            {
+    /// <summary>
-                await iteration.WaitAsync(ct);
+    /// Один проход цикла: список тенантов реестра и тик каждого (no-op, если проход уже идёт).
-            }
+    /// </summary>
-            catch (OperationCanceledException)
+    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются) и
-            {
+    /// ручного вызова при отладке; таймер вызывает этот же метод. Ошибки и отмена токена наружу не
-                // Лимит остановки истёк — хост продолжает остановку; ошибки прохода проглочены внутри
+    /// выбрасываются: сбои логируются (цикл живёт), отмена по токену останова завершает проход штатно.</remarks>
-                // RunCycleAsync, незавершённый проход безопасно завершится на отменённом токене.
+    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
-            }
+    /// <returns>Задача прохода (завершается без исключений).</returns>
-        }
+    public Task RunCycleAsync(CancellationToken ct)
-    }
+    {
-
+        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
-    /// <summary>
+        {
-    /// Один проход цикла: список тенантов реестра и тик каждого (no-op, если проход уже идёт).
+            return Task.CompletedTask;
-    /// </summary>
+        }
-    /// <remarks>Публичен как точка запуска прохода для unit-тестов (тайминги цикла не тестируются) и
+
-    /// ручного вызова при отладке; таймер вызывает этот же метод. Ошибки и отмена токена наружу не
+        Task iteration = RunCycleCoreAsync(ct);
-    /// выбрасываются: сбои логируются (цикл живёт), отмена по токену останова завершает проход штатно.</remarks>
+        Volatile.Write(ref _currentIteration, iteration);
-    /// <param name="ct">Токен отмены прохода (в проде — токен остановки хоста).</param>
+        return iteration;
-    /// <returns>Задача прохода (завершается без исключений).</returns>
+    }
-    public Task RunCycleAsync(CancellationToken ct)
+
-    {
+    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
-        if (Interlocked.CompareExchange(ref _iterationInProgress, 1, 0) != 0)
+    private void RunIteration()
-        {
+    {
-            return Task.CompletedTask;
+        _ = RunCycleAsync(_shutdownCts.Token);
-        }
+    }
-
+
-        Task iteration = RunCycleCoreAsync(ct);
+    // Тело прохода: тик каждого тенанта реестра; guard сбрасывается в finally.
-        Volatile.Write(ref _currentIteration, iteration);
+    // ct: Токен отмены (остановка хоста).
-        return iteration;
+    private async Task RunCycleCoreAsync(CancellationToken ct)
-    }
+    {
-
+        try
-    // Запускает проход из callback таймера (guard — внутри RunCycleAsync).
+        {
-    private void RunIteration()
+            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
-    {
+            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
-        _ = RunCycleAsync(_shutdownCts.Token);
+            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
-    }
+
-
+            foreach (TenantRecordDto tenant in tenants)
-    // Тело прохода: тик каждого тенанта реестра; guard сбрасывается в finally.
+            {
-    // ct: Токен отмены (остановка хоста).
+                await TickTenantAsync(tenant, ct);
-    private async Task RunCycleCoreAsync(CancellationToken ct)
+            }
-    {
+        }
-        try
+        catch (OperationCanceledException)
-        {
+        {
-            await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
+            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
-            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
+        }
-            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
+        catch (Exception exception)
-
+        {
-            foreach (TenantRecordDto tenant in tenants)
+            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
-            {
+            _logger.LogError(exception, "Цикл правил хранения: проход по тенантам не удался");
-                await TickTenantAsync(tenant, ct);
+        }
-            }
+        finally
-        }
+        {
-        catch (OperationCanceledException)
+            Interlocked.Exchange(ref _iterationInProgress, 0);
-        {
+        }
-            // Остановка хоста: проход прерван по токену — штатный выход, не ошибка.
+    }
-        }
+
-        catch (Exception exception)
+    // Тик одного тенанта в собственном scope: SetTenant → Kanban-тик → purge отсева → SSE-тосты →
-        {
+    // проверка напоминаний + SSE reminder_due; Reset в finally (1:1 с _storage_loop main.py L47–53: тик →
-            // Сбой всего прохода (реестр недоступен и т.п.): логируем, цикл продолжит со следующего тика.
+    // тосты → напоминания).
-            _logger.LogError(exception, "Цикл правил хранения: проход по тенантам не удался");
+    // Контекст AsyncLocal сбрасывается в finally, чтобы не переживать scope тенанта (как
-        }
+    // SessionMiddleware). Тик одного тенанта не валит проход: ошибка ветки/тенанта логируется, остальные
-        finally
+    // тенанты обрабатываются; отмена (OCE) пробрасывается наверх — проход завершается.
-        {
+    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
-            Interlocked.Exchange(ref _iterationInProgress, 0);
+    // ct: Токен отмены прохода.
-        }
+    private async Task TickTenantAsync(TenantRecordDto tenant, CancellationToken ct)
-    }
+    {
-
+        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
-    // Тик одного тенанта в собственном scope: SetTenant → Kanban-тик → purge отсева → SSE-тосты →
+        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
-    // проверка напоминаний + SSE reminder_due; Reset в finally (1:1 с _storage_loop main.py L47–53: тик →
+        try
-    // тосты → напоминания).
+        {
-    // Контекст AsyncLocal сбрасывается в finally, чтобы не переживать scope тенанта (как
+            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
-    // SessionMiddleware). Тик одного тенанта не валит проход: ошибка ветки/тенанта логируется, остальные
+
-    // тенанты обрабатываются; отмена (OCE) пробрасывается наверх — проход завершается.
+            // Resolve ПОСЛЕ SetTenant: TenantDbContext (и его адаптеры) строятся от схемы текущего тенанта.
-    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
+            StorageTickService tickService = tenantScope.ServiceProvider.GetRequiredService<StorageTickService>();
-    // ct: Токен отмены прохода.
+            StorageTickStatsDto stats = await tickService.TickAsync(ct);
-    private async Task TickTenantAsync(TenantRecordDto tenant, CancellationToken ct)
+
-    {
+            // Автоочистка отсева пайплайна: записи старше 3 суток — безвозвратно (Task 11, Ruling 8/9;
-        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
+            // tick_storage L485–493). Счётчик вливается в storage.purgedRejected — как ручной тик
-        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
+            // (AdminTickOrchestrator), тост «Отсев очищен: N записей (3 дн.)» публикуется этой же веткой.
-        try
+            PipelineProcessingService processing = tenantScope.ServiceProvider.GetRequiredService<PipelineProcessingService>();
-        {
+            int purgedRejected = await processing.PurgeExpiredAsync(ct);
-            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
+            StorageTickStatsDto mergedStats = stats with { PurgedRejected = purgedRejected };
-
+
-            // Resolve ПОСЛЕ SetTenant: TenantDbContext (и его адаптеры) строятся от схемы текущего тенанта.
+            // Тосты — в канал тенанта (публикация из Api-слоя, Ruling 5; без подписчиков — no-op).
-            StorageTickService tickService = tenantScope.ServiceProvider.GetRequiredService<StorageTickService>();
+            _toastPublisher.PublishTickToasts(tenant.Id, mergedStats);
-            StorageTickStatsDto stats = await tickService.TickAsync(ct);
+
-
+            // Проверка наступивших напоминаний «Отложено» (Task 12, Ruling 3/8; proj_svc.check_reminders из
-            // Автоочистка отсева пайплайна: записи старше 3 суток — безвозвратно (Task 11, Ruling 8/9;
+            // _storage_loop main.py L49): CheckDueRemindersAsync помечает due-строки hold-карточек fired и
-            // tick_storage L485–493). Счётчик вливается в storage.purgedRejected — как ручной тик
+            // возвращает их {id,title,containerId}. Сбой проверки НЕ роняет тик тенанта/проход: лог-предупреждение,
-            // (AdminTickOrchestrator), тост «Отсев очищен: N записей (3 дн.)» публикуется этой же веткой.
+            // остальные тенанты обрабатываются (паттерн ветки AdminTickOrchestrator). SSE reminder_due по каждой
-            PipelineProcessingService processing = tenantScope.ServiceProvider.GetRequiredService<PipelineProcessingService>();
+            // записи — в канал тенанта (Ruling 8: публикации только из Api; toast НЕ шлём, без подписчиков — no-op).
-            int purgedRejected = await processing.PurgeExpiredAsync(ct);
+            IReadOnlyList<CardReminderDueDto> dueReminders;
-            StorageTickStatsDto mergedStats = stats with { PurgedRejected = purgedRejected };
+            try
-
+            {
-            // Тосты — в канал тенанта (публикация из Api-слоя, Ruling 5; без подписчиков — no-op).
+                CardsService reminders = tenantScope.ServiceProvider.GetRequiredService<CardsService>();
-            _toastPublisher.PublishTickToasts(tenant.Id, mergedStats);
+                dueReminders = await reminders.CheckDueRemindersAsync(ct);
-
+            }
-            // Проверка наступивших напоминаний «Отложено» (Task 12, Ruling 3/8; proj_svc.check_reminders из
+            catch (OperationCanceledException)
-            // _storage_loop main.py L49): CheckDueRemindersAsync помечает due-строки hold-карточек fired и
+            {
-            // возвращает их {id,title,containerId}. Сбой проверки НЕ роняет тик тенанта/проход: лог-предупреждение,
+                // Остановка хоста — прерываем проход штатно (не «сбой проверки напоминаний»).
-            // остальные тенанты обрабатываются (паттерн ветки AdminTickOrchestrator). SSE reminder_due по каждой
+                throw;
-            // записи — в канал тенанта (Ruling 8: публикации только из Api; toast НЕ шлём, без подписчиков — no-op).
+            }
-            IReadOnlyList<CardReminderDueDto> dueReminders;
+            catch (Exception exception)
-            try
+            {
-            {
+                _logger.LogWarning(exception, "Цикл правил хранения: проверка напоминаний тенанта {TenantId} не удалась", tenant.Id);
-                CardsService reminders = tenantScope.ServiceProvider.GetRequiredService<CardsService>();
+                dueReminders = Array.Empty<CardReminderDueDto>();
-                dueReminders = await reminders.CheckDueRemindersAsync(ct);
+            }
-            }
+
-            catch (OperationCanceledException)
+            foreach (CardReminderDueDto due in dueReminders)
-            {
+            {
-                // Остановка хоста — прерываем проход штатно (не «сбой проверки напоминаний»).
+                _broker.Publish(tenant.Id, ReminderDueEventType, due);
-                throw;
+            }
-            }
+        }
-            catch (Exception exception)
+        catch (OperationCanceledException)
-            {
+        {
-                _logger.LogWarning(exception, "Цикл правил хранения: проверка напоминаний тенанта {TenantId} не удалась", tenant.Id);
+            throw;
-                dueReminders = Array.Empty<CardReminderDueDto>();
+        }
-            }
+        catch (Exception exception)
-
+        {
-            foreach (CardReminderDueDto due in dueReminders)
+            _logger.LogWarning(exception, "Цикл правил хранения: тик тенанта {TenantId} не удался", tenant.Id);
-            {
+        }
-                _broker.Publish(tenant.Id, ReminderDueEventType, due);
+        finally
-            }
+        {
-        }
+            tenantContext.Reset();
-        catch (OperationCanceledException)
+        }
-        {
+    }
-            throw;
+}
-        }
-        catch (Exception exception)
-        {
-            _logger.LogWarning(exception, "Цикл правил хранения: тик тенанта {TenantId} не удался", tenant.Id);
-        }
-        finally
-        {
-            tenantContext.Reset();
-        }
-    }
-}

src/core/Deal.Api/Hosting/TenantBootstrapService.cs

@@ -1,99 +1,95 @@
-using Deal.Infrastructure.Tenancy;
+using Deal.Infrastructure.Tenancy;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Modules.Tenants.Application.Extensions;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Tenants.Application.Models;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Modules.Tenants.Application.Registrars;
+
-using Deal.Modules.Tenants.Application.Services;
+namespace Deal.Api.Hosting;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+/// <summary>
-
+/// Bootstrap при старте (Ruling 8): дефолтный тенант + admin (dev-only), провижининг схем всех тенантов.
-namespace Deal.Api.Hosting;
+/// </summary>
-
+/// <remarks>
-/// <summary>
+/// Идемпотентен. Dev-seed дефолтного тенанта (фиксированный id) и пользователя admin из env
-/// Bootstrap при старте (Ruling 8): дефолтный тенант + admin (dev-only), провижининг схем всех тенантов.
+/// DEAL_BOOTSTRAP_LOGIN/DEAL_BOOTSTRAP_PASSWORD (по умолчанию admin/admin) выполняется только в Development
-/// </summary>
+/// или при DEAL_BOOTSTRAP_DEFAULT_TENANT=1 (Ruling 1 этапа 7); в Production тенантов заводит оператор.
-/// <remarks>
+/// Провижининг схем ВСЕХ тенантов реестра выполняется всегда. Работает только через порты модулей и
-/// Идемпотентен. Dev-seed дефолтного тенанта (фиксированный id) и пользователя admin из env
+/// IPasswordHasher — без DealDbContext.
-/// DEAL_BOOTSTRAP_LOGIN/DEAL_BOOTSTRAP_PASSWORD (по умолчанию admin/admin) выполняется только в Development
+/// </remarks>
-/// или при DEAL_BOOTSTRAP_DEFAULT_TENANT=1 (Ruling 1 этапа 7); в Production тенантов заводит оператор.
+public sealed class TenantBootstrapService(IServiceScopeFactory scopeFactory) : IHostedService
-/// Провижининг схем ВСЕХ тенантов реестра выполняется всегда. Работает только через порты модулей и
+{
-/// IPasswordHasher — без DealDbContext.
+    // Имя дефолтного тенанта, если реестр пуст (Ruling 8).
-/// </remarks>
+    private const string DefaultTenantName = "Default";
-public sealed class TenantBootstrapService(IServiceScopeFactory scopeFactory) : IHostedService
+
-{
+    // Фиксированный id дефолтного тенанта: схема tenant_000...0001 детерминирована (Ruling 8).
-    // Имя дефолтного тенанта, если реестр пуст (Ruling 8).
+    private static readonly Guid DefaultTenantId = Guid.Parse("00000000-0000-0000-0000-000000000001");
-    private const string DefaultTenantName = "Default";
+
-
+    private const string ActiveStatus = "active";
-    // Фиксированный id дефолтного тенанта: схема tenant_000...0001 детерминирована (Ruling 8).
+    private const string BootstrapLoginEnvKey = "DEAL_BOOTSTRAP_LOGIN";
-    private static readonly Guid DefaultTenantId = Guid.Parse("00000000-0000-0000-0000-000000000001");
+    private const string BootstrapPasswordEnvKey = "DEAL_BOOTSTRAP_PASSWORD";
-
+    private const string DefaultAdminLogin = "admin";
-    private const string ActiveStatus = "active";
+    private const string DefaultAdminPassword = "admin";
-    private const string BootstrapLoginEnvKey = "DEAL_BOOTSTRAP_LOGIN";
+
-    private const string BootstrapPasswordEnvKey = "DEAL_BOOTSTRAP_PASSWORD";
+    // Ключ env-флага принудительного dev-seed в не-Development окружениях (Ruling 1 этапа 7).
-    private const string DefaultAdminLogin = "admin";
+    private const string DefaultTenantBootstrapEnvKey = "DEAL_BOOTSTRAP_DEFAULT_TENANT";
-    private const string DefaultAdminPassword = "admin";
+
-
+    // Значение «включено» env-флага (Ruling 1: =1).
-    // Ключ env-флага принудительного dev-seed в не-Development окружениях (Ruling 1 этапа 7).
+    private const string DefaultTenantBootstrapEnabledValue = "1";
-    private const string DefaultTenantBootstrapEnvKey = "DEAL_BOOTSTRAP_DEFAULT_TENANT";
+
-
+    /// <inheritdoc />
-    // Значение «включено» env-флага (Ruling 1: =1).
+    public async Task StartAsync(CancellationToken ct)
-    private const string DefaultTenantBootstrapEnabledValue = "1";
+    {
-
+        await using var scope = scopeFactory.CreateAsyncScope();
-    /// <inheritdoc />
+        var configuration = scope.ServiceProvider.GetRequiredService<IConfiguration>();
-    public async Task StartAsync(CancellationToken ct)
+        var tenantService = scope.ServiceProvider.GetRequiredService<TenantService>();
-    {
+        var tenantRepository = scope.ServiceProvider.GetRequiredService<ITenantRepository>();
-        await using var scope = scopeFactory.CreateAsyncScope();
+        var authStore = scope.ServiceProvider.GetRequiredService<IAuthStore>();
-        var configuration = scope.ServiceProvider.GetRequiredService<IConfiguration>();
+        var passwordHasher = scope.ServiceProvider.GetRequiredService<IPasswordHasher>();
-        var tenantService = scope.ServiceProvider.GetRequiredService<TenantService>();
+
-        var tenantRepository = scope.ServiceProvider.GetRequiredService<ITenantRepository>();
+        var login = NormalizeLogin(configuration[BootstrapLoginEnvKey] ?? DefaultAdminLogin);
-        var authStore = scope.ServiceProvider.GetRequiredService<IAuthStore>();
+        var password = configuration[BootstrapPasswordEnvKey] ?? DefaultAdminPassword;
-        var passwordHasher = scope.ServiceProvider.GetRequiredService<IPasswordHasher>();
+        var environment = scope.ServiceProvider.GetRequiredService<IHostEnvironment>();
-
+
-        var login = NormalizeLogin(configuration[BootstrapLoginEnvKey] ?? DefaultAdminLogin);
+        // Dev-seed дефолтного тенанта + admin становится dev-only (Ruling 1 этапа 7): создаётся только
-        var password = configuration[BootstrapPasswordEnvKey] ?? DefaultAdminPassword;
+        // в Development или при DEAL_BOOTSTRAP_DEFAULT_TENANT=1. В Production тенантов заводит оператор.
-        var environment = scope.ServiceProvider.GetRequiredService<IHostEnvironment>();
+        var seedDefaultTenant = environment.IsDevelopment()
-
+            || configuration[DefaultTenantBootstrapEnvKey] == DefaultTenantBootstrapEnabledValue;
-        // Dev-seed дефолтного тенанта + admin становится dev-only (Ruling 1 этапа 7): создаётся только
+        if (seedDefaultTenant)
-        // в Development или при DEAL_BOOTSTRAP_DEFAULT_TENANT=1. В Production тенантов заводит оператор.
+        {
-        var seedDefaultTenant = environment.IsDevelopment()
+            var tenants = await tenantRepository.ListAsync(ct);
-            || configuration[DefaultTenantBootstrapEnvKey] == DefaultTenantBootstrapEnabledValue;
+            if (tenants.Count == 0)
-        if (seedDefaultTenant)
+            {
-        {
+                // CreateTenantAsync сам провижинит схему дефолтного тенанта (TenantService → ITenantProvisioner).
-            var tenants = await tenantRepository.ListAsync(ct);
+                await tenantService.CreateTenantAsync(DefaultTenantName, DefaultTenantId, ct);
-            if (tenants.Count == 0)
+            }
-            {
+
-                // CreateTenantAsync сам провижинит схему дефолтного тенанта (TenantService → ITenantProvisioner).
+            // Идемпотентность: пользователь с таким логином уже есть — ничего не делаем.
-                await tenantService.CreateTenantAsync(DefaultTenantName, DefaultTenantId, ct);
+            var existingUser = await authStore.FindUserByLoginAsync(login, ct);
-            }
+            if (existingUser is null)
-
+            {
-            // Идемпотентность: пользователь с таким логином уже есть — ничего не делаем.
+                await authStore.CreateUserAsync(
-            var existingUser = await authStore.FindUserByLoginAsync(login, ct);
+                    new StoredUserDto(
-            if (existingUser is null)
+                        Id: Guid.NewGuid(),
-            {
+                        Login: login,
-                await authStore.CreateUserAsync(
+                        TenantId: DefaultTenantId,
-                    new StoredUserDto(
+                        Status: ActiveStatus,
-                        Id: Guid.NewGuid(),
+                        PasswordHash: passwordHasher.Hash(password)),
-                        Login: login,
+                    ct);
-                        TenantId: DefaultTenantId,
+            }
-                        Status: ActiveStatus,
+        }
-                        PasswordHash: passwordHasher.Hash(password)),
+
-                    ct);
+        // Провижининг схем ВСЕХ тенантов реестра выполняется всегда (Ruling 1 этапа 7), включая только
-            }
+        // что созданного в dev: пакетная идемпотентная миграция (CREATE SCHEMA IF NOT EXISTS + Migrate,
-        }
+        // применяющий только неприменённые миграции) с ограниченным параллелизмом и логированием прогресса —
-
+        // масштабируется на сотни/тысячи схем (этап 12, пакет C). Повторный старт безопасен.
-        // Провижининг схем ВСЕХ тенантов реестра выполняется всегда (Ruling 1 этапа 7), включая только
+        var tenantSchemaMigrationService = scope.ServiceProvider.GetRequiredService<TenantSchemaMigrationService>();
-        // что созданного в dev: пакетная идемпотентная миграция (CREATE SCHEMA IF NOT EXISTS + Migrate,
+        await tenantSchemaMigrationService.MigrateAllAsync(ct);
-        // применяющий только неприменённые миграции) с ограниченным параллелизмом и логированием прогресса —
+    }
-        // масштабируется на сотни/тысячи схем (этап 12, пакет C). Повторный старт безопасен.
+
-        var tenantSchemaMigrationService = scope.ServiceProvider.GetRequiredService<TenantSchemaMigrationService>();
+    /// <inheritdoc />
-        await tenantSchemaMigrationService.MigrateAllAsync(ct);
+    public Task StopAsync(CancellationToken ct) => Task.CompletedTask;
-    }
+
-
+    // Нормализация логина: нижний регистр и обрезка пробелов (единая форма хранения).
-    /// <inheritdoc />
+    // login: Входной логин.
-    public Task StopAsync(CancellationToken ct) => Task.CompletedTask;
+    // Возвращает: Нормализованный логин.
-
+    private static string NormalizeLogin(string login) => login.Trim().ToLowerInvariant();
-    // Нормализация логина: нижний регистр и обрезка пробелов (единая форма хранения).
+}
-    // login: Входной логин.
-    // Возвращает: Нормализованный логин.
-    private static string NormalizeLogin(string login) => login.Trim().ToLowerInvariant();
-}

src/core/Deal.Api/Logging/DealLogging.cs

@@ -1,126 +1,123 @@
-using Microsoft.Extensions.Configuration;
+using Serilog;
-using Serilog;
+using Serilog.Events;
-using Serilog.Events;
+using Serilog.Formatting.Compact;
-using Serilog.Formatting.Compact;
+
-using Deal.Api.Services;
+namespace Deal.Api.Logging;
-using Deal.Api.Dtos;
+
-
+// Serilog-конфигурация процесса core (Ruling 7/9, план Task 14).
-namespace Deal.Api.Logging;
+// Все четыре процесса (core + telegram/ai/ml-сервисы) логируют через Serilog: консоль — JSON в
-
+// prod-стиле (CompactJsonFormatter: одна JSON-строка на событие, поля @t/@mt/@l — парсинг
-// Serilog-конфигурация процесса core (Ruling 7/9, план Task 14).
+// Loki/Promtail) либо текст в Development; плюс rolling-файл data/logs/deal-<процесс>.json
-// Все четыре процесса (core + telegram/ai/ml-сервисы) логируют через Serilog: консоль — JSON в
+// (под ContentRoot; у core каталог data смонтирован volume-ом, compose.prod). Уровень/каталог
-// prod-стиле (CompactJsonFormatter: одна JSON-строка на событие, поля @t/@mt/@l — парсинг
+// переопределяются env: DEAL_LOG_LEVEL, DEAL_LOGS_DIR.
-// Loki/Promtail) либо текст в Development; плюс rolling-файл data/logs/deal-<процесс>.json
+// Конфигурация кодом, а не секцией appsettings: у трёх сервисов appsettings.json нет (весь конфиг —
-// (под ContentRoot; у core каталог data смонтирован volume-ом, compose.prod). Уровень/каталог
+// env, Ruling 13), поэтому единый для четырёх хостов код-набор с env-переопределениями дешевле и не
-// переопределяются env: DEAL_LOG_LEVEL, DEAL_LOGS_DIR.
+// расходится между процессами. Правило «секреты не логируются» (Ruling 13) соблюдается на уровне
-// Конфигурация кодом, а не секцией appsettings: у трёх сервисов appsettings.json нет (весь конфиг —
+// сообщений (в лог-конфигурации секретов нет; запрос-логи Task 14 логируют метод/путь/статус без
-// env, Ruling 13), поэтому единый для четырёх хостов код-набор с env-переопределениями дешевле и не
+// query/заголовков/тел). OTel-метрики/трейсы и Prometheus в этапе 7 не добавляются (Ruling 7) —
-// расходится между процессами. Правило «секреты не логируются» (Ruling 13) соблюдается на уровне
+// стек: Serilog-логи → docker-логи → Promtail → Loki → Grafana.
-// сообщений (в лог-конфигурации секретов нет; запрос-логи Task 14 логируют метод/путь/статус без
+// Вызов — из Program.cs процесса (entry point): DealLogging.Configure(builder, "…") ДО
-// query/заголовков/тел). OTel-метрики/трейсы и Prometheus в этапе 7 не добавляются (Ruling 7) —
+// builder.Build(). Интеграционные тесты сервисов поднимают хост через *ServiceHost.Create
-// стек: Serilog-логи → docker-логи → Promtail → Loki → Grafana.
+// БЕЗ этого вызова (конфигурация логирования — забота production-точки входа), поэтому тесты не пишут
-// Вызов — из Program.cs процесса (entry point): DealLogging.Configure(builder, "…") ДО
+// файлы-логи и не меняют своё логирование.
-// builder.Build(). Интеграционные тесты сервисов поднимают хост через *ServiceHost.Create
+internal static class DealLogging
-// БЕЗ этого вызова (конфигурация логирования — забота production-точки входа), поэтому тесты не пишут
+{
-// файлы-логи и не меняют своё логирование.
+    // Env-ключ минимального уровня Serilog (Debug/Information/Warning/Error; дефолт Information).
-internal static class DealLogging
+    private const string MinimumLevelEnvKey = "DEAL_LOG_LEVEL";
-{
+
-    // Env-ключ минимального уровня Serilog (Debug/Information/Warning/Error; дефолт Information).
+    // Env-ключ каталога rolling-файлов (дефолт data/logs под ContentRoot).
-    private const string MinimumLevelEnvKey = "DEAL_LOG_LEVEL";
+    private const string LogsDirectoryEnvKey = "DEAL_LOGS_DIR";
-
+
-    // Env-ключ каталога rolling-файлов (дефолт data/logs под ContentRoot).
+    // Каталог логов по умолчанию (относительно ContentRoot): core — внутри volume /app/data.
-    private const string LogsDirectoryEnvKey = "DEAL_LOGS_DIR";
+    private const string DefaultLogsSubdirectory = "data/logs";
-
+
-    // Каталог логов по умолчанию (относительно ContentRoot): core — внутри volume /app/data.
+    // Шаблон имени rolling-файла (Serilog добавляет дату перед расширением): deal-core-20260908.json.
-    private const string DefaultLogsSubdirectory = "data/logs";
+    private const string LogFileNameTemplate = "deal-{0}-.json";
-
+
-    // Шаблон имени rolling-файла (Serilog добавляет дату перед расширением): deal-core-20260908.json.
+    // Сколько rolling-файлов хранится (суток); старшие удаляются Serilog автоматически.
-    private const string LogFileNameTemplate = "deal-{0}-.json";
+    private const int RetainedFileCount = 30;
-
+
-    // Сколько rolling-файлов хранится (суток); старшие удаляются Serilog автоматически.
+    // Текстовая разметка консоли в Development (цвета — дефолтной темой Serilog).
-    private const int RetainedFileCount = 30;
+    private const string DevelopmentConsoleTemplate =
-
+        "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}";
-    // Текстовая разметка консоли в Development (цвета — дефолтной темой Serilog).
+
-    private const string DevelopmentConsoleTemplate =
+    // Категория EF Core: команды SQL логируются на Warning+ (шум запросов не попадает в Loki).
-        "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}";
+    private const string EntityFrameworkCoreCategory = "Microsoft.EntityFrameworkCore";
-
+
-    // Категория EF Core: команды SQL логируются на Warning+ (шум запросов не попадает в Loki).
+    // Категория Grpc.AspNetCore: не ниже Information (внутренние Debug-события вызовов не дублируют access-лог).
-    private const string EntityFrameworkCoreCategory = "Microsoft.EntityFrameworkCore";
+    private const string GrpcCategory = "Grpc";
-
+
-    // Категория Grpc.AspNetCore: не ниже Information (внутренние Debug-события вызовов не дублируют access-лог).
+    // Дефолтный уровень при пустом/невалидном env DEAL_LOG_LEVEL.
-    private const string GrpcCategory = "Grpc";
+    private const LogEventLevel DefaultMinimumLevel = LogEventLevel.Information;
-
+
-    // Дефолтный уровень при пустом/невалидном env DEAL_LOG_LEVEL.
+    /// <summary>
-    private const LogEventLevel DefaultMinimumLevel = LogEventLevel.Information;
+    /// Подключает Serilog к хосту (builder.Host.UseSerilog). Регистрация отложенная: конфигурация
-
+    /// логгера применяется при <c>builder.Build()</c>, когда среда/конфигурация (env) уже собраны.
-    /// <summary>
+    /// </summary>
-    /// Подключает Serilog к хосту (builder.Host.UseSerilog). Регистрация отложенная: конфигурация
+    /// <param name="builder">Билдер WebApplication процесса (до Build).</param>
-    /// логгера применяется при <c>builder.Build()</c>, когда среда/конфигурация (env) уже собраны.
+    /// <param name="processName">Имя процесса для имени файла-лога (core/telegram/ai/ml).</param>
-    /// </summary>
+    public static void Configure(WebApplicationBuilder builder, string processName)
-    /// <param name="builder">Билдер WebApplication процесса (до Build).</param>
+    {
-    /// <param name="processName">Имя процесса для имени файла-лога (core/telegram/ai/ml).</param>
+        ArgumentNullException.ThrowIfNull(builder);
-    public static void Configure(WebApplicationBuilder builder, string processName)
+        ArgumentException.ThrowIfNullOrWhiteSpace(processName);
-    {
+        builder.Host.UseSerilog((context, loggerConfiguration) =>
-        ArgumentNullException.ThrowIfNull(builder);
+            Apply(loggerConfiguration, context.HostingEnvironment, context.Configuration, processName));
-        ArgumentException.ThrowIfNullOrWhiteSpace(processName);
+    }
-        builder.Host.UseSerilog((context, loggerConfiguration) =>
+
-            Apply(loggerConfiguration, context.HostingEnvironment, context.Configuration, processName));
+    // Собирает LoggerConfiguration процесса: уровень/фильтры, rolling-файл, консоль.
-    }
+    // loggerConfiguration: Конфигурация Serilog (до CreateLogger).
-
+    // environment: Окружение хоста (Development — текстовая консоль).
-    // Собирает LoggerConfiguration процесса: уровень/фильтры, rolling-файл, консоль.
+    // configuration: Конфигурация хоста (env DEAL_LOG_*).
-    // loggerConfiguration: Конфигурация Serilog (до CreateLogger).
+    // processName: Имя процесса (суффикс имени rolling-файла).
-    // environment: Окружение хоста (Development — текстовая консоль).
+    private static void Apply(
-    // configuration: Конфигурация хоста (env DEAL_LOG_*).
+        LoggerConfiguration loggerConfiguration,
-    // processName: Имя процесса (суффикс имени rolling-файла).
+        IHostEnvironment environment,
-    private static void Apply(
+        IConfiguration configuration,
-        LoggerConfiguration loggerConfiguration,
+        string processName)
-        IHostEnvironment environment,
+    {
-        IConfiguration configuration,
+        loggerConfiguration
-        string processName)
+            .MinimumLevel.Is(ParseMinimumLevel(configuration[MinimumLevelEnvKey]))
-    {
+            .MinimumLevel.Override(EntityFrameworkCoreCategory, LogEventLevel.Warning)
-        loggerConfiguration
+            .MinimumLevel.Override(GrpcCategory, LogEventLevel.Information)
-            .MinimumLevel.Is(ParseMinimumLevel(configuration[MinimumLevelEnvKey]))
+            .Enrich.FromLogContext();
-            .MinimumLevel.Override(EntityFrameworkCoreCategory, LogEventLevel.Warning)
+
-            .MinimumLevel.Override(GrpcCategory, LogEventLevel.Information)
+        string logsDirectory = ResolveLogsDirectory(environment.ContentRootPath, configuration[LogsDirectoryEnvKey]);
-            .Enrich.FromLogContext();
+        Directory.CreateDirectory(logsDirectory);
-
+        string logFilePath = Path.Combine(
-        string logsDirectory = ResolveLogsDirectory(environment.ContentRootPath, configuration[LogsDirectoryEnvKey]);
+            logsDirectory,
-        Directory.CreateDirectory(logsDirectory);
+            string.Format(LogFileNameTemplate, processName));
-        string logFilePath = Path.Combine(
+        loggerConfiguration.WriteTo.File(
-            logsDirectory,
+            new CompactJsonFormatter(),
-            string.Format(LogFileNameTemplate, processName));
+            logFilePath,
-        loggerConfiguration.WriteTo.File(
+            rollingInterval: RollingInterval.Day,
-            new CompactJsonFormatter(),
+            retainedFileCountLimit: RetainedFileCount);
-            logFilePath,
+
-            rollingInterval: RollingInterval.Day,
+        if (environment.IsDevelopment())
-            retainedFileCountLimit: RetainedFileCount);
+        {
-
+            // Dev: читаемый текст в консоли (Ruling 7: «dev можно текст»); файл — всегда JSON.
-        if (environment.IsDevelopment())
+            loggerConfiguration.WriteTo.Console(outputTemplate: DevelopmentConsoleTemplate);
-        {
+        }
-            // Dev: читаемый текст в консоли (Ruling 7: «dev можно текст»); файл — всегда JSON.
+        else
-            loggerConfiguration.WriteTo.Console(outputTemplate: DevelopmentConsoleTemplate);
+        {
-        }
+            // Prod-стиль: одна JSON-строка на событие — docker-логи собирает Promtail (Ruling 7/9).
-        else
+            loggerConfiguration.WriteTo.Console(new CompactJsonFormatter());
-        {
+        }
-            // Prod-стиль: одна JSON-строка на событие — docker-логи собирает Promtail (Ruling 7/9).
+    }
-            loggerConfiguration.WriteTo.Console(new CompactJsonFormatter());
+
-        }
+    // Каталог rolling-файлов: env DEAL_LOGS_DIR либо data/logs под ContentRoot процесса.
-    }
+    // contentRootPath: ContentRoot хоста (/app в контейнере).
-
+    // configuredDirectory: Значение env DEAL_LOGS_DIR (null/пусто — дефолт).
-    // Каталог rolling-файлов: env DEAL_LOGS_DIR либо data/logs под ContentRoot процесса.
+    // Возвращает: Абсолютный путь каталога логов.
-    // contentRootPath: ContentRoot хоста (/app в контейнере).
+    private static string ResolveLogsDirectory(string contentRootPath, string? configuredDirectory)
-    // configuredDirectory: Значение env DEAL_LOGS_DIR (null/пусто — дефолт).
+        => string.IsNullOrWhiteSpace(configuredDirectory)
-    // Возвращает: Абсолютный путь каталога логов.
+            ? Path.Combine(contentRootPath, DefaultLogsSubdirectory)
-    private static string ResolveLogsDirectory(string contentRootPath, string? configuredDirectory)
+            : configuredDirectory.Trim();
-        => string.IsNullOrWhiteSpace(configuredDirectory)
+
-            ? Path.Combine(contentRootPath, DefaultLogsSubdirectory)
+    // Разбирает env DEAL_LOG_LEVEL; пустое/невалидное значение — DefaultMinimumLevel.
-            : configuredDirectory.Trim();
+    // rawValue: Сырое значение env.
-
+    // Возвращает: Уровень Serilog.
-    // Разбирает env DEAL_LOG_LEVEL; пустое/невалидное значение — DefaultMinimumLevel.
+    private static LogEventLevel ParseMinimumLevel(string? rawValue)
-    // rawValue: Сырое значение env.
+        => Enum.TryParse(rawValue, ignoreCase: true, out LogEventLevel parsedLevel)
-    // Возвращает: Уровень Serilog.
+            ? parsedLevel
-    private static LogEventLevel ParseMinimumLevel(string? rawValue)
+            : DefaultMinimumLevel;
-        => Enum.TryParse(rawValue, ignoreCase: true, out LogEventLevel parsedLevel)
+}
-            ? parsedLevel
-            : DefaultMinimumLevel;
-}

src/core/Deal.Api/Middleware/HttpAccessLogMiddleware.cs

@@ -1,100 +1,98 @@
-using System.Diagnostics;
+using System.Diagnostics;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Middleware;
-
+
-namespace Deal.Api.Middleware;
+/// <summary>
-
+/// Access-лог HTTP-запросов core (Ruling 7, план Task 14): каждый запрос — одна структурированная
-/// <summary>
+/// строка «метод путь → статус за N мс» (Serilog JSON). Логируются метод и путь БЕЗ query-строки,
-/// Access-лог HTTP-запросов core (Ruling 7, план Task 14): каждый запрос — одна структурированная
+/// заголовков и тела — секреты/токены в query не попадают в логи (Ruling 13); клиентский IP не
-/// строка «метод путь → статус за N мс» (Serilog JSON). Логируются метод и путь БЕЗ query-строки,
+/// логируется (аудит-IP живёт в AuditLog, операторский контур).
-/// заголовков и тела — секреты/токены в query не попадают в логи (Ruling 13); клиентский IP не
+/// </summary>
-/// логируется (аудит-IP живёт в AuditLog, операторский контур).
+/// <remarks>
-/// </summary>
+/// Регистрируется самым первым в HTTP-конвейере (после UseForwardedHeaders): видит результат всех
-/// <remarks>
+/// слоёв ниже (CORS/session/rate-limiter/OriginGuard/эндпоинты) и полную длительность запроса.
-/// Регистрируется самым первым в HTTP-конвейере (после UseForwardedHeaders): видит результат всех
+/// Запросы gRPC-ингресса (Content-Type application/grpc) пропускаются — их содержательный access-лог
-/// слоёв ниже (CORS/session/rate-limiter/OriginGuard/эндпоинты) и полную длительность запроса.
+/// пишет интерцептор RpcCallLoggingInterceptor (HTTP-статус gRPC-вызовов всегда 200, полезен только
-/// Запросы gRPC-ингресса (Content-Type application/grpc) пропускаются — их содержательный access-лог
+/// gRPC-статус). SSE-подписка /api/events логируется по завершении потока (длительность = время жизни
-/// пишет интерцептор RpcCallLoggingInterceptor (HTTP-статус gRPC-вызовов всегда 200, полезен только
+/// соединения). Отмена запроса (клиент закрыл SSE/дисконнект) отдельной строкой не пишется.
-/// gRPC-статус). SSE-подписка /api/events логируется по завершении потока (длительность = время жизни
+/// </remarks>
-/// соединения). Отмена запроса (клиент закрыл SSE/дисконнект) отдельной строкой не пишется.
+public sealed class HttpAccessLogMiddleware
-/// </remarks>
+{
-public sealed class HttpAccessLogMiddleware
+    // Content-Type gRPC-запросов (HTTP/2) — их логирует RpcCallLoggingInterceptor.
-{
+    private const string GrpcContentType = "application/grpc";
-    // Content-Type gRPC-запросов (HTTP/2) — их логирует RpcCallLoggingInterceptor.
+
-    private const string GrpcContentType = "application/grpc";
+    private readonly RequestDelegate _next;
-
+    private readonly ILogger<HttpAccessLogMiddleware> _logger;
-    private readonly RequestDelegate _next;
+
-    private readonly ILogger<HttpAccessLogMiddleware> _logger;
+    /// <summary>
-
+    /// Создаёт middleware access-лога HTTP-запросов.
-    /// <summary>
+    /// </summary>
-    /// Создаёт middleware access-лога HTTP-запросов.
+    /// <param name="next">Следующий обработчик конвейера.</param>
-    /// </summary>
+    /// <param name="logger">Логгер (Serilog, Ruling 7).</param>
-    /// <param name="next">Следующий обработчик конвейера.</param>
+    public HttpAccessLogMiddleware(RequestDelegate next, ILogger<HttpAccessLogMiddleware> logger)
-    /// <param name="logger">Логгер (Serilog, Ruling 7).</param>
+    {
-    public HttpAccessLogMiddleware(RequestDelegate next, ILogger<HttpAccessLogMiddleware> logger)
+        ArgumentNullException.ThrowIfNull(next);
-    {
+        ArgumentNullException.ThrowIfNull(logger);
-        ArgumentNullException.ThrowIfNull(next);
+        _next = next;
-        ArgumentNullException.ThrowIfNull(logger);
+        _logger = logger;
-        _next = next;
+    }
-        _logger = logger;
+
-    }
+    /// <summary>
-
+    /// Обрабатывает запрос: пропускает gRPC-ингресс, остальные логирует по завершении.
-    /// <summary>
+    /// </summary>
-    /// Обрабатывает запрос: пропускает gRPC-ингресс, остальные логирует по завершении.
+    /// <param name="context">Контекст запроса.</param>
-    /// </summary>
+    public async Task InvokeAsync(HttpContext context)
-    /// <param name="context">Контекст запроса.</param>
+    {
-    public async Task InvokeAsync(HttpContext context)
+        if (context.Request.ContentType?.StartsWith(GrpcContentType, StringComparison.OrdinalIgnoreCase) == true)
-    {
+        {
-        if (context.Request.ContentType?.StartsWith(GrpcContentType, StringComparison.OrdinalIgnoreCase) == true)
+            await _next(context);
-        {
+            return;
-            await _next(context);
+        }
-            return;
+
-        }
+        long startedAt = Stopwatch.GetTimestamp();
-
+        try
-        long startedAt = Stopwatch.GetTimestamp();
+        {
-        try
+            await _next(context);
-        {
+            LogCall(context, startedAt, null);
-            await _next(context);
+        }
-            LogCall(context, startedAt, null);
+        catch (Exception exception) when (exception is not OperationCanceledException)
-        }
+        {
-        catch (Exception exception) when (exception is not OperationCanceledException)
+            // Необработанное исключение: фиксируем строку 500 (статус ещё не выставлен) и пробрасываем —
-        {
+            // обработку ошибки продолжает хостинг (DeveloperExceptionPage в dev/закрытие соединения в prod).
-            // Необработанное исключение: фиксируем строку 500 (статус ещё не выставлен) и пробрасываем —
+            LogCall(context, startedAt, exception);
-            // обработку ошибки продолжает хостинг (DeveloperExceptionPage в dev/закрытие соединения в prod).
+            throw;
-            LogCall(context, startedAt, exception);
+        }
-            throw;
+    }
-        }
+
-    }
+    // Пишет одну строку access-лога запроса (успех либо исключение).
-
+    // context: Контекст запроса (метод/путь/статус ответа).
-    // Пишет одну строку access-лога запроса (успех либо исключение).
+    // startedAt: Метка времени старта запроса (Stopwatch.GetTimestamp).
-    // context: Контекст запроса (метод/путь/статус ответа).
+    // exception: Необработанное исключение (null — запрос завершился штатно).
-    // startedAt: Метка времени старта запроса (Stopwatch.GetTimestamp).
+    private void LogCall(
-    // exception: Необработанное исключение (null — запрос завершился штатно).
+        HttpContext context,
-    private void LogCall(
+        long startedAt,
-        HttpContext context,
+        Exception? exception)
-        long startedAt,
+    {
-        Exception? exception)
+        long elapsedMs = (long)Stopwatch.GetElapsedTime(startedAt).TotalMilliseconds;
-    {
+        string method = context.Request.Method;
-        long elapsedMs = (long)Stopwatch.GetElapsedTime(startedAt).TotalMilliseconds;
+        string path = context.Request.Path.Value ?? "/";
-        string method = context.Request.Method;
+        if (exception is null)
-        string path = context.Request.Path.Value ?? "/";
+        {
-        if (exception is null)
+            _logger.LogInformation(
-        {
+                "HTTP {Method} {Path} -> {StatusCode} за {DurationMs} мс",
-            _logger.LogInformation(
+                method,
-                "HTTP {Method} {Path} -> {StatusCode} за {DurationMs} мс",
+                path,
-                method,
+                context.Response.StatusCode,
-                path,
+                elapsedMs);
-                context.Response.StatusCode,
+        }
-                elapsedMs);
+        else
-        }
+        {
-        else
+            _logger.LogError(
-        {
+                exception,
-            _logger.LogError(
+                "HTTP {Method} {Path} -> исключение за {DurationMs} мс",
-                exception,
+                method,
-                "HTTP {Method} {Path} -> исключение за {DurationMs} мс",
+                path,
-                method,
+                elapsedMs);
-                path,
+        }
-                elapsedMs);
+    }
-        }
+}
-    }
-}

src/core/Deal.Api/Middleware/OperatorSessionMiddleware.cs

@@ -1,62 +1,55 @@
-using Deal.Api.Configuration;
+using Deal.Api.Extensions;
-using Deal.Api.Extensions;
+using Deal.Api.Models;
-using Deal.Api.Models;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Api.Services;
+using Microsoft.Extensions.Options;
-using Deal.Modules.Tenants.Application.Abstractions;
+// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
-using Deal.Modules.Tenants.Application.Extensions;
+using OperatorCookieOptions = Deal.Api.Configuration.OperatorCookieOptions;
-using Deal.Modules.Tenants.Application.Models;
+
-using Deal.Modules.Tenants.Application.Registrars;
+namespace Deal.Api.Middleware;
-using Deal.Modules.Tenants.Application.Services;
+
-using Microsoft.Extensions.Options;
+/// <summary>
-using Deal.Api.Dtos;
+/// Middleware операторской сессии: читает httpOnly-куку deal_operator_session, разрешает сессию через
-// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
+/// OperatorAuthService и наполняет <c>HttpContext.Items["CurrentOperator"]</c> (Ruling 1 этапа 7).
-using OperatorCookieOptions = Deal.Api.Configuration.OperatorCookieOptions;
+/// </summary>
-
+/// <remarks>
-namespace Deal.Api.Middleware;
+/// Зеркало <see cref="SessionMiddleware"/> для операторов: отдельная кука и отдельный ключ Items —
-
+/// операторская сессия не может подменить тенантную и наоборот (разные имена куки, разные middleware).
-/// <summary>
+/// Tenant-контекст (ITenantContext/CurrentUser) middleware не трогает — оператор не принадлежит тенанту.
-/// Middleware операторской сессии: читает httpOnly-куку deal_operator_session, разрешает сессию через
+/// Middleware НЕ отвечает 401 сама (pass-through): ручки /api/operator/*, требующие оператора, проверяют
-/// OperatorAuthService и наполняет <c>HttpContext.Items["CurrentOperator"]</c> (Ruling 1 этапа 7).
+/// <c>GetCurrentOperator()</c> и выставляют 401. OperatorAuthService — scoped, поэтому на запрос
-/// </summary>
+/// создаётся собственный scope через RequestServices (как в SessionMiddleware).
-/// <remarks>
+/// </remarks>
-/// Зеркало <see cref="SessionMiddleware"/> для операторов: отдельная кука и отдельный ключ Items —
+public sealed class OperatorSessionMiddleware
-/// операторская сессия не может подменить тенантную и наоборот (разные имена куки, разные middleware).
+{
-/// Tenant-контекст (ITenantContext/CurrentUser) middleware не трогает — оператор не принадлежит тенанту.
+    private readonly RequestDelegate _next;
-/// Middleware НЕ отвечает 401 сама (pass-through): ручки /api/operator/*, требующие оператора, проверяют
+    private readonly IOptionsMonitor<OperatorCookieOptions> _cookieOptions;
-/// <c>GetCurrentOperator()</c> и выставляют 401. OperatorAuthService — scoped, поэтому на запрос
+
-/// создаётся собственный scope через RequestServices (как в SessionMiddleware).
+    public OperatorSessionMiddleware(RequestDelegate next, IOptionsMonitor<OperatorCookieOptions> cookieOptions)
-/// </remarks>
+    {
-public sealed class OperatorSessionMiddleware
+        _next = next;
-{
+        _cookieOptions = cookieOptions;
-    private readonly RequestDelegate _next;
+    }
-    private readonly IOptionsMonitor<OperatorCookieOptions> _cookieOptions;
+
-
+    /// <summary>
-    public OperatorSessionMiddleware(RequestDelegate next, IOptionsMonitor<OperatorCookieOptions> cookieOptions)
+    /// Обрабатывает запрос: разрешает операторскую сессию по куке и наполняет контекст.
-    {
+    /// </summary>
-        _next = next;
+    /// <param name="context">Контекст запроса.</param>
-        _cookieOptions = cookieOptions;
+    public async Task InvokeAsync(HttpContext context)
-    }
+    {
-
+        var cookieName = _cookieOptions.CurrentValue.Name;
-    /// <summary>
+        if (context.Request.Cookies.TryGetValue(cookieName, out var rawToken)
-    /// Обрабатывает запрос: разрешает операторскую сессию по куке и наполняет контекст.
+            && !string.IsNullOrWhiteSpace(rawToken))
-    /// </summary>
+        {
-    /// <param name="context">Контекст запроса.</param>
+            // OperatorAuthService scoped: создаём scope на запрос через RequestServices.
-    public async Task InvokeAsync(HttpContext context)
+            await using var scope = context.RequestServices.CreateAsyncScope();
-    {
+            var operatorAuthService = scope.ServiceProvider.GetRequiredService<OperatorAuthService>();
-        var cookieName = _cookieOptions.CurrentValue.Name;
+            var identity = await operatorAuthService.ResolveSessionAsync(rawToken, context.RequestAborted);
-        if (context.Request.Cookies.TryGetValue(cookieName, out var rawToken)
+            if (identity is not null)
-            && !string.IsNullOrWhiteSpace(rawToken))
+            {
-        {
+                context.SetCurrentOperator(new CurrentOperator(identity.Id, identity.Login, identity.Status));
-            // OperatorAuthService scoped: создаём scope на запрос через RequestServices.
+            }
-            await using var scope = context.RequestServices.CreateAsyncScope();
+        }
-            var operatorAuthService = scope.ServiceProvider.GetRequiredService<OperatorAuthService>();
+
-            var identity = await operatorAuthService.ResolveSessionAsync(rawToken, context.RequestAborted);
+        await _next(context);
-            if (identity is not null)
+    }
-            {
+}
-                context.SetCurrentOperator(new CurrentOperator(identity.Id, identity.Login, identity.Status));
-            }
-        }
-
-        await _next(context);
-    }
-}

src/core/Deal.Api/Middleware/OriginGuardMiddleware.cs

@@ -1,99 +1,97 @@
-using Deal.Api.Configuration;
+using Deal.Api.Configuration;
-using Microsoft.Net.Http.Headers;
+using Microsoft.Net.Http.Headers;
-using Deal.Api.Services;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Middleware;
-
+
-namespace Deal.Api.Middleware;
+/// <summary>
-
+/// Origin-проверка мутаций /api (план Task 12, Ruling 10(2)): запросы не-GET/HEAD/OPTIONS к /api,
-/// <summary>
+/// у которых есть заголовок Origin, обязаны иметь Origin, равный «своему» origin запроса
-/// Origin-проверка мутаций /api (план Task 12, Ruling 10(2)): запросы не-GET/HEAD/OPTIONS к /api,
+/// (схема + Host; за Caddy схема — https из X-Forwarded-Proto, см. UseForwardedHeaders) либо входящий
-/// у которых есть заголовок Origin, обязаны иметь Origin, равный «своему» origin запроса
+/// в явный allowlist <see cref="SecurityOptions.AllowedOrigins"/>; несовпадение — HTTP 403
-/// (схема + Host; за Caddy схема — https из X-Forwarded-Proto, см. UseForwardedHeaders) либо входящий
+/// <c>{"detail":"…"}</c>.
-/// в явный allowlist <see cref="SecurityOptions.AllowedOrigins"/>; несовпадение — HTTP 403
+/// </summary>
-/// <c>{"detail":"…"}</c>.
+/// <remarks>
-/// </summary>
+/// Дополнительный слой CSRF поверх SameSite=Lax кук (первый рубеж, документируется в техдок §10):
-/// <remarks>
+/// браузер всегда шлёт Origin на мутирующих запросах, а подделать его из чужого сайта нельзя, поэтому
-/// Дополнительный слой CSRF поверх SameSite=Lax кук (первый рубеж, документируется в техдок §10):
+/// «чужой» Origin — надёжный признак cross-site запроса. Запросы без Origin (curl, сервер-сервер,
-/// браузер всегда шлёт Origin на мутирующих запросах, а подделать его из чужого сайта нельзя, поэтому
+/// gRPC) не проверяются и пропускаются — Origin обязателен только у браузерных вызовов. GET/HEAD —
-/// «чужой» Origin — надёжный признак cross-site запроса. Запросы без Origin (curl, сервер-сервер,
+/// не мутации, OPTIONS — CORS-preflight: не проверяются. Пустой allowlist (dev-режим, Ruling 10(2)) —
-/// gRPC) не проверяются и пропускаются — Origin обязателен только у браузерных вызовов. GET/HEAD —
+/// правило «Origin == свой origin запроса»; непустой список из конфига расширяет его (фронт за
-/// не мутации, OPTIONS — CORS-preflight: не проверяются. Пустой allowlist (dev-режим, Ruling 10(2)) —
+/// прокси, меняющим Host, и/или явные домены PROD, Ruling 9).
-/// правило «Origin == свой origin запроса»; непустой список из конфига расширяет его (фронт за
+/// <para>
-/// прокси, меняющим Host, и/или явные домены PROD, Ruling 9).
+/// Регистрируется последним из security-слоёв (Ruling 5: Session → Operator → RateLimiter → OriginGuard):
-/// <para>
+/// сессии уже разрешены, rate-limiter ответил 429 раньше, чем проверяется Origin.
-/// Регистрируется последним из security-слоёв (Ruling 5: Session → Operator → RateLimiter → OriginGuard):
+/// </para>
-/// сессии уже разрешены, rate-limiter ответил 429 раньше, чем проверяется Origin.
+/// </remarks>
-/// </para>
+public sealed class OriginGuardMiddleware
-/// </remarks>
+{
-public sealed class OriginGuardMiddleware
+    /// <summary>
-{
+    /// Текст 403 Origin-проверки (Ruling 10(2)): единая формулировка для всех отказов.
-    /// <summary>
+    /// </summary>
-    /// Текст 403 Origin-проверки (Ruling 10(2)): единая формулировка для всех отказов.
+    public const string OriginRejectedDetail = "Запрос отклонён: недопустимый Origin";
-    /// </summary>
+
-    public const string OriginRejectedDetail = "Запрос отклонён: недопустимый Origin";
+    // Префикс пути, под которым живут все HTTP-эндпоинты приложения (Ruling 11).
-
+    private const string ApiPathPrefix = "/api";
-    // Префикс пути, под которым живут все HTTP-эндпоинты приложения (Ruling 11).
+
-    private const string ApiPathPrefix = "/api";
+    private readonly RequestDelegate _next;
-
+    private readonly HashSet<string> _allowedOrigins;
-    private readonly RequestDelegate _next;
+
-    private readonly HashSet<string> _allowedOrigins;
+    public OriginGuardMiddleware(RequestDelegate next, SecurityOptions securityOptions)
-
+    {
-    public OriginGuardMiddleware(RequestDelegate next, SecurityOptions securityOptions)
+        ArgumentNullException.ThrowIfNull(next);
-    {
+        ArgumentNullException.ThrowIfNull(securityOptions);
-        ArgumentNullException.ThrowIfNull(next);
+        _next = next;
-        ArgumentNullException.ThrowIfNull(securityOptions);
+        // Регистронезависимо: схема/хост origin'ов регистронечувствительны, браузеры шлют нижний регистр.
-        _next = next;
+        _allowedOrigins = new HashSet<string>(securityOptions.AllowedOrigins, StringComparer.OrdinalIgnoreCase);
-        // Регистронезависимо: схема/хост origin'ов регистронечувствительны, браузеры шлют нижний регистр.
+    }
-        _allowedOrigins = new HashSet<string>(securityOptions.AllowedOrigins, StringComparer.OrdinalIgnoreCase);
+
-    }
+    /// <summary>
-
+    /// Обрабатывает запрос: отклоняет мутации /api с чужим Origin (403 {detail}).
-    /// <summary>
+    /// </summary>
-    /// Обрабатывает запрос: отклоняет мутации /api с чужим Origin (403 {detail}).
+    /// <param name="context">Контекст запроса.</param>
-    /// </summary>
+    public async Task InvokeAsync(HttpContext context)
-    /// <param name="context">Контекст запроса.</param>
+    {
-    public async Task InvokeAsync(HttpContext context)
+        HttpRequest request = context.Request;
-    {
+        if (request.Path.StartsWithSegments(ApiPathPrefix)
-        HttpRequest request = context.Request;
+            && !HttpMethods.IsGet(request.Method)
-        if (request.Path.StartsWithSegments(ApiPathPrefix)
+            && !HttpMethods.IsHead(request.Method)
-            && !HttpMethods.IsGet(request.Method)
+            && !HttpMethods.IsOptions(request.Method)
-            && !HttpMethods.IsHead(request.Method)
+            && request.Headers.TryGetValue(HeaderNames.Origin, out var originValues))
-            && !HttpMethods.IsOptions(request.Method)
+        {
-            && request.Headers.TryGetValue(HeaderNames.Origin, out var originValues))
+            string origin = originValues.ToString();
-        {
+            if (!string.IsNullOrWhiteSpace(origin) && !IsTrustedOrigin(origin, request))
-            string origin = originValues.ToString();
+            {
-            if (!string.IsNullOrWhiteSpace(origin) && !IsTrustedOrigin(origin, request))
+                context.Response.StatusCode = StatusCodes.Status403Forbidden;
-            {
+                await context.Response.WriteAsJsonAsync(new { detail = OriginRejectedDetail }, context.RequestAborted);
-                context.Response.StatusCode = StatusCodes.Status403Forbidden;
+                return;
-                await context.Response.WriteAsJsonAsync(new { detail = OriginRejectedDetail }, context.RequestAborted);
+            }
-                return;
+        }
-            }
+
-        }
+        await _next(context);
-
+    }
-        await _next(context);
+
-    }
+    // Проверяет Origin: allowlist конфига либо «свой» origin запроса (схема + Host).
-
+    // origin: Значение заголовка Origin запроса.
-    // Проверяет Origin: allowlist конфига либо «свой» origin запроса (схема + Host).
+    // request: Запрос (схема/Host — с учётом прокси-заголовков, если UseForwardedHeaders включён).
-    // origin: Значение заголовка Origin запроса.
+    // Возвращает: true — Origin доверенный, запрос можно пропускать.
-    // request: Запрос (схема/Host — с учётом прокси-заголовков, если UseForwardedHeaders включён).
+    private bool IsTrustedOrigin(string origin, HttpRequest request)
-    // Возвращает: true — Origin доверенный, запрос можно пропускать.
+    {
-    private bool IsTrustedOrigin(string origin, HttpRequest request)
+        if (_allowedOrigins.Contains(origin))
-    {
+        {
-        if (_allowedOrigins.Contains(origin))
+            return true;
-        {
+        }
-            return true;
+
-        }
+        // «Свой» origin: схема + Host-заголовок запроса (без завершающего слэша — как шлёт браузер).
-
+        HostString host = request.Host;
-        // «Свой» origin: схема + Host-заголовок запроса (без завершающего слэша — как шлёт браузер).
+        if (host.HasValue)
-        HostString host = request.Host;
+        {
-        if (host.HasValue)
+            string selfOrigin = request.Scheme + "://" + host.Value;
-        {
+            if (string.Equals(origin, selfOrigin, StringComparison.OrdinalIgnoreCase))
-            string selfOrigin = request.Scheme + "://" + host.Value;
+            {
-            if (string.Equals(origin, selfOrigin, StringComparison.OrdinalIgnoreCase))
+                return true;
-            {
+            }
-                return true;
+        }
-            }
+
-        }
+        return false;
-
+    }
-        return false;
+}
-    }
-}

src/core/Deal.Api/Middleware/RateLimitPolicies.cs

@@ -1,155 +1,153 @@
-using System.Threading.RateLimiting;
+using System.Threading.RateLimiting;
-using Deal.Api.Configuration;
+using Deal.Api.Configuration;
-using Deal.Api.Extensions;
+using Deal.Api.Extensions;
-using Deal.Api.Models;
+using Deal.Api.Models;
-using Deal.Api.Services;
+using Deal.Api.Services;
-using Microsoft.AspNetCore.RateLimiting;
+using Microsoft.AspNetCore.RateLimiting;
-using Microsoft.Extensions.DependencyInjection;
+
-using Deal.Api.Dtos;
+namespace Deal.Api.Middleware;
-
+
-namespace Deal.Api.Middleware;
+/// <summary>
-
+/// Регистрация встроенного rate limiter ASP.NET Core (план Task 11, Ruling 5; этап 12, пакет B — хранилище
-/// <summary>
+/// на Postgres) и его политики: "auth" — фиксированное окно на IP клиента (ручки входа /api/auth/login и
-/// Регистрация встроенного rate limiter ASP.NET Core (план Task 11, Ruling 5; этап 12, пакет B — хранилище
+/// /api/operator/auth/login), "api" — на тенанта из <see cref="CurrentUser"/> либо IP анонима
-/// на Postgres) и его политики: "auth" — фиксированное окно на IP клиента (ручки входа /api/auth/login и
+/// (Session/OperatorSessionMiddleware отрабатывают раньше — порядок Session → Operator → RateLimiter).
-/// /api/operator/auth/login), "api" — на тенанта из <see cref="CurrentUser"/> либо IP анонима
+/// API-партиция выставляется и глобальным лимитером: все /api-эндпоинты без собственной политики
-/// (Session/OperatorSessionMiddleware отрабатывают раньше — порядок Session → Operator → RateLimiter).
+/// ограничены 600/мин на тенанта/IP. Отказ любого лимитера — HTTP 429 с телом <c>{"detail": "…"}</c>.
-/// API-партиция выставляется и глобальным лимитером: все /api-эндпоинты без собственной политики
+/// </summary>
-/// ограничены 600/мин на тенанта/IP. Отказ любого лимитера — HTTP 429 с телом <c>{"detail": "…"}</c>.
+/// <remarks>
-/// </summary>
+/// Регистрируется только при <see cref="RateLimitOptions.Enabled"/> (в dev/тестах middleware и политики
-/// <remarks>
+/// не создаются — Ruling 5). gRPC-ингресс (:5082) HTTP-лимитером освобождён (DisableRateLimiting на
-/// Регистрируется только при <see cref="RateLimitOptions.Enabled"/> (в dev/тестах middleware и политики
+/// MapGrpcService): лимит по tenant-id там считает IngressRateLimitInterceptor — иначе входящий поток
-/// не создаются — Ruling 5). gRPC-ингресс (:5082) HTTP-лимитером освобождён (DisableRateLimiting на
+/// telegram-service резался бы общим окном на IP.
-/// MapGrpcService): лимит по tenant-id там считает IngressRateLimitInterceptor — иначе входящий поток
+/// <para>
-/// telegram-service резался бы общим окном на IP.
+/// Счётчики окон живут в Postgres (<see cref="IRateLimitCounterStore"/> через scoped
-/// <para>
+/// <see cref="StoreBackedFixedWindowRateLimiter"/>) — лимиты общие для всех инстансов core. Пороги/окна
-/// Счётчики окон живут в Postgres (<see cref="IRateLimitCounterStore"/> через scoped
+/// не менялись: фиксированные 1 минута, PermitLimit из <see cref="RateLimitOptions"/>.
-/// <see cref="StoreBackedFixedWindowRateLimiter"/>) — лимиты общие для всех инстансов core. Пороги/окна
+/// </para>
-/// не менялись: фиксированные 1 минута, PermitLimit из <see cref="RateLimitOptions"/>.
+/// </remarks>
-/// </para>
+public static class RateLimitPolicies
-/// </remarks>
+{
-public static class RateLimitPolicies
+    /// <summary>
-{
+    /// Имя политики входа: фиксированное окно по IP (RateLimit:AuthPerMinute).
-    /// <summary>
+    /// </summary>
-    /// Имя политики входа: фиксированное окно по IP (RateLimit:AuthPerMinute).
+    public const string AuthPolicy = "auth";
-    /// </summary>
+
-    public const string AuthPolicy = "auth";
+    /// <summary>
-
+    /// Имя API-политики: фиксированное окно по CurrentUser.TenantId либо IP анонима (RateLimit:ApiPerMinute).
-    /// <summary>
+    /// </summary>
-    /// Имя API-политики: фиксированное окно по CurrentUser.TenantId либо IP анонима (RateLimit:ApiPerMinute).
+    public const string ApiPolicy = "api";
-    /// </summary>
+
-    public const string ApiPolicy = "api";
+    /// <summary>
-
+    /// Текст 429 rate limiter (Ruling 5): все отказы лимитов запросов — единый detail.
-    /// <summary>
+    /// </summary>
-    /// Текст 429 rate limiter (Ruling 5): все отказы лимитов запросов — единый detail.
+    public const string RejectedDetail = "Слишком много запросов. Повторите позже";
-    /// </summary>
+
-    public const string RejectedDetail = "Слишком много запросов. Повторите позже";
+    // Префикс ключа хранилища для HTTP-политик: изолирует счётчики от gRPC-ингресса и login-guard.
-
+    private const string HttpKeyPrefix = "http:";
-    // Префикс ключа хранилища для HTTP-политик: изолирует счётчики от gRPC-ингресса и login-guard.
+
-    private const string HttpKeyPrefix = "http:";
+    // Пространство ключа глобального лимитера: отдельные счётчики от именованной "api"-политики
-
+    // (как и раньше — независимые FixedWindowRateLimiter'ы, лимиты не схлопываются в один бакет).
-    // Пространство ключа глобального лимитера: отдельные счётчики от именованной "api"-политики
+    private const string GlobalScope = "global";
-    // (как и раньше — независимые FixedWindowRateLimiter'ы, лимиты не схлопываются в один бакет).
+
-    private const string GlobalScope = "global";
+    // Префикс партиции API-политики для анонима (IP не разрешён в сессию).
-
+    private const string IpKeyPrefix = "ip:";
-    // Префикс партиции API-политики для анонима (IP не разрешён в сессию).
+
-    private const string IpKeyPrefix = "ip:";
+    // Префикс партиции API-политики для аутентифицированного пользователя (по тенанту).
-
+    private const string TenantKeyPrefix = "tenant:";
-    // Префикс партиции API-политики для аутентифицированного пользователя (по тенанту).
+
-    private const string TenantKeyPrefix = "tenant:";
+    // Ключ партиции, когда IP клиента недоступен (служебные/тестовые вызовы).
-
+    private const string UnknownClientKey = "unknown";
-    // Ключ партиции, когда IP клиента недоступен (служебные/тестовые вызовы).
+
-    private const string UnknownClientKey = "unknown";
+    // Длина окна политик — 1 минута (имена настроек — «PerMinute»).
-
+    private static readonly TimeSpan Window = TimeSpan.FromMinutes(1);
-    // Длина окна политик — 1 минута (имена настроек — «PerMinute»).
+
-    private static readonly TimeSpan Window = TimeSpan.FromMinutes(1);
+    /// <summary>
-
+    /// Регистрирует AddRateLimiter с политиками "auth"/"api" и глобальным лимитером API-партиции.
-    /// <summary>
+    /// </summary>
-    /// Регистрирует AddRateLimiter с политиками "auth"/"api" и глобальным лимитером API-партиции.
+    /// <param name="services">Коллекция сервисов хоста.</param>
-    /// </summary>
+    /// <param name="options">Настройки rate limiting (секция RateLimit).</param>
-    /// <param name="services">Коллекция сервисов хоста.</param>
+    /// <returns>Коллекция сервисов для цепочки вызовов.</returns>
-    /// <param name="options">Настройки rate limiting (секция RateLimit).</param>
+    public static IServiceCollection AddDealRateLimiter(this IServiceCollection services, RateLimitOptions options)
-    /// <returns>Коллекция сервисов для цепочки вызовов.</returns>
+    {
-    public static IServiceCollection AddDealRateLimiter(this IServiceCollection services, RateLimitOptions options)
+        ArgumentNullException.ThrowIfNull(services);
-    {
+        ArgumentNullException.ThrowIfNull(options);
-        ArgumentNullException.ThrowIfNull(services);
+
-        ArgumentNullException.ThrowIfNull(options);
+        int apiPerMinute = options.ApiPerMinute;
-
+        services.AddRateLimiter(limiter =>
-        int apiPerMinute = options.ApiPerMinute;
+        {
-        services.AddRateLimiter(limiter =>
+            limiter.RejectionStatusCode = StatusCodes.Status429TooManyRequests;
-        {
+            limiter.OnRejected = OnRejectedAsync;
-            limiter.RejectionStatusCode = StatusCodes.Status429TooManyRequests;
+            limiter.AddPolicy(AuthPolicy, context => AuthPartition(context, options.AuthPerMinute));
-            limiter.OnRejected = OnRejectedAsync;
+            limiter.AddPolicy(ApiPolicy, context => ApiPartition(context, ApiPolicy, apiPerMinute));
-            limiter.AddPolicy(AuthPolicy, context => AuthPartition(context, options.AuthPerMinute));
+            // Глобальный лимитер — та же API-партиция (своё пространство ключей): эндпоинты без
-            limiter.AddPolicy(ApiPolicy, context => ApiPartition(context, ApiPolicy, apiPerMinute));
+            // RequireRateLimiting ограничены по тенанту/IP (весь /api, кроме ручек входа и gRPC).
-            // Глобальный лимитер — та же API-партиция (своё пространство ключей): эндпоинты без
+            limiter.GlobalLimiter = PartitionedRateLimiter.Create<HttpContext, string>(
-            // RequireRateLimiting ограничены по тенанту/IP (весь /api, кроме ручек входа и gRPC).
+                context => ApiPartition(context, GlobalScope, apiPerMinute));
-            limiter.GlobalLimiter = PartitionedRateLimiter.Create<HttpContext, string>(
+        });
-                context => ApiPartition(context, GlobalScope, apiPerMinute));
+
-        });
+        return services;
-
+    }
-        return services;
+
-    }
+    // Партиция политики "auth": фиксированное окно в минуту на IP клиента.
-
+    // context: Контекст запроса (адрес клиента).
-    // Партиция политики "auth": фиксированное окно в минуту на IP клиента.
+    // permitsPerMinute: Разрешено запросов в минуту на партицию (RateLimit:AuthPerMinute).
-    // context: Контекст запроса (адрес клиента).
+    // Возвращает: Партиция лимитера с ключом IP.
-    // permitsPerMinute: Разрешено запросов в минуту на партицию (RateLimit:AuthPerMinute).
+    private static RateLimitPartition<string> AuthPartition(HttpContext context, int permitsPerMinute)
-    // Возвращает: Партиция лимитера с ключом IP.
+        => StorePartition(context, AuthPolicy, ClientKey(context), permitsPerMinute);
-    private static RateLimitPartition<string> AuthPartition(HttpContext context, int permitsPerMinute)
+
-        => StorePartition(context, AuthPolicy, ClientKey(context), permitsPerMinute);
+    // Партиция политики "api": ключ — тенант сессии (CurrentUser) либо IP анонима.
-
+    // context: Контекст запроса (CurrentUser кладёт SessionMiddleware до UseRateLimiter).
-    // Партиция политики "api": ключ — тенант сессии (CurrentUser) либо IP анонима.
+    // scope: Пространство ключей (имя политики или "global" для глобального лимитера).
-    // context: Контекст запроса (CurrentUser кладёт SessionMiddleware до UseRateLimiter).
+    // permitsPerMinute: Разрешено запросов в минуту на партицию (RateLimit:ApiPerMinute).
-    // scope: Пространство ключей (имя политики или "global" для глобального лимитера).
+    // Возвращает: Партиция лимитера с ключом tenant:{id} либо IP.
-    // permitsPerMinute: Разрешено запросов в минуту на партицию (RateLimit:ApiPerMinute).
+    private static RateLimitPartition<string> ApiPartition(
-    // Возвращает: Партиция лимитера с ключом tenant:{id} либо IP.
+        HttpContext context,
-    private static RateLimitPartition<string> ApiPartition(
+        string scope,
-        HttpContext context,
+        int permitsPerMinute)
-        string scope,
+    {
-        int permitsPerMinute)
+        string partitionKey = context.GetCurrentUser() is { } user
-    {
+            ? TenantKeyPrefix + user.TenantId.ToString("N")
-        string partitionKey = context.GetCurrentUser() is { } user
+            : ClientKey(context);
-            ? TenantKeyPrefix + user.TenantId.ToString("N")
+        return StorePartition(context, scope, partitionKey, permitsPerMinute);
-            : ClientKey(context);
+    }
-        return StorePartition(context, scope, partitionKey, permitsPerMinute);
+
-    }
+    // Строит партицию на хранилище Postgres: ключ = http:{scope}:{partitionKey}, лимитер — лениво.
-
+    // context: Контекст запроса (источник IServiceScopeFactory для лениво создаваемого лимитера).
-    // Строит партицию на хранилище Postgres: ключ = http:{scope}:{partitionKey}, лимитер — лениво.
+    // scope: Пространство ключей (политика/global).
-    // context: Контекст запроса (источник IServiceScopeFactory для лениво создаваемого лимитера).
+    // partitionKey: Ключ партиции (IP/тенант).
-    // scope: Пространство ключей (политика/global).
+    // permitsPerMinute: Разрешено запросов в минуту.
-    // partitionKey: Ключ партиции (IP/тенант).
+    // Возвращает: Партиция store-backed лимитера (ленивое создание и кеш — менеджер партиций).
-    // permitsPerMinute: Разрешено запросов в минуту.
+    private static RateLimitPartition<string> StorePartition(
-    // Возвращает: Партиция store-backed лимитера (ленивое создание и кеш — менеджер партиций).
+        HttpContext context,
-    private static RateLimitPartition<string> StorePartition(
+        string scope,
-        HttpContext context,
+        string partitionKey,
-        string scope,
+        int permitsPerMinute)
-        string partitionKey,
+    {
-        int permitsPerMinute)
+        string storeKey = HttpKeyPrefix + scope + ":" + partitionKey;
-    {
+        return RateLimitPartition.Get(storeKey, key => new StoreBackedFixedWindowRateLimiter(
-        string storeKey = HttpKeyPrefix + scope + ":" + partitionKey;
+            context.RequestServices.GetRequiredService<IServiceScopeFactory>(),
-        return RateLimitPartition.Get(storeKey, key => new StoreBackedFixedWindowRateLimiter(
+            key,
-            context.RequestServices.GetRequiredService<IServiceScopeFactory>(),
+            permitsPerMinute,
-            key,
+            Window,
-            permitsPerMinute,
+            () => DateTimeOffset.UtcNow));
-            Window,
+    }
-            () => DateTimeOffset.UtcNow));
+
-    }
+    // Ключ клиента: строка IP (или unknown, если адрес недоступен).
-
+    // context: Контекст запроса.
-    // Ключ клиента: строка IP (или unknown, если адрес недоступен).
+    // Возвращает: Ключ партиции по IP.
-    // context: Контекст запроса.
+    private static string ClientKey(HttpContext context)
-    // Возвращает: Ключ партиции по IP.
+    {
-    private static string ClientKey(HttpContext context)
+        string? ip = context.Connection.RemoteIpAddress?.ToString();
-    {
+        return string.IsNullOrEmpty(ip) ? UnknownClientKey : IpKeyPrefix + ip;
-        string? ip = context.Connection.RemoteIpAddress?.ToString();
+    }
-        return string.IsNullOrEmpty(ip) ? UnknownClientKey : IpKeyPrefix + ip;
+
-    }
+    // Пишет ответ 429 формата прототипа: {"detail": "…"} (Ruling 10/5).
-
+    // context: Контекст отклонённого запроса.
-    // Пишет ответ 429 формата прототипа: {"detail": "…"} (Ruling 10/5).
+    // cancellationToken: Токен отмены ответа.
-    // context: Контекст отклонённого запроса.
+    private static async ValueTask OnRejectedAsync(OnRejectedContext context, CancellationToken cancellationToken)
-    // cancellationToken: Токен отмены ответа.
+    {
-    private static async ValueTask OnRejectedAsync(OnRejectedContext context, CancellationToken cancellationToken)
+        context.HttpContext.Response.StatusCode = StatusCodes.Status429TooManyRequests;
-    {
+        await context.HttpContext.Response.WriteAsJsonAsync(new { detail = RejectedDetail }, cancellationToken);
-        context.HttpContext.Response.StatusCode = StatusCodes.Status429TooManyRequests;
+    }
-        await context.HttpContext.Response.WriteAsJsonAsync(new { detail = RejectedDetail }, cancellationToken);
+}
-    }
-}

src/core/Deal.Api/Middleware/SessionMiddleware.cs

@@ -1,81 +1,74 @@
-using Deal.Api.Configuration;
+using Deal.Api.Extensions;
-using Deal.Api.Extensions;
+using Deal.Api.Models;
-using Deal.Api.Models;
+using Deal.Modules.Tenants.Application.Services;
-using Deal.Api.Services;
+using Deal.SharedKernel.Tenants.Abstractions;
-using Deal.Modules.Tenants.Application.Abstractions;
+using Deal.SharedKernel.Tenants.Models;
-using Deal.Modules.Tenants.Application.Extensions;
+using Microsoft.Extensions.Options;
-using Deal.Modules.Tenants.Application.Models;
+// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
-using Deal.Modules.Tenants.Application.Registrars;
+using CookieOptions = Deal.Api.Configuration.CookieOptions;
-using Deal.Modules.Tenants.Application.Services;
+
-using Deal.SharedKernel.Tenants.Abstractions;
+namespace Deal.Api.Middleware;
-using Deal.SharedKernel.Tenants.Models;
+
-using Microsoft.Extensions.Options;
+/// <summary>
-using Deal.Api.Dtos;
+/// Middleware сессии: читает httpOnly-куку, разрешает сессию через AuthService и наполняет
-// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
+/// <c>HttpContext.Items["CurrentUser"]</c> + tenant-контекст запроса (ITenantContext).
-using CookieOptions = Deal.Api.Configuration.CookieOptions;
+/// </summary>
-
+/// <remarks>
-namespace Deal.Api.Middleware;
+/// Middleware НЕ отвечает 401 сама (pass-through): эндпоинты, требующие авторизации, проверяют
-
+/// пользователя и выставляют 401. Нет куки или сессия невалидна — запрос идёт дальше без
-/// <summary>
+/// пользователя. Tenant-контекст сбрасывается в finally после обработки запроса.
-/// Middleware сессии: читает httpOnly-куку, разрешает сессию через AuthService и наполняет
+/// <para>
-/// <c>HttpContext.Items["CurrentUser"]</c> + tenant-контекст запроса (ITenantContext).
+/// AuthService — scoped, поэтому на запрос создаётся собственный scope через RequestServices.
-/// </summary>
+/// Экземпляр middleware — singleton (стандартный паттерн UseMiddleware), опции читаются через
-/// <remarks>
+/// IOptionsMonitor, чтобы подхватывать изменения конфигурации.
-/// Middleware НЕ отвечает 401 сама (pass-through): эндпоинты, требующие авторизации, проверяют
+/// </para>
-/// пользователя и выставляют 401. Нет куки или сессия невалидна — запрос идёт дальше без
+/// </remarks>
-/// пользователя. Tenant-контекст сбрасывается в finally после обработки запроса.
+public sealed class SessionMiddleware
-/// <para>
+{
-/// AuthService — scoped, поэтому на запрос создаётся собственный scope через RequestServices.
+    private readonly RequestDelegate _next;
-/// Экземпляр middleware — singleton (стандартный паттерн UseMiddleware), опции читаются через
+    private readonly IOptionsMonitor<CookieOptions> _cookieOptions;
-/// IOptionsMonitor, чтобы подхватывать изменения конфигурации.
+    private readonly ITenantContext _tenantContext;
-/// </para>
+
-/// </remarks>
+    public SessionMiddleware(
-public sealed class SessionMiddleware
+        RequestDelegate next,
-{
+        IOptionsMonitor<CookieOptions> cookieOptions,
-    private readonly RequestDelegate _next;
+        ITenantContext tenantContext)
-    private readonly IOptionsMonitor<CookieOptions> _cookieOptions;
+    {
-    private readonly ITenantContext _tenantContext;
+        _next = next;
-
+        _cookieOptions = cookieOptions;
-    public SessionMiddleware(
+        _tenantContext = tenantContext;
-        RequestDelegate next,
+    }
-        IOptionsMonitor<CookieOptions> cookieOptions,
+
-        ITenantContext tenantContext)
+    /// <summary>
-    {
+    /// Обрабатывает запрос: разрешает сессию по куке и наполняет контекст.
-        _next = next;
+    /// </summary>
-        _cookieOptions = cookieOptions;
+    /// <param name="context">Контекст запроса.</param>
-        _tenantContext = tenantContext;
+    public async Task InvokeAsync(HttpContext context)
-    }
+    {
-
+        try
-    /// <summary>
+        {
-    /// Обрабатывает запрос: разрешает сессию по куке и наполняет контекст.
+            var cookieName = _cookieOptions.CurrentValue.Name;
-    /// </summary>
+            if (context.Request.Cookies.TryGetValue(cookieName, out var rawToken)
-    /// <param name="context">Контекст запроса.</param>
+                && !string.IsNullOrWhiteSpace(rawToken))
-    public async Task InvokeAsync(HttpContext context)
+            {
-    {
+                // AuthService scoped: создаём scope на запрос через RequestServices.
-        try
+                await using var scope = context.RequestServices.CreateAsyncScope();
-        {
+                var authService = scope.ServiceProvider.GetRequiredService<AuthService>();
-            var cookieName = _cookieOptions.CurrentValue.Name;
+                var user = await authService.ResolveSessionAsync(rawToken, context.RequestAborted);
-            if (context.Request.Cookies.TryGetValue(cookieName, out var rawToken)
+                if (user is not null)
-                && !string.IsNullOrWhiteSpace(rawToken))
+                {
-            {
+                    context.SetCurrentUser(new CurrentUser(user.Id, user.Login, user.TenantId, user.Status));
-                // AuthService scoped: создаём scope на запрос через RequestServices.
+                    // Схема тенанта именуется tenant_&lt;id&gt;, где id — Guid в формате "N" (см. TenantService).
-                await using var scope = context.RequestServices.CreateAsyncScope();
+                    _tenantContext.SetTenant(new TenantId(user.TenantId.ToString("N")));
-                var authService = scope.ServiceProvider.GetRequiredService<AuthService>();
+                }
-                var user = await authService.ResolveSessionAsync(rawToken, context.RequestAborted);
+            }
-                if (user is not null)
+
-                {
+            await _next(context);
-                    context.SetCurrentUser(new CurrentUser(user.Id, user.Login, user.TenantId, user.Status));
+        }
-                    // Схема тенанта именуется tenant_&lt;id&gt;, где id — Guid в формате "N" (см. TenantService).
+        finally
-                    _tenantContext.SetTenant(new TenantId(user.TenantId.ToString("N")));
+        {
-                }
+            // Контекст AsyncLocal не должен переживать запрос.
-            }
+            _tenantContext.Reset();
-
+        }
-            await _next(context);
+    }
-        }
+}
-        finally
-        {
-            // Контекст AsyncLocal не должен переживать запрос.
-            _tenantContext.Reset();
-        }
-    }
-}

src/core/Deal.Api/Models/CurrentOperator.cs

@@ -1,13 +1,9 @@
-using Deal.Api.Services;
+namespace Deal.Api.Models;
-using Deal.Api.Dtos;
+
-using Deal.Api.Extensions;
+/// <summary>
-
+/// Текущий оператор запроса — кладёт OperatorSessionMiddleware в <c>HttpContext.Items</c> (Ruling 1).
-namespace Deal.Api.Models;
+/// </summary>
-
+/// <param name="OperatorId">Идентификатор оператора.</param>
-/// <summary>
+/// <param name="Login">Логин в нижнем регистре.</param>
-/// Текущий оператор запроса — кладёт OperatorSessionMiddleware в <c>HttpContext.Items</c> (Ruling 1).
+/// <param name="Status">Статус учётной записи (всегда "active" — разрешаются только активные).</param>
-/// </summary>
+public sealed record CurrentOperator(Guid OperatorId, string Login, string Status);
-/// <param name="OperatorId">Идентификатор оператора.</param>
-/// <param name="Login">Логин в нижнем регистре.</param>
-/// <param name="Status">Статус учётной записи (всегда "active" — разрешаются только активные).</param>
-public sealed record CurrentOperator(Guid OperatorId, string Login, string Status);

src/core/Deal.Api/Models/CurrentUser.cs

@@ -1,14 +1,10 @@
-using Deal.Api.Services;
+namespace Deal.Api.Models;
-using Deal.Api.Dtos;
+
-using Deal.Api.Extensions;
+/// <summary>
-
+/// Текущий пользователь запроса — кладётся SessionMiddleware в <c>HttpContext.Items</c>.
-namespace Deal.Api.Models;
+/// </summary>
-
+/// <param name="UserId">Идентификатор пользователя.</param>
-/// <summary>
+/// <param name="Login">Логин в нижнем регистре.</param>
-/// Текущий пользователь запроса — кладётся SessionMiddleware в <c>HttpContext.Items</c>.
+/// <param name="TenantId">Идентификатор тенанта, которому принадлежит пользователь.</param>
-/// </summary>
+/// <param name="Status">Статус учётной записи.</param>
-/// <param name="UserId">Идентификатор пользователя.</param>
+public sealed record CurrentUser(Guid UserId, string Login, Guid TenantId, string Status);
-/// <param name="Login">Логин в нижнем регистре.</param>
-/// <param name="TenantId">Идентификатор тенанта, которому принадлежит пользователь.</param>
-/// <param name="Status">Статус учётной записи.</param>
-public sealed record CurrentUser(Guid UserId, string Login, Guid TenantId, string Status);

src/core/Deal.Api/Observability/DealMetricsCollector.cs

@@ -1,6 +1,4 @@
 using Deal.SharedKernel.Observability;
-using Deal.Api.Services;
-using Deal.Api.Dtos;
 
 namespace Deal.Api.Observability;
 

src/core/Deal.Api/Observability/DealMetricsHosting.cs

@@ -1,12 +1,6 @@
 using Deal.SharedKernel.Observability;
-using Microsoft.AspNetCore.Builder;
-using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore.Server.Kestrel.Core;
-using Microsoft.Extensions.DependencyInjection;
-using OpenTelemetry;
 using OpenTelemetry.Metrics;
-using Deal.Api.Services;
-using Deal.Api.Dtos;
 
 namespace Deal.Api.Observability;
 

src/core/Deal.Api/Observability/RuntimeDepthsCollector.cs

@@ -1,160 +1,148 @@
-using Deal.Infrastructure.Persistence;
+using Deal.Infrastructure.Persistence;
-using Deal.Infrastructure.Persistence.Configurations;
+using Deal.Modules.Kanban.Application.Abstractions;
-using Deal.Modules.Kanban.Application.Abstractions;
+using Deal.Modules.Pipeline.Application.Models;
-using Deal.Modules.Kanban.Application.Extensions;
+using Deal.Modules.Pipeline.Application.Services;
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Tenants.Application.Abstractions;
-using Deal.Modules.Kanban.Application.Registrars;
+using Deal.Modules.Tenants.Application.Models;
-using Deal.Modules.Kanban.Application.Services;
+using Deal.SharedKernel.Tenants.Abstractions;
-using Deal.Modules.Pipeline.Application.Abstractions;
+using Deal.SharedKernel.Tenants.Models;
-using Deal.Modules.Pipeline.Application.Models;
+using Microsoft.EntityFrameworkCore;
-using Deal.Modules.Pipeline.Application.Registrars;
+
-using Deal.Modules.Pipeline.Application.Services;
+namespace Deal.Api.Observability;
-using Deal.Modules.Tenants.Application.Abstractions;
+
-using Deal.Modules.Tenants.Application.Extensions;
+/// <summary>
-using Deal.Modules.Tenants.Application.Models;
+/// Сборщик глубин очередей и активных сессий (этап 12, §10.2): единый источник для метрик и health.
-using Deal.Modules.Tenants.Application.Registrars;
+/// </summary>
-using Deal.Modules.Tenants.Application.Services;
+/// <remarks>
-using Deal.SharedKernel.Tenants.Abstractions;
+/// <para>
-using Deal.SharedKernel.Tenants.Models;
+/// Обходит реестр тенантов (на тенант — вложенный scope с <c>ITenantContext.SetTenant</c>) и считает через
-using Microsoft.EntityFrameworkCore;
+/// существующие сервисы/порты, без дублирования SQL:
-using Deal.Api.Services;
+/// <list type="bullet">
-using Deal.Api.Dtos;
+/// <item>глубина очереди пайплайна — <see cref="PipelineProcessingService.QueueCountsAsync"/> (new+filtered);</item>
-
+/// <item>глубина очереди обучения ML — <see cref="IMlLearningStore.CountOutboxAsync"/> (count(MlOutbox));</item>
-namespace Deal.Api.Observability;
+/// <item>активные сессии — count(public.sessions) + count(public.operator_sessions) с непросроченным ExpiresAt.</item>
-
+/// </list>
-/// <summary>
+/// Переиспользуется фоновым <see cref="DealMetricsCollector"/> (публикация в <c>DealMetrics</c>) и операторским
-/// Сборщик глубин очередей и активных сессий (этап 12, §10.2): единый источник для метрик и health.
+/// health (глубины прямо в JSON). Ошибки каждой секции логируются и не выбрасываются наружу (сбой тенанта не
-/// </summary>
+/// валит проход; наружу летит только отмена); значения агрегируются по всем тенантам.
-/// <remarks>
+/// </para>
-/// <para>
+/// </remarks>
-/// Обходит реестр тенантов (на тенант — вложенный scope с <c>ITenantContext.SetTenant</c>) и считает через
+public sealed class RuntimeDepthsCollector
-/// существующие сервисы/порты, без дублирования SQL:
+{
-/// <list type="bullet">
+    private readonly IServiceScopeFactory _scopeFactory;
-/// <item>глубина очереди пайплайна — <see cref="PipelineProcessingService.QueueCountsAsync"/> (new+filtered);</item>
+    private readonly ILogger<RuntimeDepthsCollector> _logger;
-/// <item>глубина очереди обучения ML — <see cref="IMlLearningStore.CountOutboxAsync"/> (count(MlOutbox));</item>
+
-/// <item>активные сессии — count(public.sessions) + count(public.operator_sessions) с непросроченным ExpiresAt.</item>
+    /// <summary>
-/// </list>
+    /// Создаёт сборщик глубин.
-/// Переиспользуется фоновым <see cref="DealMetricsCollector"/> (публикация в <c>DealMetrics</c>) и операторским
+    /// </summary>
-/// health (глубины прямо в JSON). Ошибки каждой секции логируются и не выбрасываются наружу (сбой тенанта не
+    /// <param name="scopeFactory">Фабрика scope: проход и тенант — в собственных scope.</param>
-/// валит проход; наружу летит только отмена); значения агрегируются по всем тенантам.
+    /// <param name="logger">Логгер ошибок секций.</param>
-/// </para>
+    public RuntimeDepthsCollector(IServiceScopeFactory scopeFactory, ILogger<RuntimeDepthsCollector> logger)
-/// </remarks>
+    {
-public sealed class RuntimeDepthsCollector
+        ArgumentNullException.ThrowIfNull(scopeFactory);
-{
+        ArgumentNullException.ThrowIfNull(logger);
-    private readonly IServiceScopeFactory _scopeFactory;
+        _scopeFactory = scopeFactory;
-    private readonly ILogger<RuntimeDepthsCollector> _logger;
+        _logger = logger;
-
+    }
-    /// <summary>
+
-    /// Создаёт сборщик глубин.
+    /// <summary>
-    /// </summary>
+    /// Собирает снимок глубин очередей и числа активных сессий (агрегат по всем тенантам).
-    /// <param name="scopeFactory">Фабрика scope: проход и тенант — в собственных scope.</param>
+    /// </summary>
-    /// <param name="logger">Логгер ошибок секций.</param>
+    /// <param name="ct">Токен отмены (пробрасывается в EF-запросы; отмена — единственное исключение наружу).</param>
-    public RuntimeDepthsCollector(IServiceScopeFactory scopeFactory, ILogger<RuntimeDepthsCollector> logger)
+    /// <returns>Снимок: суммарные глубины pipeline/ML-outbox и число активных сессий.</returns>
-    {
+    public async Task<RuntimeDepthsDto> CollectAsync(CancellationToken ct)
-        ArgumentNullException.ThrowIfNull(scopeFactory);
+    {
-        ArgumentNullException.ThrowIfNull(logger);
+        await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
-        _scopeFactory = scopeFactory;
+        int sessions = await CountActiveSessionsAsync(cycleScope, ct);
-        _logger = logger;
+        (long queue, long outbox) = await SumTenantDepthsAsync(cycleScope, ct);
-    }
+        return new RuntimeDepthsDto(queue, outbox, sessions);
-
+    }
-    /// <summary>
+
-    /// Собирает снимок глубин очередей и числа активных сессий (агрегат по всем тенантам).
+    // Считает активные непросроченные сессии пользователей и операторов (public-схема).
-    /// </summary>
+    // cycleScope: Scope прохода (DealDbContext — без tenant-контекста).
-    /// <param name="ct">Токен отмены (пробрасывается в EF-запросы; отмена — единственное исключение наружу).</param>
+    // ct: Токен отмены.
-    /// <returns>Снимок: суммарные глубины pipeline/ML-outbox и число активных сессий.</returns>
+    // Возвращает: Число активных сессий; сбой секции — 0 (снимок остаётся полезным).
-    public async Task<RuntimeDepthsDto> CollectAsync(CancellationToken ct)
+    private async Task<int> CountActiveSessionsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
-    {
+    {
-        await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
+        try
-        int sessions = await CountActiveSessionsAsync(cycleScope, ct);
+        {
-        (long queue, long outbox) = await SumTenantDepthsAsync(cycleScope, ct);
+            DealDbContext dbContext = cycleScope.ServiceProvider.GetRequiredService<DealDbContext>();
-        return new RuntimeDepthsDto(queue, outbox, sessions);
+            DateTimeOffset now = DateTimeOffset.UtcNow;
-    }
+            int tenantSessions = await dbContext.Sessions.CountAsync(session => session.ExpiresAt > now, ct);
-
+            int operatorSessions = await dbContext.OperatorSessions.CountAsync(session => session.ExpiresAt > now, ct);
-    // Считает активные непросроченные сессии пользователей и операторов (public-схема).
+            return tenantSessions + operatorSessions;
-    // cycleScope: Scope прохода (DealDbContext — без tenant-контекста).
+        }
-    // ct: Токен отмены.
+        catch (OperationCanceledException)
-    // Возвращает: Число активных сессий; сбой секции — 0 (снимок остаётся полезным).
+        {
-    private async Task<int> CountActiveSessionsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
+            throw;
-    {
+        }
-        try
+        catch (Exception exception)
-        {
+        {
-            DealDbContext dbContext = cycleScope.ServiceProvider.GetRequiredService<DealDbContext>();
+            _logger.LogWarning(exception, "Сборщик глубин: подсчёт активных сессий не удался");
-            DateTimeOffset now = DateTimeOffset.UtcNow;
+            return 0;
-            int tenantSessions = await dbContext.Sessions.CountAsync(session => session.ExpiresAt > now, ct);
+        }
-            int operatorSessions = await dbContext.OperatorSessions.CountAsync(session => session.ExpiresAt > now, ct);
+    }
-            return tenantSessions + operatorSessions;
+
-        }
+    // Суммирует глубины очередей по всем тенантам реестра.
-        catch (OperationCanceledException)
+    // cycleScope: Scope прохода (реестр тенантов читается без tenant-контекста).
-        {
+    // ct: Токен отмены.
-            throw;
+    // Возвращает: Пара (сумма очереди пайплайна, сумма MlOutbox); недоступность реестра — (0, 0).
-        }
+    private async Task<(long Queue, long Outbox)> SumTenantDepthsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
-        catch (Exception exception)
+    {
-        {
+        long queueDepth = 0;
-            _logger.LogWarning(exception, "Сборщик глубин: подсчёт активных сессий не удался");
+        long outboxDepth = 0;
-            return 0;
+        try
-        }
+        {
-    }
+            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
-
+            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
-    // Суммирует глубины очередей по всем тенантам реестра.
+            foreach (TenantRecordDto tenant in tenants)
-    // cycleScope: Scope прохода (реестр тенантов читается без tenant-контекста).
+            {
-    // ct: Токен отмены.
+                (int queue, int outbox) = await CollectTenantAsync(tenant, ct);
-    // Возвращает: Пара (сумма очереди пайплайна, сумма MlOutbox); недоступность реестра — (0, 0).
+                queueDepth += queue;
-    private async Task<(long Queue, long Outbox)> SumTenantDepthsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
+                outboxDepth += outbox;
-    {
+            }
-        long queueDepth = 0;
+        }
-        long outboxDepth = 0;
+        catch (OperationCanceledException)
-        try
+        {
-        {
+            throw;
-            ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
+        }
-            IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
+        catch (Exception exception)
-            foreach (TenantRecordDto tenant in tenants)
+        {
-            {
+            _logger.LogWarning(exception, "Сборщик глубин: обход реестра тенантов не удался");
-                (int queue, int outbox) = await CollectTenantAsync(tenant, ct);
+        }
-                queueDepth += queue;
+
-                outboxDepth += outbox;
+        return (queueDepth, outboxDepth);
-            }
+    }
-        }
+
-        catch (OperationCanceledException)
+    // Считает глубины очередей одного тенанта в собственном scope (SetTenant → сервисы → Reset).
-        {
+    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
-            throw;
+    // ct: Токен отмены прохода.
-        }
+    // Возвращает: Пара (глубина очереди пайплайна, глубина MlOutbox) для тенанта; сбой — (0, 0).
-        catch (Exception exception)
+    private async Task<(int Queue, int Outbox)> CollectTenantAsync(TenantRecordDto tenant, CancellationToken ct)
-        {
+    {
-            _logger.LogWarning(exception, "Сборщик глубин: обход реестра тенантов не удался");
+        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
-        }
+        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
-
+        try
-        return (queueDepth, outboxDepth);
+        {
-    }
+            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
-
+            PipelineProcessingService processing = tenantScope.ServiceProvider.GetRequiredService<PipelineProcessingService>();
-    // Считает глубины очередей одного тенанта в собственном scope (SetTenant → сервисы → Reset).
+            QueueCountsDto counts = await processing.QueueCountsAsync(ct);
-    // tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
+            IMlLearningStore learningStore = tenantScope.ServiceProvider.GetRequiredService<IMlLearningStore>();
-    // ct: Токен отмены прохода.
+            int outbox = await learningStore.CountOutboxAsync(ct);
-    // Возвращает: Пара (глубина очереди пайплайна, глубина MlOutbox) для тенанта; сбой — (0, 0).
+            return (counts.Total, outbox);
-    private async Task<(int Queue, int Outbox)> CollectTenantAsync(TenantRecordDto tenant, CancellationToken ct)
+        }
-    {
+        catch (OperationCanceledException)
-        await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
+        {
-        ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
+            throw;
-        try
+        }
-        {
+        catch (Exception exception)
-            tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
+        {
-            PipelineProcessingService processing = tenantScope.ServiceProvider.GetRequiredService<PipelineProcessingService>();
+            _logger.LogWarning(exception, "Сборщик глубин: подсчёт очередей тенанта {TenantId} не удался", tenant.Id);
-            QueueCountsDto counts = await processing.QueueCountsAsync(ct);
+            return (0, 0);
-            IMlLearningStore learningStore = tenantScope.ServiceProvider.GetRequiredService<IMlLearningStore>();
+        }
-            int outbox = await learningStore.CountOutboxAsync(ct);
+        finally
-            return (counts.Total, outbox);
+        {
-        }
+            tenantContext.Reset();
-        catch (OperationCanceledException)
+        }
-        {
+    }
-            throw;
+}
-        }
-        catch (Exception exception)
-        {
-            _logger.LogWarning(exception, "Сборщик глубин: подсчёт очередей тенанта {TenantId} не удался", tenant.Id);
-            return (0, 0);
-        }
-        finally
-        {
-            tenantContext.Reset();
-        }
-    }
-}

src/core/Deal.Api/Observability/RuntimeDepthsDto.cs

@@ -1,6 +1,3 @@
-using Deal.Api.Services;
-using Deal.Api.Dtos;
-
 namespace Deal.Api.Observability;
 
 /// <summary>

src/core/Deal.Api/Services/AdminTickOrchestrator.cs

@@ -1,193 +1,186 @@
-using Deal.Api.Events;
+using Deal.Api.Dtos;
-using Deal.Modules.Kanban.Application.Abstractions;
+using Deal.Api.Events;
-using Deal.Modules.Kanban.Application.Extensions;
+using Deal.Modules.Kanban.Application.Models;
-using Deal.Modules.Kanban.Application.Models;
+using Deal.Modules.Kanban.Application.Services;
-using Deal.Modules.Kanban.Application.Registrars;
+using Deal.Modules.Pipeline.Application.Models;
-using Deal.Modules.Kanban.Application.Services;
+using Deal.Modules.Pipeline.Application.Services;
-using Deal.Modules.Pipeline.Application.Abstractions;
+
-using Deal.Modules.Pipeline.Application.Models;
+namespace Deal.Api.Services;
-using Deal.Modules.Pipeline.Application.Registrars;
+
-using Deal.Modules.Pipeline.Application.Services;
+/// <summary>
-using Deal.Api.Dtos;
+/// Оркестратор ручного тика POST /api/admin/tick (план Tasks 10–11, Ruling 8/9; dashboard_routes.py admin_tick L327–337).
-using Deal.Api;
+/// </summary>
-using Deal.Api.Services;
+/// <remarks>
-
+/// Api-слой объединяет сервисы модулей (Kanban тик правил хранения + Pipeline очистка отсева и pump +
-namespace Deal.Api.Services;
+/// Projects проверка напоминаний «Отложено») и публикует SSE (Ruling 5/8/9 — публикации только из Api;
-
+/// модули остаются чистыми). Порядок 1:1 с прототипом:
-/// <summary>
+/// (1) <see cref="StorageTickService.TickAsync"/> — автоархив и очистки архива/корзины;
-/// Оркестратор ручного тика POST /api/admin/tick (план Tasks 10–11, Ruling 8/9; dashboard_routes.py admin_tick L327–337).
+/// (2) <see cref="PipelineProcessingService.PurgeExpiredAsync"/> — отсев старше 3 суток (tick_storage L485–493),
-/// </summary>
+/// результат вливается в storage.purgedRejected (Ruling 9);
-/// <remarks>
+/// (3) SSE-тосты статистики (<see cref="StorageToastPublisher"/>, notify_tick_stats L496–504) — до pump, как в
-/// Api-слой объединяет сервисы модулей (Kanban тик правил хранения + Pipeline очистка отсева и pump +
+/// прототипе (L333);
-/// Projects проверка напоминаний «Отложено») и публикует SSE (Ruling 5/8/9 — публикации только из Api;
+/// (4) проверка наступивших напоминаний <see cref="CardsService.CheckDueRemindersAsync"/> (admin_tick L334,
-/// модули остаются чистыми). Порядок 1:1 с прототипом:
+/// check_reminders L264–282; план Task 11, Ruling 3): «выстрелившие» {id,title,containerId} помечены fired и
-/// (1) <see cref="StorageTickService.TickAsync"/> — автоархив и очистки архива/корзины;
+/// публикуются SSE <c>reminder_due</c> (Ruling 8 — toast НЕ шлём, у фронта модалка ReminderNotice); сбой
-/// (2) <see cref="PipelineProcessingService.PurgeExpiredAsync"/> — отсев старше 3 суток (tick_storage L485–493),
+/// проверки НЕ роняет тик: лог + reminders ответа пуст;
-/// результат вливается в storage.purgedRejected (Ruling 9);
+/// (5) <see cref="PipelineWorkerService.PumpOnceAsync"/> под общим воркер-гейтом тенанта (Task 10/11): pump
-/// (3) SSE-тосты статистики (<see cref="StorageToastPublisher"/>, notify_tick_stats L496–504) — до pump, как в
+/// одного тенанта выполняет либо ручной тик, либо фоновый цикл — при занятом гейте проход пропускается;
-/// прототипе (L333);
+/// сбой pump НЕ роняет тик: исключение логируется, pipeline ответа пуст ({} как при занятом локе прототипа
-/// (4) проверка наступивших напоминаний <see cref="CardsService.CheckDueRemindersAsync"/> (admin_tick L334,
+/// L901–902), очередь остаётся до следующего тика/фонового цикла. Операция отмены (OCE) пробрасывается — запрос прерван;
-/// check_reminders L264–282; план Task 11, Ruling 3): «выстрелившие» {id,title,containerId} помечены fired и
+/// (6) SSE new_card по каждой созданной карточке (Ruling 8/9; полный CardDto, как publish из Api);
-/// публикуются SSE <c>reminder_due</c> (Ruling 8 — toast НЕ шлём, у фронта модалка ReminderNotice); сбой
+/// (7) queue = строк очереди после pump (queue_len L337). Ответ — <see cref="AdminTickResultDto"/>.
-/// проверки НЕ роняет тик: лог + reminders ответа пуст;
+/// </remarks>
-/// (5) <see cref="PipelineWorkerService.PumpOnceAsync"/> под общим воркер-гейтом тенанта (Task 10/11): pump
+/// <param name="storageTick">Тик правил хранения канбана (StorageTickService модуля Kanban).</param>
-/// одного тенанта выполняет либо ручной тик, либо фоновый цикл — при занятом гейте проход пропускается;
+/// <param name="processing">Очистка отсева и счётчики очереди (модуль Pipeline).</param>
-/// сбой pump НЕ роняет тик: исключение логируется, pipeline ответа пуст ({} как при занятом локе прототипа
+/// <param name="worker">Один проход pump по очереди входящих (модуль Pipeline).</param>
-/// L901–902), очередь остаётся до следующего тика/фонового цикла. Операция отмены (OCE) пробрасывается — запрос прерван;
+/// <param name="reminders">Проверка наступивших напоминаний «Отложено» (CardsService, Ruling 3).</param>
-/// (6) SSE new_card по каждой созданной карточке (Ruling 8/9; полный CardDto, как publish из Api);
+/// <param name="toastPublisher">Публикатор SSE-тостов статистики тика (общий с фоновым циклом Task 11).</param>
-/// (7) queue = строк очереди после pump (queue_len L337). Ответ — <see cref="AdminTickResultDto"/>.
+/// <param name="broker">SSE-брокер канала тенанта (публикация reminder_due/new_card).</param>
-/// </remarks>
+/// <param name="pumpGate">Общий воркер-гейт pump тенанта (singleton; общий с фоновым циклом Task 11).</param>
-/// <param name="storageTick">Тик правил хранения канбана (StorageTickService модуля Kanban).</param>
+/// <param name="logger">Логгер сбоя проверки напоминаний/pump (тик продолжается без этих веток).</param>
-/// <param name="processing">Очистка отсева и счётчики очереди (модуль Pipeline).</param>
+public sealed class AdminTickOrchestrator(
-/// <param name="worker">Один проход pump по очереди входящих (модуль Pipeline).</param>
+    StorageTickService storageTick,
-/// <param name="reminders">Проверка наступивших напоминаний «Отложено» (CardsService, Ruling 3).</param>
+    PipelineProcessingService processing,
-/// <param name="toastPublisher">Публикатор SSE-тостов статистики тика (общий с фоновым циклом Task 11).</param>
+    PipelineWorkerService worker,
-/// <param name="broker">SSE-брокер канала тенанта (публикация reminder_due/new_card).</param>
+    CardsService reminders,
-/// <param name="pumpGate">Общий воркер-гейт pump тенанта (singleton; общий с фоновым циклом Task 11).</param>
+    StorageToastPublisher toastPublisher,
-/// <param name="logger">Логгер сбоя проверки напоминаний/pump (тик продолжается без этих веток).</param>
+    SseBroker broker,
-public sealed class AdminTickOrchestrator(
+    PipelinePumpGate pumpGate,
-    StorageTickService storageTick,
+    ILogger<AdminTickOrchestrator> logger)
-    PipelineProcessingService processing,
+{
-    PipelineWorkerService worker,
+    // SSE-тип события новой карточки (Ruling 5; api.js слушает 'new_card').
-    CardsService reminders,
+    private const string NewCardEventType = "new_card";
-    StorageToastPublisher toastPublisher,
+
-    SseBroker broker,
+    // SSE-тип события «выстрелившего» напоминания «Отложено» (Ruling 8, api-map §2: {id,title,containerId}).
-    PipelinePumpGate pumpGate,
+    private const string ReminderDueEventType = "reminder_due";
-    ILogger<AdminTickOrchestrator> logger)
+
-{
+    // Ключи счётчиков pump в pipeline-словаре ответа (1:1 со словарём _pump_unlocked python L921).
-    // SSE-тип события новой карточки (Ruling 5; api.js слушает 'new_card').
+    private static readonly string[] PipelineCounterKeys =
-    private const string NewCardEventType = "new_card";
+    [
-
+        "staged", "rulesStored", "mlStored", "mlDrop", "typeDrop", "aiStored", "aiDrop", "aiFail", "noBudget",
-    // SSE-тип события «выстрелившего» напоминания «Отложено» (Ruling 8, api-map §2: {id,title,containerId}).
+    ];
-    private const string ReminderDueEventType = "reminder_due";
+
-
+    /// <summary>
-    // Ключи счётчиков pump в pipeline-словаре ответа (1:1 со словарём _pump_unlocked python L921).
+    /// Выполняет один ручной тик тенанта: правила хранения + очистка отсева + напоминания + pump + SSE-публикации.
-    private static readonly string[] PipelineCounterKeys =
+    /// </summary>
-    [
+    /// <param name="tenantId">Тенант-получатель (сессия запроса; канал SSE-публикаций).</param>
-        "staged", "rulesStored", "mlStored", "mlDrop", "typeDrop", "aiStored", "aiDrop", "aiFail", "noBudget",
+    /// <param name="ct">Токен отмены запроса.</param>
-    ];
+    /// <returns>Ответ {storage, reminders, pipeline, queue}; сбой проверки напоминаний/pump не выбрасывается наружу.</returns>
-
+    public async Task<AdminTickResultDto> TickAsync(Guid tenantId, CancellationToken ct)
-    /// <summary>
+    {
-    /// Выполняет один ручной тик тенанта: правила хранения + очистка отсева + напоминания + pump + SSE-публикации.
+        // (1) Тик правил хранения канбана (как этап 3; leads.py tick_storage L454–484).
-    /// </summary>
+        StorageTickStatsDto storage = await storageTick.TickAsync(ct);
-    /// <param name="tenantId">Тенант-получатель (сессия запроса; канал SSE-публикаций).</param>
+
-    /// <param name="ct">Токен отмены запроса.</param>
+        // (2) Очистка отсева пайплайна: записи старше 3 суток — безвозвратно (tick_storage L485–486); счётчик
-    /// <returns>Ответ {storage, reminders, pipeline, queue}; сбой проверки напоминаний/pump не выбрасывается наружу.</returns>
+        // вливается в storage.purgedRejected (Ruling 9: ответ тика объединяет статистику, L488–493).
-    public async Task<AdminTickResultDto> TickAsync(Guid tenantId, CancellationToken ct)
+        int purgedRejected = await processing.PurgeExpiredAsync(ct);
-    {
+        StorageTickStatsDto mergedStorage = storage with { PurgedRejected = purgedRejected };
-        // (1) Тик правил хранения канбана (как этап 3; leads.py tick_storage L454–484).
+
-        StorageTickStatsDto storage = await storageTick.TickAsync(ct);
+        // (3) Тосты статистики — до pump, как в прототипе (L333): очистка отсева видна, даже если pump упадёт.
-
+        toastPublisher.PublishTickToasts(tenantId, mergedStorage);
-        // (2) Очистка отсева пайплайна: записи старше 3 суток — безвозвратно (tick_storage L485–486); счётчик
+
-        // вливается в storage.purgedRejected (Ruling 9: ответ тика объединяет статистику, L488–493).
+        // (4) Проверка наступивших напоминаний «Отложено» (admin_tick L334 → check_reminders L264–282; план
-        int purgedRejected = await processing.PurgeExpiredAsync(ct);
+        // Task 11, Ruling 3): CheckDueAsync помечает due-строки fired и возвращает их {id,title,stage}. Сбой
-        StorageTickStatsDto mergedStorage = storage with { PurgedRejected = purgedRejected };
+        // проверки НЕ роняет тик: лог + reminders ответа пуст (очередь/хранение продолжают работать).
-
+        IReadOnlyList<CardReminderDueDto> dueReminders;
-        // (3) Тосты статистики — до pump, как в прототипе (L333): очистка отсева видна, даже если pump упадёт.
+        try
-        toastPublisher.PublishTickToasts(tenantId, mergedStorage);
+        {
-
+            dueReminders = await reminders.CheckDueRemindersAsync(ct);
-        // (4) Проверка наступивших напоминаний «Отложено» (admin_tick L334 → check_reminders L264–282; план
+        }
-        // Task 11, Ruling 3): CheckDueAsync помечает due-строки fired и возвращает их {id,title,stage}. Сбой
+        catch (OperationCanceledException)
-        // проверки НЕ роняет тик: лог + reminders ответа пуст (очередь/хранение продолжают работать).
+        {
-        IReadOnlyList<CardReminderDueDto> dueReminders;
+            // Запрос отменён — прерываем тик штатно (не «сбой проверки напоминаний»).
-        try
+            throw;
-        {
+        }
-            dueReminders = await reminders.CheckDueRemindersAsync(ct);
+        catch (Exception exception)
-        }
+        {
-        catch (OperationCanceledException)
+            logger.LogWarning(exception, "POST /api/admin/tick: проверка напоминаний не удалась — reminders ответа пуст");
-        {
+            dueReminders = Array.Empty<CardReminderDueDto>();
-            // Запрос отменён — прерываем тик штатно (не «сбой проверки напоминаний»).
+        }
-            throw;
+
-        }
+        // SSE reminder_due по каждому «выстрелившему» напоминанию (Ruling 8: событие {id,title,stage}, toast НЕ
-        catch (Exception exception)
+        // шлём — у фронта модалка ReminderNotice; без подписчиков канала публикация — no-op). После MarkFired
-        {
+        // (внутри CheckDueAsync), как прототип L277–281 — публикуются уже «сработавшие» записи.
-            logger.LogWarning(exception, "POST /api/admin/tick: проверка напоминаний не удалась — reminders ответа пуст");
+        foreach (CardReminderDueDto due in dueReminders)
-            dueReminders = Array.Empty<CardReminderDueDto>();
+        {
-        }
+            broker.Publish(tenantId, ReminderDueEventType, due);
-
+        }
-        // SSE reminder_due по каждому «выстрелившему» напоминанию (Ruling 8: событие {id,title,stage}, toast НЕ
+
-        // шлём — у фронта модалка ReminderNotice; без подписчиков канала публикация — no-op). После MarkFired
+        // (5) Один проход pump под гейтом тенанта; сбой не роняет тик: pipeline={}, очередь дождётся
-        // (внутри CheckDueAsync), как прототип L277–281 — публикуются уже «сработавшие» записи.
+        // следующего тика/фонового цикла (Ruling 10; Task 11 — гейт общий с фоновым циклом).
-        foreach (CardReminderDueDto due in dueReminders)
+        PipelinePumpResult? pump = await PumpOnceSafelyAsync(tenantId, ct);
-        {
+
-            broker.Publish(tenantId, ReminderDueEventType, due);
+        // (6) SSE new_card по карточкам, созданным проходом (Ruling 8/9; без подписчиков — no-op).
-        }
+        if (pump is not null)
-
+        {
-        // (5) Один проход pump под гейтом тенанта; сбой не роняет тик: pipeline={}, очередь дождётся
+            foreach (CardDto card in pump.CreatedCards)
-        // следующего тика/фонового цикла (Ruling 10; Task 11 — гейт общий с фоновым циклом).
+            {
-        PipelinePumpResult? pump = await PumpOnceSafelyAsync(tenantId, ct);
+                broker.Publish(tenantId, NewCardEventType, card);
-
+            }
-        // (6) SSE new_card по карточкам, созданным проходом (Ruling 8/9; без подписчиков — no-op).
+        }
-        if (pump is not null)
+
-        {
+        // (7) Строк очереди после pump (queue_len L337: total = new + ai).
-            foreach (CardDto card in pump.CreatedCards)
+        QueueCountsDto queueCounts = await processing.QueueCountsAsync(ct);
-            {
+
-                broker.Publish(tenantId, NewCardEventType, card);
+        return new AdminTickResultDto(
-            }
+            mergedStorage,
-        }
+            dueReminders,
-
+            pump is null ? new Dictionary<string, int>() : ToPipelineWireDict(pump),
-        // (7) Строк очереди после pump (queue_len L337: total = new + ai).
+            queueCounts.Total);
-        QueueCountsDto queueCounts = await processing.QueueCountsAsync(ct);
+    }
-
+
-        return new AdminTickResultDto(
+    // Один проход воркера под гейтом тенанта с изоляцией сбоя: исключения pump не роняют тик (Task 10).
-            mergedStorage,
+    // tenantId: Тенант тика (ключ гейта, общего с фоновым циклом Task 11).
-            dueReminders,
+    // ct: Токен отмены запроса.
-            pump is null ? new Dictionary<string, int>() : ToPipelineWireDict(pump),
+    // Возвращает: Результат прохода либо null — гейт занят другим воркером/pump упал (pipeline ответа пуст).
-            queueCounts.Total);
+    private async Task<PipelinePumpResult?> PumpOnceSafelyAsync(Guid tenantId, CancellationToken ct)
-    }
+    {
-
+        // Общий воркер-гейт (Ruling 8, аналог asyncio.Lock pipeline.py L40): admin/tick и фоновый цикл не
-    // Один проход воркера под гейтом тенанта с изоляцией сбоя: исключения pump не роняют тик (Task 10).
+        // разбирают очередь тенанта одновременно. Гейт занят (фоновый цикл уже pump'ит) — проход пропускаем,
-    // tenantId: Тенант тика (ключ гейта, общего с фоновым циклом Task 11).
+        // как прототип при занятом локе (L901–902): pipeline={}, очередь дождётся следующего срабатывания.
-    // ct: Токен отмены запроса.
+        if (!pumpGate.TryEnter(tenantId))
-    // Возвращает: Результат прохода либо null — гейт занят другим воркером/pump упал (pipeline ответа пуст).
+        {
-    private async Task<PipelinePumpResult?> PumpOnceSafelyAsync(Guid tenantId, CancellationToken ct)
+            return null;
-    {
+        }
-        // Общий воркер-гейт (Ruling 8, аналог asyncio.Lock pipeline.py L40): admin/tick и фоновый цикл не
+
-        // разбирают очередь тенанта одновременно. Гейт занят (фоновый цикл уже pump'ит) — проход пропускаем,
+        try
-        // как прототип при занятом локе (L901–902): pipeline={}, очередь дождётся следующего срабатывания.
+        {
-        if (!pumpGate.TryEnter(tenantId))
+            return await worker.PumpOnceAsync(ct);
-        {
+        }
-            return null;
+        catch (OperationCanceledException)
-        }
+        {
-
+            // Запрос отменён — прерываем тик штатно (не «сбой pump»).
-        try
+            throw;
-        {
+        }
-            return await worker.PumpOnceAsync(ct);
+        catch (Exception exception)
-        }
+        {
-        catch (OperationCanceledException)
+            logger.LogWarning(exception, "POST /api/admin/tick: проход pump не удался — тик возвращает storage без pipeline");
-        {
+            return null;
-            // Запрос отменён — прерываем тик штатно (не «сбой pump»).
+        }
-            throw;
+        finally
-        }
+        {
-        catch (Exception exception)
+            pumpGate.Exit(tenantId);
-        {
+        }
-            logger.LogWarning(exception, "POST /api/admin/tick: проход pump не удался — тик возвращает storage без pipeline");
+    }
-            return null;
+
-        }
+    // Счётчики результата pump → pipeline-словарь ответа (9 ключей словаря python L921; карточки в
-        finally
+    // wire не выходят — они ушли отдельными SSE new_card).
-        {
+    // pump: Результат успешного прохода pump.
-            pumpGate.Exit(tenantId);
+    // Возвращает: Словарь счётчиков в wire-порядке прототипа.
-        }
+    private static IReadOnlyDictionary<string, int> ToPipelineWireDict(PipelinePumpResult pump)
-    }
+    {
-
+        int[] counters =
-    // Счётчики результата pump → pipeline-словарь ответа (9 ключей словаря python L921; карточки в
+        [
-    // wire не выходят — они ушли отдельными SSE new_card).
+            pump.Staged, pump.RulesStored, pump.MlStored, pump.MlDrop, pump.TypeDrop,
-    // pump: Результат успешного прохода pump.
+            pump.AiStored, pump.AiDrop, pump.AiFail, pump.NoBudget,
-    // Возвращает: Словарь счётчиков в wire-порядке прототипа.
+        ];
-    private static IReadOnlyDictionary<string, int> ToPipelineWireDict(PipelinePumpResult pump)
+
-    {
+        var wire = new Dictionary<string, int>(PipelineCounterKeys.Length, StringComparer.Ordinal);
-        int[] counters =
+        for (int index = 0; index < PipelineCounterKeys.Length; index++)
-        [
+        {
-            pump.Staged, pump.RulesStored, pump.MlStored, pump.MlDrop, pump.TypeDrop,
+            wire[PipelineCounterKeys[index]] = counters[index];
-            pump.AiStored, pump.AiDrop, pump.AiFail, pump.NoBudget,
+        }
-        ];
+
-
+        return wire;
-        var wire = new Dictionary<string, int>(PipelineCounterKeys.Length, StringComparer.Ordinal);
+    }
-        for (int index = 0; index < PipelineCounterKeys.Length; index++)
+}
-        {
-            wire[PipelineCounterKeys[index]] = counters[index];
-        }
-
-        return wire;
-    }
-}