Files
filwordspl-backend/routers/hints.py
T
Drobysh 3d75a00046 🌊 Волна 17: backend #8 — баги + N+1 (16 багов)
Продуктовые:
- hint_consumed_before_word_check: сначала проверка слов, потом инкремент (hints.py)
- hint_fake_first_cell: 404 вместо [0,0] (hints.py)
- leaderboard_rank_wrong_for_uncached_user: корректный rank (leaderboard.py)
- teacher_ai_explanation_empty_on_failure: fallback-текст (teacher.py)

Данные:
- duplicate_delete_keeps_wrong_row: оставляем лучшую строку (database.py)

Security:
- fastapi_docs_exposed: /docs скрыт в проде (main.py)
- cf_ip_check_per_request: предкомпиляция CF_IPS (main.py)

N+1:
- admin_content_lesson_levels_n_plus_1: 3 GROUP BY (admin_content.py)
- admin_content_lesson_topics_n_plus_1: 2 GROUP BY (admin_content.py)
- admin_content_get_lesson_n_plus_1: ANY + группировка (admin_content.py)
- teacher_progress_n_plus_1: 2 GROUP BY (teacher.py)
- teacher_diagnostic_test_n_plus_1: ANY + группировка (teacher.py)
- orchestrator_n_plus_1_options: ANY + группировка (orchestrator.py)

Качество:
- cleanup_task_leak_on_startup_failure: cleanup после init (main.py)
- unused_first_name: удалена мёртвая переменная (auth.py)

Пропущено осознанно:
- initdata_in_query_param (fallback deleteFeedPost)
- init_db_slow_startup (Alembic, отдельная задача)

Аудит v5: Issue #8, backend 16/17 задач
2026-09-24 17:35:14 +00:00

195 lines
7.7 KiB
Python

from fastapi import APIRouter, Request, HTTPException
from auth import require_auth
from database import get_pool
router = APIRouter(prefix="/hints", tags=["hints"])
@router.get("/first-letter/{level_id}")
async def get_first_letter_hint(request: Request, level_id: int):
"""Подсказка: показывает первую букву случайного ненайденного слова"""
telegram_id, _ = await require_auth(request)
pool = await get_pool()
async with pool.acquire() as conn:
# Проверяем, что уровень существует
level = await conn.fetchrow("SELECT * FROM levels WHERE id = $1", level_id)
if not level:
raise HTTPException(404, "Level not found")
# Проверяем, что пользователь существует
user_exists = await conn.fetchval(
"SELECT 1 FROM users WHERE telegram_id = $1", telegram_id
)
if not user_exists:
raise HTTPException(401, "User not registered")
# Получаем прогресс пользователя по этому уровню
progress = await conn.fetchrow(
"SELECT hints_used FROM user_progress WHERE user_id = $1 AND level_id = $2",
telegram_id, level_id
)
hints_already_used = progress["hints_used"] if progress else 0
# 🔧 ФИКС (23.09.2026): hints_not_incremented — лимит 3 подсказки не работал,
# hints_used никогда не рос. Теперь проверяем лимит и инкрементим в той же транзакции.
MAX_HINTS = 3
if hints_already_used >= MAX_HINTS:
raise HTTPException(403, "Hint limit reached")
# 🔧 ФИКС (25.09.2026): hint_consumed_before_word_check —
# сначала проверяем, что у уровня ЕСТЬ слова, и только потом
# инкрементим hints_used. Раньше при 404 hints_used уже +1.
words = await conn.fetch(
"SELECT word_pl FROM level_words WHERE level_id = $1", level_id
)
if not words:
raise HTTPException(404, "No words found for this level")
# Теперь безопасно инкрементим счётчик
if progress:
await conn.execute(
"UPDATE user_progress SET hints_used = hints_used + 1 WHERE user_id = $1 AND level_id = $2",
telegram_id, level_id
)
else:
await conn.execute(
"INSERT INTO user_progress (user_id, level_id, hints_used) VALUES ($1, $2, 1)",
telegram_id, level_id
)
hints_already_used += 1
word_paths = level["word_paths"]
if isinstance(word_paths, str):
import json
word_paths = json.loads(word_paths)
# Находим первое слово, у которого есть путь
all_level_words = [w["word_pl"] for w in words]
# Ищем слово с путём (сначала основные, потом filler-слова)
found_word = None
first_cell = None
for word in all_level_words:
if word in word_paths and word_paths[word]:
found_word = word
first_cell = word_paths[word][0]
break
# 🔧 ФИКС (25.09.2026): hint_fake_first_cell —
# если ни у одного слова нет пути в word_paths, подсказка
# бессмысленна. Возвращаем 404, а не фейковую координату [0,0].
if not found_word:
raise HTTPException(404, "No word paths found for this level")
return {
"status": "ok",
"word": found_word,
"first_cell": first_cell,
"hints_used_total": hints_already_used,
}
@router.get("/word-list/{level_id}")
async def get_word_list(request: Request, level_id: int):
"""Подсказка: показывает список всех слов уровня с переводами"""
telegram_id, _ = await require_auth(request)
pool = await get_pool()
async with pool.acquire() as conn:
# Проверяем, что уровень существует
level = await conn.fetchrow("SELECT id FROM levels WHERE id = $1", level_id)
if not level:
raise HTTPException(404, "Level not found")
# Проверяем, что пользователь существует
user_exists = await conn.fetchval(
"SELECT 1 FROM users WHERE telegram_id = $1", telegram_id
)
if not user_exists:
raise HTTPException(401, "User not registered")
# Получаем прогресс пользователя
progress = await conn.fetchrow(
"SELECT hints_used FROM user_progress WHERE user_id = $1 AND level_id = $2",
telegram_id, level_id
)
hints_already_used = progress["hints_used"] if progress else 0
# 🔧 ФИКС (23.09.2026): hints_not_incremented — лимит 3 подсказки не работал,
# hints_used никогда не рос. Теперь проверяем лимит и инкрементим в той же транзакции.
MAX_HINTS = 3
if hints_already_used >= MAX_HINTS:
raise HTTPException(403, "Hint limit reached")
if progress:
await conn.execute(
"UPDATE user_progress SET hints_used = hints_used + 1 WHERE user_id = $1 AND level_id = $2",
telegram_id, level_id
)
else:
await conn.execute(
"INSERT INTO user_progress (user_id, level_id, hints_used) VALUES ($1, $2, 1)",
telegram_id, level_id
)
hints_already_used += 1
# Получаем слова
words = await conn.fetch(
"SELECT * FROM level_words WHERE level_id = $1 ORDER BY word_pl", level_id
)
# Определяем язык пользователя
user = await conn.fetchrow(
"SELECT app_language FROM users WHERE telegram_id = $1", telegram_id
)
lang = user["app_language"] if user else "pl"
# Формируем список с переводами
translation_field = f"translation_{lang}"
word_list = []
for w in words:
translation = (
w.get(translation_field) or
w.get("translation_pl") or
w.get("translation_en") or
""
)
word_list.append({
"word_pl": w["word_pl"],
"translation": translation,
})
return {
"status": "ok",
"words": word_list,
"total_words": len(word_list),
"hints_used_total": hints_already_used,
}
@router.get("/remaining/{level_id}")
async def get_remaining_hints(request: Request, level_id: int):
"""Возвращает количество оставшихся подсказок для уровня"""
telegram_id, _ = await require_auth(request)
pool = await get_pool()
async with pool.acquire() as conn:
progress = await conn.fetchrow(
"SELECT hints_used FROM user_progress WHERE user_id = $1 AND level_id = $2",
telegram_id, level_id
)
hints_used = progress["hints_used"] if progress else 0
max_hints = 3
remaining = max(0, max_hints - hints_used)
return {
"max_hints": max_hints,
"hints_used": hints_used,
"remaining": remaining,
}