Почистить комментарии от упоминаний процесса

Удалены <remarks>, <summary> сжаты до короткой фразы, вырезаны
ссылки на Task/Ruling/этап/python/прототип; //-комментарии со ссылками
на процесс удалены; то же в .proto. Правила обновлены в
docs/spec/Код-стайл-Дейл.md. Строк комментариев 27210 -> ~19100.
This commit is contained in:
Rustam Khalimov
2026-09-11 13:39:39 +03:00
parent 5f5538d33b
commit b053d58335
902 changed files with 3902 additions and 12074 deletions
@@ -3,17 +3,10 @@ using System.Diagnostics.CodeAnalysis;
namespace Deal.Telegram.Caching;
/// <summary>
/// Кэш с ограниченной ёмкостью и вытеснением least-recently-used (LRU): при переполнении удаляется
/// элемент, к которому дольше всего не обращались. Нужен там, где раньше жил неограниченный
/// <see cref="Dictionary{TKey,TValue}"/> и память росла с числом сущностей (долгоживущий процесс сервиса).
/// Кэш с ограниченной ёмкостью и вытеснением least-recently-used
/// </summary>
/// <remarks>
/// НЕ потокобезопасен: вызывающий обязан сериализовать доступ (в telegram-service кэши
/// WTelegramSessionClient защищены общим <c>_entityCacheGate</c>). Вытеснение — забота производительности,
/// а не корректности: потерянное значение всегда можно получить повторным запросом к Telegram.
/// </remarks>
/// <typeparam name="TKey">Тип ключа (ссылочный или значимый).</typeparam>
/// <typeparam name="TValue">Тип значения.</typeparam>
/// <param name="TKey">Тип ключа (ссылочный или значимый).</param>
/// <param name="TValue">Тип значения.</param>
public sealed class LruCache<TKey, TValue>
where TKey : notnull
{
@@ -66,15 +59,14 @@ public sealed class LruCache<TKey, TValue>
}
/// <summary>
/// Проверяет наличие ключа, не меняя недавность (лёгкая проверка без вытеснения).
/// Проверяет наличие ключа, не меняя недавность
/// </summary>
/// <param name="key">Ключ.</param>
/// <returns>True — ключ есть в кэше.</returns>
public bool ContainsKey(TKey key) => _map.ContainsKey(key);
/// <summary>
/// Записывает значение по ключу (вставка или обновление) и вытесняет самый давний элемент при
/// переполнении. Обновление существующего ключа делает его самым недавним.
/// Записывает значение по ключу
/// </summary>
/// <param name="key">Ключ.</param>
/// <param name="value">Значение.</param>