Files
filwordspl-backend/routers/hints.py
T
Drobysh f2715b7593 🌊 Волна 1: backend продукты + security (12 багов)
Продуктовые фиксы:
- hints_not_incremented: лимит 3 подсказки теперь работает (hints.py)
- assistant_quota_burned_on_ai_failure: лимит не списывается при ошибке AI (assistant.py)
- learning_save_answer_missing_session_check: 500 → 404 + проверка владельца (learning.py)
- teacher_hardcoded_a1_level: реальный уровень из users вместо 'A1' (teacher.py, 3 места)

Security:
- hardcoded_default_admin: пустой дефолт ADMIN_IDS (config.py)
- double_unquote_initdata: убран повторный unquote (auth.py)
- auth_error_leak: обобщённая ошибка вместо str(e) (auth.py)
- xforwarded_for_spoof: доверяем только cf-connecting-ip (main.py)
- initdata_age_24h: 24ч → 4ч (config.py)

Качество:
- drop_matview_on_startup: убран DROP при рестарте (main.py)
- leaderboard_refresh_30s: 30с → 300с (main.py)
- teacher_create_table_on_every_request: TODO на вынос DDL (teacher.py)

Аудит: Issue #4, backend 12/20 задач
2026-09-23 11:41:26 +00:00

188 lines
7.1 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")
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 word_pl FROM level_words WHERE level_id = $1", level_id
)
if not words:
raise HTTPException(404, "No words found for this level")
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
if not found_word:
# Если пути не нашлись — берём любое слово
found_word = all_level_words[0]
first_cell = [0, 0]
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,
}