🤖 AI Review (backend): 49 задач (2026-09-25 18:44 UTC) #16

Open
opened 2026-09-25 18:44:57 +00:00 by Drobysh · 0 comments
Owner

🤖 AI Code Review (Backend)

Дата: 2026-09-25 18:44 UTC
Модель: deepseek-ai/DeepSeek-V4.1-Flash
Репозиторий: Drobysh/filwordspl-backend

📊 По пакам

  • routers_games — 7 файлов, 65,802 символов, находок=10
  • routers_learning — 4 файлов, 100,197 символов, находок=10
  • routers_admin — 4 файлов, 97,143 символов, находок=9
  • routers_misc — 5 файлов, 69,714 символов, находок=10
  • core — 4 файлов, 69,897 символов, находок=10
  • services — 0 файлов, 0 символов, находок=0

🔴 Влияет на ученика (10)

1. teacher_resume_wrong_lesson_recovery

  • Файл: routers/teacher.py:1
  • Snippet: lesson_id = await conn.fetchval(""" SELECT lesson_id FROM learning_lessons WHERE
  • Проблема: При resume сессии без ответов берётся ПЕРВЫЙ урок темы, а не тот, который был начат. Если ученик начал 3-й урок темы и закрыл приложение до первого ответа — resume вернёт 1-й урок, ученик потеряет прогресс и увидит не тот урок
  • Как воспроизвести: Начать урок 3 темы → закрыть до ответа → /teacher/resume → вернётся урок 1
  • Что сделать: Хранить lesson_id в learning_sessions при создании сессии, либо брать из session_type/доп. поля
  • Confidence: 0.85

2. learning_analytics_ai_response_keyerror

  • Файл: routers/learning.py:1
  • Snippet: data = response.json() ai_response = data["choices"][0]["message"]["content"].strip()
  • Проблема: Если Together AI вернёт неожиданный формат (reasoning_content, пустой choices), /analytics падает с KeyError/IndexError → 500, ученик не видит аналитику
  • Как воспроизвести: Together AI возвращает ответ без 'content' → POST /learning/analytics → 500
  • Что сделать: Использовать .get() с fallback как в teacher.call_ai, обернуть в try/except
  • Confidence: 0.85

3. learning_analytics_ai_response_none

  • Файл: routers/learning.py:1
  • Snippet: ai_response = data["choices"][0]["message"]["content"].strip() ai_response = ai_response.replace("**", "").r
  • Проблема: Если content=None (Together AI иногда возвращает null), .strip() падает с AttributeError → 500
  • Как воспроизвести: Together AI возвращает content=null → POST /learning/analytics → 500
  • Что сделать: ai_response = (data['choices'][0]['message'].get('content') or '').strip()
  • Confidence: 0.82

4. teacher_answer_ai_explanation_after_commit

  • Файл: routers/teacher.py:1
  • Snippet: explanation_text = db_explanation if needs_ai_explanation: explanation_text = await get_wrong_answer_ai_expl
  • Проблема: AI-объяснение ошибки вызывается ПОСЛЕ того, как сессия помечена completed и mastery обновлён. Если AI-вызов падает с исключением (не возвращает '', а бросает), ученик получает 500 и не видит ни реакции, ни следующего вопроса, хотя ответ уже записан
  • Как воспроизвести: Отключить сеть → POST /teacher/answer с неправильным ответом → 500, ответ в БД есть, но UI не получил next_question
  • Что сделать: Обернуть get_wrong_answer_ai_explanation в try/except, при ошибке вернуть db_explanation или пустую строку
  • Confidence: 0.8

5. learning_analytics_no_httpx_error_handling

  • Файл: routers/learning.py:1
  • Snippet: async with httpx.AsyncClient(timeout=90.0) as client: response = await client.post( TOGETHER
  • Проблема: При сетевой ошибке/таймауте httpx бросает исключение → 500 без понятного сообщения, ученик видит 'Internal Server Error'
  • Как воспроизвести: Отключить сеть → POST /learning/analytics → 500
  • Что сделать: Обернуть в try/except httpx.HTTPError, вернуть понятную ошибку
  • Confidence: 0.8

6. teacher_phrase_of_day_ai_failure_caches_fallback

  • Файл: routers/teacher.py:1
  • Snippet: if ai_response: # Парсим текстовый ответ построчно lines = ai_response.strip().split('\n
  • Проблема: Если AI упал, в БД сохраняется fallback-фраза 'Lepiej późno niż wcale' на ВСЮ дату для ВСЕХ пользователей. Даже когда AI восстановится, фраза дня не обновится до следующих суток
  • Как воспроизвести: AI недоступен в 00:00 → фраза дня = fallback на весь день для всех
  • Что сделать: Не сохранять в БД при пустом ai_response, либо помечать как fallback и перезапрашивать
  • Confidence: 0.8

7. teacher_explain_ai_failure_no_fallback

  • Файл: routers/teacher.py:1

  • Snippet: `ai_response = await call_ai(content, system_prompt)

    if ai_response:
    async with pool.acquire() as conn:
    `

  • Проблема: Если AI упал, возвращается пустая строка без объяснения. Ученик нажимает 'Объяснить' и видит пустоту, не понимая что произошло

  • Как воспроизвести: AI недоступен → POST /teacher/explain → {response: ''}

  • Что сделать: Возвращать fallback-сообщение или флаг error

  • Confidence: 0.8

8. admin_update_lesson_no_question_removal

  • Файл: routers/admin_content.py:1
  • Snippet: for q in questions: # Проверяем, что вопрос принадлежит этому уроку q_exists = await con
  • Проблема: Если админ удалил вопрос из урока в редакторе, старый вопрос остаётся в БД и продолжает показываться ученику
  • Как воспроизвести: Открыть урок с 3 вопросами → удалить один → сохранить → вопрос всё ещё в БД и в игре
  • Что сделать: Собирать список question_id из body и делать DELETE FROM learning_questions WHERE lesson_id=$1 AND question_id != ALL($2)
  • Confidence: 0.85

9. track_login_streak_uses_grp_of_first_row

  • Файл: routers/achievements.py:392
  • Snippet: SELECT COUNT(*) FROM dates WHERE grp = (SELECT grp FROM dates LIMIT 1)
  • Проблема: Ученик видит неверный стрик (например, 1 вместо 5) и не получает достижение login_7, хотя заходил 7 дней подряд.
  • Как воспроизвести: Заходить 7 дней подряд → /achievements/track-login возвращает streak, не соответствующий реальному.
  • Что сделать: Считать стрик от CURRENT_DATE: WHERE grp = (SELECT grp FROM dates WHERE login_date = CURRENT_DATE) или явно ограничить окно.
  • Confidence: 0.8

10. leaderboard_rank_ignores_zero_score_users

  • Файл: routers/leaderboard.py:60
  • Snippet: SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE total_score > 0
  • Проблема: Ученик с 0 очков видит себя на позиции, равной числу активных игроков + 1, а не реальному месту среди всех — путаница в рейтинге.
  • Как воспроизвести: Новый юзер без очков открывает /leaderboard → my_rank.rank не совпадает с реальным положением.
  • Что сделать: Считать rank по COUNT(*) всех записей с total_score > my_total (включая 0), либо явно документировать поведение.
  • Confidence: 0.76

🟠 Риск для данных (26)

11. check_word_no_level_ownership_check

  • Файл: routers/game.py:168
  • Snippet: level = await conn.fetchrow("SELECT * FROM levels WHERE id = $1", level_id)
  • Проблема: Ученик может отправить level_id любого уровня (в т.ч. чужого уровня/языка) и накрутить current_streak в user_progress
  • Как воспроизвести: POST /game/check-word с level_id из другого уровня → streak растёт, достижение perfect_words выдаётся
  • Что сделать: Проверять level['level'] == user['current_level'] и доступность уровня (level_number <= last_completed+1), как в get_level
  • Confidence: 0.85

12. check_word_accepts_any_cells_no_path_validation

  • Файл: routers/game.py:186
  • Snippet: for cell in selected_cells: r, c = cell[0], cell[1]
  • Проблема: Клиент может прислать произвольные координаты (в т.ч. не соседние) и собрать любое слово из сетки, обходя правила филворда
  • Как воспроизвести: POST /game/check-word с cells=0,0],[5,5],[9,9 → слово собирается из несоседних букв
  • Что сделать: Проверять, что cells образуют непрерывный путь (соседние клетки) и совпадают с word_paths[word]
  • Confidence: 0.8

13. check_word_negative_index_bypass

  • Файл: routers/game.py:187
  • Snippet: selected_word += grid_letters[r][c]
  • Проблема: Отрицательные индексы (r=-1) не вызывают IndexError и берут буквы с конца — можно собрать слово не по правилам
  • Как воспроизвести: POST /game/check-word с cells=-1,-1 → берётся последняя буква сетки
  • Что сделать: Валидировать 0 <= r < grid_size и 0 <= c < grid_size перед доступом
  • Confidence: 0.8

14. complete_level_race_double_score

  • Файл: routers/game.py:260
  • Snippet: existing_progress = await conn.fetchrow( "SELECT score, completed_at FROM user_progress WHERE user_id = $1 A
  • Проблема: Два параллельных запроса complete-level на один уровень оба пройдут проверку is_really_completed=False и начислят очки дважды
  • Как воспроизвести: Отправить два POST /game/complete-level одновременно → total_score удваивается
  • Что сделать: Использовать SELECT ... FOR UPDATE или атомарный INSERT ... ON CONFLICT DO NOTHING с проверкой rowcount
  • Confidence: 0.78

15. wordquiz_check_trusts_client_correct_polish

  • Файл: routers/wordquiz.py:152
  • Snippet: correct_polish = body.get("correct_polish", "") user_answer = body.get("answer", "")
  • Проблема: Клиент сам присылает correct_polish — можно отправить answer == correct_polish и всегда получать очки и достижения
  • Как воспроизвести: POST /wordquiz/check {correct_polish:'x', answer:'x'} → correct:true, score начислен
  • Что сделать: Хранить правильный ответ на сервере (в word_quiz_progress.pending_word) и сверять с ним
  • Confidence: 0.9

16. wordquiz_check_race_streak

  • Файл: routers/wordquiz.py:175
  • Snippet: current_streak = await conn.fetchval( "SELECT correct_streak FROM word_quiz_progress WHERE user_id = $1",
  • Проблема: Параллельные запросы /wordquiz/check читают одинаковый streak и оба инкрементят — streak и очки считаются неверно
  • Как воспроизвести: Отправить 2 POST /wordquiz/check одновременно → streak увеличивается на 1 вместо 2
  • Что сделать: Использовать UPDATE ... SET correct_streak = correct_streak + 1 RETURNING correct_streak
  • Confidence: 0.78

17. bubblewords_complete_no_min_time_check

  • Файл: routers/bubblewords.py:179
  • Snippet: completion_time = body.get("completion_time")
  • Проблема: Нет проверки минимального времени (в отличие от game/wordquiz/sentences) — можно мгновенно завершать уровни и получать bubble_speed
  • Как воспроизвести: POST /bubblewords/complete {completion_time: 0.1} → достижение bubble_speed выдаётся
  • Что сделать: Добавить проверку completion_time >= N секунд, как в других роутерах
  • Confidence: 0.82

18. sentences_check_race_double_score

  • Файл: routers/sentences.py:195
  • Snippet: existing_progress = await conn.fetchrow( "SELECT score, completed_at FROM sentence_progress WHERE user_id =
  • Проблема: Параллельные POST /sentences/check на одно предложение оба пройдут проверку и начислят очки дважды
  • Как воспроизвести: Отправить 2 POST /sentences/check одновременно → score удваивается
  • Что сделать: INSERT ... ON CONFLICT (user_id, sentence_id) DO NOTHING и проверять rowcount перед начислением
  • Confidence: 0.78

19. learning_complete_session_no_idempotency

  • Файл: routers/learning.py:1
  • Snippet: await conn.execute("UPDATE learning_sessions SET is_completed = TRUE, completed_at = NOW() WHERE id = $1", session_id)
  • Проблема: Повторный вызов /session/complete для той же сессии повторно инкрементирует attempts_count и correct_count в user_lesson_progress, завышая статистику ученика
  • Как воспроизвести: POST /session/complete дважды с одним session_id → attempts_count += 2, correct_count += 2×
  • Что сделать: Проверять session['is_completed'] перед UPDATE, или WHERE id=$1 AND is_completed=FALSE и проверять rowcount
  • Confidence: 0.88

20. learning_save_answer_no_session_completed_check

  • Файл: routers/learning.py:1
  • Snippet: session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id)
  • Проблема: Можно отправлять ответы в уже завершённую сессию — они попадут в user_learning_answers и исказят аналитику/mastery
  • Как воспроизвести: Завершить сессию → POST /learning/answer с тем же session_id → ответ записан, mastery пересчитан при следующем complete
  • Что сделать: Проверять session['is_completed'] = FALSE перед INSERT
  • Confidence: 0.82

21. teacher_ai_limit_race_condition

  • Файл: routers/teacher.py:1
  • Snippet: async def check_ai_limit(conn, user_id: int) -> bool: """Проверяет, может ли пользователь использовать AI-команду.""
  • Проблема: Проверка лимита и инкремент — две отдельные транзакции. При параллельных запросах ученик может превысить лимит 5/день (например, 10 AI-вызовов вместо 5)
  • Как воспроизвести: Отправить 10 параллельных POST /teacher/explain → все пройдут проверку, лимит превышен
  • Что сделать: Атомарный UPDATE ... WHERE command_count < LIMIT RETURNING, или SELECT FOR UPDATE
  • Confidence: 0.82

22. admin_update_word_updates_all_levels

  • Файл: routers/admin_content.py:1
  • Snippet: UPDATE level_words SET word_pl = $1, translation_ru = $2, translation_uk = $
  • Проблема: При редактировании одного слова админ может случайно перезаписать переводы всех омонимов того же уровня (включая привязки к игровым уровням Филвордов), что сломает контент игры
  • Как воспроизвести: PUT /admin/content/words/word/{id} с новым word_pl → все строки с (level, old_word_pl) обновлены, включая level_id != NULL
  • Что сделать: Ограничить UPDATE конкретным id или явно разделить: обновлять строку по id, а привязки — отдельным запросом с явным списком id
  • Confidence: 0.82

23. admin_update_word_no_duplicate_check

  • Файл: routers/admin_content.py:1
  • Snippet: result = await conn.execute(""" UPDATE level_words SET word_pl = $1,
  • Проблема: При переименовании слова в уже существующее в этом уровне создаётся дубликат (word_pl), что ломает уникальность и путает ученика в Word Quiz
  • Как воспроизвести: PUT /admin/content/words/word/{id} с word_pl, который уже есть в уровне → дубликат в БД
  • Что сделать: Перед UPDATE проверить SELECT 1 FROM level_words WHERE level=$1 AND level_id IS NULL AND LOWER(word_pl)=LOWER($2) AND id != $3
  • Confidence: 0.8

24. admin_update_lesson_no_question_id_validation

  • Файл: routers/admin_content.py:1
  • Snippet: question_id = (q.get("question_id") or "").strip() if not question_id: raise HTTPException(400, "que
  • Проблема: Админ может передать question_id другого урока — проверка есть, но только внутри транзакции после UPDATE learning_lessons, что даёт частичное сохранение при ошибке
  • Как воспроизвести: PUT с question_id из чужого урока → 400, но title/objective/examples уже обновлены (транзакция откатится, но HTTPException внутри transaction может не откатить в asyncpg)
  • Что сделать: Проверять все question_id ДО начала транзакции, либо убедиться что HTTPException внутри conn.transaction() действительно откатывает
  • Confidence: 0.75

25. feed_upload_image_no_magic_bytes_check

  • Файл: routers/feed.py:1
  • Snippet: content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:
  • Проблема: Проверяется только MIME-заголовок от клиента — можно загрузить .php/.html с content_type=image/jpeg и получить RCE/Stored XSS при отдаче через nginx
  • Как воспроизвести: POST /admin/feed/upload-image с файлом shell.php и Content-Type: image/jpeg → файл сохраняется как .jpg, но содержимое — PHP
  • Что сделать: Проверять magic bytes (PIL.Image.open или imghdr) и/или отдавать uploads через отдельный домен без исполнения
  • Confidence: 0.78

26. leaderboard_rank_achievement_side_effect_on_get

  • Файл: routers/leaderboard.py:175
  • Snippet: if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)
  • Проблема: Достижение rank_1/rank_top3 выдаётся при каждом GET /leaderboard, даже если юзер уже выпал из топ-3 — достижение остаётся навсегда.
  • Как воспроизвести: Занять топ-3 → открыть рейтинг → достижение выдано; упасть в рейтинге → достижение всё равно остаётся.
  • Что сделать: Выдавать достижение только при реальном входе в топ-3 (сравнение с предыдущим состоянием) или перенести в фоновый пересчёт.
  • Confidence: 0.79

27. assistant_save_user_message_before_quota_check_race

  • Файл: routers/assistant.py:200

  • Snippet: `await save_message(telegram_id, user_message, True)

    history = await get_history(telegram_id)`

  • Проблема: При параллельных запросах юзер может превысить дневной лимит: два запроса одновременно проходят проверку get_daily_usage до инкремента.

  • Как воспроизвести: Отправить 2 сообщения одновременно при remaining=1 → оба проходят, лимит превышен.

  • Что сделать: Атомарно проверять и инкрементировать лимит одним INSERT ... ON CONFLICT ... WHERE message_count < LIMIT RETURNING.

  • Confidence: 0.77

28. assistant_save_analytics_no_length_limit

  • Файл: routers/assistant.py:285

  • Snippet: `message = body.get("message", "").strip()

    if not message:
    raise HTTPException(400, "Message is required`

  • Проблема: Ученик может записать в историю чата произвольно длинный текст (мегабайты), раздувая БД и ломая UI истории.

  • Как воспроизвести: POST /assistant/save-analytics с message длиной 10 МБ → запись в chat_history без ограничения.

  • Что сделать: Добавить проверку len(message) <= 5000 (или разумный лимит) перед save_message.

  • Confidence: 0.83

29. tts_cache_path_no_cleanup_unbounded

  • Файл: routers/tts.py:30
  • Snippet: CACHE_DIR = "/root/filwordspl/backend/tts_cache" os.makedirs(CACHE_DIR, exist_ok=True)
  • Проблема: Кэш mp3-файлов растёт бесконечно — со временем диск переполняется, TTS и весь бэкенд падают.
  • Как воспроизвести: Долгая эксплуатация → тысячи mp3 в /root/filwordspl/backend/tts_cache без eviction.
  • Что сделать: Добавить LRU/TTL-очистку кэша (например, cron или периодический таск), либо ограничить размер директории.
  • Confidence: 0.8

30. rate_limiter_memory_leak_unbounded_keys

  • Файл: main.py:96
  • Snippet: self.requests[key] = [t for t in self.requests[key] if now - t < window]
  • Проблема: при большом числе уникальных IP:path ключей память процесса растёт, OOM, сервис падает для всех
  • Как воспроизвести: слать запросы с разных IP на разные пути → self.requests растёт быстрее, чем чистится (cleanup раз в 60с)
  • Что сделать: ограничить размер dict (LRU) или чистить агрессивнее; либо перейти на Redis
  • Confidence: 0.8

31. rate_limiter_key_includes_path_but_limits_lookup_by_path

  • Файл: main.py:88
  • Snippet: rate_key = f"{client_ip}:{path}"
  • Проблема: лимит обходится сменой пути с query-параметрами? нет — но лимит на /game/check-word не срабатывает для /game/check-word/ (trailing slash) и любых вариантов пути
  • Как воспроизвести: POST /game/check-word/ (со слэшем) → лимит default 60 вместо 30
  • Что сделать: нормализовать path (rstrip '/') перед lookup в self.limits
  • Confidence: 0.78

32. static_uploads_public_no_auth

  • Файл: main.py:262
  • Snippet: app.mount("/uploads", StaticFiles(directory=UPLOADS_DIR), name="uploads")
  • Проблема: любой может перебрать /uploads/ и скачать картинки feed-постов, включая неопубликованные
  • Как воспроизвести: GET /uploads/abc.jpg без авторизации → 200 OK
  • Что сделать: отдавать через эндпоинт с проверкой is_published, либо хранить вне public-пути
  • Confidence: 0.82

33. health_endpoint_bypasses_rate_limit

  • Файл: main.py:200
  • Snippet: if path in ["/", "/health"]:
  • Проблема: healthcheck без лимита — можно долбить БД SELECT 1 и положить пул
  • Как воспроизвести: ab -n 10000 /health → пул соединений исчерпан, остальные запросы ждут
  • Что сделать: добавить отдельный лимит для /health или кэшировать результат
  • Confidence: 0.77

34. auth_query_param_initdata_leaks_in_logs

  • Файл: auth.py:88
  • Snippet: init_data = request.query_params.get('initData', '')
  • Проблема: initData в query-параметре попадает в access-логи nginx/Cloudflare — утечка токена, replay-атака
  • Как воспроизвести: GET /feed/delete?initData=... → в логах nginx полный initData
  • Что сделать: убрать query-fallback, использовать только Authorization header
  • Confidence: 0.85

35. auth_verify_does_not_check_user_id_type

  • Файл: auth.py:76
  • Snippet: user_id = user_data.get('id')
  • Проблема: если Telegram пришлёт id как строку — user_id уйдёт строкой в SQL, потенциальные проблемы с BIGINT-кастом
  • Как воспроизвести: подделать initData с user.id="123" (если подпись валидна) → asyncpg может кинуть ошибку типа
  • Что сделать: приводить user_id = int(user_data['id']) с try/except
  • Confidence: 0.76

36. auth_hmac_secret_key_order

  • Файл: auth.py:55
  • Snippet: secret_key = hmac.new( 'WebAppData'.encode(), BOT_TOKEN.encode(), hashlib.sha256
  • Проблема: если порядок аргументов неверен — все подписи не проходят, но код работает, значит порядок верный; проверить соответствие документации Telegram
  • Как воспроизвести: сверить с https://core.telegram.org/bots/webapps#validating-data-received-via-the-mini-app
  • Что сделать: по докам: secret_key = HMAC_SHA256(key="WebAppData", msg=bot_token) — здесь верно, но добавить комментарий
  • Confidence: 0.75

🟡 Качество кода (13)

37. hints_remaining_no_level_check

  • Файл: routers/hints.py:175
  • Snippet: progress = await conn.fetchrow( "SELECT hints_used FROM user_progress WHERE user_id = $1 AND level_id = $2",
  • Проблема: Не баг для ученика, но эндпоинт не проверяет существование уровня и пользователя — возвращает 0/3 для несуществующих level_id
  • Как воспроизвести: GET /hints/remaining/999999 → 200 OK с remaining=3 вместо 404
  • Что сделать: Добавить проверку уровня и пользователя, как в get_first_letter_hint
  • Confidence: 0.8

38. bubblewords_complete_trusts_words_count

  • Файл: routers/bubblewords.py:178
  • Snippet: words_count = body.get("words_count", 3)
  • Проблема: words_count принимается от клиента, но нигде не используется — мёртвый параметр, вводит в заблуждение
  • Как воспроизвести: POST /bubblewords/complete {words_count: 999} → никак не влияет
  • Что сделать: Удалить параметр или использовать для валидации (сверить с реальным числом слов уровня)
  • Confidence: 0.85

39. admin_update_lesson_n_plus_1_question_check

  • Файл: routers/admin_content.py:1
  • Snippet: q_exists = await conn.fetchval(""" SELECT 1 FROM learning_questions WHERE questi
  • Проблема: При сохранении урока с 20 вопросами — 20 лишних round-trip к БД, сохранение тормозит
  • Как воспроизвести: PUT /admin/content/lessons/lesson/{id} с 20 вопросами → 20 отдельных SELECT
  • Что сделать: Один SELECT question_id FROM learning_questions WHERE lesson_id=$1 AND question_id = ANY($2) и сравнение множеств в Python
  • Confidence: 0.85

40. admin_update_lesson_n_plus_1_inserts

  • Файл: routers/admin_content.py:1
  • Snippet: for idx, ex in enumerate(examples, start=1): await conn.execute(""" INSERT INTO less
  • Проблема: При сохранении урока с примерами и опциями — сотни отдельных INSERT, сохранение может упасть по таймауту
  • Как воспроизвести: PUT /admin/content/lessons/lesson/{id} с 10 примерами и 20 вопросами × 4 опции → ~90 INSERT
  • Что сделать: Использовать executemany или один INSERT ... VALUES (...), (...), (...)
  • Confidence: 0.8

41. feed_update_removed_images_double_loop

  • Файл: routers/feed.py:1
  • Snippet: removed_images = body.get("removed_images", []) if removed_images and isinstance(removed_images, list):
  • Проблема: Дублирование логики парсинга URL и удаления — при расхождении в одной из веток файлы на диске и в БД разойдутся
  • Как воспроизвести: Правка одной из двух веток removed_images → рассинхрон БД и диска
  • Что сделать: Вынести парсинг URL и удаление в отдельную функцию _remove_attachment(conn, post_id, img_url)
  • Confidence: 0.8

42. support_admin_tickets_n_plus_1_subqueries

  • Файл: routers/support.py:1
  • Snippet: (SELECT COUNT(*) FROM support_messages m WHERE m.ticket_id = t.id AND m.is_read = FALSE) as unread_count,
  • Проблема: При большом числе тикетов админ-панель тормозит: 2 коррелированных подзапроса на каждую строку
  • Как воспроизвести: GET /support/admin-tickets с 500 тикетами → 1000 подзапросов
  • Что сделать: Использовать LATERAL JOIN или отдельный агрегирующий запрос с GROUP BY ticket_id
  • Confidence: 0.82

43. achievements_conn_held_during_award

  • Файл: routers/achievements.py:340
  • Snippet: async with pool.acquire() as conn: user_lang = await conn.fetchval(
  • Проблема: Под нагрузкой пул соединений исчерпывается, запросы к достижениям начинают ждать — ученик видит зависание после прохождения уровня.
  • Как воспроизвести: Открыть /achievements/track-* под нагрузкой → соединение удерживается на время всех INSERT-ов в цикле.
  • Что сделать: Вынести чтение user_lang и matching в один acquire, а INSERT-ы делать через executemany или отдельным acquire.
  • Confidence: 0.78

44. achievements_n_plus_1_insert_loop

  • Файл: routers/achievements.py:360
  • Snippet: for ach in matching: await conn.execute( "INSERT INTO user_achievements (user_id, achievemen
  • Проблема: При первом прохождении уровня с несколькими достижениями ответ приходит медленнее — ученик ждёт всплывашку.
  • Как воспроизвести: Пройти уровень, разблокирующий 3+ достижения → 3+ последовательных INSERT.
  • Что сделать: Заменить цикл на conn.executemany с одним INSERT ... ON CONFLICT DO NOTHING.
  • Confidence: 0.82

45. leaderboard_duplicate_cache_query

  • Файл: routers/leaderboard.py:55
  • Snippet: my_total_in_cache = await conn.fetchval(""" SELECT total_score FROM leaderboard_cache WHERE telegram_id = $1
  • Проблема: Лишний round-trip к БД на каждый запрос рейтинга — при большом числе игроков страница рейтинга открывается медленнее.
  • Как воспроизвести: Открыть /leaderboard → 2 одинаковых SELECT из leaderboard_cache по telegram_id.
  • Что сделать: Убрать первый fetchval, использовать my_row (уже загружен ниже) для получения my_total_in_cache.
  • Confidence: 0.85

46. tts_sync_file_io_in_async_handler

  • Файл: routers/tts.py:60
  • Snippet: with open(cache_path, 'rb') as f: return Response( content=f.read(),
  • Проблема: При чтении крупного mp3 синхронный I/O блокирует event loop — другие запросы (в т.ч. игровые) подвисают.
  • Как воспроизвести: Одновременно запросить TTS и игровой эндпоинт → игровой ждёт окончания чтения файла.
  • Что сделать: Использовать aiofiles или FileResponse для отдачи файла из кэша.
  • Confidence: 0.76

47. rate_limiter_cleanup_uses_max_window_not_per_key

  • Файл: main.py:78
  • Snippet: self.requests[key] = [t for t in self.requests[key] if now - t < max_window]
  • Проблема: не влияет напрямую, но cleanup хранит записи дольше нужного — память
  • Как воспроизвести: лимит с window=60 хранит записи до max_window (60) — ок; но если добавить window=3600, все ключи держат записи час
  • Что сделать: чистить по window конкретного пути, а не по max
  • Confidence: 0.76

48. cors_allow_credentials_false_but_auth_via_header

  • Файл: main.py:246
  • Snippet: allow_credentials=False,
  • Проблема: не баг сейчас, но если фронт начнёт использовать cookies — auth сломается молча
  • Как воспроизвести: добавить cookie-based auth → preflight отклонит credentials
  • Что сделать: задокументировать или включить allow_credentials=True при переходе на cookies
  • Confidence: 0.75

49. init_db_giant_transaction_blocks_startup

  • Файл: database.py:22
  • Snippet: async with conn.transaction():
  • Проблема: при рестарте вся инициализация в одной транзакции — долгий lock на information_schema и DDL, при ошибке на середине откат всего
  • Как воспроизвести: рестарт с большой БД → startup занимает десятки секунд, healthcheck 503
  • Что сделать: разбить на отдельные транзакции по группам таблиц или вынести в миграции (alembic)
  • Confidence: 0.78

Итого: всего находок=75, overshoot=1, snippet не совпал=0, низкий confidence=1, прошло=49

Этот Issue создан автоматически. Исправления делаются вручную.

# 🤖 AI Code Review (Backend) **Дата:** 2026-09-25 18:44 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` ## 📊 По пакам - **routers_games** — 7 файлов, 65,802 символов, находок=10 - **routers_learning** — 4 файлов, 100,197 символов, находок=10 - **routers_admin** — 4 файлов, 97,143 символов, находок=9 - **routers_misc** — 5 файлов, 69,714 символов, находок=10 - **core** — 4 файлов, 69,897 символов, находок=10 - **services** — 0 файлов, 0 символов, находок=0 --- ## 🔴 Влияет на ученика (10) ### 1. teacher_resume_wrong_lesson_recovery - **Файл:** `routers/teacher.py:1` - **Snippet:** `lesson_id = await conn.fetchval(""" SELECT lesson_id FROM learning_lessons WHERE` - **Проблема:** При resume сессии без ответов берётся ПЕРВЫЙ урок темы, а не тот, который был начат. Если ученик начал 3-й урок темы и закрыл приложение до первого ответа — resume вернёт 1-й урок, ученик потеряет прогресс и увидит не тот урок - **Как воспроизвести:** Начать урок 3 темы → закрыть до ответа → /teacher/resume → вернётся урок 1 - **Что сделать:** Хранить lesson_id в learning_sessions при создании сессии, либо брать из session_type/доп. поля - **Confidence:** 0.85 ### 2. learning_analytics_ai_response_keyerror - **Файл:** `routers/learning.py:1` - **Snippet:** `data = response.json() ai_response = data["choices"][0]["message"]["content"].strip()` - **Проблема:** Если Together AI вернёт неожиданный формат (reasoning_content, пустой choices), /analytics падает с KeyError/IndexError → 500, ученик не видит аналитику - **Как воспроизвести:** Together AI возвращает ответ без 'content' → POST /learning/analytics → 500 - **Что сделать:** Использовать .get() с fallback как в teacher.call_ai, обернуть в try/except - **Confidence:** 0.85 ### 3. learning_analytics_ai_response_none - **Файл:** `routers/learning.py:1` - **Snippet:** `ai_response = data["choices"][0]["message"]["content"].strip() ai_response = ai_response.replace("**", "").r` - **Проблема:** Если content=None (Together AI иногда возвращает null), .strip() падает с AttributeError → 500 - **Как воспроизвести:** Together AI возвращает content=null → POST /learning/analytics → 500 - **Что сделать:** ai_response = (data['choices'][0]['message'].get('content') or '').strip() - **Confidence:** 0.82 ### 4. teacher_answer_ai_explanation_after_commit - **Файл:** `routers/teacher.py:1` - **Snippet:** `explanation_text = db_explanation if needs_ai_explanation: explanation_text = await get_wrong_answer_ai_expl` - **Проблема:** AI-объяснение ошибки вызывается ПОСЛЕ того, как сессия помечена completed и mastery обновлён. Если AI-вызов падает с исключением (не возвращает '', а бросает), ученик получает 500 и не видит ни реакции, ни следующего вопроса, хотя ответ уже записан - **Как воспроизвести:** Отключить сеть → POST /teacher/answer с неправильным ответом → 500, ответ в БД есть, но UI не получил next_question - **Что сделать:** Обернуть get_wrong_answer_ai_explanation в try/except, при ошибке вернуть db_explanation или пустую строку - **Confidence:** 0.8 ### 5. learning_analytics_no_httpx_error_handling - **Файл:** `routers/learning.py:1` - **Snippet:** `async with httpx.AsyncClient(timeout=90.0) as client: response = await client.post( TOGETHER` - **Проблема:** При сетевой ошибке/таймауте httpx бросает исключение → 500 без понятного сообщения, ученик видит 'Internal Server Error' - **Как воспроизвести:** Отключить сеть → POST /learning/analytics → 500 - **Что сделать:** Обернуть в try/except httpx.HTTPError, вернуть понятную ошибку - **Confidence:** 0.8 ### 6. teacher_phrase_of_day_ai_failure_caches_fallback - **Файл:** `routers/teacher.py:1` - **Snippet:** `if ai_response: # Парсим текстовый ответ построчно lines = ai_response.strip().split('\n` - **Проблема:** Если AI упал, в БД сохраняется fallback-фраза 'Lepiej późno niż wcale' на ВСЮ дату для ВСЕХ пользователей. Даже когда AI восстановится, фраза дня не обновится до следующих суток - **Как воспроизвести:** AI недоступен в 00:00 → фраза дня = fallback на весь день для всех - **Что сделать:** Не сохранять в БД при пустом ai_response, либо помечать как fallback и перезапрашивать - **Confidence:** 0.8 ### 7. teacher_explain_ai_failure_no_fallback - **Файл:** `routers/teacher.py:1` - **Snippet:** `ai_response = await call_ai(content, system_prompt) if ai_response: async with pool.acquire() as conn: ` - **Проблема:** Если AI упал, возвращается пустая строка без объяснения. Ученик нажимает 'Объяснить' и видит пустоту, не понимая что произошло - **Как воспроизвести:** AI недоступен → POST /teacher/explain → {response: ''} - **Что сделать:** Возвращать fallback-сообщение или флаг error - **Confidence:** 0.8 ### 8. admin_update_lesson_no_question_removal - **Файл:** `routers/admin_content.py:1` - **Snippet:** `for q in questions: # Проверяем, что вопрос принадлежит этому уроку q_exists = await con` - **Проблема:** Если админ удалил вопрос из урока в редакторе, старый вопрос остаётся в БД и продолжает показываться ученику - **Как воспроизвести:** Открыть урок с 3 вопросами → удалить один → сохранить → вопрос всё ещё в БД и в игре - **Что сделать:** Собирать список question_id из body и делать DELETE FROM learning_questions WHERE lesson_id=$1 AND question_id != ALL($2) - **Confidence:** 0.85 ### 9. track_login_streak_uses_grp_of_first_row - **Файл:** `routers/achievements.py:392` - **Snippet:** `SELECT COUNT(*) FROM dates WHERE grp = (SELECT grp FROM dates LIMIT 1)` - **Проблема:** Ученик видит неверный стрик (например, 1 вместо 5) и не получает достижение login_7, хотя заходил 7 дней подряд. - **Как воспроизвести:** Заходить 7 дней подряд → /achievements/track-login возвращает streak, не соответствующий реальному. - **Что сделать:** Считать стрик от CURRENT_DATE: WHERE grp = (SELECT grp FROM dates WHERE login_date = CURRENT_DATE) или явно ограничить окно. - **Confidence:** 0.8 ### 10. leaderboard_rank_ignores_zero_score_users - **Файл:** `routers/leaderboard.py:60` - **Snippet:** `SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE total_score > 0` - **Проблема:** Ученик с 0 очков видит себя на позиции, равной числу активных игроков + 1, а не реальному месту среди всех — путаница в рейтинге. - **Как воспроизвести:** Новый юзер без очков открывает /leaderboard → my_rank.rank не совпадает с реальным положением. - **Что сделать:** Считать rank по COUNT(*) всех записей с total_score > my_total (включая 0), либо явно документировать поведение. - **Confidence:** 0.76 ## 🟠 Риск для данных (26) ### 11. check_word_no_level_ownership_check - **Файл:** `routers/game.py:168` - **Snippet:** `level = await conn.fetchrow("SELECT * FROM levels WHERE id = $1", level_id)` - **Проблема:** Ученик может отправить level_id любого уровня (в т.ч. чужого уровня/языка) и накрутить current_streak в user_progress - **Как воспроизвести:** POST /game/check-word с level_id из другого уровня → streak растёт, достижение perfect_words выдаётся - **Что сделать:** Проверять level['level'] == user['current_level'] и доступность уровня (level_number <= last_completed+1), как в get_level - **Confidence:** 0.85 ### 12. check_word_accepts_any_cells_no_path_validation - **Файл:** `routers/game.py:186` - **Snippet:** `for cell in selected_cells: r, c = cell[0], cell[1]` - **Проблема:** Клиент может прислать произвольные координаты (в т.ч. не соседние) и собрать любое слово из сетки, обходя правила филворда - **Как воспроизвести:** POST /game/check-word с cells=[[0,0],[5,5],[9,9]] → слово собирается из несоседних букв - **Что сделать:** Проверять, что cells образуют непрерывный путь (соседние клетки) и совпадают с word_paths[word] - **Confidence:** 0.8 ### 13. check_word_negative_index_bypass - **Файл:** `routers/game.py:187` - **Snippet:** `selected_word += grid_letters[r][c]` - **Проблема:** Отрицательные индексы (r=-1) не вызывают IndexError и берут буквы с конца — можно собрать слово не по правилам - **Как воспроизвести:** POST /game/check-word с cells=[[-1,-1]] → берётся последняя буква сетки - **Что сделать:** Валидировать 0 <= r < grid_size и 0 <= c < grid_size перед доступом - **Confidence:** 0.8 ### 14. complete_level_race_double_score - **Файл:** `routers/game.py:260` - **Snippet:** `existing_progress = await conn.fetchrow( "SELECT score, completed_at FROM user_progress WHERE user_id = $1 A` - **Проблема:** Два параллельных запроса complete-level на один уровень оба пройдут проверку is_really_completed=False и начислят очки дважды - **Как воспроизвести:** Отправить два POST /game/complete-level одновременно → total_score удваивается - **Что сделать:** Использовать SELECT ... FOR UPDATE или атомарный INSERT ... ON CONFLICT DO NOTHING с проверкой rowcount - **Confidence:** 0.78 ### 15. wordquiz_check_trusts_client_correct_polish - **Файл:** `routers/wordquiz.py:152` - **Snippet:** `correct_polish = body.get("correct_polish", "") user_answer = body.get("answer", "")` - **Проблема:** Клиент сам присылает correct_polish — можно отправить answer == correct_polish и всегда получать очки и достижения - **Как воспроизвести:** POST /wordquiz/check {correct_polish:'x', answer:'x'} → correct:true, score начислен - **Что сделать:** Хранить правильный ответ на сервере (в word_quiz_progress.pending_word) и сверять с ним - **Confidence:** 0.9 ### 16. wordquiz_check_race_streak - **Файл:** `routers/wordquiz.py:175` - **Snippet:** `current_streak = await conn.fetchval( "SELECT correct_streak FROM word_quiz_progress WHERE user_id = $1",` - **Проблема:** Параллельные запросы /wordquiz/check читают одинаковый streak и оба инкрементят — streak и очки считаются неверно - **Как воспроизвести:** Отправить 2 POST /wordquiz/check одновременно → streak увеличивается на 1 вместо 2 - **Что сделать:** Использовать UPDATE ... SET correct_streak = correct_streak + 1 RETURNING correct_streak - **Confidence:** 0.78 ### 17. bubblewords_complete_no_min_time_check - **Файл:** `routers/bubblewords.py:179` - **Snippet:** `completion_time = body.get("completion_time")` - **Проблема:** Нет проверки минимального времени (в отличие от game/wordquiz/sentences) — можно мгновенно завершать уровни и получать bubble_speed - **Как воспроизвести:** POST /bubblewords/complete {completion_time: 0.1} → достижение bubble_speed выдаётся - **Что сделать:** Добавить проверку completion_time >= N секунд, как в других роутерах - **Confidence:** 0.82 ### 18. sentences_check_race_double_score - **Файл:** `routers/sentences.py:195` - **Snippet:** `existing_progress = await conn.fetchrow( "SELECT score, completed_at FROM sentence_progress WHERE user_id = ` - **Проблема:** Параллельные POST /sentences/check на одно предложение оба пройдут проверку и начислят очки дважды - **Как воспроизвести:** Отправить 2 POST /sentences/check одновременно → score удваивается - **Что сделать:** INSERT ... ON CONFLICT (user_id, sentence_id) DO NOTHING и проверять rowcount перед начислением - **Confidence:** 0.78 ### 19. learning_complete_session_no_idempotency - **Файл:** `routers/learning.py:1` - **Snippet:** `await conn.execute("UPDATE learning_sessions SET is_completed = TRUE, completed_at = NOW() WHERE id = $1", session_id)` - **Проблема:** Повторный вызов /session/complete для той же сессии повторно инкрементирует attempts_count и correct_count в user_lesson_progress, завышая статистику ученика - **Как воспроизвести:** POST /session/complete дважды с одним session_id → attempts_count += 2, correct_count += 2× - **Что сделать:** Проверять session['is_completed'] перед UPDATE, или WHERE id=$1 AND is_completed=FALSE и проверять rowcount - **Confidence:** 0.88 ### 20. learning_save_answer_no_session_completed_check - **Файл:** `routers/learning.py:1` - **Snippet:** `session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id)` - **Проблема:** Можно отправлять ответы в уже завершённую сессию — они попадут в user_learning_answers и исказят аналитику/mastery - **Как воспроизвести:** Завершить сессию → POST /learning/answer с тем же session_id → ответ записан, mastery пересчитан при следующем complete - **Что сделать:** Проверять session['is_completed'] = FALSE перед INSERT - **Confidence:** 0.82 ### 21. teacher_ai_limit_race_condition - **Файл:** `routers/teacher.py:1` - **Snippet:** `async def check_ai_limit(conn, user_id: int) -> bool: """Проверяет, может ли пользователь использовать AI-команду.""` - **Проблема:** Проверка лимита и инкремент — две отдельные транзакции. При параллельных запросах ученик может превысить лимит 5/день (например, 10 AI-вызовов вместо 5) - **Как воспроизвести:** Отправить 10 параллельных POST /teacher/explain → все пройдут проверку, лимит превышен - **Что сделать:** Атомарный UPDATE ... WHERE command_count < LIMIT RETURNING, или SELECT FOR UPDATE - **Confidence:** 0.82 ### 22. admin_update_word_updates_all_levels - **Файл:** `routers/admin_content.py:1` - **Snippet:** `UPDATE level_words SET word_pl = $1, translation_ru = $2, translation_uk = $` - **Проблема:** При редактировании одного слова админ может случайно перезаписать переводы всех омонимов того же уровня (включая привязки к игровым уровням Филвордов), что сломает контент игры - **Как воспроизвести:** PUT /admin/content/words/word/{id} с новым word_pl → все строки с (level, old_word_pl) обновлены, включая level_id != NULL - **Что сделать:** Ограничить UPDATE конкретным id или явно разделить: обновлять строку по id, а привязки — отдельным запросом с явным списком id - **Confidence:** 0.82 ### 23. admin_update_word_no_duplicate_check - **Файл:** `routers/admin_content.py:1` - **Snippet:** `result = await conn.execute(""" UPDATE level_words SET word_pl = $1,` - **Проблема:** При переименовании слова в уже существующее в этом уровне создаётся дубликат (word_pl), что ломает уникальность и путает ученика в Word Quiz - **Как воспроизвести:** PUT /admin/content/words/word/{id} с word_pl, который уже есть в уровне → дубликат в БД - **Что сделать:** Перед UPDATE проверить SELECT 1 FROM level_words WHERE level=$1 AND level_id IS NULL AND LOWER(word_pl)=LOWER($2) AND id != $3 - **Confidence:** 0.8 ### 24. admin_update_lesson_no_question_id_validation - **Файл:** `routers/admin_content.py:1` - **Snippet:** `question_id = (q.get("question_id") or "").strip() if not question_id: raise HTTPException(400, "que` - **Проблема:** Админ может передать question_id другого урока — проверка есть, но только внутри транзакции после UPDATE learning_lessons, что даёт частичное сохранение при ошибке - **Как воспроизвести:** PUT с question_id из чужого урока → 400, но title/objective/examples уже обновлены (транзакция откатится, но HTTPException внутри transaction может не откатить в asyncpg) - **Что сделать:** Проверять все question_id ДО начала транзакции, либо убедиться что HTTPException внутри conn.transaction() действительно откатывает - **Confidence:** 0.75 ### 25. feed_upload_image_no_magic_bytes_check - **Файл:** `routers/feed.py:1` - **Snippet:** `content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:` - **Проблема:** Проверяется только MIME-заголовок от клиента — можно загрузить .php/.html с content_type=image/jpeg и получить RCE/Stored XSS при отдаче через nginx - **Как воспроизвести:** POST /admin/feed/upload-image с файлом shell.php и Content-Type: image/jpeg → файл сохраняется как .jpg, но содержимое — PHP - **Что сделать:** Проверять magic bytes (PIL.Image.open или imghdr) и/или отдавать uploads через отдельный домен без исполнения - **Confidence:** 0.78 ### 26. leaderboard_rank_achievement_side_effect_on_get - **Файл:** `routers/leaderboard.py:175` - **Snippet:** `if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)` - **Проблема:** Достижение rank_1/rank_top3 выдаётся при каждом GET /leaderboard, даже если юзер уже выпал из топ-3 — достижение остаётся навсегда. - **Как воспроизвести:** Занять топ-3 → открыть рейтинг → достижение выдано; упасть в рейтинге → достижение всё равно остаётся. - **Что сделать:** Выдавать достижение только при реальном входе в топ-3 (сравнение с предыдущим состоянием) или перенести в фоновый пересчёт. - **Confidence:** 0.79 ### 27. assistant_save_user_message_before_quota_check_race - **Файл:** `routers/assistant.py:200` - **Snippet:** `await save_message(telegram_id, user_message, True) history = await get_history(telegram_id)` - **Проблема:** При параллельных запросах юзер может превысить дневной лимит: два запроса одновременно проходят проверку get_daily_usage до инкремента. - **Как воспроизвести:** Отправить 2 сообщения одновременно при remaining=1 → оба проходят, лимит превышен. - **Что сделать:** Атомарно проверять и инкрементировать лимит одним INSERT ... ON CONFLICT ... WHERE message_count < LIMIT RETURNING. - **Confidence:** 0.77 ### 28. assistant_save_analytics_no_length_limit - **Файл:** `routers/assistant.py:285` - **Snippet:** `message = body.get("message", "").strip() if not message: raise HTTPException(400, "Message is required` - **Проблема:** Ученик может записать в историю чата произвольно длинный текст (мегабайты), раздувая БД и ломая UI истории. - **Как воспроизвести:** POST /assistant/save-analytics с message длиной 10 МБ → запись в chat_history без ограничения. - **Что сделать:** Добавить проверку len(message) <= 5000 (или разумный лимит) перед save_message. - **Confidence:** 0.83 ### 29. tts_cache_path_no_cleanup_unbounded - **Файл:** `routers/tts.py:30` - **Snippet:** `CACHE_DIR = "/root/filwordspl/backend/tts_cache" os.makedirs(CACHE_DIR, exist_ok=True)` - **Проблема:** Кэш mp3-файлов растёт бесконечно — со временем диск переполняется, TTS и весь бэкенд падают. - **Как воспроизвести:** Долгая эксплуатация → тысячи mp3 в /root/filwordspl/backend/tts_cache без eviction. - **Что сделать:** Добавить LRU/TTL-очистку кэша (например, cron или периодический таск), либо ограничить размер директории. - **Confidence:** 0.8 ### 30. rate_limiter_memory_leak_unbounded_keys - **Файл:** `main.py:96` - **Snippet:** `self.requests[key] = [t for t in self.requests[key] if now - t < window]` - **Проблема:** при большом числе уникальных IP:path ключей память процесса растёт, OOM, сервис падает для всех - **Как воспроизвести:** слать запросы с разных IP на разные пути → self.requests растёт быстрее, чем чистится (cleanup раз в 60с) - **Что сделать:** ограничить размер dict (LRU) или чистить агрессивнее; либо перейти на Redis - **Confidence:** 0.8 ### 31. rate_limiter_key_includes_path_but_limits_lookup_by_path - **Файл:** `main.py:88` - **Snippet:** `rate_key = f"{client_ip}:{path}"` - **Проблема:** лимит обходится сменой пути с query-параметрами? нет — но лимит на /game/check-word не срабатывает для /game/check-word/ (trailing slash) и любых вариантов пути - **Как воспроизвести:** POST /game/check-word/ (со слэшем) → лимит default 60 вместо 30 - **Что сделать:** нормализовать path (rstrip '/') перед lookup в self.limits - **Confidence:** 0.78 ### 32. static_uploads_public_no_auth - **Файл:** `main.py:262` - **Snippet:** `app.mount("/uploads", StaticFiles(directory=UPLOADS_DIR), name="uploads")` - **Проблема:** любой может перебрать /uploads/<filename> и скачать картинки feed-постов, включая неопубликованные - **Как воспроизвести:** GET /uploads/abc.jpg без авторизации → 200 OK - **Что сделать:** отдавать через эндпоинт с проверкой is_published, либо хранить вне public-пути - **Confidence:** 0.82 ### 33. health_endpoint_bypasses_rate_limit - **Файл:** `main.py:200` - **Snippet:** `if path in ["/", "/health"]:` - **Проблема:** healthcheck без лимита — можно долбить БД SELECT 1 и положить пул - **Как воспроизвести:** ab -n 10000 /health → пул соединений исчерпан, остальные запросы ждут - **Что сделать:** добавить отдельный лимит для /health или кэшировать результат - **Confidence:** 0.77 ### 34. auth_query_param_initdata_leaks_in_logs - **Файл:** `auth.py:88` - **Snippet:** `init_data = request.query_params.get('initData', '')` - **Проблема:** initData в query-параметре попадает в access-логи nginx/Cloudflare — утечка токена, replay-атака - **Как воспроизвести:** GET /feed/delete?initData=... → в логах nginx полный initData - **Что сделать:** убрать query-fallback, использовать только Authorization header - **Confidence:** 0.85 ### 35. auth_verify_does_not_check_user_id_type - **Файл:** `auth.py:76` - **Snippet:** `user_id = user_data.get('id')` - **Проблема:** если Telegram пришлёт id как строку — user_id уйдёт строкой в SQL, потенциальные проблемы с BIGINT-кастом - **Как воспроизвести:** подделать initData с user.id="123" (если подпись валидна) → asyncpg может кинуть ошибку типа - **Что сделать:** приводить user_id = int(user_data['id']) с try/except - **Confidence:** 0.76 ### 36. auth_hmac_secret_key_order - **Файл:** `auth.py:55` - **Snippet:** `secret_key = hmac.new( 'WebAppData'.encode(), BOT_TOKEN.encode(), hashlib.sha256 ` - **Проблема:** если порядок аргументов неверен — все подписи не проходят, но код работает, значит порядок верный; проверить соответствие документации Telegram - **Как воспроизвести:** сверить с https://core.telegram.org/bots/webapps#validating-data-received-via-the-mini-app - **Что сделать:** по докам: secret_key = HMAC_SHA256(key="WebAppData", msg=bot_token) — здесь верно, но добавить комментарий - **Confidence:** 0.75 ## 🟡 Качество кода (13) ### 37. hints_remaining_no_level_check - **Файл:** `routers/hints.py:175` - **Snippet:** `progress = await conn.fetchrow( "SELECT hints_used FROM user_progress WHERE user_id = $1 AND level_id = $2",` - **Проблема:** Не баг для ученика, но эндпоинт не проверяет существование уровня и пользователя — возвращает 0/3 для несуществующих level_id - **Как воспроизвести:** GET /hints/remaining/999999 → 200 OK с remaining=3 вместо 404 - **Что сделать:** Добавить проверку уровня и пользователя, как в get_first_letter_hint - **Confidence:** 0.8 ### 38. bubblewords_complete_trusts_words_count - **Файл:** `routers/bubblewords.py:178` - **Snippet:** `words_count = body.get("words_count", 3)` - **Проблема:** words_count принимается от клиента, но нигде не используется — мёртвый параметр, вводит в заблуждение - **Как воспроизвести:** POST /bubblewords/complete {words_count: 999} → никак не влияет - **Что сделать:** Удалить параметр или использовать для валидации (сверить с реальным числом слов уровня) - **Confidence:** 0.85 ### 39. admin_update_lesson_n_plus_1_question_check - **Файл:** `routers/admin_content.py:1` - **Snippet:** `q_exists = await conn.fetchval(""" SELECT 1 FROM learning_questions WHERE questi` - **Проблема:** При сохранении урока с 20 вопросами — 20 лишних round-trip к БД, сохранение тормозит - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} с 20 вопросами → 20 отдельных SELECT - **Что сделать:** Один SELECT question_id FROM learning_questions WHERE lesson_id=$1 AND question_id = ANY($2) и сравнение множеств в Python - **Confidence:** 0.85 ### 40. admin_update_lesson_n_plus_1_inserts - **Файл:** `routers/admin_content.py:1` - **Snippet:** `for idx, ex in enumerate(examples, start=1): await conn.execute(""" INSERT INTO less` - **Проблема:** При сохранении урока с примерами и опциями — сотни отдельных INSERT, сохранение может упасть по таймауту - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} с 10 примерами и 20 вопросами × 4 опции → ~90 INSERT - **Что сделать:** Использовать executemany или один INSERT ... VALUES (...), (...), (...) - **Confidence:** 0.8 ### 41. feed_update_removed_images_double_loop - **Файл:** `routers/feed.py:1` - **Snippet:** `removed_images = body.get("removed_images", []) if removed_images and isinstance(removed_images, list): ` - **Проблема:** Дублирование логики парсинга URL и удаления — при расхождении в одной из веток файлы на диске и в БД разойдутся - **Как воспроизвести:** Правка одной из двух веток removed_images → рассинхрон БД и диска - **Что сделать:** Вынести парсинг URL и удаление в отдельную функцию _remove_attachment(conn, post_id, img_url) - **Confidence:** 0.8 ### 42. support_admin_tickets_n_plus_1_subqueries - **Файл:** `routers/support.py:1` - **Snippet:** `(SELECT COUNT(*) FROM support_messages m WHERE m.ticket_id = t.id AND m.is_read = FALSE) as unread_count, ` - **Проблема:** При большом числе тикетов админ-панель тормозит: 2 коррелированных подзапроса на каждую строку - **Как воспроизвести:** GET /support/admin-tickets с 500 тикетами → 1000 подзапросов - **Что сделать:** Использовать LATERAL JOIN или отдельный агрегирующий запрос с GROUP BY ticket_id - **Confidence:** 0.82 ### 43. achievements_conn_held_during_award - **Файл:** `routers/achievements.py:340` - **Snippet:** `async with pool.acquire() as conn: user_lang = await conn.fetchval(` - **Проблема:** Под нагрузкой пул соединений исчерпывается, запросы к достижениям начинают ждать — ученик видит зависание после прохождения уровня. - **Как воспроизвести:** Открыть /achievements/track-* под нагрузкой → соединение удерживается на время всех INSERT-ов в цикле. - **Что сделать:** Вынести чтение user_lang и matching в один acquire, а INSERT-ы делать через executemany или отдельным acquire. - **Confidence:** 0.78 ### 44. achievements_n_plus_1_insert_loop - **Файл:** `routers/achievements.py:360` - **Snippet:** `for ach in matching: await conn.execute( "INSERT INTO user_achievements (user_id, achievemen` - **Проблема:** При первом прохождении уровня с несколькими достижениями ответ приходит медленнее — ученик ждёт всплывашку. - **Как воспроизвести:** Пройти уровень, разблокирующий 3+ достижения → 3+ последовательных INSERT. - **Что сделать:** Заменить цикл на conn.executemany с одним INSERT ... ON CONFLICT DO NOTHING. - **Confidence:** 0.82 ### 45. leaderboard_duplicate_cache_query - **Файл:** `routers/leaderboard.py:55` - **Snippet:** `my_total_in_cache = await conn.fetchval(""" SELECT total_score FROM leaderboard_cache WHERE telegram_id = $1` - **Проблема:** Лишний round-trip к БД на каждый запрос рейтинга — при большом числе игроков страница рейтинга открывается медленнее. - **Как воспроизвести:** Открыть /leaderboard → 2 одинаковых SELECT из leaderboard_cache по telegram_id. - **Что сделать:** Убрать первый fetchval, использовать my_row (уже загружен ниже) для получения my_total_in_cache. - **Confidence:** 0.85 ### 46. tts_sync_file_io_in_async_handler - **Файл:** `routers/tts.py:60` - **Snippet:** `with open(cache_path, 'rb') as f: return Response( content=f.read(),` - **Проблема:** При чтении крупного mp3 синхронный I/O блокирует event loop — другие запросы (в т.ч. игровые) подвисают. - **Как воспроизвести:** Одновременно запросить TTS и игровой эндпоинт → игровой ждёт окончания чтения файла. - **Что сделать:** Использовать aiofiles или FileResponse для отдачи файла из кэша. - **Confidence:** 0.76 ### 47. rate_limiter_cleanup_uses_max_window_not_per_key - **Файл:** `main.py:78` - **Snippet:** `self.requests[key] = [t for t in self.requests[key] if now - t < max_window]` - **Проблема:** не влияет напрямую, но cleanup хранит записи дольше нужного — память - **Как воспроизвести:** лимит с window=60 хранит записи до max_window (60) — ок; но если добавить window=3600, все ключи держат записи час - **Что сделать:** чистить по window конкретного пути, а не по max - **Confidence:** 0.76 ### 48. cors_allow_credentials_false_but_auth_via_header - **Файл:** `main.py:246` - **Snippet:** `allow_credentials=False,` - **Проблема:** не баг сейчас, но если фронт начнёт использовать cookies — auth сломается молча - **Как воспроизвести:** добавить cookie-based auth → preflight отклонит credentials - **Что сделать:** задокументировать или включить allow_credentials=True при переходе на cookies - **Confidence:** 0.75 ### 49. init_db_giant_transaction_blocks_startup - **Файл:** `database.py:22` - **Snippet:** `async with conn.transaction():` - **Проблема:** при рестарте вся инициализация в одной транзакции — долгий lock на information_schema и DDL, при ошибке на середине откат всего - **Как воспроизвести:** рестарт с большой БД → startup занимает десятки секунд, healthcheck 503 - **Что сделать:** разбить на отдельные транзакции по группам таблиц или вынести в миграции (alembic) - **Confidence:** 0.78 --- **Итого:** всего находок=75, overshoot=1, snippet не совпал=0, низкий confidence=1, прошло=49 _Этот Issue создан автоматически. Исправления делаются вручную._
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Drobysh/filwordspl-backend#16