feat(admin_wordsearch): exclude_maxed_words — не отдавать слова с usage_count >= 5

Слова, использованные в 5+ уровнях, «выгорают» — больше не возвращаются
в конструктор. Админ не может случайно повторно использовать слово.

- get_csv_words: WHERE COALESCE(u.usage_count, 0) < 5
- Хардкод 5 = MAX_USAGE_COUNT (в будущем — в константу)
This commit is contained in:
2026-10-03 17:20:28 +00:00
parent 98ac403675
commit 80b7f6b419
+18
View File
@@ -20,6 +20,9 @@ CRUD слов:
- DELETE /admin/wordsearch/words/{word_id} — удалить слово
🔧 ОБНОВЛЕНО (30.09.2026): /words/all — пагинация + total.
🔧 ОБНОВЛЕНО (03.10.2026): exclude_maxed_words —
/words не отдаёт слова с usage_count >= 5 (MAX_USAGE_COUNT).
"""
import json
import logging
@@ -37,6 +40,11 @@ router = APIRouter(prefix="/admin/wordsearch", tags=["admin-wordsearch"])
LEVELS = ["A1", "A2", "B1", "B2", "C1", "C2"]
MAX_GRID_SIZE = 15
# 🔧 НОВОЕ (03.10.2026): MAX_USAGE_COUNT —
# слово считается «выгоревшим» после 5 использований и не отдаётся
# в конструктор. Хардкод, но легко вынести в конфиг.
MAX_USAGE_COUNT = 5
def _json_or_value(v):
"""🔧 ФИКС (30.09.2026): asyncpg_jsonb_string —
@@ -62,6 +70,11 @@ async def get_csv_words(request: Request, level: str = "A1"):
Список слов из CSV для уровня с счётчиком использований.
Сортировка: сначала неиспользованные, потом по алфавиту.
🔧 ОБНОВЛЕНО (03.10.2026): exclude_maxed_words —
слова с usage_count >= MAX_USAGE_COUNT (5) «выгорели» (использованы
слишком много раз). Не отдаём их в конструктор, чтобы админ не мог
использовать повторно.
"""
telegram_id, _ = await require_auth(request)
_require_admin(telegram_id)
@@ -71,6 +84,10 @@ async def get_csv_words(request: Request, level: str = "A1"):
pool = await get_pool()
async with pool.acquire() as conn:
# 🔧 ОБНОВЛЕНО (03.10.2026): exclude_maxed_words —
# слова с usage_count >= 5 «выгорели» (использованы 5 раз).
# Не отдаём их в конструктор, чтобы админ не мог использовать
# повторно. Хардкод 5 = MAX_USAGE_COUNT.
rows = await conn.fetch("""
SELECT
w.word_pl,
@@ -82,6 +99,7 @@ async def get_csv_words(request: Request, level: str = "A1"):
LEFT JOIN word_usage u
ON u.word_pl = w.word_pl AND u.level_code = w.level_code
WHERE w.level_code = $1
AND COALESCE(u.usage_count, 0) < 5
ORDER BY COALESCE(u.usage_count, 0) ASC, w.word_pl ASC
""", level)