Почистить комментарии от упоминаний процесса
Удалены <remarks>, <summary> сжаты до короткой фразы, вырезаны ссылки на Task/Ruling/этап/python/прототип; //-комментарии со ссылками на процесс удалены; то же в .proto. Правила обновлены в docs/spec/Код-стайл-Дейл.md. Строк комментариев 27210 -> ~19100.
This commit is contained in:
@@ -1,21 +1,17 @@
|
||||
namespace Deal.Telegram.Telegram;
|
||||
|
||||
/// <summary>
|
||||
/// Результат чтения выборки источника для оценки кандидата (план Task 11; 1:1 discovery_read
|
||||
/// python-прототипа telegram.py L718–760: {ok, error, messages}).
|
||||
///
|
||||
/// ok=false — история недоступна (приватный/закрытый источник без членства), error="no_history";
|
||||
/// это НЕ ошибка сессии/RPC, а нормальный ответ контракта (ReadForEvalReply.ok=false).
|
||||
/// Результат чтения выборки источника для оценки кандидата.
|
||||
/// </summary>
|
||||
public sealed record DiscoveryReadResult
|
||||
{
|
||||
/// <summary>
|
||||
/// Код причины ok=false: история недоступна без членства (1:1 прототип L726).
|
||||
/// Код причины ok=false
|
||||
/// </summary>
|
||||
public const string NoHistoryError = "no_history";
|
||||
|
||||
/// <summary>
|
||||
/// Пустой успешный результат (limit ≤ 0 — выборка не запрашивалась, прототип L730–732).
|
||||
/// Пустой успешный результат.
|
||||
/// </summary>
|
||||
public static DiscoveryReadResult Empty { get; } = new(true, null, []);
|
||||
|
||||
@@ -36,7 +32,7 @@ public sealed record DiscoveryReadResult
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Создаёт результат «история недоступна» (ok=false, error=no_history, сообщений нет).
|
||||
/// Создаёт результат «история недоступна»
|
||||
/// </summary>
|
||||
public static DiscoveryReadResult NoHistory()
|
||||
=> new(false, NoHistoryError, []);
|
||||
@@ -47,12 +43,12 @@ public sealed record DiscoveryReadResult
|
||||
public bool Ok { get; }
|
||||
|
||||
/// <summary>
|
||||
/// Код причины при ok=false: "no_history"; иначе null.
|
||||
/// Код причины при ok=false
|
||||
/// </summary>
|
||||
public string? Error { get; }
|
||||
|
||||
/// <summary>
|
||||
/// Сообщения выборки (для обычных источников topic_id/topic_title пусты).
|
||||
/// Сообщения выборки
|
||||
/// </summary>
|
||||
public IReadOnlyList<DiscoveryMessage> Messages { get; }
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user