🤖 AI Review (backend): 50 задач (2026-09-25 16:37 UTC) #14

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

🤖 AI Code Review (Backend)

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

📊 По пакам

  • routers_games — 7 файлов, 63,953 символов, находок=10
  • routers_learning — 4 файлов, 99,070 символов, находок=10
  • routers_admin — 4 файлов, 96,370 символов, находок=10
  • routers_misc — 5 файлов, 69,714 символов, находок=10
  • core — 4 файлов, 69,297 символов, находок=10
  • services — 0 файлов, 0 символов, находок=0

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

1. hints_used_never_incremented_on_complete

  • Файл: routers/game.py:232
  • Snippet: hints_used = await conn.fetchval( "SELECT hints_used FROM user_progress WHERE user_id = $1 AND level_id
  • Проблема: Ученик берёт подсказки, но при завершении уровня score всегда 100 — очки завышены, лимит подсказок не влияет на итог
  • Как воспроизвести: взять 3 подсказки → завершить уровень → score = 100 вместо 70
  • Что сделать: Проверить, что hints.py действительно пишет в user_progress.hints_used для того же level_id, и что INSERT в complete_level не перезаписывает hints_used нулём
  • Confidence: 0.75

2. hints_used_never_incremented_actually

  • Файл: routers/hints.py:88
  • Snippet: await conn.execute( "UPDATE user_progress SET hints_used = hints_used + 1 WHERE user_id = $1 AND level_i
  • Проблема: Если строка user_progress не существует, UPDATE затронет 0 строк и hints_used не вырастет — лимит 3 подсказки не работает
  • Как воспроизвести: новый пользователь → взять подсказку → hints_used_total=1 в ответе, но в БД 0
  • Что сделать: Использовать INSERT ... ON CONFLICT (user_id, level_id) DO UPDATE SET hints_used = user_progress.hints_used + 1
  • Confidence: 0.85

3. teacher_resume_ignores_lesson_id

  • Файл: routers/teacher.py:1
  • Snippet: lesson_id = await conn.fetchval(""" SELECT lesson_id FROM learning_lessons WHERE
  • Проблема: при resume берётся первый урок темы, а не тот, что проходил ученик — вопросы не совпадают, прогресс сбивается
  • Как воспроизвести: начать урок 3 темы → закрыть → /teacher/resume → возвращаются вопросы урока 1
  • Что сделать: хранить lesson_id в learning_sessions или брать из user_learning_answers по session_id
  • Confidence: 0.85

4. teacher_diagnostic_test_no_level_filter

  • Файл: routers/teacher.py:1
  • Snippet: SELECT * FROM learning_questions WHERE is_test_question = TRUE ORDER BY RANDOM() LIM
  • Проблема: диагностический тест берёт вопросы всех уровней (A1-C2) — новичок получает C1-вопросы, результат уровня неверный
  • Как воспроизвести: POST /teacher/diagnostic-test у нового пользователя → вопросы уровня C1
  • Что сделать: фильтровать по level_code или брать по 3 вопроса с каждого уровня
  • Confidence: 0.8

5. teacher_answer_options_language_get_on_dict

  • Файл: routers/teacher.py:1
  • Snippet: options_language = question_row.get("options_language") or "pl"
  • Проблема: asyncpg Record не имеет метода .get() — AttributeError → 500 при каждом ответе
  • Как воспроизвести: POST /teacher/answer с любым вопросом → 500 AttributeError: 'Record' object has no attribute 'get'
  • Что сделать: использовать question_row["options_language"] или dict(question_row).get(...)
  • Confidence: 0.95

6. teacher_answer_prompt_get_on_record

  • Файл: routers/teacher.py:1
  • Snippet: prompt_text = question_row.get(f"prompt_{lang}") or question_row.get("prompt_en") or ""
  • Проблема: тот же AttributeError на asyncpg.Record — 500 при неверном ответе
  • Как воспроизвести: POST /teacher/answer с неверным ответом → 500
  • Что сделать: dict(question_row).get(...) или явный доступ по ключу
  • Confidence: 0.95

7. admin_dashboard_active_24h_mixes_login_date_with_timestamps

  • Файл: routers/admin.py:78
  • Snippet: SELECT user_id FROM daily_logins WHERE login_date = CURRENT_DATE
  • Проблема: Админ видит завышенный active_24h: пользователь, зашедший в 00:01, попадает в метрику даже в 23:59, а зашедший вчера в 23:00 — не попадает.
  • Как воспроизвести: зайти в 00:05 → в 23:50 метрика active_24h всё ещё включает этого юзера
  • Что сделать: Заменить на login_at > NOW() - INTERVAL '24 hours' (если есть timestamp) или убрать ветку daily_logins.
  • Confidence: 0.8

8. feed_translate_uses_httpx_without_retry

  • Файл: routers/feed.py:245
  • Snippet: async with httpx.AsyncClient(timeout=90.0) as client: response = await client.post( TOGETHER
  • Проблема: При кратковременном сбое Together AI пост сохраняется с fallback (source_lang для всех языков) — юзеры видят русский текст на всех языках.
  • Как воспроизвести: временно отключить сеть к Together → создать пост → все 4 языка = source
  • Что сделать: Добавить 2-3 retry с backoff; при полном провале — вернуть 502 и не сохранять пост.
  • Confidence: 0.7

9. tts_cache_write_race

  • Файл: routers/tts.py:78
  • Snippet: with open(cache_path, 'wb') as f: f.write(audio_bytes)
  • Проблема: при параллельных запросах одного текста клиент может получить обрезанный mp3 (audio/mpeg битый)
  • Как воспроизвести: два одновременных GET /tts?text=привет → один читает файл, пока другой пишет
  • Что сделать: писать во временный файл и os.replace() атомарно; читать только после replace
  • Confidence: 0.78

10. leaderboard_rank_off_by_one_for_uncached

  • Файл: routers/leaderboard.py:60
  • Snippet: user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot
  • Проблема: новый игрок с 0 очков видит себя на позиции N+1 (после всех, у кого >0), но при равенстве очков с другими нулевыми — место неверное; также не учитывает tie-break
  • Как воспроизвести: новый юзер без записей в кэше → my_rank.rank = COUNT(score>0)+1, хотя реальное место среди всех = COUNT(*)+1
  • Что сделать: считать COUNT(*) + 1 по всей leaderboard_cache (не только >0), либо явно документировать правило
  • Confidence: 0.72

11. leaderboard_rank_achievement_side_effect_on_read

  • Файл: routers/leaderboard.py:175
  • Snippet: if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)
  • Проблема: достижение 'rank_reached' выдаётся при каждом GET /leaderboard, если юзер в топ-3 — даже если он просто открыл экран, а не реально достиг места; при падении рейтинга достижение остаётся
  • Как воспроизвести: юзер в топ-3 → каждый GET /leaderboard вызывает check_and_award_achievements (лишние запросы + неверная семантика)
  • Что сделать: выдавать rank-достижения в фоновом джобе при пересчёте leaderboard_cache, а не в GET-хендлере
  • Confidence: 0.75

12. achievements_check_race_duplicate_award

  • Файл: routers/achievements.py:245
  • Snippet: for ach in matching: await conn.execute( "INSERT INTO user_achievements (user_id, achievemen
  • Проблема: при параллельных запросах (напр. track-login + track-progress) юзер может получить дубликат 'new_achievements' в ответе — фронт покажет всплывашку дважды
  • Как воспроизвести: два одновременных POST /achievements/track-* → оба SELECT'ят matching до INSERT, оба возвращают одно достижение
  • Что сделать: использовать INSERT ... ON CONFLICT DO NOTHING RETURNING id и добавлять в newly_unlocked только реально вставленные строки
  • Confidence: 0.8

13. assistant_history_race_delete

  • Файл: routers/assistant.py:130
  • Snippet: await conn.execute(""" DELETE FROM chat_history WHERE user_id = $1 AND id NOT IN (
  • Проблема: при параллельных сообщениях от одного юзера DELETE может удалить только что вставленное сообщение (гонка между INSERT и DELETE в разных транзакциях)
  • Как воспроизвести: два параллельных POST /assistant/chat → одно из сообщений пропадает из истории
  • Что сделать: обернуть INSERT+DELETE в одну транзакцию (async with conn.transaction()) или использовать advisory lock по user_id
  • Confidence: 0.72

14. leaderboard_matview_no_refresh_on_start

  • Файл: main.py:195
  • Snippet: await asyncio.sleep(10)
  • Проблема: после рестарта первые 10 секунд рейтинг пустой/устаревший, ученик видит неверные места
  • Как воспроизвести: рестарт сервиса → открыть лидерборд в первые 10с
  • Что сделать: сделать первый REFRESH сразу в lifespan до yield, а sleep(300) — только между итерациями
  • Confidence: 0.8

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

15. complete_level_insert_overwrites_hints_used

  • Файл: routers/game.py:245
  • Snippet: """INSERT INTO user_progress (user_id, level_id, completed_at, hints_used, score, level, current_streak)
  • Проблема: Если строка user_progress уже существует (создана hints.py), INSERT упадёт с unique violation — уровень не завершится
  • Как воспроизвести: взять подсказку (создастся user_progress) → завершить уровень → 500
  • Что сделать: Использовать INSERT ... ON CONFLICT (user_id, level_id) DO UPDATE SET completed_at=NOW(), score=$4, current_streak=0
  • Confidence: 0.9

16. wordquiz_check_trusts_client_correct_polish

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

17. wordquiz_check_race_on_streak

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

18. bubblewords_complete_trusts_words_count

  • Файл: routers/bubblewords.py:152
  • Snippet: words_count = body.get("words_count", 3) completion_time = body.get("completion_time")
  • Проблема: words_count от клиента не используется в логике, но completion_time тоже от клиента — можно подделать ачивку bubble_speed
  • Как воспроизвести: POST /bubblewords/complete {completion_time: 1} → bubble_speed ачивка
  • Что сделать: Замерять время на сервере (сохранять start_time при /next и считать разницу)
  • Confidence: 0.75

19. sentences_check_trusts_completion_time

  • Файл: routers/sentences.py:175
  • Snippet: if completion_time is not None and completion_time < 3: return { "correct": False,
  • Проблема: completion_time от клиента — можно подделать speed_sentence ачивку, отправив любое число > 3
  • Как воспроизвести: POST /sentences/check {completion_time: 4} → speed_sentence
  • Что сделать: Замерять время на сервере: сохранять timestamp при /next, вычислять разницу при /check
  • Confidence: 0.8

20. typing_check_no_anti_cheat

  • Файл: routers/typing.py:62
  • Snippet: sentence_id = body.get("sentence_id") user_text = body.get("text", "")
  • Проблема: Нет проверки времени и нет лимита попыток — можно брутфорсить или копировать ответ из /hint
  • Как воспроизвести: GET /typing/hint/{id} → POST /typing/check с тем же текстом → correct=true
  • Что сделать: Проверять, что hint не использован для этого sentence_id, и добавить минимальное время
  • Confidence: 0.75

21. teacher_answer_missing_session_owner_check

  • Файл: routers/teacher.py:1
  • Snippet: session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id) if not session:
  • Проблема: чужой пользователь может записать ответы в чужую сессию, испортив прогресс и статистику жертвы
  • Как воспроизвести: POST /teacher/answer с session_id другой сессии — ответ сохраняется, владелец не проверяется
  • Что сделать: SELECT ... WHERE id = $1 AND user_id = $2 и 403 при несовпадении (как в learning.py save_answer)
  • Confidence: 0.9

22. teacher_answer_saves_before_session_check

  • Файл: routers/teacher.py:1
  • Snippet: await save_answer_to_session( conn, telegram_id, session_id, question_data, selected_answer, is_
  • Проблема: ответ пишется в БД до проверки существования/владельца сессии — мусорные записи и FK-ошибки
  • Как воспроизвести: POST /teacher/answer с несуществующим session_id → INSERT в user_learning_answers до 404
  • Что сделать: сначала fetchrow сессии с проверкой user_id, потом save_answer_to_session
  • Confidence: 0.85

23. teacher_ai_limit_race_condition

  • Файл: routers/teacher.py:1
  • Snippet: if not await check_ai_limit(conn, telegram_id): return { "response": "", "li
  • Проблема: параллельные запросы обходят дневной лимит AI (check и increment в разных транзакциях)
  • Как воспроизвести: отправить 10 параллельных POST /teacher/explain — все пройдут проверку до инкремента
  • Что сделать: атомарный UPSERT с проверкой count < limit в одном запросе, либо SELECT FOR UPDATE
  • Confidence: 0.8

24. teacher_phrase_of_day_race

  • Файл: routers/teacher.py:1
  • Snippet: if not today_phrase: # Список тем для фразы дня
  • Проблема: при параллельных запросах несколько пользователей одновременно генерируют фразу дня — лишние вызовы AI и гонка на INSERT
  • Как воспроизвести: два запроса /teacher/phrase-of-day в один момент при пустой таблице
  • Что сделать: использовать advisory lock или INSERT ... ON CONFLICT DO NOTHING с последующим SELECT
  • Confidence: 0.75

25. admin_content_update_word_updates_all_levels_by_word_pl

  • Файл: routers/admin_content.py:305
  • Snippet: WHERE level = $5 AND word_pl = $6 """, word_pl, translation_ru, translation_uk, translation_en, level, old_word_
  • Проблема: Если в одном уровне есть два разных слова с одинаковым word_pl (например, омограф), правка одного перезапишет оба — ученик увидит неверный перевод в игре.
  • Как воспроизвести: создать два слова 'bank' в A1 → отредактировать одно → оба получат новый перевод
  • Что сделать: Обновлять по id, а привязки к игровым уровням — отдельным UPDATE по (level, old_word_pl) с явным списком id.
  • Confidence: 0.75

26. feed_upload_image_no_magic_bytes_check

  • Файл: routers/feed.py:640
  • Snippet: content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:
  • Проблема: Админ может загрузить .php/.html под видом image/jpeg — файл ляжет в /uploads/feed/ и при определённой конфигурации nginx может исполниться.
  • Как воспроизвести: curl -F 'file=@shell.php;type=image/jpeg' /admin/feed/upload-image → файл сохранён как .jpg, но содержимое — PHP
  • Что сделать: Проверять magic bytes (imghdr/Pillow) и/или отдавать /uploads через nginx с Content-Disposition: attachment.
  • Confidence: 0.8

27. tts_no_rate_limit

  • Файл: routers/tts.py:34
  • Snippet: async def text_to_speech(request: Request, text: str = "", voice: str = "male"):
  • Проблема: любой авторизованный юзер может залить диск сервера уникальными текстами (500 символов × бесконечные запросы) — сервис ляжет для всех
  • Как воспроизвести: цикл GET /tts?text= → tts_cache заполняется, диск переполняется
  • Что сделать: добавить rate-limit (per-user, напр. 30/мин) и/или LRU-очистку кэша по размеру/возрасту
  • Confidence: 0.82

28. rate_limit_path_mismatch

  • Файл: main.py:130
  • Snippet: limit_config = self.limits.get(path, self.limits["default"])
  • Проблема: лимиты на дорогие AI-эндпоинты (assistant/chat, learning/analytics, tts) не применяются, если путь не совпадает точно — например, с trailing slash или префиксом
  • Как воспроизвести: POST /assistant/chat/ (со слэшем) → попадает в default 60/мин вместо 20/мин
  • Что сделать: нормализовать path (rstrip('/')) или матчить по префиксу/роуту, а не по точной строке
  • Confidence: 0.75

29. rate_limit_key_per_path

  • Файл: main.py:175
  • Snippet: rate_key = f"{client_ip}:{path}"
  • Проблема: атакующий обходит лимит, меняя путь (например /assistant/chat?x=1 vs /assistant/chat), либо забивает память уникальными путями
  • Как воспроизвести: GET /leaderboard?a=1, /leaderboard?a=2, ... — каждый уникальный path = отдельный bucket
  • Что сделать: использовать нормализованный route.path (request.scope['route'].path) вместо raw path
  • Confidence: 0.8

30. rate_limiter_memory_unbounded

  • Файл: main.py:100
  • Snippet: self.requests = defaultdict(list)
  • Проблема: при сканировании с уникальными IP/path словарь растёт до OOM, сервис падает для всех
  • Как воспроизвести: ботнет с 100k IP бьёт по /health-подобным путям → память растёт, cleanup раз в 60с не успевает
  • Что сделать: ограничить размер словаря (LRU) или перейти на Redis; чистить по last_seen, а не только по окну
  • Confidence: 0.72

31. cf_ips_missing_v6_2400_cb00

  • Файл: config.py:47
  • Snippet: "2400:cb00::/32", "2606:4700::/32", "2803:f800::/32",
  • Проблема: если реальный IP клиента — Cloudflare IPv6 из неполного списка, cf-connecting-ip игнорируется, все клиенты за этим edge получают один rate-limit bucket
  • Как воспроизвести: запрос через Cloudflare IPv6 → _is_cloudflare_ip=False → client_ip=edge IP → лимит общий на всех
  • Что сделать: обновлять CF_IPS из https://www.cloudflare.com/ips-v6 автоматически или периодически
  • Confidence: 0.7

32. auth_query_param_initdata_leak

  • Файл: auth.py:108
  • Snippet: init_data = request.query_params.get('initData', '')
  • Проблема: initData (содержит подпись и user_id) попадает в access-логи Cloudflare/nginx и в Referer — возможен replay в течение 4 часов
  • Как воспроизвести: DELETE /feed/post?initData=... → строка с токеном в логах прокси
  • Что сделать: убрать query-параметр, использовать только Authorization: tma; для deleteFeedPost — POST с телом
  • Confidence: 0.85

33. auth_no_replay_protection

  • Файл: auth.py:30
  • Snippet: if current_time - auth_date > MAX_INITDATA_AGE:
  • Проблема: перехваченный initData можно переиспользовать 4 часа для любых действий от имени пользователя
  • Как воспроизвести: перехватить initData из логов → 4 часа выполнять запросы
  • Что сделать: хранить использованные hash в Redis/таблице с TTL, отклонять повторные; либо привязать к сессии
  • Confidence: 0.75

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

34. bubblewords_split_word_uses_random_in_loop

  • Файл: routers/bubblewords.py:20
  • Snippet: while attempts < max_attempts: parts = [] i = 0
  • Проблема: При большом количестве слов на уровне разбиение может не найтись за 50 попыток и уйти в fallback с суффиксами — пузыри выглядят как 'k.a1b2.0'
  • Как воспроизвести: уровень с 8 словами, где много коротких — forbidden_parts быстро заполняется
  • Что сделать: Увеличить max_attempts или использовать детерминированный алгоритм разбиения с проверкой конфликтов
  • Confidence: 0.7

35. pronunciation_no_progress_tracking

  • Файл: routers/pronunciation.py:30
  • Snippet: word = await conn.fetchrow(""" SELECT word_pl, translation_ru, translation_uk, translation_en, level
  • Проблема: Слова выдаются полностью случайно без учёта прогресса — ученик может получать одни и те же слова, нет статистики
  • Как воспроизвести: многократный вызов /pronunciation/next → повторы слов
  • Что сделать: Добавить таблицу pronunciation_progress и исключать пройденные слова, как в wordquiz
  • Confidence: 0.7

36. teacher_answer_ai_explanation_outside_conn

  • Файл: routers/teacher.py:1
  • Snippet: explanation_text = db_explanation if needs_ai_explanation: explanation_text = await get_wrong_answer_ai_expl
  • Проблема: AI-вызов идёт после закрытия соединения — при ошибке AI ответ теряет explanation, но это не критично
  • Как воспроизвести: неверный ответ без wrong_because → AI-вызов вне транзакции
  • Что сделать: вынести AI-вызов до закрытия conn или явно документировать, что это осознанно
  • Confidence: 0.7

37. teacher_phrase_of_day_import_random_inline

  • Файл: routers/teacher.py:1
  • Snippet: import random selected_topic = random.choice(topics_list)
  • Проблема: импорт внутри функции — стилистический запах, не влияет на ученика
  • Как воспроизвести: чтение кода
  • Что сделать: перенести import random в шапку модуля
  • Confidence: 0.9

38. admin_dashboard_online_now_uses_old_metric

  • Файл: routers/admin.py:55
  • Snippet: # daily_logins оставляем только если login_date = CURRENT_DATE И # есть свежая активность. Проще — убрать ветку
  • Проблема: Админ видит устаревший комментарий-размышление вместо кода; риск, что следующий разработчик вернёт daily_logins в online_now и метрика снова станет бесполезной.
  • Как воспроизвести: открыть routers/admin.py → прочитать комментарий над online_now
  • Что сделать: Удалить комментарий-размышление, оставить только итоговое решение.
  • Confidence: 0.75

39. admin_content_words_levels_n_plus_1

  • Файл: routers/admin_content.py:168
  • Snippet: count = await conn.fetchval( "SELECT COUNT(*) FROM level_words WHERE level = $1 AND level_id IS NULL", c
  • Проблема: Дашборд слов грузится медленнее (2 запроса × 6 уровней = 12 round-trip), при росте числа уровней деградация растёт.
  • Как воспроизвести: GET /admin/content/words/levels → в логах 12 SQL-запросов
  • Что сделать: Один GROUP BY level с COUNT(*) и MAX(edited_at), как уже сделано в /texts/levels.
  • Confidence: 0.9

40. admin_content_update_lesson_question_belongs_check_inside_loop

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

41. admin_content_update_lesson_options_insert_loop

  • Файл: routers/admin_content.py:758
  • Snippet: for o in q["options"]: await conn.execute(""" INSERT INTO question_options
  • Проблема: Сохранение урока с 20 вопросами × 4 опции = 80 отдельных INSERT — медленно, риск таймаута на слабой сети.
  • Как воспроизвести: PUT /admin/content/lessons/lesson/{id} → в логах 80 INSERT подряд
  • Что сделать: Использовать executemany или один INSERT ... VALUES (...), (...), ... через unnest.
  • Confidence: 0.85

42. admin_content_update_lesson_examples_insert_loop

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

43. support_admin_tickets_correlated_subqueries

  • Файл: routers/support.py:195
  • 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 при 1000 тикетов → 2000 подзапросов
  • Что сделать: LEFT JOIN LATERAL или отдельные агрегаты через GROUP BY + DISTINCT ON.
  • Confidence: 0.8

44. tts_path_traversal_via_cache_dir

  • Файл: routers/tts.py:22
  • Snippet: CACHE_DIR = "/root/filwordspl/backend/tts_cache"
  • Проблема: при деплое в другом окружении (Docker, другой пользователь) сервис падает на старте — озвучка недоступна
  • Как воспроизвести: запустить backend не из /root/filwordspl → os.makedirs падает с PermissionError
  • Что сделать: вынести путь в config/env (TTS_CACHE_DIR), дефолт — относительный путь или tempfile.gettempdir()
  • Confidence: 0.85

45. leaderboard_duplicate_cache_query

  • Файл: routers/leaderboard.py:68
  • Snippet: my_row = await conn.fetchrow(""" SELECT * FROM leaderboard_cache WHERE telegram_id = $1 """, telegra
  • Проблема: лишний round-trip к БД на каждый запрос лидерборда — медленнее отклик главного экрана
  • Как воспроизвести: GET /leaderboard → 2 запроса к leaderboard_cache по одному telegram_id (my_total_in_cache и my_row)
  • Что сделать: объединить: один SELECT * FROM leaderboard_cache WHERE telegram_id=$1 и использовать его и для total_score, и для остальных полей
  • Confidence: 0.9

46. achievements_get_all_no_pagination

  • Файл: routers/achievements.py:200
  • Snippet: rows = await conn.fetch("SELECT * FROM achievements ORDER BY id")
  • Проблема: SELECT * тянет все колонки (включая description_* на 4 языках) — лишний трафик, но пока 52 строки терпимо
  • Как воспроизвести: GET /achievements → возвращает все поля всех достижений
  • Что сделать: выбирать только нужные колонки (code, icon, name_, description_) или отдавать по языку
  • Confidence: 0.7

47. assistant_remaining_extra_query

  • Файл: routers/assistant.py:245
  • Snippet: remaining = FREE_DAILY_LIMIT if is_admin else max(0, FREE_DAILY_LIMIT - await get_daily_usage(telegram_id))
  • Проблема: лишний SELECT chat_usage после каждого успешного ответа AI — увеличивает latency ответа
  • Как воспроизвести: POST /assistant/chat → после increment_daily_usage ещё один SELECT для remaining
  • Что сделать: increment_daily_usage возвращать новое значение через RETURNING message_count и использовать его
  • Confidence: 0.85

48. auth_http_exception_in_verify

  • Файл: auth.py:20
  • Snippet: raise HTTPException(401, "Hash not found in initData")
  • Проблема: verify_telegram_initdata смешивает валидацию и HTTP-слой — сложно переиспользовать и тестировать
  • Как воспроизвести: юнит-тест verify_telegram_initdata требует FastAPI-контекста
  • Что сделать: возвращать (ok, reason) или кидать доменное исключение, HTTPException — только в require_auth
  • Confidence: 0.72

49. init_db_giant_transaction

  • Файл: database.py:20
  • Snippet: async with conn.transaction():
  • Проблема: вся инициализация схемы в одной транзакции — долгий lock на information_schema/pg_constraint, при рестарте возможны таймауты и блокировки
  • Как воспроизвести: рестарт при активных запросах → ALTER TABLE ждёт lock, транзакция висит
  • Что сделать: разбить на отдельные транзакции по таблицам; миграции вынести в Alembic
  • Confidence: 0.7

50. init_db_auto_migrations_in_prod

  • Файл: database.py:60
  • Snippet: ALTER TABLE users ADD COLUMN current_level TEXT DEFAULT 'A1'
  • Проблема: авто-миграции в рантайме на каждом старте — риск рассинхрона схемы между окружениями и неожиданных ALTER на проде
  • Как воспроизвести: изменить определение таблицы в коде → на проде применится ALTER без ревью
  • Что сделать: перейти на Alembic/Flyway; init_db оставить только для CREATE IF NOT EXISTS
  • Confidence: 0.78

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

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

# 🤖 AI Code Review (Backend) **Дата:** 2026-09-25 16:37 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` ## 📊 По пакам - **routers_games** — 7 файлов, 63,953 символов, находок=10 - **routers_learning** — 4 файлов, 99,070 символов, находок=10 - **routers_admin** — 4 файлов, 96,370 символов, находок=10 - **routers_misc** — 5 файлов, 69,714 символов, находок=10 - **core** — 4 файлов, 69,297 символов, находок=10 - **services** — 0 файлов, 0 символов, находок=0 --- ## 🔴 Влияет на ученика (14) ### 1. hints_used_never_incremented_on_complete - **Файл:** `routers/game.py:232` - **Snippet:** `hints_used = await conn.fetchval( "SELECT hints_used FROM user_progress WHERE user_id = $1 AND level_id ` - **Проблема:** Ученик берёт подсказки, но при завершении уровня score всегда 100 — очки завышены, лимит подсказок не влияет на итог - **Как воспроизвести:** взять 3 подсказки → завершить уровень → score = 100 вместо 70 - **Что сделать:** Проверить, что hints.py действительно пишет в user_progress.hints_used для того же level_id, и что INSERT в complete_level не перезаписывает hints_used нулём - **Confidence:** 0.75 ### 2. hints_used_never_incremented_actually - **Файл:** `routers/hints.py:88` - **Snippet:** `await conn.execute( "UPDATE user_progress SET hints_used = hints_used + 1 WHERE user_id = $1 AND level_i` - **Проблема:** Если строка user_progress не существует, UPDATE затронет 0 строк и hints_used не вырастет — лимит 3 подсказки не работает - **Как воспроизвести:** новый пользователь → взять подсказку → hints_used_total=1 в ответе, но в БД 0 - **Что сделать:** Использовать INSERT ... ON CONFLICT (user_id, level_id) DO UPDATE SET hints_used = user_progress.hints_used + 1 - **Confidence:** 0.85 ### 3. teacher_resume_ignores_lesson_id - **Файл:** `routers/teacher.py:1` - **Snippet:** `lesson_id = await conn.fetchval(""" SELECT lesson_id FROM learning_lessons WHERE` - **Проблема:** при resume берётся первый урок темы, а не тот, что проходил ученик — вопросы не совпадают, прогресс сбивается - **Как воспроизвести:** начать урок 3 темы → закрыть → /teacher/resume → возвращаются вопросы урока 1 - **Что сделать:** хранить lesson_id в learning_sessions или брать из user_learning_answers по session_id - **Confidence:** 0.85 ### 4. teacher_diagnostic_test_no_level_filter - **Файл:** `routers/teacher.py:1` - **Snippet:** `SELECT * FROM learning_questions WHERE is_test_question = TRUE ORDER BY RANDOM() LIM` - **Проблема:** диагностический тест берёт вопросы всех уровней (A1-C2) — новичок получает C1-вопросы, результат уровня неверный - **Как воспроизвести:** POST /teacher/diagnostic-test у нового пользователя → вопросы уровня C1 - **Что сделать:** фильтровать по level_code или брать по 3 вопроса с каждого уровня - **Confidence:** 0.8 ### 5. teacher_answer_options_language_get_on_dict - **Файл:** `routers/teacher.py:1` - **Snippet:** `options_language = question_row.get("options_language") or "pl"` - **Проблема:** asyncpg Record не имеет метода .get() — AttributeError → 500 при каждом ответе - **Как воспроизвести:** POST /teacher/answer с любым вопросом → 500 AttributeError: 'Record' object has no attribute 'get' - **Что сделать:** использовать question_row["options_language"] или dict(question_row).get(...) - **Confidence:** 0.95 ### 6. teacher_answer_prompt_get_on_record - **Файл:** `routers/teacher.py:1` - **Snippet:** `prompt_text = question_row.get(f"prompt_{lang}") or question_row.get("prompt_en") or ""` - **Проблема:** тот же AttributeError на asyncpg.Record — 500 при неверном ответе - **Как воспроизвести:** POST /teacher/answer с неверным ответом → 500 - **Что сделать:** dict(question_row).get(...) или явный доступ по ключу - **Confidence:** 0.95 ### 7. admin_dashboard_active_24h_mixes_login_date_with_timestamps - **Файл:** `routers/admin.py:78` - **Snippet:** `SELECT user_id FROM daily_logins WHERE login_date = CURRENT_DATE` - **Проблема:** Админ видит завышенный active_24h: пользователь, зашедший в 00:01, попадает в метрику даже в 23:59, а зашедший вчера в 23:00 — не попадает. - **Как воспроизвести:** зайти в 00:05 → в 23:50 метрика active_24h всё ещё включает этого юзера - **Что сделать:** Заменить на login_at > NOW() - INTERVAL '24 hours' (если есть timestamp) или убрать ветку daily_logins. - **Confidence:** 0.8 ### 8. feed_translate_uses_httpx_without_retry - **Файл:** `routers/feed.py:245` - **Snippet:** `async with httpx.AsyncClient(timeout=90.0) as client: response = await client.post( TOGETHER` - **Проблема:** При кратковременном сбое Together AI пост сохраняется с fallback (source_lang для всех языков) — юзеры видят русский текст на всех языках. - **Как воспроизвести:** временно отключить сеть к Together → создать пост → все 4 языка = source - **Что сделать:** Добавить 2-3 retry с backoff; при полном провале — вернуть 502 и не сохранять пост. - **Confidence:** 0.7 ### 9. tts_cache_write_race - **Файл:** `routers/tts.py:78` - **Snippet:** `with open(cache_path, 'wb') as f: f.write(audio_bytes)` - **Проблема:** при параллельных запросах одного текста клиент может получить обрезанный mp3 (audio/mpeg битый) - **Как воспроизвести:** два одновременных GET /tts?text=привет → один читает файл, пока другой пишет - **Что сделать:** писать во временный файл и os.replace() атомарно; читать только после replace - **Confidence:** 0.78 ### 10. leaderboard_rank_off_by_one_for_uncached - **Файл:** `routers/leaderboard.py:60` - **Snippet:** `user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot` - **Проблема:** новый игрок с 0 очков видит себя на позиции N+1 (после всех, у кого >0), но при равенстве очков с другими нулевыми — место неверное; также не учитывает tie-break - **Как воспроизвести:** новый юзер без записей в кэше → my_rank.rank = COUNT(score>0)+1, хотя реальное место среди всех = COUNT(*)+1 - **Что сделать:** считать COUNT(*) + 1 по всей leaderboard_cache (не только >0), либо явно документировать правило - **Confidence:** 0.72 ### 11. leaderboard_rank_achievement_side_effect_on_read - **Файл:** `routers/leaderboard.py:175` - **Snippet:** `if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)` - **Проблема:** достижение 'rank_reached' выдаётся при каждом GET /leaderboard, если юзер в топ-3 — даже если он просто открыл экран, а не реально достиг места; при падении рейтинга достижение остаётся - **Как воспроизвести:** юзер в топ-3 → каждый GET /leaderboard вызывает check_and_award_achievements (лишние запросы + неверная семантика) - **Что сделать:** выдавать rank-достижения в фоновом джобе при пересчёте leaderboard_cache, а не в GET-хендлере - **Confidence:** 0.75 ### 12. achievements_check_race_duplicate_award - **Файл:** `routers/achievements.py:245` - **Snippet:** `for ach in matching: await conn.execute( "INSERT INTO user_achievements (user_id, achievemen` - **Проблема:** при параллельных запросах (напр. track-login + track-progress) юзер может получить дубликат 'new_achievements' в ответе — фронт покажет всплывашку дважды - **Как воспроизвести:** два одновременных POST /achievements/track-* → оба SELECT'ят matching до INSERT, оба возвращают одно достижение - **Что сделать:** использовать INSERT ... ON CONFLICT DO NOTHING RETURNING id и добавлять в newly_unlocked только реально вставленные строки - **Confidence:** 0.8 ### 13. assistant_history_race_delete - **Файл:** `routers/assistant.py:130` - **Snippet:** `await conn.execute(""" DELETE FROM chat_history WHERE user_id = $1 AND id NOT IN (` - **Проблема:** при параллельных сообщениях от одного юзера DELETE может удалить только что вставленное сообщение (гонка между INSERT и DELETE в разных транзакциях) - **Как воспроизвести:** два параллельных POST /assistant/chat → одно из сообщений пропадает из истории - **Что сделать:** обернуть INSERT+DELETE в одну транзакцию (async with conn.transaction()) или использовать advisory lock по user_id - **Confidence:** 0.72 ### 14. leaderboard_matview_no_refresh_on_start - **Файл:** `main.py:195` - **Snippet:** `await asyncio.sleep(10)` - **Проблема:** после рестарта первые 10 секунд рейтинг пустой/устаревший, ученик видит неверные места - **Как воспроизвести:** рестарт сервиса → открыть лидерборд в первые 10с - **Что сделать:** сделать первый REFRESH сразу в lifespan до yield, а sleep(300) — только между итерациями - **Confidence:** 0.8 ## 🟠 Риск для данных (19) ### 15. complete_level_insert_overwrites_hints_used - **Файл:** `routers/game.py:245` - **Snippet:** `"""INSERT INTO user_progress (user_id, level_id, completed_at, hints_used, score, level, current_streak) ` - **Проблема:** Если строка user_progress уже существует (создана hints.py), INSERT упадёт с unique violation — уровень не завершится - **Как воспроизвести:** взять подсказку (создастся user_progress) → завершить уровень → 500 - **Что сделать:** Использовать INSERT ... ON CONFLICT (user_id, level_id) DO UPDATE SET completed_at=NOW(), score=$4, current_streak=0 - **Confidence:** 0.9 ### 16. wordquiz_check_trusts_client_correct_polish - **Файл:** `routers/wordquiz.py:130` - **Snippet:** `correct_polish = body.get("correct_polish", "") user_answer = body.get("answer", "")` - **Проблема:** Клиент присылает correct_polish сам — можно подделать ответ и получать очки/ачивки без реального знания - **Как воспроизвести:** POST /wordquiz/check {correct_polish:'kot', answer:'kot'} → correct=true, +score - **Что сделать:** Хранить правильный ответ на сервере (в word_quiz_progress или отдельной таблице сессии) и сверять с ним - **Confidence:** 0.95 ### 17. wordquiz_check_race_on_streak - **Файл:** `routers/wordquiz.py:155` - **Snippet:** `current_streak = await conn.fetchval( "SELECT correct_streak FROM word_quiz_progress WHERE user_id = $1", ` - **Проблема:** Параллельные запросы читают одинаковый streak и перезаписывают друг друга — очки/серии теряются - **Как воспроизвести:** два одновременных POST /wordquiz/check → streak увеличится на 1 вместо 2 - **Что сделать:** Использовать атомарный UPDATE ... SET correct_streak = correct_streak + 1 RETURNING correct_streak - **Confidence:** 0.8 ### 18. bubblewords_complete_trusts_words_count - **Файл:** `routers/bubblewords.py:152` - **Snippet:** `words_count = body.get("words_count", 3) completion_time = body.get("completion_time")` - **Проблема:** words_count от клиента не используется в логике, но completion_time тоже от клиента — можно подделать ачивку bubble_speed - **Как воспроизвести:** POST /bubblewords/complete {completion_time: 1} → bubble_speed ачивка - **Что сделать:** Замерять время на сервере (сохранять start_time при /next и считать разницу) - **Confidence:** 0.75 ### 19. sentences_check_trusts_completion_time - **Файл:** `routers/sentences.py:175` - **Snippet:** `if completion_time is not None and completion_time < 3: return { "correct": False,` - **Проблема:** completion_time от клиента — можно подделать speed_sentence ачивку, отправив любое число > 3 - **Как воспроизвести:** POST /sentences/check {completion_time: 4} → speed_sentence - **Что сделать:** Замерять время на сервере: сохранять timestamp при /next, вычислять разницу при /check - **Confidence:** 0.8 ### 20. typing_check_no_anti_cheat - **Файл:** `routers/typing.py:62` - **Snippet:** `sentence_id = body.get("sentence_id") user_text = body.get("text", "")` - **Проблема:** Нет проверки времени и нет лимита попыток — можно брутфорсить или копировать ответ из /hint - **Как воспроизвести:** GET /typing/hint/{id} → POST /typing/check с тем же текстом → correct=true - **Что сделать:** Проверять, что hint не использован для этого sentence_id, и добавить минимальное время - **Confidence:** 0.75 ### 21. teacher_answer_missing_session_owner_check - **Файл:** `routers/teacher.py:1` - **Snippet:** `session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id) if not session: ` - **Проблема:** чужой пользователь может записать ответы в чужую сессию, испортив прогресс и статистику жертвы - **Как воспроизвести:** POST /teacher/answer с session_id другой сессии — ответ сохраняется, владелец не проверяется - **Что сделать:** SELECT ... WHERE id = $1 AND user_id = $2 и 403 при несовпадении (как в learning.py save_answer) - **Confidence:** 0.9 ### 22. teacher_answer_saves_before_session_check - **Файл:** `routers/teacher.py:1` - **Snippet:** `await save_answer_to_session( conn, telegram_id, session_id, question_data, selected_answer, is_` - **Проблема:** ответ пишется в БД до проверки существования/владельца сессии — мусорные записи и FK-ошибки - **Как воспроизвести:** POST /teacher/answer с несуществующим session_id → INSERT в user_learning_answers до 404 - **Что сделать:** сначала fetchrow сессии с проверкой user_id, потом save_answer_to_session - **Confidence:** 0.85 ### 23. teacher_ai_limit_race_condition - **Файл:** `routers/teacher.py:1` - **Snippet:** `if not await check_ai_limit(conn, telegram_id): return { "response": "", "li` - **Проблема:** параллельные запросы обходят дневной лимит AI (check и increment в разных транзакциях) - **Как воспроизвести:** отправить 10 параллельных POST /teacher/explain — все пройдут проверку до инкремента - **Что сделать:** атомарный UPSERT с проверкой count < limit в одном запросе, либо SELECT FOR UPDATE - **Confidence:** 0.8 ### 24. teacher_phrase_of_day_race - **Файл:** `routers/teacher.py:1` - **Snippet:** `if not today_phrase: # Список тем для фразы дня` - **Проблема:** при параллельных запросах несколько пользователей одновременно генерируют фразу дня — лишние вызовы AI и гонка на INSERT - **Как воспроизвести:** два запроса /teacher/phrase-of-day в один момент при пустой таблице - **Что сделать:** использовать advisory lock или INSERT ... ON CONFLICT DO NOTHING с последующим SELECT - **Confidence:** 0.75 ### 25. admin_content_update_word_updates_all_levels_by_word_pl - **Файл:** `routers/admin_content.py:305` - **Snippet:** `WHERE level = $5 AND word_pl = $6 """, word_pl, translation_ru, translation_uk, translation_en, level, old_word_` - **Проблема:** Если в одном уровне есть два разных слова с одинаковым word_pl (например, омограф), правка одного перезапишет оба — ученик увидит неверный перевод в игре. - **Как воспроизвести:** создать два слова 'bank' в A1 → отредактировать одно → оба получат новый перевод - **Что сделать:** Обновлять по id, а привязки к игровым уровням — отдельным UPDATE по (level, old_word_pl) с явным списком id. - **Confidence:** 0.75 ### 26. feed_upload_image_no_magic_bytes_check - **Файл:** `routers/feed.py:640` - **Snippet:** `content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:` - **Проблема:** Админ может загрузить .php/.html под видом image/jpeg — файл ляжет в /uploads/feed/ и при определённой конфигурации nginx может исполниться. - **Как воспроизвести:** curl -F 'file=@shell.php;type=image/jpeg' /admin/feed/upload-image → файл сохранён как .jpg, но содержимое — PHP - **Что сделать:** Проверять magic bytes (imghdr/Pillow) и/или отдавать /uploads через nginx с Content-Disposition: attachment. - **Confidence:** 0.8 ### 27. tts_no_rate_limit - **Файл:** `routers/tts.py:34` - **Snippet:** `async def text_to_speech(request: Request, text: str = "", voice: str = "male"):` - **Проблема:** любой авторизованный юзер может залить диск сервера уникальными текстами (500 символов × бесконечные запросы) — сервис ляжет для всех - **Как воспроизвести:** цикл GET /tts?text=<random> → tts_cache заполняется, диск переполняется - **Что сделать:** добавить rate-limit (per-user, напр. 30/мин) и/или LRU-очистку кэша по размеру/возрасту - **Confidence:** 0.82 ### 28. rate_limit_path_mismatch - **Файл:** `main.py:130` - **Snippet:** `limit_config = self.limits.get(path, self.limits["default"])` - **Проблема:** лимиты на дорогие AI-эндпоинты (assistant/chat, learning/analytics, tts) не применяются, если путь не совпадает точно — например, с trailing slash или префиксом - **Как воспроизвести:** POST /assistant/chat/ (со слэшем) → попадает в default 60/мин вместо 20/мин - **Что сделать:** нормализовать path (rstrip('/')) или матчить по префиксу/роуту, а не по точной строке - **Confidence:** 0.75 ### 29. rate_limit_key_per_path - **Файл:** `main.py:175` - **Snippet:** `rate_key = f"{client_ip}:{path}"` - **Проблема:** атакующий обходит лимит, меняя путь (например /assistant/chat?x=1 vs /assistant/chat), либо забивает память уникальными путями - **Как воспроизвести:** GET /leaderboard?a=1, /leaderboard?a=2, ... — каждый уникальный path = отдельный bucket - **Что сделать:** использовать нормализованный route.path (request.scope['route'].path) вместо raw path - **Confidence:** 0.8 ### 30. rate_limiter_memory_unbounded - **Файл:** `main.py:100` - **Snippet:** `self.requests = defaultdict(list)` - **Проблема:** при сканировании с уникальными IP/path словарь растёт до OOM, сервис падает для всех - **Как воспроизвести:** ботнет с 100k IP бьёт по /health-подобным путям → память растёт, cleanup раз в 60с не успевает - **Что сделать:** ограничить размер словаря (LRU) или перейти на Redis; чистить по last_seen, а не только по окну - **Confidence:** 0.72 ### 31. cf_ips_missing_v6_2400_cb00 - **Файл:** `config.py:47` - **Snippet:** `"2400:cb00::/32", "2606:4700::/32", "2803:f800::/32",` - **Проблема:** если реальный IP клиента — Cloudflare IPv6 из неполного списка, cf-connecting-ip игнорируется, все клиенты за этим edge получают один rate-limit bucket - **Как воспроизвести:** запрос через Cloudflare IPv6 → _is_cloudflare_ip=False → client_ip=edge IP → лимит общий на всех - **Что сделать:** обновлять CF_IPS из https://www.cloudflare.com/ips-v6 автоматически или периодически - **Confidence:** 0.7 ### 32. auth_query_param_initdata_leak - **Файл:** `auth.py:108` - **Snippet:** `init_data = request.query_params.get('initData', '')` - **Проблема:** initData (содержит подпись и user_id) попадает в access-логи Cloudflare/nginx и в Referer — возможен replay в течение 4 часов - **Как воспроизвести:** DELETE /feed/post?initData=... → строка с токеном в логах прокси - **Что сделать:** убрать query-параметр, использовать только Authorization: tma; для deleteFeedPost — POST с телом - **Confidence:** 0.85 ### 33. auth_no_replay_protection - **Файл:** `auth.py:30` - **Snippet:** `if current_time - auth_date > MAX_INITDATA_AGE:` - **Проблема:** перехваченный initData можно переиспользовать 4 часа для любых действий от имени пользователя - **Как воспроизвести:** перехватить initData из логов → 4 часа выполнять запросы - **Что сделать:** хранить использованные hash в Redis/таблице с TTL, отклонять повторные; либо привязать к сессии - **Confidence:** 0.75 ## 🟡 Качество кода (17) ### 34. bubblewords_split_word_uses_random_in_loop - **Файл:** `routers/bubblewords.py:20` - **Snippet:** `while attempts < max_attempts: parts = [] i = 0` - **Проблема:** При большом количестве слов на уровне разбиение может не найтись за 50 попыток и уйти в fallback с суффиксами — пузыри выглядят как 'k.a1b2.0' - **Как воспроизвести:** уровень с 8 словами, где много коротких — forbidden_parts быстро заполняется - **Что сделать:** Увеличить max_attempts или использовать детерминированный алгоритм разбиения с проверкой конфликтов - **Confidence:** 0.7 ### 35. pronunciation_no_progress_tracking - **Файл:** `routers/pronunciation.py:30` - **Snippet:** `word = await conn.fetchrow(""" SELECT word_pl, translation_ru, translation_uk, translation_en, level ` - **Проблема:** Слова выдаются полностью случайно без учёта прогресса — ученик может получать одни и те же слова, нет статистики - **Как воспроизвести:** многократный вызов /pronunciation/next → повторы слов - **Что сделать:** Добавить таблицу pronunciation_progress и исключать пройденные слова, как в wordquiz - **Confidence:** 0.7 ### 36. teacher_answer_ai_explanation_outside_conn - **Файл:** `routers/teacher.py:1` - **Snippet:** `explanation_text = db_explanation if needs_ai_explanation: explanation_text = await get_wrong_answer_ai_expl` - **Проблема:** AI-вызов идёт после закрытия соединения — при ошибке AI ответ теряет explanation, но это не критично - **Как воспроизвести:** неверный ответ без wrong_because → AI-вызов вне транзакции - **Что сделать:** вынести AI-вызов до закрытия conn или явно документировать, что это осознанно - **Confidence:** 0.7 ### 37. teacher_phrase_of_day_import_random_inline - **Файл:** `routers/teacher.py:1` - **Snippet:** `import random selected_topic = random.choice(topics_list)` - **Проблема:** импорт внутри функции — стилистический запах, не влияет на ученика - **Как воспроизвести:** чтение кода - **Что сделать:** перенести import random в шапку модуля - **Confidence:** 0.9 ### 38. admin_dashboard_online_now_uses_old_metric - **Файл:** `routers/admin.py:55` - **Snippet:** `# daily_logins оставляем только если login_date = CURRENT_DATE И # есть свежая активность. Проще — убрать ветку ` - **Проблема:** Админ видит устаревший комментарий-размышление вместо кода; риск, что следующий разработчик вернёт daily_logins в online_now и метрика снова станет бесполезной. - **Как воспроизвести:** открыть routers/admin.py → прочитать комментарий над online_now - **Что сделать:** Удалить комментарий-размышление, оставить только итоговое решение. - **Confidence:** 0.75 ### 39. admin_content_words_levels_n_plus_1 - **Файл:** `routers/admin_content.py:168` - **Snippet:** `count = await conn.fetchval( "SELECT COUNT(*) FROM level_words WHERE level = $1 AND level_id IS NULL", c` - **Проблема:** Дашборд слов грузится медленнее (2 запроса × 6 уровней = 12 round-trip), при росте числа уровней деградация растёт. - **Как воспроизвести:** GET /admin/content/words/levels → в логах 12 SQL-запросов - **Что сделать:** Один GROUP BY level с COUNT(*) и MAX(edited_at), как уже сделано в /texts/levels. - **Confidence:** 0.9 ### 40. admin_content_update_lesson_question_belongs_check_inside_loop - **Файл:** `routers/admin_content.py:720` - **Snippet:** `q_exists = await conn.fetchval(""" SELECT 1 FROM learning_questions WHERE questi` - **Проблема:** Сохранение урока с 20 вопросами делает 20+ лишних SELECT — заметная задержка при сохранении в WYSIWYG. - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} с 20 вопросами → 20 SELECT + 20 UPDATE + 20 DELETE + N INSERT - **Что сделать:** Один SELECT question_id FROM learning_questions WHERE lesson_id=$1 AND question_id = ANY($2) до цикла, сверить множества. - **Confidence:** 0.85 ### 41. admin_content_update_lesson_options_insert_loop - **Файл:** `routers/admin_content.py:758` - **Snippet:** `for o in q["options"]: await conn.execute(""" INSERT INTO question_options` - **Проблема:** Сохранение урока с 20 вопросами × 4 опции = 80 отдельных INSERT — медленно, риск таймаута на слабой сети. - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} → в логах 80 INSERT подряд - **Что сделать:** Использовать executemany или один INSERT ... VALUES (...), (...), ... через unnest. - **Confidence:** 0.85 ### 42. admin_content_update_lesson_examples_insert_loop - **Файл:** `routers/admin_content.py:690` - **Snippet:** `for idx, ex in enumerate(examples, start=1): await conn.execute(""" INSERT INTO less` - **Проблема:** Каждый пример — отдельный round-trip; при 10 примерах + 20 вопросах сохранение урока становится заметно медленным. - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} с 10 примерами → 10 INSERT - **Что сделать:** executemany или один INSERT с unnest. - **Confidence:** 0.8 ### 43. support_admin_tickets_correlated_subqueries - **Файл:** `routers/support.py:195` - **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 при 1000 тикетов → 2000 подзапросов - **Что сделать:** LEFT JOIN LATERAL или отдельные агрегаты через GROUP BY + DISTINCT ON. - **Confidence:** 0.8 ### 44. tts_path_traversal_via_cache_dir - **Файл:** `routers/tts.py:22` - **Snippet:** `CACHE_DIR = "/root/filwordspl/backend/tts_cache"` - **Проблема:** при деплое в другом окружении (Docker, другой пользователь) сервис падает на старте — озвучка недоступна - **Как воспроизвести:** запустить backend не из /root/filwordspl → os.makedirs падает с PermissionError - **Что сделать:** вынести путь в config/env (TTS_CACHE_DIR), дефолт — относительный путь или tempfile.gettempdir() - **Confidence:** 0.85 ### 45. leaderboard_duplicate_cache_query - **Файл:** `routers/leaderboard.py:68` - **Snippet:** `my_row = await conn.fetchrow(""" SELECT * FROM leaderboard_cache WHERE telegram_id = $1 """, telegra` - **Проблема:** лишний round-trip к БД на каждый запрос лидерборда — медленнее отклик главного экрана - **Как воспроизвести:** GET /leaderboard → 2 запроса к leaderboard_cache по одному telegram_id (my_total_in_cache и my_row) - **Что сделать:** объединить: один SELECT * FROM leaderboard_cache WHERE telegram_id=$1 и использовать его и для total_score, и для остальных полей - **Confidence:** 0.9 ### 46. achievements_get_all_no_pagination - **Файл:** `routers/achievements.py:200` - **Snippet:** `rows = await conn.fetch("SELECT * FROM achievements ORDER BY id")` - **Проблема:** SELECT * тянет все колонки (включая description_* на 4 языках) — лишний трафик, но пока 52 строки терпимо - **Как воспроизвести:** GET /achievements → возвращает все поля всех достижений - **Что сделать:** выбирать только нужные колонки (code, icon, name_*, description_*) или отдавать по языку - **Confidence:** 0.7 ### 47. assistant_remaining_extra_query - **Файл:** `routers/assistant.py:245` - **Snippet:** `remaining = FREE_DAILY_LIMIT if is_admin else max(0, FREE_DAILY_LIMIT - await get_daily_usage(telegram_id))` - **Проблема:** лишний SELECT chat_usage после каждого успешного ответа AI — увеличивает latency ответа - **Как воспроизвести:** POST /assistant/chat → после increment_daily_usage ещё один SELECT для remaining - **Что сделать:** increment_daily_usage возвращать новое значение через RETURNING message_count и использовать его - **Confidence:** 0.85 ### 48. auth_http_exception_in_verify - **Файл:** `auth.py:20` - **Snippet:** `raise HTTPException(401, "Hash not found in initData")` - **Проблема:** verify_telegram_initdata смешивает валидацию и HTTP-слой — сложно переиспользовать и тестировать - **Как воспроизвести:** юнит-тест verify_telegram_initdata требует FastAPI-контекста - **Что сделать:** возвращать (ok, reason) или кидать доменное исключение, HTTPException — только в require_auth - **Confidence:** 0.72 ### 49. init_db_giant_transaction - **Файл:** `database.py:20` - **Snippet:** `async with conn.transaction():` - **Проблема:** вся инициализация схемы в одной транзакции — долгий lock на information_schema/pg_constraint, при рестарте возможны таймауты и блокировки - **Как воспроизвести:** рестарт при активных запросах → ALTER TABLE ждёт lock, транзакция висит - **Что сделать:** разбить на отдельные транзакции по таблицам; миграции вынести в Alembic - **Confidence:** 0.7 ### 50. init_db_auto_migrations_in_prod - **Файл:** `database.py:60` - **Snippet:** `ALTER TABLE users ADD COLUMN current_level TEXT DEFAULT 'A1'` - **Проблема:** авто-миграции в рантайме на каждом старте — риск рассинхрона схемы между окружениями и неожиданных ALTER на проде - **Как воспроизвести:** изменить определение таблицы в коде → на проде применится ALTER без ревью - **Что сделать:** перейти на Alembic/Flyway; init_db оставить только для CREATE IF NOT EXISTS - **Confidence:** 0.78 --- **Итого:** всего находок=50, snippet не совпал=0, низкий confidence=0, прошло=50 _Этот 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#14