🤖 AI Review (backend): 60 задач (2026-09-25 20:00 UTC) #18

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

🤖 AI Code Review (Backend)

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

📊 По пакам

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

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

1. pronunciation_missing_conn

  • Файл: routers/pronunciation.py:12
  • Snippet: pool = await get_pool() async with pool.acquire() as conn: user = await conn.fetchrow(
  • Проблема: Раздел «Произношение» падает с NameError: name 'conn' is not defined — ученик не может получить слово
  • Как воспроизвести: GET /pronunciation/next → 500 NameError
  • Что сделать: Добавить async with pool.acquire() as conn: перед первым fetchrow
  • Confidence: 0.98

2. wordquiz_mistakes_never_reset_after_consolation 🔵 secondary

  • Файл: routers/wordquiz.py:175
  • Snippet: if mistakes >= 3: await conn.execute(""" INSERT INTO word_quiz_progress (user_id, wo
  • Проблема: после утешительных 10 очков current_mistakes не сбрасывается: все последующие правильные ответы дают минимум 10 очков (max(10, 50-mistakes*20)), а каждая ошибка даёт ещё +10 — бесконечный фарм очков и сломанная прогрессия
  • Как воспроизвести: дать 3 неверных ответа → +10; далее каждый неверный ответ снова +10, каждый верный — всегда 10 очков
  • Что сделать: в ветке mistakes >= 3 сбрасывать current_mistakes = 0 в том же UPSERT
  • Confidence: 0.92

3. hints_limit_race_condition 🔵 secondary

  • Файл: routers/hints.py:30
  • Snippet: if hints_already_used >= MAX_HINTS: raise HTTPException(403, "Hint limit reached")
  • Проблема: параллельные запросы подсказки проходят проверку лимита до инкремента → юзер получает больше 3 подсказок
  • Как воспроизвести: отправить 5 одновременных GET /hints/first-letter/{id} → все вернут 200, hints_used = 5
  • Что сделать: атомарный UPSERT с условием: INSERT ... ON CONFLICT DO UPDATE SET hints_used = hints_used + 1 WHERE user_progress.hints_used < 3, и проверять RETURNING hints_used
  • Confidence: 0.88

4. wordquiz_check_achievements_unbound

  • Файл: routers/wordquiz.py:200
  • Snippet: if is_correct: from routers.achievements import check_and_award_achievements new_achievements = []
  • Проблема: При правильном ответе, если ветка is_correct в БД не выполнялась (например, ошибка), achievements_to_check не определён → 500
  • Как воспроизвести: POST /wordquiz/check с корректным ответом → UnboundLocalError achievements_to_check
  • Что сделать: Инициализировать achievements_to_check = [] перед async with pool.acquire()
  • Confidence: 0.85

5. completion_time_type_error_500 🔵 secondary

  • Файл: routers/game.py:190
  • Snippet: if completion_time is not None and completion_time < 5: raise HTTPException(400, "Completion time too fast. Mini
  • Проблема: если клиент пришлёт completion_time строкой ("30") — TypeError, необработанный 500 вместо валидации
  • Как воспроизвести: POST /game/complete-level {"level_id": 1, "completion_time": "30"} → 500 Internal Server Error
  • Что сделать: валимировать тип: if not isinstance(completion_time, (int, float)) → 400, или использовать pydantic-модель
  • Confidence: 0.85

6. analytics_httpx_no_error_handling 🔵 secondary

  • Файл: routers/learning.py:690
  • Snippet: async with httpx.AsyncClient(timeout=90.0) as client: response = await client.post(
  • Проблема: При таймауте/сетевой ошибке httpx.ReadTimeout/ConnectError не перехвачен — ученик получает сырой 500 вместо понятного сообщения.
  • Как воспроизвести: недоступен api.together.xyz → POST /analytics → 500 Internal Server Error
  • Что сделать: try/except httpx.HTTPError → HTTPException(503, 'AI временно недоступен')
  • Confidence: 0.9

7. complete_session_replay_no_guard 🔵 secondary

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

  • Snippet: `if not session:
    raise HTTPException(404, "Session not found")

      await conn.execute("UPDATE learning_s`
    
  • Проблема: Повторный вызов complete_session по тому же session_id снова инкрементирует attempts_count и correct_count в user_lesson_progress и перезаписывает test_score — статистика ученика раздувается/искажается.

  • Как воспроизвести: дважды POST /learning/session/complete с тем же session_id → attempts_count = 2 при одном прохождении

  • Что сделать: Проверять session["is_completed"] и возвращать 409/идемпотентный ответ при повторе

  • Confidence: 0.88

8. analytics_ai_response_keyerror

  • Файл: routers/learning.py:720
  • Snippet: ai_response = data["choices"][0]["message"]["content"].strip()
  • Проблема: Если Together API вернёт 200 без choices (или с пустым массивом) — KeyError/IndexError → 500, ученик видит ошибку вместо аналитики
  • Как воспроизвести: замокать ответ API без choices → 500
  • Что сделать: Обернуть в try/except (KeyError, IndexError) и вернуть fallback-текст
  • Confidence: 0.85

9. analytics_httpx_no_exception_handling

  • Файл: routers/learning.py:700
  • Snippet: response = await client.post(
  • Проблема: При таймауте/сетевой ошибке httpx бросает исключение → 500 без понятного сообщения, ученик видит «Internal Server Error»
  • Как воспроизвести: отключить сеть → POST /learning/analytics → 500
  • Что сделать: Обернуть в try/except httpx.HTTPError и вернуть 503 с понятным текстом
  • Confidence: 0.85

10. topic_progress_counts_inactive_lessons 🔵 secondary

  • Файл: routers/learning.py:262
  • Snippet: lessons_completed = await conn.fetchval(""" SELECT COUNT(*) FROM user_lesson_progress WHERE user_id = $1 AND les
  • Проблема: Подзапрос не фильтрует is_active = TRUE (в отличие от lessons_total): завершённый деактивированный урок не входит в lessons_total, но входит в lessons_completed → lessons_completed > lessons_total.
  • Как воспроизвести: деактивировать урок, пройденный учеником → в теме completed=3, total=2
  • Что сделать: Добавить AND is_active = TRUE в подзапрос
  • Confidence: 0.85

11. resume_lesson_id_from_first_lesson_not_session

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

12. start_duplicate_active_session 🔵 secondary

  • Файл: routers/teacher.py:432
  • Snippet: session_id = await start_learning_session(conn, telegram_id, user_level, topic_id, "teacher_test")
  • Проблема: /teacher/start не проверяет незавершённую сессию — каждый вызов создаёт новую learning_sessions. Старые сессии висят is_completed=FALSE, /resume подхватывает последнюю, а ответы могут размазаться по разным сессиям
  • Как воспроизвести: начать урок → выйти → снова /start → вторая сессия; /resume вернёт новую с 0 вопроса, старая потеряна
  • Что сделать: перед созданием искать активную сессию (как в /resume) и продолжать её, либо закрывать предыдущую
  • Confidence: 0.85

13. phrase_of_day_ai_failure_uses_fallback_silently

  • Файл: routers/teacher.py:400
  • Snippet: if ai_response: # Парсим текстовый ответ построчно
  • Проблема: При сбое AI все пользователи на весь день получают одну и ту же захардкоженную фразу «Lepiej późno niż wcale»
  • Как воспроизвести: Отключить AI → GET /teacher/phrase-of-day → всегда одна и та же фраза, кэшируется на 24ч
  • Что сделать: Не кэшировать fallback в daily_phrases, либо использовать пул заранее подготовленных фраз
  • Confidence: 0.82

14. orchestrator_lesson_lookup_ignores_level 🔗 both

  • Файл: routers/orchestrator.py:47
  • Snippet: WHERE l.skill_tag = $1 AND l.is_active = TRUE ORDER BY l.order_number LIMIT 1
  • Проблема: ученик уровня B1 может получить повторение урока уровня A1, если skill_tag совпадает — несоответствие сложности
  • Как воспроизвести: skill_tag='greetings' есть в A1 и B1 → всегда берётся урок с минимальным order_number (A1)
  • Что сделать: добавить JOIN learning_topics и фильтр t.level_code = current_level (или ближайший доступный уровень)
  • Confidence: 0.83

15. orchestrator_weak_skill_ignores_retention

  • Файл: routers/orchestrator.py:78
  • Snippet: WHERE user_id = $1 AND mastery_score < 75 AND attempts_count >= 2 ORDER BY mastery_score ASC
  • Проблема: ученик с overdue-навыком, у которого mastery уже >= 75, никогда не получит повторение этого навыка — retention игнорируется
  • Как воспроизвести: навык с retention_status='overdue' и mastery_score=80 → шаг 1 не сработал (attempts<2), шаг 2 не сработал (mastery>=75) → ученик уходит на новый урок
  • Что сделать: в шаге 2 добавить OR retention_status IN ('needs_review','overdue') либо убрать фильтр attempts_count>=2 для overdue
  • Confidence: 0.82

16. not_in_null_trap 🔵 secondary

  • Файл: routers/orchestrator.py:130
  • 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' несмотря на непройденные уроки
  • Как воспроизвести: вставить строку с NULL lesson_id и completed=TRUE → get_next_lesson возвращает type='completed'
  • Что сделать: заменить на NOT EXISTS (SELECT 1 FROM user_lesson_progress p WHERE p.lesson_id = l.lesson_id AND p.user_id = $2 AND p.completed = TRUE)
  • Confidence: 0.8

17. feed_get_post_no_expires_check

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

18. admin_update_lesson_no_question_delete

  • Файл: routers/admin_content.py:0
  • Snippet: if not q_exists: raise HTTPException( 400,
  • Проблема: Если админ удалил вопрос в редакторе, он не удаляется из БД — ученик продолжает видеть удалённый вопрос в уроке
  • Как воспроизвести: админ удаляет вопрос в WYSIWYG → сохраняет → вопрос остаётся в learning_questions
  • Что сделать: Сравнить присланные question_id с существующими в уроке и DELETE отсутствующие (в той же транзакции)
  • Confidence: 0.85

19. rate_limit_shared_ip_bucket 🔵 secondary

  • Файл: main.py:262
  • Snippet: real_client_ip = request.client.host if request.client else "unknown"
  • Проблема: если приложение стоит за nginx/любым прокси, который не в списке CF_IPS, все пользователи получают один bucket 'real_client_ip' — лимит 60 req/min делится на всех учеников, у части игроков API начнёт отдавать 429
  • Как воспроизвести: развернуть за nginx без проброса реального IP → request.client.host = 127.0.0.1 для всех → все пользователи в одном bucket → 429 у части пользователей
  • Что сделать: добавить в конфиг доверенные прокси (TRUSTED_PROXIES) и разбирать X-Forwarded-For только с них; при 'unknown'/прокси-IP не класть всех в один bucket
  • Confidence: 0.75

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

20. wordquiz_check_trusts_client_correct_polish

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

21. complete_level_no_word_verification 🔵 secondary

  • Файл: routers/game.py:200
  • Snippet: if not level_id: raise HTTPException(400, "level_id required")
  • Проблема: уровень можно «завершить» одним запросом: сервер не проверяет, что слова реально найдены (check-word не обязателен), только completion_time >= 5
  • Как воспроизвести: POST /game/complete-level {level_id, completion_time: 6} без единого найденного слова → +100 очков, last_completed_level растёт
  • Что сделать: проверять на сервере, что все word_paths уровня были найдены через check-word (например, флаг found_words в user_progress), либо подписывать прогресс
  • Confidence: 0.9

22. update_skill_mastery_placeholder_mismatch

  • Файл: routers/learning.py:240
  • Snippet: VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, 0, $14, $15, $16, $17, $18, $19, $20, $21, $22, $23, $24
  • Проблема: Мастерство навыков считается неверно: retention_score всегда 0, а все последующие поля (hint_dependency, average_time_ms, mastery_score и т.д.) сдвинуты на одну позицию — в БД пишутся чужие значения
  • Как воспроизвести: пройти урок → в user_skill_mastery hint_dependency = avg_time_ms, mastery_score = previous_mastery и т.д.
  • Что сделать: В INSERT-части заменить литерал 0 на $14 и сдвинуть все последующие плейсхолдеры, либо явно перечислить колонки без retention_score
  • Confidence: 0.95

23. complete_session_no_transaction 🔗 both

  • Файл: routers/learning.py:560
  • Snippet: await conn.execute("UPDATE learning_sessions SET is_completed = TRUE, completed_at = NOW() WHERE id = $1", session_id)
  • Проблема: При падении на любом из последующих шагов (update_skill_mastery, update_topic_progress, update_ai_context) сессия уже помечена completed, а прогресс/мастерство не обновлены — ученик теряет результат урока
  • Как воспроизвести: искусственно уронить update_skill_mastery → сессия completed, user_lesson_progress не обновлён
  • Что сделать: Обернуть весь блок в async with conn.transaction(): — либо перенести UPDATE learning_sessions в самый конец
  • Confidence: 0.9

24. analytics_no_rate_limit_expensive_llm 🔵 secondary

  • Файл: routers/learning.py:610
  • Snippet: @router.post("/analytics") async def get_analytics(request: Request): """Анализирует результаты пользователя через A
  • Проблема: Аутентифицированный пользователь может бесконечно дёргать платный LLM-вызов (timeout 90s, 1000 tokens) — неконтролируемые расходы API.
  • Как воспроизвести: цикл POST /learning/analytics → каждый вызов бьёт Together API
  • Что сделать: Добавить rate-limit / кэширование результата по user_id + last_analysis_at
  • Confidence: 0.85

25. save_answer_no_question_session_match 🔵 secondary

  • Файл: routers/learning.py:452
  • Snippet: question = await conn.fetchrow("SELECT * FROM learning_questions WHERE question_id = $1", question_id) if not qu
  • Проблема: Вопрос не проверяется на принадлежность сессии (topic/lesson): клиент может записать в сессию ответы на любые вопросы из базы, искажая mastery и статистику темы.
  • Как воспроизвести: POST /answer с session_id своей сессии и question_id из другой темы → ответ сохраняется
  • Что сделать: Проверить, что question.topic_id/lesson_id соответствует session
  • Confidence: 0.85

26. ai_limit_race_condition

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

27. admin_update_lesson_no_examples_audio_preserved

  • Файл: routers/admin_content.py:0
  • Snippet: INSERT INTO lesson_examples (lesson_id, order_number, text_pl, text_ru, text_uk, text_en)
  • Проблема: DELETE+INSERT примеров теряет audio_url — ученик больше не слышит озвучку примеров после любой правки урока
  • Как воспроизвести: админ правит title урока → все примеры пересоздаются без audio_url
  • Что сделать: Либо сохранять audio_url при пересоздании (передавать в INSERT), либо делать UPSERT по id вместо DELETE+INSERT
  • Confidence: 0.83

28. admin_update_word_updates_all_levels

  • Файл: routers/admin_content.py:0
  • Snippet: WHERE level = $5 AND word_pl = $6
  • Проблема: При переименовании слова в админке массово перезаписываются переводы всех строк с тем же word_pl в уровне, включая привязки к игровым уровням Филвордов — ученик видит чужой перевод в игре
  • Как воспроизвести: админ меняет перевод слова 'kot' в A1 → все строки level_words с level='A1' AND word_pl='kot' (включая level_id != NULL) получают новый перевод
  • Что сделать: Обновлять по id, либо явно разделить: UPDATE ... WHERE id=$1 для чистой строки + отдельный UPDATE для level_id IS NOT NULL с явным подтверждением
  • Confidence: 0.82

29. admin_update_word_no_unique_check

  • Файл: routers/admin_content.py:0
  • Snippet: UPDATE level_words SET word_pl = $1,
  • Проблема: При переименовании слова в уже существующее в уровне создаётся дубликат — в Word Quiz ученик видит два одинаковых слова
  • Как воспроизвести: в A1 есть 'kot' и 'pies'; админ переименовывает 'pies' → 'kot'; теперь два 'kot' в A1
  • Что сделать: Перед UPDATE проверить SELECT 1 FROM level_words WHERE level=$1 AND level_id IS NULL AND LOWER(word_pl)=LOWER($2) AND id != $word_id
  • Confidence: 0.8

30. feed_upload_image_no_magic_bytes_check

  • Файл: routers/feed.py:0
  • Snippet: content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:
  • Проблема: Проверка только по Content-Type из заголовка — можно загрузить HTML/JS под видом image/png, файл отдаётся с публичного URL
  • Как воспроизвести: curl -F 'file=@evil.html;type=image/png' /admin/feed/upload-image → файл сохранён как .png, но содержимое HTML
  • Что сделать: Проверять magic bytes (imghdr/Pillow) перед сохранением; отдавать uploads с Content-Disposition: attachment или X-Content-Type-Options: nosniff
  • Confidence: 0.8

31. save_analytics_no_limit 🔵 secondary

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

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

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

  • Проблема: Нет ограничения длины и частоты: можно записать в chat_history сообщение любой длины и под видом assistant-роли — раздувание БД и подмена контекста будущих ответов AI

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

  • Что сделать: Добавить len(message) <= 500 и rate-limit как в /chat

  • Confidence: 0.88

32. tts_cache_unbounded 🔵 secondary

  • Файл: routers/tts.py:27
  • Snippet: CACHE_DIR = "/root/filwordspl/backend/tts_cache" os.makedirs(CACHE_DIR, exist_ok=True)
  • Проблема: Кэш растёт неограниченно: уникальных текстов до 500 символов может быть миллионы → переполнение диска и отказ сервиса
  • Как воспроизвести: Скриптом запросить TTS для 100k уникальных строк → 100k mp3-файлов на диске без очистки
  • Что сделать: Периодическая очистка по mtime (LRU) или лимит размера директории
  • Confidence: 0.85

33. assistant_race_daily_limit 🔗 both

  • Файл: routers/assistant.py:168
  • Snippet: daily_usage = await get_daily_usage(telegram_id) if daily_usage >= FREE_DAILY_LIMIT:
  • Проблема: при параллельных запросах лимит можно превысить (TOCTOU)
  • Как воспроизвести: отправить 5 запросов одновременно при used=4 → все пройдут проверку
  • Что сделать: использовать атомарный INSERT ... ON CONFLICT ... WHERE message_count < LIMIT RETURNING, либо SELECT FOR UPDATE
  • Confidence: 0.84

34. tts_no_rate_limit

  • Файл: routers/tts.py:38
  • Snippet: async def text_to_speech(request: Request, text: str = "", voice: str = "male"):
  • Проблема: злоумышленник может забить диск кэшем и нагрузить CPU синтезом
  • Как воспроизвести: цикл GET /tts?text= → каждый уникальный текст создаёт mp3-файл на диске
  • Что сделать: добавить rate-limit по user_id (например, 60 запросов/мин) и лимит размера кэша с LRU-очисткой
  • Confidence: 0.82

35. rate_limiter_memory_leak_unbounded_keys

  • Файл: main.py:88
  • Snippet: self.requests[key] = [t for t in self.requests[key] if now - t < window]
  • Проблема: при большом числе уникальных IP:path словарь requests растёт, память утекает, сервис может упасть (502/504 у всех учеников)
  • Как воспроизвести: нагрузить API с разных IP → defaultdict накапливает ключи, cleanup раз в 60с не успевает
  • Что сделать: использовать TTL-кэш (cachetools.TTLCache) или Redis; ограничить размер словаря
  • Confidence: 0.8

36. rate_limit_path_exact_match_bypass 🔗 both

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

37. auth_query_param_initdata_leak

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

38. auth_no_replay_protection

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

39. init_db_transaction_ddl_lock_risk

  • Файл: database.py:22
  • Snippet: async with conn.transaction():
  • Проблема: вся инициализация в одной транзакции с ALTER TABLE/DROP CONSTRAINT держит ACCESS EXCLUSIVE locks — при рестарте под нагрузкой API зависает для всех учеников
  • Как воспроизвести: рестарт backend при активных запросах → блокировки на users/levels → таймауты
  • Что сделать: разнести миграции и CREATE TABLE; использовать advisory lock и отдельные транзакции на миграцию
  • Confidence: 0.8

40. init_db_drop_constraint_no_cascade_orphan_fk

  • Файл: database.py:130
  • Snippet: ALTER TABLE user_progress DROP CONSTRAINT IF EXISTS user_progress_user_id_fkey
  • Проблема: если на user_progress.user_id ссылаются другие FK (не перечисленные), миграция упадёт и БД останется в промежуточном состоянии — прогресс учеников недоступен
  • Как воспроизвести: наличие внешнего FK на user_progress.user_id → ALTER COLUMN TYPE BIGINT падает
  • Что сделать: перед ALTER TYPE явно находить и пересоздавать все зависимые FK через pg_constraint
  • Confidence: 0.77

41. leaderboard_matview_refresh_concurrently_no_unique_guard

  • Файл: main.py:130
  • Snippet: await conn.execute("REFRESH MATERIALIZED VIEW CONCURRENTLY leaderboard_cache")
  • Проблема: если unique index не создан (например, упал CREATE INDEX на старте), REFRESH CONCURRENTLY падает каждые 5 мин — рейтинг у учеников замораживается
  • Как воспроизвести: удалить idx_leaderboard_cache_user → refresh loop логирует ошибки, рейтинг не обновляется
  • Что сделать: проверять наличие unique index перед refresh или использовать REFRESH без CONCURRENTLY как fallback
  • Confidence: 0.76

42. initdata_in_query_param 🔵 secondary

  • Файл: auth.py:100
  • Snippet: if not init_data: init_data = request.query_params.get('initData', '')
  • Проблема: initData (валидный credential на 4 часа) попадает в access-логи nginx/Cloudflare, browser history и Sentry breadcrumbs — утечка токена авторизации, replay-атака от имени ученика
  • Как воспроизвести: вызвать любой эндпоинт с ?initData=... → токен сохраняется в access-log прокси и в URL, который виден в истории/логах
  • Что сделать: принимать initData только из заголовков; для deleteFeedPost передавать initData в теле POST или отдельным заголовком, а не в query
  • Confidence: 0.85

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

43. game_progress_n_plus_1_scores 🔗 both

  • Файл: routers/game.py:30
  • Snippet: wordsearch_score = await conn.fetchval( "SELECT COALESCE(SUM(score), 0) FROM user_progress WHERE user_id = $
  • Проблема: 4 последовательных запроса вместо одного UNION — медленнее на больших данных
  • Как воспроизвести: GET /game/progress → 4 round-trip к БД
  • Что сделать: Объединить в один запрос с UNION ALL или CTE
  • Confidence: 0.9

44. questions_options_duplication 🔵 secondary

  • Файл: routers/orchestrator.py:168
  • Snippet: question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids:
  • Проблема: Одинаковый блок загрузки options + группировки скопирован трижды (get_lesson_by_id, get_lesson_questions, get_test_questions) — правка в одном месте разъедется с остальными
  • Как воспроизвести: сравнить тела трёх функций — идентичный код ~15 строк × 3
  • Что сделать: вынести в хелпер fetch_questions_with_options(conn, where_clause, params)
  • Confidence: 0.95

45. orchestrator_duplicate_options_query

  • Файл: routers/orchestrator.py:175
  • Snippet: async def get_lesson_questions(conn, lesson_id: str) -> list: """Получает только вопросы урока (без объяснения)."""
  • Проблема: нет прямого эффекта, но при расхождении логики в трёх копиях ученик может увидеть разные наборы опций в уроке и тесте
  • Как воспроизвести: изменить формат options в get_lesson_by_id, забыть про get_lesson_questions/get_test_questions → рассинхрон
  • Что сделать: вынести общий хелпер _load_questions_with_options(conn, where_sql, params) и переиспользовать в трёх функциях
  • Confidence: 0.9

46. orchestrator_random_order_by

  • Файл: routers/orchestrator.py:232
  • Snippet: WHERE reaction_type = $1 ORDER BY RANDOM() LIMIT 1
  • Проблема: при большом банке реакций каждый ответ учителя делает full scan — заметная задержка в чате
  • Как воспроизвести: teacher_reactions с 10k строк → ORDER BY RANDOM() сканирует всю таблицу на каждый ответ
  • Что сделать: использовать TABLESAMPLE SYSTEM или предзагружать банк в память с random.choice
  • Confidence: 0.85

47. select_star_lessons 🔵 secondary

  • Файл: routers/orchestrator.py:96
  • Snippet: SELECT * FROM learning_lessons WHERE lesson_id = $1 AND is_active = TRUE
  • Проблема: SELECT * втягивает все колонки (включая тяжёлые/служебные) в ответ урока, который уходит дальше по коду; изменение схемы тихо меняет API-ответ
  • Как воспроизвести: добавить колонку в learning_lessons → она появится в payload урока
  • Что сделать: явный список колонок
  • Confidence: 0.85

48. orchestrator_not_in_subquery_perf

  • Файл: routers/orchestrator.py:138
  • Snippet: AND l.lesson_id NOT IN ( SELECT lesson_id FROM user_lesson_progress WHERE user_id = $2 AND
  • Проблема: при росте user_lesson_progress запрос деградирует, ученик ждёт ответа чата дольше
  • Как воспроизвести: 10k+ записей прогресса → seq scan на NOT IN, latency растёт
  • Что сделать: заменить на NOT EXISTS или LEFT JOIN ... IS NULL, добавить индекс (user_id, completed, lesson_id)
  • Confidence: 0.8

49. profile_get_profile_hash_decimal_only

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

50. tts_blocking_io 🔵 secondary

  • Файл: routers/tts.py:62
  • Snippet: with open(cache_path, 'rb') as f: return Response(
  • Проблема: Блокирующие file I/O (open/read/write) в async-хендлере блокируют event loop → лаги всех запросов при медленном диске/больших файлах
  • Как воспроизвести: Много одновременных TTS-запросов с cache miss → рост латентности всего API
  • Что сделать: Использовать aiofiles или anyio.to_thread.run_sync для чтения/записи кэша
  • Confidence: 0.9

51. admin_stats_duplicated 🔵 secondary

  • Файл: routers/assistant.py:330
  • Snippet: total_users = await conn.fetchval("SELECT COUNT(*) FROM users") or 0 new_today = await conn.fetchval("SELECT COU
  • Проблема: Код админ-статистики (total_users, new_today, online_now, level_counts) полностью дублируется между routers/leaderboard.py:/admin/stats и routers/assistant.py:/stats/admin — правки придётся делать в двух местах
  • Как воспроизвести: Сравнить get_admin_stats в leaderboard.py и assistant.py — идентичные SQL-блоки
  • Что сделать: Вынести общие запросы в общий сервисный модуль/функцию
  • Confidence: 0.9

52. achievements_track_endpoints_duplication

  • Файл: routers/achievements.py:300
  • Snippet: @router.post("/track-teacher-menu") async def track_teacher_menu_opened(request: Request): """Отмечает открытие меню
  • Проблема: нет UX-эффекта, но 7 почти идентичных эндпоинтов
  • Как воспроизвести: grep track-* → 7 функций с одинаковым телом, отличаются только achievement_type
  • Что сделать: один эндпоинт POST /track/{event} с валидацией event по whitelist
  • Confidence: 0.88

53. leaderboard_duplicate_cache_query

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

54. leaderboard_zero_fields 🔵 secondary

  • Файл: routers/leaderboard.py:47
  • Snippet: "levels_completed": 0, "sentences_completed": 0,
  • Проблема: В записях лидерборда levels_completed и sentences_completed всегда 0 — клиент получает фиктивные данные для других игроков
  • Как воспроизвести: GET /leaderboard → у всех игроков levels_completed=0 независимо от прогресса
  • Что сделать: Либо убрать поля, либо добавить их в leaderboard_cache при REFRESH
  • Confidence: 0.85

55. rate_limit_key_includes_path_double_count

  • Файл: main.py:200
  • Snippet: rate_key = f"{client_ip}:{path}"
  • Проблема: лимит 'default' фактически применяется per-path, а не per-IP — ученик может обойти общий лимит, чередуя эндпоинты
  • Как воспроизвести: 60 запросов на /a + 60 на /b — оба проходят, хотя default=60/мин на IP
  • Что сделать: для default использовать ключ только по IP, для специфичных — IP:path
  • Confidence: 0.78

56. cors_allow_credentials_false_with_auth_header

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

57. health_endpoint_no_rate_limit_info_leak

  • Файл: main.py:320
  • Snippet: return {"status": "ok", "database": "connected"}
  • Проблема: публичный /health раскрывает состояние БД без авторизации — упрощает разведку для атакующего
  • Как воспроизвести: curl /health → видно connected/disconnected
  • Что сделать: ограничить /health по IP или возвращать только 200/503 без деталей
  • Confidence: 0.76

58. init_db_ddl_every_startup 🔵 secondary

  • Файл: database.py:20
  • Snippet: async with conn.transaction(): # ============ users ============ await conn.execute("""
  • Проблема: каждый рестарт выполняет ~100 DDL-операций (CREATE/ALTER/DROP INDEX/DO-блоки) с ACCESS EXCLUSIVE локами; на больших таблицах ALTER/индексы блокируют запросы учеников, деплой зависает
  • Как воспроизвести: рестарт приложения на проде с большой user_learning_answers → транзакция init_db держит локи, /game/* запросы висят до завершения
  • Что сделать: вынести схему в миграции (alembic/версионированные SQL-файлы), init_db оставить только для create_pool
  • Confidence: 0.9

59. learning_tables_no_user_fk 🔵 secondary

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

60. uploads_dir_hardcoded_root 🔵 secondary

  • Файл: config.py:96
  • Snippet: UPLOADS_DIR = os.getenv("UPLOADS_DIR", "/root/filwordspl/backend/uploads")
  • Проблема: дефолт привязан к конкретному пути /root/... — при запуске в контейнере/другом пользователе папка создаётся в неожиданном месте (os.makedirs в момент импорта), загруженные картинки пропадают после редеплоя
  • Как воспроизвести: запустить backend не от root без UPLOADS_DIR → создаётся /root/... от текущего пользователя (или PermissionError), смонтированные файлы теряются при деплое
  • Что сделать: дефолт — относительный Path(file).parent / 'uploads'; убрать makedirs из config в lifespan
  • Confidence: 0.78

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

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

# 🤖 AI Code Review (Backend) **Дата:** 2026-09-25 20:00 UTC **Модели:** `deepseek-ai/DeepSeek-V4.1-Flash` + `zai-org/GLM-5.3-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` ## 📊 По пакам - **routers_games** — 7 файлов, 65,802 символов, находок=8 - **routers_learning_core** — 1 файлов, 40,548 символов, находок=9 - **routers_learning_teacher** — 1 файлов, 47,356 символов, находок=4 - **routers_learning_orch** — 2 файлов, 12,293 символов, находок=9 - **routers_admin** — 4 файлов, 97,143 символов, находок=6 - **routers_misc** — 5 файлов, 69,714 символов, находок=9 - **core** — 4 файлов, 69,897 символов, находок=15 - **services** — 0 файлов, 0 символов, находок=0 --- ## 🔴 Влияет на ученика (19) ### 1. pronunciation_missing_conn - **Файл:** `routers/pronunciation.py:12` - **Snippet:** `pool = await get_pool() async with pool.acquire() as conn: user = await conn.fetchrow(` - **Проблема:** Раздел «Произношение» падает с NameError: name 'conn' is not defined — ученик не может получить слово - **Как воспроизвести:** GET /pronunciation/next → 500 NameError - **Что сделать:** Добавить `async with pool.acquire() as conn:` перед первым fetchrow - **Confidence:** 0.98 ### 2. wordquiz_mistakes_never_reset_after_consolation 🔵 secondary - **Файл:** `routers/wordquiz.py:175` - **Snippet:** `if mistakes >= 3: await conn.execute(""" INSERT INTO word_quiz_progress (user_id, wo` - **Проблема:** после утешительных 10 очков current_mistakes не сбрасывается: все последующие правильные ответы дают минимум 10 очков (max(10, 50-mistakes*20)), а каждая ошибка даёт ещё +10 — бесконечный фарм очков и сломанная прогрессия - **Как воспроизвести:** дать 3 неверных ответа → +10; далее каждый неверный ответ снова +10, каждый верный — всегда 10 очков - **Что сделать:** в ветке mistakes >= 3 сбрасывать current_mistakes = 0 в том же UPSERT - **Confidence:** 0.92 ### 3. hints_limit_race_condition 🔵 secondary - **Файл:** `routers/hints.py:30` - **Snippet:** `if hints_already_used >= MAX_HINTS: raise HTTPException(403, "Hint limit reached")` - **Проблема:** параллельные запросы подсказки проходят проверку лимита до инкремента → юзер получает больше 3 подсказок - **Как воспроизвести:** отправить 5 одновременных GET /hints/first-letter/{id} → все вернут 200, hints_used = 5 - **Что сделать:** атомарный UPSERT с условием: INSERT ... ON CONFLICT DO UPDATE SET hints_used = hints_used + 1 WHERE user_progress.hints_used < 3, и проверять RETURNING hints_used - **Confidence:** 0.88 ### 4. wordquiz_check_achievements_unbound - **Файл:** `routers/wordquiz.py:200` - **Snippet:** `if is_correct: from routers.achievements import check_and_award_achievements new_achievements = [] ` - **Проблема:** При правильном ответе, если ветка is_correct в БД не выполнялась (например, ошибка), achievements_to_check не определён → 500 - **Как воспроизвести:** POST /wordquiz/check с корректным ответом → UnboundLocalError achievements_to_check - **Что сделать:** Инициализировать achievements_to_check = [] перед async with pool.acquire() - **Confidence:** 0.85 ### 5. completion_time_type_error_500 🔵 secondary - **Файл:** `routers/game.py:190` - **Snippet:** `if completion_time is not None and completion_time < 5: raise HTTPException(400, "Completion time too fast. Mini` - **Проблема:** если клиент пришлёт completion_time строкой ("30") — TypeError, необработанный 500 вместо валидации - **Как воспроизвести:** POST /game/complete-level {"level_id": 1, "completion_time": "30"} → 500 Internal Server Error - **Что сделать:** валимировать тип: if not isinstance(completion_time, (int, float)) → 400, или использовать pydantic-модель - **Confidence:** 0.85 ### 6. analytics_httpx_no_error_handling 🔵 secondary - **Файл:** `routers/learning.py:690` - **Snippet:** `async with httpx.AsyncClient(timeout=90.0) as client: response = await client.post(` - **Проблема:** При таймауте/сетевой ошибке httpx.ReadTimeout/ConnectError не перехвачен — ученик получает сырой 500 вместо понятного сообщения. - **Как воспроизвести:** недоступен api.together.xyz → POST /analytics → 500 Internal Server Error - **Что сделать:** try/except httpx.HTTPError → HTTPException(503, 'AI временно недоступен') - **Confidence:** 0.9 ### 7. complete_session_replay_no_guard 🔵 secondary - **Файл:** `routers/learning.py:516` - **Snippet:** `if not session: raise HTTPException(404, "Session not found") await conn.execute("UPDATE learning_s` - **Проблема:** Повторный вызов complete_session по тому же session_id снова инкрементирует attempts_count и correct_count в user_lesson_progress и перезаписывает test_score — статистика ученика раздувается/искажается. - **Как воспроизвести:** дважды POST /learning/session/complete с тем же session_id → attempts_count = 2 при одном прохождении - **Что сделать:** Проверять session["is_completed"] и возвращать 409/идемпотентный ответ при повторе - **Confidence:** 0.88 ### 8. analytics_ai_response_keyerror - **Файл:** `routers/learning.py:720` - **Snippet:** `ai_response = data["choices"][0]["message"]["content"].strip()` - **Проблема:** Если Together API вернёт 200 без choices (или с пустым массивом) — KeyError/IndexError → 500, ученик видит ошибку вместо аналитики - **Как воспроизвести:** замокать ответ API без choices → 500 - **Что сделать:** Обернуть в try/except (KeyError, IndexError) и вернуть fallback-текст - **Confidence:** 0.85 ### 9. analytics_httpx_no_exception_handling - **Файл:** `routers/learning.py:700` - **Snippet:** `response = await client.post(` - **Проблема:** При таймауте/сетевой ошибке httpx бросает исключение → 500 без понятного сообщения, ученик видит «Internal Server Error» - **Как воспроизвести:** отключить сеть → POST /learning/analytics → 500 - **Что сделать:** Обернуть в try/except httpx.HTTPError и вернуть 503 с понятным текстом - **Confidence:** 0.85 ### 10. topic_progress_counts_inactive_lessons 🔵 secondary - **Файл:** `routers/learning.py:262` - **Snippet:** `lessons_completed = await conn.fetchval(""" SELECT COUNT(*) FROM user_lesson_progress WHERE user_id = $1 AND les` - **Проблема:** Подзапрос не фильтрует is_active = TRUE (в отличие от lessons_total): завершённый деактивированный урок не входит в lessons_total, но входит в lessons_completed → lessons_completed > lessons_total. - **Как воспроизвести:** деактивировать урок, пройденный учеником → в теме completed=3, total=2 - **Что сделать:** Добавить AND is_active = TRUE в подзапрос - **Confidence:** 0.85 ### 11. resume_lesson_id_from_first_lesson_not_session - **Файл:** `routers/teacher.py:470` - **Snippet:** `lesson_id = await conn.fetchval(""" SELECT lesson_id FROM learning_lessons WHERE` - **Проблема:** Если ученик был на 3-м уроке темы, /resume вернёт вопросы 1-го урока — прогресс сессии теряется - **Как воспроизвести:** Начать урок 3 темы → прервать → POST /teacher/resume → вопросы урока 1 - **Что сделать:** Хранить lesson_id в learning_sessions или брать из user_learning_answers по session_id - **Confidence:** 0.85 ### 12. start_duplicate_active_session 🔵 secondary - **Файл:** `routers/teacher.py:432` - **Snippet:** `session_id = await start_learning_session(conn, telegram_id, user_level, topic_id, "teacher_test")` - **Проблема:** /teacher/start не проверяет незавершённую сессию — каждый вызов создаёт новую learning_sessions. Старые сессии висят is_completed=FALSE, /resume подхватывает последнюю, а ответы могут размазаться по разным сессиям - **Как воспроизвести:** начать урок → выйти → снова /start → вторая сессия; /resume вернёт новую с 0 вопроса, старая потеряна - **Что сделать:** перед созданием искать активную сессию (как в /resume) и продолжать её, либо закрывать предыдущую - **Confidence:** 0.85 ### 13. phrase_of_day_ai_failure_uses_fallback_silently - **Файл:** `routers/teacher.py:400` - **Snippet:** `if ai_response: # Парсим текстовый ответ построчно` - **Проблема:** При сбое AI все пользователи на весь день получают одну и ту же захардкоженную фразу «Lepiej późno niż wcale» - **Как воспроизвести:** Отключить AI → GET /teacher/phrase-of-day → всегда одна и та же фраза, кэшируется на 24ч - **Что сделать:** Не кэшировать fallback в daily_phrases, либо использовать пул заранее подготовленных фраз - **Confidence:** 0.82 ### 14. orchestrator_lesson_lookup_ignores_level 🔗 both - **Файл:** `routers/orchestrator.py:47` - **Snippet:** `WHERE l.skill_tag = $1 AND l.is_active = TRUE ORDER BY l.order_number LIMIT 1` - **Проблема:** ученик уровня B1 может получить повторение урока уровня A1, если skill_tag совпадает — несоответствие сложности - **Как воспроизвести:** skill_tag='greetings' есть в A1 и B1 → всегда берётся урок с минимальным order_number (A1) - **Что сделать:** добавить JOIN learning_topics и фильтр t.level_code = current_level (или ближайший доступный уровень) - **Confidence:** 0.83 ### 15. orchestrator_weak_skill_ignores_retention - **Файл:** `routers/orchestrator.py:78` - **Snippet:** `WHERE user_id = $1 AND mastery_score < 75 AND attempts_count >= 2 ORDER BY mastery_score ASC` - **Проблема:** ученик с overdue-навыком, у которого mastery уже >= 75, никогда не получит повторение этого навыка — retention игнорируется - **Как воспроизвести:** навык с retention_status='overdue' и mastery_score=80 → шаг 1 не сработал (attempts<2), шаг 2 не сработал (mastery>=75) → ученик уходит на новый урок - **Что сделать:** в шаге 2 добавить OR retention_status IN ('needs_review','overdue') либо убрать фильтр attempts_count>=2 для overdue - **Confidence:** 0.82 ### 16. not_in_null_trap 🔵 secondary - **Файл:** `routers/orchestrator.py:130` - **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' несмотря на непройденные уроки - **Как воспроизвести:** вставить строку с NULL lesson_id и completed=TRUE → get_next_lesson возвращает type='completed' - **Что сделать:** заменить на NOT EXISTS (SELECT 1 FROM user_lesson_progress p WHERE p.lesson_id = l.lesson_id AND p.user_id = $2 AND p.completed = TRUE) - **Confidence:** 0.8 ### 17. feed_get_post_no_expires_check - **Файл:** `routers/feed.py:0` - **Snippet:** `SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE` - **Проблема:** Истёкший пост (expires_at < NOW()) не отдаётся в списке, но доступен по прямой ссылке /feed/post/{id} — ученик видит просроченную акцию партнёра - **Как воспроизвести:** GET /feed/post/123 для поста с expires_at в прошлом → 200 OK вместо 404 - **Что сделать:** Добавить AND (expires_at IS NULL OR expires_at > NOW()) в запрос - **Confidence:** 0.88 ### 18. admin_update_lesson_no_question_delete - **Файл:** `routers/admin_content.py:0` - **Snippet:** `if not q_exists: raise HTTPException( 400,` - **Проблема:** Если админ удалил вопрос в редакторе, он не удаляется из БД — ученик продолжает видеть удалённый вопрос в уроке - **Как воспроизвести:** админ удаляет вопрос в WYSIWYG → сохраняет → вопрос остаётся в learning_questions - **Что сделать:** Сравнить присланные question_id с существующими в уроке и DELETE отсутствующие (в той же транзакции) - **Confidence:** 0.85 ### 19. rate_limit_shared_ip_bucket 🔵 secondary - **Файл:** `main.py:262` - **Snippet:** `real_client_ip = request.client.host if request.client else "unknown"` - **Проблема:** если приложение стоит за nginx/любым прокси, который не в списке CF_IPS, все пользователи получают один bucket 'real_client_ip' — лимит 60 req/min делится на всех учеников, у части игроков API начнёт отдавать 429 - **Как воспроизвести:** развернуть за nginx без проброса реального IP → request.client.host = 127.0.0.1 для всех → все пользователи в одном bucket → 429 у части пользователей - **Что сделать:** добавить в конфиг доверенные прокси (TRUSTED_PROXIES) и разбирать X-Forwarded-For только с них; при 'unknown'/прокси-IP не класть всех в один bucket - **Confidence:** 0.75 ## 🟠 Риск для данных (23) ### 20. wordquiz_check_trusts_client_correct_polish - **Файл:** `routers/wordquiz.py:155` - **Snippet:** `correct_polish = body.get("correct_polish", "") user_answer = body.get("answer", "")` - **Проблема:** Клиент сам присылает правильный ответ — можно накрутить очки, отправив correct_polish=answer - **Как воспроизвести:** POST /wordquiz/check {correct_polish:'x', answer:'x'} → +50 очков без реального ответа - **Что сделать:** Хранить правильный ответ на сервере (в word_quiz_progress или отдельной таблице), не доверять клиенту - **Confidence:** 0.9 ### 21. complete_level_no_word_verification 🔵 secondary - **Файл:** `routers/game.py:200` - **Snippet:** `if not level_id: raise HTTPException(400, "level_id required")` - **Проблема:** уровень можно «завершить» одним запросом: сервер не проверяет, что слова реально найдены (check-word не обязателен), только completion_time >= 5 - **Как воспроизвести:** POST /game/complete-level {level_id, completion_time: 6} без единого найденного слова → +100 очков, last_completed_level растёт - **Что сделать:** проверять на сервере, что все word_paths уровня были найдены через check-word (например, флаг found_words в user_progress), либо подписывать прогресс - **Confidence:** 0.9 ### 22. update_skill_mastery_placeholder_mismatch - **Файл:** `routers/learning.py:240` - **Snippet:** `VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, 0, $14, $15, $16, $17, $18, $19, $20, $21, $22, $23, $24` - **Проблема:** Мастерство навыков считается неверно: retention_score всегда 0, а все последующие поля (hint_dependency, average_time_ms, mastery_score и т.д.) сдвинуты на одну позицию — в БД пишутся чужие значения - **Как воспроизвести:** пройти урок → в user_skill_mastery hint_dependency = avg_time_ms, mastery_score = previous_mastery и т.д. - **Что сделать:** В INSERT-части заменить литерал 0 на $14 и сдвинуть все последующие плейсхолдеры, либо явно перечислить колонки без retention_score - **Confidence:** 0.95 ### 23. complete_session_no_transaction 🔗 both - **Файл:** `routers/learning.py:560` - **Snippet:** `await conn.execute("UPDATE learning_sessions SET is_completed = TRUE, completed_at = NOW() WHERE id = $1", session_id)` - **Проблема:** При падении на любом из последующих шагов (update_skill_mastery, update_topic_progress, update_ai_context) сессия уже помечена completed, а прогресс/мастерство не обновлены — ученик теряет результат урока - **Как воспроизвести:** искусственно уронить update_skill_mastery → сессия completed, user_lesson_progress не обновлён - **Что сделать:** Обернуть весь блок в async with conn.transaction(): — либо перенести UPDATE learning_sessions в самый конец - **Confidence:** 0.9 ### 24. analytics_no_rate_limit_expensive_llm 🔵 secondary - **Файл:** `routers/learning.py:610` - **Snippet:** `@router.post("/analytics") async def get_analytics(request: Request): """Анализирует результаты пользователя через A` - **Проблема:** Аутентифицированный пользователь может бесконечно дёргать платный LLM-вызов (timeout 90s, 1000 tokens) — неконтролируемые расходы API. - **Как воспроизвести:** цикл POST /learning/analytics → каждый вызов бьёт Together API - **Что сделать:** Добавить rate-limit / кэширование результата по user_id + last_analysis_at - **Confidence:** 0.85 ### 25. save_answer_no_question_session_match 🔵 secondary - **Файл:** `routers/learning.py:452` - **Snippet:** `question = await conn.fetchrow("SELECT * FROM learning_questions WHERE question_id = $1", question_id) if not qu` - **Проблема:** Вопрос не проверяется на принадлежность сессии (topic/lesson): клиент может записать в сессию ответы на любые вопросы из базы, искажая mastery и статистику темы. - **Как воспроизвести:** POST /answer с session_id своей сессии и question_id из другой темы → ответ сохраняется - **Что сделать:** Проверить, что question.topic_id/lesson_id соответствует session - **Confidence:** 0.85 ### 26. ai_limit_race_condition - **Файл:** `routers/teacher.py:165` - **Snippet:** `if not await check_ai_limit(conn, telegram_id): return get_ai_limit_message(lang)` - **Проблема:** Ученик может превысить дневной лимит AI-команд: параллельные запросы проходят проверку до инкремента - **Как воспроизвести:** Отправить 5+ параллельных POST /teacher/explain — все пройдут check_ai_limit, счётчик вырастет после - **Что сделать:** Атомарно: INSERT ... ON CONFLICT DO UPDATE SET command_count = command_count + 1 WHERE command_count < LIMIT RETURNING command_count, либо SELECT FOR UPDATE - **Confidence:** 0.85 ### 27. admin_update_lesson_no_examples_audio_preserved - **Файл:** `routers/admin_content.py:0` - **Snippet:** `INSERT INTO lesson_examples (lesson_id, order_number, text_pl, text_ru, text_uk, text_en)` - **Проблема:** DELETE+INSERT примеров теряет audio_url — ученик больше не слышит озвучку примеров после любой правки урока - **Как воспроизвести:** админ правит title урока → все примеры пересоздаются без audio_url - **Что сделать:** Либо сохранять audio_url при пересоздании (передавать в INSERT), либо делать UPSERT по id вместо DELETE+INSERT - **Confidence:** 0.83 ### 28. admin_update_word_updates_all_levels - **Файл:** `routers/admin_content.py:0` - **Snippet:** `WHERE level = $5 AND word_pl = $6` - **Проблема:** При переименовании слова в админке массово перезаписываются переводы всех строк с тем же word_pl в уровне, включая привязки к игровым уровням Филвордов — ученик видит чужой перевод в игре - **Как воспроизвести:** админ меняет перевод слова 'kot' в A1 → все строки level_words с level='A1' AND word_pl='kot' (включая level_id != NULL) получают новый перевод - **Что сделать:** Обновлять по id, либо явно разделить: UPDATE ... WHERE id=$1 для чистой строки + отдельный UPDATE для level_id IS NOT NULL с явным подтверждением - **Confidence:** 0.82 ### 29. admin_update_word_no_unique_check - **Файл:** `routers/admin_content.py:0` - **Snippet:** `UPDATE level_words SET word_pl = $1,` - **Проблема:** При переименовании слова в уже существующее в уровне создаётся дубликат — в Word Quiz ученик видит два одинаковых слова - **Как воспроизвести:** в A1 есть 'kot' и 'pies'; админ переименовывает 'pies' → 'kot'; теперь два 'kot' в A1 - **Что сделать:** Перед UPDATE проверить SELECT 1 FROM level_words WHERE level=$1 AND level_id IS NULL AND LOWER(word_pl)=LOWER($2) AND id != $word_id - **Confidence:** 0.8 ### 30. feed_upload_image_no_magic_bytes_check - **Файл:** `routers/feed.py:0` - **Snippet:** `content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:` - **Проблема:** Проверка только по Content-Type из заголовка — можно загрузить HTML/JS под видом image/png, файл отдаётся с публичного URL - **Как воспроизвести:** curl -F 'file=@evil.html;type=image/png' /admin/feed/upload-image → файл сохранён как .png, но содержимое HTML - **Что сделать:** Проверять magic bytes (imghdr/Pillow) перед сохранением; отдавать uploads с Content-Disposition: attachment или X-Content-Type-Options: nosniff - **Confidence:** 0.8 ### 31. save_analytics_no_limit 🔵 secondary - **Файл:** `routers/assistant.py:246` - **Snippet:** `message = body.get("message", "").strip() if not message: raise HTTPException(400, "Message is required` - **Проблема:** Нет ограничения длины и частоты: можно записать в chat_history сообщение любой длины и под видом assistant-роли — раздувание БД и подмена контекста будущих ответов AI - **Как воспроизвести:** POST /assistant/save-analytics с message из 10 МБ → записывается в chat_history без отказа - **Что сделать:** Добавить len(message) <= 500 и rate-limit как в /chat - **Confidence:** 0.88 ### 32. tts_cache_unbounded 🔵 secondary - **Файл:** `routers/tts.py:27` - **Snippet:** `CACHE_DIR = "/root/filwordspl/backend/tts_cache" os.makedirs(CACHE_DIR, exist_ok=True)` - **Проблема:** Кэш растёт неограниченно: уникальных текстов до 500 символов может быть миллионы → переполнение диска и отказ сервиса - **Как воспроизвести:** Скриптом запросить TTS для 100k уникальных строк → 100k mp3-файлов на диске без очистки - **Что сделать:** Периодическая очистка по mtime (LRU) или лимит размера директории - **Confidence:** 0.85 ### 33. assistant_race_daily_limit 🔗 both - **Файл:** `routers/assistant.py:168` - **Snippet:** `daily_usage = await get_daily_usage(telegram_id) if daily_usage >= FREE_DAILY_LIMIT:` - **Проблема:** при параллельных запросах лимит можно превысить (TOCTOU) - **Как воспроизвести:** отправить 5 запросов одновременно при used=4 → все пройдут проверку - **Что сделать:** использовать атомарный INSERT ... ON CONFLICT ... WHERE message_count < LIMIT RETURNING, либо SELECT FOR UPDATE - **Confidence:** 0.84 ### 34. tts_no_rate_limit - **Файл:** `routers/tts.py:38` - **Snippet:** `async def text_to_speech(request: Request, text: str = "", voice: str = "male"):` - **Проблема:** злоумышленник может забить диск кэшем и нагрузить CPU синтезом - **Как воспроизвести:** цикл GET /tts?text=<random> → каждый уникальный текст создаёт mp3-файл на диске - **Что сделать:** добавить rate-limit по user_id (например, 60 запросов/мин) и лимит размера кэша с LRU-очисткой - **Confidence:** 0.82 ### 35. rate_limiter_memory_leak_unbounded_keys - **Файл:** `main.py:88` - **Snippet:** `self.requests[key] = [t for t in self.requests[key] if now - t < window]` - **Проблема:** при большом числе уникальных IP:path словарь requests растёт, память утекает, сервис может упасть (502/504 у всех учеников) - **Как воспроизвести:** нагрузить API с разных IP → defaultdict накапливает ключи, cleanup раз в 60с не успевает - **Что сделать:** использовать TTL-кэш (cachetools.TTLCache) или Redis; ограничить размер словаря - **Confidence:** 0.8 ### 36. rate_limit_path_exact_match_bypass 🔗 both - **Файл:** `main.py:87` - **Snippet:** `limit_config = self.limits.get(path, self.limits["default"])` - **Проблема:** лимиты на дорогие AI-эндпоинты обходятся добавлением слэша/кодировки пути (например /assistant/chat/ или //assistant/chat), бюджет выжигается - **Как воспроизвести:** POST /assistant/chat/ → path != '/assistant/chat' → применяется default 60/мин вместо 20/мин - **Что сделать:** нормализовать path (rstrip('/'), unquote) или матчить по префиксу роутера - **Confidence:** 0.87 ### 37. auth_query_param_initdata_leak - **Файл:** `auth.py:108` - **Snippet:** `init_data = request.query_params.get('initData', '')` - **Проблема:** initData (подпись Telegram) попадает в URL → в логи Cloudflare/nginx/access.log, возможен replay-захват аккаунта ученика - **Как воспроизвести:** DELETE /feed/post?initData=... → строка с токеном в access.log - **Что сделать:** убрать query-fallback, использовать только Authorization: tma; для deleteFeedPost — POST с телом - **Confidence:** 0.85 ### 38. auth_no_replay_protection - **Файл:** `auth.py:30` - **Snippet:** `if current_time - auth_date > MAX_INITDATA_AGE:` - **Проблема:** перехваченный initData валиден 4 часа — можно переиграть запросы от имени ученика (списать очки, изменить прогресс) - **Как воспроизвести:** перехватить initData → в течение 4ч повторять запросы - **Что сделать:** хранить использованные hash в Redis с TTL=MAX_INITDATA_AGE, отклонять повторные - **Confidence:** 0.78 ### 39. init_db_transaction_ddl_lock_risk - **Файл:** `database.py:22` - **Snippet:** `async with conn.transaction():` - **Проблема:** вся инициализация в одной транзакции с ALTER TABLE/DROP CONSTRAINT держит ACCESS EXCLUSIVE locks — при рестарте под нагрузкой API зависает для всех учеников - **Как воспроизвести:** рестарт backend при активных запросах → блокировки на users/levels → таймауты - **Что сделать:** разнести миграции и CREATE TABLE; использовать advisory lock и отдельные транзакции на миграцию - **Confidence:** 0.8 ### 40. init_db_drop_constraint_no_cascade_orphan_fk - **Файл:** `database.py:130` - **Snippet:** `ALTER TABLE user_progress DROP CONSTRAINT IF EXISTS user_progress_user_id_fkey` - **Проблема:** если на user_progress.user_id ссылаются другие FK (не перечисленные), миграция упадёт и БД останется в промежуточном состоянии — прогресс учеников недоступен - **Как воспроизвести:** наличие внешнего FK на user_progress.user_id → ALTER COLUMN TYPE BIGINT падает - **Что сделать:** перед ALTER TYPE явно находить и пересоздавать все зависимые FK через pg_constraint - **Confidence:** 0.77 ### 41. leaderboard_matview_refresh_concurrently_no_unique_guard - **Файл:** `main.py:130` - **Snippet:** `await conn.execute("REFRESH MATERIALIZED VIEW CONCURRENTLY leaderboard_cache")` - **Проблема:** если unique index не создан (например, упал CREATE INDEX на старте), REFRESH CONCURRENTLY падает каждые 5 мин — рейтинг у учеников замораживается - **Как воспроизвести:** удалить idx_leaderboard_cache_user → refresh loop логирует ошибки, рейтинг не обновляется - **Что сделать:** проверять наличие unique index перед refresh или использовать REFRESH без CONCURRENTLY как fallback - **Confidence:** 0.76 ### 42. initdata_in_query_param 🔵 secondary - **Файл:** `auth.py:100` - **Snippet:** `if not init_data: init_data = request.query_params.get('initData', '')` - **Проблема:** initData (валидный credential на 4 часа) попадает в access-логи nginx/Cloudflare, browser history и Sentry breadcrumbs — утечка токена авторизации, replay-атака от имени ученика - **Как воспроизвести:** вызвать любой эндпоинт с ?initData=... → токен сохраняется в access-log прокси и в URL, который виден в истории/логах - **Что сделать:** принимать initData только из заголовков; для deleteFeedPost передавать initData в теле POST или отдельным заголовком, а не в query - **Confidence:** 0.85 ## 🟡 Качество кода (18) ### 43. game_progress_n_plus_1_scores 🔗 both - **Файл:** `routers/game.py:30` - **Snippet:** `wordsearch_score = await conn.fetchval( "SELECT COALESCE(SUM(score), 0) FROM user_progress WHERE user_id = $` - **Проблема:** 4 последовательных запроса вместо одного UNION — медленнее на больших данных - **Как воспроизвести:** GET /game/progress → 4 round-trip к БД - **Что сделать:** Объединить в один запрос с UNION ALL или CTE - **Confidence:** 0.9 ### 44. questions_options_duplication 🔵 secondary - **Файл:** `routers/orchestrator.py:168` - **Snippet:** `question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids:` - **Проблема:** Одинаковый блок загрузки options + группировки скопирован трижды (get_lesson_by_id, get_lesson_questions, get_test_questions) — правка в одном месте разъедется с остальными - **Как воспроизвести:** сравнить тела трёх функций — идентичный код ~15 строк × 3 - **Что сделать:** вынести в хелпер fetch_questions_with_options(conn, where_clause, params) - **Confidence:** 0.95 ### 45. orchestrator_duplicate_options_query - **Файл:** `routers/orchestrator.py:175` - **Snippet:** `async def get_lesson_questions(conn, lesson_id: str) -> list: """Получает только вопросы урока (без объяснения)."""` - **Проблема:** нет прямого эффекта, но при расхождении логики в трёх копиях ученик может увидеть разные наборы опций в уроке и тесте - **Как воспроизвести:** изменить формат options в get_lesson_by_id, забыть про get_lesson_questions/get_test_questions → рассинхрон - **Что сделать:** вынести общий хелпер _load_questions_with_options(conn, where_sql, params) и переиспользовать в трёх функциях - **Confidence:** 0.9 ### 46. orchestrator_random_order_by - **Файл:** `routers/orchestrator.py:232` - **Snippet:** `WHERE reaction_type = $1 ORDER BY RANDOM() LIMIT 1` - **Проблема:** при большом банке реакций каждый ответ учителя делает full scan — заметная задержка в чате - **Как воспроизвести:** teacher_reactions с 10k строк → ORDER BY RANDOM() сканирует всю таблицу на каждый ответ - **Что сделать:** использовать TABLESAMPLE SYSTEM или предзагружать банк в память с random.choice - **Confidence:** 0.85 ### 47. select_star_lessons 🔵 secondary - **Файл:** `routers/orchestrator.py:96` - **Snippet:** `SELECT * FROM learning_lessons WHERE lesson_id = $1 AND is_active = TRUE` - **Проблема:** SELECT * втягивает все колонки (включая тяжёлые/служебные) в ответ урока, который уходит дальше по коду; изменение схемы тихо меняет API-ответ - **Как воспроизвести:** добавить колонку в learning_lessons → она появится в payload урока - **Что сделать:** явный список колонок - **Confidence:** 0.85 ### 48. orchestrator_not_in_subquery_perf - **Файл:** `routers/orchestrator.py:138` - **Snippet:** `AND l.lesson_id NOT IN ( SELECT lesson_id FROM user_lesson_progress WHERE user_id = $2 AND ` - **Проблема:** при росте user_lesson_progress запрос деградирует, ученик ждёт ответа чата дольше - **Как воспроизвести:** 10k+ записей прогресса → seq scan на NOT IN, latency растёт - **Что сделать:** заменить на NOT EXISTS или LEFT JOIN ... IS NULL, добавить индекс (user_id, completed, lesson_id) - **Confidence:** 0.8 ### 49. profile_get_profile_hash_decimal_only - **Файл:** `routers/learning_profile.py:47` - **Snippet:** `if isinstance(v, Decimal): item[k] = float(v) else: item[k] = v` - **Проблема:** если в weak_skills появится datetime/date, json.dumps упадёт → /analytics и /review вернут 500 - **Как воспроизвести:** добавить в SELECT поле last_attempt_at (timestamp) → get_profile_hash бросает TypeError - **Что сделать:** использовать default=str в json.dumps или расширить конвертер на date/datetime - **Confidence:** 0.8 ### 50. tts_blocking_io 🔵 secondary - **Файл:** `routers/tts.py:62` - **Snippet:** `with open(cache_path, 'rb') as f: return Response(` - **Проблема:** Блокирующие file I/O (open/read/write) в async-хендлере блокируют event loop → лаги всех запросов при медленном диске/больших файлах - **Как воспроизвести:** Много одновременных TTS-запросов с cache miss → рост латентности всего API - **Что сделать:** Использовать aiofiles или anyio.to_thread.run_sync для чтения/записи кэша - **Confidence:** 0.9 ### 51. admin_stats_duplicated 🔵 secondary - **Файл:** `routers/assistant.py:330` - **Snippet:** `total_users = await conn.fetchval("SELECT COUNT(*) FROM users") or 0 new_today = await conn.fetchval("SELECT COU` - **Проблема:** Код админ-статистики (total_users, new_today, online_now, level_counts) полностью дублируется между routers/leaderboard.py:/admin/stats и routers/assistant.py:/stats/admin — правки придётся делать в двух местах - **Как воспроизвести:** Сравнить get_admin_stats в leaderboard.py и assistant.py — идентичные SQL-блоки - **Что сделать:** Вынести общие запросы в общий сервисный модуль/функцию - **Confidence:** 0.9 ### 52. achievements_track_endpoints_duplication - **Файл:** `routers/achievements.py:300` - **Snippet:** `@router.post("/track-teacher-menu") async def track_teacher_menu_opened(request: Request): """Отмечает открытие меню` - **Проблема:** нет UX-эффекта, но 7 почти идентичных эндпоинтов - **Как воспроизвести:** grep track-* → 7 функций с одинаковым телом, отличаются только achievement_type - **Что сделать:** один эндпоинт POST /track/{event} с валидацией event по whitelist - **Confidence:** 0.88 ### 53. leaderboard_duplicate_cache_query - **Файл:** `routers/leaderboard.py:62` - **Snippet:** `my_total_in_cache = await conn.fetchval(""" SELECT total_score FROM leaderboard_cache WHERE telegram_id = $1` - **Проблема:** лишний round-trip к БД на каждый запрос лидерборда - **Как воспроизвести:** профилирование: 2 одинаковых SELECT из leaderboard_cache по telegram_id - **Что сделать:** объединить с my_row (SELECT * уже делается ниже) — использовать my_row["total_score"] - **Confidence:** 0.85 ### 54. leaderboard_zero_fields 🔵 secondary - **Файл:** `routers/leaderboard.py:47` - **Snippet:** `"levels_completed": 0, "sentences_completed": 0,` - **Проблема:** В записях лидерборда levels_completed и sentences_completed всегда 0 — клиент получает фиктивные данные для других игроков - **Как воспроизвести:** GET /leaderboard → у всех игроков levels_completed=0 независимо от прогресса - **Что сделать:** Либо убрать поля, либо добавить их в leaderboard_cache при REFRESH - **Confidence:** 0.85 ### 55. rate_limit_key_includes_path_double_count - **Файл:** `main.py:200` - **Snippet:** `rate_key = f"{client_ip}:{path}"` - **Проблема:** лимит 'default' фактически применяется per-path, а не per-IP — ученик может обойти общий лимит, чередуя эндпоинты - **Как воспроизвести:** 60 запросов на /a + 60 на /b — оба проходят, хотя default=60/мин на IP - **Что сделать:** для default использовать ключ только по IP, для специфичных — IP:path - **Confidence:** 0.78 ### 56. cors_allow_credentials_false_with_auth_header - **Файл:** `main.py:232` - **Snippet:** `allow_credentials=False,` - **Проблема:** если фронт когда-либо начнёт слать cookies — preflight упадёт; сейчас работает, но конфиг противоречив с Authorization-подходом - **Как воспроизвести:** не воспроизводится сейчас, риск при добавлении cookie-сессий - **Что сделать:** оставить как есть или явно задокументировать, что cookies не используются - **Confidence:** 0.75 ### 57. health_endpoint_no_rate_limit_info_leak - **Файл:** `main.py:320` - **Snippet:** `return {"status": "ok", "database": "connected"}` - **Проблема:** публичный /health раскрывает состояние БД без авторизации — упрощает разведку для атакующего - **Как воспроизвести:** curl /health → видно connected/disconnected - **Что сделать:** ограничить /health по IP или возвращать только 200/503 без деталей - **Confidence:** 0.76 ### 58. init_db_ddl_every_startup 🔵 secondary - **Файл:** `database.py:20` - **Snippet:** `async with conn.transaction(): # ============ users ============ await conn.execute(""" ` - **Проблема:** каждый рестарт выполняет ~100 DDL-операций (CREATE/ALTER/DROP INDEX/DO-блоки) с ACCESS EXCLUSIVE локами; на больших таблицах ALTER/индексы блокируют запросы учеников, деплой зависает - **Как воспроизвести:** рестарт приложения на проде с большой user_learning_answers → транзакция init_db держит локи, /game/* запросы висят до завершения - **Что сделать:** вынести схему в миграции (alembic/версионированные SQL-файлы), init_db оставить только для create_pool - **Confidence:** 0.9 ### 59. learning_tables_no_user_fk 🔵 secondary - **Файл:** `database.py:330` - **Snippet:** `CREATE TABLE IF NOT EXISTS learning_sessions ( id BIGSERIAL PRIMARY KEY, user_id` - **Проблема:** user_id в learning_sessions, user_learning_answers, user_lesson_progress, user_topic_progress, user_skill_mastery, ai_user_context, support_tickets без FK на users(telegram_id) — при удалении пользователя остаются orphan-строки, аналитика и лидерборд-агрегаты считают мёртвые данные - **Как воспроизвести:** удалить пользователя из users → строки во всех learning_* и support_* таблицах остаются навсегда - **Что сделать:** добавить REFERENCES users(telegram_id) ON DELETE CASCADE (или плановую очистку по списку user_id) - **Confidence:** 0.85 ### 60. uploads_dir_hardcoded_root 🔵 secondary - **Файл:** `config.py:96` - **Snippet:** `UPLOADS_DIR = os.getenv("UPLOADS_DIR", "/root/filwordspl/backend/uploads")` - **Проблема:** дефолт привязан к конкретному пути /root/... — при запуске в контейнере/другом пользователе папка создаётся в неожиданном месте (os.makedirs в момент импорта), загруженные картинки пропадают после редеплоя - **Как воспроизвести:** запустить backend не от root без UPLOADS_DIR → создаётся /root/... от текущего пользователя (или PermissionError), смонтированные файлы теряются при деплое - **Что сделать:** дефолт — относительный Path(__file__).parent / 'uploads'; убрать makedirs из config в lifespan - **Confidence:** 0.78 --- **Итого:** всего находок=126, overshoot=6, snippet не совпал=15, низкий confidence=0, прошло=60 _Этот 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#18