🤖 AI Review (backend): 59 задач (2026-09-25 19:38 UTC) #17

Open
opened 2026-09-25 19:38:51 +00:00 by Drobysh · 0 comments
Owner

🤖 AI Code Review (Backend)

Дата: 2026-09-25 19:38 UTC
Модели: deepseek-ai/DeepSeek-V4.1-Flash + zai-org/GLM-5.3-Flash
Репозиторий: Drobysh/filwordspl-backend

📊 По пакам

  • routers_games — 7 файлов, 65,802 символов, находок=3
  • routers_learning_core — 1 файлов, 40,548 символов, находок=5
  • routers_learning_teacher — 1 файлов, 47,356 символов, находок=10
  • routers_learning_orch — 2 файлов, 12,293 символов, находок=14
  • routers_admin — 4 файлов, 97,143 символов, находок=8
  • routers_misc — 5 файлов, 69,714 символов, находок=9
  • core — 4 файлов, 69,897 символов, находок=10
  • services — 0 файлов, 0 символов, находок=0

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

1. completion_time_type_unvalidated 🔵 secondary

  • Файл: routers/game.py:168
  • Snippet: if completion_time is not None and completion_time < 5:
  • Проблема: completion_time приходит из JSON без валидации типа: строка или объект вызовет TypeError при сравнении → 500 вместо 400
  • Как воспроизвести: POST /game/complete-level с {"completion_time": "fast"} → Internal Server Error
  • Что сделать: валидировать тело pydantic-моделью (completion_time: float | None) или isinstance-проверкой
  • Confidence: 0.85

2. session_complete_no_session_id_check

  • Файл: routers/learning.py:0

  • Snippet: `session_id = body.get("session_id")

    pool = await get_pool()
    async with pool.acquire() as conn:
    session `

  • Проблема: При отсутствии session_id в теле запроса asyncpg падает с ошибкой типа → 500 вместо понятной 400

  • Как воспроизвести: POST /learning/session/complete с пустым body → 500 Internal Server Error

  • Что сделать: if not session_id: raise HTTPException(400, "session_id required") до обращения к БД

  • Confidence: 0.9

3. update_skill_mastery_previous_mastery_self_reference

  • Файл: routers/learning.py:0
  • Snippet: previous_mastery = float(previous_row["mastery_score"]) if previous_row and previous_row["mastery_score"] else mastery
  • Проблема: При первой попытке previous_mastery = mastery → delta всегда 0, ученик никогда не видит роста на первом расчёте
  • Как воспроизвести: Первый ответ по навыку → mastery_delta = 0 вместо реального значения
  • Что сделать: Если previous_row отсутствует — previous_mastery = 0 (или NULL), а не текущий mastery
  • Confidence: 0.85

4. diagnostic_test_no_options_in_resume

  • Файл: routers/teacher.py:320
  • Snippet: if session["session_type"] == "teacher_test": questions = await get_test_questions(conn, session["topic_
  • Проблема: При /resume диагностического теста (session_type='diagnostic_test') код идёт в else-ветку, ищет lesson_id по topic_id='' → questions=[] → возвращает has_active_session=False. Ученик теряет прогресс диагностики.
  • Как воспроизвести: Начать /diagnostic-test → ответить на 3 вопроса → закрыть → /resume → has_active_session=False, сессия потеряна.
  • Что сделать: Добавить ветку для session_type == 'diagnostic_test': перезагружать вопросы через тот же запрос, что и в teacher_diagnostic_test (ORDER BY RANDOM() LIMIT 15 не воспроизводит порядок — нужно хранить question_ids в сессии).
  • Confidence: 0.88

5. save_answer_ignores_hint_used 🔗 both

  • Файл: routers/teacher.py:130
  • Snippet: await save_answer_to_session( conn, telegram_id, session_id, question_data, selected_answer, is_
  • Проблема: Параметр hint_used в save_answer_to_session всегда False — если ученик использовал подсказку, это не фиксируется в БД. Аналитика и mastery искажаются.
  • Как воспроизвести: Использовать подсказку → ответить → в user_learning_answers.hint_used = FALSE.
  • Что сделать: Принимать hint_used из body запроса и передавать в save_answer_to_session.
  • Confidence: 0.87

6. diagnostic_test_questions_not_persisted

  • Файл: routers/teacher.py:780
  • Snippet: SELECT * FROM learning_questions WHERE is_test_question = TRUE ORDER BY RANDOM() LIM
  • Проблема: Диагностический тест выбирает 15 случайных вопросов, но не сохраняет их список в сессии. При /resume или перезагрузке страницы вопросы будут другими — ученик не сможет завершить тест.
  • Как воспроизвести: Начать /diagnostic-test, ответить на 5 вопросов, вызвать /resume — вопросы перегенерируются, прогресс ломается.
  • Что сделать: Сохранять question_ids в learning_sessions (JSONB-поле) при создании сессии и читать их при resume/answer.
  • Confidence: 0.85

7. answer_question_not_in_session 🔗 both

  • Файл: routers/teacher.py:620
  • Snippet: current_index = 0 for i, q in enumerate(questions): if q["question"]["question_id"] == question_id:
  • Проблема: Если question_id не найден в списке questions (например, при diagnostic_test или рассинхроне), current_index остаётся 0 → next_index=1 → ученику показывается второй вопрос вместо следующего. Прогресс сбивается.
  • Как воспроизвести: Отправить /answer с question_id, которого нет в текущем списке questions — получишь questions[1] вместо корректного next.
  • Что сделать: Если вопрос не найден (current_index не изменился и questions[0] != question_id) — вернуть 400/404, а не молча показывать questions[1].
  • Confidence: 0.85

8. orchestrator_weak_skill_ignores_retention

  • Файл: routers/orchestrator.py:78
  • Snippet: WHERE user_id = $1 AND mastery_score < 75 AND attempts_count >= 2
  • Проблема: Ученик с overdue-навыком без подходящего урока в learning_lessons проваливается в шаг 2 и получает тот же слабый навык, но с reason='weak_mastery' — цикл повторения не сдвигается
  • Как воспроизвести: overdue_skill найден, но lesson для его skill_tag отсутствует (is_active=FALSE) → шаг 2 возвращает тот же skill_tag
  • Что сделать: Исключить skill_tag из шага 2 (AND skill_tag != $2) или объединить шаги 1 и 2 в один запрос с приоритетом retention
  • Confidence: 0.8

9. orchestrator_lesson_id_not_in_null 🔗 both

  • Файл: routers/orchestrator.py:137
  • Snippet: AND l.lesson_id NOT IN ( SELECT lesson_id FROM user_lesson_progress WHERE user_id = $2 AND
  • Проблема: Если в user_lesson_progress есть строка с lesson_id = NULL, NOT IN вернёт пустой результат — ученик увидит 'all_completed' и не получит следующий урок
  • Как воспроизвести: INSERT INTO user_lesson_progress(user_id, lesson_id, completed) VALUES(1, NULL, TRUE) → orchestrator возвращает type='completed'
  • Что сделать: Заменить на NOT EXISTS или добавить AND lesson_id IS NOT NULL в подзапрос
  • Confidence: 0.9

10. orchestrator_lesson_questions_no_active_filter

  • Файл: routers/orchestrator.py:200
  • Snippet: SELECT * FROM learning_questions WHERE lesson_id = $1 AND is_test_question = FALSE ORDER BY id
  • Проблема: В get_lesson_questions и get_test_questions нет фильтра is_active у вопросов — ученик может получить деактивированные/устаревшие вопросы, тогда как get_lesson_by_id использует тот же запрос без фильтра, но урок фильтруется по is_active
  • Как воспроизвести: UPDATE learning_questions SET is_active=FALSE WHERE lesson_id='x' → вопросы всё равно возвращаются
  • Что сделать: Добавить AND is_active = TRUE (если колонка существует) во все три запроса вопросов
  • Confidence: 0.75

11. review_always_first_lesson 🔵 secondary

  • Файл: routers/orchestrator.py:44
  • Snippet: WHERE l.skill_tag = $1 AND l.is_active = TRUE ORDER BY l.order_number LIMIT 1
  • Проблема: При повторении (overdue/weak) ученику всегда выдаётся ПЕРВЫЙ урок навыка по порядку, а не тот, где он ошибался — повторение бесконечно крутит один и тот же начальный урок, прогресс по слабому навыку не двигается
  • Как воспроизвести: провалить 3-й урок навыка → mastery < 75 → orchestrator раз за разом возвращает урок №1 этого навыка
  • Что сделать: выбирать урок с учётом user_lesson_progress (наименее освоенный/последний ошибочный) или сортировать по убыванию сложности/ошибкам
  • Confidence: 0.85

12. current_level_param_mismatch 🔵 secondary

  • Файл: routers/orchestrator.py:30
  • Snippet: SELECT current_level FROM users WHERE telegram_id = $1 """, user_id) or "A1"
  • Проблема: Если вызывающий код передаёт внутренний user_id (int PK), а не telegram_id, запрос вернёт NULL и молча подставится 'A1' — ученик с уровнем B1 получает уроки уровня A1
  • Как воспроизвести: вызвать get_next_lesson(conn, user_id=внутренний_pk) → current_level всегда 'A1' → шаг 4 выдаёт уроки A1
  • Что сделать: переименовать параметр в telegram_id или фильтровать по users.user_id; убрать молчаливый fallback 'A1' (логировать/падать)
  • Confidence: 0.78

13. test_step_no_level_check 🔵 secondary

  • Файл: routers/orchestrator.py:88
  • Snippet: WHERE tp.user_id = $1 AND tp.lessons_completed >= tp.lessons_total AND tp.lessons_total > 0
  • Проблема: Тест темы предлагается по user_topic_progress без проверки, что тема относится к текущему уровню и что lessons_total актуален; при рассинхроне lessons_total (например, тему расширили) ученика зациклит на тесте, хотя уроки темы не все пройдены фактически
  • Как воспроизвести: увеличить lessons_total у завершённой темы → lessons_completed >= lessons_total ложно, но если наоборот уменьшить — тест предлагается до прохождения добавленных уроков
  • Что сделать: сверять lessons_completed с фактическим числом активных уроков темы в learning_lessons
  • Confidence: 0.76

14. feed_get_feed_post_no_expires_check

  • Файл: routers/feed.py:178
  • Snippet: SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE
  • Проблема: Истёкший пост (expires_at < NOW()) всё равно отдаётся по прямому ID, хотя в списке секции он скрыт
  • Как воспроизвести: GET /feed/post/{id} для поста с истёкшим expires_at → пост возвращается
  • Что сделать: Добавить AND (expires_at IS NULL OR expires_at > NOW())
  • Confidence: 0.9

15. admin_dashboard_online_now_uses_wrong_columns

  • Файл: routers/admin.py:78
  • Snippet: SELECT user_id FROM user_progress WHERE completed_at > NOW() - INTERVAL '30 minutes'
  • Проблема: Метрика online_now показывает 0 или заниженное число — админ видит неверную статистику
  • Как воспроизвести: Открыть /admin/dashboard → online_now всегда 0, хотя юзеры активны
  • Что сделать: Проверить реальные имена колонок (user_id/completed_at) в user_progress, sentence_progress, user_learning_answers, chat_history; если их нет — запрос упадёт с UndefinedColumn
  • Confidence: 0.8

16. leaderboard_rank_off_by_one

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

17. login_streak_nondeterministic_grp 🔵 secondary

  • Файл: routers/achievements.py:262
  • Snippet: SELECT COUNT(*) FROM dates WHERE grp = (SELECT grp FROM dates LIMIT 1)
  • Проблема: Подзапрос (SELECT grp FROM dates LIMIT 1) без ORDER BY возвращает произвольную строку — серия входов считается нестабильно, достижение login_3/login_7 может не выдаться или streak показывается неверный.
  • Как воспроизвести: заходить несколько дней подряд → /achievements/track-login иногда возвращает streak=1 вместо реальной серии
  • Что сделать: (SELECT grp FROM dates ORDER BY login_date DESC LIMIT 1) или вычислять grp первой строки CTE
  • Confidence: 0.88

18. leaderboard_rank_achievement_uses_wrong_rank 🔗 both

  • Файл: routers/leaderboard.py:175
  • Snippet: if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)
  • Проблема: Достижение 'rank_top3'/'rank_1' выдаётся по my_position, который может быть завышен из-за off-by-one выше. Юзер с реальным 4-м местом получит 'топ-3'
  • Как воспроизвести: Занять 4-е место → из-за +1 в user_rank my_position=3 → выдаётся rank_top3
  • Что сделать: Исправить расчёт user_rank (см. выше), либо считать позицию через ROW_NUMBER() OVER (ORDER BY total_score DESC) в одном запросе
  • Confidence: 0.87

19. register_race_unique_violation 🔵 secondary

  • Файл: routers/users.py:27
  • Snippet: row = await conn.fetchrow( """INSERT INTO users (telegram_id, username, current_level)
  • Проблема: При двух параллельных запросах /users/register (повторный коннект клиента, гонка после SELECT) второй INSERT падает с unique_violation → 500, пользователь видит ошибку регистрации.
  • Как воспроизвести: двойной вызов /users/register одновременно → один из запросов возвращает 500
  • Что сделать: INSERT ... ON CONFLICT (telegram_id) DO UPDATE SET username = COALESCE(EXCLUDED.username, users.username) RETURNING ... или ловить UniqueViolation и делать SELECT
  • Confidence: 0.85

20. matview_if_not_exists_drift 🔵 secondary

  • Файл: main.py:152
  • Snippet: CREATE MATERIALIZED VIEW IF NOT EXISTS leaderboard_cache AS
  • Проблема: если определение matview меняется в коде (новая игра/колонка score), на существующем проде CREATE IF NOT EXISTS молча пропустит создание — лидерборд навсегда считает по старой формуле, очки учеников в рейтинге неверные
  • Как воспроизвести: изменить SELECT matview → задеплоить → leaderboard продолжает использовать старое определение
  • Что сделать: версионировать matview: CREATE OR REPLACE / DROP+CREATE в отдельной миграции с REFRESH
  • Confidence: 0.85

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

21. wordquiz_client_controls_correct_answer

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

22. wordquiz_consolation_score_repeatable

  • Файл: routers/wordquiz.py:200
  • Snippet: if mistakes >= 3: await conn.execute(""" INSERT INTO word_quiz_progress (user_id, wo
  • Проблема: Ученик может бесконечно получать по 10 очков за каждую ошибку после 3-й — total_score накручивается
  • Как воспроизвести: сделать 3 ошибки → +10, сделать 4-ю ошибку → снова +10, и так далее
  • Что сделать: Сбрасывать current_mistakes после начисления утешительных очков или начислять только один раз
  • Confidence: 0.85

23. update_skill_mastery_previous_mastery_score_not_updated

  • Файл: routers/learning.py:0
  • Snippet: previous_mastery_score = $25, mastery_delta = $26,
  • Проблема: previous_mastery_score перезаписывается текущим mastery, а не старым — история дельт ломается, аналитика тренда некорректна
  • Как воспроизвести: Два ответа подряд → previous_mastery_score == mastery_score, delta всегда 0 после первого раза
  • Что сделать: В ON CONFLICT SET previous_mastery_score = user_skill_mastery.mastery_score (старое значение), а не $25
  • Confidence: 0.88

24. complete_session_no_idempotency

  • Файл: routers/learning.py:0
  • Snippet: await conn.execute("UPDATE learning_sessions SET is_completed = TRUE, completed_at = NOW() WHERE id = $1", session_id)
  • Проблема: Повторный вызов complete_session пересчитывает мастерство, инкрементит attempts_count, обновляет AI-контекст — двойной учёт
  • Как воспроизвести: Двойной клик по кнопке завершения → двойные инкременты
  • Что сделать: Проверять session["is_completed"] и возвращать 200 без повторной обработки
  • Confidence: 0.85

25. history_save_no_size_limit 🔗 both

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

  • Snippet: `messages = body.get("messages", [])

    if not isinstance(messages, list):
    raise HTTPException(400, "messag`

  • Проблема: Нет ограничения на размер messages — атакующий может залить мегабайты JSON в teacher_chat_history, раздувая БД и вызывая OOM при загрузке.

  • Как воспроизвести: POST /teacher/history/save с messages = [{'x': 'A'*1000000}] * 1000 — запись на гигабайты.

  • Что сделать: Ограничить: len(messages) <= 200 и общий размер json.dumps(messages) <= 100KB, иначе 413.

  • Confidence: 0.93

26. ai_limit_race_condition

  • Файл: routers/teacher.py:155
  • Snippet: if not await check_ai_limit(conn, telegram_id): return get_ai_limit_message(lang)
  • Проблема: Ученик может бесплатно обойти лимит AI-помощи, отправив несколько параллельных запросов — счётчик инкрементируется только ПОСЛЕ успешного ответа AI, а проверка лимита и инкремент не атомарны.
  • Как воспроизвести: Отправить 10 параллельных POST /teacher/explain — все пройдут check_ai_limit (usage=0), все вызовут AI, все инкрементируют счётчик. Лимит 5/день обходится.
  • Что сделать: Атомарно резервировать слот: INSERT ... ON CONFLICT DO UPDATE SET command_count = command_count + 1 WHERE command_count < LIMIT RETURNING command_count — до вызова AI. При ошибке AI — откатывать.
  • Confidence: 0.9

27. ai_limit_check_race 🔵 secondary

  • Файл: routers/teacher.py:130
  • Snippet: usage = await get_teacher_ai_usage(conn, user_id) return usage < TEACHER_AI_DAILY_LIMIT
  • Проблема: Параллельные запросы (explain/examples/free-message/translate) проходят проверку лимита одновременно — реальное число AI-вызовов за день превышает 5, растут расходы на Together API
  • Как воспроизвести: отправить 10 параллельных POST /teacher/explain → все пройдут check_ai_limit до инкремента → 10 AI-вызовов при лимите 5
  • Что сделать: атомарный upsert с условием: INSERT ... ON CONFLICT DO UPDATE SET command_count = command_count + 1 WHERE command_count < $limit RETURNING command_count
  • Confidence: 0.88

28. ai_limit_not_incremented_on_failure

  • Файл: routers/teacher.py:165
  • Snippet: if ai_response: async with pool.acquire() as conn: await increment_teacher_ai_usage(conn, telegram_i
  • Проблема: Если AI-провайдер падает/таймаутит, лимит не списывается — ученик может бесконечно долбить AI-эндпоинты, нагружая внешний API и не получая ответа.
  • Как воспроизвести: Сделать TOGETHER_API_KEY невалидным → call_ai возвращает '' → счётчик не растёт → лимит никогда не исчерпается.
  • Что сделать: Инкрементировать счётчик ДО вызова AI (после успешной проверки лимита), либо инкрементировать всегда, независимо от результата.
  • Confidence: 0.85

29. phrase_of_day_race_condition

  • Файл: routers/teacher.py:260
  • Snippet: today_phrase = await conn.fetchrow(""" SELECT * FROM daily_phrases WHERE phrase_date = $1 """, today
  • Проблема: При одновременных запросах от нескольких пользователей в момент смены дня все они увидят пустую фразу → все вызовут AI → все сделают INSERT ... ON CONFLICT DO UPDATE. Лишние траты AI-токенов и гонка записи.
  • Как воспроизвести: В 00:00 UTC отправить 50 параллельных GET /teacher/phrase-of-day — 50 вызовов AI вместо одного.
  • Что сделать: Использовать advisory lock (pg_advisory_xact_lock) или INSERT ... ON CONFLICT DO NOTHING RETURNING с проверкой — генерировать фразу только если INSERT реально вставил строку.
  • Confidence: 0.85

30. phrase_day_ai_inside_conn 🔵 secondary

  • Файл: routers/teacher.py:300
  • Snippet: ai_response = await call_ai(user_prompt, system_prompt, max_tokens=1000)
  • Проблема: AI-вызов (timeout 90s) выполняется внутри pool.acquire() — соединение из пула занято до 90 секунд; несколько одновременных запросов исчерпывают пул, у всех пользователей падают запросы к БД
  • Как воспроизвести: первый запрос дня на /teacher/phrase-of-day при медленном AI + параллельные запросы других пользователей → pool exhausted, таймауты
  • Что сделать: освободить соединение перед call_ai, вернуть его только для INSERT; или генерировать фразу в фоне/по cron
  • Confidence: 0.85

31. orchestrator_reaction_lang_unsafe 🔗 both

  • Файл: routers/orchestrator.py:275
  • Snippet: field = f"text_{lang}" return row.get(field) or row.get("text_en") or "OK"
  • Проблема: Если lang приходит из query/body без whitelist, f-string подставляется в имя колонки — потенциальный доступ к произвольным полям row (например, 'id' или 'reaction_type')
  • Как воспроизвести: get_random_reaction(conn, 'correct', 'id') → вернёт row['id'] вместо текста
  • Что сделать: Валидировать lang ∈ {'pl','ru','uk','en'} до формирования field
  • Confidence: 0.87

32. orchestrator_wrong_because_lang_unsafe

  • Файл: routers/orchestrator.py:296
  • Snippet: field = f"explanation_{lang}" return row.get(field) or row.get("explanation_en") or ""
  • Проблема: Аналогично: невалидированный lang позволяет вытащить произвольную колонку из wrong_because_explanations
  • Как воспроизвести: get_wrong_because_explanation(conn, 'x', 'wrong_because') → вернёт wrong_because
  • Что сделать: Whitelist lang перед формированием имени поля
  • Confidence: 0.82

33. feed_upload_image_no_magic_bytes_check

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

34. support_admin_reply_no_message_length_check_on_ticket_id_type 🔗 both

  • Файл: routers/support.py:245
  • Snippet: ticket_id = body.get("ticket_id") message = body.get("message", "").strip()
  • Проблема: ticket_id не приводится к int — если придёт строка, asyncpg упадёт с ошибкой типа; если None — 400, но без явной валидации
  • Как воспроизвести: POST /support/admin-reply с ticket_id="abc" → 500 вместо 400
  • Что сделать: Валидировать ticket_id как int, обрабатывать ValueError
  • Confidence: 0.85

35. admin_content_update_word_updates_all_levels_rows

  • Файл: routers/admin_content.py:268
  • Snippet: WHERE level = $5 AND word_pl = $6
  • Проблема: При переименовании слова обновляются ВСЕ строки с этим word_pl в уровне, включая привязки к игровым уровням Филвордов — может сломать игровой контент
  • Как воспроизвести: PUT /admin/content/words/word/{id} с новым word_pl → все строки (level, old_word_pl) перезаписаны, включая level_id != NULL
  • Что сделать: Обновлять только строку с данным id, либо явно ограничить level_id IS NULL + отдельно синхронизировать привязки
  • Confidence: 0.82

36. achievements_check_race_condition

  • Файл: routers/achievements.py:340
  • Snippet: matching = await conn.fetch(""" SELECT a.* FROM achievements a WHERE a.requirement_type = $1
  • Проблема: При параллельных запросах (двойной клик, retry) одно и то же достижение может быть выдано дважды — ON CONFLICT DO NOTHING спасает от дубля в БД, но в ответе new_achievements юзер увидит дубликат попапа
  • Как воспроизвести: Два параллельных POST /track-login → оба SELECT вернут одно достижение → оба INSERT ON CONFLICT DO NOTHING → оба добавят в newly_unlocked
  • Что сделать: Использовать INSERT ... ON CONFLICT DO NOTHING RETURNING id и добавлять в newly_unlocked только если RETURNING вернул строку
  • Confidence: 0.85

37. save_analytics_bypasses_limits 🔵 secondary

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

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

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

  • Проблема: Эндпоинт сохраняет произвольный текст как сообщение ассистента (is_user=False) без проверки длины и дневного лимита — можно раздуть историю/контекст и подменить ответы бота, а также обойти лимит 5 сообщений.

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

  • Что сделать: Добавить проверку len(message) <= 500 и лимит на количество вызовов, валидировать источник (только серверная аналитика)

  • Confidence: 0.85

38. auth_query_param_initdata_leaks_in_logs 🔗 both

  • Файл: auth.py:78
  • Snippet: init_data = request.query_params.get('initData', '')
  • Проблема: initData в query-параметре попадает в access-логи nginx/Cloudflare/Sentry — утечка токена, позволяющая имперсонировать ученика
  • Как воспроизвести: сделать запрос с ?initData=... → токен в логах
  • Что сделать: убрать query-fallback, использовать только заголовки; либо маскировать initData в логах
  • Confidence: 0.9

39. auth_hmac_secret_key_order_wrong

  • Файл: auth.py:55
  • Snippet: secret_key = hmac.new( 'WebAppData'.encode(), BOT_TOKEN.encode(), hashlib.sha256
  • Проблема: порядок аргументов hmac.new(key, msg) — здесь key='WebAppData', msg=BOT_TOKEN. По документации Telegram должно быть наоборот: key=BOT_TOKEN, msg='WebAppData'. Если так — подпись не сходится и ВСЕ пользователи получают 401
  • Как воспроизвести: любой валидный initData от Telegram → 401 Invalid initData signature
  • Что сделать: поменять: hmac.new(BOT_TOKEN.encode(), b'WebAppData', hashlib.sha256).digest()
  • Confidence: 0.9

40. learning_tables_no_user_fk 🔵 secondary

  • Файл: database.py:336
  • Snippet: CREATE TABLE IF NOT EXISTS learning_sessions ( id BIGSERIAL PRIMARY KEY, user_id
  • Проблема: при удалении пользователя (ON DELETE CASCADE в других таблицах) строки learning_sessions, user_learning_answers, user_lesson_progress, user_topic_progress, user_skill_mastery, ai_user_context остаются сиротами — аналитика и matview считают мёртвых пользователей
  • Как воспроизвести: удалить user из users → SELECT из user_learning_answers по удалённому user_id всё ещё возвращает строки
  • Что сделать: добавить REFERENCES users(telegram_id) ON DELETE CASCADE для user_id во всех learning-таблицах (миграция + в CREATE TABLE)
  • Confidence: 0.9

41. static_uploads_no_auth_no_size_limit 🔗 both

  • Файл: main.py:172
  • Snippet: app.mount("/uploads", StaticFiles(directory=UPLOADS_DIR), name="uploads")
  • Проблема: любой может перебрать/скачать все загруженные картинки feed-постов (включая неопубликованные), если знает имя файла
  • Как воспроизвести: GET /uploads/ без авторизации
  • Что сделать: отдавать через эндпоинт с проверкой is_published, либо использовать непредсказуемые имена (uuid) и не листить
  • Confidence: 0.87

42. ratelimit_no_global_ip_cap 🔵 secondary

  • Файл: main.py:262

  • Snippet: `rate_key = f"{client_ip}:{path}"

    if not rate_limiter.is_allowed(rate_key, path):`

  • Проблема: лимит только per-path: атакующий с одного IP может одновременно долбить все ~25 эндпоинтов, каждый со своим лимитом (60+30+30+... запросов/мин) — дорогие AI-эндпоинты (/assistant, /teacher, /tts) выжигают бюджет суммарно

  • Как воспроизвести: циклом слать по 55 запросов/мин на каждый AI-эндпоинт с одного IP — ни один 429 не вернётся

  • Что сделать: добавить глобальный per-IP лимит (например 120/мин) поверх per-path, проверять оба ключа

  • Confidence: 0.85

43. rate_limiter_memory_leak_unbounded_keys

  • Файл: main.py:78
  • Snippet: self.requests = defaultdict(list)
  • Проблема: при большом числе уникальных IP:path ключей память растёт неограниченно, процесс может упасть (OOM) — все ученики получают 502
  • Как воспроизвести: нагрузка с разных IP → ключи накапливаются → RSS растёт; cleanup раз в 60с не спасает при burst
  • Что сделать: ограничить размер dict (LRU) или перейти на Redis; либо чистить при превышении N ключей
  • Confidence: 0.8

44. ratelimit_inmemory_multivorker 🔵 secondary

  • Файл: main.py:47

  • Snippet: `class RateLimiter:
    """In-memory rate limiter.

    ⚠️ ВАЖНО: работает корректно только при ОДНОМ воркере uvicorn.`

  • Проблема: при запуске --workers N или после рестарта лимиты обнуляются/умножаются: /game/complete-level фактически 10*N/мин, рестарт сбрасывает счётчики — брутфорс и выжигание AI-бюджета

  • Как воспроизвести: запустить uvicorn --workers 4 → один IP получает 240 req/min на default-лимите

  • Что сделать: перевести на Redis (INCR + EXPIRE) до горизонтального масштабирования

  • Confidence: 0.8

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

45. retention_score_hardcoded_zero 🔵 secondary

  • Файл: routers/learning.py:428
  • Snippet: ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, 0, $14,
  • Проблема: поле retention_score в user_skill_mastery всегда 0 — мёртвые данные, вводят в заблуждение потребителей аналитики
  • Как воспроизвести: SELECT retention_score FROM user_skill_mastery → всегда 0
  • Что сделать: либо рассчитать retention, либо убрать колонку из INSERT/схемы
  • Confidence: 0.85

46. orchestrator_duplicate_lesson_query

  • Файл: routers/orchestrator.py:47
  • Snippet: lesson = await conn.fetchrow(""" SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.titl
  • Проблема: Дублирование SQL — при изменении схемы уроков легко забыть поправить во втором месте, что приведёт к рассинхрону ответов orchestrator
  • Как воспроизвести: Сравнить блоки в шаге 1 (стр. 47) и шаге 2 (стр. 86) — идентичный SQL
  • Что сделать: Вынести в helper _fetch_lesson_by_skill(conn, skill_tag)
  • Confidence: 0.9

47. orchestrator_duplicate_options_loader

  • Файл: routers/orchestrator.py:175
  • Snippet: question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids: all_options = awa
  • Проблема: Три почти идентичных блока загрузки options (get_lesson_by_id, get_lesson_questions, get_test_questions) — риск рассинхрона при правках
  • Как воспроизвести: Сравнить строки 175, 205, 235 — одинаковый код
  • Что сделать: Вынести _attach_options(conn, questions) -> list
  • Confidence: 0.9

48. orchestrator_random_reaction_full_scan

  • Файл: routers/orchestrator.py:253
  • Snippet: FROM teacher_reactions WHERE reaction_type = $1 ORDER BY RANDOM() LIMIT 1
  • Проблема: ORDER BY RANDOM() делает full scan таблицы реакций на каждый ответ ученика — при росте банка реакций ответы замедлятся
  • Как воспроизвести: EXPLAIN ANALYZE на teacher_reactions с 10k+ строк
  • Что сделать: Использовать TABLESAMPLE SYSTEM_ROWS(1) или предвыборку id через random() в подзапросе
  • Confidence: 0.8

49. profile_hash_decimal_only

  • Файл: routers/learning_profile.py:47
  • Snippet: if isinstance(v, Decimal): item[k] = float(v) else: item[k] = v
  • Проблема: Хэш не сериализует datetime/date (например, days_since_last_attempt как date) — json.dumps упадёт с TypeError, кэш профиля не построится
  • Как воспроизвести: Передать weak_skills с полем типа datetime → get_profile_hash бросает TypeError
  • Что сделать: Использовать default=str в json.dumps или расширить конвертер на date/datetime
  • Confidence: 0.8

50. options_loader_triplicated 🔵 secondary

  • Файл: routers/orchestrator.py:190
  • Snippet: question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids:
  • Проблема: Одинаковый блок загрузки опций (fetch + группировка в Python) скопирован в get_lesson_by_id, get_lesson_questions и get_test_questions — правка в одном месте разъедется с двумя другими
  • Как воспроизвести: изменить логику сортировки/фильтрации опций в одной функции → две другие останутся со старой логикой
  • Что сделать: вынести в хелпер _load_questions_with_options(conn, where_clause, params) или одну функцию с флагом is_test_question
  • Confidence: 0.95

51. review_lesson_query_duplicated 🔵 secondary

  • Файл: routers/orchestrator.py:44
  • Snippet: SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.title_uk, l.title_en FROM learning_le
  • Проблема: Идентичный SQL выбора урока для повторения продублирован в шагах 1 и 2 — при изменении критериев выбора урока для review легко поправить только одну ветку
  • Как воспроизвести: добавить фильтр уровня в шаг 1 → шаг 2 продолжит выдавать уроки чужого уровня
  • Что сделать: вынести в общий хелпер _get_review_lesson_for_skill(conn, skill_tag)
  • Confidence: 0.9

52. admin_content_unused_import_re 🔵 secondary

  • Файл: routers/admin_content.py:27
  • Snippet: import logging import re from typing import Optional
  • Проблема: мёртвый импорт, сбивает при чтении модуля
  • Как воспроизвести: grep 're.' routers/admin_content.py — ни одного использования
  • Что сделать: удалить import re
  • Confidence: 0.95

53. feed_unused_import_os 🔵 secondary

  • Файл: routers/feed.py:15
  • Snippet: import json import re import uuid import os
  • Проблема: мёртвый импорт
  • Как воспроизвести: grep 'os.' routers/feed.py — не используется (пути через Path/UPLOADS_DIR)
  • Что сделать: удалить import os
  • Confidence: 0.9

54. admin_content_update_lesson_row_by_row 🔵 secondary

  • Файл: routers/admin_content.py:780
  • Snippet: for idx, ex in enumerate(examples, start=1): await conn.execute(""" INSERT INTO less
  • Проблема: сохранение урока с 10 вопросами × 4 опции = ~50 последовательных round-trip в одной транзакции; при медленной сети/локах транзакция держит коннект секунды
  • Как воспроизвести: PUT /admin/content/lessons/lesson/x с 10 вопросами → 1 UPDATE + 1 DELETE + 10 INSERT examples + 10×(SELECT+UPDATE+DELETE+4 INSERT) ≈ 70 запросов
  • Что сделать: использовать executemany / COPY / INSERT ... SELECT FROM unnest($1::text[][]) для батч-вставки
  • Confidence: 0.85

55. tts_path_traversal_via_cache_dir 🔗 both

  • Файл: routers/tts.py:30
  • Snippet: CACHE_DIR = "/root/filwordspl/backend/tts_cache" os.makedirs(CACHE_DIR, exist_ok=True)
  • Проблема: Хардкод абсолютного пути — при деплое в другой каталог/контейнер os.makedirs упадёт с PermissionError на старте приложения, весь backend не поднимется
  • Как воспроизвести: Запустить backend из другого окружения (Docker, staging) → ImportError/PermissionError при импорте routers.tts
  • Что сделать: Вынести путь в config/env (TTS_CACHE_DIR), использовать os.getenv с дефолтом относительно file
  • Confidence: 0.93

56. admin_stats_duplicated 🔵 secondary

  • Файл: routers/assistant.py:330
  • Snippet: online_now = await conn.fetchval(""" SELECT COUNT(DISTINCT user_id) FROM (
  • Проблема: Запросы total_users/new_today/online_now/level_counts полностью дублируются между routers/leaderboard.py:get_admin_stats и routers/assistant.py:get_admin_stats — правки в одном месте расходятся со вторым.
  • Как воспроизвести: сравнить /leaderboard/admin/stats и /assistant/stats/admin — одинаковый код в двух файлах
  • Что сделать: Вынести общие агрегаты в общий сервис/модуль stats.py
  • Confidence: 0.9

57. tts_blocking_io_event_loop 🔵 secondary

  • Файл: routers/tts.py:55
  • Snippet: with open(cache_path, 'rb') as f: return Response(
  • Проблема: Синхронные open/read/write в async-хендлере блокируют event loop: при медленном диске/большом кэше зависают все запросы сервера, включая игру.
  • Как воспроизвести: много параллельных запросов /tts с cache miss → latency всех эндпоинтов растёт
  • Что сделать: Использовать asyncio.to_thread / aiofiles для чтения и записи кэша
  • Confidence: 0.85

58. col_exists_migration_duplication 🔵 secondary

  • Файл: database.py:55
  • Snippet: col_exists = await conn.fetchval(""" SELECT 1 FROM information_schema.columns WHERE tab
  • Проблема: один и тот же блок fetchval+ALTER скопирован ~12 раз с разными именами — легко забыть добавить проверку для новой колонки или ошибиться в table_name (ошибка всплывёт только на проде)
  • Как воспроизвести: добавить новую колонку в любую таблицу → скопировать блок → опечатка в table_name → ALTER на несуществующей таблице падает на старте
  • Что сделать: хелпер ensure_column(conn, table, column, ddl) с параметризованным запросом через $1/$2
  • Confidence: 0.9

59. init_db_ddl_every_startup 🔵 secondary

  • Файл: database.py:20
  • Snippet: async with conn.transaction(): # ============ users ============ await conn.execute("""
  • Проблема: ~500 строк DDL, десятки information_schema-проверок и ALTER выполняются при каждом старте в одной транзакции: долгий старт, блокировки каталога PostgreSQL, риск частично применённой схемы при таймауте деплоя
  • Как воспроизвести: рестарт приложения → в логах десятки миграционных проверок; время старта растёт с числом таблиц
  • Что сделать: вынести в отдельные версионированные миграции (alembic/yoyo), в init_db оставить только проверку версии схемы
  • Confidence: 0.88

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

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

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