Files
filwordspl-backend/routers/hints.py

200 lines
8.6 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import random
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, found: str = ""):
"""Подсказка: показывает первую букву случайного ненайденного слова"""
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")
word_paths = level["word_paths"]
if isinstance(word_paths, str):
import json
word_paths = json.loads(word_paths)
# Слова уровня, у которых есть путь в word_paths
all_level_words = [w["word_pl"] for w in words]
words_with_paths = [
w for w in all_level_words
if w in word_paths and word_paths[w]
]
if not words_with_paths:
raise HTTPException(404, "No word paths found for this level")
# 🔧 ФИКС (12.10.2026): hint_shows_found_word —
# подсказка показывала уже найденное слово. Теперь фронт передаёт
# найденные слова в query-параметре found (через запятую), и мы
# исключаем их из кандидатов.
found_words = {w.strip() for w in found.split(",") if w.strip()}
remaining_words = [w for w in words_with_paths if w not in found_words]
if not remaining_words:
raise HTTPException(404, "All words found")
# 🔧 ФИКС (11.10.2026): hint_always_first_word —
# раньше всегда возвращалось первое слово списка, поэтому
# повторные нажатия давали одну и ту же букву. Теперь слово
# выбирается случайно из ещё не найденных.
found_word = random.choice(remaining_words)
first_cell = word_paths[found_word][0]
# 🔧 ФИКС (25.09.2026): hint_consumed_before_word_paths_check —
# инкрементим hints_used ТОЛЬКО после всех проверок.
# Раньше при 404 (нет word_paths) подсказка уже была потрачена.
#
# 🔧 ФИКС (25.09.2026): hints_used_never_incremented_actually —
# раньше при отсутствии строки user_progress UPDATE затрагивал 0 строк,
# и лимит 3 подсказки не работал для новых юзеров.
# Теперь UPSERT: INSERT с ON CONFLICT DO UPDATE.
await conn.execute("""
INSERT INTO user_progress (user_id, level_id, hints_used)
VALUES ($1, $2, 1)
ON CONFLICT (user_id, level_id) DO UPDATE
SET hints_used = user_progress.hints_used + 1
""", telegram_id, level_id)
hints_already_used += 1
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
# 🔧 ФИКС (01.10.2026): word_list_is_not_hint —
# «Показать слова» — базовая функция (в UI написано ∞),
# НЕ расходует лимит подсказок и НЕ уменьшает очки.
# Раньше зря инкрементился hints_used → минус 10 очков за уровень.
# Лимит 3 остаётся ТОЛЬКО для «Первой буквы».
words = await conn.fetch(
"SELECT * FROM level_words WHERE level_id = $1 ORDER BY word_pl", level_id
)
if not words:
raise HTTPException(404, "No words found for this level")
# hints_used НЕ инкрементим. hints_already_used читаем из БД для информации.
# Определяем язык пользователя
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,
}