Продуктовые: - 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 задач
195 lines
7.7 KiB
Python
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,
|
|
} |