Разбить модули Deal.Modules.* по назначению

Application проектов Discovery, Kanban, Pipeline, Settings, Tenants
разделён на Abstractions/Exceptions/Extensions/Models/Registrars/Services;
namespace приведён к путям, using потребителей мигрированы и
дедуплицированы (169 файлов), cref/FQN обновлены.
This commit is contained in:
Rustam Khalimov
2026-09-11 13:18:14 +03:00
parent 31c434ed93
commit cd0b3b606b
356 changed files with 14436 additions and 12906 deletions
+7 -2
View File
@@ -1,8 +1,13 @@
using Deal.Api.Events;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
namespace Deal.Api;
@@ -1,4 +1,8 @@
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Configuration;
@@ -1,4 +1,8 @@
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Configuration;
@@ -1,7 +1,9 @@
using System.Text.Json;
using Deal.Api.Http;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Api.Endpoints;
+4 -1
View File
@@ -1,7 +1,10 @@
using Deal.Api.Http;
using Deal.Api.Middleware;
using Deal.Modules.Tenants.Application;
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 Microsoft.Extensions.Options;
// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
using CookieOptions = Deal.Api.Configuration.CookieOptions;
@@ -3,9 +3,16 @@ using Deal.Api.Endpoints.RequestModels;
using Deal.Api.Http;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
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;
namespace Deal.Api.Endpoints;
+12 -3
View File
@@ -4,11 +4,20 @@ using Deal.Api.Http;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
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;
namespace Deal.Api.Endpoints;
@@ -1,9 +1,16 @@
using System.Text.Json;
using Deal.Api.Endpoints.RequestModels;
using Deal.Api.Http;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
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;
namespace Deal.Api.Endpoints;
@@ -3,10 +3,16 @@ using Deal.Api.Endpoints.RequestModels;
using Deal.Api.Http;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Settings.Application;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
using Deal.Modules.Telegram.Application;
namespace Deal.Api.Endpoints;
@@ -1,6 +1,8 @@
using Deal.Api.Http;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Api.Endpoints;
+4 -1
View File
@@ -1,6 +1,9 @@
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Endpoints;
+3 -1
View File
@@ -1,8 +1,10 @@
using Deal.Api.Http;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
namespace Deal.Api.Endpoints;
@@ -1,168 +1,171 @@
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
namespace Deal.Api.Endpoints;
/// <summary>
/// Операторские read-only эндпоинты аналитики: /api/operator/analytics/{overview,tokens,activity} (этап 10, T3).
/// </summary>
/// <remarks>
/// Только под операторской сессией: без неё 401 «Требуется вход оператора» (как прочие /api/operator/*).
/// Ничего не меняет (read-only). groupBy — day|tenant|provider|model (неизвестное — 400 {detail}); from/to —
/// ISO-8601 (включительно), как у аудита; activity поддерживает фильтры eventType/actorType/actorId/tenantId,
/// limit (1..500) и offset. Все ответы — camelCase (контракт: docs/architecture/2026-09-10-operator-analytics-contract.md).
/// </remarks>
public static class OperatorAnalyticsEndpoints
{
// Префикс группы аналитики (Ruling 4 этапа 10).
private const string AnalyticsGroupPrefix = "/api/operator/analytics";
// OpenAPI-тег группы.
private const string OperatorOpenApiTag = "operator";
// Группировка расхода токенов по умолчанию (сутки).
private const string DefaultGroupBy = TokenUsageGroupBys.Day;
// 400 tokens: неизвестная группировка.
private const string InvalidGroupByDetail = "Неизвестная группировка (day|tenant|provider|model)";
/// <summary>
/// Регистрирует группу /api/operator/analytics: overview/tokens/activity.
/// </summary>
/// <param name="app">Построитель маршрутов приложения.</param>
/// <returns>Построитель маршрутов для цепочки вызовов.</returns>
public static IEndpointRouteBuilder MapOperatorAnalyticsEndpoints(this IEndpointRouteBuilder app)
{
var group = app.MapGroup(AnalyticsGroupPrefix).WithTags(OperatorOpenApiTag);
group.MapGet("/overview", OverviewAsync);
group.MapGet("/tokens", TokensAsync);
group.MapGet("/activity", ActivityAsync);
group.MapGet("/suspicious", SuspiciousAsync);
return app;
}
// GET /api/operator/analytics/suspicious?from=&amp;to=: находки детектора подозрительной активности (§10.5).
// from: Начало окна анализа (включительно; ISO-8601); null — последние 24 часа.
// to: Конец окна анализа (включительно; ISO-8601); null — «сейчас».
// context: Контекст запроса.
// suspiciousService: Детектор подозрительной активности (scoped).
// ct: Токен отмены.
// Возвращает: 200 сводка находок или 401 без операторской сессии.
private static async Task<IResult> SuspiciousAsync(
DateTimeOffset? from,
DateTimeOffset? to,
HttpContext context,
SuspiciousActivityService suspiciousService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
SuspiciousActivityDto report = await suspiciousService.AnalyzeAsync(from, to, ct);
return Results.Ok(report);
}
// GET /api/operator/analytics/overview?from=&amp;to=: сводка (тенанты, токены, события, входы/выходы).
// from: Начало периода (включительно; ISO-8601).
// to: Конец периода (включительно; ISO-8601).
// context: Контекст запроса.
// analyticsService: Сервис аналитики (scoped).
// ct: Токен отмены.
// Возвращает: 200 сводка или 401 без операторской сессии.
private static async Task<IResult> OverviewAsync(
DateTimeOffset? from,
DateTimeOffset? to,
HttpContext context,
AnalyticsService analyticsService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
AnalyticsOverviewDto overview = await analyticsService.OverviewAsync(from, to, ct);
return Results.Ok(overview);
}
// GET /api/operator/analytics/tokens?groupBy=&amp;tenantId=&amp;from=&amp;to=: агрегаты расхода токенов.
// groupBy: Группировка day|tenant|provider|model (дефолт day).
// tenantId: Тенант (равенство; пусто — все тенанты).
// from: Начало периода (включительно; ISO-8601).
// to: Конец периода (включительно; ISO-8601).
// context: Контекст запроса.
// analyticsService: Сервис аналитики (scoped).
// ct: Токен отмены.
// Возвращает: 200 агрегаты, 400 неизвестная группировка или 401 без операторской сессии.
private static async Task<IResult> TokensAsync(
string? groupBy,
Guid? tenantId,
DateTimeOffset? from,
DateTimeOffset? to,
HttpContext context,
AnalyticsService analyticsService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
string normalizedGroupBy = string.IsNullOrWhiteSpace(groupBy) ? DefaultGroupBy : groupBy;
if (!IsKnownGroupBy(normalizedGroupBy))
{
return EndpointResults.BadRequest(InvalidGroupByDetail);
}
AnalyticsTokensDto tokens = await analyticsService.TokensAsync(normalizedGroupBy, tenantId, from, to, ct);
return Results.Ok(tokens);
}
// GET /api/operator/analytics/activity?eventType=&amp;actorType=&amp;actorId=&amp;tenantId=&amp;from=&amp;to=&amp;limit=&amp;offset=: лента действий.
// eventType: Тип события (равенство; пусто — без фильтра).
// actorType: Тип актора operator|tenant|system (равенство).
// actorId: Идентификатор актора (равенство).
// tenantId: Тенант (равенство).
// from: Нижняя граница At (включительно; ISO-8601).
// to: Верхняя граница At (включительно; ISO-8601).
// limit: Размер страницы (дефолт 100, кламп 1..500).
// offset: Смещение страницы (≥0).
// context: Контекст запроса.
// analyticsService: Сервис аналитики (scoped).
// ct: Токен отмены.
// Возвращает: 200 {items, total, limit, offset} или 401 без операторской сессии.
private static async Task<IResult> ActivityAsync(
string? eventType,
string? actorType,
Guid? actorId,
Guid? tenantId,
DateTimeOffset? from,
DateTimeOffset? to,
int? limit,
int? offset,
HttpContext context,
AnalyticsService analyticsService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
AnalyticsActivityDto activity = await analyticsService.ActivityAsync(
eventType, actorType, actorId, tenantId, from, to, limit, offset, ct);
return Results.Ok(activity);
}
/// <summary>
/// Известна ли группировка расхода токенов (day|tenant|provider|model).
/// </summary>
/// <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;
}
using Deal.Api.Http;
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;
namespace Deal.Api.Endpoints;
/// <summary>
/// Операторские read-only эндпоинты аналитики: /api/operator/analytics/{overview,tokens,activity} (этап 10, T3).
/// </summary>
/// <remarks>
/// Только под операторской сессией: без неё 401 «Требуется вход оператора» (как прочие /api/operator/*).
/// Ничего не меняет (read-only). groupBy — day|tenant|provider|model (неизвестное — 400 {detail}); from/to —
/// ISO-8601 (включительно), как у аудита; activity поддерживает фильтры eventType/actorType/actorId/tenantId,
/// limit (1..500) и offset. Все ответы — camelCase (контракт: docs/architecture/2026-09-10-operator-analytics-contract.md).
/// </remarks>
public static class OperatorAnalyticsEndpoints
{
// Префикс группы аналитики (Ruling 4 этапа 10).
private const string AnalyticsGroupPrefix = "/api/operator/analytics";
// OpenAPI-тег группы.
private const string OperatorOpenApiTag = "operator";
// Группировка расхода токенов по умолчанию (сутки).
private const string DefaultGroupBy = TokenUsageGroupBys.Day;
// 400 tokens: неизвестная группировка.
private const string InvalidGroupByDetail = "Неизвестная группировка (day|tenant|provider|model)";
/// <summary>
/// Регистрирует группу /api/operator/analytics: overview/tokens/activity.
/// </summary>
/// <param name="app">Построитель маршрутов приложения.</param>
/// <returns>Построитель маршрутов для цепочки вызовов.</returns>
public static IEndpointRouteBuilder MapOperatorAnalyticsEndpoints(this IEndpointRouteBuilder app)
{
var group = app.MapGroup(AnalyticsGroupPrefix).WithTags(OperatorOpenApiTag);
group.MapGet("/overview", OverviewAsync);
group.MapGet("/tokens", TokensAsync);
group.MapGet("/activity", ActivityAsync);
group.MapGet("/suspicious", SuspiciousAsync);
return app;
}
// GET /api/operator/analytics/suspicious?from=&amp;to=: находки детектора подозрительной активности (§10.5).
// from: Начало окна анализа (включительно; ISO-8601); null — последние 24 часа.
// to: Конец окна анализа (включительно; ISO-8601); null — «сейчас».
// context: Контекст запроса.
// suspiciousService: Детектор подозрительной активности (scoped).
// ct: Токен отмены.
// Возвращает: 200 сводка находок или 401 без операторской сессии.
private static async Task<IResult> SuspiciousAsync(
DateTimeOffset? from,
DateTimeOffset? to,
HttpContext context,
SuspiciousActivityService suspiciousService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
SuspiciousActivityDto report = await suspiciousService.AnalyzeAsync(from, to, ct);
return Results.Ok(report);
}
// GET /api/operator/analytics/overview?from=&amp;to=: сводка (тенанты, токены, события, входы/выходы).
// from: Начало периода (включительно; ISO-8601).
// to: Конец периода (включительно; ISO-8601).
// context: Контекст запроса.
// analyticsService: Сервис аналитики (scoped).
// ct: Токен отмены.
// Возвращает: 200 сводка или 401 без операторской сессии.
private static async Task<IResult> OverviewAsync(
DateTimeOffset? from,
DateTimeOffset? to,
HttpContext context,
AnalyticsService analyticsService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
AnalyticsOverviewDto overview = await analyticsService.OverviewAsync(from, to, ct);
return Results.Ok(overview);
}
// GET /api/operator/analytics/tokens?groupBy=&amp;tenantId=&amp;from=&amp;to=: агрегаты расхода токенов.
// groupBy: Группировка day|tenant|provider|model (дефолт day).
// tenantId: Тенант (равенство; пусто — все тенанты).
// from: Начало периода (включительно; ISO-8601).
// to: Конец периода (включительно; ISO-8601).
// context: Контекст запроса.
// analyticsService: Сервис аналитики (scoped).
// ct: Токен отмены.
// Возвращает: 200 агрегаты, 400 неизвестная группировка или 401 без операторской сессии.
private static async Task<IResult> TokensAsync(
string? groupBy,
Guid? tenantId,
DateTimeOffset? from,
DateTimeOffset? to,
HttpContext context,
AnalyticsService analyticsService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
string normalizedGroupBy = string.IsNullOrWhiteSpace(groupBy) ? DefaultGroupBy : groupBy;
if (!IsKnownGroupBy(normalizedGroupBy))
{
return EndpointResults.BadRequest(InvalidGroupByDetail);
}
AnalyticsTokensDto tokens = await analyticsService.TokensAsync(normalizedGroupBy, tenantId, from, to, ct);
return Results.Ok(tokens);
}
// GET /api/operator/analytics/activity?eventType=&amp;actorType=&amp;actorId=&amp;tenantId=&amp;from=&amp;to=&amp;limit=&amp;offset=: лента действий.
// eventType: Тип события (равенство; пусто — без фильтра).
// actorType: Тип актора operator|tenant|system (равенство).
// actorId: Идентификатор актора (равенство).
// tenantId: Тенант (равенство).
// from: Нижняя граница At (включительно; ISO-8601).
// to: Верхняя граница At (включительно; ISO-8601).
// limit: Размер страницы (дефолт 100, кламп 1..500).
// offset: Смещение страницы (≥0).
// context: Контекст запроса.
// analyticsService: Сервис аналитики (scoped).
// ct: Токен отмены.
// Возвращает: 200 {items, total, limit, offset} или 401 без операторской сессии.
private static async Task<IResult> ActivityAsync(
string? eventType,
string? actorType,
Guid? actorId,
Guid? tenantId,
DateTimeOffset? from,
DateTimeOffset? to,
int? limit,
int? offset,
HttpContext context,
AnalyticsService analyticsService,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
AnalyticsActivityDto activity = await analyticsService.ActivityAsync(
eventType, actorType, actorId, tenantId, from, to, limit, offset, ct);
return Results.Ok(activity);
}
/// <summary>
/// Известна ли группировка расхода токенов (day|tenant|provider|model).
/// </summary>
/// <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;
}
@@ -1,6 +1,9 @@
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Endpoints;
@@ -1,171 +1,174 @@
using Deal.Api.Http;
using Deal.Api.Middleware;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
using Microsoft.Extensions.Options;
using AspNetCoreCookieOptions = Microsoft.AspNetCore.Http.CookieOptions;
// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасами.
using OperatorCookieOptions = Deal.Api.Configuration.OperatorCookieOptions;
namespace Deal.Api.Endpoints;
/// <summary>
/// HTTP-эндпоинты аутентификации оператора (группа /api/operator/auth). Зеркало AuthEndpoints для операторов (Ruling 1).
/// </summary>
/// <remarks>
/// Оператор ≠ пользователь тенанта: вход по отдельным public-таблицам (OperatorAuthService/IOperatorAuthStore),
/// сессия — в куке deal_operator_session (отдельная от deal_session; 12 ч, httpOnly, SameSite=Lax).
/// Успех-ответы — <c>{ok:true,...}</c>, ошибки — HTTP-код + <c>{"detail":"..."}</c> (Ruling 10). Защищённые
/// ручки (me) требуют операторскую сессию (401 «Требуется вход оператора») — тенантная кука не проходит.
/// Результаты входа пишутся в аудит (operator_login_ok/failed, Task 4/Ruling 4).
/// </remarks>
public static class OperatorAuthEndpoints
{
private const string InvalidCredentialsDetail = "Неверный логин или пароль оператора";
private const string OperatorAuthGroupPrefix = "/api/operator/auth";
private const string OperatorAuthOpenApiTag = "operator-auth";
/// <summary>
/// Регистрирует группу /api/operator/auth: login, logout, me.
/// </summary>
/// <param name="app">Построитель маршрутов приложения.</param>
/// <returns>Построитель маршрутов для цепочки вызовов.</returns>
public static IEndpointRouteBuilder MapOperatorAuthEndpoints(this IEndpointRouteBuilder app)
{
var group = app.MapGroup(OperatorAuthGroupPrefix).WithTags(OperatorAuthOpenApiTag);
// Политика "auth" rate limiter (план Task 11, Ruling 5): фиксированное окно 10/мин на IP ручки
// входа оператора; остальные ручки группы — под глобальной API-политикой (по тенанту/IP).
group.MapPost("/login", LoginAsync).RequireRateLimiting(RateLimitPolicies.AuthPolicy);
group.MapPost("/logout", LogoutAsync);
group.MapGet("/me", MeAsync);
return app;
}
// POST /api/operator/auth/login: проверка учётных данных оператора, выдача куки сессии; результат пишется в аудит (Task 4).
// До OperatorAuthService отрабатывает LoginAttemptGuard (5 неудач ip|login за 15 мин → 429, Ruling 5).
private static async Task<IResult> LoginAsync(
LoginRequest body,
OperatorAuthService operatorAuthService,
AuditService auditService,
IOptions<OperatorCookieOptions> cookieOptions,
HttpContext context,
CancellationToken ct,
LoginAttemptGuard loginAttemptGuard)
{
string? attemptedLogin = NormalizeLogin(body.Login);
// Защита входа оператора (план Task 11, Ruling 5): зеркало AuthEndpoints — блокировка ключа
// ip|login до проверки учётных данных (в dev при RateLimit:Enabled=false гвард выключен).
if (await loginAttemptGuard.IsBlockedAsync(ClientIp(context), attemptedLogin, ct))
{
return EndpointResults.TooManyRequests(LoginAttemptGuard.BlockedDetail);
}
var result = await operatorAuthService.LoginAsync(body.Login, body.Password, ct);
if (result.Login is null || result.Token is null)
{
// Неверные учётные данные оператора — одно сообщение (зеркало AuthEndpoints).
// Аудит operator_login_failed — только для реальной попытки (непустой логин), без пароля (Ruling 4);
// счётчик неудач гварда растёт там же (пустые логины ключа не имеют).
if (attemptedLogin is not null)
{
await loginAttemptGuard.RecordFailureAsync(ClientIp(context), attemptedLogin, ct);
await auditService.AppendAsync(new AuditRecordDto(
AuditEvents.OperatorLoginFailed,
AuditActorTypes.Operator,
ActorId: null,
TenantId: null,
Ip: ClientIp(context),
DetailJson: AuditService.ToDetailJson(new { login = attemptedLogin })), ct);
}
return EndpointResults.Unauthorized(InvalidCredentialsDetail);
}
// Успешный вход оператора сбрасывает счётчик неудач ключа ip|login (Ruling 5).
await loginAttemptGuard.ResetAsync(ClientIp(context), result.Login, ct);
await auditService.AppendAsync(new AuditRecordDto(
AuditEvents.OperatorLoginOk,
AuditActorTypes.Operator,
ActorId: result.OperatorId,
TenantId: null,
Ip: ClientIp(context),
DetailJson: AuditService.ToDetailJson(new { login = result.Login })), ct);
SetOperatorSessionCookie(context, cookieOptions.Value, result.Token);
return Results.Ok(new { ok = true, login = result.Login });
}
// POST /api/operator/auth/logout: удаление операторской сессии по токену из куки и очистка куки (всегда ok).
private static async Task<IResult> LogoutAsync(
OperatorAuthService operatorAuthService,
IOptions<OperatorCookieOptions> cookieOptions,
HttpContext context,
CancellationToken ct)
{
var cookieName = cookieOptions.Value.Name;
var rawToken = context.Request.Cookies[cookieName];
// Оператор разрешённой сессии — до её удаления (OperatorSessionMiddleware наполнил Items).
CurrentOperator? operatorIdentity = context.GetCurrentOperator();
await operatorAuthService.LogoutAsync(rawToken, ct);
context.Response.Cookies.Delete(cookieName);
// Выход оператора (этап 10, T1): событие пишется при живой разрешённой сессии.
if (operatorIdentity is not null)
{
await AuditAppender.AppendOperatorAsync(context, AuditEvents.OperatorLogout, new { login = operatorIdentity.Login }, ct);
}
return Results.Ok(new { ok = true });
}
// GET /api/operator/auth/me: проверка живой операторской сессии (401 без неё, Ruling 1).
private static IResult MeAsync(HttpContext context)
{
var operatorIdentity = context.GetCurrentOperator();
if (operatorIdentity is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
return Results.Ok(new { login = operatorIdentity.Login, ok = true });
}
// Выставляет httpOnly-куку сессии оператора: SameSite=Lax, Path=/, MaxAge=Hours, Secure — из конфига.
// context: Контекст запроса.
// options: Настройки куки из конфигурации (секция OperatorCookies).
// rawToken: Raw-токен операторской сессии.
private static void SetOperatorSessionCookie(HttpContext context, OperatorCookieOptions options, string rawToken)
{
// MaxAge — OperatorCookies:Hours; код-дефолт значения ссылается на
// OperatorAuthService.SessionLifetimeHours (единый источник «12 часов», см. OperatorCookieOptions).
context.Response.Cookies.Append(
options.Name,
rawToken,
new AspNetCoreCookieOptions
{
HttpOnly = true,
SameSite = SameSiteMode.Lax,
Path = "/",
MaxAge = TimeSpan.FromHours(options.Hours),
Secure = options.Secure,
});
}
// Нормализованная попытка логина для аудита (нижний регистр/обрезка); null — писать нечего.
// login: Логин из тела запроса.
// Возвращает: Нормализованный логин или null при пустом/пробельном входе.
private static string? NormalizeLogin(string? login)
{
string? normalized = login?.Trim().ToLowerInvariant();
return string.IsNullOrEmpty(normalized) ? null : normalized;
}
// IP-адрес клиента для аудита (без порта; null, если недоступен).
// context: Контекст запроса.
// Возвращает: Строковое представление IP или null.
private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
}
using Deal.Api.Http;
using Deal.Api.Middleware;
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 Microsoft.Extensions.Options;
using AspNetCoreCookieOptions = Microsoft.AspNetCore.Http.CookieOptions;
// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасами.
using OperatorCookieOptions = Deal.Api.Configuration.OperatorCookieOptions;
namespace Deal.Api.Endpoints;
/// <summary>
/// HTTP-эндпоинты аутентификации оператора (группа /api/operator/auth). Зеркало AuthEndpoints для операторов (Ruling 1).
/// </summary>
/// <remarks>
/// Оператор ≠ пользователь тенанта: вход по отдельным public-таблицам (OperatorAuthService/IOperatorAuthStore),
/// сессия — в куке deal_operator_session (отдельная от deal_session; 12 ч, httpOnly, SameSite=Lax).
/// Успех-ответы — <c>{ok:true,...}</c>, ошибки — HTTP-код + <c>{"detail":"..."}</c> (Ruling 10). Защищённые
/// ручки (me) требуют операторскую сессию (401 «Требуется вход оператора») — тенантная кука не проходит.
/// Результаты входа пишутся в аудит (operator_login_ok/failed, Task 4/Ruling 4).
/// </remarks>
public static class OperatorAuthEndpoints
{
private const string InvalidCredentialsDetail = "Неверный логин или пароль оператора";
private const string OperatorAuthGroupPrefix = "/api/operator/auth";
private const string OperatorAuthOpenApiTag = "operator-auth";
/// <summary>
/// Регистрирует группу /api/operator/auth: login, logout, me.
/// </summary>
/// <param name="app">Построитель маршрутов приложения.</param>
/// <returns>Построитель маршрутов для цепочки вызовов.</returns>
public static IEndpointRouteBuilder MapOperatorAuthEndpoints(this IEndpointRouteBuilder app)
{
var group = app.MapGroup(OperatorAuthGroupPrefix).WithTags(OperatorAuthOpenApiTag);
// Политика "auth" rate limiter (план Task 11, Ruling 5): фиксированное окно 10/мин на IP ручки
// входа оператора; остальные ручки группы — под глобальной API-политикой (по тенанту/IP).
group.MapPost("/login", LoginAsync).RequireRateLimiting(RateLimitPolicies.AuthPolicy);
group.MapPost("/logout", LogoutAsync);
group.MapGet("/me", MeAsync);
return app;
}
// POST /api/operator/auth/login: проверка учётных данных оператора, выдача куки сессии; результат пишется в аудит (Task 4).
// До OperatorAuthService отрабатывает LoginAttemptGuard (5 неудач ip|login за 15 мин → 429, Ruling 5).
private static async Task<IResult> LoginAsync(
LoginRequest body,
OperatorAuthService operatorAuthService,
AuditService auditService,
IOptions<OperatorCookieOptions> cookieOptions,
HttpContext context,
CancellationToken ct,
LoginAttemptGuard loginAttemptGuard)
{
string? attemptedLogin = NormalizeLogin(body.Login);
// Защита входа оператора (план Task 11, Ruling 5): зеркало AuthEndpoints — блокировка ключа
// ip|login до проверки учётных данных (в dev при RateLimit:Enabled=false гвард выключен).
if (await loginAttemptGuard.IsBlockedAsync(ClientIp(context), attemptedLogin, ct))
{
return EndpointResults.TooManyRequests(LoginAttemptGuard.BlockedDetail);
}
var result = await operatorAuthService.LoginAsync(body.Login, body.Password, ct);
if (result.Login is null || result.Token is null)
{
// Неверные учётные данные оператора — одно сообщение (зеркало AuthEndpoints).
// Аудит operator_login_failed — только для реальной попытки (непустой логин), без пароля (Ruling 4);
// счётчик неудач гварда растёт там же (пустые логины ключа не имеют).
if (attemptedLogin is not null)
{
await loginAttemptGuard.RecordFailureAsync(ClientIp(context), attemptedLogin, ct);
await auditService.AppendAsync(new AuditRecordDto(
AuditEvents.OperatorLoginFailed,
AuditActorTypes.Operator,
ActorId: null,
TenantId: null,
Ip: ClientIp(context),
DetailJson: AuditService.ToDetailJson(new { login = attemptedLogin })), ct);
}
return EndpointResults.Unauthorized(InvalidCredentialsDetail);
}
// Успешный вход оператора сбрасывает счётчик неудач ключа ip|login (Ruling 5).
await loginAttemptGuard.ResetAsync(ClientIp(context), result.Login, ct);
await auditService.AppendAsync(new AuditRecordDto(
AuditEvents.OperatorLoginOk,
AuditActorTypes.Operator,
ActorId: result.OperatorId,
TenantId: null,
Ip: ClientIp(context),
DetailJson: AuditService.ToDetailJson(new { login = result.Login })), ct);
SetOperatorSessionCookie(context, cookieOptions.Value, result.Token);
return Results.Ok(new { ok = true, login = result.Login });
}
// POST /api/operator/auth/logout: удаление операторской сессии по токену из куки и очистка куки (всегда ok).
private static async Task<IResult> LogoutAsync(
OperatorAuthService operatorAuthService,
IOptions<OperatorCookieOptions> cookieOptions,
HttpContext context,
CancellationToken ct)
{
var cookieName = cookieOptions.Value.Name;
var rawToken = context.Request.Cookies[cookieName];
// Оператор разрешённой сессии — до её удаления (OperatorSessionMiddleware наполнил Items).
CurrentOperator? operatorIdentity = context.GetCurrentOperator();
await operatorAuthService.LogoutAsync(rawToken, ct);
context.Response.Cookies.Delete(cookieName);
// Выход оператора (этап 10, T1): событие пишется при живой разрешённой сессии.
if (operatorIdentity is not null)
{
await AuditAppender.AppendOperatorAsync(context, AuditEvents.OperatorLogout, new { login = operatorIdentity.Login }, ct);
}
return Results.Ok(new { ok = true });
}
// GET /api/operator/auth/me: проверка живой операторской сессии (401 без неё, Ruling 1).
private static IResult MeAsync(HttpContext context)
{
var operatorIdentity = context.GetCurrentOperator();
if (operatorIdentity is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
return Results.Ok(new { login = operatorIdentity.Login, ok = true });
}
// Выставляет httpOnly-куку сессии оператора: SameSite=Lax, Path=/, MaxAge=Hours, Secure — из конфига.
// context: Контекст запроса.
// options: Настройки куки из конфигурации (секция OperatorCookies).
// rawToken: Raw-токен операторской сессии.
private static void SetOperatorSessionCookie(HttpContext context, OperatorCookieOptions options, string rawToken)
{
// MaxAge — OperatorCookies:Hours; код-дефолт значения ссылается на
// OperatorAuthService.SessionLifetimeHours (единый источник «12 часов», см. OperatorCookieOptions).
context.Response.Cookies.Append(
options.Name,
rawToken,
new AspNetCoreCookieOptions
{
HttpOnly = true,
SameSite = SameSiteMode.Lax,
Path = "/",
MaxAge = TimeSpan.FromHours(options.Hours),
Secure = options.Secure,
});
}
// Нормализованная попытка логина для аудита (нижний регистр/обрезка); null — писать нечего.
// login: Логин из тела запроса.
// Возвращает: Нормализованный логин или null при пустом/пробельном входе.
private static string? NormalizeLogin(string? login)
{
string? normalized = login?.Trim().ToLowerInvariant();
return string.IsNullOrEmpty(normalized) ? null : normalized;
}
// IP-адрес клиента для аудита (без порта; null, если недоступен).
// context: Контекст запроса.
// Возвращает: Строковое представление IP или null.
private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
}
@@ -1,6 +1,9 @@
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Endpoints;
@@ -1,6 +1,9 @@
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Endpoints;
@@ -1,154 +1,157 @@
using Deal.Api.Endpoints.RequestModels;
using Deal.Api.Http;
using Deal.Api.Telegram;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
namespace Deal.Api.Endpoints;
/// <summary>
/// Операторские ручки глобальных (системных) настроек: ключи приложения Telegram
/// (ТЗ §4.1/§8.1).
/// </summary>
/// <remarks>
/// Все ручки — только под операторской сессией: без неё 401 «Требуется вход оператора». Ключи Telegram
/// задаёт оператор глобально (едины для всех тенантов), тенант их не видит и не задаёт.
/// <list type="bullet">
/// <item>GET /api/operator/settings/telegram-keys — маскированный снимок: apiId (не секрет, открыт),
/// apiHash (маска) и keysSet;</item>
/// <item>PUT /api/operator/settings/telegram-keys {apiId?, apiHash?} — частичное сохранение (можно
/// передать только одно поле, второе сохраняется); валидация (api_id 5..9 цифр, api_hash непустой),
/// шифрование секрета и аудит telegram_keys_changed (без секретов в деталях).</item>
/// </list>
/// Ошибки — 400/401 <c>{detail}</c> (формат прототипа, Ruling 10).
/// </remarks>
public static class OperatorSettingsEndpoints
{
// Префикс группы операторских настроек.
private const string SettingsGroupPrefix = "/api/operator/settings";
// OpenAPI-тег группы.
private const string SettingsOpenApiTag = "operator-settings";
// Относительный путь глобальных ключей Telegram (GET/PUT).
private const string TelegramKeysPath = "/telegram-keys";
// Текст 400: пустое тело PUT (ни одного поля).
private const string EmptyBodyDetail = "Укажите api_id и api_hash";
// Текст 400: частичное обновление, но ключей ещё нет — нужны оба поля.
private const string MissingKeysDetail = "Ключи ещё не заданы — укажите и api_id, и api_hash";
// Текст 400: api_id не 5..9 цифр.
private const string InvalidApiIdDetail = "api_id должен состоять из 5–9 цифр";
// Текст 400: api_hash пустой/маска/с префиксом enc:.
private const string InvalidApiHashDetail = "Укажите непустой api_hash";
/// <summary>
/// Регистрирует группу /api/operator/settings: telegram-keys (GET/PUT).
/// </summary>
/// <param name="app">Построитель маршрутов приложения.</param>
/// <returns>Построитель маршрутов для цепочки вызовов.</returns>
public static IEndpointRouteBuilder MapOperatorSettingsEndpoints(this IEndpointRouteBuilder app)
{
var group = app.MapGroup(SettingsGroupPrefix).WithTags(SettingsOpenApiTag);
group.MapGet(TelegramKeysPath, GetTelegramKeysAsync);
group.MapPut(TelegramKeysPath, PutTelegramKeysAsync);
return app;
}
// GET /api/operator/settings/telegram-keys: маскированные глобальные ключи Telegram.
// context: Контекст запроса.
// keys: Сервис глобальных ключей Telegram (scoped).
// ct: Токен отмены.
// Возвращает: 200 маскированный снимок или 401 без операторской сессии.
private static async Task<IResult> GetTelegramKeysAsync(
HttpContext context,
TelegramKeysService keys,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
return Results.Ok(snapshot);
}
// PUT /api/operator/settings/telegram-keys: частичное сохранение глобальных ключей Telegram
// оператором.
// Поля можно передавать по отдельности: непереданное поле (null) сохраняет текущее значение,
// явное значение (в т.ч. пустая строка) валидируется. Если ключей ещё нет, оба поля обязательны.
// body: Тело {apiId?, apiHash?} (хотя бы одно поле).
// context: Контекст запроса.
// keys: Сервис глобальных ключей Telegram (scoped).
// auditService: Сервис аудита (событие telegram_keys_changed).
// ct: Токен отмены.
// Возвращает: 200 маскированный снимок, 400 при невалидных/недостающих полях или 401 без операторской сессии.
private static async Task<IResult> PutTelegramKeysAsync(
OperatorTelegramKeysRequest? body,
HttpContext context,
TelegramKeysService keys,
AuditService auditService,
CancellationToken ct)
{
var operatorIdentity = context.GetCurrentOperator();
if (operatorIdentity is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
if (body is null)
{
return EndpointResults.BadRequest(EmptyBodyDetail);
}
// null — поле не передано (сохраняем текущее); непустая строка/плейсхолдер — валидируем явно.
string? apiId = body.ApiId?.Trim();
string? apiHash = body.ApiHash?.Trim();
if (apiId is null && apiHash is null)
{
return EndpointResults.BadRequest(EmptyBodyDetail);
}
if (apiId is not null && !TelegramKeysService.IsValidApiId(apiId))
{
return EndpointResults.BadRequest(InvalidApiIdDetail);
}
if (apiHash is not null && !TelegramKeysService.IsValidApiHash(apiHash))
{
return EndpointResults.BadRequest(InvalidApiHashDetail);
}
// Частичное обновление: недостающее поле берём из текущих ключей; если ключей ещё нет — нужны оба.
TgKeysSnapshot current = await keys.GetAsync(ct);
string effectiveApiId = apiId ?? current.ApiId;
string effectiveApiHash = apiHash ?? current.ApiHash;
if (effectiveApiId.Length == 0 || effectiveApiHash.Length == 0)
{
return EndpointResults.BadRequest(MissingKeysDetail);
}
await keys.SaveAsync(effectiveApiId, effectiveApiHash, ct);
// Аудит смены глобальных ключей: apiId — не секрет, apiHash в детали не пишется (Ruling 4).
await auditService.AppendAsync(new AuditRecordDto(
AuditEvents.TelegramKeysChanged,
AuditActorTypes.Operator,
ActorId: operatorIdentity.OperatorId,
TenantId: null,
Ip: ClientIp(context),
DetailJson: AuditService.ToDetailJson(new { apiId = effectiveApiId, apiHashSet = true })), ct);
TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
return Results.Ok(snapshot);
}
// IP-адрес клиента для аудита (без порта; null, если недоступен).
// context: Контекст запроса.
// Возвращает: Строковое представление IP или null.
private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
}
using Deal.Api.Endpoints.RequestModels;
using Deal.Api.Http;
using Deal.Api.Telegram;
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;
namespace Deal.Api.Endpoints;
/// <summary>
/// Операторские ручки глобальных (системных) настроек: ключи приложения Telegram
/// (ТЗ §4.1/§8.1).
/// </summary>
/// <remarks>
/// Все ручки — только под операторской сессией: без неё 401 «Требуется вход оператора». Ключи Telegram
/// задаёт оператор глобально (едины для всех тенантов), тенант их не видит и не задаёт.
/// <list type="bullet">
/// <item>GET /api/operator/settings/telegram-keys — маскированный снимок: apiId (не секрет, открыт),
/// apiHash (маска) и keysSet;</item>
/// <item>PUT /api/operator/settings/telegram-keys {apiId?, apiHash?} — частичное сохранение (можно
/// передать только одно поле, второе сохраняется); валидация (api_id 5..9 цифр, api_hash непустой),
/// шифрование секрета и аудит telegram_keys_changed (без секретов в деталях).</item>
/// </list>
/// Ошибки — 400/401 <c>{detail}</c> (формат прототипа, Ruling 10).
/// </remarks>
public static class OperatorSettingsEndpoints
{
// Префикс группы операторских настроек.
private const string SettingsGroupPrefix = "/api/operator/settings";
// OpenAPI-тег группы.
private const string SettingsOpenApiTag = "operator-settings";
// Относительный путь глобальных ключей Telegram (GET/PUT).
private const string TelegramKeysPath = "/telegram-keys";
// Текст 400: пустое тело PUT (ни одного поля).
private const string EmptyBodyDetail = "Укажите api_id и api_hash";
// Текст 400: частичное обновление, но ключей ещё нет — нужны оба поля.
private const string MissingKeysDetail = "Ключи ещё не заданы — укажите и api_id, и api_hash";
// Текст 400: api_id не 5..9 цифр.
private const string InvalidApiIdDetail = "api_id должен состоять из 5–9 цифр";
// Текст 400: api_hash пустой/маска/с префиксом enc:.
private const string InvalidApiHashDetail = "Укажите непустой api_hash";
/// <summary>
/// Регистрирует группу /api/operator/settings: telegram-keys (GET/PUT).
/// </summary>
/// <param name="app">Построитель маршрутов приложения.</param>
/// <returns>Построитель маршрутов для цепочки вызовов.</returns>
public static IEndpointRouteBuilder MapOperatorSettingsEndpoints(this IEndpointRouteBuilder app)
{
var group = app.MapGroup(SettingsGroupPrefix).WithTags(SettingsOpenApiTag);
group.MapGet(TelegramKeysPath, GetTelegramKeysAsync);
group.MapPut(TelegramKeysPath, PutTelegramKeysAsync);
return app;
}
// GET /api/operator/settings/telegram-keys: маскированные глобальные ключи Telegram.
// context: Контекст запроса.
// keys: Сервис глобальных ключей Telegram (scoped).
// ct: Токен отмены.
// Возвращает: 200 маскированный снимок или 401 без операторской сессии.
private static async Task<IResult> GetTelegramKeysAsync(
HttpContext context,
TelegramKeysService keys,
CancellationToken ct)
{
if (context.GetCurrentOperator() is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
return Results.Ok(snapshot);
}
// PUT /api/operator/settings/telegram-keys: частичное сохранение глобальных ключей Telegram
// оператором.
// Поля можно передавать по отдельности: непереданное поле (null) сохраняет текущее значение,
// явное значение (в т.ч. пустая строка) валидируется. Если ключей ещё нет, оба поля обязательны.
// body: Тело {apiId?, apiHash?} (хотя бы одно поле).
// context: Контекст запроса.
// keys: Сервис глобальных ключей Telegram (scoped).
// auditService: Сервис аудита (событие telegram_keys_changed).
// ct: Токен отмены.
// Возвращает: 200 маскированный снимок, 400 при невалидных/недостающих полях или 401 без операторской сессии.
private static async Task<IResult> PutTelegramKeysAsync(
OperatorTelegramKeysRequest? body,
HttpContext context,
TelegramKeysService keys,
AuditService auditService,
CancellationToken ct)
{
var operatorIdentity = context.GetCurrentOperator();
if (operatorIdentity is null)
{
return EndpointResults.Unauthorized(AuthHelpers.OperatorUnauthorizedDetail);
}
if (body is null)
{
return EndpointResults.BadRequest(EmptyBodyDetail);
}
// null — поле не передано (сохраняем текущее); непустая строка/плейсхолдер — валидируем явно.
string? apiId = body.ApiId?.Trim();
string? apiHash = body.ApiHash?.Trim();
if (apiId is null && apiHash is null)
{
return EndpointResults.BadRequest(EmptyBodyDetail);
}
if (apiId is not null && !TelegramKeysService.IsValidApiId(apiId))
{
return EndpointResults.BadRequest(InvalidApiIdDetail);
}
if (apiHash is not null && !TelegramKeysService.IsValidApiHash(apiHash))
{
return EndpointResults.BadRequest(InvalidApiHashDetail);
}
// Частичное обновление: недостающее поле берём из текущих ключей; если ключей ещё нет — нужны оба.
TgKeysSnapshot current = await keys.GetAsync(ct);
string effectiveApiId = apiId ?? current.ApiId;
string effectiveApiHash = apiHash ?? current.ApiHash;
if (effectiveApiId.Length == 0 || effectiveApiHash.Length == 0)
{
return EndpointResults.BadRequest(MissingKeysDetail);
}
await keys.SaveAsync(effectiveApiId, effectiveApiHash, ct);
// Аудит смены глобальных ключей: apiId — не секрет, apiHash в детали не пишется (Ruling 4).
await auditService.AppendAsync(new AuditRecordDto(
AuditEvents.TelegramKeysChanged,
AuditActorTypes.Operator,
ActorId: operatorIdentity.OperatorId,
TenantId: null,
Ip: ClientIp(context),
DetailJson: AuditService.ToDetailJson(new { apiId = effectiveApiId, apiHashSet = true })), ct);
TelegramKeysMaskedDto snapshot = await keys.GetMaskedAsync(ct);
return Results.Ok(snapshot);
}
// IP-адрес клиента для аудита (без порта; null, если недоступен).
// context: Контекст запроса.
// Возвращает: Строковое представление IP или null.
private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
}
@@ -1,6 +1,9 @@
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
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 Microsoft.Extensions.Options;
using CookieOptions = Deal.Api.Configuration.CookieOptions;
@@ -1,7 +1,9 @@
using Deal.Api.Endpoints.RequestModels;
using Deal.Api.Http;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
namespace Deal.Api.Endpoints;
@@ -1,6 +1,8 @@
using Deal.Api.Http;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Api.Endpoints;
@@ -1,9 +1,15 @@
using System.Text.Json;
using Deal.Api;
using Deal.Api.Http;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
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;
namespace Deal.Api.Endpoints;
@@ -5,7 +5,11 @@ using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Telegram.Application;
using Deal.Modules.Telegram.Application.Models;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Endpoints;
@@ -1,6 +1,9 @@
using Deal.Api.Events;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Hosting;
@@ -1,5 +1,9 @@
using Deal.Api.Configuration;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Hosting;
@@ -1,6 +1,14 @@
using Deal.Modules.Discovery.Application;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
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.SharedKernel.Tenants;
namespace Deal.Api.Hosting;
@@ -1,8 +1,14 @@
using Deal.Infrastructure.Integrations;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
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.SharedKernel.Tenants;
namespace Deal.Api.Hosting;
@@ -1,4 +1,8 @@
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Hosting;
@@ -1,9 +1,18 @@
using Deal.Api.Events;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
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.SharedKernel.Tenants;
namespace Deal.Api.Hosting;
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Tenancy;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Hosting;
+86 -83
View File
@@ -1,83 +1,86 @@
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
using Microsoft.Extensions.DependencyInjection;
namespace Deal.Api.Http;
/// <summary>
/// Хелпер записи аудита действий пользователей тенанта и операторов (единая точка — <see cref="AuditService"/>).
/// </summary>
/// <remarks>
/// Актор берётся из разрешённой сессии (<c>HttpContext.Items</c>, наполняют SessionMiddleware/
/// OperatorSessionMiddleware): для тенанта — <see cref="AuditActorTypes.Tenant"/> с userId/tenantId, для
/// оператора — <see cref="AuditActorTypes.Operator"/> без tenantId. IP — адрес клиента без порта.
/// Детали — минимальные, без секретов (пароли/токены/api-ключи). Нет сессии — no-op (вызывать после
/// проверки HasUser, но безопасно и без неё). Append-only, как весь аудит.
/// </remarks>
public static class AuditAppender
{
/// <summary>
/// Пишет событие действия пользователя тенанта (актор tenant).
/// </summary>
/// <param name="context">Контекст запроса (источник актора и IP).</param>
/// <param name="eventType">Тип события — константа <see cref="AuditEvents"/>.</param>
/// <param name="details">Минимальные детали события (обычно анонимный объект) или null.</param>
/// <param name="ct">Токен отмены.</param>
public static async Task AppendTenantAsync(HttpContext context, string eventType, object? details, CancellationToken ct)
{
CurrentUser? user = context.GetCurrentUser();
if (user is null)
{
return;
}
AuditService audit = context.RequestServices.GetRequiredService<AuditService>();
await audit.AppendAsync(
new AuditRecordDto(
eventType,
AuditActorTypes.Tenant,
ActorId: user.UserId,
TenantId: user.TenantId,
Ip: ClientIp(context),
DetailJson: DetailJson(details)),
ct);
}
/// <summary>
/// Пишет событие действия оператора (актор operator, без tenantId).
/// </summary>
/// <param name="context">Контекст запроса (источник актора и IP).</param>
/// <param name="eventType">Тип события — константа <see cref="AuditEvents"/>.</param>
/// <param name="details">Минимальные детали события (обычно анонимный объект) или null.</param>
/// <param name="ct">Токен отмены.</param>
public static async Task AppendOperatorAsync(HttpContext context, string eventType, object? details, CancellationToken ct)
{
CurrentOperator? operatorIdentity = context.GetCurrentOperator();
if (operatorIdentity is null)
{
return;
}
AuditService audit = context.RequestServices.GetRequiredService<AuditService>();
await audit.AppendAsync(
new AuditRecordDto(
eventType,
AuditActorTypes.Operator,
ActorId: operatorIdentity.OperatorId,
TenantId: null,
Ip: ClientIp(context),
DetailJson: DetailJson(details)),
ct);
}
// Сериализует детали события (null — деталей нет).
// details: Объект деталей или null.
// Возвращает: JSON деталей (camelCase) или null.
private static string? DetailJson(object? details) =>
details is null ? null : AuditService.ToDetailJson(details);
// IP-адрес клиента для аудита (без порта; null, если недоступен).
// context: Контекст запроса.
// Возвращает: Строковое представление IP или null.
private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
}
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 Microsoft.Extensions.DependencyInjection;
namespace Deal.Api.Http;
/// <summary>
/// Хелпер записи аудита действий пользователей тенанта и операторов (единая точка — <see cref="AuditService"/>).
/// </summary>
/// <remarks>
/// Актор берётся из разрешённой сессии (<c>HttpContext.Items</c>, наполняют SessionMiddleware/
/// OperatorSessionMiddleware): для тенанта — <see cref="AuditActorTypes.Tenant"/> с userId/tenantId, для
/// оператора — <see cref="AuditActorTypes.Operator"/> без tenantId. IP — адрес клиента без порта.
/// Детали — минимальные, без секретов (пароли/токены/api-ключи). Нет сессии — no-op (вызывать после
/// проверки HasUser, но безопасно и без неё). Append-only, как весь аудит.
/// </remarks>
public static class AuditAppender
{
/// <summary>
/// Пишет событие действия пользователя тенанта (актор tenant).
/// </summary>
/// <param name="context">Контекст запроса (источник актора и IP).</param>
/// <param name="eventType">Тип события — константа <see cref="AuditEvents"/>.</param>
/// <param name="details">Минимальные детали события (обычно анонимный объект) или null.</param>
/// <param name="ct">Токен отмены.</param>
public static async Task AppendTenantAsync(HttpContext context, string eventType, object? details, CancellationToken ct)
{
CurrentUser? user = context.GetCurrentUser();
if (user is null)
{
return;
}
AuditService audit = context.RequestServices.GetRequiredService<AuditService>();
await audit.AppendAsync(
new AuditRecordDto(
eventType,
AuditActorTypes.Tenant,
ActorId: user.UserId,
TenantId: user.TenantId,
Ip: ClientIp(context),
DetailJson: DetailJson(details)),
ct);
}
/// <summary>
/// Пишет событие действия оператора (актор operator, без tenantId).
/// </summary>
/// <param name="context">Контекст запроса (источник актора и IP).</param>
/// <param name="eventType">Тип события — константа <see cref="AuditEvents"/>.</param>
/// <param name="details">Минимальные детали события (обычно анонимный объект) или null.</param>
/// <param name="ct">Токен отмены.</param>
public static async Task AppendOperatorAsync(HttpContext context, string eventType, object? details, CancellationToken ct)
{
CurrentOperator? operatorIdentity = context.GetCurrentOperator();
if (operatorIdentity is null)
{
return;
}
AuditService audit = context.RequestServices.GetRequiredService<AuditService>();
await audit.AppendAsync(
new AuditRecordDto(
eventType,
AuditActorTypes.Operator,
ActorId: operatorIdentity.OperatorId,
TenantId: null,
Ip: ClientIp(context),
DetailJson: DetailJson(details)),
ct);
}
// Сериализует детали события (null — деталей нет).
// details: Объект деталей или null.
// Возвращает: JSON деталей (camelCase) или null.
private static string? DetailJson(object? details) =>
details is null ? null : AuditService.ToDetailJson(details);
// IP-адрес клиента для аудита (без порта; null, если недоступен).
// context: Контекст запроса.
// Возвращает: Строковое представление IP или null.
private static string? ClientIp(HttpContext context) => context.Connection.RemoteIpAddress?.ToString();
}
+5 -1
View File
@@ -1,5 +1,9 @@
using Deal.Api.Configuration;
using Deal.Modules.Tenants.Application;
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;
namespace Deal.Api.Http;
@@ -1,5 +1,9 @@
using System.Threading.RateLimiting;
using Deal.Modules.Tenants.Application;
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 Microsoft.Extensions.DependencyInjection;
namespace Deal.Api.Http;
@@ -1,6 +1,10 @@
using Deal.Api.Configuration;
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
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 Microsoft.Extensions.Options;
// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
using OperatorCookieOptions = Deal.Api.Configuration.OperatorCookieOptions;
@@ -1,6 +1,10 @@
using Deal.Api.Configuration;
using Deal.Api.Http;
using Deal.Modules.Tenants.Application;
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.SharedKernel.Tenants;
using Microsoft.Extensions.Options;
// Имя конфигурационного типа совпадает с Microsoft.AspNetCore.Http.CookieOptions — фиксируем алиасом.
@@ -1,147 +1,156 @@
using Deal.Infrastructure.Persistence;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
using Deal.SharedKernel.Tenants;
using Microsoft.EntityFrameworkCore;
namespace Deal.Api.Observability;
/// <summary>
/// Сборщик глубин очередей и активных сессий (этап 12, §10.2): единый источник для метрик и health.
/// </summary>
/// <remarks>
/// <para>
/// Обходит реестр тенантов (на тенант — вложенный scope с <c>ITenantContext.SetTenant</c>) и считает через
/// существующие сервисы/порты, без дублирования SQL:
/// <list type="bullet">
/// <item>глубина очереди пайплайна — <see cref="PipelineProcessingService.QueueCountsAsync"/> (new+filtered);</item>
/// <item>глубина очереди обучения ML — <see cref="IMlLearningStore.CountOutboxAsync"/> (count(MlOutbox));</item>
/// <item>активные сессии — count(public.sessions) + count(public.operator_sessions) с непросроченным ExpiresAt.</item>
/// </list>
/// Переиспользуется фоновым <see cref="DealMetricsCollector"/> (публикация в <c>DealMetrics</c>) и операторским
/// health (глубины прямо в JSON). Ошибки каждой секции логируются и не выбрасываются наружу (сбой тенанта не
/// валит проход; наружу летит только отмена); значения агрегируются по всем тенантам.
/// </para>
/// </remarks>
public sealed class RuntimeDepthsCollector
{
private readonly IServiceScopeFactory _scopeFactory;
private readonly ILogger<RuntimeDepthsCollector> _logger;
/// <summary>
/// Создаёт сборщик глубин.
/// </summary>
/// <param name="scopeFactory">Фабрика scope: проход и тенант — в собственных scope.</param>
/// <param name="logger">Логгер ошибок секций.</param>
public RuntimeDepthsCollector(IServiceScopeFactory scopeFactory, ILogger<RuntimeDepthsCollector> logger)
{
ArgumentNullException.ThrowIfNull(scopeFactory);
ArgumentNullException.ThrowIfNull(logger);
_scopeFactory = scopeFactory;
_logger = logger;
}
/// <summary>
/// Собирает снимок глубин очередей и числа активных сессий (агрегат по всем тенантам).
/// </summary>
/// <param name="ct">Токен отмены (пробрасывается в EF-запросы; отмена — единственное исключение наружу).</param>
/// <returns>Снимок: суммарные глубины pipeline/ML-outbox и число активных сессий.</returns>
public async Task<RuntimeDepthsDto> CollectAsync(CancellationToken ct)
{
await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
int sessions = await CountActiveSessionsAsync(cycleScope, ct);
(long queue, long outbox) = await SumTenantDepthsAsync(cycleScope, ct);
return new RuntimeDepthsDto(queue, outbox, sessions);
}
// Считает активные непросроченные сессии пользователей и операторов (public-схема).
// cycleScope: Scope прохода (DealDbContext — без tenant-контекста).
// ct: Токен отмены.
// Возвращает: Число активных сессий; сбой секции — 0 (снимок остаётся полезным).
private async Task<int> CountActiveSessionsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
{
try
{
DealDbContext dbContext = cycleScope.ServiceProvider.GetRequiredService<DealDbContext>();
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);
return tenantSessions + operatorSessions;
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
_logger.LogWarning(exception, "Сборщик глубин: подсчёт активных сессий не удался");
return 0;
}
}
// Суммирует глубины очередей по всем тенантам реестра.
// cycleScope: Scope прохода (реестр тенантов читается без tenant-контекста).
// ct: Токен отмены.
// Возвращает: Пара (сумма очереди пайплайна, сумма MlOutbox); недоступность реестра — (0, 0).
private async Task<(long Queue, long Outbox)> SumTenantDepthsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
{
long queueDepth = 0;
long outboxDepth = 0;
try
{
ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
foreach (TenantRecordDto tenant in tenants)
{
(int queue, int outbox) = await CollectTenantAsync(tenant, ct);
queueDepth += queue;
outboxDepth += outbox;
}
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
_logger.LogWarning(exception, "Сборщик глубин: обход реестра тенантов не удался");
}
return (queueDepth, outboxDepth);
}
// Считает глубины очередей одного тенанта в собственном scope (SetTenant → сервисы → Reset).
// tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
// ct: Токен отмены прохода.
// Возвращает: Пара (глубина очереди пайплайна, глубина MlOutbox) для тенанта; сбой — (0, 0).
private async Task<(int Queue, int Outbox)> CollectTenantAsync(TenantRecordDto tenant, CancellationToken ct)
{
await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
PipelineProcessingService processing = tenantScope.ServiceProvider.GetRequiredService<PipelineProcessingService>();
QueueCountsDto counts = await processing.QueueCountsAsync(ct);
IMlLearningStore learningStore = tenantScope.ServiceProvider.GetRequiredService<IMlLearningStore>();
int outbox = await learningStore.CountOutboxAsync(ct);
return (counts.Total, outbox);
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
_logger.LogWarning(exception, "Сборщик глубин: подсчёт очередей тенанта {TenantId} не удался", tenant.Id);
return (0, 0);
}
finally
{
tenantContext.Reset();
}
}
}
using Deal.Infrastructure.Persistence;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
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.SharedKernel.Tenants;
using Microsoft.EntityFrameworkCore;
namespace Deal.Api.Observability;
/// <summary>
/// Сборщик глубин очередей и активных сессий (этап 12, §10.2): единый источник для метрик и health.
/// </summary>
/// <remarks>
/// <para>
/// Обходит реестр тенантов (на тенант — вложенный scope с <c>ITenantContext.SetTenant</c>) и считает через
/// существующие сервисы/порты, без дублирования SQL:
/// <list type="bullet">
/// <item>глубина очереди пайплайна — <see cref="PipelineProcessingService.QueueCountsAsync"/> (new+filtered);</item>
/// <item>глубина очереди обучения ML — <see cref="IMlLearningStore.CountOutboxAsync"/> (count(MlOutbox));</item>
/// <item>активные сессии — count(public.sessions) + count(public.operator_sessions) с непросроченным ExpiresAt.</item>
/// </list>
/// Переиспользуется фоновым <see cref="DealMetricsCollector"/> (публикация в <c>DealMetrics</c>) и операторским
/// health (глубины прямо в JSON). Ошибки каждой секции логируются и не выбрасываются наружу (сбой тенанта не
/// валит проход; наружу летит только отмена); значения агрегируются по всем тенантам.
/// </para>
/// </remarks>
public sealed class RuntimeDepthsCollector
{
private readonly IServiceScopeFactory _scopeFactory;
private readonly ILogger<RuntimeDepthsCollector> _logger;
/// <summary>
/// Создаёт сборщик глубин.
/// </summary>
/// <param name="scopeFactory">Фабрика scope: проход и тенант — в собственных scope.</param>
/// <param name="logger">Логгер ошибок секций.</param>
public RuntimeDepthsCollector(IServiceScopeFactory scopeFactory, ILogger<RuntimeDepthsCollector> logger)
{
ArgumentNullException.ThrowIfNull(scopeFactory);
ArgumentNullException.ThrowIfNull(logger);
_scopeFactory = scopeFactory;
_logger = logger;
}
/// <summary>
/// Собирает снимок глубин очередей и числа активных сессий (агрегат по всем тенантам).
/// </summary>
/// <param name="ct">Токен отмены (пробрасывается в EF-запросы; отмена — единственное исключение наружу).</param>
/// <returns>Снимок: суммарные глубины pipeline/ML-outbox и число активных сессий.</returns>
public async Task<RuntimeDepthsDto> CollectAsync(CancellationToken ct)
{
await using AsyncServiceScope cycleScope = _scopeFactory.CreateAsyncScope();
int sessions = await CountActiveSessionsAsync(cycleScope, ct);
(long queue, long outbox) = await SumTenantDepthsAsync(cycleScope, ct);
return new RuntimeDepthsDto(queue, outbox, sessions);
}
// Считает активные непросроченные сессии пользователей и операторов (public-схема).
// cycleScope: Scope прохода (DealDbContext — без tenant-контекста).
// ct: Токен отмены.
// Возвращает: Число активных сессий; сбой секции — 0 (снимок остаётся полезным).
private async Task<int> CountActiveSessionsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
{
try
{
DealDbContext dbContext = cycleScope.ServiceProvider.GetRequiredService<DealDbContext>();
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);
return tenantSessions + operatorSessions;
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
_logger.LogWarning(exception, "Сборщик глубин: подсчёт активных сессий не удался");
return 0;
}
}
// Суммирует глубины очередей по всем тенантам реестра.
// cycleScope: Scope прохода (реестр тенантов читается без tenant-контекста).
// ct: Токен отмены.
// Возвращает: Пара (сумма очереди пайплайна, сумма MlOutbox); недоступность реестра — (0, 0).
private async Task<(long Queue, long Outbox)> SumTenantDepthsAsync(AsyncServiceScope cycleScope, CancellationToken ct)
{
long queueDepth = 0;
long outboxDepth = 0;
try
{
ITenantRepository tenantRepository = cycleScope.ServiceProvider.GetRequiredService<ITenantRepository>();
IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct);
foreach (TenantRecordDto tenant in tenants)
{
(int queue, int outbox) = await CollectTenantAsync(tenant, ct);
queueDepth += queue;
outboxDepth += outbox;
}
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
_logger.LogWarning(exception, "Сборщик глубин: обход реестра тенантов не удался");
}
return (queueDepth, outboxDepth);
}
// Считает глубины очередей одного тенанта в собственном scope (SetTenant → сервисы → Reset).
// tenant: Тенант реестра (Id в формате Guid; схема — tenant_&lt;N&gt;).
// ct: Токен отмены прохода.
// Возвращает: Пара (глубина очереди пайплайна, глубина MlOutbox) для тенанта; сбой — (0, 0).
private async Task<(int Queue, int Outbox)> CollectTenantAsync(TenantRecordDto tenant, CancellationToken ct)
{
await using AsyncServiceScope tenantScope = _scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
PipelineProcessingService processing = tenantScope.ServiceProvider.GetRequiredService<PipelineProcessingService>();
QueueCountsDto counts = await processing.QueueCountsAsync(ct);
IMlLearningStore learningStore = tenantScope.ServiceProvider.GetRequiredService<IMlLearningStore>();
int outbox = await learningStore.CountOutboxAsync(ct);
return (counts.Total, outbox);
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
_logger.LogWarning(exception, "Сборщик глубин: подсчёт очередей тенанта {TenantId} не удался", tenant.Id);
return (0, 0);
}
finally
{
tenantContext.Reset();
}
}
}
+7 -2
View File
@@ -1,9 +1,14 @@
using Deal.Api.Events;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
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.SharedKernel.Tenants;
namespace Deal.Api;
File diff suppressed because it is too large Load Diff
+4 -1
View File
@@ -1,4 +1,7 @@
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Api;
@@ -1,417 +1,424 @@
using System.Text.Json;
using Deal.Api.Events;
using Deal.Contracts.Integrations.Models;
using Deal.Grpc.Telegram;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Telegram.Application;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
using Deal.SharedKernel.Tenants;
using Grpc.Core;
namespace Deal.Api.Telegram;
/// <summary>
/// gRPC-сервер входящего потока telegram-service → ядро (план Task 12, L361377; Ruling 1/7).
///
/// Реализация серверной стороны Deal.Grpc.Telegram.IngressService (telegram.proto, L380395):
/// PushMessage — новое/догоняющее сообщение мониторящегося диалога в очередь пайплайна
/// (<see cref="PipelineIngestService.EnqueueAsync"/>, тот же контракт, что приём сообщений пайплайна) в схеме тенанта
/// + превью (DialogsService.SavePreview: TgMessages + «последнее сообщение» каталога, Ruling 7);
/// SyncDialogs — применение каталога диалогов (DialogsService.SyncFromTelegram) и ответ со списком
/// monitored id (зеркало сервиса); ReportStatus — статус аккаунта в KV (tgStatus/tgAccount) + SSE
/// system_status/тосты на переходах фаз.
/// </summary>
/// <remarks>
/// Tenant-id берётся ТОЛЬКО из gRPC-metadata (полю в теле не доверяем — Ruling 1), принадлежность
/// подтверждается реестром тенантов (public.tenants), затем для работы открывается собственный scope
/// с <c>ITenantContext.SetTenant</c> (эталон PipelineWorkerScheduler, L169213): tenant-scoped адаптеры
/// (PipelineStore/SettingsStore) строятся от схемы тенанта. Неизвестный тенант/сбой схемы — RPC не падает:
/// ответ не-принято (accepted=false / ok=false, план Task 12) + лог аудита (Ruling 13); недоступный сервис
/// догоняет упущенное realtime-sweep (контракт README).
/// <para>
/// Полная синхронизация каталога (применение entries к таблице Dialogs, ответ = список monitored id) —
/// модуль Deal.Modules.Telegram (план Task 13): DialogsService.SyncFromTelegram (upsert/удаление, авто-
/// мониторинг новых по autoMonitorNew), превью сообщений — DialogsService.SavePreview (PushMessage).
/// </para>
/// </remarks>
public sealed class TelegramIngressService(
IServiceScopeFactory scopeFactory,
SseBroker broker,
ILogger<TelegramIngressService> logger) : IngressService.IngressServiceBase
{
/// <summary>
/// Ключ gRPC-metadata с id тенанта (единственный источник принадлежности — Ruling 1).
/// </summary>
public const string TenantIdMetadataKey = "tenant-id";
// Тип SSE-события статуса Telegram (фронт по нему перечитывает GET /api/tg/status, Ruling 7).
private const string SystemStatusEventType = "system_status";
// Тип SSE-события тоста (Ruling 5; api.js L79 слушает 'toast').
private const string ToastEventType = "toast";
// Текст тоста подключения (Ruling 7, 1:1 с прототипом).
private const string ConnectedToastText = "Telegram подключён, сессия сохранена";
// Текст тоста отключения (Ruling 7, 1:1 с прототипом).
private const string DisconnectedToastText = "Telegram отключён";
// Иконка тоста подключения (из набора Icon.vue фронта).
private const string ConnectedToastIcon = "send";
// Иконка тоста отключения (из набора Icon.vue фронта).
private const string DisconnectedToastIcon = "logout";
// Деталь отказа: metadata tenant-id отсутствует (UNAUTHENTICATED, README src/contracts).
private const string MissingTenantIdDetail = "tenant-id отсутствует в metadata";
// Опции JSON KV-статуса: camelCase (1:1 с wire-именами) + терпимость регистра при чтении.
private static readonly JsonSerializerOptions StatusJsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
/// <summary>
/// PushMessage — сообщение диалога в очередь пайплайна тенанта + превью (PushMessageRequest, Ruling 7).
/// </summary>
/// <remarks>Дубль dialog_id+msg_id уже в очереди — duplicate=true, очередь не растёт (гвард
/// PipelineIngestService). Пустой текст/диалог — no-op приёма (accepted=false, контракт proto).
/// После постановки в очередь пишется превью (DialogsService.SavePreview: строка TgMessages
/// «m_&lt;dialog&gt;_&lt;msg&gt;» + «последнее сообщение» каталога — 1:1 _on_message python L270274);
/// сбой превью не влияет на приём (accepted определён очередью, лог дебага).
/// Неизвестный тенант или сбой схемы/БД — не-принято (accepted=false) без исключения RPC.</remarks>
/// <param name="request">Сообщение из потока telegram-service.</param>
/// <param name="context">Контекст вызова (metadata tenant-id + service-token).</param>
/// <returns>accepted — сообщение принято (либо дубль), duplicate — уже было в очереди.</returns>
public override async Task<PushMessageReply> PushMessage(PushMessageRequest request, ServerCallContext context)
{
TenantRecordDto? tenant = await ResolveTenantAsync(context).ConfigureAwait(false);
if (tenant is null)
{
return new PushMessageReply();
}
await using AsyncServiceScope tenantScope = scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
// Resolve ПОСЛЕ SetTenant: TenantDbContext (и его адаптеры) строятся от схемы текущего тенанта.
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
PipelineIngestService ingest = tenantScope.ServiceProvider.GetRequiredService<PipelineIngestService>();
PipelineIngestResultDto result = await ingest.EnqueueAsync(
new QueuedMessage
{
DialogId = request.DialogId,
ChannelName = request.ChannelName,
ChannelHandle = request.ChannelHandle,
ChannelHue = request.ChannelHue,
MsgId = request.HasMsgId ? request.MsgId : null,
Text = request.Text,
MsgAtMs = request.HasMsgAt ? request.MsgAt : null,
},
context.CancellationToken).ConfigureAwait(false);
await SavePreviewSafelyAsync(tenantScope, tenant, request, context.CancellationToken).ConfigureAwait(false);
logger.LogInformation(
"Аудит: PushMessage {TenantId} диалог {DialogId} msg {MsgId} → {Outcome}",
tenant.Id,
request.DialogId,
request.HasMsgId ? request.MsgId.ToString() : "-",
result.Duplicate ? "duplicate" : result.Id is null ? "no-op" : "queued");
return new PushMessageReply
{
Accepted = result.Id is not null || result.Duplicate,
Duplicate = result.Duplicate,
};
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
// Сбой схемы/БД тенанта (напр. схема ещё не провижинена): RPC не падает — reply not-accepted
// (план Task 12), упущенное сообщение при необходимости догонит realtime-sweep сервиса.
logger.LogWarning(exception, "Аудит: PushMessage {TenantId} → не принято (сбой схемы/БД)", tenant.Id);
return new PushMessageReply();
}
finally
{
tenantContext.Reset();
}
}
/// <summary>
/// SyncDialogs — синхронизация каталога диалогов аккаунта (Ruling 7, L386390).
/// </summary>
/// <remarks>
/// Модуль Deal.Modules.Telegram (план Task 13) применяет entries к таблице Dialogs
/// (DialogsService.SyncFromTelegram: upsert + удаление отсутствующих; авто-мониторинг новых — по
/// настройке autoMonitorNew). Ответ несёт актуальный список monitored id — по нему telegram-service
/// держит своё зеркало мониторинга в памяти (обновляется ответом SyncDialogs и командой SetMonitor,
/// Ruling 7) и фильтрует события realtime.
/// </remarks>
/// <param name="request">Актуальный каталог диалогов (entries).</param>
/// <param name="context">Контекст вызова.</param>
/// <returns>monitored_ids — диалоги с включённым мониторингом после применения каталога.</returns>
public override async Task<SyncDialogsReply> SyncDialogs(SyncDialogsRequest request, ServerCallContext context)
{
TenantRecordDto? tenant = await ResolveTenantAsync(context).ConfigureAwait(false);
if (tenant is null)
{
return new SyncDialogsReply();
}
await using AsyncServiceScope tenantScope = scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
DialogsService dialogs = tenantScope.ServiceProvider.GetRequiredService<DialogsService>();
List<TelegramDialogEntryDto> entries = new(request.Entries.Count);
foreach (DialogEntry entry in request.Entries)
{
entries.Add(new TelegramDialogEntryDto(entry.Id, entry.Name, entry.Username, entry.Kind, entry.Hue));
}
int synced = await dialogs.SyncFromTelegramAsync(entries, context.CancellationToken).ConfigureAwait(false);
IReadOnlyCollection<string> monitoredIds =
await dialogs.ListMonitoredIdsAsync(context.CancellationToken).ConfigureAwait(false);
logger.LogInformation(
"Аудит: SyncDialogs {TenantId}: каталог {Count} → применено {Synced}, monitored {Monitored}",
tenant.Id,
request.Entries.Count,
synced,
monitoredIds.Count);
var reply = new SyncDialogsReply();
reply.MonitoredIds.AddRange(monitoredIds);
return reply;
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
logger.LogWarning(exception, "Аудит: SyncDialogs {TenantId} → каталог не применён (сбой схемы/БД)", tenant.Id);
return new SyncDialogsReply();
}
finally
{
tenantContext.Reset();
}
}
/// <summary>
/// ReportStatus — статус аккаунта в KV + SSE system_status/тосты на переходах фаз (Ruling 7).
/// </summary>
/// <remarks>KV tgStatus (снимок без account) и tgAccount (JSON-строка) пишутся в схему тенанта;
/// system_status публикуется на каждый репорт (фронт перечитывает /api/tg/status), тосты — только на
/// переходы connected: false→true «Telegram подключён, сессия сохранена», true→false «Telegram отключён»
/// (сервис шлёт статус по событию и heartbeat'ом — без гарда переходов тосты дублировались бы).
/// Неизвестный тенант/сбой схемы — ok=false без исключения RPC (план Task 12).</remarks>
/// <param name="request">Статус аккаунта из _publish_status прототипа.</param>
/// <param name="context">Контекст вызова.</param>
/// <returns>ok — статус принят и сохранён.</returns>
public override async Task<ReportStatusReply> ReportStatus(ReportStatusRequest request, ServerCallContext context)
{
TenantRecordDto? tenant = await ResolveTenantAsync(context).ConfigureAwait(false);
if (tenant is null)
{
return new ReportStatusReply();
}
await using AsyncServiceScope tenantScope = scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
ISettingsStore settings = tenantScope.ServiceProvider.GetRequiredService<ISettingsStore>();
TgReportedStatus current = ToReportedStatus(request);
TgReportedStatus? previous = await ReadPreviousStatusAsync(settings, context.CancellationToken).ConfigureAwait(false);
// SSE до записи KV: канал тенанта обновляется и при сбое записи (следующий репорт перепишет KV).
PublishStatusEvents(tenant.Id, previous, current);
await settings.SetAsync(SettingsKeys.TgStatus, ToJson(current), context.CancellationToken).ConfigureAwait(false);
await settings.SetAsync(SettingsKeys.TgAccount, JsonSerializer.Serialize(request.Account), context.CancellationToken).ConfigureAwait(false);
logger.LogInformation(
"Аудит: ReportStatus {TenantId} → фаза {Phase}, connected {Connected}",
tenant.Id,
request.Phase,
request.Connected);
return new ReportStatusReply { Ok = true };
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
logger.LogWarning(exception, "Аудит: ReportStatus {TenantId} → не сохранён (сбой схемы/БД)", tenant.Id);
return new ReportStatusReply();
}
finally
{
tenantContext.Reset();
}
}
// Разрешает тенанта запроса: metadata tenant-id → реестр public.tenants.
// Отсутствующий/пустой tenant-id — RPC-отказ UNAUTHENTICATED (README: tenant-id обязателен).
// Id не Guid либо записи нет в реестре — неизвестный тенант: лог аудита и null (RPC отвечает не-принято,
// план Task 12: «для несуществующего тенанта не падает»).
// context: Контекст вызова.
// Возвращает: Запись тенанта реестра либо null (тенант неизвестен).
private async Task<TenantRecordDto?> ResolveTenantAsync(ServerCallContext context)
{
string tenantId = RequireTenantIdMetadata(context);
if (!Guid.TryParse(tenantId, out Guid tenantGuid))
{
logger.LogWarning("Аудит: ингресс {Action} → тенант {TenantId} неизвестен (id не Guid)", context.Method, tenantId);
return null;
}
await using AsyncServiceScope registryScope = scopeFactory.CreateAsyncScope();
ITenantRepository repository = registryScope.ServiceProvider.GetRequiredService<ITenantRepository>();
TenantRecordDto? tenant = await repository.FindByIdAsync(tenantGuid, context.CancellationToken).ConfigureAwait(false);
if (tenant is null)
{
logger.LogWarning("Аудит: ингресс {Action} → тенант {TenantId} неизвестен (нет в реестре)", context.Method, tenantId);
}
return tenant;
}
// Читает tenant-id из metadata (обязателен; отсутствие — UNAUTHENTICATED, README).
// context: Контекст вызова.
// Возвращает: Значение tenant-id.
private static string RequireTenantIdMetadata(ServerCallContext context)
{
string? tenantId = context.RequestHeaders.GetValue(TenantIdMetadataKey);
if (string.IsNullOrWhiteSpace(tenantId))
{
throw new RpcException(new Status(StatusCode.Unauthenticated, MissingTenantIdDetail));
}
return tenantId;
}
// Пишет превью принятого сообщения (TgMessages + «последнее сообщение» каталога) без влияния на приём.
// Ruling 7: PushMessage → EnqueueAsync + превью. Сбой превью (нет таблиц/строки каталога и т.п.)
// не роняет RPC и не меняет accepted — очередь уже записана, упущенное догонит realtime-sweep (как
// python: обновление last_text после enqueue в том же обработчике, ошибка не отменяет приём).
// tenantScope: Scope тенанта (TenantDbContext построен на схеме тенанта).
// tenant: Тенант канала (для лога аудита).
// request: Сообщение PushMessage.
// ct: Токен отмены.
private async Task SavePreviewSafelyAsync(
AsyncServiceScope tenantScope, TenantRecordDto tenant, PushMessageRequest request, CancellationToken ct)
{
try
{
DialogsService dialogs = tenantScope.ServiceProvider.GetRequiredService<DialogsService>();
DateTimeOffset? msgAt = request.HasMsgAt ? DateTimeOffset.FromUnixTimeMilliseconds(request.MsgAt) : null;
await dialogs.SavePreviewAsync(
request.DialogId,
request.HasMsgId ? request.MsgId : null,
request.Text,
msgAt,
ct).ConfigureAwait(false);
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
// Превью — вторичная запись: приём не затронут (лог дебага, не ошибка RPC).
logger.LogDebug(exception, "PushMessage {TenantId}: превью не сохранено (приём не затронут)", tenant.Id);
}
}
// Публикует SSE system_status (каждый репорт) и тосты на переходах connected.
// tenantId: Тенант канала (реестровый Guid).
// previous: Предыдущий снимок из KV (null — первый репорт).
// current: Текущий снимок репорта.
private void PublishStatusEvents(Guid tenantId, TgReportedStatus? previous, TgReportedStatus current)
{
broker.Publish(tenantId, SystemStatusEventType, current);
if (previous is null)
{
// Первый репорт после старта сервиса: переходов нет, статус фронт получит по system_status.
return;
}
if (!previous.Connected && current.Connected)
{
PublishToast(tenantId, ConnectedToastText, ConnectedToastIcon);
}
else if (previous.Connected && !current.Connected)
{
PublishToast(tenantId, DisconnectedToastText, DisconnectedToastIcon);
}
}
// Публикует SSE-тост в канал тенанта (без подписчиков — no-op, Ruling 5).
// tenantId: Тенант-получатель.
// text: Текст тоста.
// icon: Иконка тоста (набор Icon.vue фронта).
private void PublishToast(Guid tenantId, string text, string icon)
{
broker.Publish(tenantId, ToastEventType, new { text, icon });
}
// Снимок предыдущего статуса из KV tgStatus (нет записи/битый JSON — null).
// settings: KV-хранилище настроек схемы тенанта.
// ct: Токен отмены.
// Возвращает: Предыдущий снимок либо null.
private async Task<TgReportedStatus?> ReadPreviousStatusAsync(ISettingsStore settings, CancellationToken ct)
{
SettingValue? stored = await settings.GetAsync(SettingsKeys.TgStatus, ct).ConfigureAwait(false);
if (stored is null)
{
return null;
}
try
{
return JsonSerializer.Deserialize<TgReportedStatus>(stored.ValueJson, StatusJsonOptions);
}
catch (JsonException exception)
{
logger.LogWarning(exception, "Аудит: KV tgStatus повреждён — переходы фаз не определяются");
return null;
}
}
// Маппит запрос ReportStatus в снимок KV (account живёт отдельным ключом tgAccount).
// request: Запрос ReportStatus.
// Возвращает: Снимок статуса.
private static TgReportedStatus ToReportedStatus(ReportStatusRequest request) => new()
{
Phase = request.Phase,
Connected = request.Connected,
Listener = request.Listener,
Error = request.HasError ? request.Error : null,
QrUrl = request.HasQrUrl ? request.QrUrl : null,
};
// Сериализует снимок в JSON (camelCase, конвенция value_json).
// status: Снимок статуса.
// Возвращает: JSON-строка.
private static string ToJson(TgReportedStatus status) => JsonSerializer.Serialize(status, StatusJsonOptions);
}
using System.Text.Json;
using Deal.Api.Events;
using Deal.Contracts.Integrations.Models;
using Deal.Grpc.Telegram;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
using Deal.Modules.Telegram.Application;
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.SharedKernel.Tenants;
using Grpc.Core;
namespace Deal.Api.Telegram;
/// <summary>
/// gRPC-сервер входящего потока telegram-service → ядро (план Task 12, L361377; Ruling 1/7).
///
/// Реализация серверной стороны Deal.Grpc.Telegram.IngressService (telegram.proto, L380395):
/// PushMessage — новое/догоняющее сообщение мониторящегося диалога в очередь пайплайна
/// (<see cref="PipelineIngestService.EnqueueAsync"/>, тот же контракт, что приём сообщений пайплайна) в схеме тенанта
/// + превью (DialogsService.SavePreview: TgMessages + «последнее сообщение» каталога, Ruling 7);
/// SyncDialogs — применение каталога диалогов (DialogsService.SyncFromTelegram) и ответ со списком
/// monitored id (зеркало сервиса); ReportStatus — статус аккаунта в KV (tgStatus/tgAccount) + SSE
/// system_status/тосты на переходах фаз.
/// </summary>
/// <remarks>
/// Tenant-id берётся ТОЛЬКО из gRPC-metadata (полю в теле не доверяем — Ruling 1), принадлежность
/// подтверждается реестром тенантов (public.tenants), затем для работы открывается собственный scope
/// с <c>ITenantContext.SetTenant</c> (эталон PipelineWorkerScheduler, L169213): tenant-scoped адаптеры
/// (PipelineStore/SettingsStore) строятся от схемы тенанта. Неизвестный тенант/сбой схемы — RPC не падает:
/// ответ не-принято (accepted=false / ok=false, план Task 12) + лог аудита (Ruling 13); недоступный сервис
/// догоняет упущенное realtime-sweep (контракт README).
/// <para>
/// Полная синхронизация каталога (применение entries к таблице Dialogs, ответ = список monitored id) —
/// модуль Deal.Modules.Telegram (план Task 13): DialogsService.SyncFromTelegram (upsert/удаление, авто-
/// мониторинг новых по autoMonitorNew), превью сообщений — DialogsService.SavePreview (PushMessage).
/// </para>
/// </remarks>
public sealed class TelegramIngressService(
IServiceScopeFactory scopeFactory,
SseBroker broker,
ILogger<TelegramIngressService> logger) : IngressService.IngressServiceBase
{
/// <summary>
/// Ключ gRPC-metadata с id тенанта (единственный источник принадлежности — Ruling 1).
/// </summary>
public const string TenantIdMetadataKey = "tenant-id";
// Тип SSE-события статуса Telegram (фронт по нему перечитывает GET /api/tg/status, Ruling 7).
private const string SystemStatusEventType = "system_status";
// Тип SSE-события тоста (Ruling 5; api.js L79 слушает 'toast').
private const string ToastEventType = "toast";
// Текст тоста подключения (Ruling 7, 1:1 с прототипом).
private const string ConnectedToastText = "Telegram подключён, сессия сохранена";
// Текст тоста отключения (Ruling 7, 1:1 с прототипом).
private const string DisconnectedToastText = "Telegram отключён";
// Иконка тоста подключения (из набора Icon.vue фронта).
private const string ConnectedToastIcon = "send";
// Иконка тоста отключения (из набора Icon.vue фронта).
private const string DisconnectedToastIcon = "logout";
// Деталь отказа: metadata tenant-id отсутствует (UNAUTHENTICATED, README src/contracts).
private const string MissingTenantIdDetail = "tenant-id отсутствует в metadata";
// Опции JSON KV-статуса: camelCase (1:1 с wire-именами) + терпимость регистра при чтении.
private static readonly JsonSerializerOptions StatusJsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
/// <summary>
/// PushMessage — сообщение диалога в очередь пайплайна тенанта + превью (PushMessageRequest, Ruling 7).
/// </summary>
/// <remarks>Дубль dialog_id+msg_id уже в очереди — duplicate=true, очередь не растёт (гвард
/// PipelineIngestService). Пустой текст/диалог — no-op приёма (accepted=false, контракт proto).
/// После постановки в очередь пишется превью (DialogsService.SavePreview: строка TgMessages
/// «m_&lt;dialog&gt;_&lt;msg&gt;» + «последнее сообщение» каталога — 1:1 _on_message python L270274);
/// сбой превью не влияет на приём (accepted определён очередью, лог дебага).
/// Неизвестный тенант или сбой схемы/БД — не-принято (accepted=false) без исключения RPC.</remarks>
/// <param name="request">Сообщение из потока telegram-service.</param>
/// <param name="context">Контекст вызова (metadata tenant-id + service-token).</param>
/// <returns>accepted — сообщение принято (либо дубль), duplicate — уже было в очереди.</returns>
public override async Task<PushMessageReply> PushMessage(PushMessageRequest request, ServerCallContext context)
{
TenantRecordDto? tenant = await ResolveTenantAsync(context).ConfigureAwait(false);
if (tenant is null)
{
return new PushMessageReply();
}
await using AsyncServiceScope tenantScope = scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
// Resolve ПОСЛЕ SetTenant: TenantDbContext (и его адаптеры) строятся от схемы текущего тенанта.
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
PipelineIngestService ingest = tenantScope.ServiceProvider.GetRequiredService<PipelineIngestService>();
PipelineIngestResultDto result = await ingest.EnqueueAsync(
new QueuedMessage
{
DialogId = request.DialogId,
ChannelName = request.ChannelName,
ChannelHandle = request.ChannelHandle,
ChannelHue = request.ChannelHue,
MsgId = request.HasMsgId ? request.MsgId : null,
Text = request.Text,
MsgAtMs = request.HasMsgAt ? request.MsgAt : null,
},
context.CancellationToken).ConfigureAwait(false);
await SavePreviewSafelyAsync(tenantScope, tenant, request, context.CancellationToken).ConfigureAwait(false);
logger.LogInformation(
"Аудит: PushMessage {TenantId} диалог {DialogId} msg {MsgId} → {Outcome}",
tenant.Id,
request.DialogId,
request.HasMsgId ? request.MsgId.ToString() : "-",
result.Duplicate ? "duplicate" : result.Id is null ? "no-op" : "queued");
return new PushMessageReply
{
Accepted = result.Id is not null || result.Duplicate,
Duplicate = result.Duplicate,
};
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
// Сбой схемы/БД тенанта (напр. схема ещё не провижинена): RPC не падает — reply not-accepted
// (план Task 12), упущенное сообщение при необходимости догонит realtime-sweep сервиса.
logger.LogWarning(exception, "Аудит: PushMessage {TenantId} → не принято (сбой схемы/БД)", tenant.Id);
return new PushMessageReply();
}
finally
{
tenantContext.Reset();
}
}
/// <summary>
/// SyncDialogs — синхронизация каталога диалогов аккаунта (Ruling 7, L386390).
/// </summary>
/// <remarks>
/// Модуль Deal.Modules.Telegram (план Task 13) применяет entries к таблице Dialogs
/// (DialogsService.SyncFromTelegram: upsert + удаление отсутствующих; авто-мониторинг новых — по
/// настройке autoMonitorNew). Ответ несёт актуальный список monitored id — по нему telegram-service
/// держит своё зеркало мониторинга в памяти (обновляется ответом SyncDialogs и командой SetMonitor,
/// Ruling 7) и фильтрует события realtime.
/// </remarks>
/// <param name="request">Актуальный каталог диалогов (entries).</param>
/// <param name="context">Контекст вызова.</param>
/// <returns>monitored_ids — диалоги с включённым мониторингом после применения каталога.</returns>
public override async Task<SyncDialogsReply> SyncDialogs(SyncDialogsRequest request, ServerCallContext context)
{
TenantRecordDto? tenant = await ResolveTenantAsync(context).ConfigureAwait(false);
if (tenant is null)
{
return new SyncDialogsReply();
}
await using AsyncServiceScope tenantScope = scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
DialogsService dialogs = tenantScope.ServiceProvider.GetRequiredService<DialogsService>();
List<TelegramDialogEntryDto> entries = new(request.Entries.Count);
foreach (DialogEntry entry in request.Entries)
{
entries.Add(new TelegramDialogEntryDto(entry.Id, entry.Name, entry.Username, entry.Kind, entry.Hue));
}
int synced = await dialogs.SyncFromTelegramAsync(entries, context.CancellationToken).ConfigureAwait(false);
IReadOnlyCollection<string> monitoredIds =
await dialogs.ListMonitoredIdsAsync(context.CancellationToken).ConfigureAwait(false);
logger.LogInformation(
"Аудит: SyncDialogs {TenantId}: каталог {Count} → применено {Synced}, monitored {Monitored}",
tenant.Id,
request.Entries.Count,
synced,
monitoredIds.Count);
var reply = new SyncDialogsReply();
reply.MonitoredIds.AddRange(monitoredIds);
return reply;
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
logger.LogWarning(exception, "Аудит: SyncDialogs {TenantId} → каталог не применён (сбой схемы/БД)", tenant.Id);
return new SyncDialogsReply();
}
finally
{
tenantContext.Reset();
}
}
/// <summary>
/// ReportStatus — статус аккаунта в KV + SSE system_status/тосты на переходах фаз (Ruling 7).
/// </summary>
/// <remarks>KV tgStatus (снимок без account) и tgAccount (JSON-строка) пишутся в схему тенанта;
/// system_status публикуется на каждый репорт (фронт перечитывает /api/tg/status), тосты — только на
/// переходы connected: false→true «Telegram подключён, сессия сохранена», true→false «Telegram отключён»
/// (сервис шлёт статус по событию и heartbeat'ом — без гарда переходов тосты дублировались бы).
/// Неизвестный тенант/сбой схемы — ok=false без исключения RPC (план Task 12).</remarks>
/// <param name="request">Статус аккаунта из _publish_status прототипа.</param>
/// <param name="context">Контекст вызова.</param>
/// <returns>ok — статус принят и сохранён.</returns>
public override async Task<ReportStatusReply> ReportStatus(ReportStatusRequest request, ServerCallContext context)
{
TenantRecordDto? tenant = await ResolveTenantAsync(context).ConfigureAwait(false);
if (tenant is null)
{
return new ReportStatusReply();
}
await using AsyncServiceScope tenantScope = scopeFactory.CreateAsyncScope();
ITenantContext tenantContext = tenantScope.ServiceProvider.GetRequiredService<ITenantContext>();
try
{
tenantContext.SetTenant(new TenantId(tenant.Id.ToString("N")));
ISettingsStore settings = tenantScope.ServiceProvider.GetRequiredService<ISettingsStore>();
TgReportedStatus current = ToReportedStatus(request);
TgReportedStatus? previous = await ReadPreviousStatusAsync(settings, context.CancellationToken).ConfigureAwait(false);
// SSE до записи KV: канал тенанта обновляется и при сбое записи (следующий репорт перепишет KV).
PublishStatusEvents(tenant.Id, previous, current);
await settings.SetAsync(SettingsKeys.TgStatus, ToJson(current), context.CancellationToken).ConfigureAwait(false);
await settings.SetAsync(SettingsKeys.TgAccount, JsonSerializer.Serialize(request.Account), context.CancellationToken).ConfigureAwait(false);
logger.LogInformation(
"Аудит: ReportStatus {TenantId} → фаза {Phase}, connected {Connected}",
tenant.Id,
request.Phase,
request.Connected);
return new ReportStatusReply { Ok = true };
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
logger.LogWarning(exception, "Аудит: ReportStatus {TenantId} → не сохранён (сбой схемы/БД)", tenant.Id);
return new ReportStatusReply();
}
finally
{
tenantContext.Reset();
}
}
// Разрешает тенанта запроса: metadata tenant-id → реестр public.tenants.
// Отсутствующий/пустой tenant-id — RPC-отказ UNAUTHENTICATED (README: tenant-id обязателен).
// Id не Guid либо записи нет в реестре — неизвестный тенант: лог аудита и null (RPC отвечает не-принято,
// план Task 12: «для несуществующего тенанта не падает»).
// context: Контекст вызова.
// Возвращает: Запись тенанта реестра либо null (тенант неизвестен).
private async Task<TenantRecordDto?> ResolveTenantAsync(ServerCallContext context)
{
string tenantId = RequireTenantIdMetadata(context);
if (!Guid.TryParse(tenantId, out Guid tenantGuid))
{
logger.LogWarning("Аудит: ингресс {Action} → тенант {TenantId} неизвестен (id не Guid)", context.Method, tenantId);
return null;
}
await using AsyncServiceScope registryScope = scopeFactory.CreateAsyncScope();
ITenantRepository repository = registryScope.ServiceProvider.GetRequiredService<ITenantRepository>();
TenantRecordDto? tenant = await repository.FindByIdAsync(tenantGuid, context.CancellationToken).ConfigureAwait(false);
if (tenant is null)
{
logger.LogWarning("Аудит: ингресс {Action} → тенант {TenantId} неизвестен (нет в реестре)", context.Method, tenantId);
}
return tenant;
}
// Читает tenant-id из metadata (обязателен; отсутствие — UNAUTHENTICATED, README).
// context: Контекст вызова.
// Возвращает: Значение tenant-id.
private static string RequireTenantIdMetadata(ServerCallContext context)
{
string? tenantId = context.RequestHeaders.GetValue(TenantIdMetadataKey);
if (string.IsNullOrWhiteSpace(tenantId))
{
throw new RpcException(new Status(StatusCode.Unauthenticated, MissingTenantIdDetail));
}
return tenantId;
}
// Пишет превью принятого сообщения (TgMessages + «последнее сообщение» каталога) без влияния на приём.
// Ruling 7: PushMessage → EnqueueAsync + превью. Сбой превью (нет таблиц/строки каталога и т.п.)
// не роняет RPC и не меняет accepted — очередь уже записана, упущенное догонит realtime-sweep (как
// python: обновление last_text после enqueue в том же обработчике, ошибка не отменяет приём).
// tenantScope: Scope тенанта (TenantDbContext построен на схеме тенанта).
// tenant: Тенант канала (для лога аудита).
// request: Сообщение PushMessage.
// ct: Токен отмены.
private async Task SavePreviewSafelyAsync(
AsyncServiceScope tenantScope, TenantRecordDto tenant, PushMessageRequest request, CancellationToken ct)
{
try
{
DialogsService dialogs = tenantScope.ServiceProvider.GetRequiredService<DialogsService>();
DateTimeOffset? msgAt = request.HasMsgAt ? DateTimeOffset.FromUnixTimeMilliseconds(request.MsgAt) : null;
await dialogs.SavePreviewAsync(
request.DialogId,
request.HasMsgId ? request.MsgId : null,
request.Text,
msgAt,
ct).ConfigureAwait(false);
}
catch (OperationCanceledException)
{
throw;
}
catch (Exception exception)
{
// Превью — вторичная запись: приём не затронут (лог дебага, не ошибка RPC).
logger.LogDebug(exception, "PushMessage {TenantId}: превью не сохранено (приём не затронут)", tenant.Id);
}
}
// Публикует SSE system_status (каждый репорт) и тосты на переходах connected.
// tenantId: Тенант канала (реестровый Guid).
// previous: Предыдущий снимок из KV (null — первый репорт).
// current: Текущий снимок репорта.
private void PublishStatusEvents(Guid tenantId, TgReportedStatus? previous, TgReportedStatus current)
{
broker.Publish(tenantId, SystemStatusEventType, current);
if (previous is null)
{
// Первый репорт после старта сервиса: переходов нет, статус фронт получит по system_status.
return;
}
if (!previous.Connected && current.Connected)
{
PublishToast(tenantId, ConnectedToastText, ConnectedToastIcon);
}
else if (previous.Connected && !current.Connected)
{
PublishToast(tenantId, DisconnectedToastText, DisconnectedToastIcon);
}
}
// Публикует SSE-тост в канал тенанта (без подписчиков — no-op, Ruling 5).
// tenantId: Тенант-получатель.
// text: Текст тоста.
// icon: Иконка тоста (набор Icon.vue фронта).
private void PublishToast(Guid tenantId, string text, string icon)
{
broker.Publish(tenantId, ToastEventType, new { text, icon });
}
// Снимок предыдущего статуса из KV tgStatus (нет записи/битый JSON — null).
// settings: KV-хранилище настроек схемы тенанта.
// ct: Токен отмены.
// Возвращает: Предыдущий снимок либо null.
private async Task<TgReportedStatus?> ReadPreviousStatusAsync(ISettingsStore settings, CancellationToken ct)
{
SettingValue? stored = await settings.GetAsync(SettingsKeys.TgStatus, ct).ConfigureAwait(false);
if (stored is null)
{
return null;
}
try
{
return JsonSerializer.Deserialize<TgReportedStatus>(stored.ValueJson, StatusJsonOptions);
}
catch (JsonException exception)
{
logger.LogWarning(exception, "Аудит: KV tgStatus повреждён — переходы фаз не определяются");
return null;
}
}
// Маппит запрос ReportStatus в снимок KV (account живёт отдельным ключом tgAccount).
// request: Запрос ReportStatus.
// Возвращает: Снимок статуса.
private static TgReportedStatus ToReportedStatus(ReportStatusRequest request) => new()
{
Phase = request.Phase,
Connected = request.Connected,
Listener = request.Listener,
Error = request.HasError ? request.Error : null,
QrUrl = request.HasQrUrl ? request.QrUrl : null,
};
// Сериализует снимок в JSON (camelCase, конвенция value_json).
// status: Снимок статуса.
// Возвращает: JSON-строка.
private static string ToJson(TgReportedStatus status) => JsonSerializer.Serialize(status, StatusJsonOptions);
}
@@ -1,6 +1,8 @@
using System.Text.Json;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Api.Telegram;
+110 -108
View File
@@ -1,108 +1,110 @@
using System.Text.Json;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Telegram.Application;
using Deal.Modules.Telegram.Application.Models;
namespace Deal.Api.Telegram;
/// <summary>
/// Сборка статуса вкладки Telegram — GET /api/tg/status (Ruling 8, api-map §4.9 L357359).
/// </summary>
/// <remarks>
/// Форма 1:1 с status() python L103119 в терминах этапа 6:
/// <list type="bullet">
/// <item>live-поля (phase/connected/listener/error/qrUrl) — из гейта <see cref="ITelegramGateway.StatusAsync"/>
/// (живой telegram-service); сервис недоступен/сессии нет (RPC-отказ) → idle-форма (Ruling 8);</item>
/// <item>account — из KV tgAccount (источник истины — ReportStatus ингресса, Ruling 7);</item>
/// <item>monitored — count(Dialogs WHERE Monitor) ядра (DialogsService.ListMonitoredIds);</item>
/// <item>keysSet — оба глобальных ключа приложения заданы оператором (TelegramKeysService, Ruling 3, ТЗ §4.1/§8.1).</item>
/// </list>
/// Scoped: зависимости живут на контекстах запроса (ISettingsStore — схема тенанта, IGlobalSettingsStore — public).
/// </remarks>
/// <param name="gateway">Порт-гейт telegram-service (живой статус аккаунта).</param>
/// <param name="dialogs">Сервис каталога диалогов ядра (счётчик мониторящихся).</param>
/// <param name="settings">KV-хранилище настроек тенанта (tgAccount).</param>
/// <param name="keys">Глобальные ключи приложения Telegram (keysSet).</param>
public sealed class TgStatusService(
ITelegramGateway gateway,
DialogsService dialogs,
ISettingsStore settings,
TelegramKeysService keys)
{
// Фаза idle-формы (аккаунт не подключён/сервис недоступен — Ruling 8).
private const string IdlePhase = "idle";
// Опции JSON KV-значений статуса: camelCase (как пишет ингресс) + терпимость регистра.
private static readonly JsonSerializerOptions KvJsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
/// <summary>
/// Форма GET /api/tg/status текущего тенанта (поля §4.9).
/// </summary>
/// <param name="ct">Токен отмены.</param>
/// <returns>Полный статус вкладки Telegram.</returns>
public async Task<TgStatusDto> GetAsync(CancellationToken ct)
{
TelegramAccountStatusDto live = await ReadLiveAsync(ct).ConfigureAwait(false);
string account = await ReadAccountAsync(ct).ConfigureAwait(false);
int monitored = (await dialogs.ListMonitoredIdsAsync(ct).ConfigureAwait(false)).Count;
TgKeysSnapshot snapshot = await keys.GetAsync(ct).ConfigureAwait(false);
return new TgStatusDto(
Phase: live.Phase,
Connected: live.Connected,
Listener: live.Listener,
Account: account,
Monitored: monitored,
KeysSet: snapshot.KeysSet,
Error: live.Error,
QrUrl: live.QrUrl);
}
// Живой статус из гейта; сбой (сервис недоступен/нет сессии) → idle-форма (Ruling 8).
// ct: Токен отмены.
// Возвращает: Статус гейта либо idle-поля.
private async Task<TelegramAccountStatusDto> ReadLiveAsync(CancellationToken ct)
{
try
{
return await gateway.StatusAsync(ct).ConfigureAwait(false);
}
catch (Exception exception) when (exception is not OperationCanceledException || !ct.IsCancellationRequested)
{
// «Сервис недоступен → idle-форма» (Ruling 8): connected=false, live-поля пусты. Аккаунт/счётчики
// ядро всё равно докладывает из своего KV/БД (ниже) — как python при отключённом клиенте.
return new TelegramAccountStatusDto(IdlePhase, Connected: false, Listener: false, string.Empty, null, null);
}
}
// Аккаунт «@username» из KV tgAccount (JSON-строка, пишет ReportStatus ингресса, Ruling 7).
// ct: Токен отмены.
// Возвращает: Аккаунт или пустая строка.
private async Task<string> ReadAccountAsync(CancellationToken ct)
{
SettingValue? row = await settings.GetAsync(SettingsKeys.TgAccount, ct).ConfigureAwait(false);
if (row is null)
{
return string.Empty;
}
try
{
using JsonDocument document = JsonDocument.Parse(row.ValueJson);
return document.RootElement.ValueKind == JsonValueKind.String
? document.RootElement.GetString() ?? string.Empty
: string.Empty;
}
catch (JsonException)
{
return string.Empty;
}
}
}
using System.Text.Json;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
using Deal.Modules.Telegram.Application;
using Deal.Modules.Telegram.Application.Models;
namespace Deal.Api.Telegram;
/// <summary>
/// Сборка статуса вкладки Telegram — GET /api/tg/status (Ruling 8, api-map §4.9 L357359).
/// </summary>
/// <remarks>
/// Форма 1:1 с status() python L103119 в терминах этапа 6:
/// <list type="bullet">
/// <item>live-поля (phase/connected/listener/error/qrUrl) — из гейта <see cref="ITelegramGateway.StatusAsync"/>
/// (живой telegram-service); сервис недоступен/сессии нет (RPC-отказ) → idle-форма (Ruling 8);</item>
/// <item>account — из KV tgAccount (источник истины — ReportStatus ингресса, Ruling 7);</item>
/// <item>monitored — count(Dialogs WHERE Monitor) ядра (DialogsService.ListMonitoredIds);</item>
/// <item>keysSet — оба глобальных ключа приложения заданы оператором (TelegramKeysService, Ruling 3, ТЗ §4.1/§8.1).</item>
/// </list>
/// Scoped: зависимости живут на контекстах запроса (ISettingsStore — схема тенанта, IGlobalSettingsStore — public).
/// </remarks>
/// <param name="gateway">Порт-гейт telegram-service (живой статус аккаунта).</param>
/// <param name="dialogs">Сервис каталога диалогов ядра (счётчик мониторящихся).</param>
/// <param name="settings">KV-хранилище настроек тенанта (tgAccount).</param>
/// <param name="keys">Глобальные ключи приложения Telegram (keysSet).</param>
public sealed class TgStatusService(
ITelegramGateway gateway,
DialogsService dialogs,
ISettingsStore settings,
TelegramKeysService keys)
{
// Фаза idle-формы (аккаунт не подключён/сервис недоступен — Ruling 8).
private const string IdlePhase = "idle";
// Опции JSON KV-значений статуса: camelCase (как пишет ингресс) + терпимость регистра.
private static readonly JsonSerializerOptions KvJsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
/// <summary>
/// Форма GET /api/tg/status текущего тенанта (поля §4.9).
/// </summary>
/// <param name="ct">Токен отмены.</param>
/// <returns>Полный статус вкладки Telegram.</returns>
public async Task<TgStatusDto> GetAsync(CancellationToken ct)
{
TelegramAccountStatusDto live = await ReadLiveAsync(ct).ConfigureAwait(false);
string account = await ReadAccountAsync(ct).ConfigureAwait(false);
int monitored = (await dialogs.ListMonitoredIdsAsync(ct).ConfigureAwait(false)).Count;
TgKeysSnapshot snapshot = await keys.GetAsync(ct).ConfigureAwait(false);
return new TgStatusDto(
Phase: live.Phase,
Connected: live.Connected,
Listener: live.Listener,
Account: account,
Monitored: monitored,
KeysSet: snapshot.KeysSet,
Error: live.Error,
QrUrl: live.QrUrl);
}
// Живой статус из гейта; сбой (сервис недоступен/нет сессии) → idle-форма (Ruling 8).
// ct: Токен отмены.
// Возвращает: Статус гейта либо idle-поля.
private async Task<TelegramAccountStatusDto> ReadLiveAsync(CancellationToken ct)
{
try
{
return await gateway.StatusAsync(ct).ConfigureAwait(false);
}
catch (Exception exception) when (exception is not OperationCanceledException || !ct.IsCancellationRequested)
{
// «Сервис недоступен → idle-форма» (Ruling 8): connected=false, live-поля пусты. Аккаунт/счётчики
// ядро всё равно докладывает из своего KV/БД (ниже) — как python при отключённом клиенте.
return new TelegramAccountStatusDto(IdlePhase, Connected: false, Listener: false, string.Empty, null, null);
}
}
// Аккаунт «@username» из KV tgAccount (JSON-строка, пишет ReportStatus ингресса, Ruling 7).
// ct: Токен отмены.
// Возвращает: Аккаунт или пустая строка.
private async Task<string> ReadAccountAsync(CancellationToken ct)
{
SettingValue? row = await settings.GetAsync(SettingsKeys.TgAccount, ct).ConfigureAwait(false);
if (row is null)
{
return string.Empty;
}
try
{
using JsonDocument document = JsonDocument.Parse(row.ValueJson);
return document.RootElement.ValueKind == JsonValueKind.String
? document.RootElement.GetString() ?? string.Empty
: string.Empty;
}
catch (JsonException)
{
return string.Empty;
}
}
}
@@ -1,7 +1,9 @@
using System.Diagnostics.CodeAnalysis;
using System.Net.Http.Headers;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Infrastructure.Integrations;
@@ -1,7 +1,9 @@
using System.Text.Json.Nodes;
using Deal.Grpc.Ai;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Infrastructure.Integrations;
@@ -1,7 +1,10 @@
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Tenants.Application;
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.SharedKernel.Tenants;
using Microsoft.Extensions.Logging;
@@ -1,7 +1,10 @@
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Tenants.Application;
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.SharedKernel.Tenants;
using Microsoft.Extensions.Logging;
@@ -1,6 +1,9 @@
using System.Globalization;
using System.Text.Json;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
using Microsoft.Extensions.Logging;
namespace Deal.Infrastructure.Integrations;
@@ -1,7 +1,10 @@
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Grpc.Ai;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
using Deal.SharedKernel.Tenants;
using Grpc.Core;
using Microsoft.Extensions.Logging;
@@ -2,11 +2,20 @@ using System.Text.Json;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Grpc.Ml;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Settings.Application;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
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.SharedKernel.Tenants;
using Grpc.Core;
using Microsoft.Extensions.Logging;
@@ -1,7 +1,9 @@
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
using Deal.Modules.Pipeline.Application.Parse;
namespace Deal.Infrastructure.Integrations;
@@ -1,247 +1,252 @@
using System.Globalization;
using System.Text.Json;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Models;
// Алиас: статический класс ColumnRules лежит в одноимённом пространстве имён (см. CardsService) —
// внутри Deal.Modules.Kanban.Application имя ColumnRules резолвится в пространство.
using KanbanColumnRules = Deal.Modules.Kanban.Application.ColumnRules.ColumnRules;
namespace Deal.Infrastructure.Integrations;
/// <summary>
/// Адаптер ИИ-предложений колонок/ключей — детерминированная эвристика этапа 3 (Ruling 3, план Task 14).
/// </summary>
/// <remarks>
/// Реализует порт <see cref="IColumnSuggester"/> поверх порта <see cref="ICardStore"/> и чистого ядра
/// <see cref="SuggestHeuristics"/> (модуль Kanban): читает «Неразобранное» (ListInboxWithSourceAsync),
/// считает группы слов-тем и создаёт доски suggested=true (RulesJson {mode:"any", keywords:[…]},
/// note-обоснование, цвет/позицию даёт ContainersService) и раскладывает карточки (is_new=TRUE,
/// prev_col='inbox', matchHits по правилам доски — Ruling 2). Причины отказов — детерминированные
/// строки прототипа/Ruling 3: «мало карточек в «Неразобранном» (нужно от 6)», «похожие колонки уже
/// есть или нечего сгруппировать»; кулдаун повторов — KV-ключ <see cref="SettingsKeys.LastSuggestAt"/>
/// (прототип COOLDOWN_S L51 + «недавно предлагали — подождите» L95). Журнал CardMoves/ML-сигналы при
/// раскладке НЕ пишутся (suggest.py _assign_ids L220239 — это не действие пользователя, а предложение).
/// Suggest-keywords читает карточки вне trash/archive (suggest_domain_keywords L172178).
/// </remarks>
/// <param name="store">Порт хранилища (карточки «Неразобранного», переносы в колонки-доски).</param>
/// <param name="settings">KV-хранилище настроек тенанта (кулдаун lastSuggestAt, как KEY suggest.py L52).</param>
/// <param name="containersService">Сервис контейнеров: список существующих и создание suggested-колонок с дефолтами.</param>
public sealed class LocalColumnSuggester(
ICardStore store,
ISettingsStore settings,
ContainersService containersService) : IColumnSuggester
{
// ── Кулдаун повторов (suggest.py COOLDOWN_S L51; KEY lastSuggestAt L52) ──
// Как часто можно переспрашивать ИИ-предложения: 20 минут (COOLDOWN_S = 20 * 60, L51).
private const long CooldownSeconds = 20 * 60;
// ── Детерминированные причины (Ruling 3; строки прототипа suggest.py) ──
// Кулдаун: повторный вызов слишком рано (suggest.py L95 «недавно предлагали — подождите»).
private const string CooldownReason = "недавно предлагали — подождите";
// Мало карточек в «Неразобранном»: {0} — порог MIN_INBOX (suggest.py L102).
private const string TooFewCardsReasonFormat = "мало карточек в «Неразобранном» (нужно от {0})";
// Групп не вышло: темы похожи на существующие доски или карточкам нечего разделить (L159).
private const string NothingGroupedReason = "похожие колонки уже есть или нечего сгруппировать";
// Мало карточек для ключей: нужно хотя бы 3 (suggest_domain_keywords L178).
private const string KeywordsTooFewReason = "мало карточек — сначала накопите заявки (нужно хотя бы 3)";
// Повторяющихся слов-маркеров не нашлось (suggest_domain_keywords L187, текст прототипа).
private const string KeywordsEmptyReason = "ИИ не смог выделить ключи — попробуйте ещё раз";
// Режим правил колонки-предложения: «любое из условий» (suggest.py _rules_for L68 mode: any).
private const string RulesModeAny = "any";
/// <inheritdoc />
public async Task<SuggestColumnsResultDto> SuggestColumnsAsync(CancellationToken ct)
{
if (await WithinCooldownAsync(ct))
{
return new SuggestColumnsResultDto(Ok: false, Created: 0, Reason: CooldownReason, Cooldown: true);
}
IReadOnlyList<CardDto> inbox = await store.ListInboxWithSourceAsync(ct);
if (inbox.Count < SuggestHeuristics.MinInbox)
{
return new SuggestColumnsResultDto(
Ok: false,
Created: 0,
Reason: string.Format(TooFewCardsReasonFormat, SuggestHeuristics.MinInbox),
Cooldown: false);
}
// Существующие (suggested=false) колонки: похожие темы не предлагаем (suggest.py L105, L138139).
IReadOnlyList<ContainerDto> containers = await containersService.ListAsync(ContainerSpaces.Dashboard, ct);
IReadOnlyList<string> existingNames = containers
.Where(container => !container.Suggested)
.Select(container => container.Name)
.ToList();
IReadOnlyList<SuggestedColumnPlan> plans = SuggestHeuristics.PlanColumns(inbox, existingNames);
if (plans.Count == 0)
{
return new SuggestColumnsResultDto(Ok: false, Created: 0, Reason: NothingGroupedReason, Cooldown: false);
}
int created = await StoreSuggestedColumnsAsync(inbox, plans, ct);
if (created == 0)
{
// Все колонки откатаны: карточки групп разобраны между чтением и раскладкой (suggest.py L153156).
return new SuggestColumnsResultDto(Ok: false, Created: 0, Reason: NothingGroupedReason, Cooldown: false);
}
await WriteLastSuggestAtAsync(ct);
return new SuggestColumnsResultDto(Ok: true, Created: created, Reason: null, Cooldown: false);
}
/// <inheritdoc />
public async Task<SuggestKeywordsResultDto> SuggestKeywordsAsync(CancellationToken ct)
{
// Выборка ключей — как suggest_domain_keywords L172176: карточки вне trash/archive с текстом,
// свежие 40 (ListCardsAsync(null) = «все, кроме taken», ORDER BY received_at DESC).
IReadOnlyList<CardDto> cards = await store.ListCardsAsync(new CardsQuery(null), ct);
List<string> texts = cards
.Where(card => card.Col != CardIds.Trash
&& card.Col != CardIds.Archive
&& card.SourceMsg.Trim().Length > 0)
.Take(SuggestHeuristics.KeywordsSampleLimit)
.Select(card => card.SourceMsg.Trim())
.ToList();
if (texts.Count < SuggestHeuristics.MinKeywordsSample)
{
return new SuggestKeywordsResultDto(Ok: false, Keywords: null, Reason: KeywordsTooFewReason);
}
IReadOnlyList<string> keywords = SuggestHeuristics.SuggestDomainKeywords(texts);
if (keywords.Count == 0)
{
return new SuggestKeywordsResultDto(Ok: false, Keywords: null, Reason: KeywordsEmptyReason);
}
return new SuggestKeywordsResultDto(Ok: true, Keywords: keywords, Reason: null);
}
// Создаёт доски-предложения по планам и раскладывает карточки (suggest.py L129156).
// inbox: Снимок «Неразобранного» (карточки планов берутся из него).
// plans: Планы колонок (SuggestHeuristics.PlanColumns, ≤4).
// ct: Токен отмены.
// Возвращает: Сколько досок реально создано (0 — все откатаны из-за разобранных карточек).
// Каждая доска — suggested=true c правилами {mode:"any", keywords:[тема]} и note-обоснованием.
// Перед раскладкой перечитывается «Неразобранное»: карточки, ушедшие из inbox между снимком и
// раскладкой (пользователь/тик), пропускаются — 1:1 со страховкой _assign_ids L231233. Если в
// колонку не легло ни одной карточки, пустая доска-предложение откатывается (_rollback_suggested
// L242248). matchHits считаются по правилам созданной доски (Ruling 2); журнал/ML не пишутся.
private async Task<int> StoreSuggestedColumnsAsync(
IReadOnlyList<CardDto> inbox,
IReadOnlyList<SuggestedColumnPlan> plans,
CancellationToken ct)
{
// Свежий снимок inbox — страховка «карточку уже разобрали» (suggest.py _assign_ids L231233).
HashSet<string> inboxIds = (await store.ListInboxWithSourceAsync(ct))
.Select(card => card.Id)
.ToHashSet(StringComparer.Ordinal);
Dictionary<string, string> textByCardId = inbox
.ToDictionary(card => card.Id, card => card.SourceMsg, StringComparer.Ordinal);
int created = 0;
foreach (SuggestedColumnPlan plan in plans)
{
var rules = new ContainerRulesDto(
Mode: RulesModeAny,
Direction: Array.Empty<string>(),
Keywords: [plan.Word],
Stack: Array.Empty<string>(),
Grade: Array.Empty<string>(),
Exclude: Array.Empty<string>(),
Budget: null);
ContainerDto container = await containersService.CreateAsync(new ContainerCreateDto(
Name: plan.Name,
Description: string.Empty,
Color: null,
Space: ContainerSpaces.Dashboard,
Kind: ContainerKinds.Board,
Suggested: true,
Rules: rules,
Note: plan.Note), ct);
int placed = 0;
foreach (string cardId in plan.CardIds)
{
if (!inboxIds.Contains(cardId))
{
continue; // карточка уже разобрана другим предложением/пользователем (L231–233)
}
IReadOnlyList<MatchHitDto> hits = KanbanColumnRules.ComputeHits(rules, textByCardId[cardId]);
await store.UpdateColumnAsync(new CardColumnUpdateDto(
CardId: cardId,
Col: container.Id,
IsNew: true,
PrevCol: CardIds.Inbox,
ArchivedAt: null,
MatchHits: hits), ct);
placed++;
}
if (placed == 0)
{
// Ничего не легло — пустое предложение не нужно (suggest.py L152156).
await containersService.DeleteAsync(container.Id, ct);
continue;
}
created++;
}
return created;
}
// Сработал ли кулдаун: с последнего успешного предложения прошло меньше 20 минут.
// Повреждённое/отсутствующее значение lastSuggestAt — кулдауна нет (как прототип: значение
// пишется только после успеха, L160–161; битый KV — дефолт «никогда»).
// ct: Токен отмены.
// Возвращает: True — повторный вызов слишком рано (ответ {ok:false, reason, cooldown:true}).
private async Task<bool> WithinCooldownAsync(CancellationToken ct)
{
SettingValue? row = await settings.GetAsync(SettingsKeys.LastSuggestAt, ct);
if (row is null)
{
return false;
}
try
{
using JsonDocument document = JsonDocument.Parse(row.ValueJson);
if (document.RootElement.ValueKind != JsonValueKind.Number)
{
return false;
}
long lastSuggestAt = document.RootElement.GetInt64();
return DateTimeOffset.UtcNow.ToUnixTimeSeconds() - lastSuggestAt < CooldownSeconds;
}
catch (JsonException)
{
return false; // повреждённое значение не должно блокировать предложения
}
}
// Записывает метку успешного предложения (suggest.py L160: set_setting(KEY, time.time())).
// ct: Токен отмены.
private Task WriteLastSuggestAtAsync(CancellationToken ct) =>
settings.SetAsync(
SettingsKeys.LastSuggestAt,
DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString(CultureInfo.InvariantCulture),
ct);
}
using System.Globalization;
using System.Text.Json;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
// Алиас: статический класс ColumnRules лежит в одноимённом пространстве имён (см. CardsService) —
// внутри Deal.Modules.Kanban.Application имя ColumnRules резолвится в пространство.
using KanbanColumnRules = Deal.Modules.Kanban.Application.ColumnRules.ColumnRules;
namespace Deal.Infrastructure.Integrations;
/// <summary>
/// Адаптер ИИ-предложений колонок/ключей — детерминированная эвристика этапа 3 (Ruling 3, план Task 14).
/// </summary>
/// <remarks>
/// Реализует порт <see cref="IColumnSuggester"/> поверх порта <see cref="ICardStore"/> и чистого ядра
/// <see cref="SuggestHeuristics"/> (модуль Kanban): читает «Неразобранное» (ListInboxWithSourceAsync),
/// считает группы слов-тем и создаёт доски suggested=true (RulesJson {mode:"any", keywords:[…]},
/// note-обоснование, цвет/позицию даёт ContainersService) и раскладывает карточки (is_new=TRUE,
/// prev_col='inbox', matchHits по правилам доски — Ruling 2). Причины отказов — детерминированные
/// строки прототипа/Ruling 3: «мало карточек в «Неразобранном» (нужно от 6)», «похожие колонки уже
/// есть или нечего сгруппировать»; кулдаун повторов — KV-ключ <see cref="SettingsKeys.LastSuggestAt"/>
/// (прототип COOLDOWN_S L51 + «недавно предлагали — подождите» L95). Журнал CardMoves/ML-сигналы при
/// раскладке НЕ пишутся (suggest.py _assign_ids L220239 — это не действие пользователя, а предложение).
/// Suggest-keywords читает карточки вне trash/archive (suggest_domain_keywords L172178).
/// </remarks>
/// <param name="store">Порт хранилища (карточки «Неразобранного», переносы в колонки-доски).</param>
/// <param name="settings">KV-хранилище настроек тенанта (кулдаун lastSuggestAt, как KEY suggest.py L52).</param>
/// <param name="containersService">Сервис контейнеров: список существующих и создание suggested-колонок с дефолтами.</param>
public sealed class LocalColumnSuggester(
ICardStore store,
ISettingsStore settings,
ContainersService containersService) : IColumnSuggester
{
// ── Кулдаун повторов (suggest.py COOLDOWN_S L51; KEY lastSuggestAt L52) ──
// Как часто можно переспрашивать ИИ-предложения: 20 минут (COOLDOWN_S = 20 * 60, L51).
private const long CooldownSeconds = 20 * 60;
// ── Детерминированные причины (Ruling 3; строки прототипа suggest.py) ──
// Кулдаун: повторный вызов слишком рано (suggest.py L95 «недавно предлагали — подождите»).
private const string CooldownReason = "недавно предлагали — подождите";
// Мало карточек в «Неразобранном»: {0} — порог MIN_INBOX (suggest.py L102).
private const string TooFewCardsReasonFormat = "мало карточек в «Неразобранном» (нужно от {0})";
// Групп не вышло: темы похожи на существующие доски или карточкам нечего разделить (L159).
private const string NothingGroupedReason = "похожие колонки уже есть или нечего сгруппировать";
// Мало карточек для ключей: нужно хотя бы 3 (suggest_domain_keywords L178).
private const string KeywordsTooFewReason = "мало карточек — сначала накопите заявки (нужно хотя бы 3)";
// Повторяющихся слов-маркеров не нашлось (suggest_domain_keywords L187, текст прототипа).
private const string KeywordsEmptyReason = "ИИ не смог выделить ключи — попробуйте ещё раз";
// Режим правил колонки-предложения: «любое из условий» (suggest.py _rules_for L68 mode: any).
private const string RulesModeAny = "any";
/// <inheritdoc />
public async Task<SuggestColumnsResultDto> SuggestColumnsAsync(CancellationToken ct)
{
if (await WithinCooldownAsync(ct))
{
return new SuggestColumnsResultDto(Ok: false, Created: 0, Reason: CooldownReason, Cooldown: true);
}
IReadOnlyList<CardDto> inbox = await store.ListInboxWithSourceAsync(ct);
if (inbox.Count < SuggestHeuristics.MinInbox)
{
return new SuggestColumnsResultDto(
Ok: false,
Created: 0,
Reason: string.Format(TooFewCardsReasonFormat, SuggestHeuristics.MinInbox),
Cooldown: false);
}
// Существующие (suggested=false) колонки: похожие темы не предлагаем (suggest.py L105, L138139).
IReadOnlyList<ContainerDto> containers = await containersService.ListAsync(ContainerSpaces.Dashboard, ct);
IReadOnlyList<string> existingNames = containers
.Where(container => !container.Suggested)
.Select(container => container.Name)
.ToList();
IReadOnlyList<SuggestedColumnPlan> plans = SuggestHeuristics.PlanColumns(inbox, existingNames);
if (plans.Count == 0)
{
return new SuggestColumnsResultDto(Ok: false, Created: 0, Reason: NothingGroupedReason, Cooldown: false);
}
int created = await StoreSuggestedColumnsAsync(inbox, plans, ct);
if (created == 0)
{
// Все колонки откатаны: карточки групп разобраны между чтением и раскладкой (suggest.py L153156).
return new SuggestColumnsResultDto(Ok: false, Created: 0, Reason: NothingGroupedReason, Cooldown: false);
}
await WriteLastSuggestAtAsync(ct);
return new SuggestColumnsResultDto(Ok: true, Created: created, Reason: null, Cooldown: false);
}
/// <inheritdoc />
public async Task<SuggestKeywordsResultDto> SuggestKeywordsAsync(CancellationToken ct)
{
// Выборка ключей — как suggest_domain_keywords L172176: карточки вне trash/archive с текстом,
// свежие 40 (ListCardsAsync(null) = «все, кроме taken», ORDER BY received_at DESC).
IReadOnlyList<CardDto> cards = await store.ListCardsAsync(new CardsQuery(null), ct);
List<string> texts = cards
.Where(card => card.Col != CardIds.Trash
&& card.Col != CardIds.Archive
&& card.SourceMsg.Trim().Length > 0)
.Take(SuggestHeuristics.KeywordsSampleLimit)
.Select(card => card.SourceMsg.Trim())
.ToList();
if (texts.Count < SuggestHeuristics.MinKeywordsSample)
{
return new SuggestKeywordsResultDto(Ok: false, Keywords: null, Reason: KeywordsTooFewReason);
}
IReadOnlyList<string> keywords = SuggestHeuristics.SuggestDomainKeywords(texts);
if (keywords.Count == 0)
{
return new SuggestKeywordsResultDto(Ok: false, Keywords: null, Reason: KeywordsEmptyReason);
}
return new SuggestKeywordsResultDto(Ok: true, Keywords: keywords, Reason: null);
}
// Создаёт доски-предложения по планам и раскладывает карточки (suggest.py L129156).
// inbox: Снимок «Неразобранного» (карточки планов берутся из него).
// plans: Планы колонок (SuggestHeuristics.PlanColumns, ≤4).
// ct: Токен отмены.
// Возвращает: Сколько досок реально создано (0 — все откатаны из-за разобранных карточек).
// Каждая доска — suggested=true c правилами {mode:"any", keywords:[тема]} и note-обоснованием.
// Перед раскладкой перечитывается «Неразобранное»: карточки, ушедшие из inbox между снимком и
// раскладкой (пользователь/тик), пропускаются — 1:1 со страховкой _assign_ids L231233. Если в
// колонку не легло ни одной карточки, пустая доска-предложение откатывается (_rollback_suggested
// L242248). matchHits считаются по правилам созданной доски (Ruling 2); журнал/ML не пишутся.
private async Task<int> StoreSuggestedColumnsAsync(
IReadOnlyList<CardDto> inbox,
IReadOnlyList<SuggestedColumnPlan> plans,
CancellationToken ct)
{
// Свежий снимок inbox — страховка «карточку уже разобрали» (suggest.py _assign_ids L231233).
HashSet<string> inboxIds = (await store.ListInboxWithSourceAsync(ct))
.Select(card => card.Id)
.ToHashSet(StringComparer.Ordinal);
Dictionary<string, string> textByCardId = inbox
.ToDictionary(card => card.Id, card => card.SourceMsg, StringComparer.Ordinal);
int created = 0;
foreach (SuggestedColumnPlan plan in plans)
{
var rules = new ContainerRulesDto(
Mode: RulesModeAny,
Direction: Array.Empty<string>(),
Keywords: [plan.Word],
Stack: Array.Empty<string>(),
Grade: Array.Empty<string>(),
Exclude: Array.Empty<string>(),
Budget: null);
ContainerDto container = await containersService.CreateAsync(new ContainerCreateDto(
Name: plan.Name,
Description: string.Empty,
Color: null,
Space: ContainerSpaces.Dashboard,
Kind: ContainerKinds.Board,
Suggested: true,
Rules: rules,
Note: plan.Note), ct);
int placed = 0;
foreach (string cardId in plan.CardIds)
{
if (!inboxIds.Contains(cardId))
{
continue; // карточка уже разобрана другим предложением/пользователем (L231–233)
}
IReadOnlyList<MatchHitDto> hits = KanbanColumnRules.ComputeHits(rules, textByCardId[cardId]);
await store.UpdateColumnAsync(new CardColumnUpdateDto(
CardId: cardId,
Col: container.Id,
IsNew: true,
PrevCol: CardIds.Inbox,
ArchivedAt: null,
MatchHits: hits), ct);
placed++;
}
if (placed == 0)
{
// Ничего не легло — пустое предложение не нужно (suggest.py L152156).
await containersService.DeleteAsync(container.Id, ct);
continue;
}
created++;
}
return created;
}
// Сработал ли кулдаун: с последнего успешного предложения прошло меньше 20 минут.
// Повреждённое/отсутствующее значение lastSuggestAt — кулдауна нет (как прототип: значение
// пишется только после успеха, L160–161; битый KV — дефолт «никогда»).
// ct: Токен отмены.
// Возвращает: True — повторный вызов слишком рано (ответ {ok:false, reason, cooldown:true}).
private async Task<bool> WithinCooldownAsync(CancellationToken ct)
{
SettingValue? row = await settings.GetAsync(SettingsKeys.LastSuggestAt, ct);
if (row is null)
{
return false;
}
try
{
using JsonDocument document = JsonDocument.Parse(row.ValueJson);
if (document.RootElement.ValueKind != JsonValueKind.Number)
{
return false;
}
long lastSuggestAt = document.RootElement.GetInt64();
return DateTimeOffset.UtcNow.ToUnixTimeSeconds() - lastSuggestAt < CooldownSeconds;
}
catch (JsonException)
{
return false; // повреждённое значение не должно блокировать предложения
}
}
// Записывает метку успешного предложения (suggest.py L160: set_setting(KEY, time.time())).
// ct: Токен отмены.
private Task WriteLastSuggestAtAsync(CancellationToken ct) =>
settings.SetAsync(
SettingsKeys.LastSuggestAt,
DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString(CultureInfo.InvariantCulture),
ct);
}
@@ -1,9 +1,15 @@
using System.Text.Json;
using Deal.Contracts.Integrations;
using Deal.Contracts.Integrations.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Settings.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Infrastructure.Integrations;
@@ -1,5 +1,9 @@
using System.Security.Cryptography;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
namespace Deal.Infrastructure.Integrations;
@@ -1,10 +1,15 @@
using System.Text.Json;
using System.Text.Json.Nodes;
using Deal.Grpc.Ai;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
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.SharedKernel.Observability;
using Deal.SharedKernel.Tenants;
@@ -6,7 +6,7 @@ namespace Deal.Infrastructure.Persistence.Entities;
/// <remarks>
/// Единое KV-хранилище всего SaaS-контура (ТЗ §4.1/§8.1): значения задаёт оператор, видят все
/// тенанты. Секреты хранятся зашифрованными (префикс <c>enc:</c>), формат значения определяет ключ
/// (<see cref="Deal.Modules.Settings.Application.GlobalSettingsKeys"/>).
/// (<see cref="Deal.Modules.Settings.Application.Models.GlobalSettingsKeys"/>).
/// </remarks>
public sealed class GlobalSettingEntity
{
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,65 +1,69 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Чёрный список Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего
/// файла, поведение не менялось): upsert/удаление/чтение/список DiscBlacklist (ON CONFLICT DO UPDATE).
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task UpsertBlacklistAsync(string dialogId, string name, string reason, CancellationToken ct)
{
DiscBlacklistEntity? row = await _dbContext.DiscBlacklist
.FirstOrDefaultAsync(entry => entry.DialogId == dialogId, ct);
if (row is null)
{
_dbContext.DiscBlacklist.Add(new DiscBlacklistEntity
{
DialogId = dialogId,
Name = name,
Reason = reason,
CreatedAt = DateTimeOffset.UtcNow,
});
}
else
{
// add_blacklist L572575 (ON CONFLICT DO UPDATE): name/reason обновляются, CreatedAt сохраняется.
row.Name = name;
row.Reason = reason;
}
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task RemoveBlacklistAsync(string dialogId, CancellationToken ct)
{
await _dbContext.DiscBlacklist.Where(entry => entry.DialogId == dialogId).ExecuteDeleteAsync(ct);
}
/// <inheritdoc />
public async Task<DiscoveryBlacklistDto?> GetBlacklistAsync(string dialogId, CancellationToken ct)
{
DiscBlacklistEntity? row = await _dbContext.DiscBlacklist
.AsNoTracking()
.FirstOrDefaultAsync(entry => entry.DialogId == dialogId, ct);
return row is null ? null : ToBlacklistDto(row);
}
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryBlacklistDto>> ListBlacklistAsync(CancellationToken ct)
{
List<DiscBlacklistEntity> rows = await _dbContext.DiscBlacklist
.AsNoTracking()
.OrderByDescending(entry => entry.CreatedAt)
.ToListAsync(ct);
return rows.Select(ToBlacklistDto).ToList();
}
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Чёрный список Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего
/// файла, поведение не менялось): upsert/удаление/чтение/список DiscBlacklist (ON CONFLICT DO UPDATE).
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task UpsertBlacklistAsync(string dialogId, string name, string reason, CancellationToken ct)
{
DiscBlacklistEntity? row = await _dbContext.DiscBlacklist
.FirstOrDefaultAsync(entry => entry.DialogId == dialogId, ct);
if (row is null)
{
_dbContext.DiscBlacklist.Add(new DiscBlacklistEntity
{
DialogId = dialogId,
Name = name,
Reason = reason,
CreatedAt = DateTimeOffset.UtcNow,
});
}
else
{
// add_blacklist L572575 (ON CONFLICT DO UPDATE): name/reason обновляются, CreatedAt сохраняется.
row.Name = name;
row.Reason = reason;
}
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task RemoveBlacklistAsync(string dialogId, CancellationToken ct)
{
await _dbContext.DiscBlacklist.Where(entry => entry.DialogId == dialogId).ExecuteDeleteAsync(ct);
}
/// <inheritdoc />
public async Task<DiscoveryBlacklistDto?> GetBlacklistAsync(string dialogId, CancellationToken ct)
{
DiscBlacklistEntity? row = await _dbContext.DiscBlacklist
.AsNoTracking()
.FirstOrDefaultAsync(entry => entry.DialogId == dialogId, ct);
return row is null ? null : ToBlacklistDto(row);
}
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryBlacklistDto>> ListBlacklistAsync(CancellationToken ct)
{
List<DiscBlacklistEntity> rows = await _dbContext.DiscBlacklist
.AsNoTracking()
.OrderByDescending(entry => entry.CreatedAt)
.ToListAsync(ct);
return rows.Select(ToBlacklistDto).ToList();
}
}
@@ -1,158 +1,162 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Кандидаты Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего файла,
/// поведение не менялось): список/чтение кандидатов (DiscCandidates), мониторинг диалога и чёрный список,
/// создание/патч/статусы joined/rejected и счётчик сбоев вступлений.
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryCandidateDto>> ListCandidatesAsync(string taskId, string? status, CancellationToken ct)
{
IQueryable<DiscCandidateEntity> query = _dbContext.DiscCandidates.AsNoTracking().Where(candidate => candidate.TaskId == taskId);
if (status is not null)
{
query = query.Where(candidate => candidate.Status == status);
}
List<DiscCandidateEntity> rows = await query.OrderBy(candidate => candidate.CreatedAt).ToListAsync(ct);
return rows.Select(ToCandidateDto).ToList();
}
/// <inheritdoc />
public async Task<DiscoveryCandidateDto?> GetCandidateAsync(string dialogId, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.AsNoTracking()
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
return row is null ? null : ToCandidateDto(row);
}
/// <inheritdoc />
public async Task<bool> IsDialogMonitoredAsync(string dialogId, CancellationToken ct)
{
return await _dbContext.Dialogs.AnyAsync(dialog => dialog.Id == dialogId, ct);
}
/// <inheritdoc />
public Task<bool> IsBlacklistedAsync(string dialogId, CancellationToken ct)
{
return _dbContext.DiscBlacklist.AnyAsync(row => row.DialogId == dialogId, ct);
}
/// <inheritdoc />
public async Task CreateCandidateAsync(DiscoveryCandidateRow row, CancellationToken ct)
{
DateTimeOffset now = DateTimeOffset.UtcNow;
_dbContext.DiscCandidates.Add(new DiscCandidateEntity
{
DialogId = row.DialogId,
TaskId = row.TaskId,
Name = row.Name,
Username = row.Username,
Kind = row.Kind,
Hue = row.Hue,
Status = "new",
CreatedAt = now,
UpdatedAt = now,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task DeleteCandidateAsync(string dialogId, CancellationToken ct)
{
await _dbContext.DiscCandidates.Where(candidate => candidate.DialogId == dialogId).ExecuteDeleteAsync(ct);
}
/// <inheritdoc />
public async Task<bool> PatchCandidateAsync(string dialogId, DiscoveryCandidatePatch patch, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
ApplyCandidatePatch(row, patch);
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetCandidateStatusAsync(string dialogId, string status, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
row.Status = status;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetCandidateJoinedAsync(string dialogId, bool autoJoined, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
// mark_joined L531534: status=joined + auto_joined.
row.Status = "joined";
row.AutoJoined = autoJoined;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<int?> IncrementJoinFailuresAsync(string dialogId, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null || row.Status != "review")
{
// воркер L404–416: счётчик и удаление трогаем только у живой записи в статусе review.
return null;
}
row.JoinFailures += 1;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return row.JoinFailures;
}
/// <inheritdoc />
public async Task<bool> SetCandidateRejectedAsync(string dialogId, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
row.Status = "rejected";
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Кандидаты Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего файла,
/// поведение не менялось): список/чтение кандидатов (DiscCandidates), мониторинг диалога и чёрный список,
/// создание/патч/статусы joined/rejected и счётчик сбоев вступлений.
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryCandidateDto>> ListCandidatesAsync(string taskId, string? status, CancellationToken ct)
{
IQueryable<DiscCandidateEntity> query = _dbContext.DiscCandidates.AsNoTracking().Where(candidate => candidate.TaskId == taskId);
if (status is not null)
{
query = query.Where(candidate => candidate.Status == status);
}
List<DiscCandidateEntity> rows = await query.OrderBy(candidate => candidate.CreatedAt).ToListAsync(ct);
return rows.Select(ToCandidateDto).ToList();
}
/// <inheritdoc />
public async Task<DiscoveryCandidateDto?> GetCandidateAsync(string dialogId, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.AsNoTracking()
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
return row is null ? null : ToCandidateDto(row);
}
/// <inheritdoc />
public async Task<bool> IsDialogMonitoredAsync(string dialogId, CancellationToken ct)
{
return await _dbContext.Dialogs.AnyAsync(dialog => dialog.Id == dialogId, ct);
}
/// <inheritdoc />
public Task<bool> IsBlacklistedAsync(string dialogId, CancellationToken ct)
{
return _dbContext.DiscBlacklist.AnyAsync(row => row.DialogId == dialogId, ct);
}
/// <inheritdoc />
public async Task CreateCandidateAsync(DiscoveryCandidateRow row, CancellationToken ct)
{
DateTimeOffset now = DateTimeOffset.UtcNow;
_dbContext.DiscCandidates.Add(new DiscCandidateEntity
{
DialogId = row.DialogId,
TaskId = row.TaskId,
Name = row.Name,
Username = row.Username,
Kind = row.Kind,
Hue = row.Hue,
Status = "new",
CreatedAt = now,
UpdatedAt = now,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task DeleteCandidateAsync(string dialogId, CancellationToken ct)
{
await _dbContext.DiscCandidates.Where(candidate => candidate.DialogId == dialogId).ExecuteDeleteAsync(ct);
}
/// <inheritdoc />
public async Task<bool> PatchCandidateAsync(string dialogId, DiscoveryCandidatePatch patch, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
ApplyCandidatePatch(row, patch);
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetCandidateStatusAsync(string dialogId, string status, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
row.Status = status;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetCandidateJoinedAsync(string dialogId, bool autoJoined, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
// mark_joined L531534: status=joined + auto_joined.
row.Status = "joined";
row.AutoJoined = autoJoined;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<int?> IncrementJoinFailuresAsync(string dialogId, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null || row.Status != "review")
{
// воркер L404–416: счётчик и удаление трогаем только у живой записи в статусе review.
return null;
}
row.JoinFailures += 1;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return row.JoinFailures;
}
/// <inheritdoc />
public async Task<bool> SetCandidateRejectedAsync(string dialogId, CancellationToken ct)
{
DiscCandidateEntity? row = await _dbContext.DiscCandidates
.FirstOrDefaultAsync(candidate => candidate.DialogId == dialogId, ct);
if (row is null)
{
return false;
}
row.Status = "rejected";
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
}
@@ -1,47 +1,51 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Лог Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего файла,
/// поведение не менялось): запись события, счётчик событий с начала суток (квота вступлений) и лог задачи.
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task AddLogAsync(string logId, string taskId, string logEvent, string text, CancellationToken ct)
{
_dbContext.DiscLog.Add(new DiscLogEntity
{
Id = logId,
TaskId = taskId,
Event = logEvent,
Text = text,
CreatedAt = DateTimeOffset.UtcNow,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task<int> CountLogEventAsync(string logEvent, DateTimeOffset sinceUtc, CancellationToken ct)
{
// ban_guard.joins_today_auto L2935: число событий лога по типу с начала UTC-суток (счётчик квоты).
return await _dbContext.DiscLog.CountAsync(row => row.Event == logEvent && row.CreatedAt >= sinceUtc, ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryLogDto>> ListTaskLogAsync(string taskId, int limit, CancellationToken ct)
{
List<DiscLogEntity> rows = await _dbContext.DiscLog
.AsNoTracking()
.Where(log => log.TaskId == taskId)
.OrderByDescending(log => log.CreatedAt)
.Take(limit)
.ToListAsync(ct);
return rows.Select(ToLogDto).ToList();
}
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Лог Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего файла,
/// поведение не менялось): запись события, счётчик событий с начала суток (квота вступлений) и лог задачи.
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task AddLogAsync(string logId, string taskId, string logEvent, string text, CancellationToken ct)
{
_dbContext.DiscLog.Add(new DiscLogEntity
{
Id = logId,
TaskId = taskId,
Event = logEvent,
Text = text,
CreatedAt = DateTimeOffset.UtcNow,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task<int> CountLogEventAsync(string logEvent, DateTimeOffset sinceUtc, CancellationToken ct)
{
// ban_guard.joins_today_auto L2935: число событий лога по типу с начала UTC-суток (счётчик квоты).
return await _dbContext.DiscLog.CountAsync(row => row.Event == logEvent && row.CreatedAt >= sinceUtc, ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryLogDto>> ListTaskLogAsync(string taskId, int limit, CancellationToken ct)
{
List<DiscLogEntity> rows = await _dbContext.DiscLog
.AsNoTracking()
.Where(log => log.TaskId == taskId)
.OrderByDescending(log => log.CreatedAt)
.Take(limit)
.ToListAsync(ct);
return rows.Select(ToLogDto).ToList();
}
}
@@ -1,217 +1,221 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Задачи Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего файла,
/// поведение не менялось): CRUD задач (DiscTasks), состояние running/paused/done, атомарные инкременты
/// счётчиков и сдвиг поиска, сумма плана (discovery.py db.py; Ruling 9, Task 17).
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryTaskDto>> ListTasksAsync(CancellationToken ct)
{
List<DiscTaskEntity> rows = await _dbContext.DiscTasks
.AsNoTracking()
.OrderBy(task => task.CreatedAt)
.ToListAsync(ct);
return rows.Select(ToTaskDto).ToList();
}
/// <inheritdoc />
public async Task<DiscoveryTaskDto?> GetTaskAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.AsNoTracking()
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
return row is null ? null : ToTaskDto(row);
}
/// <inheritdoc />
public async Task CreateTaskAsync(DiscoveryTaskRow row, CancellationToken ct)
{
DateTimeOffset now = DateTimeOffset.UtcNow;
_dbContext.DiscTasks.Add(new DiscTaskEntity
{
Id = row.Id,
Name = row.Name,
Description = row.Description,
KeywordsJson = ToJson(row.Keywords),
MinSubscribers = row.MinSubscribers,
Lang = row.Lang,
Threshold = row.Threshold,
SampleSize = row.SampleSize,
PlanJoins = row.PlanJoins,
AutoJoin = row.AutoJoin,
Status = "draft",
CreatedAt = now,
UpdatedAt = now,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task<bool> PatchTaskAsync(string taskId, DiscoveryTaskPatch patch, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
ApplyTaskPatch(row, patch);
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> DeleteTaskAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
// delete_task L314318: задача удаляется вместе с кандидатами и логом; чёрный список общий — не трогаем.
await _dbContext.DiscCandidates.Where(candidate => candidate.TaskId == taskId).ExecuteDeleteAsync(ct);
await _dbContext.DiscLog.Where(log => log.TaskId == taskId).ExecuteDeleteAsync(ct);
_dbContext.DiscTasks.Remove(row);
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetTaskRunningAsync(string taskId, bool resetProgress, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
row.Status = "running";
if (resetProgress)
{
// start_task L333339: повторный прогон завершённой/упавшей — свежий проход по ключам.
row.SearchIdx = 0;
row.SearchDone = false;
row.Found = 0;
row.Evaluated = 0;
row.Joined = 0;
row.Rejected = 0;
}
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetTaskPausedAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
row.Status = "paused";
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetTaskDoneAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
// воркер _finish_done L126136: план вступлений выполнен — status=done, бюджет планов освобождается.
row.Status = "done";
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> BumpTaskCounterAsync(string taskId, DiscoveryCounterField field, int n, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null || n <= 0)
{
return row is not null;
}
// bump_counter L359368: приращение счётчика + bump UpdatedAt (python читает и пишет абсолютное значение).
switch (field)
{
case DiscoveryCounterField.Found:
row.Found += n;
break;
case DiscoveryCounterField.Evaluated:
row.Evaluated += n;
break;
case DiscoveryCounterField.Joined:
row.Joined += n;
break;
case DiscoveryCounterField.Rejected:
row.Rejected += n;
break;
default:
throw new ArgumentOutOfRangeException(nameof(field), field, "Неизвестный счётчик задачи");
}
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> AdvanceSearchAsync(string taskId, int nextIndex, bool searchDone, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
// advance_search L371380: новый индекс и флаг завершения прохода (значения считает сервис).
row.SearchIdx = nextIndex;
row.SearchDone = searchDone;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<int> SumActivePlanAsync(string? excludeTaskId, CancellationToken ct)
{
IQueryable<DiscTaskEntity> query = _dbContext.DiscTasks
.Where(task => task.Status != "done" && task.Status != "failed");
if (excludeTaskId is not null)
{
query = query.Where(task => task.Id != excludeTaskId);
}
return await query.SumAsync(task => task.PlanJoins, ct);
}
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Задачи Discovery — partial-часть <see cref="DiscoveryStore"/> (C32: выделено из общего файла,
/// поведение не менялось): CRUD задач (DiscTasks), состояние running/paused/done, атомарные инкременты
/// счётчиков и сдвиг поиска, сумма плана (discovery.py db.py; Ruling 9, Task 17).
/// </summary>
public sealed partial class DiscoveryStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<DiscoveryTaskDto>> ListTasksAsync(CancellationToken ct)
{
List<DiscTaskEntity> rows = await _dbContext.DiscTasks
.AsNoTracking()
.OrderBy(task => task.CreatedAt)
.ToListAsync(ct);
return rows.Select(ToTaskDto).ToList();
}
/// <inheritdoc />
public async Task<DiscoveryTaskDto?> GetTaskAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.AsNoTracking()
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
return row is null ? null : ToTaskDto(row);
}
/// <inheritdoc />
public async Task CreateTaskAsync(DiscoveryTaskRow row, CancellationToken ct)
{
DateTimeOffset now = DateTimeOffset.UtcNow;
_dbContext.DiscTasks.Add(new DiscTaskEntity
{
Id = row.Id,
Name = row.Name,
Description = row.Description,
KeywordsJson = ToJson(row.Keywords),
MinSubscribers = row.MinSubscribers,
Lang = row.Lang,
Threshold = row.Threshold,
SampleSize = row.SampleSize,
PlanJoins = row.PlanJoins,
AutoJoin = row.AutoJoin,
Status = "draft",
CreatedAt = now,
UpdatedAt = now,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task<bool> PatchTaskAsync(string taskId, DiscoveryTaskPatch patch, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
ApplyTaskPatch(row, patch);
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> DeleteTaskAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
// delete_task L314318: задача удаляется вместе с кандидатами и логом; чёрный список общий — не трогаем.
await _dbContext.DiscCandidates.Where(candidate => candidate.TaskId == taskId).ExecuteDeleteAsync(ct);
await _dbContext.DiscLog.Where(log => log.TaskId == taskId).ExecuteDeleteAsync(ct);
_dbContext.DiscTasks.Remove(row);
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetTaskRunningAsync(string taskId, bool resetProgress, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
row.Status = "running";
if (resetProgress)
{
// start_task L333339: повторный прогон завершённой/упавшей — свежий проход по ключам.
row.SearchIdx = 0;
row.SearchDone = false;
row.Found = 0;
row.Evaluated = 0;
row.Joined = 0;
row.Rejected = 0;
}
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetTaskPausedAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
row.Status = "paused";
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> SetTaskDoneAsync(string taskId, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
// воркер _finish_done L126136: план вступлений выполнен — status=done, бюджет планов освобождается.
row.Status = "done";
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> BumpTaskCounterAsync(string taskId, DiscoveryCounterField field, int n, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null || n <= 0)
{
return row is not null;
}
// bump_counter L359368: приращение счётчика + bump UpdatedAt (python читает и пишет абсолютное значение).
switch (field)
{
case DiscoveryCounterField.Found:
row.Found += n;
break;
case DiscoveryCounterField.Evaluated:
row.Evaluated += n;
break;
case DiscoveryCounterField.Joined:
row.Joined += n;
break;
case DiscoveryCounterField.Rejected:
row.Rejected += n;
break;
default:
throw new ArgumentOutOfRangeException(nameof(field), field, "Неизвестный счётчик задачи");
}
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<bool> AdvanceSearchAsync(string taskId, int nextIndex, bool searchDone, CancellationToken ct)
{
DiscTaskEntity? row = await _dbContext.DiscTasks
.FirstOrDefaultAsync(task => task.Id == taskId, ct);
if (row is null)
{
return false;
}
// advance_search L371380: новый индекс и флаг завершения прохода (значения считает сервис).
row.SearchIdx = nextIndex;
row.SearchDone = searchDone;
row.UpdatedAt = DateTimeOffset.UtcNow;
await _dbContext.SaveChangesAsync(ct);
return true;
}
/// <inheritdoc />
public async Task<int> SumActivePlanAsync(string? excludeTaskId, CancellationToken ct)
{
IQueryable<DiscTaskEntity> query = _dbContext.DiscTasks
.Where(task => task.Status != "done" && task.Status != "failed");
if (excludeTaskId is not null)
{
query = query.Where(task => task.Id != excludeTaskId);
}
return await query.SumAsync(task => task.PlanJoins, ct);
}
}
@@ -1,219 +1,223 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер хранилища Discovery: таблицы DiscTasks/DiscCandidates/DiscBlacklist/DiscLog схемы тенанта (Ruling 9, Task 17).
/// </summary>
/// <remarks>
/// Реализация порта <see cref="IDiscoveryStore"/> на <see cref="TenantDbContext"/> (эталон TelegramStore/
/// KanbanStore). Семантика 1:1 с python discovery.py/db.py: INSERT со служебными дефолтами (draft/new/счётчики 0),
/// UPDATE присутствующих полей патча с bump UpdatedAt, атомарные инкременты счётчиков (bump_counter), upsert
/// чёрного списка (ON CONFLICT DO UPDATE name/reason при сохранённом CreatedAt), каскад delete_task
/// (задача + кандидаты + лог). JSON-колонки (keywords/marks/topics) — text с сериализованным JSON camelCase;
/// времена — timestamptz (DateTimeOffset), наружу epoch-ms. Чтение Dialogs (проверка «уже мониторится») — тот же
/// TenantDbContext (владелец каталога — модуль Telegram; доступ по БД, реверс-зависимостей нет).
/// C32: класс разделён на partial-файлы по агрегатам (DiscoveryStore.Tasks/Candidates/Blacklist/Logs.cs);
/// маппинг DTO ↔ строк остаётся в этом файле. Поведение и сигнатуры не менялись.
/// </remarks>
public sealed partial class DiscoveryStore : IDiscoveryStore
{
private readonly TenantDbContext _dbContext;
/// <summary>
/// Создаёт EF-адаптер хранилища Discovery (зависимости — tenant-контекст БД).
/// </summary>
/// <param name="dbContext">Scoped-контекст тенанта запроса (search_path).</param>
public DiscoveryStore(TenantDbContext dbContext)
{
_dbContext = dbContext;
}
// Опции JSON: camelCase для wire-форм Discovery (1:1 с §4.8; эталон KanbanStore JsonOptions).
private static readonly JsonSerializerOptions JsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
// Маппит строку задачи в DTO (task_view L116137; keywords — JSON-список, времена — epoch-ms).
private static DiscoveryTaskDto ToTaskDto(DiscTaskEntity row)
{
return new DiscoveryTaskDto(
row.Id,
row.Name,
row.Description,
FromJson<string>(row.KeywordsJson),
row.MinSubscribers,
row.Lang,
row.Threshold,
row.SampleSize,
row.PlanJoins,
row.AutoJoin,
row.Status,
row.SearchIdx,
row.SearchDone,
row.Found,
row.Evaluated,
row.Joined,
row.Rejected,
row.CreatedAt.ToUnixTimeMilliseconds(),
row.UpdatedAt.ToUnixTimeMilliseconds());
}
// Маппит строку кандидата в DTO (candidate_view L140158; marks/topics — JSON-списки).
private static DiscoveryCandidateDto ToCandidateDto(DiscCandidateEntity row)
{
return new DiscoveryCandidateDto(
row.DialogId,
row.TaskId,
row.Name,
row.Username,
row.Kind,
row.Hue,
row.Participants,
row.LangRu,
FromJson<string>(row.MarksJson),
FromJson<DiscoveryTopicDto>(row.TopicsJson),
row.FitRatio,
row.Status,
row.AutoJoined,
row.JoinFailures,
row.CreatedAt.ToUnixTimeMilliseconds(),
row.UpdatedAt.ToUnixTimeMilliseconds());
}
// Маппит строку чёрного списка в DTO (blacklist_view L161167).
private static DiscoveryBlacklistDto ToBlacklistDto(DiscBlacklistEntity row)
{
return new DiscoveryBlacklistDto(row.DialogId, row.Name, row.Reason, row.CreatedAt.ToUnixTimeMilliseconds());
}
// Маппит строку лога в DTO (log_view L170177).
private static DiscoveryLogDto ToLogDto(DiscLogEntity row)
{
return new DiscoveryLogDto(row.Id, row.TaskId, row.Event, row.Text, row.CreatedAt.ToUnixTimeMilliseconds());
}
// Применяет патч задачи к строке (patch_task L292310: только присутствующие поля; keywords — JSON).
private static void ApplyTaskPatch(DiscTaskEntity row, DiscoveryTaskPatch patch)
{
if (patch.Name is not null)
{
row.Name = patch.Name;
}
if (patch.Description is not null)
{
row.Description = patch.Description;
}
if (patch.Keywords is not null)
{
row.KeywordsJson = ToJson(patch.Keywords);
}
if (patch.MinSubscribers is int minSubscribers)
{
row.MinSubscribers = minSubscribers;
}
if (patch.Lang is not null)
{
row.Lang = patch.Lang;
}
if (patch.Threshold is int threshold)
{
row.Threshold = threshold;
}
if (patch.SampleSize is int sampleSize)
{
row.SampleSize = sampleSize;
}
if (patch.PlanJoins is int planJoins)
{
row.PlanJoins = planJoins;
}
if (patch.AutoJoin is bool autoJoin)
{
row.AutoJoin = autoJoin;
}
}
// Применяет патч кандидата к строке (set_candidate L468492; marks/topics — JSON-замена).
private static void ApplyCandidatePatch(DiscCandidateEntity row, DiscoveryCandidatePatch patch)
{
if (patch.Name is not null)
{
row.Name = patch.Name;
}
if (patch.Username is not null)
{
row.Username = patch.Username;
}
if (patch.Kind is not null)
{
row.Kind = patch.Kind;
}
if (patch.Hue is not null)
{
row.Hue = patch.Hue;
}
if (patch.Participants is int participants)
{
row.Participants = participants;
}
if (patch.LangRu is bool langRu)
{
row.LangRu = langRu;
}
if (patch.Marks is not null)
{
row.MarksJson = ToJson(patch.Marks);
}
if (patch.Topics is not null)
{
row.TopicsJson = ToJson(patch.Topics);
}
if (patch.FitRatio is double fitRatio)
{
row.FitRatio = fitRatio;
}
if (patch.AutoJoined is bool autoJoined)
{
row.AutoJoined = autoJoined;
}
}
// Разбирает JSON-массив колонки (повреждённая строка/не-массив → пустой список, python _loads L7377).
private static IReadOnlyList<T> FromJson<T>(string json)
{
try
{
return JsonSerializer.Deserialize<List<T>>(json, JsonOptions) ?? [];
}
catch (JsonException)
{
return [];
}
}
// Сериализует значение в JSON (camelCase, конвенция value_json).
private static string ToJson<T>(T value) => JsonSerializer.Serialize(value, JsonOptions);
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер хранилища Discovery: таблицы DiscTasks/DiscCandidates/DiscBlacklist/DiscLog схемы тенанта (Ruling 9, Task 17).
/// </summary>
/// <remarks>
/// Реализация порта <see cref="IDiscoveryStore"/> на <see cref="TenantDbContext"/> (эталон TelegramStore/
/// KanbanStore). Семантика 1:1 с python discovery.py/db.py: INSERT со служебными дефолтами (draft/new/счётчики 0),
/// UPDATE присутствующих полей патча с bump UpdatedAt, атомарные инкременты счётчиков (bump_counter), upsert
/// чёрного списка (ON CONFLICT DO UPDATE name/reason при сохранённом CreatedAt), каскад delete_task
/// (задача + кандидаты + лог). JSON-колонки (keywords/marks/topics) — text с сериализованным JSON camelCase;
/// времена — timestamptz (DateTimeOffset), наружу epoch-ms. Чтение Dialogs (проверка «уже мониторится») — тот же
/// TenantDbContext (владелец каталога — модуль Telegram; доступ по БД, реверс-зависимостей нет).
/// C32: класс разделён на partial-файлы по агрегатам (DiscoveryStore.Tasks/Candidates/Blacklist/Logs.cs);
/// маппинг DTO ↔ строк остаётся в этом файле. Поведение и сигнатуры не менялись.
/// </remarks>
public sealed partial class DiscoveryStore : IDiscoveryStore
{
private readonly TenantDbContext _dbContext;
/// <summary>
/// Создаёт EF-адаптер хранилища Discovery (зависимости — tenant-контекст БД).
/// </summary>
/// <param name="dbContext">Scoped-контекст тенанта запроса (search_path).</param>
public DiscoveryStore(TenantDbContext dbContext)
{
_dbContext = dbContext;
}
// Опции JSON: camelCase для wire-форм Discovery (1:1 с §4.8; эталон KanbanStore JsonOptions).
private static readonly JsonSerializerOptions JsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
// Маппит строку задачи в DTO (task_view L116137; keywords — JSON-список, времена — epoch-ms).
private static DiscoveryTaskDto ToTaskDto(DiscTaskEntity row)
{
return new DiscoveryTaskDto(
row.Id,
row.Name,
row.Description,
FromJson<string>(row.KeywordsJson),
row.MinSubscribers,
row.Lang,
row.Threshold,
row.SampleSize,
row.PlanJoins,
row.AutoJoin,
row.Status,
row.SearchIdx,
row.SearchDone,
row.Found,
row.Evaluated,
row.Joined,
row.Rejected,
row.CreatedAt.ToUnixTimeMilliseconds(),
row.UpdatedAt.ToUnixTimeMilliseconds());
}
// Маппит строку кандидата в DTO (candidate_view L140158; marks/topics — JSON-списки).
private static DiscoveryCandidateDto ToCandidateDto(DiscCandidateEntity row)
{
return new DiscoveryCandidateDto(
row.DialogId,
row.TaskId,
row.Name,
row.Username,
row.Kind,
row.Hue,
row.Participants,
row.LangRu,
FromJson<string>(row.MarksJson),
FromJson<DiscoveryTopicDto>(row.TopicsJson),
row.FitRatio,
row.Status,
row.AutoJoined,
row.JoinFailures,
row.CreatedAt.ToUnixTimeMilliseconds(),
row.UpdatedAt.ToUnixTimeMilliseconds());
}
// Маппит строку чёрного списка в DTO (blacklist_view L161167).
private static DiscoveryBlacklistDto ToBlacklistDto(DiscBlacklistEntity row)
{
return new DiscoveryBlacklistDto(row.DialogId, row.Name, row.Reason, row.CreatedAt.ToUnixTimeMilliseconds());
}
// Маппит строку лога в DTO (log_view L170177).
private static DiscoveryLogDto ToLogDto(DiscLogEntity row)
{
return new DiscoveryLogDto(row.Id, row.TaskId, row.Event, row.Text, row.CreatedAt.ToUnixTimeMilliseconds());
}
// Применяет патч задачи к строке (patch_task L292310: только присутствующие поля; keywords — JSON).
private static void ApplyTaskPatch(DiscTaskEntity row, DiscoveryTaskPatch patch)
{
if (patch.Name is not null)
{
row.Name = patch.Name;
}
if (patch.Description is not null)
{
row.Description = patch.Description;
}
if (patch.Keywords is not null)
{
row.KeywordsJson = ToJson(patch.Keywords);
}
if (patch.MinSubscribers is int minSubscribers)
{
row.MinSubscribers = minSubscribers;
}
if (patch.Lang is not null)
{
row.Lang = patch.Lang;
}
if (patch.Threshold is int threshold)
{
row.Threshold = threshold;
}
if (patch.SampleSize is int sampleSize)
{
row.SampleSize = sampleSize;
}
if (patch.PlanJoins is int planJoins)
{
row.PlanJoins = planJoins;
}
if (patch.AutoJoin is bool autoJoin)
{
row.AutoJoin = autoJoin;
}
}
// Применяет патч кандидата к строке (set_candidate L468492; marks/topics — JSON-замена).
private static void ApplyCandidatePatch(DiscCandidateEntity row, DiscoveryCandidatePatch patch)
{
if (patch.Name is not null)
{
row.Name = patch.Name;
}
if (patch.Username is not null)
{
row.Username = patch.Username;
}
if (patch.Kind is not null)
{
row.Kind = patch.Kind;
}
if (patch.Hue is not null)
{
row.Hue = patch.Hue;
}
if (patch.Participants is int participants)
{
row.Participants = participants;
}
if (patch.LangRu is bool langRu)
{
row.LangRu = langRu;
}
if (patch.Marks is not null)
{
row.MarksJson = ToJson(patch.Marks);
}
if (patch.Topics is not null)
{
row.TopicsJson = ToJson(patch.Topics);
}
if (patch.FitRatio is double fitRatio)
{
row.FitRatio = fitRatio;
}
if (patch.AutoJoined is bool autoJoined)
{
row.AutoJoined = autoJoined;
}
}
// Разбирает JSON-массив колонки (повреждённая строка/не-массив → пустой список, python _loads L7377).
private static IReadOnlyList<T> FromJson<T>(string json)
{
try
{
return JsonSerializer.Deserialize<List<T>>(json, JsonOptions) ?? [];
}
catch (JsonException)
{
return [];
}
}
// Сериализует значение в JSON (camelCase, конвенция value_json).
private static string ToJson<T>(T value) => JsonSerializer.Serialize(value, JsonOptions);
}
@@ -1,51 +1,53 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер KV-хранилища глобальных (системных) настроек оператора: таблица public.global_settings.
/// </summary>
/// <remarks>
/// Маппинг 1:1 со строкой таблицы: key/value/updated_at (сущность GlobalSettingEntity, системный
/// DealDbContext схемы public). Порт оперирует готовыми JSON-строками (сериализацию выполняет
/// владелец ключа), поэтому адаптер хранит значение как текст без интерпретации. <see cref="SetAsync"/>
/// пишет updated_at = UTC-now.
/// </remarks>
public sealed class GlobalSettingsStore(DealDbContext dbContext) : IGlobalSettingsStore
{
/// <inheritdoc />
public async Task<SettingValue?> GetAsync(string key, CancellationToken ct)
{
var entity = await dbContext.GlobalSettings
.AsNoTracking()
.SingleOrDefaultAsync(s => s.Key == key, ct);
return entity is null ? null : new SettingValue(entity.Key, entity.Value, entity.UpdatedAt);
}
/// <inheritdoc />
public async Task SetAsync(string key, string valueJson, CancellationToken ct)
{
// Upsert по ключу (PK): существующая строка обновляется, отсутствующая — добавляется.
GlobalSettingEntity? entity = await dbContext.GlobalSettings
.SingleOrDefaultAsync(s => s.Key == key, ct);
if (entity is null)
{
dbContext.GlobalSettings.Add(new GlobalSettingEntity
{
Key = key,
Value = valueJson,
UpdatedAt = DateTimeOffset.UtcNow,
});
}
else
{
entity.Value = valueJson;
entity.UpdatedAt = DateTimeOffset.UtcNow;
}
await dbContext.SaveChangesAsync(ct);
}
}
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер KV-хранилища глобальных (системных) настроек оператора: таблица public.global_settings.
/// </summary>
/// <remarks>
/// Маппинг 1:1 со строкой таблицы: key/value/updated_at (сущность GlobalSettingEntity, системный
/// DealDbContext схемы public). Порт оперирует готовыми JSON-строками (сериализацию выполняет
/// владелец ключа), поэтому адаптер хранит значение как текст без интерпретации. <see cref="SetAsync"/>
/// пишет updated_at = UTC-now.
/// </remarks>
public sealed class GlobalSettingsStore(DealDbContext dbContext) : IGlobalSettingsStore
{
/// <inheritdoc />
public async Task<SettingValue?> GetAsync(string key, CancellationToken ct)
{
var entity = await dbContext.GlobalSettings
.AsNoTracking()
.SingleOrDefaultAsync(s => s.Key == key, ct);
return entity is null ? null : new SettingValue(entity.Key, entity.Value, entity.UpdatedAt);
}
/// <inheritdoc />
public async Task SetAsync(string key, string valueJson, CancellationToken ct)
{
// Upsert по ключу (PK): существующая строка обновляется, отсутствующая — добавляется.
GlobalSettingEntity? entity = await dbContext.GlobalSettings
.SingleOrDefaultAsync(s => s.Key == key, ct);
if (entity is null)
{
dbContext.GlobalSettings.Add(new GlobalSettingEntity
{
Key = key,
Value = valueJson,
UpdatedAt = DateTimeOffset.UtcNow,
});
}
else
{
entity.Value = valueJson;
entity.UpdatedAt = DateTimeOffset.UtcNow;
}
await dbContext.SaveChangesAsync(ct);
}
}
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,7 +1,10 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,90 +1,93 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Комментарии и журнал действий — partial-часть <see cref="KanbanStore"/> (C32: выделено из общего
/// файла, поведение не менялось): LeadComments (список/добавление), CardMoves (запись/счётчик learning)
/// и few-shot-примеры разметки для ИИ (leads.py add_comment/_log_learning/_learning_examples).
/// </summary>
public sealed partial class KanbanStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<CardCommentDto>> ListCommentsAsync(string cardId, CancellationToken ct)
{
List<LeadCommentEntity> entities = await _dbContext.LeadComments
.AsNoTracking()
.Where(comment => comment.CardId == cardId)
.OrderBy(comment => comment.CreatedAt)
.ThenBy(comment => comment.Id)
.ToListAsync(ct);
return entities.Select(ToCommentDto).ToList();
}
/// <inheritdoc />
public async Task AddCommentAsync(string commentId, string cardId, string by, string text, CancellationToken ct)
{
// CreatedAt — UTC-now (leads.py add_comment L259265). Целостность ссылки на карточку держит FK:
// комментарий без карточки не запишется (404-семантику несуществующей карточки отдаёт сервис,
// прочитав карточку перед добавлением, — адаптеру возвращать нечего: порт void).
_dbContext.LeadComments.Add(new LeadCommentEntity
{
Id = commentId,
CardId = cardId,
By = by,
Text = text,
CreatedAt = DateTimeOffset.UtcNow,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task AddMoveAsync(CardMoveDto move, CancellationToken ct)
{
// Каждое действие пользователя пишет строку журнала (leads.py _log_learning L4044); счётчик
// learning = число записей CardMoves (Ruling 4). CreatedAt — UTC-now.
_dbContext.CardMoves.Add(new CardMoveEntity
{
Id = move.Id,
LeadId = move.LeadId,
Action = move.Action,
FromCol = move.FromCol,
ToCol = move.ToCol,
CreatedAt = DateTimeOffset.UtcNow,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public Task<int> CountMovesAsync(CancellationToken ct) => _dbContext.CardMoves.CountAsync(ct);
/// <inheritdoc />
public async Task<IReadOnlyList<AiMarkupExampleDto>> GetAiMarkupExamplesAsync(int limit, CancellationToken ct)
{
// Few-shot-примеры ИИ-классификации (pipeline.py _learning_examples L201215): join журнала с карточками,
// действия move/restore, цель не служебная (trash/archive), source_msg непустой, свежие первыми.
return await _dbContext.CardMoves
.AsNoTracking()
.Where(move => move.ToCol != null && move.ToCol != CardIds.Trash && move.ToCol != CardIds.Archive)
.Join(
_dbContext.Cards.AsNoTracking(),
move => move.LeadId,
card => card.Id,
(move, card) => new { move, card })
.Where(joined => (joined.move.Action == MoveAction || joined.move.Action == RestoreAction)
&& joined.card.SourceMsg.Length > 0)
.OrderByDescending(joined => joined.move.CreatedAt)
.Take(limit)
.Select(joined => new AiMarkupExampleDto(joined.card.SourceMsg, joined.move.ToCol!))
.ToListAsync(ct);
}
/// <inheritdoc />
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Комментарии и журнал действий — partial-часть <see cref="KanbanStore"/> (C32: выделено из общего
/// файла, поведение не менялось): LeadComments (список/добавление), CardMoves (запись/счётчик learning)
/// и few-shot-примеры разметки для ИИ (leads.py add_comment/_log_learning/_learning_examples).
/// </summary>
public sealed partial class KanbanStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<CardCommentDto>> ListCommentsAsync(string cardId, CancellationToken ct)
{
List<LeadCommentEntity> entities = await _dbContext.LeadComments
.AsNoTracking()
.Where(comment => comment.CardId == cardId)
.OrderBy(comment => comment.CreatedAt)
.ThenBy(comment => comment.Id)
.ToListAsync(ct);
return entities.Select(ToCommentDto).ToList();
}
/// <inheritdoc />
public async Task AddCommentAsync(string commentId, string cardId, string by, string text, CancellationToken ct)
{
// CreatedAt — UTC-now (leads.py add_comment L259265). Целостность ссылки на карточку держит FK:
// комментарий без карточки не запишется (404-семантику несуществующей карточки отдаёт сервис,
// прочитав карточку перед добавлением, — адаптеру возвращать нечего: порт void).
_dbContext.LeadComments.Add(new LeadCommentEntity
{
Id = commentId,
CardId = cardId,
By = by,
Text = text,
CreatedAt = DateTimeOffset.UtcNow,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task AddMoveAsync(CardMoveDto move, CancellationToken ct)
{
// Каждое действие пользователя пишет строку журнала (leads.py _log_learning L4044); счётчик
// learning = число записей CardMoves (Ruling 4). CreatedAt — UTC-now.
_dbContext.CardMoves.Add(new CardMoveEntity
{
Id = move.Id,
LeadId = move.LeadId,
Action = move.Action,
FromCol = move.FromCol,
ToCol = move.ToCol,
CreatedAt = DateTimeOffset.UtcNow,
});
await _dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public Task<int> CountMovesAsync(CancellationToken ct) => _dbContext.CardMoves.CountAsync(ct);
/// <inheritdoc />
public async Task<IReadOnlyList<AiMarkupExampleDto>> GetAiMarkupExamplesAsync(int limit, CancellationToken ct)
{
// Few-shot-примеры ИИ-классификации (pipeline.py _learning_examples L201215): join журнала с карточками,
// действия move/restore, цель не служебная (trash/archive), source_msg непустой, свежие первыми.
return await _dbContext.CardMoves
.AsNoTracking()
.Where(move => move.ToCol != null && move.ToCol != CardIds.Trash && move.ToCol != CardIds.Archive)
.Join(
_dbContext.Cards.AsNoTracking(),
move => move.LeadId,
card => card.Id,
(move, card) => new { move, card })
.Where(joined => (joined.move.Action == MoveAction || joined.move.Action == RestoreAction)
&& joined.card.SourceMsg.Length > 0)
.OrderByDescending(joined => joined.move.CreatedAt)
.Take(limit)
.Select(joined => new AiMarkupExampleDto(joined.card.SourceMsg, joined.move.ToCol!))
.ToListAsync(ct);
}
/// <inheritdoc />
}
@@ -2,8 +2,11 @@ using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,144 +1,147 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Правила хранения, конверсии и вход эвристики suggest — partial-часть <see cref="KanbanStore"/>
/// (C32: выделено из общего файла, поведение не менялось): кандидаты тика (автоархив/очистка архива и
/// корзины), batch-архивация и жёсткое удаление пачки, пересчёт бюджетных конверсий и «Неразобранное»
/// с исходным текстом для ИИ-предложений (tick_storage/recompute_conversions/suggest, Rulings 3/7/8).
/// </summary>
public sealed partial class KanbanStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<string>> ListArchiveCandidatesAsync(DateTimeOffset receivedBeforeUtc, CancellationToken ct)
{
// Кандидаты автоархива: карточки пользовательских колонок (kind=board) и «Неразобранного»
// (tick_storage L462467) — колонки динамические, поэтому id колонок читаем реестром контейнеров.
List<string> boardIds = await _dbContext.Containers
.AsNoTracking()
.Where(container => container.Kind == ContainerKinds.Board)
.Select(container => container.Id)
.ToListAsync(ct);
return await _dbContext.Cards
.AsNoTracking()
.Where(card => card.ReceivedAt < receivedBeforeUtc
&& (card.Col == CardIds.Inbox || boardIds.Contains(card.Col)))
.Select(card => card.Id)
.ToListAsync(ct);
}
/// <inheritdoc />
public async Task<int> ArchiveAsync(IReadOnlyList<string> cardIds, DateTimeOffset archivedAt, CancellationToken ct)
{
// Автоархив тика пачкой (tick_storage L462473): один UPDATE вместо N по-карточных — как по-карточный
// UpdateColumnAsync автоархива: col=archive, is_new=false, archived_at=now, matchHits пусто;
// prev_col не трогается (Ruling 8). Возврат — сколько строк обновлено.
if (cardIds.Count == 0)
{
return 0;
}
return await _dbContext.Cards
.Where(card => cardIds.Contains(card.Id))
.ExecuteUpdateAsync(setters => setters
.SetProperty(card => card.Col, CardIds.Archive)
.SetProperty(card => card.IsNew, false)
.SetProperty(card => card.ArchivedAt, archivedAt)
.SetProperty(card => card.MatchHitsJson, ToJson(Array.Empty<MatchHitDto>())),
ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<string>> ListExpiredArchiveCandidatesAsync(DateTimeOffset archivedBeforeUtc, CancellationToken ct)
{
// Очистка архива: col='archive' и archived_at старше срока (tick_storage L475478).
return await _dbContext.Cards
.AsNoTracking()
.Where(card => card.Col == CardIds.Archive
&& card.ArchivedAt != null
&& card.ArchivedAt < archivedBeforeUtc)
.Select(card => card.Id)
.ToListAsync(ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<string>> ListTrashCandidatesAsync(DateTimeOffset receivedBeforeUtc, CancellationToken ct)
{
// Очистка корзины: col='trash' и received_at старше срока (tick_storage L480483).
return await _dbContext.Cards
.AsNoTracking()
.Where(card => card.Col == CardIds.Trash && card.ReceivedAt < receivedBeforeUtc)
.Select(card => card.Id)
.ToListAsync(ct);
}
/// <inheritdoc />
public async Task<int> PurgeAsync(IReadOnlyList<string> cardIds, CancellationToken ct)
{
// Жёсткое удаление пачки (очистки тика и clear-col, Ruling 8): комментарии чистит каскад БД,
// строки дедупа удаляемых карточек — здесь же в транзакции (Ruling 3, _hard_delete L229).
if (cardIds.Count == 0)
{
return 0;
}
await using var transaction = await _dbContext.Database.BeginTransactionAsync(ct);
await _dbContext.DedupEntries
.Where(entry => entry.LeadId != null && cardIds.Contains(entry.LeadId!))
.ExecuteDeleteAsync(ct);
int deleted = await _dbContext.Cards
.Where(card => cardIds.Contains(card.Id))
.ExecuteDeleteAsync(ct);
await transaction.CommitAsync(ct);
return deleted;
}
/// <inheritdoc />
public async Task<IReadOnlyList<CardDto>> ListCardsForConversionAsync(CancellationToken ct)
{
// Карточки с бюджетом вне служебных колонок (recompute_conversions L106130, Ruling 7):
// пересчёт читает только бюджетные/conv-поля, комментарии не нужны.
List<CardEntity> entities = await _dbContext.Cards
.AsNoTracking()
.Where(card => card.BudgetCur != string.Empty
&& !ConversionExcludedCols.Contains(card.Col))
.OrderByDescending(card => card.ReceivedAt)
.ToListAsync(ct);
return entities.Select(card => ToCardDto(card, Array.Empty<CardCommentDto>())).ToList();
}
/// <inheritdoc />
public async Task UpdateConversionAsync(string cardId, double? convFrom, double? convTo, string convCur, CancellationToken ct)
{
// Пишутся только conv-поля карточки (Ruling 7); convCur пуст — конверсия снята.
await _dbContext.Cards
.Where(card => card.Id == cardId)
.ExecuteUpdateAsync(setters => setters
.SetProperty(card => card.ConvFrom, convFrom)
.SetProperty(card => card.ConvTo, convTo)
.SetProperty(card => card.ConvCur, convCur),
ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<CardDto>> ListInboxWithSourceAsync(CancellationToken ct)
{
// Вход эвристики suggest (Ruling 3): «Неразобранное» с непустым source_msg — только тексты нужны.
List<CardEntity> entities = await _dbContext.Cards
.AsNoTracking()
.Where(card => card.Col == CardIds.Inbox && card.SourceMsg != string.Empty)
.OrderByDescending(card => card.ReceivedAt)
.ToListAsync(ct);
return entities.Select(card => ToCardDto(card, Array.Empty<CardCommentDto>())).ToList();
}
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// Правила хранения, конверсии и вход эвристики suggest — partial-часть <see cref="KanbanStore"/>
/// (C32: выделено из общего файла, поведение не менялось): кандидаты тика (автоархив/очистка архива и
/// корзины), batch-архивация и жёсткое удаление пачки, пересчёт бюджетных конверсий и «Неразобранное»
/// с исходным текстом для ИИ-предложений (tick_storage/recompute_conversions/suggest, Rulings 3/7/8).
/// </summary>
public sealed partial class KanbanStore
{
/// <inheritdoc />
public async Task<IReadOnlyList<string>> ListArchiveCandidatesAsync(DateTimeOffset receivedBeforeUtc, CancellationToken ct)
{
// Кандидаты автоархива: карточки пользовательских колонок (kind=board) и «Неразобранного»
// (tick_storage L462467) — колонки динамические, поэтому id колонок читаем реестром контейнеров.
List<string> boardIds = await _dbContext.Containers
.AsNoTracking()
.Where(container => container.Kind == ContainerKinds.Board)
.Select(container => container.Id)
.ToListAsync(ct);
return await _dbContext.Cards
.AsNoTracking()
.Where(card => card.ReceivedAt < receivedBeforeUtc
&& (card.Col == CardIds.Inbox || boardIds.Contains(card.Col)))
.Select(card => card.Id)
.ToListAsync(ct);
}
/// <inheritdoc />
public async Task<int> ArchiveAsync(IReadOnlyList<string> cardIds, DateTimeOffset archivedAt, CancellationToken ct)
{
// Автоархив тика пачкой (tick_storage L462473): один UPDATE вместо N по-карточных — как по-карточный
// UpdateColumnAsync автоархива: col=archive, is_new=false, archived_at=now, matchHits пусто;
// prev_col не трогается (Ruling 8). Возврат — сколько строк обновлено.
if (cardIds.Count == 0)
{
return 0;
}
return await _dbContext.Cards
.Where(card => cardIds.Contains(card.Id))
.ExecuteUpdateAsync(setters => setters
.SetProperty(card => card.Col, CardIds.Archive)
.SetProperty(card => card.IsNew, false)
.SetProperty(card => card.ArchivedAt, archivedAt)
.SetProperty(card => card.MatchHitsJson, ToJson(Array.Empty<MatchHitDto>())),
ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<string>> ListExpiredArchiveCandidatesAsync(DateTimeOffset archivedBeforeUtc, CancellationToken ct)
{
// Очистка архива: col='archive' и archived_at старше срока (tick_storage L475478).
return await _dbContext.Cards
.AsNoTracking()
.Where(card => card.Col == CardIds.Archive
&& card.ArchivedAt != null
&& card.ArchivedAt < archivedBeforeUtc)
.Select(card => card.Id)
.ToListAsync(ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<string>> ListTrashCandidatesAsync(DateTimeOffset receivedBeforeUtc, CancellationToken ct)
{
// Очистка корзины: col='trash' и received_at старше срока (tick_storage L480483).
return await _dbContext.Cards
.AsNoTracking()
.Where(card => card.Col == CardIds.Trash && card.ReceivedAt < receivedBeforeUtc)
.Select(card => card.Id)
.ToListAsync(ct);
}
/// <inheritdoc />
public async Task<int> PurgeAsync(IReadOnlyList<string> cardIds, CancellationToken ct)
{
// Жёсткое удаление пачки (очистки тика и clear-col, Ruling 8): комментарии чистит каскад БД,
// строки дедупа удаляемых карточек — здесь же в транзакции (Ruling 3, _hard_delete L229).
if (cardIds.Count == 0)
{
return 0;
}
await using var transaction = await _dbContext.Database.BeginTransactionAsync(ct);
await _dbContext.DedupEntries
.Where(entry => entry.LeadId != null && cardIds.Contains(entry.LeadId!))
.ExecuteDeleteAsync(ct);
int deleted = await _dbContext.Cards
.Where(card => cardIds.Contains(card.Id))
.ExecuteDeleteAsync(ct);
await transaction.CommitAsync(ct);
return deleted;
}
/// <inheritdoc />
public async Task<IReadOnlyList<CardDto>> ListCardsForConversionAsync(CancellationToken ct)
{
// Карточки с бюджетом вне служебных колонок (recompute_conversions L106130, Ruling 7):
// пересчёт читает только бюджетные/conv-поля, комментарии не нужны.
List<CardEntity> entities = await _dbContext.Cards
.AsNoTracking()
.Where(card => card.BudgetCur != string.Empty
&& !ConversionExcludedCols.Contains(card.Col))
.OrderByDescending(card => card.ReceivedAt)
.ToListAsync(ct);
return entities.Select(card => ToCardDto(card, Array.Empty<CardCommentDto>())).ToList();
}
/// <inheritdoc />
public async Task UpdateConversionAsync(string cardId, double? convFrom, double? convTo, string convCur, CancellationToken ct)
{
// Пишутся только conv-поля карточки (Ruling 7); convCur пуст — конверсия снята.
await _dbContext.Cards
.Where(card => card.Id == cardId)
.ExecuteUpdateAsync(setters => setters
.SetProperty(card => card.ConvFrom, convFrom)
.SetProperty(card => card.ConvTo, convTo)
.SetProperty(card => card.ConvCur, convCur),
ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<CardDto>> ListInboxWithSourceAsync(CancellationToken ct)
{
// Вход эвристики suggest (Ruling 3): «Неразобранное» с непустым source_msg — только тексты нужны.
List<CardEntity> entities = await _dbContext.Cards
.AsNoTracking()
.Where(card => card.Col == CardIds.Inbox && card.SourceMsg != string.Empty)
.OrderByDescending(card => card.ReceivedAt)
.ToListAsync(ct);
return entities.Select(card => ToCardDto(card, Array.Empty<CardCommentDto>())).ToList();
}
}
@@ -1,320 +1,323 @@
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер хранилища карточек и контейнеров (Ruling 1/12): таблицы Cards/Containers/LeadComments/CardMoves схемы тенанта.
/// </summary>
/// <remarks>
/// Маппинг DTO ↔ строк выполняется вручную (эталон SettingsStore.cs): порт модуля не видит EF-сущности.
/// JSON-поля (KeywordsJson/VisibleFieldsJson/RulesJson, StackJson/ContactsJson/MatchHitsJson) хранятся текстом
/// с сериализованным JSON camelCase (конвенция value_json) — адаптер сериализует при записи и разбирает при чтении.
/// Времена — timestamptz (DateTimeOffset); наружу карточки отдают receivedAt epoch-ms (ToUnixTimeMilliseconds),
/// а human-метку «time» адаптер считает на лету от ReceivedAt/CreatedAt (Ruling 10, pipeline.py human_age L528537).
/// Чтения — AsNoTracking; сортировки (received_at DESC и т.п.) — здесь, как требует порт. Id записей генерирует
/// модуль (Ruling 12) — адаптер только сохраняет готовые id. Транзакции: одиночная запись — SaveChanges
/// (ExecuteUpdate/ExecuteDelete — одним statement'ом); методы с несколькими изменениями (DeleteContainerAsync:
/// карточки + доска; ReorderContainersAsync: позиции всех досок) обёрнуты в явную транзакцию.
/// Удаление карточки чистит комментарии каскадом БД (FK LeadComments → Cards, Ruling 1); журнал CardMoves
/// и MlOutbox при удалении карточек не трогаются (прототип _hard_delete). Строки DedupEntries карточки
/// (LeadId = id карточки) удаляются вместе с ней в той же транзакции (Ruling 3) — «сирота» не должна
/// блокировать повторное создание карточки; таблицы соседние в том же TenantDbContext, порт Pipeline
/// не привлекается (циклов модулей нет).
/// C32: класс разделён на partial-файлы по темам (KanbanStore.Containers/Cards/Selected/Comments/StorageRules.cs);
/// поведение, сигнатуры и тексты ошибок не менялись.
/// </remarks>
public sealed partial class KanbanStore : ICardStore
{
private readonly TenantDbContext _dbContext;
/// <summary>
/// Создаёт EF-адаптер хранилища канбана (зависимости — tenant-контекст БД).
/// </summary>
/// <param name="dbContext">Контекст схемы тенанта (Containers/Cards/LeadComments/CardMoves/DedupEntries).</param>
public KanbanStore(TenantDbContext dbContext)
{
_dbContext = dbContext;
}
// JSON-представление «правил нет» (в DTO — null Rules, Ruling 1: как value_json настроек).
private const string NoRulesJson = "{}";
// Действие журнала CardMoves «перенос» (источник few-shot-примеров, python move).
private const string MoveAction = "move";
// Действие журнала CardMoves «возврат из корзины/архива» (python restore).
private const string RestoreAction = "restore";
private const long MillisPerMinute = 60_000L;
private const long MinutesPerHour = 60L;
private const long HoursPerDay = 24L;
// Колонки, исключённые из пересчёта конверсий (recompute_conversions L106130, Ruling 7).
private static readonly string[] ConversionExcludedCols =
[CardIds.Archive, CardIds.Trash];
// Id контейнеров-стадий пространства «Выбранные»: дашборд эти карточки не показывает (этап 9).
private static readonly string[] SelectedStageIds = CardsDefaultContainers.Ids.ToArray();
// Стадия «Отложено» — единственная, чьи напоминания проверяет проверка напоминаний (Ruling 3).
private const string HoldStage = CardsDefaultContainers.Hold;
// Опции JSON: camelCase для записей модуля Kanban (1:1 с wire-именами §4.1/§4.2).
private static readonly JsonSerializerOptions JsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
// Читает карточки пачкой с приложенными комментариями (один запрос на все id).
// cards: Карточки (уже отсортированы запросом чтения).
// ct: Токен отмены.
// Возвращает: DTO карточек в порядке входа: JSON-поля разобраны, комментарии приложены, time посчитан.
private async Task<IReadOnlyList<CardDto>> ToCardDtosAsync(List<CardEntity> cards, CancellationToken ct)
{
if (cards.Count == 0)
{
return Array.Empty<CardDto>();
}
List<string> cardIds = cards.Select(card => card.Id).ToList();
List<LeadCommentEntity> comments = await _dbContext.LeadComments
.AsNoTracking()
.Where(comment => cardIds.Contains(comment.CardId))
.OrderBy(comment => comment.CreatedAt)
.ThenBy(comment => comment.Id)
.ToListAsync(ct);
ILookup<string, LeadCommentEntity> commentsByCardId = comments.ToLookup(comment => comment.CardId);
return cards
.Select(card => ToCardDto(card, commentsByCardId[card.Id].Select(ToCommentDto).ToList()))
.ToList();
}
// Маппинг строки Containers в DTO (JSON-поля разбираются).
private static ContainerDto ToContainerDto(ContainerEntity entity) => new()
{
Id = entity.Id,
Name = entity.Name,
Description = entity.Description,
Color = entity.Color,
Order = entity.Position,
Space = entity.Space,
Kind = entity.Kind,
Collapsed = entity.Collapsed,
Suggested = entity.Suggested,
Rules = ToRulesOrNull(entity.RulesJson),
Policy = ToPolicyOrEmpty(entity.PolicyJson),
Note = entity.Note,
};
// Маппинг DTO в строку Containers (JSON-поля сериализуются; CreatedAt — UTC-now).
private static ContainerEntity ToContainerEntity(ContainerDto container) => new()
{
Id = container.Id,
Name = container.Name,
Description = container.Description,
Color = container.Color,
Position = container.Order,
Space = container.Space,
Kind = container.Kind,
Collapsed = container.Collapsed,
Suggested = container.Suggested,
RulesJson = ToRulesJson(container.Rules),
PolicyJson = ToPolicyJson(container.Policy),
Note = container.Note,
CreatedAt = DateTimeOffset.UtcNow,
};
// Маппинг строки Cards в DTO: JSON-поля разобраны, budget/converted собраны из пар (from,to,cur).
// entity: Строка карточки.
// comments: Комментарии карточки (уже в DTO с human-меткой time).
private static CardDto ToCardDto(CardEntity entity, IReadOnlyList<CardCommentDto> comments) => new()
{
Id = entity.Id,
Col = entity.Col,
IsNew = entity.IsNew,
Local = entity.Local,
IsVacancy = entity.IsVacancy,
IsVacancyKnown = entity.IsVacancyKnown,
Title = entity.Title,
Summary = entity.Summary,
Source = new CardSourceDto(
Kind: ResolveSourceKind(entity),
DisplayName: entity.ChannelName,
OriginRef: entity.SourceDialogId,
ReceivedAt: entity.ReceivedAt.ToUnixTimeMilliseconds()),
Stack = ToJsonList<string>(entity.StackJson),
Budget = entity.BudgetCur.Length == 0
? null
: new CardBudgetDto(entity.BudgetFrom, entity.BudgetTo, entity.BudgetCur),
Converted = entity.ConvCur.Length == 0
? null
: new CardBudgetDto(entity.ConvFrom, entity.ConvTo, entity.ConvCur),
Contact = entity.Contact,
Contacts = ToJsonList<CardContactDto>(entity.ContactsJson),
Channel = new CardChannelDto(entity.ChannelName, entity.ChannelHandle, entity.ChannelHue),
Time = HumanAge(entity.ReceivedAt),
ReceivedAtMs = entity.ReceivedAt.ToUnixTimeMilliseconds(),
SourceMsg = entity.SourceMsg,
SourceDialogId = entity.SourceDialogId,
SourceMsgId = entity.SourceMsgId,
PrevCol = entity.PrevCol,
MatchHits = ToJsonList<MatchHitDto>(entity.MatchHitsJson),
Comments = comments,
Links = ToJsonList<CardLinkDto>(entity.LinksJson),
Files = ToJsonList<CardFileDto>(entity.FilesJson),
History = ToJsonList<CardHistoryDto>(entity.HistoryJson),
TzText = entity.TzText,
Reminder = entity.ReminderAt is { } reminderAt ? new CardReminderDto(reminderAt.ToUnixTimeMilliseconds()) : null,
CreatedAtMs = entity.CreatedAt.ToUnixTimeMilliseconds(),
UpdatedAtMs = entity.UpdatedAt.ToUnixTimeMilliseconds(),
};
// Вид источника карточки (производная проекция): local/telegram/other.
// entity: Строка карточки.
// Возвращает: Вид источника (строка wire-контракта).
private static string ResolveSourceKind(CardEntity entity)
{
if (entity.Local)
{
return "local";
}
return entity.ChannelName.Length > 0 || entity.SourceDialogId.Length > 0 ? "telegram" : "other";
}
// Маппинг снимка (write-модель создания карточки) в строку Cards; CreatedAt — UTC-now.
private static CardEntity ToCardEntity(CardSnapshot snapshot) => new()
{
Id = snapshot.Id,
Col = snapshot.Col,
IsNew = snapshot.IsNew,
Local = snapshot.Local,
IsVacancy = snapshot.IsVacancy,
IsVacancyKnown = snapshot.IsVacancyKnown,
Title = snapshot.Title,
Summary = snapshot.Summary,
StackJson = ToJson(snapshot.Stack),
BudgetFrom = snapshot.BudgetFrom,
BudgetTo = snapshot.BudgetTo,
BudgetCur = snapshot.BudgetCur,
ConvFrom = snapshot.ConvFrom,
ConvTo = snapshot.ConvTo,
ConvCur = snapshot.ConvCur,
Contact = snapshot.Contact,
ContactsJson = ToJson(snapshot.Contacts),
ChannelName = snapshot.ChannelName,
ChannelHandle = snapshot.ChannelHandle,
ChannelHue = snapshot.ChannelHue,
ReceivedAt = snapshot.ReceivedAt,
SourceMsg = snapshot.SourceMsg,
SourceDialogId = snapshot.SourceDialogId,
SourceMsgId = snapshot.SourceMsgId,
PrevCol = snapshot.PrevCol,
ArchivedAt = snapshot.ArchivedAt,
MatchHitsJson = ToJson(snapshot.MatchHits),
TzText = snapshot.TzText,
HistoryJson = ToJson(snapshot.History),
CreatedAt = DateTimeOffset.UtcNow,
UpdatedAt = DateTimeOffset.UtcNow,
};
// Маппинг строки LeadComments в DTO (human-метка time от CreatedAt, Ruling 10).
private static CardCommentDto ToCommentDto(LeadCommentEntity entity) =>
new(entity.Id, entity.By, entity.Text, HumanAge(entity.CreatedAt));
// Человеческая метка возраста: «только что»/«N мин»/«N ч»/«N дн» (Ruling 10, pipeline.py human_age L528537).
// timestamp: Время события (получения сообщения/добавления комментария).
// Возвращает: Метка от текущего UTC-момента; будущее время даёт «только что» (delta зажат в 0, как в прототипе).
private static string HumanAge(DateTimeOffset timestamp)
{
long deltaMs = Math.Max(0, DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() - timestamp.ToUnixTimeMilliseconds());
long minutes = deltaMs / MillisPerMinute;
if (minutes < MinutesPerHour)
{
return minutes < 1 ? CardsService.JustNowLabel : $"{minutes} мин";
}
long hours = minutes / MinutesPerHour;
if (hours < HoursPerDay)
{
return $"{hours} ч";
}
long days = hours / HoursPerDay;
return $"{days} дн";
}
// Разбирает JSON-массив в список; пустая/битая строка — пустой список (как json.loads в прототипе).
private static IReadOnlyList<T> ToJsonList<T>(string json)
{
if (string.IsNullOrWhiteSpace(json))
{
return Array.Empty<T>();
}
try
{
return JsonSerializer.Deserialize<List<T>>(json, JsonOptions) ?? [];
}
catch (JsonException)
{
return Array.Empty<T>();
}
}
// Разбирает rules-объект: {}/пустая/битая строка — null («правил нет»).
private static ContainerRulesDto? ToRulesOrNull(string json)
{
if (string.IsNullOrWhiteSpace(json) || json == NoRulesJson)
{
return null;
}
try
{
return JsonSerializer.Deserialize<ContainerRulesDto>(json, JsonOptions);
}
catch (JsonException)
{
return null;
}
}
// Сериализует rules-объект: null («правил нет») хранится как {}.
private static string ToRulesJson(ContainerRulesDto? rules) =>
rules is null ? NoRulesJson : JsonSerializer.Serialize(rules, JsonOptions);
// Разбирает policy-объект: пустая/битая строка — политика по умолчанию (обычная колонка).
private static ContainerPolicyDto ToPolicyOrEmpty(string json)
{
if (string.IsNullOrWhiteSpace(json) || json == NoRulesJson)
{
return new ContainerPolicyDto();
}
try
{
return JsonSerializer.Deserialize<ContainerPolicyDto>(json, JsonOptions) ?? new ContainerPolicyDto();
}
catch (JsonException)
{
return new ContainerPolicyDto();
}
}
// Сериализует policy-объект в JSON (camelCase, конвенция value_json).
private static string ToPolicyJson(ContainerPolicyDto policy) => JsonSerializer.Serialize(policy, JsonOptions);
// Сериализует значение в JSON (camelCase, конвенция value_json).
private static string ToJson<T>(T value) => JsonSerializer.Serialize(value, JsonOptions);
}
using System.Text.Json;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер хранилища карточек и контейнеров (Ruling 1/12): таблицы Cards/Containers/LeadComments/CardMoves схемы тенанта.
/// </summary>
/// <remarks>
/// Маппинг DTO ↔ строк выполняется вручную (эталон SettingsStore.cs): порт модуля не видит EF-сущности.
/// JSON-поля (KeywordsJson/VisibleFieldsJson/RulesJson, StackJson/ContactsJson/MatchHitsJson) хранятся текстом
/// с сериализованным JSON camelCase (конвенция value_json) — адаптер сериализует при записи и разбирает при чтении.
/// Времена — timestamptz (DateTimeOffset); наружу карточки отдают receivedAt epoch-ms (ToUnixTimeMilliseconds),
/// а human-метку «time» адаптер считает на лету от ReceivedAt/CreatedAt (Ruling 10, pipeline.py human_age L528537).
/// Чтения — AsNoTracking; сортировки (received_at DESC и т.п.) — здесь, как требует порт. Id записей генерирует
/// модуль (Ruling 12) — адаптер только сохраняет готовые id. Транзакции: одиночная запись — SaveChanges
/// (ExecuteUpdate/ExecuteDelete — одним statement'ом); методы с несколькими изменениями (DeleteContainerAsync:
/// карточки + доска; ReorderContainersAsync: позиции всех досок) обёрнуты в явную транзакцию.
/// Удаление карточки чистит комментарии каскадом БД (FK LeadComments → Cards, Ruling 1); журнал CardMoves
/// и MlOutbox при удалении карточек не трогаются (прототип _hard_delete). Строки DedupEntries карточки
/// (LeadId = id карточки) удаляются вместе с ней в той же транзакции (Ruling 3) — «сирота» не должна
/// блокировать повторное создание карточки; таблицы соседние в том же TenantDbContext, порт Pipeline
/// не привлекается (циклов модулей нет).
/// C32: класс разделён на partial-файлы по темам (KanbanStore.Containers/Cards/Selected/Comments/StorageRules.cs);
/// поведение, сигнатуры и тексты ошибок не менялись.
/// </remarks>
public sealed partial class KanbanStore : ICardStore
{
private readonly TenantDbContext _dbContext;
/// <summary>
/// Создаёт EF-адаптер хранилища канбана (зависимости — tenant-контекст БД).
/// </summary>
/// <param name="dbContext">Контекст схемы тенанта (Containers/Cards/LeadComments/CardMoves/DedupEntries).</param>
public KanbanStore(TenantDbContext dbContext)
{
_dbContext = dbContext;
}
// JSON-представление «правил нет» (в DTO — null Rules, Ruling 1: как value_json настроек).
private const string NoRulesJson = "{}";
// Действие журнала CardMoves «перенос» (источник few-shot-примеров, python move).
private const string MoveAction = "move";
// Действие журнала CardMoves «возврат из корзины/архива» (python restore).
private const string RestoreAction = "restore";
private const long MillisPerMinute = 60_000L;
private const long MinutesPerHour = 60L;
private const long HoursPerDay = 24L;
// Колонки, исключённые из пересчёта конверсий (recompute_conversions L106130, Ruling 7).
private static readonly string[] ConversionExcludedCols =
[CardIds.Archive, CardIds.Trash];
// Id контейнеров-стадий пространства «Выбранные»: дашборд эти карточки не показывает (этап 9).
private static readonly string[] SelectedStageIds = CardsDefaultContainers.Ids.ToArray();
// Стадия «Отложено» — единственная, чьи напоминания проверяет проверка напоминаний (Ruling 3).
private const string HoldStage = CardsDefaultContainers.Hold;
// Опции JSON: camelCase для записей модуля Kanban (1:1 с wire-именами §4.1/§4.2).
private static readonly JsonSerializerOptions JsonOptions = new()
{
PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
PropertyNameCaseInsensitive = true,
};
// Читает карточки пачкой с приложенными комментариями (один запрос на все id).
// cards: Карточки (уже отсортированы запросом чтения).
// ct: Токен отмены.
// Возвращает: DTO карточек в порядке входа: JSON-поля разобраны, комментарии приложены, time посчитан.
private async Task<IReadOnlyList<CardDto>> ToCardDtosAsync(List<CardEntity> cards, CancellationToken ct)
{
if (cards.Count == 0)
{
return Array.Empty<CardDto>();
}
List<string> cardIds = cards.Select(card => card.Id).ToList();
List<LeadCommentEntity> comments = await _dbContext.LeadComments
.AsNoTracking()
.Where(comment => cardIds.Contains(comment.CardId))
.OrderBy(comment => comment.CreatedAt)
.ThenBy(comment => comment.Id)
.ToListAsync(ct);
ILookup<string, LeadCommentEntity> commentsByCardId = comments.ToLookup(comment => comment.CardId);
return cards
.Select(card => ToCardDto(card, commentsByCardId[card.Id].Select(ToCommentDto).ToList()))
.ToList();
}
// Маппинг строки Containers в DTO (JSON-поля разбираются).
private static ContainerDto ToContainerDto(ContainerEntity entity) => new()
{
Id = entity.Id,
Name = entity.Name,
Description = entity.Description,
Color = entity.Color,
Order = entity.Position,
Space = entity.Space,
Kind = entity.Kind,
Collapsed = entity.Collapsed,
Suggested = entity.Suggested,
Rules = ToRulesOrNull(entity.RulesJson),
Policy = ToPolicyOrEmpty(entity.PolicyJson),
Note = entity.Note,
};
// Маппинг DTO в строку Containers (JSON-поля сериализуются; CreatedAt — UTC-now).
private static ContainerEntity ToContainerEntity(ContainerDto container) => new()
{
Id = container.Id,
Name = container.Name,
Description = container.Description,
Color = container.Color,
Position = container.Order,
Space = container.Space,
Kind = container.Kind,
Collapsed = container.Collapsed,
Suggested = container.Suggested,
RulesJson = ToRulesJson(container.Rules),
PolicyJson = ToPolicyJson(container.Policy),
Note = container.Note,
CreatedAt = DateTimeOffset.UtcNow,
};
// Маппинг строки Cards в DTO: JSON-поля разобраны, budget/converted собраны из пар (from,to,cur).
// entity: Строка карточки.
// comments: Комментарии карточки (уже в DTO с human-меткой time).
private static CardDto ToCardDto(CardEntity entity, IReadOnlyList<CardCommentDto> comments) => new()
{
Id = entity.Id,
Col = entity.Col,
IsNew = entity.IsNew,
Local = entity.Local,
IsVacancy = entity.IsVacancy,
IsVacancyKnown = entity.IsVacancyKnown,
Title = entity.Title,
Summary = entity.Summary,
Source = new CardSourceDto(
Kind: ResolveSourceKind(entity),
DisplayName: entity.ChannelName,
OriginRef: entity.SourceDialogId,
ReceivedAt: entity.ReceivedAt.ToUnixTimeMilliseconds()),
Stack = ToJsonList<string>(entity.StackJson),
Budget = entity.BudgetCur.Length == 0
? null
: new CardBudgetDto(entity.BudgetFrom, entity.BudgetTo, entity.BudgetCur),
Converted = entity.ConvCur.Length == 0
? null
: new CardBudgetDto(entity.ConvFrom, entity.ConvTo, entity.ConvCur),
Contact = entity.Contact,
Contacts = ToJsonList<CardContactDto>(entity.ContactsJson),
Channel = new CardChannelDto(entity.ChannelName, entity.ChannelHandle, entity.ChannelHue),
Time = HumanAge(entity.ReceivedAt),
ReceivedAtMs = entity.ReceivedAt.ToUnixTimeMilliseconds(),
SourceMsg = entity.SourceMsg,
SourceDialogId = entity.SourceDialogId,
SourceMsgId = entity.SourceMsgId,
PrevCol = entity.PrevCol,
MatchHits = ToJsonList<MatchHitDto>(entity.MatchHitsJson),
Comments = comments,
Links = ToJsonList<CardLinkDto>(entity.LinksJson),
Files = ToJsonList<CardFileDto>(entity.FilesJson),
History = ToJsonList<CardHistoryDto>(entity.HistoryJson),
TzText = entity.TzText,
Reminder = entity.ReminderAt is { } reminderAt ? new CardReminderDto(reminderAt.ToUnixTimeMilliseconds()) : null,
CreatedAtMs = entity.CreatedAt.ToUnixTimeMilliseconds(),
UpdatedAtMs = entity.UpdatedAt.ToUnixTimeMilliseconds(),
};
// Вид источника карточки (производная проекция): local/telegram/other.
// entity: Строка карточки.
// Возвращает: Вид источника (строка wire-контракта).
private static string ResolveSourceKind(CardEntity entity)
{
if (entity.Local)
{
return "local";
}
return entity.ChannelName.Length > 0 || entity.SourceDialogId.Length > 0 ? "telegram" : "other";
}
// Маппинг снимка (write-модель создания карточки) в строку Cards; CreatedAt — UTC-now.
private static CardEntity ToCardEntity(CardSnapshot snapshot) => new()
{
Id = snapshot.Id,
Col = snapshot.Col,
IsNew = snapshot.IsNew,
Local = snapshot.Local,
IsVacancy = snapshot.IsVacancy,
IsVacancyKnown = snapshot.IsVacancyKnown,
Title = snapshot.Title,
Summary = snapshot.Summary,
StackJson = ToJson(snapshot.Stack),
BudgetFrom = snapshot.BudgetFrom,
BudgetTo = snapshot.BudgetTo,
BudgetCur = snapshot.BudgetCur,
ConvFrom = snapshot.ConvFrom,
ConvTo = snapshot.ConvTo,
ConvCur = snapshot.ConvCur,
Contact = snapshot.Contact,
ContactsJson = ToJson(snapshot.Contacts),
ChannelName = snapshot.ChannelName,
ChannelHandle = snapshot.ChannelHandle,
ChannelHue = snapshot.ChannelHue,
ReceivedAt = snapshot.ReceivedAt,
SourceMsg = snapshot.SourceMsg,
SourceDialogId = snapshot.SourceDialogId,
SourceMsgId = snapshot.SourceMsgId,
PrevCol = snapshot.PrevCol,
ArchivedAt = snapshot.ArchivedAt,
MatchHitsJson = ToJson(snapshot.MatchHits),
TzText = snapshot.TzText,
HistoryJson = ToJson(snapshot.History),
CreatedAt = DateTimeOffset.UtcNow,
UpdatedAt = DateTimeOffset.UtcNow,
};
// Маппинг строки LeadComments в DTO (human-метка time от CreatedAt, Ruling 10).
private static CardCommentDto ToCommentDto(LeadCommentEntity entity) =>
new(entity.Id, entity.By, entity.Text, HumanAge(entity.CreatedAt));
// Человеческая метка возраста: «только что»/«N мин»/«N ч»/«N дн» (Ruling 10, pipeline.py human_age L528537).
// timestamp: Время события (получения сообщения/добавления комментария).
// Возвращает: Метка от текущего UTC-момента; будущее время даёт «только что» (delta зажат в 0, как в прототипе).
private static string HumanAge(DateTimeOffset timestamp)
{
long deltaMs = Math.Max(0, DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() - timestamp.ToUnixTimeMilliseconds());
long minutes = deltaMs / MillisPerMinute;
if (minutes < MinutesPerHour)
{
return minutes < 1 ? CardsService.JustNowLabel : $"{minutes} мин";
}
long hours = minutes / MinutesPerHour;
if (hours < HoursPerDay)
{
return $"{hours} ч";
}
long days = hours / HoursPerDay;
return $"{days} дн";
}
// Разбирает JSON-массив в список; пустая/битая строка — пустой список (как json.loads в прототипе).
private static IReadOnlyList<T> ToJsonList<T>(string json)
{
if (string.IsNullOrWhiteSpace(json))
{
return Array.Empty<T>();
}
try
{
return JsonSerializer.Deserialize<List<T>>(json, JsonOptions) ?? [];
}
catch (JsonException)
{
return Array.Empty<T>();
}
}
// Разбирает rules-объект: {}/пустая/битая строка — null («правил нет»).
private static ContainerRulesDto? ToRulesOrNull(string json)
{
if (string.IsNullOrWhiteSpace(json) || json == NoRulesJson)
{
return null;
}
try
{
return JsonSerializer.Deserialize<ContainerRulesDto>(json, JsonOptions);
}
catch (JsonException)
{
return null;
}
}
// Сериализует rules-объект: null («правил нет») хранится как {}.
private static string ToRulesJson(ContainerRulesDto? rules) =>
rules is null ? NoRulesJson : JsonSerializer.Serialize(rules, JsonOptions);
// Разбирает policy-объект: пустая/битая строка — политика по умолчанию (обычная колонка).
private static ContainerPolicyDto ToPolicyOrEmpty(string json)
{
if (string.IsNullOrWhiteSpace(json) || json == NoRulesJson)
{
return new ContainerPolicyDto();
}
try
{
return JsonSerializer.Deserialize<ContainerPolicyDto>(json, JsonOptions) ?? new ContainerPolicyDto();
}
catch (JsonException)
{
return new ContainerPolicyDto();
}
}
// Сериализует policy-объект в JSON (camelCase, конвенция value_json).
private static string ToPolicyJson(ContainerPolicyDto policy) => JsonSerializer.Serialize(policy, JsonOptions);
// Сериализует значение в JSON (camelCase, конвенция value_json).
private static string ToJson<T>(T value) => JsonSerializer.Serialize(value, JsonOptions);
}
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,7 +1,13 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -2,7 +2,11 @@ using System.Data;
using System.Data.Common;
using System.Globalization;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,6 +1,8 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,6 +1,9 @@
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
@@ -1,183 +1,186 @@
using System.Linq.Expressions;
using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер истории расхода токенов: таблица public.token_usage_events (append-only + агрегаты, этап 10, T2).
/// </summary>
/// <remarks>
/// Маппинг DTO ↔ сущности вручную (порт модуля не видит EF-сущности, Ruling 1). Запись — только Add+SaveChanges.
/// Агрегация — group by день UTC (Year/Month/Day), тенант, провайдер или модель; фильтры TenantId/Provider/Model/
/// Kind/At-range. Порядок: day — по возрастанию даты, остальные — по убыванию total (детерминизм витрины).
/// Неизвестный groupBy — <see cref="ArgumentException"/> (HTTP-слой валидирует и отвечает 400 раньше).
/// </remarks>
public sealed class TokenUsageEventStore(DealDbContext dbContext) : ITokenUsageEventStore
{
/// <inheritdoc />
public async Task AppendAsync(TokenUsageEventDto record, CancellationToken ct)
{
dbContext.TokenUsageEvents.Add(new TokenUsageEventEntity
{
// Id генерирует БД (identity) — из DTO не копируется.
TenantId = record.TenantId,
At = record.At,
Provider = record.Provider,
Model = record.Model,
Kind = record.Kind,
PromptTokens = record.PromptTokens,
CompletionTokens = record.CompletionTokens,
TotalTokens = record.TotalTokens,
DetailJson = record.DetailJson,
});
await dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateAsync(TokenUsageEventQueryDto query, CancellationToken ct)
{
IQueryable<TokenUsageEventEntity> source = ApplyFilters(dbContext.TokenUsageEvents.AsNoTracking(), query);
return query.GroupBy switch
{
TokenUsageGroupBys.Day => await AggregateByDayAsync(source, ct),
TokenUsageGroupBys.Tenant => await AggregateByTenantAsync(source, ct),
TokenUsageGroupBys.Provider => await AggregateByStringAsync(source, entity => entity.Provider, ct),
TokenUsageGroupBys.Model => await AggregateByStringAsync(source, entity => entity.Model, ct),
_ => throw new ArgumentException($"Неизвестная группировка расхода токенов: '{query.GroupBy}'.", nameof(query)),
};
}
// Применяет фильтры агрегации (TenantId/Provider/Model/Kind/At-range).
// source: Базовый запрос.
// query: Фильтр/группировка.
// Возвращает: Запрос с фильтрами.
private static IQueryable<TokenUsageEventEntity> ApplyFilters(IQueryable<TokenUsageEventEntity> source, TokenUsageEventQueryDto query)
{
if (query.TenantId is not null)
{
source = source.Where(e => e.TenantId == query.TenantId);
}
if (!string.IsNullOrWhiteSpace(query.Provider))
{
source = source.Where(e => e.Provider == query.Provider);
}
if (!string.IsNullOrWhiteSpace(query.Model))
{
source = source.Where(e => e.Model == query.Model);
}
if (!string.IsNullOrWhiteSpace(query.Kind))
{
source = source.Where(e => e.Kind == query.Kind);
}
if (query.From is not null)
{
source = source.Where(e => e.At >= query.From.Value);
}
if (query.To is not null)
{
source = source.Where(e => e.At <= query.To.Value);
}
return source;
}
// Агрегат по суткам UTC (ключ ГГГГ-ММ-ДД), порядок — по возрастанию даты.
// source: Отфильтрованный запрос.
// ct: Токен отмены.
// Возвращает: Строки агрегатов по дням.
private static async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateByDayAsync(
IQueryable<TokenUsageEventEntity> source, CancellationToken ct)
{
var rows = await source
.GroupBy(e => new { e.At.Year, e.At.Month, e.At.Day })
.Select(group => new
{
group.Key.Year,
group.Key.Month,
group.Key.Day,
Prompt = group.Sum(x => x.PromptTokens),
Completion = group.Sum(x => x.CompletionTokens),
Total = group.Sum(x => x.TotalTokens),
Count = group.LongCount(),
})
.ToListAsync(ct);
return rows
.OrderBy(row => row.Year)
.ThenBy(row => row.Month)
.ThenBy(row => row.Day)
.Select(row => new TokenUsageAggregateDto(
$"{row.Year:D4}-{row.Month:D2}-{row.Day:D2}",
row.Prompt,
row.Completion,
row.Total,
row.Count))
.ToList();
}
// Агрегат по тенантам (ключ — Guid "D"), порядок — по убыванию total.
// source: Отфильтрованный запрос.
// ct: Токен отмены.
// Возвращает: Строки агрегатов по тенантам.
private static async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateByTenantAsync(
IQueryable<TokenUsageEventEntity> source, CancellationToken ct)
{
var rows = await source
.GroupBy(e => e.TenantId)
.Select(group => new
{
group.Key,
Prompt = group.Sum(x => x.PromptTokens),
Completion = group.Sum(x => x.CompletionTokens),
Total = group.Sum(x => x.TotalTokens),
Count = group.LongCount(),
})
.ToListAsync(ct);
return rows
.OrderByDescending(row => row.Total)
.Select(row => new TokenUsageAggregateDto(
row.Key.ToString("D"),
row.Prompt,
row.Completion,
row.Total,
row.Count))
.ToList();
}
// Агрегат по строковому ключу (провайдер/модель), порядок — по убыванию total.
// source: Отфильтрованный запрос.
// keySelector: Селектор ключа группы (провайдер/модель).
// ct: Токен отмены.
// Возвращает: Строки агрегатов по ключу.
private static async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateByStringAsync(
IQueryable<TokenUsageEventEntity> source,
Expression<Func<TokenUsageEventEntity, string>> keySelector,
CancellationToken ct)
{
var rows = await source
.GroupBy(keySelector)
.Select(group => new
{
Key = group.Key,
Prompt = group.Sum(x => x.PromptTokens),
Completion = group.Sum(x => x.CompletionTokens),
Total = group.Sum(x => x.TotalTokens),
Count = group.LongCount(),
})
.ToListAsync(ct);
return rows
.OrderByDescending(row => row.Total)
.Select(row => new TokenUsageAggregateDto(row.Key, row.Prompt, row.Completion, row.Total, row.Count))
.ToList();
}
}
using System.Linq.Expressions;
using Deal.Infrastructure.Persistence.Entities;
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 Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Persistence.Repositories;
/// <summary>
/// EF-адаптер истории расхода токенов: таблица public.token_usage_events (append-only + агрегаты, этап 10, T2).
/// </summary>
/// <remarks>
/// Маппинг DTO ↔ сущности вручную (порт модуля не видит EF-сущности, Ruling 1). Запись — только Add+SaveChanges.
/// Агрегация — group by день UTC (Year/Month/Day), тенант, провайдер или модель; фильтры TenantId/Provider/Model/
/// Kind/At-range. Порядок: day — по возрастанию даты, остальные — по убыванию total (детерминизм витрины).
/// Неизвестный groupBy — <see cref="ArgumentException"/> (HTTP-слой валидирует и отвечает 400 раньше).
/// </remarks>
public sealed class TokenUsageEventStore(DealDbContext dbContext) : ITokenUsageEventStore
{
/// <inheritdoc />
public async Task AppendAsync(TokenUsageEventDto record, CancellationToken ct)
{
dbContext.TokenUsageEvents.Add(new TokenUsageEventEntity
{
// Id генерирует БД (identity) — из DTO не копируется.
TenantId = record.TenantId,
At = record.At,
Provider = record.Provider,
Model = record.Model,
Kind = record.Kind,
PromptTokens = record.PromptTokens,
CompletionTokens = record.CompletionTokens,
TotalTokens = record.TotalTokens,
DetailJson = record.DetailJson,
});
await dbContext.SaveChangesAsync(ct);
}
/// <inheritdoc />
public async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateAsync(TokenUsageEventQueryDto query, CancellationToken ct)
{
IQueryable<TokenUsageEventEntity> source = ApplyFilters(dbContext.TokenUsageEvents.AsNoTracking(), query);
return query.GroupBy switch
{
TokenUsageGroupBys.Day => await AggregateByDayAsync(source, ct),
TokenUsageGroupBys.Tenant => await AggregateByTenantAsync(source, ct),
TokenUsageGroupBys.Provider => await AggregateByStringAsync(source, entity => entity.Provider, ct),
TokenUsageGroupBys.Model => await AggregateByStringAsync(source, entity => entity.Model, ct),
_ => throw new ArgumentException($"Неизвестная группировка расхода токенов: '{query.GroupBy}'.", nameof(query)),
};
}
// Применяет фильтры агрегации (TenantId/Provider/Model/Kind/At-range).
// source: Базовый запрос.
// query: Фильтр/группировка.
// Возвращает: Запрос с фильтрами.
private static IQueryable<TokenUsageEventEntity> ApplyFilters(IQueryable<TokenUsageEventEntity> source, TokenUsageEventQueryDto query)
{
if (query.TenantId is not null)
{
source = source.Where(e => e.TenantId == query.TenantId);
}
if (!string.IsNullOrWhiteSpace(query.Provider))
{
source = source.Where(e => e.Provider == query.Provider);
}
if (!string.IsNullOrWhiteSpace(query.Model))
{
source = source.Where(e => e.Model == query.Model);
}
if (!string.IsNullOrWhiteSpace(query.Kind))
{
source = source.Where(e => e.Kind == query.Kind);
}
if (query.From is not null)
{
source = source.Where(e => e.At >= query.From.Value);
}
if (query.To is not null)
{
source = source.Where(e => e.At <= query.To.Value);
}
return source;
}
// Агрегат по суткам UTC (ключ ГГГГ-ММ-ДД), порядок — по возрастанию даты.
// source: Отфильтрованный запрос.
// ct: Токен отмены.
// Возвращает: Строки агрегатов по дням.
private static async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateByDayAsync(
IQueryable<TokenUsageEventEntity> source, CancellationToken ct)
{
var rows = await source
.GroupBy(e => new { e.At.Year, e.At.Month, e.At.Day })
.Select(group => new
{
group.Key.Year,
group.Key.Month,
group.Key.Day,
Prompt = group.Sum(x => x.PromptTokens),
Completion = group.Sum(x => x.CompletionTokens),
Total = group.Sum(x => x.TotalTokens),
Count = group.LongCount(),
})
.ToListAsync(ct);
return rows
.OrderBy(row => row.Year)
.ThenBy(row => row.Month)
.ThenBy(row => row.Day)
.Select(row => new TokenUsageAggregateDto(
$"{row.Year:D4}-{row.Month:D2}-{row.Day:D2}",
row.Prompt,
row.Completion,
row.Total,
row.Count))
.ToList();
}
// Агрегат по тенантам (ключ — Guid "D"), порядок — по убыванию total.
// source: Отфильтрованный запрос.
// ct: Токен отмены.
// Возвращает: Строки агрегатов по тенантам.
private static async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateByTenantAsync(
IQueryable<TokenUsageEventEntity> source, CancellationToken ct)
{
var rows = await source
.GroupBy(e => e.TenantId)
.Select(group => new
{
group.Key,
Prompt = group.Sum(x => x.PromptTokens),
Completion = group.Sum(x => x.CompletionTokens),
Total = group.Sum(x => x.TotalTokens),
Count = group.LongCount(),
})
.ToListAsync(ct);
return rows
.OrderByDescending(row => row.Total)
.Select(row => new TokenUsageAggregateDto(
row.Key.ToString("D"),
row.Prompt,
row.Completion,
row.Total,
row.Count))
.ToList();
}
// Агрегат по строковому ключу (провайдер/модель), порядок — по убыванию total.
// source: Отфильтрованный запрос.
// keySelector: Селектор ключа группы (провайдер/модель).
// ct: Токен отмены.
// Возвращает: Строки агрегатов по ключу.
private static async Task<IReadOnlyList<TokenUsageAggregateDto>> AggregateByStringAsync(
IQueryable<TokenUsageEventEntity> source,
Expression<Func<TokenUsageEventEntity, string>> keySelector,
CancellationToken ct)
{
var rows = await source
.GroupBy(keySelector)
.Select(group => new
{
Key = group.Key,
Prompt = group.Sum(x => x.PromptTokens),
Completion = group.Sum(x => x.CompletionTokens),
Total = group.Sum(x => x.TotalTokens),
Count = group.LongCount(),
})
.ToListAsync(ct);
return rows
.OrderByDescending(row => row.Total)
.Select(row => new TokenUsageAggregateDto(row.Key, row.Prompt, row.Completion, row.Total, row.Count))
.ToList();
}
}
@@ -1,6 +1,9 @@
using System.Security.Cryptography;
using System.Text;
using Deal.Modules.Settings.Application;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
namespace Deal.Infrastructure.Security;
@@ -1,267 +1,285 @@
using Deal.Contracts.Integrations;
using Deal.Infrastructure.Integrations;
using Deal.Infrastructure.Persistence;
using Deal.Infrastructure.Persistence.Repositories;
using Deal.Infrastructure.Security;
using Deal.Infrastructure.Services;
using Deal.Infrastructure.Tenancy;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Discovery.Application;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Pipeline.Application;
using Deal.Modules.Settings.Application;
using Deal.Modules.Telegram.Application;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
using Deal.SharedKernel.Tenants;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
namespace Deal.Infrastructure;
/// <summary>
/// DI-регистрация адаптеров персистентности Deal.Infrastructure (паттерн «port &amp; adapter», Ruling 1).
/// </summary>
/// <remarks>
/// Регистрируются только EF-адаптеры портов модулей. Сервисы самих модулей регистрируют
/// модульные регистраторы (AddTenantsModule в Deal.Api). Адаптеры — scoped, потому что живут
/// на scoped-контекстах EF (DealDbContext), которыми владеет запрос.
/// </remarks>
public static class ServiceCollectionExtensions
{
/// <summary>
/// Регистрирует EF-адаптеры портов модулей: IAuthStore, IOperatorAuthStore, ITenantRepository, IAuditLogStore, IInviteStore, ITenantLimitStore, ISettingsStore, IGlobalSettingsStore, ICardStore, IPipelineStore, IMlLearningStore, ITenantProvisioner.
/// </summary>
/// <param name="services">Коллекция сервисов.</param>
/// <param name="tenantLimitDefaults">Дефолт-бюджет лениво создаваемых строк tenant_limits (Ruling 3; null — константа TokenBudgetDefaults).
/// Передаётся из конфигурации/env DEAL_DEFAULT_AI_BUDGET в Program.cs (Task 8).</param>
/// <returns>Коллекция сервисов для цепочки вызовов.</returns>
public static IServiceCollection AddDealPersistence(
this IServiceCollection services, TokenLimitDefaults? tenantLimitDefaults = null)
{
services.AddScoped<IAuthStore, AuthStore>();
// Хранилище аутентификации оператора (Ruling 1 этапа 7): таблицы operators/operator_sessions
// схемы public — отдельный порт от IAuthStore (оператор ≠ пользователь тенанта).
services.AddScoped<IOperatorAuthStore, OperatorAuthStore>();
services.AddScoped<ITenantRepository, TenantRepository>();
// Хранилище аудита (Ruling 4): таблица public.audit_log — append-only, порт без Update/Delete.
services.AddScoped<IAuditLogStore, AuditLogStore>();
// Хранилище истории расхода токенов (этап 10, T2): таблица public.token_usage_events — append-only
// + агрегаты для аналитики; порт без Update/Delete.
services.AddScoped<ITokenUsageEventStore, TokenUsageEventStore>();
// Хранилище приглашений (Ruling 2): таблица public.invites — создание/чтение/отзыв оператором (Task 5),
// статусные переходы меняет прикладной слой (InvitesService), активацию выполнит /api/join (Task 6).
services.AddScoped<IInviteStore, InviteStore>();
// Хранилище лимитов ИИ-бюджета (Ruling 3, Task 8): таблица public.tenant_limits. Фабрика передаёт
// дефолт-бюджет из конфигурации (Program.cs) — ленивый GetOrCreate новой строки использует его;
// DealDbContext уже зарегистрирован в Api (AddDbContext до AddDealPersistence).
services.AddScoped<ITenantLimitStore>(provider => new TenantLimitStore(
provider.GetRequiredService<DealDbContext>(),
tenantLimitDefaults ?? TokenBudgetDefaults.Default));
// Хранилище счётчиков фиксированного окна (этап 12, пакет B): таблица public.rate_limit_counters —
// общее хранилище распределённого rate limiting (auth/api/gRPC) и учёта попыток входа. Scoped
// (DealDbContext); лимитер резолвит его в собственном scope на каждое приобретение.
services.AddScoped<IRateLimitCounterStore, RateLimitCounterStore>();
// KV-хранилище настроек тенанта (Ruling 1): таблица settings в схеме тенанта,
// контекст — scoped TenantDbContext запроса (см. AddDbContext в Deal.Api).
services.AddScoped<ISettingsStore, SettingsStore>();
// KV-хранилище глобальных (системных) настроек оператора (ТЗ §4.1/§8.1): таблица
// public.global_settings, контекст — системный DealDbContext (public-схема). Ключи Telegram
// задаёт оператор, ядро читает их для команд входа (TelegramKeysService).
services.AddScoped<IGlobalSettingsStore, GlobalSettingsStore>();
// Хранилище карточек и контейнеров (Ruling 12): таблицы Cards/Containers/LeadComments/CardMoves в схеме тенанта.
services.AddScoped<ICardStore, KanbanStore>();
// Хранилище пайплайна (Ruling 10): таблицы QueueItems/RejectedItems/DedupEntries в схеме тенанта.
// KanbanStore при жёстком удалении карточки чистит DedupEntries напрямую тем же TenantDbContext
// (Ruling 3) — IPipelineStore для этого не привлекается, цикла Kanban → Pipeline нет.
services.AddScoped<IPipelineStore, PipelineStore>();
// Хранилище обучения ML (Ruling 4, Task 5): очередь MlOutbox + счётчик журнала CardMoves.
services.AddScoped<IMlLearningStore, MlLearningStore>();
// Хранилище каталога диалогов Telegram (Ruling 7, Task 13): таблицы Dialogs/TgMessages в схеме тенанта.
services.AddScoped<ITelegramStore, TelegramStore>();
// Хранилище Discovery (Ruling 9, Task 17): таблицы DiscTasks/DiscCandidates/DiscBlacklist/DiscLog в схеме
// тенанта. Проверки «уже мониторится» читают таблицу Dialogs (владелец — Telegram) тем же TenantDbContext.
services.AddScoped<IDiscoveryStore, DiscoveryStore>();
// Провижининг схем тенантов (Ruling 3). TenantProvisioningService зависит от
// ConnectionStringProvider — он регистрируется в Deal.Api (Program.cs) как singleton.
services.AddScoped<ITenantProvisioner, TenantProvisioningService>();
// Пакетная (maintenance) миграция схем всех тенантов (этап 12, пакет C): ограниченный
// параллелизм + логирование прогресса поверх ITenantRepository и ITenantProvisioner.
services.AddScoped<TenantSchemaMigrationService>();
// Единая точка перехода карточки между контейнерами (R4 этапа 9): выбор маршрута «стадия
// Выбранных vs дашборд-контейнер» живёт в адаптере, а не в эндпоинте. Scoped —
// композирует scoped-сервис карточек в рамках tenant-запроса.
services.AddScoped<ICardMover, CardMover>();
return services;
}
/// <summary>
/// Регистрирует адаптеры внешних интеграций (Rulings 4/5/6/9): IMlClient, IAiClassifier, IAiTools, IColumnSuggester, ITelegramGateway.
/// </summary>
/// <param name="services">Коллекция сервисов.</param>
/// <param name="mlOptions">Конфигурация секции <c>Services:Ml</c> — выбор реализации IMlClient (Ruling 6).</param>
/// <param name="aiOptions">Конфигурация секции <c>Services:Ai</c> — выбор реализации IAiClassifier/IAiTools (Ruling 6).</param>
/// <param name="telegramOptions">Конфигурация секции <c>Services:Telegram</c> — выбор реализации ITelegramGateway (Ruling 6).</param>
/// <returns>Коллекция сервисов для цепочки вызовов.</returns>
/// <remarks>
/// IMlClient: при <c>UseLocal=true</c> (default) — Local-заглушка LocalMlClient (фолбэк этапов 2–5); при
/// <c>UseLocal=false</c> — gRPC-адаптер GrpcMlClient (ml.proto, Ruling 1/4) + синглтон-транспорт
/// MlGrpcConnection и кэш статуса MlStatusCache; тот же адаптер реализует IMlTrainClient для фонового
/// MlOutboxFlushScheduler (регистрируется в Deal.Api под тем же флагом). PushAsync в обоих режимах пишет
/// в MlOutbox (Ruling 6 — обучение всегда локально), выгрузку батчами делает флашер. IAiClassifier: при
/// <c>Services:Ai:UseLocal=true</c> — LocalAiClassifier (детерминированный разбор ядра, Ruling 5 этапа 4);
/// при false — GrpcAiClassifier (ai.proto; Ruling 5/6) + синглтон AiGrpcConnection (fail-fast, как
/// MlGrpcConnection) + scoped-сервисы конфига провайдера/учёта токенов. Бюджетный гейт (Task 9, Ruling 3):
/// в gRPC-режиме порты наружу отдаются декораторами BudgetedAiClassifier/BudgetedAiTools поверх gRPC-адаптеров
/// (порядок Grpc → Budgeted), Local-реализации регистрируются как бесплатный fallback гейта. IAiTools:
/// LocalAiTools (методы не поддерживаются — NotSupportedException, Ruling 9) либо GrpcAiTools за тем же флагом.
/// IColumnSuggester —
/// детерминированная Local-эвристика LocalColumnSuggester (Self-Review плана L525527: на gRPC сознательно
/// не заменяется). ITelegramGateway: при <c>Services:Telegram:UseLocal=true</c> (default) — LocalTelegramGateway
/// (нейтральный no-op/idle, фолбэк до Task 14); при false — GrpcTelegramClient (telegram.proto, Ruling 7) +
/// синглтон-транспорт TelegramGrpcConnection (fail-fast).
/// Scoped: адаптеры читают KV-настройки тенанта (ISettingsStore → scoped TenantDbContext запроса) и
/// пишут в таблицы схемы тенанта, поэтому не могут жить дольше scope. HTTP-адаптеры других
/// интеграций (IAiConnectionChecker/IRatesSource) регистрируются в Deal.Api через AddHttpClient —
/// см. Program.cs (Tasks 6/8).
/// </remarks>
public static IServiceCollection AddDealIntegrations(
this IServiceCollection services, MlServiceOptions mlOptions, AiServiceOptions aiOptions,
TelegramServiceOptions telegramOptions, MtlsCertificates? mtlsCertificates = null)
{
// Сертификаты mTLS-каналов (Ruling 6, Task 13): null (флаг DEAL_MTLS_ENABLED выключен) — каналы
// остаются plaintext + service-token (dev); при включённом флаге каждый транспорт подписывает запрос
// клиентским сертификатом и проверяет CA сервера (fail-fast на загрузку — в MtlsCertificates.Load).
// Recorder расхода токенов (Ruling 3 этапа 7; история — этап 10, T2): пишет бюджет/lifetime/историю
// событий. Регистрируется независимо от AI-режима — им пользуется и gRPC ML-клиент (событие kind=ml).
services.AddScoped<TokenUsageRecorder>();
// ML-клиент (Ruling 6, план Task 16): выбор на старте — Local-заглушка либо gRPC-адаптер ml-service.
if (mlOptions.UseLocal)
{
// Обучение копится в MlOutbox (этап 3); отправка в ML-сервис не выполняется (сервиса нет в dev) —
// очередь остаётся накопленной, как в прототипе при недоступном сервисе (python L5682).
services.AddScoped<IMlClient, LocalMlClient>();
}
else
{
// gRPC-клиент ml-service: транспорт создаётся сразу (fail-fast: пустой endpoint/токен останавливают
// старт — Ruling 2/13), кэш статуса 15 с переживает scope запросов. Scoped GrpcMlClient читает
// KV/таблицы тенанта (как LocalMlClient) и ходит в сервис по metadata tenant-id/service-token.
services.AddSingleton(new MlGrpcConnection(mlOptions, mtlsCertificates));
services.AddSingleton<MlStatusCache>();
services.AddScoped<GrpcMlClient>();
services.AddScoped<IMlClient>(provider => provider.GetRequiredService<GrpcMlClient>());
services.AddScoped<IMlTrainClient>(provider => provider.GetRequiredService<GrpcMlClient>());
}
// ИИ-предложения колонок/ключей (Ruling 3, Task 14): порт Contracts → детерминированная эвристика.
// LocalColumnSuggester читает карточки через ICardStore, считает группы ядром SuggestHeuristics
// (модуль Kanban) и создаёт доски suggested=true через ContainersService; scoped — его зависимости
// живут в рамках tenant-запроса (KanbanStore/TenantDbContext). На этапе 6 адаптер заменяется
// gRPC-клиентом ai-service с тем же контрактом.
services.AddScoped<IColumnSuggester, LocalColumnSuggester>();
// ИИ-классификатор входящих (Ruling 5/6, Task 15): порт Contracts → детерминированная Local-реализация
// (UseLocal=true) либо gRPC-адаптер ai-service (UseLocal=false). LocalAiClassifier разбирает сообщение
// ядром LocalFieldsParser модуля Pipeline (маркерная гипотеза типа: is_vacancy_known=false, board=null —
// «смысловые колонки до ИИ не назначаем») и всегда пропускает ИИ-фильтр {pass:true, skipped:true};
// scoped — LocalFieldsParser читает маркеры hireMarkers/levelTerms из KV-настроек тенанта (ISettingsStore).
// GrpcAiClassifier строит промпты/контекст классификации (AiClassifyContextBuilder модуля Pipeline,
// регистрируется AddPipelineModule), ходит в ai-service с ProviderConfig из настроек (расшифровка apiKey)
// и копит usage в KV aiTokenUsage; недоступность/ok=false → AiUnavailableException — воркер падает в
// локальный разбор (aiFail, как raw={} python L11081114). Выбор на старте, рантайм-логики нет (Ruling 6).
// Списывание в tenant_limits + lifetime-KV aiTokenUsage выполняет TokenUsageRecorder (Ruling 3, Task 8).
if (aiOptions.UseLocal)
{
services.AddScoped<IAiClassifier, LocalAiClassifier>();
services.AddScoped<IAiTools, LocalAiTools>();
}
else
{
// gRPC-клиент ai-service: транспорт создаётся сразу (fail-fast: пустой endpoint/токен останавливают
// старт — Ruling 2/13), как MlGrpcConnection. Scoped-адаптеры читают настройки/данные тенанта и ходят
// в сервис по metadata tenant-id/service-token; usage ответов списывает TokenUsageRecorder
// (tenant_limits + lifetime-KV aiTokenUsage, Ruling 3 этапа 7).
services.AddSingleton(new AiGrpcConnection(aiOptions, mtlsCertificates));
services.AddScoped<AiProviderConfigBuilder>();
services.AddScoped<GrpcAiClassifier>();
// Локальные адаптеры как fallback бюджетного гейта (Ruling 3, Task 9): даже в gRPC-режиме декоратор при
// исчерпанном бюджете/приостановке уводит вызов на детерминированный бесплатный локальный разбор
// (LocalAiClassifier; LocalFieldsParser регистрирует AddPipelineModule в Program.cs). Инструменты локального
// fallback не имеют — при запрете BudgetedAiTools бросает AiUnavailableException/мягкую ошибку (Ruling 3).
services.AddScoped<LocalAiClassifier>();
// Декораторы бюджетного гейта (порядок Grpc → Budgeted → наружу): перед каждым платным вызовом
// GetStateAsync (ITenantLimitStore, scoped) — исчерпано/приостановлено → Local-классификатор либо
// исключение/мягкая ошибка инструментов; списание usage остаётся внутри gRPC-адаптеров (Task 8).
services.AddScoped<IAiClassifier>(provider => new BudgetedAiClassifier(
provider.GetRequiredService<GrpcAiClassifier>(),
provider.GetRequiredService<LocalAiClassifier>(),
provider.GetRequiredService<ITenantLimitStore>(),
provider.GetRequiredService<ITenantContext>(),
provider.GetRequiredService<ILogger<BudgetedAiClassifier>>()));
services.AddScoped<GrpcAiTools>();
services.AddScoped<IAiTools>(provider => new BudgetedAiTools(
provider.GetRequiredService<GrpcAiTools>(),
provider.GetRequiredService<ITenantLimitStore>(),
provider.GetRequiredService<ITenantContext>(),
provider.GetRequiredService<ILogger<BudgetedAiTools>>()));
}
// Гейт telegram-service (Ruling 6/7, план Task 14): порт Contracts. По умолчанию (UseLocal=true) —
// локальная заглушка dev LocalTelegramGateway (нейтральный no-op/idle — сервис не поднят); при
// UseLocal=false — gRPC-клиент GrpcTelegramClient (telegram.proto) + синглтон-транспорт
// TelegramGrpcConnection (fail-fast, как MlGrpcConnection). Scoped-адаптер: tenant-id для metadata
// берёт из ITenantContext (AsyncLocal) scope вызова (HTTP-запрос/tenant-циклы ингресса).
if (telegramOptions.UseLocal)
{
services.AddSingleton<ITelegramGateway, LocalTelegramGateway>();
}
else
{
services.AddSingleton(new TelegramGrpcConnection(telegramOptions, mtlsCertificates));
services.AddScoped<GrpcTelegramClient>();
services.AddScoped<ITelegramGateway>(provider => provider.GetRequiredService<GrpcTelegramClient>());
}
return services;
}
/// <summary>
/// Регистрирует сервисы шифрования секретов: ISecretCipher → AesGcmSecretCipher (Ruling 2).
/// </summary>
/// <param name="services">Коллекция сервисов.</param>
/// <param name="contentRootPath">ContentRoot приложения — каталог по умолчанию для файла-ключа data/encryption.key.</param>
/// <returns>Коллекция сервисов для цепочки вызовов.</returns>
/// <remarks>
/// Ключ разрешается один раз при вызове: невалидный DEAL_ENCRYPTION_KEY → исключение при старте
/// (план Task 1). EncryptionKeyProvider в контейнер не регистрируется — после разрешения ключа
/// он рантайм-сервисам не нужен. ISecretCipher — singleton: реализация без разделяемого
/// состояния (AesGcm создаётся на операцию), поэтому потокобезопасна.
/// </remarks>
public static IServiceCollection AddDealSecurity(this IServiceCollection services, string contentRootPath)
{
EncryptionKeyProvider keyProvider = new(contentRootPath);
byte[] key = keyProvider.GetKey();
services.AddSingleton<ISecretCipher>(new AesGcmSecretCipher(key));
return services;
}
}
using Deal.Contracts.Integrations;
using Deal.Infrastructure.Integrations;
using Deal.Infrastructure.Persistence;
using Deal.Infrastructure.Persistence.Repositories;
using Deal.Infrastructure.Security;
using Deal.Infrastructure.Services;
using Deal.Infrastructure.Tenancy;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Deal.Modules.Pipeline.Application.Abstractions;
using Deal.Modules.Pipeline.Application.Models;
using Deal.Modules.Pipeline.Application.Registrars;
using Deal.Modules.Pipeline.Application.Services;
using Deal.Modules.Settings.Application.Abstractions;
using Deal.Modules.Settings.Application.Models;
using Deal.Modules.Settings.Application.Registrars;
using Deal.Modules.Settings.Application.Services;
using Deal.Modules.Telegram.Application;
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.SharedKernel.Tenants;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
namespace Deal.Infrastructure;
/// <summary>
/// DI-регистрация адаптеров персистентности Deal.Infrastructure (паттерн «port &amp; adapter», Ruling 1).
/// </summary>
/// <remarks>
/// Регистрируются только EF-адаптеры портов модулей. Сервисы самих модулей регистрируют
/// модульные регистраторы (AddTenantsModule в Deal.Api). Адаптеры — scoped, потому что живут
/// на scoped-контекстах EF (DealDbContext), которыми владеет запрос.
/// </remarks>
public static class ServiceCollectionExtensions
{
/// <summary>
/// Регистрирует EF-адаптеры портов модулей: IAuthStore, IOperatorAuthStore, ITenantRepository, IAuditLogStore, IInviteStore, ITenantLimitStore, ISettingsStore, IGlobalSettingsStore, ICardStore, IPipelineStore, IMlLearningStore, ITenantProvisioner.
/// </summary>
/// <param name="services">Коллекция сервисов.</param>
/// <param name="tenantLimitDefaults">Дефолт-бюджет лениво создаваемых строк tenant_limits (Ruling 3; null — константа TokenBudgetDefaults).
/// Передаётся из конфигурации/env DEAL_DEFAULT_AI_BUDGET в Program.cs (Task 8).</param>
/// <returns>Коллекция сервисов для цепочки вызовов.</returns>
public static IServiceCollection AddDealPersistence(
this IServiceCollection services, TokenLimitDefaults? tenantLimitDefaults = null)
{
services.AddScoped<IAuthStore, AuthStore>();
// Хранилище аутентификации оператора (Ruling 1 этапа 7): таблицы operators/operator_sessions
// схемы public — отдельный порт от IAuthStore (оператор ≠ пользователь тенанта).
services.AddScoped<IOperatorAuthStore, OperatorAuthStore>();
services.AddScoped<ITenantRepository, TenantRepository>();
// Хранилище аудита (Ruling 4): таблица public.audit_log — append-only, порт без Update/Delete.
services.AddScoped<IAuditLogStore, AuditLogStore>();
// Хранилище истории расхода токенов (этап 10, T2): таблица public.token_usage_events — append-only
// + агрегаты для аналитики; порт без Update/Delete.
services.AddScoped<ITokenUsageEventStore, TokenUsageEventStore>();
// Хранилище приглашений (Ruling 2): таблица public.invites — создание/чтение/отзыв оператором (Task 5),
// статусные переходы меняет прикладной слой (InvitesService), активацию выполнит /api/join (Task 6).
services.AddScoped<IInviteStore, InviteStore>();
// Хранилище лимитов ИИ-бюджета (Ruling 3, Task 8): таблица public.tenant_limits. Фабрика передаёт
// дефолт-бюджет из конфигурации (Program.cs) — ленивый GetOrCreate новой строки использует его;
// DealDbContext уже зарегистрирован в Api (AddDbContext до AddDealPersistence).
services.AddScoped<ITenantLimitStore>(provider => new TenantLimitStore(
provider.GetRequiredService<DealDbContext>(),
tenantLimitDefaults ?? TokenBudgetDefaults.Default));
// Хранилище счётчиков фиксированного окна (этап 12, пакет B): таблица public.rate_limit_counters —
// общее хранилище распределённого rate limiting (auth/api/gRPC) и учёта попыток входа. Scoped
// (DealDbContext); лимитер резолвит его в собственном scope на каждое приобретение.
services.AddScoped<IRateLimitCounterStore, RateLimitCounterStore>();
// KV-хранилище настроек тенанта (Ruling 1): таблица settings в схеме тенанта,
// контекст — scoped TenantDbContext запроса (см. AddDbContext в Deal.Api).
services.AddScoped<ISettingsStore, SettingsStore>();
// KV-хранилище глобальных (системных) настроек оператора (ТЗ §4.1/§8.1): таблица
// public.global_settings, контекст — системный DealDbContext (public-схема). Ключи Telegram
// задаёт оператор, ядро читает их для команд входа (TelegramKeysService).
services.AddScoped<IGlobalSettingsStore, GlobalSettingsStore>();
// Хранилище карточек и контейнеров (Ruling 12): таблицы Cards/Containers/LeadComments/CardMoves в схеме тенанта.
services.AddScoped<ICardStore, KanbanStore>();
// Хранилище пайплайна (Ruling 10): таблицы QueueItems/RejectedItems/DedupEntries в схеме тенанта.
// KanbanStore при жёстком удалении карточки чистит DedupEntries напрямую тем же TenantDbContext
// (Ruling 3) — IPipelineStore для этого не привлекается, цикла Kanban → Pipeline нет.
services.AddScoped<IPipelineStore, PipelineStore>();
// Хранилище обучения ML (Ruling 4, Task 5): очередь MlOutbox + счётчик журнала CardMoves.
services.AddScoped<IMlLearningStore, MlLearningStore>();
// Хранилище каталога диалогов Telegram (Ruling 7, Task 13): таблицы Dialogs/TgMessages в схеме тенанта.
services.AddScoped<ITelegramStore, TelegramStore>();
// Хранилище Discovery (Ruling 9, Task 17): таблицы DiscTasks/DiscCandidates/DiscBlacklist/DiscLog в схеме
// тенанта. Проверки «уже мониторится» читают таблицу Dialogs (владелец — Telegram) тем же TenantDbContext.
services.AddScoped<IDiscoveryStore, DiscoveryStore>();
// Провижининг схем тенантов (Ruling 3). TenantProvisioningService зависит от
// ConnectionStringProvider — он регистрируется в Deal.Api (Program.cs) как singleton.
services.AddScoped<ITenantProvisioner, TenantProvisioningService>();
// Пакетная (maintenance) миграция схем всех тенантов (этап 12, пакет C): ограниченный
// параллелизм + логирование прогресса поверх ITenantRepository и ITenantProvisioner.
services.AddScoped<TenantSchemaMigrationService>();
// Единая точка перехода карточки между контейнерами (R4 этапа 9): выбор маршрута «стадия
// Выбранных vs дашборд-контейнер» живёт в адаптере, а не в эндпоинте. Scoped —
// композирует scoped-сервис карточек в рамках tenant-запроса.
services.AddScoped<ICardMover, CardMover>();
return services;
}
/// <summary>
/// Регистрирует адаптеры внешних интеграций (Rulings 4/5/6/9): IMlClient, IAiClassifier, IAiTools, IColumnSuggester, ITelegramGateway.
/// </summary>
/// <param name="services">Коллекция сервисов.</param>
/// <param name="mlOptions">Конфигурация секции <c>Services:Ml</c> — выбор реализации IMlClient (Ruling 6).</param>
/// <param name="aiOptions">Конфигурация секции <c>Services:Ai</c> — выбор реализации IAiClassifier/IAiTools (Ruling 6).</param>
/// <param name="telegramOptions">Конфигурация секции <c>Services:Telegram</c> — выбор реализации ITelegramGateway (Ruling 6).</param>
/// <returns>Коллекция сервисов для цепочки вызовов.</returns>
/// <remarks>
/// IMlClient: при <c>UseLocal=true</c> (default) — Local-заглушка LocalMlClient (фолбэк этапов 2–5); при
/// <c>UseLocal=false</c> — gRPC-адаптер GrpcMlClient (ml.proto, Ruling 1/4) + синглтон-транспорт
/// MlGrpcConnection и кэш статуса MlStatusCache; тот же адаптер реализует IMlTrainClient для фонового
/// MlOutboxFlushScheduler (регистрируется в Deal.Api под тем же флагом). PushAsync в обоих режимах пишет
/// в MlOutbox (Ruling 6 — обучение всегда локально), выгрузку батчами делает флашер. IAiClassifier: при
/// <c>Services:Ai:UseLocal=true</c> — LocalAiClassifier (детерминированный разбор ядра, Ruling 5 этапа 4);
/// при false — GrpcAiClassifier (ai.proto; Ruling 5/6) + синглтон AiGrpcConnection (fail-fast, как
/// MlGrpcConnection) + scoped-сервисы конфига провайдера/учёта токенов. Бюджетный гейт (Task 9, Ruling 3):
/// в gRPC-режиме порты наружу отдаются декораторами BudgetedAiClassifier/BudgetedAiTools поверх gRPC-адаптеров
/// (порядок Grpc → Budgeted), Local-реализации регистрируются как бесплатный fallback гейта. IAiTools:
/// LocalAiTools (методы не поддерживаются — NotSupportedException, Ruling 9) либо GrpcAiTools за тем же флагом.
/// IColumnSuggester —
/// детерминированная Local-эвристика LocalColumnSuggester (Self-Review плана L525527: на gRPC сознательно
/// не заменяется). ITelegramGateway: при <c>Services:Telegram:UseLocal=true</c> (default) — LocalTelegramGateway
/// (нейтральный no-op/idle, фолбэк до Task 14); при false — GrpcTelegramClient (telegram.proto, Ruling 7) +
/// синглтон-транспорт TelegramGrpcConnection (fail-fast).
/// Scoped: адаптеры читают KV-настройки тенанта (ISettingsStore → scoped TenantDbContext запроса) и
/// пишут в таблицы схемы тенанта, поэтому не могут жить дольше scope. HTTP-адаптеры других
/// интеграций (IAiConnectionChecker/IRatesSource) регистрируются в Deal.Api через AddHttpClient —
/// см. Program.cs (Tasks 6/8).
/// </remarks>
public static IServiceCollection AddDealIntegrations(
this IServiceCollection services, MlServiceOptions mlOptions, AiServiceOptions aiOptions,
TelegramServiceOptions telegramOptions, MtlsCertificates? mtlsCertificates = null)
{
// Сертификаты mTLS-каналов (Ruling 6, Task 13): null (флаг DEAL_MTLS_ENABLED выключен) — каналы
// остаются plaintext + service-token (dev); при включённом флаге каждый транспорт подписывает запрос
// клиентским сертификатом и проверяет CA сервера (fail-fast на загрузку — в MtlsCertificates.Load).
// Recorder расхода токенов (Ruling 3 этапа 7; история — этап 10, T2): пишет бюджет/lifetime/историю
// событий. Регистрируется независимо от AI-режима — им пользуется и gRPC ML-клиент (событие kind=ml).
services.AddScoped<TokenUsageRecorder>();
// ML-клиент (Ruling 6, план Task 16): выбор на старте — Local-заглушка либо gRPC-адаптер ml-service.
if (mlOptions.UseLocal)
{
// Обучение копится в MlOutbox (этап 3); отправка в ML-сервис не выполняется (сервиса нет в dev) —
// очередь остаётся накопленной, как в прототипе при недоступном сервисе (python L5682).
services.AddScoped<IMlClient, LocalMlClient>();
}
else
{
// gRPC-клиент ml-service: транспорт создаётся сразу (fail-fast: пустой endpoint/токен останавливают
// старт — Ruling 2/13), кэш статуса 15 с переживает scope запросов. Scoped GrpcMlClient читает
// KV/таблицы тенанта (как LocalMlClient) и ходит в сервис по metadata tenant-id/service-token.
services.AddSingleton(new MlGrpcConnection(mlOptions, mtlsCertificates));
services.AddSingleton<MlStatusCache>();
services.AddScoped<GrpcMlClient>();
services.AddScoped<IMlClient>(provider => provider.GetRequiredService<GrpcMlClient>());
services.AddScoped<IMlTrainClient>(provider => provider.GetRequiredService<GrpcMlClient>());
}
// ИИ-предложения колонок/ключей (Ruling 3, Task 14): порт Contracts → детерминированная эвристика.
// LocalColumnSuggester читает карточки через ICardStore, считает группы ядром SuggestHeuristics
// (модуль Kanban) и создаёт доски suggested=true через ContainersService; scoped — его зависимости
// живут в рамках tenant-запроса (KanbanStore/TenantDbContext). На этапе 6 адаптер заменяется
// gRPC-клиентом ai-service с тем же контрактом.
services.AddScoped<IColumnSuggester, LocalColumnSuggester>();
// ИИ-классификатор входящих (Ruling 5/6, Task 15): порт Contracts → детерминированная Local-реализация
// (UseLocal=true) либо gRPC-адаптер ai-service (UseLocal=false). LocalAiClassifier разбирает сообщение
// ядром LocalFieldsParser модуля Pipeline (маркерная гипотеза типа: is_vacancy_known=false, board=null —
// «смысловые колонки до ИИ не назначаем») и всегда пропускает ИИ-фильтр {pass:true, skipped:true};
// scoped — LocalFieldsParser читает маркеры hireMarkers/levelTerms из KV-настроек тенанта (ISettingsStore).
// GrpcAiClassifier строит промпты/контекст классификации (AiClassifyContextBuilder модуля Pipeline,
// регистрируется AddPipelineModule), ходит в ai-service с ProviderConfig из настроек (расшифровка apiKey)
// и копит usage в KV aiTokenUsage; недоступность/ok=false → AiUnavailableException — воркер падает в
// локальный разбор (aiFail, как raw={} python L11081114). Выбор на старте, рантайм-логики нет (Ruling 6).
// Списывание в tenant_limits + lifetime-KV aiTokenUsage выполняет TokenUsageRecorder (Ruling 3, Task 8).
if (aiOptions.UseLocal)
{
services.AddScoped<IAiClassifier, LocalAiClassifier>();
services.AddScoped<IAiTools, LocalAiTools>();
}
else
{
// gRPC-клиент ai-service: транспорт создаётся сразу (fail-fast: пустой endpoint/токен останавливают
// старт — Ruling 2/13), как MlGrpcConnection. Scoped-адаптеры читают настройки/данные тенанта и ходят
// в сервис по metadata tenant-id/service-token; usage ответов списывает TokenUsageRecorder
// (tenant_limits + lifetime-KV aiTokenUsage, Ruling 3 этапа 7).
services.AddSingleton(new AiGrpcConnection(aiOptions, mtlsCertificates));
services.AddScoped<AiProviderConfigBuilder>();
services.AddScoped<GrpcAiClassifier>();
// Локальные адаптеры как fallback бюджетного гейта (Ruling 3, Task 9): даже в gRPC-режиме декоратор при
// исчерпанном бюджете/приостановке уводит вызов на детерминированный бесплатный локальный разбор
// (LocalAiClassifier; LocalFieldsParser регистрирует AddPipelineModule в Program.cs). Инструменты локального
// fallback не имеют — при запрете BudgetedAiTools бросает AiUnavailableException/мягкую ошибку (Ruling 3).
services.AddScoped<LocalAiClassifier>();
// Декораторы бюджетного гейта (порядок Grpc → Budgeted → наружу): перед каждым платным вызовом
// GetStateAsync (ITenantLimitStore, scoped) — исчерпано/приостановлено → Local-классификатор либо
// исключение/мягкая ошибка инструментов; списание usage остаётся внутри gRPC-адаптеров (Task 8).
services.AddScoped<IAiClassifier>(provider => new BudgetedAiClassifier(
provider.GetRequiredService<GrpcAiClassifier>(),
provider.GetRequiredService<LocalAiClassifier>(),
provider.GetRequiredService<ITenantLimitStore>(),
provider.GetRequiredService<ITenantContext>(),
provider.GetRequiredService<ILogger<BudgetedAiClassifier>>()));
services.AddScoped<GrpcAiTools>();
services.AddScoped<IAiTools>(provider => new BudgetedAiTools(
provider.GetRequiredService<GrpcAiTools>(),
provider.GetRequiredService<ITenantLimitStore>(),
provider.GetRequiredService<ITenantContext>(),
provider.GetRequiredService<ILogger<BudgetedAiTools>>()));
}
// Гейт telegram-service (Ruling 6/7, план Task 14): порт Contracts. По умолчанию (UseLocal=true) —
// локальная заглушка dev LocalTelegramGateway (нейтральный no-op/idle — сервис не поднят); при
// UseLocal=false — gRPC-клиент GrpcTelegramClient (telegram.proto) + синглтон-транспорт
// TelegramGrpcConnection (fail-fast, как MlGrpcConnection). Scoped-адаптер: tenant-id для metadata
// берёт из ITenantContext (AsyncLocal) scope вызова (HTTP-запрос/tenant-циклы ингресса).
if (telegramOptions.UseLocal)
{
services.AddSingleton<ITelegramGateway, LocalTelegramGateway>();
}
else
{
services.AddSingleton(new TelegramGrpcConnection(telegramOptions, mtlsCertificates));
services.AddScoped<GrpcTelegramClient>();
services.AddScoped<ITelegramGateway>(provider => provider.GetRequiredService<GrpcTelegramClient>());
}
return services;
}
/// <summary>
/// Регистрирует сервисы шифрования секретов: ISecretCipher → AesGcmSecretCipher (Ruling 2).
/// </summary>
/// <param name="services">Коллекция сервисов.</param>
/// <param name="contentRootPath">ContentRoot приложения — каталог по умолчанию для файла-ключа data/encryption.key.</param>
/// <returns>Коллекция сервисов для цепочки вызовов.</returns>
/// <remarks>
/// Ключ разрешается один раз при вызове: невалидный DEAL_ENCRYPTION_KEY → исключение при старте
/// (план Task 1). EncryptionKeyProvider в контейнер не регистрируется — после разрешения ключа
/// он рантайм-сервисам не нужен. ISecretCipher — singleton: реализация без разделяемого
/// состояния (AesGcm создаётся на операцию), поэтому потокобезопасна.
/// </remarks>
public static IServiceCollection AddDealSecurity(this IServiceCollection services, string contentRootPath)
{
EncryptionKeyProvider keyProvider = new(contentRootPath);
byte[] key = keyProvider.GetKey();
services.AddSingleton<ISecretCipher>(new AesGcmSecretCipher(key));
return services;
}
}
@@ -1,38 +1,41 @@
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Models;
namespace Deal.Infrastructure.Services;
/// <summary>
/// Единая точка перехода карточки между контейнерами — реализация порта <see cref="ICardMover"/>
/// (R4 этапа 9).
/// </summary>
/// <remarks>
/// Маршрутизация цели живёт в домене: цель-стадия пространства «Выбранные»
/// (<see cref="CardsDefaultContainers"/>) переходит через <see cref="CardsService.MoveStageCardAsync"/> —
/// запись истории движения и сброс напоминания; остальные цели (доски/служебные зоны) — штатный перенос
/// дашборда <see cref="CardsService.MoveDashboardCardAsync"/> (журнал CardMoves, matchHits, обучение ML).
/// Адаптер только нормализует результаты обоих маршрутов к <see cref="CardMoveResultDto"/>; снимок карточки
/// эндпоинт перечитывает единым чтением. Scoped: зависимости живут в рамках tenant-запроса.
/// </remarks>
/// <param name="cardsService">Сервис карточек — единый домен перехода (стадии и контейнеры дашборда).</param>
public sealed class CardMover(CardsService cardsService) : ICardMover
{
/// <inheritdoc />
public async Task<CardMoveResultDto> MoveAsync(
string cardId, string toContainerId, TransitionContext ctx, CancellationToken ct)
{
// Контекст перехода (инициатор/обучение) учтён внутри маршрутов: дашборд-перенос обучает ML по
// цели пользователя, переход по стадии пишет историю и сбрасывает напоминание. Отдельного
// ветвления по ctx сейчас нет — оно появится с политиками контейнеров (R4).
CardResultDto result = CardsDefaultContainers.Contains(toContainerId)
? await cardsService.MoveStageCardAsync(cardId, toContainerId, ct)
: await cardsService.MoveDashboardCardAsync(cardId, toContainerId, ct);
return result.Error is not null
? new CardMoveResultDto(result.Error, Exists: true)
: new CardMoveResultDto(null, Exists: result.Card is not null);
}
}
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
namespace Deal.Infrastructure.Services;
/// <summary>
/// Единая точка перехода карточки между контейнерами — реализация порта <see cref="ICardMover"/>
/// (R4 этапа 9).
/// </summary>
/// <remarks>
/// Маршрутизация цели живёт в домене: цель-стадия пространства «Выбранные»
/// (<see cref="CardsDefaultContainers"/>) переходит через <see cref="CardsService.MoveStageCardAsync"/> —
/// запись истории движения и сброс напоминания; остальные цели (доски/служебные зоны) — штатный перенос
/// дашборда <see cref="CardsService.MoveDashboardCardAsync"/> (журнал CardMoves, matchHits, обучение ML).
/// Адаптер только нормализует результаты обоих маршрутов к <see cref="CardMoveResultDto"/>; снимок карточки
/// эндпоинт перечитывает единым чтением. Scoped: зависимости живут в рамках tenant-запроса.
/// </remarks>
/// <param name="cardsService">Сервис карточек — единый домен перехода (стадии и контейнеры дашборда).</param>
public sealed class CardMover(CardsService cardsService) : ICardMover
{
/// <inheritdoc />
public async Task<CardMoveResultDto> MoveAsync(
string cardId, string toContainerId, TransitionContext ctx, CancellationToken ct)
{
// Контекст перехода (инициатор/обучение) учтён внутри маршрутов: дашборд-перенос обучает ML по
// цели пользователя, переход по стадии пишет историю и сбрасывает напоминание. Отдельного
// ветвления по ctx сейчас нет — оно появится с политиками контейнеров (R4).
CardResultDto result = CardsDefaultContainers.Contains(toContainerId)
? await cardsService.MoveStageCardAsync(cardId, toContainerId, ct)
: await cardsService.MoveDashboardCardAsync(cardId, toContainerId, ct);
return result.Error is not null
? new CardMoveResultDto(result.Error, Exists: true)
: new CardMoveResultDto(null, Exists: result.Card is not null);
}
}
@@ -4,8 +4,11 @@ using Deal.Infrastructure.Persistence.Entities;
using Deal.Modules.Cards.Application.Abstractions;
using Deal.Modules.Cards.Application.Dtos;
using Deal.Modules.Cards.Application.Models;
using Deal.Modules.Kanban.Application;
using Deal.Modules.Kanban.Application.Abstractions;
using Deal.Modules.Kanban.Application.Extensions;
using Deal.Modules.Kanban.Application.Models;
using Deal.Modules.Kanban.Application.Registrars;
using Deal.Modules.Kanban.Application.Services;
using Microsoft.EntityFrameworkCore;
namespace Deal.Infrastructure.Tenancy;
@@ -2,7 +2,11 @@ using System.Collections.Concurrent;
using Deal.Infrastructure.Data;
using Deal.Infrastructure.Migrations;
using Deal.Infrastructure.Persistence;
using Deal.Modules.Tenants.Application;
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.SharedKernel.Tenants;
using Microsoft.EntityFrameworkCore;
using Npgsql;
@@ -1,110 +1,113 @@
using System.Collections.Concurrent;
using System.Diagnostics;
using Deal.Modules.Tenants.Application;
using Deal.Modules.Tenants.Application.Models;
using Deal.SharedKernel.Tenants;
using Microsoft.Extensions.Logging;
namespace Deal.Infrastructure.Tenancy;
/// <summary>
/// Пакетная (maintenance) миграция схем ВСЕХ существующих тенантов реестра (этап 12, пакет C) с
/// ограниченным параллелизмом и логированием прогресса — для провижининга SaaS на сотни/тысячи схем.
/// </summary>
/// <remarks>
/// Идемпотентность обеспечивает сам провижининг: <c>CREATE SCHEMA IF NOT EXISTS</c> + EF Core
/// <c>MigrateAsync</c>, который сверяется с таблицей истории <c>__TenantMigrationsHistory</c> схемы тенанта
/// и применяет ТОЛЬКО неприменённые миграции (повторный прогон ничего не меняет). Поэтому пакетный прогон
/// безопасен и при повторном запуске, и параллельно со стартовым bootstrap. Сбой одной схемы не прерывает
/// остальные: ошибка логируется, схема попадает в <see cref="TenantMigrationSummary.FailedSchemas"/>, а
/// операция завершается итоговой сводкой. Степень параллелизма клампится разумными границами, чтобы не
/// перегрузить Postgres при большом реестре.
/// </remarks>
public sealed class TenantSchemaMigrationService(
ITenantRepository tenantRepository,
ITenantProvisioner tenantProvisioner,
ILogger<TenantSchemaMigrationService> logger)
{
/// <summary>
/// Параллелизм пакетной миграции по умолчанию (схем одновременно).
/// </summary>
public const int DefaultMaxParallelism = 4;
// Нижняя граница параллелизма (ноль/отрицательное значение недопустимо).
private const int MinMaxParallelism = 1;
// Верхняя граница параллелизма: защита Postgres от лавины одновременных DDL-подключений.
private const int MaxMaxParallelism = 32;
/// <summary>
/// Мигрирует схемы всех тенантов реестра с параллелизмом по умолчанию.
/// </summary>
/// <param name="ct">Токен отмены.</param>
/// <returns>Итоговая сводка пакетной миграции.</returns>
public Task<TenantMigrationSummary> MigrateAllAsync(CancellationToken ct)
=> MigrateAllAsync(DefaultMaxParallelism, ct);
/// <summary>
/// Мигрирует схемы всех тенантов реестра с заданным параллелизмом (значение клампится).
/// </summary>
/// <param name="maxParallelism">Желаемое число схем, мигрируемых одновременно.</param>
/// <param name="ct">Токен отмены.</param>
/// <returns>Итоговая сводка пакетной миграции.</returns>
public async Task<TenantMigrationSummary> MigrateAllAsync(int maxParallelism, CancellationToken ct)
{
int parallelism = Math.Clamp(maxParallelism, MinMaxParallelism, MaxMaxParallelism);
IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct).ConfigureAwait(false);
var stopwatch = Stopwatch.StartNew();
if (tenants.Count == 0)
{
stopwatch.Stop();
logger.LogInformation("Пакетная миграция схем: в реестре нет тенантов — мигрировать нечего");
return new TenantMigrationSummary(0, 0, 0, stopwatch.ElapsedMilliseconds, []);
}
var failedSchemas = new ConcurrentBag<string>();
int migrated = 0;
await Parallel.ForEachAsync(
tenants,
new ParallelOptions { MaxDegreeOfParallelism = parallelism, CancellationToken = ct },
async (tenant, token) =>
{
var tenantId = new TenantId(tenant.Id.ToString("N"));
try
{
await tenantProvisioner.ProvisionAsync(tenantId, token).ConfigureAwait(false);
int done = Interlocked.Increment(ref migrated);
logger.LogInformation(
"Пакетная миграция схем: {Done}/{Total} — {Schema} готова",
done,
tenants.Count,
tenantId.SchemaName);
}
catch (Exception exception) when (exception is not OperationCanceledException)
{
failedSchemas.Add(tenantId.SchemaName);
logger.LogError(
exception,
"Пакетная миграция схем: {Schema} не мигрирована",
tenantId.SchemaName);
}
}).ConfigureAwait(false);
stopwatch.Stop();
var summary = new TenantMigrationSummary(
tenants.Count,
migrated,
failedSchemas.Count,
stopwatch.ElapsedMilliseconds,
failedSchemas.OrderBy(schema => schema, StringComparer.Ordinal).ToArray());
logger.LogInformation(
"Пакетная миграция схем завершена: всего {Total}, успешно {Migrated}, сбоев {Failed}, {DurationMs} мс",
summary.Total,
summary.Migrated,
summary.Failed,
summary.DurationMs);
return summary;
}
}
using System.Collections.Concurrent;
using System.Diagnostics;
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.SharedKernel.Tenants;
using Microsoft.Extensions.Logging;
namespace Deal.Infrastructure.Tenancy;
/// <summary>
/// Пакетная (maintenance) миграция схем ВСЕХ существующих тенантов реестра (этап 12, пакет C) с
/// ограниченным параллелизмом и логированием прогресса — для провижининга SaaS на сотни/тысячи схем.
/// </summary>
/// <remarks>
/// Идемпотентность обеспечивает сам провижининг: <c>CREATE SCHEMA IF NOT EXISTS</c> + EF Core
/// <c>MigrateAsync</c>, который сверяется с таблицей истории <c>__TenantMigrationsHistory</c> схемы тенанта
/// и применяет ТОЛЬКО неприменённые миграции (повторный прогон ничего не меняет). Поэтому пакетный прогон
/// безопасен и при повторном запуске, и параллельно со стартовым bootstrap. Сбой одной схемы не прерывает
/// остальные: ошибка логируется, схема попадает в <see cref="TenantMigrationSummary.FailedSchemas"/>, а
/// операция завершается итоговой сводкой. Степень параллелизма клампится разумными границами, чтобы не
/// перегрузить Postgres при большом реестре.
/// </remarks>
public sealed class TenantSchemaMigrationService(
ITenantRepository tenantRepository,
ITenantProvisioner tenantProvisioner,
ILogger<TenantSchemaMigrationService> logger)
{
/// <summary>
/// Параллелизм пакетной миграции по умолчанию (схем одновременно).
/// </summary>
public const int DefaultMaxParallelism = 4;
// Нижняя граница параллелизма (ноль/отрицательное значение недопустимо).
private const int MinMaxParallelism = 1;
// Верхняя граница параллелизма: защита Postgres от лавины одновременных DDL-подключений.
private const int MaxMaxParallelism = 32;
/// <summary>
/// Мигрирует схемы всех тенантов реестра с параллелизмом по умолчанию.
/// </summary>
/// <param name="ct">Токен отмены.</param>
/// <returns>Итоговая сводка пакетной миграции.</returns>
public Task<TenantMigrationSummary> MigrateAllAsync(CancellationToken ct)
=> MigrateAllAsync(DefaultMaxParallelism, ct);
/// <summary>
/// Мигрирует схемы всех тенантов реестра с заданным параллелизмом (значение клампится).
/// </summary>
/// <param name="maxParallelism">Желаемое число схем, мигрируемых одновременно.</param>
/// <param name="ct">Токен отмены.</param>
/// <returns>Итоговая сводка пакетной миграции.</returns>
public async Task<TenantMigrationSummary> MigrateAllAsync(int maxParallelism, CancellationToken ct)
{
int parallelism = Math.Clamp(maxParallelism, MinMaxParallelism, MaxMaxParallelism);
IReadOnlyList<TenantRecordDto> tenants = await tenantRepository.ListAsync(ct).ConfigureAwait(false);
var stopwatch = Stopwatch.StartNew();
if (tenants.Count == 0)
{
stopwatch.Stop();
logger.LogInformation("Пакетная миграция схем: в реестре нет тенантов — мигрировать нечего");
return new TenantMigrationSummary(0, 0, 0, stopwatch.ElapsedMilliseconds, []);
}
var failedSchemas = new ConcurrentBag<string>();
int migrated = 0;
await Parallel.ForEachAsync(
tenants,
new ParallelOptions { MaxDegreeOfParallelism = parallelism, CancellationToken = ct },
async (tenant, token) =>
{
var tenantId = new TenantId(tenant.Id.ToString("N"));
try
{
await tenantProvisioner.ProvisionAsync(tenantId, token).ConfigureAwait(false);
int done = Interlocked.Increment(ref migrated);
logger.LogInformation(
"Пакетная миграция схем: {Done}/{Total} — {Schema} готова",
done,
tenants.Count,
tenantId.SchemaName);
}
catch (Exception exception) when (exception is not OperationCanceledException)
{
failedSchemas.Add(tenantId.SchemaName);
logger.LogError(
exception,
"Пакетная миграция схем: {Schema} не мигрирована",
tenantId.SchemaName);
}
}).ConfigureAwait(false);
stopwatch.Stop();
var summary = new TenantMigrationSummary(
tenants.Count,
migrated,
failedSchemas.Count,
stopwatch.ElapsedMilliseconds,
failedSchemas.OrderBy(schema => schema, StringComparer.Ordinal).ToArray());
logger.LogInformation(
"Пакетная миграция схем завершена: всего {Total}, успешно {Migrated}, сбоев {Failed}, {DurationMs} мс",
summary.Total,
summary.Migrated,
summary.Failed,
summary.DurationMs);
return summary;
}
}
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Abstractions;
/// <summary>
/// Порт «пейсера» Discovery: паузы между сетевыми действиями (план Task 18, Ruling 10).
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Abstractions;
/// <summary>
/// Счётчик ошибок поиска одного ключа по задачам (discovery_worker._search_errors L82, план Task 18).
@@ -1,6 +1,10 @@
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application;
namespace Deal.Modules.Discovery.Application.Abstractions;
/// <summary>
/// Порт хранилища Discovery: таблицы DiscTasks/DiscCandidates/DiscBlacklist/DiscLog схемы тенанта (Ruling 9, Task 17).
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Exceptions;
/// <summary>
/// Доменная ошибка запроса Discovery — 400-семантика (аналог ValueError discovery.py).
@@ -1,6 +1,10 @@
using Deal.Modules.Discovery.Application.Models;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application;
namespace Deal.Modules.Discovery.Application.Extensions;
internal static class DiscoveryTaskPatchExtensions
{
@@ -6,21 +6,21 @@ namespace Deal.Modules.Discovery.Application.Models;
/// <remarks>
/// Поля 1:1 с _candidate_view discovery.py L140158 и строкой disc_candidates (db.py L159176). marks/topics —
/// JSON-колонки, наружу всегда списки (marks — строки-метки, topics — элементы <see cref="DiscoveryTopicDto"/> для
/// форумов). Статус — <see cref="Deal.Modules.Discovery.Application.DiscoveryCandidateStatuses"/>; переводы в
/// форумов). Статус — <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryCandidateStatuses"/>; переводы в
/// joined/rejected — только через mark_joined/mark_rejected.
/// </remarks>
/// <param name="DialogId">Подписанный id источника (первичный ключ кандидата; как Dialogs.Id).</param>
/// <param name="TaskId">Id задачи поиска, которой принадлежит кандидат.</param>
/// <param name="Name">Отображаемое имя источника (пусто → DialogId).</param>
/// <param name="Username">Username (handle) источника; пуст, если нет публичного username.</param>
/// <param name="Kind">Тип источника: channel|group|forum (см. <see cref="Deal.Modules.Discovery.Application.DiscoveryCandidateKinds"/>).</param>
/// <param name="Kind">Тип источника: channel|group|forum (см. <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryCandidateKinds"/>).</param>
/// <param name="Hue">Цвет источника из палитры DIALOG_HUES (hex «#rrggbb»; дефолт «#666»).</param>
/// <param name="Participants">Число участников (после discovery_info); null — неизвестно.</param>
/// <param name="LangRu">Язык источника: true — русский, false — не русский, null — не определён.</param>
/// <param name="Marks">Метки оценки («закрытая группа (история скрыта)», «мало сообщений», …).</param>
/// <param name="Topics">Оценка тем форума (kind=forum; для каналов/групп пуст).</param>
/// <param name="FitRatio">Доля подходящих сообщений оценки (0..1); null — контент не оценён.</param>
/// <param name="Status">Статус кандидата (см. <see cref="Deal.Modules.Discovery.Application.DiscoveryCandidateStatuses"/>).</param>
/// <param name="Status">Статус кандидата (см. <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryCandidateStatuses"/>).</param>
/// <param name="AutoJoined">Вступили автоматически (воркером); false — вручную (join из UI).</param>
/// <param name="JoinFailures">Неудачные авто-вступления подряд (3 → кандидат удаляется, Task 18).</param>
/// <param name="CreatedAt">Время добавления, epoch-ms.</param>
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// Типы источников-кандидатов Discovery (колонка DiscCandidates.Kind; api-map §4.8, discovery_worker _kind_code).
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// Статусы кандидата Discovery (колонка DiscCandidates.Status; discovery.py L171, api-map §4.8).
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// Счётчики прогресса задачи поиска (колонки DiscTasks Found/Evaluated/Joined/Rejected; discovery.py L359368).
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// Агрегат оценки выборки сообщений (python evaluate_sample L197226: fit_count/total/fit_ratio/per_message).
@@ -1,6 +1,11 @@
using System.Security.Cryptography;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// Префиксы коротких id модуля Discovery и их генерация (прототип store.uid в discovery.py).
@@ -5,12 +5,12 @@ namespace Deal.Modules.Discovery.Application.Models;
/// </summary>
/// <remarks>
/// Поля 1:1 с _log_view discovery.py L170177 и строкой disc_log (db.py L189195). Событие — каталог
/// <see cref="Deal.Modules.Discovery.Application.DiscoveryLogEvents"/> (search|skip|review|join_auto|join_manual|
/// <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryLogEvents"/> (search|skip|review|join_auto|join_manual|
/// reject|flood|error|done|…). Список — последние события задачи, новые сверху (ORDER BY created_at DESC).
/// </remarks>
/// <param name="Id">Короткий id записи (префикс <c>dl_</c>).</param>
/// <param name="TaskId">Id задачи поиска.</param>
/// <param name="Event">Событие (см. <see cref="Deal.Modules.Discovery.Application.DiscoveryLogEvents"/>).</param>
/// <param name="Event">Событие (см. <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryLogEvents"/>).</param>
/// <param name="Text">Текст/детали события (русская строка 1:1 с прототипом).</param>
/// <param name="CreatedAt">Время события, epoch-ms.</param>
public sealed record DiscoveryLogDto(
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// События лога задачи Discovery (колонка DiscLog.Event; discovery.py L187188, api-map §3.8).
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// Вердикт фита одного сообщения (python evaluate_message L174194).
@@ -5,7 +5,7 @@ namespace Deal.Modules.Discovery.Application.Models;
/// </summary>
/// <remarks>
/// Поля 1:1 с _task_view discovery.py L116137 и строкой disc_tasks (db.py L136156). JSON-поле keywords
/// наружу всегда список строк; статус — <see cref="Deal.Modules.Discovery.Application.DiscoveryTaskStatuses"/>.
/// наружу всегда список строк; статус — <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryTaskStatuses"/>.
/// createdAt/updatedAt — epoch-ms (времена хранятся UTC, на границе переводятся в ms — конвенция проекта).
/// </remarks>
/// <param name="Id">Короткий id задачи (префикс <c>dt_</c>).</param>
@@ -18,7 +18,7 @@ namespace Deal.Modules.Discovery.Application.Models;
/// <param name="SampleSize">Размер выборки сообщений при оценке (≥1; дефолт discEvalSample).</param>
/// <param name="PlanJoins">План авто-вступлений задачи (1..discJoinLimit; занимает суточный бюджет).</param>
/// <param name="AutoJoin">Авто-вступления воркером включены (иначе кандидатов вступает человек).</param>
/// <param name="Status">Статус задачи (см. <see cref="Deal.Modules.Discovery.Application.DiscoveryTaskStatuses"/>).</param>
/// <param name="Status">Статус задачи (см. <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryTaskStatuses"/>).</param>
/// <param name="SearchIdx">Индекс текущего ключа поиска (прогресс прохода по keywords).</param>
/// <param name="SearchDone">Проход по всем ключам завершён (searchIdx ≥ keywords.Count).</param>
/// <param name="Found">Найдено кандидатов (счётчик found).</param>
@@ -5,7 +5,7 @@ namespace Deal.Modules.Discovery.Application.Models;
/// </summary>
/// <remarks>
/// Write-модель: содержит полное состояние новой задачи, включая готовый id (<c>dt_...</c>, генерирует модуль —
/// <see cref="Deal.Modules.Discovery.Application.DiscoveryIdPrefixes"/>). Служебные значения, вычисленные до
/// <see cref="Deal.Modules.Discovery.Application.Models.DiscoveryIdPrefixes"/>). Служебные значения, вычисленные до
/// записи: Status=<c>draft</c>, SearchIdx=0, SearchDone=false, счётчики Found/Evaluated/Joined/Rejected=0 —
/// как в INSERT прототипа discovery.py L260280. CreatedAt/UpdatedAt проставляет хранилище (UTC-now);
/// keywords адаптер сериализует в JSON при записи.
@@ -1,4 +1,10 @@
namespace Deal.Modules.Discovery.Application;
using Deal.Modules.Discovery.Application.Abstractions;
using Deal.Modules.Discovery.Application.Exceptions;
using Deal.Modules.Discovery.Application.Extensions;
using Deal.Modules.Discovery.Application.Registrars;
using Deal.Modules.Discovery.Application.Services;
namespace Deal.Modules.Discovery.Application.Models;
/// <summary>
/// Статусы задачи поиска Discovery (колонка DiscTasks.Status; discovery.py L147, api-map §4.8).

Some files were not shown because too many files have changed in this diff Show More