Проблема: При /resume диагностического теста (session_type='diagnostic_test') код идёт в else-ветку, ищет lesson_id по topic_id='' → questions=[] → возвращает has_active_session=False. Ученик теряет прогресс диагностики.
Как воспроизвести: Начать /diagnostic-test → ответить на 3 вопроса → закрыть → /resume → has_active_session=False, сессия потеряна.
Что сделать: Добавить ветку для session_type == 'diagnostic_test': перезагружать вопросы через тот же запрос, что и в teacher_diagnostic_test (ORDER BY RANDOM() LIMIT 15 не воспроизводит порядок — нужно хранить question_ids в сессии).
Проблема: Параметр hint_used в save_answer_to_session всегда False — если ученик использовал подсказку, это не фиксируется в БД. Аналитика и mastery искажаются.
Как воспроизвести: Использовать подсказку → ответить → в user_learning_answers.hint_used = FALSE.
Что сделать: Принимать hint_used из body запроса и передавать в save_answer_to_session.
Confidence: 0.87
6. diagnostic_test_questions_not_persisted
Файл:routers/teacher.py:780
Snippet:SELECT * FROM learning_questions WHERE is_test_question = TRUE ORDER BY RANDOM() LIM
Проблема: Диагностический тест выбирает 15 случайных вопросов, но не сохраняет их список в сессии. При /resume или перезагрузке страницы вопросы будут другими — ученик не сможет завершить тест.
Как воспроизвести: Начать /diagnostic-test, ответить на 5 вопросов, вызвать /resume — вопросы перегенерируются, прогресс ломается.
Что сделать: Сохранять question_ids в learning_sessions (JSONB-поле) при создании сессии и читать их при resume/answer.
Confidence: 0.85
7. answer_question_not_in_session 🔗 both
Файл:routers/teacher.py:620
Snippet:current_index = 0 for i, q in enumerate(questions): if q["question"]["question_id"] == question_id:
Проблема: Если question_id не найден в списке questions (например, при diagnostic_test или рассинхроне), current_index остаётся 0 → next_index=1 → ученику показывается второй вопрос вместо следующего. Прогресс сбивается.
Как воспроизвести: Отправить /answer с question_id, которого нет в текущем списке questions — получишь questions[1] вместо корректного next.
Что сделать: Если вопрос не найден (current_index не изменился и questions[0] != question_id) — вернуть 400/404, а не молча показывать questions[1].
Confidence: 0.85
8. orchestrator_weak_skill_ignores_retention
Файл:routers/orchestrator.py:78
Snippet:WHERE user_id = $1 AND mastery_score < 75 AND attempts_count >= 2
Проблема: Ученик с overdue-навыком без подходящего урока в learning_lessons проваливается в шаг 2 и получает тот же слабый навык, но с reason='weak_mastery' — цикл повторения не сдвигается
Как воспроизвести: overdue_skill найден, но lesson для его skill_tag отсутствует (is_active=FALSE) → шаг 2 возвращает тот же skill_tag
Что сделать: Исключить skill_tag из шага 2 (AND skill_tag != $2) или объединить шаги 1 и 2 в один запрос с приоритетом retention
Confidence: 0.8
9. orchestrator_lesson_id_not_in_null 🔗 both
Файл:routers/orchestrator.py:137
Snippet:AND l.lesson_id NOT IN ( SELECT lesson_id FROM user_lesson_progress WHERE user_id = $2 AND
Проблема: Если в user_lesson_progress есть строка с lesson_id = NULL, NOT IN вернёт пустой результат — ученик увидит 'all_completed' и не получит следующий урок
Как воспроизвести: INSERT INTO user_lesson_progress(user_id, lesson_id, completed) VALUES(1, NULL, TRUE) → orchestrator возвращает type='completed'
Что сделать: Заменить на NOT EXISTS или добавить AND lesson_id IS NOT NULL в подзапрос
Snippet:SELECT * FROM learning_questions WHERE lesson_id = $1 AND is_test_question = FALSE ORDER BY id
Проблема: В get_lesson_questions и get_test_questions нет фильтра is_active у вопросов — ученик может получить деактивированные/устаревшие вопросы, тогда как get_lesson_by_id использует тот же запрос без фильтра, но урок фильтруется по is_active
Как воспроизвести: UPDATE learning_questions SET is_active=FALSE WHERE lesson_id='x' → вопросы всё равно возвращаются
Что сделать: Добавить AND is_active = TRUE (если колонка существует) во все три запроса вопросов
Confidence: 0.75
11. review_always_first_lesson 🔵 secondary
Файл:routers/orchestrator.py:44
Snippet:WHERE l.skill_tag = $1 AND l.is_active = TRUE ORDER BY l.order_number LIMIT 1
Проблема: При повторении (overdue/weak) ученику всегда выдаётся ПЕРВЫЙ урок навыка по порядку, а не тот, где он ошибался — повторение бесконечно крутит один и тот же начальный урок, прогресс по слабому навыку не двигается
Как воспроизвести: провалить 3-й урок навыка → mastery < 75 → orchestrator раз за разом возвращает урок №1 этого навыка
Что сделать: выбирать урок с учётом user_lesson_progress (наименее освоенный/последний ошибочный) или сортировать по убыванию сложности/ошибкам
Confidence: 0.85
12. current_level_param_mismatch 🔵 secondary
Файл:routers/orchestrator.py:30
Snippet:SELECT current_level FROM users WHERE telegram_id = $1 """, user_id) or "A1"
Проблема: Если вызывающий код передаёт внутренний user_id (int PK), а не telegram_id, запрос вернёт NULL и молча подставится 'A1' — ученик с уровнем B1 получает уроки уровня A1
Как воспроизвести: вызвать get_next_lesson(conn, user_id=внутренний_pk) → current_level всегда 'A1' → шаг 4 выдаёт уроки A1
Что сделать: переименовать параметр в telegram_id или фильтровать по users.user_id; убрать молчаливый fallback 'A1' (логировать/падать)
Confidence: 0.78
13. test_step_no_level_check 🔵 secondary
Файл:routers/orchestrator.py:88
Snippet:WHERE tp.user_id = $1 AND tp.lessons_completed >= tp.lessons_total AND tp.lessons_total > 0
Проблема: Тест темы предлагается по user_topic_progress без проверки, что тема относится к текущему уровню и что lessons_total актуален; при рассинхроне lessons_total (например, тему расширили) ученика зациклит на тесте, хотя уроки темы не все пройдены фактически
Как воспроизвести: увеличить lessons_total у завершённой темы → lessons_completed >= lessons_total ложно, но если наоборот уменьшить — тест предлагается до прохождения добавленных уроков
Что сделать: сверять lessons_completed с фактическим числом активных уроков темы в learning_lessons
Confidence: 0.76
14. feed_get_feed_post_no_expires_check
Файл:routers/feed.py:178
Snippet:SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE
Проблема: Истёкший пост (expires_at < NOW()) всё равно отдаётся по прямому ID, хотя в списке секции он скрыт
Как воспроизвести: GET /feed/post/{id} для поста с истёкшим expires_at → пост возвращается
Что сделать: Добавить AND (expires_at IS NULL OR expires_at > NOW())
Confidence: 0.9
15. admin_dashboard_online_now_uses_wrong_columns
Файл:routers/admin.py:78
Snippet:SELECT user_id FROM user_progress WHERE completed_at > NOW() - INTERVAL '30 minutes'
Проблема: Метрика online_now показывает 0 или заниженное число — админ видит неверную статистику
Как воспроизвести: Открыть /admin/dashboard → online_now всегда 0, хотя юзеры активны
Что сделать: Проверить реальные имена колонок (user_id/completed_at) в user_progress, sentence_progress, user_learning_answers, chat_history; если их нет — запрос упадёт с UndefinedColumn
Confidence: 0.8
16. leaderboard_rank_off_by_one
Файл:routers/leaderboard.py:60
Snippet:user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot
Проблема: Ученик видит свой ранг на 1 позицию выше реального (например, реально 5-й, показывается 4-й), потому что COUNT(*) уже не включает его самого
Как воспроизвести: Открыть лидерборд → my_rank.rank не совпадает с позицией в списке leaderboard
Что сделать: Убрать +1: SELECT COUNT(*) FROM leaderboard_cache WHERE total_score > $1 (юзер уже в кэше, его не считаем)
Confidence: 0.9
17. login_streak_nondeterministic_grp 🔵 secondary
Файл:routers/achievements.py:262
Snippet:SELECT COUNT(*) FROM dates WHERE grp = (SELECT grp FROM dates LIMIT 1)
Проблема: Подзапрос (SELECT grp FROM dates LIMIT 1) без ORDER BY возвращает произвольную строку — серия входов считается нестабильно, достижение login_3/login_7 может не выдаться или streak показывается неверный.
Как воспроизвести: заходить несколько дней подряд → /achievements/track-login иногда возвращает streak=1 вместо реальной серии
Что сделать: (SELECT grp FROM dates ORDER BY login_date DESC LIMIT 1) или вычислять grp первой строки CTE
Confidence: 0.88
18. leaderboard_rank_achievement_uses_wrong_rank 🔗 both
Проблема: Достижение 'rank_top3'/'rank_1' выдаётся по my_position, который может быть завышен из-за off-by-one выше. Юзер с реальным 4-м местом получит 'топ-3'
Как воспроизвести: Занять 4-е место → из-за +1 в user_rank my_position=3 → выдаётся rank_top3
Что сделать: Исправить расчёт user_rank (см. выше), либо считать позицию через ROW_NUMBER() OVER (ORDER BY total_score DESC) в одном запросе
Confidence: 0.87
19. register_race_unique_violation 🔵 secondary
Файл:routers/users.py:27
Snippet:row = await conn.fetchrow( """INSERT INTO users (telegram_id, username, current_level)
Проблема: При двух параллельных запросах /users/register (повторный коннект клиента, гонка после SELECT) второй INSERT падает с unique_violation → 500, пользователь видит ошибку регистрации.
Как воспроизвести: двойной вызов /users/register одновременно → один из запросов возвращает 500
Что сделать: INSERT ... ON CONFLICT (telegram_id) DO UPDATE SET username = COALESCE(EXCLUDED.username, users.username) RETURNING ... или ловить UniqueViolation и делать SELECT
Confidence: 0.85
20. matview_if_not_exists_drift 🔵 secondary
Файл:main.py:152
Snippet:CREATE MATERIALIZED VIEW IF NOT EXISTS leaderboard_cache AS
Проблема: если определение matview меняется в коде (новая игра/колонка score), на существующем проде CREATE IF NOT EXISTS молча пропустит создание — лидерборд навсегда считает по старой формуле, очки учеников в рейтинге неверные
Как воспроизвести: изменить SELECT matview → задеплоить → leaderboard продолжает использовать старое определение
Что сделать: версионировать matview: CREATE OR REPLACE / DROP+CREATE в отдельной миграции с REFRESH
Как воспроизвести: Двойной клик по кнопке завершения → двойные инкременты
Что сделать: Проверять session["is_completed"] и возвращать 200 без повторной обработки
Confidence: 0.85
25. history_save_no_size_limit 🔗 both
Файл:routers/teacher.py:900
Snippet: `messages = body.get("messages", [])
if not isinstance(messages, list):
raise HTTPException(400, "messag`
Проблема: Нет ограничения на размер messages — атакующий может залить мегабайты JSON в teacher_chat_history, раздувая БД и вызывая OOM при загрузке.
Как воспроизвести: POST /teacher/history/save с messages = [{'x': 'A'*1000000}] * 1000 — запись на гигабайты.
Что сделать: Ограничить: len(messages) <= 200 и общий размер json.dumps(messages) <= 100KB, иначе 413.
Confidence: 0.93
26. ai_limit_race_condition
Файл:routers/teacher.py:155
Snippet:if not await check_ai_limit(conn, telegram_id): return get_ai_limit_message(lang)
Проблема: Ученик может бесплатно обойти лимит AI-помощи, отправив несколько параллельных запросов — счётчик инкрементируется только ПОСЛЕ успешного ответа AI, а проверка лимита и инкремент не атомарны.
Как воспроизвести: Отправить 10 параллельных POST /teacher/explain — все пройдут check_ai_limit (usage=0), все вызовут AI, все инкрементируют счётчик. Лимит 5/день обходится.
Что сделать: Атомарно резервировать слот: INSERT ... ON CONFLICT DO UPDATE SET command_count = command_count + 1 WHERE command_count < LIMIT RETURNING command_count — до вызова AI. При ошибке AI — откатывать.
Проблема: Параллельные запросы (explain/examples/free-message/translate) проходят проверку лимита одновременно — реальное число AI-вызовов за день превышает 5, растут расходы на Together API
Как воспроизвести: отправить 10 параллельных POST /teacher/explain → все пройдут check_ai_limit до инкремента → 10 AI-вызовов при лимите 5
Что сделать: атомарный upsert с условием: INSERT ... ON CONFLICT DO UPDATE SET command_count = command_count + 1 WHERE command_count < $limit RETURNING command_count
Confidence: 0.88
28. ai_limit_not_incremented_on_failure
Файл:routers/teacher.py:165
Snippet:if ai_response: async with pool.acquire() as conn: await increment_teacher_ai_usage(conn, telegram_i
Проблема: Если AI-провайдер падает/таймаутит, лимит не списывается — ученик может бесконечно долбить AI-эндпоинты, нагружая внешний API и не получая ответа.
Как воспроизвести: Сделать TOGETHER_API_KEY невалидным → call_ai возвращает '' → счётчик не растёт → лимит никогда не исчерпается.
Что сделать: Инкрементировать счётчик ДО вызова AI (после успешной проверки лимита), либо инкрементировать всегда, независимо от результата.
Confidence: 0.85
29. phrase_of_day_race_condition
Файл:routers/teacher.py:260
Snippet:today_phrase = await conn.fetchrow(""" SELECT * FROM daily_phrases WHERE phrase_date = $1 """, today
Проблема: При одновременных запросах от нескольких пользователей в момент смены дня все они увидят пустую фразу → все вызовут AI → все сделают INSERT ... ON CONFLICT DO UPDATE. Лишние траты AI-токенов и гонка записи.
Как воспроизвести: В 00:00 UTC отправить 50 параллельных GET /teacher/phrase-of-day — 50 вызовов AI вместо одного.
Что сделать: Использовать advisory lock (pg_advisory_xact_lock) или INSERT ... ON CONFLICT DO NOTHING RETURNING с проверкой — генерировать фразу только если INSERT реально вставил строку.
Проблема: AI-вызов (timeout 90s) выполняется внутри pool.acquire() — соединение из пула занято до 90 секунд; несколько одновременных запросов исчерпывают пул, у всех пользователей падают запросы к БД
Как воспроизвести: первый запрос дня на /teacher/phrase-of-day при медленном AI + параллельные запросы других пользователей → pool exhausted, таймауты
Что сделать: освободить соединение перед call_ai, вернуть его только для INSERT; или генерировать фразу в фоне/по cron
Confidence: 0.85
31. orchestrator_reaction_lang_unsafe 🔗 both
Файл:routers/orchestrator.py:275
Snippet:field = f"text_{lang}" return row.get(field) or row.get("text_en") or "OK"
Проблема: Если lang приходит из query/body без whitelist, f-string подставляется в имя колонки — потенциальный доступ к произвольным полям row (например, 'id' или 'reaction_type')
Как воспроизвести: get_random_reaction(conn, 'correct', 'id') → вернёт row['id'] вместо текста
Что сделать: Валидировать lang ∈ {'pl','ru','uk','en'} до формирования field
Confidence: 0.87
32. orchestrator_wrong_because_lang_unsafe
Файл:routers/orchestrator.py:296
Snippet:field = f"explanation_{lang}" return row.get(field) or row.get("explanation_en") or ""
Проблема: Аналогично: невалидированный lang позволяет вытащить произвольную колонку из wrong_because_explanations
Как воспроизвести: get_wrong_because_explanation(conn, 'x', 'wrong_because') → вернёт wrong_because
Что сделать: Whitelist lang перед формированием имени поля
Confidence: 0.82
33. feed_upload_image_no_magic_bytes_check
Файл:routers/feed.py:620
Snippet:content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:
Проблема: Проверка только по Content-Type из заголовка — можно загрузить .php/.html под видом image/jpeg, файл сохранится в /uploads/feed/
Как воспроизвести: curl -F 'file=@shell.php;type=image/jpeg' → файл сохранён с расширением .jpg, но содержимое — PHP
Что сделать: Проверять magic bytes (imghdr/PIL) и/или перекодировать через Pillow
Confidence: 0.85
34. support_admin_reply_no_message_length_check_on_ticket_id_type 🔗 both
Проблема: При переименовании слова обновляются ВСЕ строки с этим word_pl в уровне, включая привязки к игровым уровням Филвордов — может сломать игровой контент
Как воспроизвести: PUT /admin/content/words/word/{id} с новым word_pl → все строки (level, old_word_pl) перезаписаны, включая level_id != NULL
Что сделать: Обновлять только строку с данным id, либо явно ограничить level_id IS NULL + отдельно синхронизировать привязки
Confidence: 0.82
36. achievements_check_race_condition
Файл:routers/achievements.py:340
Snippet:matching = await conn.fetch(""" SELECT a.* FROM achievements a WHERE a.requirement_type = $1
Проблема: При параллельных запросах (двойной клик, retry) одно и то же достижение может быть выдано дважды — ON CONFLICT DO NOTHING спасает от дубля в БД, но в ответе new_achievements юзер увидит дубликат попапа
Как воспроизвести: Два параллельных POST /track-login → оба SELECT вернут одно достижение → оба INSERT ON CONFLICT DO NOTHING → оба добавят в newly_unlocked
Что сделать: Использовать INSERT ... ON CONFLICT DO NOTHING RETURNING id и добавлять в newly_unlocked только если RETURNING вернул строку
if not message:
raise HTTPException(400, "Message is required`
Проблема: Эндпоинт сохраняет произвольный текст как сообщение ассистента (is_user=False) без проверки длины и дневного лимита — можно раздуть историю/контекст и подменить ответы бота, а также обойти лимит 5 сообщений.
Как воспроизвести: POST /assistant/save-analytics с message длиной 10 МБ → сохраняется в chat_history без лимита
Что сделать: Добавить проверку len(message) <= 500 и лимит на количество вызовов, валидировать источник (только серверная аналитика)
Confidence: 0.85
38. auth_query_param_initdata_leaks_in_logs 🔗 both
Проблема: порядок аргументов hmac.new(key, msg) — здесь key='WebAppData', msg=BOT_TOKEN. По документации Telegram должно быть наоборот: key=BOT_TOKEN, msg='WebAppData'. Если так — подпись не сходится и ВСЕ пользователи получают 401
Как воспроизвести: любой валидный initData от Telegram → 401 Invalid initData signature
Что сделать: поменять: hmac.new(BOT_TOKEN.encode(), b'WebAppData', hashlib.sha256).digest()
Confidence: 0.9
40. learning_tables_no_user_fk 🔵 secondary
Файл:database.py:336
Snippet:CREATE TABLE IF NOT EXISTS learning_sessions ( id BIGSERIAL PRIMARY KEY, user_id
Проблема: при удалении пользователя (ON DELETE CASCADE в других таблицах) строки learning_sessions, user_learning_answers, user_lesson_progress, user_topic_progress, user_skill_mastery, ai_user_context остаются сиротами — аналитика и matview считают мёртвых пользователей
Как воспроизвести: удалить user из users → SELECT из user_learning_answers по удалённому user_id всё ещё возвращает строки
Что сделать: добавить REFERENCES users(telegram_id) ON DELETE CASCADE для user_id во всех learning-таблицах (миграция + в CREATE TABLE)
Проблема: любой может перебрать/скачать все загруженные картинки feed-постов (включая неопубликованные), если знает имя файла
Как воспроизвести: GET /uploads/ без авторизации
Что сделать: отдавать через эндпоинт с проверкой is_published, либо использовать непредсказуемые имена (uuid) и не листить
Confidence: 0.87
42. ratelimit_no_global_ip_cap 🔵 secondary
Файл:main.py:262
Snippet: `rate_key = f"{client_ip}:{path}"
if not rate_limiter.is_allowed(rate_key, path):`
Проблема: лимит только per-path: атакующий с одного IP может одновременно долбить все ~25 эндпоинтов, каждый со своим лимитом (60+30+30+... запросов/мин) — дорогие AI-эндпоинты (/assistant, /teacher, /tts) выжигают бюджет суммарно
Как воспроизвести: циклом слать по 55 запросов/мин на каждый AI-эндпоинт с одного IP — ни один 429 не вернётся
Что сделать: добавить глобальный per-IP лимит (например 120/мин) поверх per-path, проверять оба ключа
Confidence: 0.85
43. rate_limiter_memory_leak_unbounded_keys
Файл:main.py:78
Snippet:self.requests = defaultdict(list)
Проблема: при большом числе уникальных IP:path ключей память растёт неограниченно, процесс может упасть (OOM) — все ученики получают 502
Как воспроизвести: нагрузка с разных IP → ключи накапливаются → RSS растёт; cleanup раз в 60с не спасает при burst
Что сделать: ограничить размер dict (LRU) или перейти на Redis; либо чистить при превышении N ключей
⚠️ ВАЖНО: работает корректно только при ОДНОМ воркере uvicorn.`
Проблема: при запуске --workers N или после рестарта лимиты обнуляются/умножаются: /game/complete-level фактически 10*N/мин, рестарт сбрасывает счётчики — брутфорс и выжигание AI-бюджета
Как воспроизвести: запустить uvicorn --workers 4 → один IP получает 240 req/min на default-лимите
Что сделать: перевести на Redis (INCR + EXPIRE) до горизонтального масштабирования
Проблема: Дублирование SQL — при изменении схемы уроков легко забыть поправить во втором месте, что приведёт к рассинхрону ответов orchestrator
Как воспроизвести: Сравнить блоки в шаге 1 (стр. 47) и шаге 2 (стр. 86) — идентичный SQL
Что сделать: Вынести в helper _fetch_lesson_by_skill(conn, skill_tag)
Confidence: 0.9
47. orchestrator_duplicate_options_loader
Файл:routers/orchestrator.py:175
Snippet:question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids: all_options = awa
Проблема: Три почти идентичных блока загрузки options (get_lesson_by_id, get_lesson_questions, get_test_questions) — риск рассинхрона при правках
Как воспроизвести: Сравнить строки 175, 205, 235 — одинаковый код
Что сделать: Вынести _attach_options(conn, questions) -> list
Confidence: 0.9
48. orchestrator_random_reaction_full_scan
Файл:routers/orchestrator.py:253
Snippet:FROM teacher_reactions WHERE reaction_type = $1 ORDER BY RANDOM() LIMIT 1
Проблема: ORDER BY RANDOM() делает full scan таблицы реакций на каждый ответ ученика — при росте банка реакций ответы замедлятся
Как воспроизвести: EXPLAIN ANALYZE на teacher_reactions с 10k+ строк
Что сделать: Использовать TABLESAMPLE SYSTEM_ROWS(1) или предвыборку id через random() в подзапросе
Confidence: 0.8
49. profile_hash_decimal_only
Файл:routers/learning_profile.py:47
Snippet:if isinstance(v, Decimal): item[k] = float(v) else: item[k] = v
Проблема: Хэш не сериализует datetime/date (например, days_since_last_attempt как date) — json.dumps упадёт с TypeError, кэш профиля не построится
Как воспроизвести: Передать weak_skills с полем типа datetime → get_profile_hash бросает TypeError
Что сделать: Использовать default=str в json.dumps или расширить конвертер на date/datetime
Confidence: 0.8
50. options_loader_triplicated 🔵 secondary
Файл:routers/orchestrator.py:190
Snippet:question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids:
Проблема: Одинаковый блок загрузки опций (fetch + группировка в Python) скопирован в get_lesson_by_id, get_lesson_questions и get_test_questions — правка в одном месте разъедется с двумя другими
Как воспроизвести: изменить логику сортировки/фильтрации опций в одной функции → две другие останутся со старой логикой
Что сделать: вынести в хелпер _load_questions_with_options(conn, where_clause, params) или одну функцию с флагом is_test_question
Confidence: 0.95
51. review_lesson_query_duplicated 🔵 secondary
Файл:routers/orchestrator.py:44
Snippet:SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.title_uk, l.title_en FROM learning_le
Проблема: Идентичный SQL выбора урока для повторения продублирован в шагах 1 и 2 — при изменении критериев выбора урока для review легко поправить только одну ветку
Как воспроизвести: добавить фильтр уровня в шаг 1 → шаг 2 продолжит выдавать уроки чужого уровня
Что сделать: вынести в общий хелпер _get_review_lesson_for_skill(conn, skill_tag)
Confidence: 0.9
52. admin_content_unused_import_re 🔵 secondary
Файл:routers/admin_content.py:27
Snippet:import logging import re from typing import Optional
Проблема: мёртвый импорт, сбивает при чтении модуля
Как воспроизвести: grep 're.' routers/admin_content.py — ни одного использования
Что сделать: удалить import re
Confidence: 0.95
53. feed_unused_import_os 🔵 secondary
Файл:routers/feed.py:15
Snippet:import json import re import uuid import os
Проблема: мёртвый импорт
Как воспроизвести: grep 'os.' routers/feed.py — не используется (пути через Path/UPLOADS_DIR)
Проблема: Хардкод абсолютного пути — при деплое в другой каталог/контейнер os.makedirs упадёт с PermissionError на старте приложения, весь backend не поднимется
Как воспроизвести: Запустить backend из другого окружения (Docker, staging) → ImportError/PermissionError при импорте routers.tts
Что сделать: Вынести путь в config/env (TTS_CACHE_DIR), использовать os.getenv с дефолтом относительно file
Confidence: 0.93
56. admin_stats_duplicated 🔵 secondary
Файл:routers/assistant.py:330
Snippet:online_now = await conn.fetchval(""" SELECT COUNT(DISTINCT user_id) FROM (
Проблема: Запросы total_users/new_today/online_now/level_counts полностью дублируются между routers/leaderboard.py:get_admin_stats и routers/assistant.py:get_admin_stats — правки в одном месте расходятся со вторым.
Как воспроизвести: сравнить /leaderboard/admin/stats и /assistant/stats/admin — одинаковый код в двух файлах
Что сделать: Вынести общие агрегаты в общий сервис/модуль stats.py
Confidence: 0.9
57. tts_blocking_io_event_loop 🔵 secondary
Файл:routers/tts.py:55
Snippet:with open(cache_path, 'rb') as f: return Response(
Проблема: Синхронные open/read/write в async-хендлере блокируют event loop: при медленном диске/большом кэше зависают все запросы сервера, включая игру.
Как воспроизвести: много параллельных запросов /tts с cache miss → latency всех эндпоинтов растёт
Что сделать: Использовать asyncio.to_thread / aiofiles для чтения и записи кэша
Confidence: 0.85
58. col_exists_migration_duplication 🔵 secondary
Файл:database.py:55
Snippet:col_exists = await conn.fetchval(""" SELECT 1 FROM information_schema.columns WHERE tab
Проблема: один и тот же блок fetchval+ALTER скопирован ~12 раз с разными именами — легко забыть добавить проверку для новой колонки или ошибиться в table_name (ошибка всплывёт только на проде)
Как воспроизвести: добавить новую колонку в любую таблицу → скопировать блок → опечатка в table_name → ALTER на несуществующей таблице падает на старте
Что сделать: хелпер ensure_column(conn, table, column, ddl) с параметризованным запросом через $1/$2
Confidence: 0.9
59. init_db_ddl_every_startup 🔵 secondary
Файл:database.py:20
Snippet:async with conn.transaction(): # ============ users ============ await conn.execute("""
Проблема: ~500 строк DDL, десятки information_schema-проверок и ALTER выполняются при каждом старте в одной транзакции: долгий старт, блокировки каталога PostgreSQL, риск частично применённой схемы при таймауте деплоя
Как воспроизвести: рестарт приложения → в логах десятки миграционных проверок; время старта растёт с числом таблиц
Что сделать: вынести в отдельные версионированные миграции (alembic/yoyo), в init_db оставить только проверку версии схемы
Confidence: 0.88
Итого: всего находок=124, overshoot=6, snippet не совпал=15, низкий confidence=0, прошло=59
Этот Issue создан автоматически. Исправления делаются вручную.
# 🤖 AI Code Review (Backend)
**Дата:** 2026-09-25 19:38 UTC
**Модели:** `deepseek-ai/DeepSeek-V4.1-Flash` + `zai-org/GLM-5.3-Flash`
**Репозиторий:** `Drobysh/filwordspl-backend`
## 📊 По пакам
- **routers_games** — 7 файлов, 65,802 символов, находок=3
- **routers_learning_core** — 1 файлов, 40,548 символов, находок=5
- **routers_learning_teacher** — 1 файлов, 47,356 символов, находок=10
- **routers_learning_orch** — 2 файлов, 12,293 символов, находок=14
- **routers_admin** — 4 файлов, 97,143 символов, находок=8
- **routers_misc** — 5 файлов, 69,714 символов, находок=9
- **core** — 4 файлов, 69,897 символов, находок=10
- **services** — 0 файлов, 0 символов, находок=0
---
## 🔴 Влияет на ученика (20)
### 1. completion_time_type_unvalidated 🔵 secondary
- **Файл:** `routers/game.py:168`
- **Snippet:** `if completion_time is not None and completion_time < 5:`
- **Проблема:** completion_time приходит из JSON без валидации типа: строка или объект вызовет TypeError при сравнении → 500 вместо 400
- **Как воспроизвести:** POST /game/complete-level с {"completion_time": "fast"} → Internal Server Error
- **Что сделать:** валидировать тело pydantic-моделью (completion_time: float | None) или isinstance-проверкой
- **Confidence:** 0.85
### 2. session_complete_no_session_id_check
- **Файл:** `routers/learning.py:0`
- **Snippet:** `session_id = body.get("session_id")
pool = await get_pool()
async with pool.acquire() as conn:
session `
- **Проблема:** При отсутствии session_id в теле запроса asyncpg падает с ошибкой типа → 500 вместо понятной 400
- **Как воспроизвести:** POST /learning/session/complete с пустым body → 500 Internal Server Error
- **Что сделать:** if not session_id: raise HTTPException(400, "session_id required") до обращения к БД
- **Confidence:** 0.9
### 3. update_skill_mastery_previous_mastery_self_reference
- **Файл:** `routers/learning.py:0`
- **Snippet:** `previous_mastery = float(previous_row["mastery_score"]) if previous_row and previous_row["mastery_score"] else mastery
`
- **Проблема:** При первой попытке previous_mastery = mastery → delta всегда 0, ученик никогда не видит роста на первом расчёте
- **Как воспроизвести:** Первый ответ по навыку → mastery_delta = 0 вместо реального значения
- **Что сделать:** Если previous_row отсутствует — previous_mastery = 0 (или NULL), а не текущий mastery
- **Confidence:** 0.85
### 4. diagnostic_test_no_options_in_resume
- **Файл:** `routers/teacher.py:320`
- **Snippet:** `if session["session_type"] == "teacher_test":
questions = await get_test_questions(conn, session["topic_`
- **Проблема:** При /resume диагностического теста (session_type='diagnostic_test') код идёт в else-ветку, ищет lesson_id по topic_id='' → questions=[] → возвращает has_active_session=False. Ученик теряет прогресс диагностики.
- **Как воспроизвести:** Начать /diagnostic-test → ответить на 3 вопроса → закрыть → /resume → has_active_session=False, сессия потеряна.
- **Что сделать:** Добавить ветку для session_type == 'diagnostic_test': перезагружать вопросы через тот же запрос, что и в teacher_diagnostic_test (ORDER BY RANDOM() LIMIT 15 не воспроизводит порядок — нужно хранить question_ids в сессии).
- **Confidence:** 0.88
### 5. save_answer_ignores_hint_used 🔗 both
- **Файл:** `routers/teacher.py:130`
- **Snippet:** `await save_answer_to_session(
conn, telegram_id, session_id, question_data,
selected_answer, is_`
- **Проблема:** Параметр hint_used в save_answer_to_session всегда False — если ученик использовал подсказку, это не фиксируется в БД. Аналитика и mastery искажаются.
- **Как воспроизвести:** Использовать подсказку → ответить → в user_learning_answers.hint_used = FALSE.
- **Что сделать:** Принимать hint_used из body запроса и передавать в save_answer_to_session.
- **Confidence:** 0.87
### 6. diagnostic_test_questions_not_persisted
- **Файл:** `routers/teacher.py:780`
- **Snippet:** `SELECT * FROM learning_questions
WHERE is_test_question = TRUE
ORDER BY RANDOM()
LIM`
- **Проблема:** Диагностический тест выбирает 15 случайных вопросов, но не сохраняет их список в сессии. При /resume или перезагрузке страницы вопросы будут другими — ученик не сможет завершить тест.
- **Как воспроизвести:** Начать /diagnostic-test, ответить на 5 вопросов, вызвать /resume — вопросы перегенерируются, прогресс ломается.
- **Что сделать:** Сохранять question_ids в learning_sessions (JSONB-поле) при создании сессии и читать их при resume/answer.
- **Confidence:** 0.85
### 7. answer_question_not_in_session 🔗 both
- **Файл:** `routers/teacher.py:620`
- **Snippet:** `current_index = 0
for i, q in enumerate(questions):
if q["question"]["question_id"] == question_id:
`
- **Проблема:** Если question_id не найден в списке questions (например, при diagnostic_test или рассинхроне), current_index остаётся 0 → next_index=1 → ученику показывается второй вопрос вместо следующего. Прогресс сбивается.
- **Как воспроизвести:** Отправить /answer с question_id, которого нет в текущем списке questions — получишь questions[1] вместо корректного next.
- **Что сделать:** Если вопрос не найден (current_index не изменился и questions[0] != question_id) — вернуть 400/404, а не молча показывать questions[1].
- **Confidence:** 0.85
### 8. orchestrator_weak_skill_ignores_retention
- **Файл:** `routers/orchestrator.py:78`
- **Snippet:** `WHERE user_id = $1
AND mastery_score < 75
AND attempts_count >= 2`
- **Проблема:** Ученик с overdue-навыком без подходящего урока в learning_lessons проваливается в шаг 2 и получает тот же слабый навык, но с reason='weak_mastery' — цикл повторения не сдвигается
- **Как воспроизвести:** overdue_skill найден, но lesson для его skill_tag отсутствует (is_active=FALSE) → шаг 2 возвращает тот же skill_tag
- **Что сделать:** Исключить skill_tag из шага 2 (AND skill_tag != $2) или объединить шаги 1 и 2 в один запрос с приоритетом retention
- **Confidence:** 0.8
### 9. orchestrator_lesson_id_not_in_null 🔗 both
- **Файл:** `routers/orchestrator.py:137`
- **Snippet:** `AND l.lesson_id NOT IN (
SELECT lesson_id FROM user_lesson_progress
WHERE user_id = $2 AND `
- **Проблема:** Если в user_lesson_progress есть строка с lesson_id = NULL, NOT IN вернёт пустой результат — ученик увидит 'all_completed' и не получит следующий урок
- **Как воспроизвести:** INSERT INTO user_lesson_progress(user_id, lesson_id, completed) VALUES(1, NULL, TRUE) → orchestrator возвращает type='completed'
- **Что сделать:** Заменить на NOT EXISTS или добавить AND lesson_id IS NOT NULL в подзапрос
- **Confidence:** 0.9
### 10. orchestrator_lesson_questions_no_active_filter
- **Файл:** `routers/orchestrator.py:200`
- **Snippet:** `SELECT * FROM learning_questions
WHERE lesson_id = $1 AND is_test_question = FALSE
ORDER BY id`
- **Проблема:** В get_lesson_questions и get_test_questions нет фильтра is_active у вопросов — ученик может получить деактивированные/устаревшие вопросы, тогда как get_lesson_by_id использует тот же запрос без фильтра, но урок фильтруется по is_active
- **Как воспроизвести:** UPDATE learning_questions SET is_active=FALSE WHERE lesson_id='x' → вопросы всё равно возвращаются
- **Что сделать:** Добавить AND is_active = TRUE (если колонка существует) во все три запроса вопросов
- **Confidence:** 0.75
### 11. review_always_first_lesson 🔵 secondary
- **Файл:** `routers/orchestrator.py:44`
- **Snippet:** `WHERE l.skill_tag = $1
AND l.is_active = TRUE
ORDER BY l.order_number
LIMIT 1`
- **Проблема:** При повторении (overdue/weak) ученику всегда выдаётся ПЕРВЫЙ урок навыка по порядку, а не тот, где он ошибался — повторение бесконечно крутит один и тот же начальный урок, прогресс по слабому навыку не двигается
- **Как воспроизвести:** провалить 3-й урок навыка → mastery < 75 → orchestrator раз за разом возвращает урок №1 этого навыка
- **Что сделать:** выбирать урок с учётом user_lesson_progress (наименее освоенный/последний ошибочный) или сортировать по убыванию сложности/ошибкам
- **Confidence:** 0.85
### 12. current_level_param_mismatch 🔵 secondary
- **Файл:** `routers/orchestrator.py:30`
- **Snippet:** `SELECT current_level FROM users WHERE telegram_id = $1
""", user_id) or "A1"`
- **Проблема:** Если вызывающий код передаёт внутренний user_id (int PK), а не telegram_id, запрос вернёт NULL и молча подставится 'A1' — ученик с уровнем B1 получает уроки уровня A1
- **Как воспроизвести:** вызвать get_next_lesson(conn, user_id=внутренний_pk) → current_level всегда 'A1' → шаг 4 выдаёт уроки A1
- **Что сделать:** переименовать параметр в telegram_id или фильтровать по users.user_id; убрать молчаливый fallback 'A1' (логировать/падать)
- **Confidence:** 0.78
### 13. test_step_no_level_check 🔵 secondary
- **Файл:** `routers/orchestrator.py:88`
- **Snippet:** `WHERE tp.user_id = $1
AND tp.lessons_completed >= tp.lessons_total
AND tp.lessons_total > 0
`
- **Проблема:** Тест темы предлагается по user_topic_progress без проверки, что тема относится к текущему уровню и что lessons_total актуален; при рассинхроне lessons_total (например, тему расширили) ученика зациклит на тесте, хотя уроки темы не все пройдены фактически
- **Как воспроизвести:** увеличить lessons_total у завершённой темы → lessons_completed >= lessons_total ложно, но если наоборот уменьшить — тест предлагается до прохождения добавленных уроков
- **Что сделать:** сверять lessons_completed с фактическим числом активных уроков темы в learning_lessons
- **Confidence:** 0.76
### 14. feed_get_feed_post_no_expires_check
- **Файл:** `routers/feed.py:178`
- **Snippet:** `SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE`
- **Проблема:** Истёкший пост (expires_at < NOW()) всё равно отдаётся по прямому ID, хотя в списке секции он скрыт
- **Как воспроизвести:** GET /feed/post/{id} для поста с истёкшим expires_at → пост возвращается
- **Что сделать:** Добавить AND (expires_at IS NULL OR expires_at > NOW())
- **Confidence:** 0.9
### 15. admin_dashboard_online_now_uses_wrong_columns
- **Файл:** `routers/admin.py:78`
- **Snippet:** `SELECT user_id FROM user_progress WHERE completed_at > NOW() - INTERVAL '30 minutes'`
- **Проблема:** Метрика online_now показывает 0 или заниженное число — админ видит неверную статистику
- **Как воспроизвести:** Открыть /admin/dashboard → online_now всегда 0, хотя юзеры активны
- **Что сделать:** Проверить реальные имена колонок (user_id/completed_at) в user_progress, sentence_progress, user_learning_answers, chat_history; если их нет — запрос упадёт с UndefinedColumn
- **Confidence:** 0.8
### 16. leaderboard_rank_off_by_one
- **Файл:** `routers/leaderboard.py:60`
- **Snippet:** `user_rank = await conn.fetchval("""
SELECT COUNT(*) + 1 FROM leaderboard_cache
WHERE tot`
- **Проблема:** Ученик видит свой ранг на 1 позицию выше реального (например, реально 5-й, показывается 4-й), потому что COUNT(*) уже не включает его самого
- **Как воспроизвести:** Открыть лидерборд → my_rank.rank не совпадает с позицией в списке leaderboard
- **Что сделать:** Убрать +1: SELECT COUNT(*) FROM leaderboard_cache WHERE total_score > $1 (юзер уже в кэше, его не считаем)
- **Confidence:** 0.9
### 17. login_streak_nondeterministic_grp 🔵 secondary
- **Файл:** `routers/achievements.py:262`
- **Snippet:** `SELECT COUNT(*) FROM dates WHERE grp = (SELECT grp FROM dates LIMIT 1)`
- **Проблема:** Подзапрос (SELECT grp FROM dates LIMIT 1) без ORDER BY возвращает произвольную строку — серия входов считается нестабильно, достижение login_3/login_7 может не выдаться или streak показывается неверный.
- **Как воспроизвести:** заходить несколько дней подряд → /achievements/track-login иногда возвращает streak=1 вместо реальной серии
- **Что сделать:** (SELECT grp FROM dates ORDER BY login_date DESC LIMIT 1) или вычислять grp первой строки CTE
- **Confidence:** 0.88
### 18. leaderboard_rank_achievement_uses_wrong_rank 🔗 both
- **Файл:** `routers/leaderboard.py:175`
- **Snippet:** `if my_position <= 3:
await check_and_award_achievements(telegram_id, "rank_reached", my_position)`
- **Проблема:** Достижение 'rank_top3'/'rank_1' выдаётся по my_position, который может быть завышен из-за off-by-one выше. Юзер с реальным 4-м местом получит 'топ-3'
- **Как воспроизвести:** Занять 4-е место → из-за +1 в user_rank my_position=3 → выдаётся rank_top3
- **Что сделать:** Исправить расчёт user_rank (см. выше), либо считать позицию через ROW_NUMBER() OVER (ORDER BY total_score DESC) в одном запросе
- **Confidence:** 0.87
### 19. register_race_unique_violation 🔵 secondary
- **Файл:** `routers/users.py:27`
- **Snippet:** `row = await conn.fetchrow(
"""INSERT INTO users (telegram_id, username, current_level)`
- **Проблема:** При двух параллельных запросах /users/register (повторный коннект клиента, гонка после SELECT) второй INSERT падает с unique_violation → 500, пользователь видит ошибку регистрации.
- **Как воспроизвести:** двойной вызов /users/register одновременно → один из запросов возвращает 500
- **Что сделать:** INSERT ... ON CONFLICT (telegram_id) DO UPDATE SET username = COALESCE(EXCLUDED.username, users.username) RETURNING ... или ловить UniqueViolation и делать SELECT
- **Confidence:** 0.85
### 20. matview_if_not_exists_drift 🔵 secondary
- **Файл:** `main.py:152`
- **Snippet:** `CREATE MATERIALIZED VIEW IF NOT EXISTS leaderboard_cache AS`
- **Проблема:** если определение matview меняется в коде (новая игра/колонка score), на существующем проде CREATE IF NOT EXISTS молча пропустит создание — лидерборд навсегда считает по старой формуле, очки учеников в рейтинге неверные
- **Как воспроизвести:** изменить SELECT matview → задеплоить → leaderboard продолжает использовать старое определение
- **Что сделать:** версионировать matview: CREATE OR REPLACE / DROP+CREATE в отдельной миграции с REFRESH
- **Confidence:** 0.85
## 🟠 Риск для данных (24)
### 21. wordquiz_client_controls_correct_answer
- **Файл:** `routers/wordquiz.py:130`
- **Snippet:** `correct_polish = body.get("correct_polish", "")
user_answer = body.get("answer", "")`
- **Проблема:** Ученик может подделать correct_polish и всегда отвечать правильно — очки и достижения начисляются за читерство
- **Как воспроизвести:** POST /wordquiz/check с correct_polish='abc', answer='abc' → correct=True, score начислен
- **Что сделать:** Хранить правильный ответ на сервере (в word_quiz_progress.last_word) и проверять по нему
- **Confidence:** 0.9
### 22. wordquiz_consolation_score_repeatable
- **Файл:** `routers/wordquiz.py:200`
- **Snippet:** `if mistakes >= 3:
await conn.execute("""
INSERT INTO word_quiz_progress (user_id, wo`
- **Проблема:** Ученик может бесконечно получать по 10 очков за каждую ошибку после 3-й — total_score накручивается
- **Как воспроизвести:** сделать 3 ошибки → +10, сделать 4-ю ошибку → снова +10, и так далее
- **Что сделать:** Сбрасывать current_mistakes после начисления утешительных очков или начислять только один раз
- **Confidence:** 0.85
### 23. update_skill_mastery_previous_mastery_score_not_updated
- **Файл:** `routers/learning.py:0`
- **Snippet:** `previous_mastery_score = $25,
mastery_delta = $26,`
- **Проблема:** previous_mastery_score перезаписывается текущим mastery, а не старым — история дельт ломается, аналитика тренда некорректна
- **Как воспроизвести:** Два ответа подряд → previous_mastery_score == mastery_score, delta всегда 0 после первого раза
- **Что сделать:** В ON CONFLICT SET previous_mastery_score = user_skill_mastery.mastery_score (старое значение), а не $25
- **Confidence:** 0.88
### 24. complete_session_no_idempotency
- **Файл:** `routers/learning.py:0`
- **Snippet:** `await conn.execute("UPDATE learning_sessions SET is_completed = TRUE, completed_at = NOW() WHERE id = $1", session_id)`
- **Проблема:** Повторный вызов complete_session пересчитывает мастерство, инкрементит attempts_count, обновляет AI-контекст — двойной учёт
- **Как воспроизвести:** Двойной клик по кнопке завершения → двойные инкременты
- **Что сделать:** Проверять session["is_completed"] и возвращать 200 без повторной обработки
- **Confidence:** 0.85
### 25. history_save_no_size_limit 🔗 both
- **Файл:** `routers/teacher.py:900`
- **Snippet:** `messages = body.get("messages", [])
if not isinstance(messages, list):
raise HTTPException(400, "messag`
- **Проблема:** Нет ограничения на размер messages — атакующий может залить мегабайты JSON в teacher_chat_history, раздувая БД и вызывая OOM при загрузке.
- **Как воспроизвести:** POST /teacher/history/save с messages = [{'x': 'A'*1000000}] * 1000 — запись на гигабайты.
- **Что сделать:** Ограничить: len(messages) <= 200 и общий размер json.dumps(messages) <= 100KB, иначе 413.
- **Confidence:** 0.93
### 26. ai_limit_race_condition
- **Файл:** `routers/teacher.py:155`
- **Snippet:** `if not await check_ai_limit(conn, telegram_id):
return get_ai_limit_message(lang)`
- **Проблема:** Ученик может бесплатно обойти лимит AI-помощи, отправив несколько параллельных запросов — счётчик инкрементируется только ПОСЛЕ успешного ответа AI, а проверка лимита и инкремент не атомарны.
- **Как воспроизвести:** Отправить 10 параллельных POST /teacher/explain — все пройдут check_ai_limit (usage=0), все вызовут AI, все инкрементируют счётчик. Лимит 5/день обходится.
- **Что сделать:** Атомарно резервировать слот: INSERT ... ON CONFLICT DO UPDATE SET command_count = command_count + 1 WHERE command_count < LIMIT RETURNING command_count — до вызова AI. При ошибке AI — откатывать.
- **Confidence:** 0.9
### 27. ai_limit_check_race 🔵 secondary
- **Файл:** `routers/teacher.py:130`
- **Snippet:** `usage = await get_teacher_ai_usage(conn, user_id)
return usage < TEACHER_AI_DAILY_LIMIT`
- **Проблема:** Параллельные запросы (explain/examples/free-message/translate) проходят проверку лимита одновременно — реальное число AI-вызовов за день превышает 5, растут расходы на Together API
- **Как воспроизвести:** отправить 10 параллельных POST /teacher/explain → все пройдут check_ai_limit до инкремента → 10 AI-вызовов при лимите 5
- **Что сделать:** атомарный upsert с условием: INSERT ... ON CONFLICT DO UPDATE SET command_count = command_count + 1 WHERE command_count < $limit RETURNING command_count
- **Confidence:** 0.88
### 28. ai_limit_not_incremented_on_failure
- **Файл:** `routers/teacher.py:165`
- **Snippet:** `if ai_response:
async with pool.acquire() as conn:
await increment_teacher_ai_usage(conn, telegram_i`
- **Проблема:** Если AI-провайдер падает/таймаутит, лимит не списывается — ученик может бесконечно долбить AI-эндпоинты, нагружая внешний API и не получая ответа.
- **Как воспроизвести:** Сделать TOGETHER_API_KEY невалидным → call_ai возвращает '' → счётчик не растёт → лимит никогда не исчерпается.
- **Что сделать:** Инкрементировать счётчик ДО вызова AI (после успешной проверки лимита), либо инкрементировать всегда, независимо от результата.
- **Confidence:** 0.85
### 29. phrase_of_day_race_condition
- **Файл:** `routers/teacher.py:260`
- **Snippet:** `today_phrase = await conn.fetchrow("""
SELECT * FROM daily_phrases WHERE phrase_date = $1
""", today`
- **Проблема:** При одновременных запросах от нескольких пользователей в момент смены дня все они увидят пустую фразу → все вызовут AI → все сделают INSERT ... ON CONFLICT DO UPDATE. Лишние траты AI-токенов и гонка записи.
- **Как воспроизвести:** В 00:00 UTC отправить 50 параллельных GET /teacher/phrase-of-day — 50 вызовов AI вместо одного.
- **Что сделать:** Использовать advisory lock (pg_advisory_xact_lock) или INSERT ... ON CONFLICT DO NOTHING RETURNING с проверкой — генерировать фразу только если INSERT реально вставил строку.
- **Confidence:** 0.85
### 30. phrase_day_ai_inside_conn 🔵 secondary
- **Файл:** `routers/teacher.py:300`
- **Snippet:** `ai_response = await call_ai(user_prompt, system_prompt, max_tokens=1000)`
- **Проблема:** AI-вызов (timeout 90s) выполняется внутри pool.acquire() — соединение из пула занято до 90 секунд; несколько одновременных запросов исчерпывают пул, у всех пользователей падают запросы к БД
- **Как воспроизвести:** первый запрос дня на /teacher/phrase-of-day при медленном AI + параллельные запросы других пользователей → pool exhausted, таймауты
- **Что сделать:** освободить соединение перед call_ai, вернуть его только для INSERT; или генерировать фразу в фоне/по cron
- **Confidence:** 0.85
### 31. orchestrator_reaction_lang_unsafe 🔗 both
- **Файл:** `routers/orchestrator.py:275`
- **Snippet:** `field = f"text_{lang}"
return row.get(field) or row.get("text_en") or "OK"`
- **Проблема:** Если lang приходит из query/body без whitelist, f-string подставляется в имя колонки — потенциальный доступ к произвольным полям row (например, 'id' или 'reaction_type')
- **Как воспроизвести:** get_random_reaction(conn, 'correct', 'id') → вернёт row['id'] вместо текста
- **Что сделать:** Валидировать lang ∈ {'pl','ru','uk','en'} до формирования field
- **Confidence:** 0.87
### 32. orchestrator_wrong_because_lang_unsafe
- **Файл:** `routers/orchestrator.py:296`
- **Snippet:** `field = f"explanation_{lang}"
return row.get(field) or row.get("explanation_en") or ""`
- **Проблема:** Аналогично: невалидированный lang позволяет вытащить произвольную колонку из wrong_because_explanations
- **Как воспроизвести:** get_wrong_because_explanation(conn, 'x', 'wrong_because') → вернёт wrong_because
- **Что сделать:** Whitelist lang перед формированием имени поля
- **Confidence:** 0.82
### 33. feed_upload_image_no_magic_bytes_check
- **Файл:** `routers/feed.py:620`
- **Snippet:** `content_type = (file.content_type or "").lower()
if content_type not in FEED_ALLOWED_IMAGE_TYPES:`
- **Проблема:** Проверка только по Content-Type из заголовка — можно загрузить .php/.html под видом image/jpeg, файл сохранится в /uploads/feed/
- **Как воспроизвести:** curl -F 'file=@shell.php;type=image/jpeg' → файл сохранён с расширением .jpg, но содержимое — PHP
- **Что сделать:** Проверять magic bytes (imghdr/PIL) и/или перекодировать через Pillow
- **Confidence:** 0.85
### 34. support_admin_reply_no_message_length_check_on_ticket_id_type 🔗 both
- **Файл:** `routers/support.py:245`
- **Snippet:** `ticket_id = body.get("ticket_id")
message = body.get("message", "").strip()`
- **Проблема:** ticket_id не приводится к int — если придёт строка, asyncpg упадёт с ошибкой типа; если None — 400, но без явной валидации
- **Как воспроизвести:** POST /support/admin-reply с ticket_id="abc" → 500 вместо 400
- **Что сделать:** Валидировать ticket_id как int, обрабатывать ValueError
- **Confidence:** 0.85
### 35. admin_content_update_word_updates_all_levels_rows
- **Файл:** `routers/admin_content.py:268`
- **Snippet:** `WHERE level = $5 AND word_pl = $6`
- **Проблема:** При переименовании слова обновляются ВСЕ строки с этим word_pl в уровне, включая привязки к игровым уровням Филвордов — может сломать игровой контент
- **Как воспроизвести:** PUT /admin/content/words/word/{id} с новым word_pl → все строки (level, old_word_pl) перезаписаны, включая level_id != NULL
- **Что сделать:** Обновлять только строку с данным id, либо явно ограничить level_id IS NULL + отдельно синхронизировать привязки
- **Confidence:** 0.82
### 36. achievements_check_race_condition
- **Файл:** `routers/achievements.py:340`
- **Snippet:** `matching = await conn.fetch("""
SELECT a.* FROM achievements a
WHERE a.requirement_type = $1
`
- **Проблема:** При параллельных запросах (двойной клик, retry) одно и то же достижение может быть выдано дважды — ON CONFLICT DO NOTHING спасает от дубля в БД, но в ответе new_achievements юзер увидит дубликат попапа
- **Как воспроизвести:** Два параллельных POST /track-login → оба SELECT вернут одно достижение → оба INSERT ON CONFLICT DO NOTHING → оба добавят в newly_unlocked
- **Что сделать:** Использовать INSERT ... ON CONFLICT DO NOTHING RETURNING id и добавлять в newly_unlocked только если RETURNING вернул строку
- **Confidence:** 0.85
### 37. save_analytics_bypasses_limits 🔵 secondary
- **Файл:** `routers/assistant.py:268`
- **Snippet:** `message = body.get("message", "").strip()
if not message:
raise HTTPException(400, "Message is required`
- **Проблема:** Эндпоинт сохраняет произвольный текст как сообщение ассистента (is_user=False) без проверки длины и дневного лимита — можно раздуть историю/контекст и подменить ответы бота, а также обойти лимит 5 сообщений.
- **Как воспроизвести:** POST /assistant/save-analytics с message длиной 10 МБ → сохраняется в chat_history без лимита
- **Что сделать:** Добавить проверку len(message) <= 500 и лимит на количество вызовов, валидировать источник (только серверная аналитика)
- **Confidence:** 0.85
### 38. auth_query_param_initdata_leaks_in_logs 🔗 both
- **Файл:** `auth.py:78`
- **Snippet:** `init_data = request.query_params.get('initData', '')`
- **Проблема:** initData в query-параметре попадает в access-логи nginx/Cloudflare/Sentry — утечка токена, позволяющая имперсонировать ученика
- **Как воспроизвести:** сделать запрос с ?initData=... → токен в логах
- **Что сделать:** убрать query-fallback, использовать только заголовки; либо маскировать initData в логах
- **Confidence:** 0.9
### 39. auth_hmac_secret_key_order_wrong
- **Файл:** `auth.py:55`
- **Snippet:** `secret_key = hmac.new(
'WebAppData'.encode(),
BOT_TOKEN.encode(),
hashlib.sha256
`
- **Проблема:** порядок аргументов hmac.new(key, msg) — здесь key='WebAppData', msg=BOT_TOKEN. По документации Telegram должно быть наоборот: key=BOT_TOKEN, msg='WebAppData'. Если так — подпись не сходится и ВСЕ пользователи получают 401
- **Как воспроизвести:** любой валидный initData от Telegram → 401 Invalid initData signature
- **Что сделать:** поменять: hmac.new(BOT_TOKEN.encode(), b'WebAppData', hashlib.sha256).digest()
- **Confidence:** 0.9
### 40. learning_tables_no_user_fk 🔵 secondary
- **Файл:** `database.py:336`
- **Snippet:** `CREATE TABLE IF NOT EXISTS learning_sessions (
id BIGSERIAL PRIMARY KEY,
user_id`
- **Проблема:** при удалении пользователя (ON DELETE CASCADE в других таблицах) строки learning_sessions, user_learning_answers, user_lesson_progress, user_topic_progress, user_skill_mastery, ai_user_context остаются сиротами — аналитика и matview считают мёртвых пользователей
- **Как воспроизвести:** удалить user из users → SELECT из user_learning_answers по удалённому user_id всё ещё возвращает строки
- **Что сделать:** добавить REFERENCES users(telegram_id) ON DELETE CASCADE для user_id во всех learning-таблицах (миграция + в CREATE TABLE)
- **Confidence:** 0.9
### 41. static_uploads_no_auth_no_size_limit 🔗 both
- **Файл:** `main.py:172`
- **Snippet:** `app.mount("/uploads", StaticFiles(directory=UPLOADS_DIR), name="uploads")`
- **Проблема:** любой может перебрать/скачать все загруженные картинки feed-постов (включая неопубликованные), если знает имя файла
- **Как воспроизвести:** GET /uploads/<filename> без авторизации
- **Что сделать:** отдавать через эндпоинт с проверкой is_published, либо использовать непредсказуемые имена (uuid) и не листить
- **Confidence:** 0.87
### 42. ratelimit_no_global_ip_cap 🔵 secondary
- **Файл:** `main.py:262`
- **Snippet:** `rate_key = f"{client_ip}:{path}"
if not rate_limiter.is_allowed(rate_key, path):`
- **Проблема:** лимит только per-path: атакующий с одного IP может одновременно долбить все ~25 эндпоинтов, каждый со своим лимитом (60+30+30+... запросов/мин) — дорогие AI-эндпоинты (/assistant, /teacher, /tts) выжигают бюджет суммарно
- **Как воспроизвести:** циклом слать по 55 запросов/мин на каждый AI-эндпоинт с одного IP — ни один 429 не вернётся
- **Что сделать:** добавить глобальный per-IP лимит (например 120/мин) поверх per-path, проверять оба ключа
- **Confidence:** 0.85
### 43. rate_limiter_memory_leak_unbounded_keys
- **Файл:** `main.py:78`
- **Snippet:** `self.requests = defaultdict(list)`
- **Проблема:** при большом числе уникальных IP:path ключей память растёт неограниченно, процесс может упасть (OOM) — все ученики получают 502
- **Как воспроизвести:** нагрузка с разных IP → ключи накапливаются → RSS растёт; cleanup раз в 60с не спасает при burst
- **Что сделать:** ограничить размер dict (LRU) или перейти на Redis; либо чистить при превышении N ключей
- **Confidence:** 0.8
### 44. ratelimit_inmemory_multivorker 🔵 secondary
- **Файл:** `main.py:47`
- **Snippet:** `class RateLimiter:
"""In-memory rate limiter.
⚠️ ВАЖНО: работает корректно только при ОДНОМ воркере uvicorn.`
- **Проблема:** при запуске --workers N или после рестарта лимиты обнуляются/умножаются: /game/complete-level фактически 10*N/мин, рестарт сбрасывает счётчики — брутфорс и выжигание AI-бюджета
- **Как воспроизвести:** запустить uvicorn --workers 4 → один IP получает 240 req/min на default-лимите
- **Что сделать:** перевести на Redis (INCR + EXPIRE) до горизонтального масштабирования
- **Confidence:** 0.8
## 🟡 Качество кода (15)
### 45. retention_score_hardcoded_zero 🔵 secondary
- **Файл:** `routers/learning.py:428`
- **Snippet:** `) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, 0, $14,`
- **Проблема:** поле retention_score в user_skill_mastery всегда 0 — мёртвые данные, вводят в заблуждение потребителей аналитики
- **Как воспроизвести:** SELECT retention_score FROM user_skill_mastery → всегда 0
- **Что сделать:** либо рассчитать retention, либо убрать колонку из INSERT/схемы
- **Confidence:** 0.85
### 46. orchestrator_duplicate_lesson_query
- **Файл:** `routers/orchestrator.py:47`
- **Snippet:** `lesson = await conn.fetchrow("""
SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.titl`
- **Проблема:** Дублирование SQL — при изменении схемы уроков легко забыть поправить во втором месте, что приведёт к рассинхрону ответов orchestrator
- **Как воспроизвести:** Сравнить блоки в шаге 1 (стр. 47) и шаге 2 (стр. 86) — идентичный SQL
- **Что сделать:** Вынести в helper _fetch_lesson_by_skill(conn, skill_tag)
- **Confidence:** 0.9
### 47. orchestrator_duplicate_options_loader
- **Файл:** `routers/orchestrator.py:175`
- **Snippet:** `question_ids = [q["question_id"] for q in questions]
all_options = []
if question_ids:
all_options = awa`
- **Проблема:** Три почти идентичных блока загрузки options (get_lesson_by_id, get_lesson_questions, get_test_questions) — риск рассинхрона при правках
- **Как воспроизвести:** Сравнить строки 175, 205, 235 — одинаковый код
- **Что сделать:** Вынести _attach_options(conn, questions) -> list
- **Confidence:** 0.9
### 48. orchestrator_random_reaction_full_scan
- **Файл:** `routers/orchestrator.py:253`
- **Snippet:** `FROM teacher_reactions
WHERE reaction_type = $1
ORDER BY RANDOM()
LIMIT 1`
- **Проблема:** ORDER BY RANDOM() делает full scan таблицы реакций на каждый ответ ученика — при росте банка реакций ответы замедлятся
- **Как воспроизвести:** EXPLAIN ANALYZE на teacher_reactions с 10k+ строк
- **Что сделать:** Использовать TABLESAMPLE SYSTEM_ROWS(1) или предвыборку id через random() в подзапросе
- **Confidence:** 0.8
### 49. profile_hash_decimal_only
- **Файл:** `routers/learning_profile.py:47`
- **Snippet:** `if isinstance(v, Decimal):
item[k] = float(v)
else:
item[k] = v`
- **Проблема:** Хэш не сериализует datetime/date (например, days_since_last_attempt как date) — json.dumps упадёт с TypeError, кэш профиля не построится
- **Как воспроизвести:** Передать weak_skills с полем типа datetime → get_profile_hash бросает TypeError
- **Что сделать:** Использовать default=str в json.dumps или расширить конвертер на date/datetime
- **Confidence:** 0.8
### 50. options_loader_triplicated 🔵 secondary
- **Файл:** `routers/orchestrator.py:190`
- **Snippet:** `question_ids = [q["question_id"] for q in questions]
all_options = []
if question_ids:`
- **Проблема:** Одинаковый блок загрузки опций (fetch + группировка в Python) скопирован в get_lesson_by_id, get_lesson_questions и get_test_questions — правка в одном месте разъедется с двумя другими
- **Как воспроизвести:** изменить логику сортировки/фильтрации опций в одной функции → две другие останутся со старой логикой
- **Что сделать:** вынести в хелпер _load_questions_with_options(conn, where_clause, params) или одну функцию с флагом is_test_question
- **Confidence:** 0.95
### 51. review_lesson_query_duplicated 🔵 secondary
- **Файл:** `routers/orchestrator.py:44`
- **Snippet:** `SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.title_uk, l.title_en
FROM learning_le`
- **Проблема:** Идентичный SQL выбора урока для повторения продублирован в шагах 1 и 2 — при изменении критериев выбора урока для review легко поправить только одну ветку
- **Как воспроизвести:** добавить фильтр уровня в шаг 1 → шаг 2 продолжит выдавать уроки чужого уровня
- **Что сделать:** вынести в общий хелпер _get_review_lesson_for_skill(conn, skill_tag)
- **Confidence:** 0.9
### 52. admin_content_unused_import_re 🔵 secondary
- **Файл:** `routers/admin_content.py:27`
- **Snippet:** `import logging
import re
from typing import Optional`
- **Проблема:** мёртвый импорт, сбивает при чтении модуля
- **Как воспроизвести:** grep 're\.' routers/admin_content.py — ни одного использования
- **Что сделать:** удалить `import re`
- **Confidence:** 0.95
### 53. feed_unused_import_os 🔵 secondary
- **Файл:** `routers/feed.py:15`
- **Snippet:** `import json
import re
import uuid
import os`
- **Проблема:** мёртвый импорт
- **Как воспроизвести:** grep 'os\.' routers/feed.py — не используется (пути через Path/UPLOADS_DIR)
- **Что сделать:** удалить `import os`
- **Confidence:** 0.9
### 54. admin_content_update_lesson_row_by_row 🔵 secondary
- **Файл:** `routers/admin_content.py:780`
- **Snippet:** `for idx, ex in enumerate(examples, start=1):
await conn.execute("""
INSERT INTO less`
- **Проблема:** сохранение урока с 10 вопросами × 4 опции = ~50 последовательных round-trip в одной транзакции; при медленной сети/локах транзакция держит коннект секунды
- **Как воспроизвести:** PUT /admin/content/lessons/lesson/x с 10 вопросами → 1 UPDATE + 1 DELETE + 10 INSERT examples + 10×(SELECT+UPDATE+DELETE+4 INSERT) ≈ 70 запросов
- **Что сделать:** использовать executemany / COPY / INSERT ... SELECT FROM unnest($1::text[][]) для батч-вставки
- **Confidence:** 0.85
### 55. tts_path_traversal_via_cache_dir 🔗 both
- **Файл:** `routers/tts.py:30`
- **Snippet:** `CACHE_DIR = "/root/filwordspl/backend/tts_cache"
os.makedirs(CACHE_DIR, exist_ok=True)`
- **Проблема:** Хардкод абсолютного пути — при деплое в другой каталог/контейнер os.makedirs упадёт с PermissionError на старте приложения, весь backend не поднимется
- **Как воспроизвести:** Запустить backend из другого окружения (Docker, staging) → ImportError/PermissionError при импорте routers.tts
- **Что сделать:** Вынести путь в config/env (TTS_CACHE_DIR), использовать os.getenv с дефолтом относительно __file__
- **Confidence:** 0.93
### 56. admin_stats_duplicated 🔵 secondary
- **Файл:** `routers/assistant.py:330`
- **Snippet:** `online_now = await conn.fetchval("""
SELECT COUNT(DISTINCT user_id) FROM (`
- **Проблема:** Запросы total_users/new_today/online_now/level_counts полностью дублируются между routers/leaderboard.py:get_admin_stats и routers/assistant.py:get_admin_stats — правки в одном месте расходятся со вторым.
- **Как воспроизвести:** сравнить /leaderboard/admin/stats и /assistant/stats/admin — одинаковый код в двух файлах
- **Что сделать:** Вынести общие агрегаты в общий сервис/модуль stats.py
- **Confidence:** 0.9
### 57. tts_blocking_io_event_loop 🔵 secondary
- **Файл:** `routers/tts.py:55`
- **Snippet:** `with open(cache_path, 'rb') as f:
return Response(`
- **Проблема:** Синхронные open/read/write в async-хендлере блокируют event loop: при медленном диске/большом кэше зависают все запросы сервера, включая игру.
- **Как воспроизвести:** много параллельных запросов /tts с cache miss → latency всех эндпоинтов растёт
- **Что сделать:** Использовать asyncio.to_thread / aiofiles для чтения и записи кэша
- **Confidence:** 0.85
### 58. col_exists_migration_duplication 🔵 secondary
- **Файл:** `database.py:55`
- **Snippet:** `col_exists = await conn.fetchval("""
SELECT 1 FROM information_schema.columns
WHERE tab`
- **Проблема:** один и тот же блок fetchval+ALTER скопирован ~12 раз с разными именами — легко забыть добавить проверку для новой колонки или ошибиться в table_name (ошибка всплывёт только на проде)
- **Как воспроизвести:** добавить новую колонку в любую таблицу → скопировать блок → опечатка в table_name → ALTER на несуществующей таблице падает на старте
- **Что сделать:** хелпер ensure_column(conn, table, column, ddl) с параметризованным запросом через $1/$2
- **Confidence:** 0.9
### 59. init_db_ddl_every_startup 🔵 secondary
- **Файл:** `database.py:20`
- **Snippet:** `async with conn.transaction():
# ============ users ============
await conn.execute("""
`
- **Проблема:** ~500 строк DDL, десятки information_schema-проверок и ALTER выполняются при каждом старте в одной транзакции: долгий старт, блокировки каталога PostgreSQL, риск частично применённой схемы при таймауте деплоя
- **Как воспроизвести:** рестарт приложения → в логах десятки миграционных проверок; время старта растёт с числом таблиц
- **Что сделать:** вынести в отдельные версионированные миграции (alembic/yoyo), в init_db оставить только проверку версии схемы
- **Confidence:** 0.88
---
**Итого:** всего находок=124, overshoot=6, snippet не совпал=15, низкий confidence=0, прошло=59
_Этот Issue создан автоматически. Исправления делаются вручную._
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
🤖 AI Code Review (Backend)
Дата: 2026-09-25 19:38 UTC
Модели:
deepseek-ai/DeepSeek-V4.1-Flash+zai-org/GLM-5.3-FlashРепозиторий:
Drobysh/filwordspl-backend📊 По пакам
🔴 Влияет на ученика (20)
1. completion_time_type_unvalidated 🔵 secondary
routers/game.py:168if completion_time is not None and completion_time < 5:2. session_complete_no_session_id_check
Файл:
routers/learning.py:0Snippet: `session_id = body.get("session_id")
pool = await get_pool()
async with pool.acquire() as conn:
session `
Проблема: При отсутствии session_id в теле запроса asyncpg падает с ошибкой типа → 500 вместо понятной 400
Как воспроизвести: POST /learning/session/complete с пустым body → 500 Internal Server Error
Что сделать: if not session_id: raise HTTPException(400, "session_id required") до обращения к БД
Confidence: 0.9
3. update_skill_mastery_previous_mastery_self_reference
routers/learning.py:0previous_mastery = float(previous_row["mastery_score"]) if previous_row and previous_row["mastery_score"] else mastery4. diagnostic_test_no_options_in_resume
routers/teacher.py:320if session["session_type"] == "teacher_test": questions = await get_test_questions(conn, session["topic_5. save_answer_ignores_hint_used 🔗 both
routers/teacher.py:130await save_answer_to_session( conn, telegram_id, session_id, question_data, selected_answer, is_6. diagnostic_test_questions_not_persisted
routers/teacher.py:780SELECT * FROM learning_questions WHERE is_test_question = TRUE ORDER BY RANDOM() LIM7. answer_question_not_in_session 🔗 both
routers/teacher.py:620current_index = 0 for i, q in enumerate(questions): if q["question"]["question_id"] == question_id:8. orchestrator_weak_skill_ignores_retention
routers/orchestrator.py:78WHERE user_id = $1 AND mastery_score < 75 AND attempts_count >= 29. orchestrator_lesson_id_not_in_null 🔗 both
routers/orchestrator.py:137AND l.lesson_id NOT IN ( SELECT lesson_id FROM user_lesson_progress WHERE user_id = $2 AND10. orchestrator_lesson_questions_no_active_filter
routers/orchestrator.py:200SELECT * FROM learning_questions WHERE lesson_id = $1 AND is_test_question = FALSE ORDER BY id11. review_always_first_lesson 🔵 secondary
routers/orchestrator.py:44WHERE l.skill_tag = $1 AND l.is_active = TRUE ORDER BY l.order_number LIMIT 112. current_level_param_mismatch 🔵 secondary
routers/orchestrator.py:30SELECT current_level FROM users WHERE telegram_id = $1 """, user_id) or "A1"13. test_step_no_level_check 🔵 secondary
routers/orchestrator.py:88WHERE tp.user_id = $1 AND tp.lessons_completed >= tp.lessons_total AND tp.lessons_total > 014. feed_get_feed_post_no_expires_check
routers/feed.py:178SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE15. admin_dashboard_online_now_uses_wrong_columns
routers/admin.py:78SELECT user_id FROM user_progress WHERE completed_at > NOW() - INTERVAL '30 minutes'16. leaderboard_rank_off_by_one
routers/leaderboard.py:60user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot17. login_streak_nondeterministic_grp 🔵 secondary
routers/achievements.py:262SELECT COUNT(*) FROM dates WHERE grp = (SELECT grp FROM dates LIMIT 1)18. leaderboard_rank_achievement_uses_wrong_rank 🔗 both
routers/leaderboard.py:175if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)19. register_race_unique_violation 🔵 secondary
routers/users.py:27row = await conn.fetchrow( """INSERT INTO users (telegram_id, username, current_level)20. matview_if_not_exists_drift 🔵 secondary
main.py:152CREATE MATERIALIZED VIEW IF NOT EXISTS leaderboard_cache AS🟠 Риск для данных (24)
21. wordquiz_client_controls_correct_answer
routers/wordquiz.py:130correct_polish = body.get("correct_polish", "") user_answer = body.get("answer", "")22. wordquiz_consolation_score_repeatable
routers/wordquiz.py:200if mistakes >= 3: await conn.execute(""" INSERT INTO word_quiz_progress (user_id, wo23. update_skill_mastery_previous_mastery_score_not_updated
routers/learning.py:0previous_mastery_score = $25, mastery_delta = $26,24. complete_session_no_idempotency
routers/learning.py:0await conn.execute("UPDATE learning_sessions SET is_completed = TRUE, completed_at = NOW() WHERE id = $1", session_id)25. history_save_no_size_limit 🔗 both
Файл:
routers/teacher.py:900Snippet: `messages = body.get("messages", [])
if not isinstance(messages, list):
raise HTTPException(400, "messag`
Проблема: Нет ограничения на размер messages — атакующий может залить мегабайты JSON в teacher_chat_history, раздувая БД и вызывая OOM при загрузке.
Как воспроизвести: POST /teacher/history/save с messages = [{'x': 'A'*1000000}] * 1000 — запись на гигабайты.
Что сделать: Ограничить: len(messages) <= 200 и общий размер json.dumps(messages) <= 100KB, иначе 413.
Confidence: 0.93
26. ai_limit_race_condition
routers/teacher.py:155if not await check_ai_limit(conn, telegram_id): return get_ai_limit_message(lang)27. ai_limit_check_race 🔵 secondary
routers/teacher.py:130usage = await get_teacher_ai_usage(conn, user_id) return usage < TEACHER_AI_DAILY_LIMIT28. ai_limit_not_incremented_on_failure
routers/teacher.py:165if ai_response: async with pool.acquire() as conn: await increment_teacher_ai_usage(conn, telegram_i29. phrase_of_day_race_condition
routers/teacher.py:260today_phrase = await conn.fetchrow(""" SELECT * FROM daily_phrases WHERE phrase_date = $1 """, today30. phrase_day_ai_inside_conn 🔵 secondary
routers/teacher.py:300ai_response = await call_ai(user_prompt, system_prompt, max_tokens=1000)31. orchestrator_reaction_lang_unsafe 🔗 both
routers/orchestrator.py:275field = f"text_{lang}" return row.get(field) or row.get("text_en") or "OK"32. orchestrator_wrong_because_lang_unsafe
routers/orchestrator.py:296field = f"explanation_{lang}" return row.get(field) or row.get("explanation_en") or ""33. feed_upload_image_no_magic_bytes_check
routers/feed.py:620content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:34. support_admin_reply_no_message_length_check_on_ticket_id_type 🔗 both
routers/support.py:245ticket_id = body.get("ticket_id") message = body.get("message", "").strip()35. admin_content_update_word_updates_all_levels_rows
routers/admin_content.py:268WHERE level = $5 AND word_pl = $636. achievements_check_race_condition
routers/achievements.py:340matching = await conn.fetch(""" SELECT a.* FROM achievements a WHERE a.requirement_type = $137. save_analytics_bypasses_limits 🔵 secondary
Файл:
routers/assistant.py:268Snippet: `message = body.get("message", "").strip()
if not message:
raise HTTPException(400, "Message is required`
Проблема: Эндпоинт сохраняет произвольный текст как сообщение ассистента (is_user=False) без проверки длины и дневного лимита — можно раздуть историю/контекст и подменить ответы бота, а также обойти лимит 5 сообщений.
Как воспроизвести: POST /assistant/save-analytics с message длиной 10 МБ → сохраняется в chat_history без лимита
Что сделать: Добавить проверку len(message) <= 500 и лимит на количество вызовов, валидировать источник (только серверная аналитика)
Confidence: 0.85
38. auth_query_param_initdata_leaks_in_logs 🔗 both
auth.py:78init_data = request.query_params.get('initData', '')39. auth_hmac_secret_key_order_wrong
auth.py:55secret_key = hmac.new( 'WebAppData'.encode(), BOT_TOKEN.encode(), hashlib.sha25640. learning_tables_no_user_fk 🔵 secondary
database.py:336CREATE TABLE IF NOT EXISTS learning_sessions ( id BIGSERIAL PRIMARY KEY, user_id41. static_uploads_no_auth_no_size_limit 🔗 both
main.py:172app.mount("/uploads", StaticFiles(directory=UPLOADS_DIR), name="uploads")42. ratelimit_no_global_ip_cap 🔵 secondary
Файл:
main.py:262Snippet: `rate_key = f"{client_ip}:{path}"
if not rate_limiter.is_allowed(rate_key, path):`
Проблема: лимит только per-path: атакующий с одного IP может одновременно долбить все ~25 эндпоинтов, каждый со своим лимитом (60+30+30+... запросов/мин) — дорогие AI-эндпоинты (/assistant, /teacher, /tts) выжигают бюджет суммарно
Как воспроизвести: циклом слать по 55 запросов/мин на каждый AI-эндпоинт с одного IP — ни один 429 не вернётся
Что сделать: добавить глобальный per-IP лимит (например 120/мин) поверх per-path, проверять оба ключа
Confidence: 0.85
43. rate_limiter_memory_leak_unbounded_keys
main.py:78self.requests = defaultdict(list)44. ratelimit_inmemory_multivorker 🔵 secondary
Файл:
main.py:47Snippet: `class RateLimiter:
"""In-memory rate limiter.
⚠️ ВАЖНО: работает корректно только при ОДНОМ воркере uvicorn.`
Проблема: при запуске --workers N или после рестарта лимиты обнуляются/умножаются: /game/complete-level фактически 10*N/мин, рестарт сбрасывает счётчики — брутфорс и выжигание AI-бюджета
Как воспроизвести: запустить uvicorn --workers 4 → один IP получает 240 req/min на default-лимите
Что сделать: перевести на Redis (INCR + EXPIRE) до горизонтального масштабирования
Confidence: 0.8
🟡 Качество кода (15)
45. retention_score_hardcoded_zero 🔵 secondary
routers/learning.py:428) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, 0, $14,46. orchestrator_duplicate_lesson_query
routers/orchestrator.py:47lesson = await conn.fetchrow(""" SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.titl47. orchestrator_duplicate_options_loader
routers/orchestrator.py:175question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids: all_options = awa48. orchestrator_random_reaction_full_scan
routers/orchestrator.py:253FROM teacher_reactions WHERE reaction_type = $1 ORDER BY RANDOM() LIMIT 149. profile_hash_decimal_only
routers/learning_profile.py:47if isinstance(v, Decimal): item[k] = float(v) else: item[k] = v50. options_loader_triplicated 🔵 secondary
routers/orchestrator.py:190question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids:51. review_lesson_query_duplicated 🔵 secondary
routers/orchestrator.py:44SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.title_uk, l.title_en FROM learning_le52. admin_content_unused_import_re 🔵 secondary
routers/admin_content.py:27import logging import re from typing import Optionalimport re53. feed_unused_import_os 🔵 secondary
routers/feed.py:15import json import re import uuid import osimport os54. admin_content_update_lesson_row_by_row 🔵 secondary
routers/admin_content.py:780for idx, ex in enumerate(examples, start=1): await conn.execute(""" INSERT INTO less55. tts_path_traversal_via_cache_dir 🔗 both
routers/tts.py:30CACHE_DIR = "/root/filwordspl/backend/tts_cache" os.makedirs(CACHE_DIR, exist_ok=True)56. admin_stats_duplicated 🔵 secondary
routers/assistant.py:330online_now = await conn.fetchval(""" SELECT COUNT(DISTINCT user_id) FROM (57. tts_blocking_io_event_loop 🔵 secondary
routers/tts.py:55with open(cache_path, 'rb') as f: return Response(58. col_exists_migration_duplication 🔵 secondary
database.py:55col_exists = await conn.fetchval(""" SELECT 1 FROM information_schema.columns WHERE tab59. init_db_ddl_every_startup 🔵 secondary
database.py:20async with conn.transaction(): # ============ users ============ await conn.execute("""Итого: всего находок=124, overshoot=6, snippet не совпал=15, низкий confidence=0, прошло=59
Этот Issue создан автоматически. Исправления делаются вручную.