🤖 AI Review (backend): 214 задач (2026-09-25 18:12 UTC) #15

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

🤖 AI Code Review (Backend)

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

📊 По пакам

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

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

1. hint_consumed_on_403_limit

  • Файл: routers/hints.py:30
  • Snippet: if hints_already_used >= MAX_HINTS: raise HTTPException(403, "Hint limit reached")
  • Проблема: ученик получает 403, но подсказка не выдана — при этом лимит уже исчерпан
  • Как воспроизвести: взять 3 подсказки → 4-й запрос возвращает 403, но hints_used не растёт (это ок), однако клиент может считать что подсказка потрачена
  • Что сделать: проверять лимит до инкремента (уже так), но вернуть в теле ответа hints_used_total для синхронизации UI
  • Confidence: 0.72

2. word_list_hint_consumed_on_403

  • Файл: routers/hints.py:130
  • Snippet: if hints_already_used >= MAX_HINTS: raise HTTPException(403, "Hint limit reached")
  • Проблема: то же самое — 403 без выдачи подсказки
  • Как воспроизвести: аналогично first-letter
  • Что сделать: то же — атомарный инкремент с условием
  • Confidence: 0.7

3. update_skill_mastery_previous_mastery_default

  • Файл: routers/learning.py:0
  • Snippet: previous_mastery = float(previous_row["mastery_score"]) if previous_row and previous_row["mastery_score"] else mastery
  • Проблема: При первом расчёте mastery_delta=0, но при повторном — если предыдущий mastery был 0, delta считается от нового значения (0), что искажает тренд
  • Как воспроизвести: Первый расчёт: mastery=50, previous=50, delta=0. Второй: mastery=60, previous=50, delta=10 (ок). Но если previous_row.mastery_score=0 → previous=mastery → delta=0
  • Что сделать: Различать 'нет записи' и 'mastery_score=0': использовать is not None
  • Confidence: 0.75

4. analytics_ai_response_keyerror

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

5. analytics_ai_no_timeout_retry

  • Файл: routers/learning.py:0
  • Snippet: async with httpx.AsyncClient(timeout=90.0) as client:
  • Проблема: При таймауте AI — 500 без fallback, ученик не получает аналитику
  • Как воспроизвести: Together AI недоступен → httpx.TimeoutException → 500
  • Что сделать: try/except вокруг httpx, возвращать fallback-сообщение
  • Confidence: 0.8

6. teacher_answer_ai_explanation_outside_conn

  • Файл: routers/teacher.py:0
  • Snippet: explanation_text = db_explanation if needs_ai_explanation: explanation_text = await get_wrong_answer_ai_expl
  • Проблема: AI-вызов происходит ПОСЛЕ закрытия соединения — если AI упадёт, ответ уже сохранён, но ученик не получит объяснение (ок), однако session_completed уже зафиксирован
  • Как воспроизвести: AI timeout → explanation_text='' → ученик видит пустое объяснение
  • Что сделать: Ок как есть, но fallback уже есть в get_wrong_answer_ai_explanation
  • Confidence: 0.7

7. teacher_resume_lesson_id_from_first_lesson

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

8. teacher_resume_question_not_found

  • Файл: routers/teacher.py:0
  • Snippet: last_question_id = last_answer["question_id"] last_index = 0 for i, q in enumerate(questions):
  • Проблема: Если вопрос удалён/деактивирован, last_index=0 → resume вернёт вопрос 1, ученик застрянет
  • Как воспроизвести: Вопрос удалён из БД → resume возвращает questions[1] вместо следующего
  • Что сделать: Если вопрос не найден — завершать сессию или искать по created_at
  • Confidence: 0.75

9. teacher_phrase_of_day_ai_failure_cached

  • Файл: routers/teacher.py:0
  • Snippet: if ai_response: # Парсим текстовый ответ построчно
  • Проблема: Если AI упал — фраза-заглушка 'Lepiej późno niż wcale' кэшируется на весь день для всех юзеров
  • Как воспроизвести: AI timeout в 00:00 → все юзеры весь день видят одну и ту же фразу
  • Что сделать: Не кэшировать fallback: если ai_response пустой — не INSERT, вернуть fallback без сохранения
  • Confidence: 0.82

10. teacher_diagnostic_test_no_level_filter

  • Файл: routers/teacher.py:0
  • Snippet: questions = await conn.fetch(""" SELECT * FROM learning_questions WHERE is_test_question = TRUE
  • Проблема: Диагностический тест берёт вопросы всех уровней (A1-C2) случайно — новичок получит C2-вопросы
  • Как воспроизвести: POST /teacher/diagnostic-test → вопросы уровня C1 для A1-юзера
  • Что сделать: Стратифицировать по уровням: 3 вопроса A1, 3 A2, 3 B1 и т.д.
  • Confidence: 0.85

11. teacher_diagnostic_test_no_result_processing

  • Файл: routers/teacher.py:0
  • Snippet: session_id = await start_learning_session(conn, telegram_id, user_level, "", "diagnostic_test")
  • Проблема: Результат диагностического теста не обновляет current_level пользователя — тест бесполезен
  • Как воспроизвести: Пройти diagnostic_test → current_level не меняется
  • Что сделать: В complete_session обрабатывать session_type='diagnostic_test' и обновлять users.current_level
  • Confidence: 0.85

12. teacher_phrase_of_day_ai_failure_no_retry

  • Файл: routers/teacher.py:0
  • Snippet: ai_response = await call_ai(user_prompt, system_prompt, max_tokens=1000)
  • Проблема: Если AI упал — фраза дня = заглушка на весь день
  • Как воспроизвести: —
  • Что сделать: Retry 1-2 раза или не кэшировать fallback
  • Confidence: 0.75

13. teacher_answer_returns_correct_answer_text

  • Файл: routers/teacher.py:0
  • Snippet: correct_answer_text = "" for opt in options: if opt["is_correct"]:
  • Проблема: correct_answer_text возвращается в ответе даже когда is_correct=true — не критично, но при is_correct=false тоже отдаётся (ок для обучения)
  • Как воспроизвести: —
  • Что сделать: Ок для обучающего режима
  • Confidence: 0.7

14. learning_answer_returns_wrong_because

  • Файл: routers/learning.py:0
  • Snippet: return {"correct": correct, "wrong_because": wrong_because}
  • Проблема: wrong_because отдаётся клиенту — ок для обучения, но можно использовать для reverse-engineering правильного ответа
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

15. learning_analytics_regex_strips_legit_text

  • Файл: routers/learning.py:0
  • Snippet: ai_response = re.sub(r'\s*\([a-z_]+_[a-z_]+\)', '', ai_response)
  • Проблема: Regex удаляет любые скобки с подчёркиванием, включая легитимные (например, '(hello_world)')
  • Как воспроизвести: AI пишет 'слово (hello_world)' → 'слово'
  • Что сделать: Удалять только известные skill_tag из БД
  • Confidence: 0.75

16. learning_analytics_no_lang_in_prompt

  • Файл: routers/learning.py:0
  • Snippet: system_prompt = f"""Ты — AI-наставник польского языка в приложении Filwords PL.
  • Проблема: Промпт требует 'Отвечай на языке пользователя', но язык не передаётся — AI угадывает
  • Как воспроизвести: Юзер с lang=pl → AI может ответить на русском
  • Что сделать: Загрузить lang через get_user_lang и передать в промпт
  • Confidence: 0.85

17. learning_analytics_weak_lessons_empty

  • Файл: routers/learning.py:0
  • Snippet: weak_lessons_lines = '\n'.join([f'- {l["title_ru"]} (тема: {l["topic_name"]})' for l in weak_lessons])
  • Проблема: Если weak_lessons пуст — в промпт попадает пустая строка, AI может галлюцинировать уроки
  • Как воспроизвести: weak_skills есть, но уроков по ним нет → AI выдумывает уроки
  • Что сделать: Если weak_lessons пуст — не включать секцию в промпт
  • Confidence: 0.75

18. learning_practice_start_no_questions_fallback

  • Файл: routers/learning.py:0
  • Snippet: if not questions: return {"has_weak_skills": True, "questions": [], "message": "Для этих навыков пока нет во
  • Проблема: Сессия уже создана в БД, но возвращается пустой ответ — сессия висит незавершённой
  • Как воспроизвести: POST /learning/practice/start → пустой ответ → сессия в БД is_completed=false
  • Что сделать: Создавать сессию только после проверки наличия вопросов
  • Confidence: 0.8

19. learning_update_skill_mastery_previous_mastery_float

  • Файл: routers/learning.py:0
  • Snippet: previous_mastery = float(previous_row["mastery_score"]) if previous_row and previous_row["mastery_score"] else mastery
  • Проблема: Если previous mastery_score=0 (Decimal('0')), if previous_row["mastery_score"] = False → previous=mastery → delta=0 (неверно)
  • Как воспроизвести: Первый расчёт mastery=50 → previous=50, delta=0. Второй: mastery=60, previous=50, delta=10. Но если предыдущий был 0 → previous=60, delta=0
  • Что сделать: Использовать is not None вместо truthy-проверки
  • Confidence: 0.8

20. leaderboard_rank_off_by_one_for_cached_user

  • Файл: routers/leaderboard.py:60
  • Snippet: user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot
  • Проблема: Ученик видит свой ранг на 1 выше реального (например, 5-е место вместо 6-го), если у кого-то равный total_score
  • Как воспроизвести: два юзера с одинаковым total_score в leaderboard_cache → у обоих my_rank.rank одинаковый, но по факту один выше другого
  • Что сделать: Использовать RANK() OVER (ORDER BY total_score DESC) или считать COUNT(*) + 1 WHERE total_score > $1 OR (total_score = $1 AND telegram_id < $2)
  • Confidence: 0.78

21. leaderboard_rank_ignores_zero_score_users

  • Файл: routers/leaderboard.py:55
  • Snippet: user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot
  • Проблема: Новый ученик с 0 очков видит себя на позиции N+1 (после всех с очками), но в самом списке leaderboard его нет — рассинхрон между my_rank и leaderboard
  • Как воспроизвести: новый юзер → GET /leaderboard → my_rank.rank = 100, но в leaderboard[] его нет
  • Что сделать: Либо добавлять юзера в leaderboard[] при отсутствии в кэше, либо явно возвращать rank=null и флаг not_ranked
  • Confidence: 0.75

22. leaderboard_rank_achievement_uses_wrong_value

  • Файл: routers/leaderboard.py:220
  • Snippet: if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)
  • Проблема: Достижение rank_1 (value=1) выдаётся только при my_position==1, но rank_top3 (value=3) требует requirement_value <= value — при my_position=2 условие 3<=2 ложно, достижение top3 не выдаётся
  • Как воспроизвести: юзер занял 2 место → check_and_award_achievements(..., 'rank_reached', 2) → rank_top3 (value=3) не проходит фильтр 3<=2
  • Что сделать: Передавать value=3 при попадании в топ-3, либо инвертировать логику: requirement_value >= value для rank_reached
  • Confidence: 0.82

23. assistant_save_message_before_ai_call

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

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

    history = await get_history(telegram_id)`

  • Проблема: При ошибке AI (timeout/500) сообщение пользователя уже сохранено в истории, но ответа нет — при следующем запросе модель видит «висящий» вопрос без ответа

  • Как воспроизвести: отправить сообщение → AI timeout → в /assistant/history висит user-сообщение без assistant-ответа

  • Что сделать: Сохранять user_message только после успешного ответа AI, либо помечать сообщение как failed и удалять при ошибке

  • Confidence: 0.75

24. users_set_language_no_user_check

  • Файл: routers/users.py:55
  • Snippet: await conn.execute( "UPDATE users SET app_language = $1 WHERE telegram_id = $2", lang, user_id,
  • Проблема: Если юзер не зарегистрирован (нет в users), UPDATE молча ничего не делает, но API возвращает status:ok — клиент думает, что язык сохранён
  • Как воспроизвести: вызвать POST /users/set-language без предварительного /register → 200 ok, но в БД ничего
  • Что сделать: Проверять rowcount или существование юзера (как в set_level) и возвращать 401
  • Confidence: 0.8

25. rate_limiter_default_60_per_min_global

  • Файл: main.py:89
  • Snippet: "default": {"max_requests": 60, "window": 60},
  • Проблема: любой не перечисленный эндпоинт (например /users/me, /feed) лимитируется 60 req/min на IP:path — при активной навигации ученик получает 429
  • Как воспроизвести: открыть приложение, быстро переключать экраны → часть запросов падает с 429 Too many requests
  • Что сделать: увеличить default или добавить лимиты для всех реально используемых путей
  • Confidence: 0.72

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

26. hint_race_condition_limit

  • Файл: routers/hints.py:60
  • Snippet: await conn.execute(""" INSERT INTO user_progress (user_id, level_id, hints_used) VALUES ($1, $2,
  • Проблема: при параллельных запросах можно получить больше 3 подсказок (лимит обходится)
  • Как воспроизвести: отправить 5 параллельных GET /hints/first-letter/{id} — все пройдут проверку hints_already_used < 3
  • Что сделать: использовать SELECT ... FOR UPDATE или атомарный UPDATE ... WHERE hints_used < 3 RETURNING hints_used
  • Confidence: 0.85

27. wordquiz_check_trusts_client_correct_polish

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

28. wordquiz_check_no_level_validation

  • Файл: routers/wordquiz.py:145
  • Snippet: is_correct = user_answer.strip().lower() == correct_polish.strip().lower()
  • Проблема: можно начислять очки за слова не из своего уровня
  • Как воспроизвести: отправить correct_polish из другого уровня
  • Что сделать: проверять, что correct_polish принадлежит level_words с level = user.current_level
  • Confidence: 0.85

29. wordquiz_consolation_score_repeatable

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

30. bubblewords_completion_time_trusted

  • Файл: routers/bubblewords.py:190
  • Snippet: if completion_time is not None and completion_time > 0 and int(completion_time) <= 45: achievements_to_check
  • Проблема: клиент может подставить completion_time=1 и получить достижение bubble_speed
  • Как воспроизвести: POST /bubblewords/complete {completion_time: 1}
  • Что сделать: замерять время на сервере (сохранять started_at при /next)
  • Confidence: 0.85

31. sentences_check_trusts_completion_time

  • Файл: routers/sentences.py:175
  • Snippet: if completion_time is not None and completion_time > 0: achievements_to_check.append(("speed_sentence",
  • Проблема: клиент может подставить любое время для достижения speed_sentence
  • Как воспроизвести: POST /sentences/check {completion_time: 1}
  • Что сделать: замерять время на сервере
  • Confidence: 0.8

32. typing_check_no_progress_validation

  • Файл: routers/typing.py:70
  • Snippet: if is_correct: # Сохраняем прогресс await conn.execute(""" INSERT INTO typing_pr
  • Проблема: нет проверки, что предложение принадлежит уровню пользователя; нет защиты от читерства по времени
  • Как воспроизвести: отправить sentence_id из другого уровня
  • Что сделать: проверять s.level = user.current_level и добавить минимальное время
  • Confidence: 0.75

33. answer_uses_client_hint_used

  • Файл: routers/learning.py:0
  • Snippet: hint_used = body.get("hint_used", False)
  • Проблема: Ученик может подделать hint_used=false, чтобы завысить mastery и fluency
  • Как воспроизвести: POST /learning/answer с hint_used=false после реального использования подсказки → hint_dependency не растёт, mastery завышен
  • Что сделать: Сервер должен сам фиксировать факт подсказки (например, отдельный endpoint /hint/use), а не доверять клиенту
  • Confidence: 0.85

34. answer_uses_client_time_taken

  • Файл: routers/learning.py:0
  • Snippet: time_taken_ms = body.get("time_taken_ms", 0)
  • Проблема: Ученик может присылать time_taken_ms=100 и получать fluency_score=100 без реальной скорости
  • Как воспроизвести: POST /learning/answer с time_taken_ms=1 → median_correct_time_ms < 5000 → speed_score=100
  • Что сделать: Замерять время на сервере (session start → answer) или валидировать разумные границы
  • Confidence: 0.8

35. answer_uses_client_is_final

  • Файл: routers/learning.py:0
  • Snippet: is_final = body.get("is_final_answer", True)
  • Проблема: Клиент может пометить все ответы is_final_answer=false, чтобы session/complete показал 0/0 и не портил статистику
  • Как воспроизвести: POST /learning/answer с is_final_answer=false → stats.total=0 → score=0, но mastery пересчитывается по всем ответам
  • Что сделать: Определять is_final_answer на сервере по позиции вопроса в сессии
  • Confidence: 0.75

36. answer_no_session_owner_check

  • Файл: routers/learning.py:0
  • Snippet: session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id)
  • Проблема: Атакующий может записать ответы в чужую сессию, испортив чужую аналитику
  • Как воспроизвести: POST /learning/answer с session_id жертвы → ответ записан в чужую сессию (проверка владельца есть, но только после fetch — ок, но лучше одним запросом)
  • Что сделать: SELECT ... WHERE id=$1 AND user_id=$2 одним запросом, fail fast
  • Confidence: 0.7

37. complete_session_no_owner_check

  • Файл: routers/learning.py:0
  • Snippet: session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1 AND user_id = $2", session_id, telegram_id)
  • Проблема: Если session_id=None, запрос вернёт None → 404, но при передаче чужого id — 404 (ок). Проблема: session_id не валидируется на тип
  • Как воспроизвести: POST /learning/session/complete с session_id='abc' → asyncpg может кинуть ошибку типа → 500
  • Что сделать: Валидировать session_id как int, возвращать 400 при неверном типе
  • Confidence: 0.72

38. update_skill_mastery_retention_score_hardcoded

  • Файл: routers/learning.py:0
  • Snippet: retention_score, hint_dependency, average_time_ms, median_time_ms, median_correct_time_ms, median_wrong_time
  • Проблема: retention_score всегда 0 в БД, хотя в ON CONFLICT он не обновляется — retention_score остаётся 0 навсегда
  • Как воспроизвести: SELECT retention_score FROM user_skill_mastery → всегда 0
  • Что сделать: Либо вычислять retention_score, либо убрать поле из INSERT/схемы
  • Confidence: 0.82

39. get_lesson_no_owner_check

  • Файл: routers/learning.py:0
  • Snippet: lesson = await conn.fetchrow("SELECT * FROM learning_lessons WHERE lesson_id = $1", lesson_id)
  • Проблема: Ученик может получить любой урок, включая неактивные (is_active не проверяется)
  • Как воспроизвести: GET /learning/lessons/{id} для is_active=false урока → возвращается
  • Что сделать: Добавить AND is_active = TRUE
  • Confidence: 0.75

40. get_topic_no_active_check

  • Файл: routers/learning.py:0
  • Snippet: topic = await conn.fetchrow("SELECT * FROM learning_topics WHERE topic_id = $1", topic_id)
  • Проблема: Можно получить неактивную тему
  • Как воспроизвести: GET /learning/topics/{id} для is_active=false → возвращается
  • Что сделать: Добавить AND is_active = TRUE
  • Confidence: 0.72

41. start_session_no_topic_validation

  • Файл: routers/learning.py:0
  • Snippet: topic_id = body.get("topic_id", "") session_type = body.get("session_type", "lesson")
  • Проблема: Клиент может передать произвольный session_type (например, 'topic_test') и получить прогресс теста без прохождения
  • Как воспроизвести: POST /learning/session/start с session_type='topic_test' → complete_session засчитает тест
  • Что сделать: Валидировать session_type по whitelist и проверять, что тест доступен (уроки пройдены)
  • Confidence: 0.8

42. complete_session_test_score_no_validation

  • Файл: routers/learning.py:0
  • Snippet: if session["session_type"] == "topic_test": test_score = (stats["correct_count"] / stats["total"] * 100) if
  • Проблема: Клиент может создать сессию topic_test, ответить на 1 вопрос правильно и получить test_score=100
  • Как воспроизвести: start_session(topic_test) → answer(1 вопрос) → complete → test_completed=true, test_score=100
  • Что сделать: Проверять, что отвечено на все вопросы теста темы (сравнить с COUNT тестовых вопросов)
  • Confidence: 0.85

43. teacher_ai_limit_race_condition

  • Файл: routers/teacher.py:0
  • Snippet: if not await check_ai_limit(conn, telegram_id): return get_ai_limit_message(lang)
  • Проблема: Параллельные запросы могут обойти лимит 5/день (check-then-act race)
  • Как воспроизвести: 5 параллельных POST /teacher/explain → все проходят check, все инкрементируют → 10 использований
  • Что сделать: Атомарный INSERT ... ON CONFLICT с проверкой count в одном запросе, или SELECT FOR UPDATE
  • Confidence: 0.8

44. teacher_ai_usage_increment_after_call

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

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

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

  • Проблема: Если AI вернул пустую строку — лимит не инкрементируется, но запрос к AI уже потрачен (деньги)

  • Как воспроизвести: AI возвращает '' → usage не растёт, но токены списаны

  • Что сделать: Инкрементировать usage ДО вызова AI (или всегда после, независимо от результата)

  • Confidence: 0.78

45. teacher_phrase_of_day_race

  • Файл: routers/teacher.py:0
  • Snippet: today_phrase = await conn.fetchrow(""" SELECT * FROM daily_phrases WHERE phrase_date = $1 """, today
  • Проблема: Параллельные запросы от разных юзеров в 00:00 UTC → N вызовов AI, N× стоимость
  • Как воспроизвести: 10 юзеров одновременно в 00:00 → 10 AI-вызовов для одной фразы
  • Что сделать: Использовать advisory lock или INSERT ... ON CONFLICT DO NOTHING RETURNING для атомарного создания
  • Confidence: 0.8

46. teacher_free_message_no_rate_limit

  • Файл: routers/teacher.py:0
  • Snippet: if len(user_message) > 300: raise HTTPException(400, "Message too long (max 300 characters)")
  • Проблема: Лимит 300 символов, но нет защиты от prompt injection — ученик может заставить AI выдать что угодно
  • Как воспроизвести: POST /teacher/free-message с 'Ignore previous instructions...'
  • Что сделать: Санитизация/фильтр промптов, ограничение тематики
  • Confidence: 0.7

47. teacher_history_no_size_limit

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

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

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

  • Проблема: Ученик может залить мегабайты JSON в teacher_chat_history — раздувание БД

  • Как воспроизвести: POST /teacher/history/save с messages=[...100000 элементов...]

  • Что сделать: Ограничить длину списка (например, 200) и общий размер JSON

  • Confidence: 0.8

48. teacher_answer_question_options_no_owner

  • Файл: routers/teacher.py:0
  • Snippet: options = await conn.fetch(""" SELECT * FROM question_options WHERE question_id = $1 """, question_i
  • Проблема: Возвращаются ВСЕ опции, включая is_correct=true — клиент может подсмотреть правильный ответ
  • Как воспроизвести: POST /teacher/answer → response.options содержит is_correct
  • Что сделать: Не отдавать is_correct клиенту (или отдавать только после ответа)
  • Confidence: 0.85

49. learning_get_lesson_returns_correct_answer

  • Файл: routers/learning.py:0
  • Snippet: questions = await conn.fetch("SELECT * FROM learning_questions WHERE lesson_id = $1 AND is_test_question = FALSE ORDER B
  • Проблема: SELECT * отдаёт correct_answer клиенту — ученик может подсмотреть ответы
  • Как воспроизвести: GET /learning/lessons/{id} → questions[].question.correct_answer
  • Что сделать: Явно перечислять поля без correct_answer, wrong_because
  • Confidence: 0.9

50. learning_get_test_returns_correct_answer

  • Файл: routers/learning.py:0
  • Snippet: questions = await conn.fetch("SELECT * FROM learning_questions WHERE topic_id = $1 AND is_test_question = TRUE ORDER BY
  • Проблема: Финальный тест отдаёт correct_answer клиенту — тест можно пройти без знаний
  • Как воспроизвести: GET /learning/test/{topic_id} → correct_answer в ответе
  • Что сделать: SELECT конкретные поля без correct_answer
  • Confidence: 0.9

51. orchestrator_get_lesson_returns_correct_answer

  • Файл: routers/orchestrator.py:0
  • Snippet: questions = await conn.fetch(""" SELECT * FROM learning_questions WHERE lesson_id = $1 AND is_test_ques
  • Проблема: SELECT * отдаёт correct_answer и wrong_because клиенту через teacher/start
  • Как воспроизвести: POST /teacher/start → question.correct_answer
  • Что сделать: Явный список полей без correct_answer
  • Confidence: 0.9

52. learning_practice_start_no_owner_check

  • Файл: routers/learning.py:0
  • Snippet: session = await conn.fetchrow(""" INSERT INTO learning_sessions (user_id, level_code, topic_id, session_type
  • Проблема: topic_id='' — при complete_session update_topic_progress не вызовется (ок), но session_type='weak_skills_practice' не обрабатывается в complete_session
  • Как воспроизвести: POST /learning/practice/start → complete → update_ai_context вызывается, но update_topic_progress нет (ок)
  • Что сделать: Ок, но убедиться, что complete_session корректно обрабатывает weak_skills_practice
  • Confidence: 0.7

53. learning_update_skill_mastery_retention_score_never_set

  • Файл: routers/learning.py:0
  • Snippet: retention_score, hint_dependency, average_time_ms, median_time_ms,
  • Проблема: retention_score всегда 0 в INSERT и не обновляется в ON CONFLICT — поле мёртвое
  • Как воспроизвести: SELECT retention_score FROM user_skill_mastery → всегда 0
  • Что сделать: Вычислять retention_score или убрать поле
  • Confidence: 0.85

54. admin_sentry_error_leak_to_client

  • Файл: routers/admin.py:155
  • Snippet: logger.error(f"Sentry API unexpected error: {e}") return {"errors": [], "error": str(e)}
  • Проблема: В ответе админу утекает внутренний текст исключения (может содержать URL с токеном, детали окружения).
  • Как воспроизвести: Сломать SENTRY_API_BASE → /admin/sentry-errors вернёт str(e) с деталями.
  • Что сделать: Возвращать обобщённое сообщение ('Sentry API error'), детали — только в лог.
  • Confidence: 0.75

55. admin_content_update_word_mass_update

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

56. achievements_check_race_condition

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

57. achievements_no_transaction_on_award

  • Файл: routers/achievements.py:310
  • Snippet: for ach in matching: await conn.execute( "INSERT INTO user_achievements (user_id, achievemen
  • Проблема: При падении между итерациями часть достижений выдана, часть нет — при повторном вызове SELECT их уже не вернёт, ученик не увидит попап
  • Как воспроизвести: обрыв соединения на 3-м из 5 INSERT → 2 достижения в БД, но new_achievements не вернулся клиенту
  • Что сделать: Обернуть цикл в conn.transaction() или использовать один bulk INSERT ... RETURNING
  • Confidence: 0.72

58. tts_cache_unbounded_growth

  • Файл: routers/tts.py:55
  • Snippet: with open(cache_path, 'wb') as f: f.write(audio_bytes)
  • Проблема: Кэш mp3 растёт бесконечно — со временем диск переполнится, TTS и весь backend упадут
  • Как воспроизвести: озвучить 100k уникальных фраз → /root/filwordspl/backend/tts_cache заполнит диск
  • Что сделать: Добавить LRU-очистку по размеру/возрасту (например, cron или при старте), либо использовать TTL-кэш
  • Confidence: 0.78

59. rate_limiter_memory_leak_unbounded_keys

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

60. rate_limit_key_uses_path_not_route

  • Файл: main.py:240
  • Snippet: rate_key = f"{client_ip}:{path}"
  • Проблема: лимит обходится добавлением query-параметров или слэша: /game/check-word?x=1 и /game/check-word — разные ключи, но один эндпоинт
  • Как воспроизвести: curl '/game/check-word?a=1' в цикле с меняющимся a → лимит 30/мин не срабатывает
  • Что сделать: использовать request.scope['route'].path (шаблон маршрута) вместо request.url.path
  • Confidence: 0.8

61. rate_limit_limits_lookup_by_path_mismatch

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

62. static_uploads_no_auth_no_path_check

  • Файл: main.py:271
  • Snippet: app.mount("/uploads", StaticFiles(directory=UPLOADS_DIR), name="uploads")
  • Проблема: любой файл из uploads доступен без авторизации по прямому URL; при загрузке небезопасного имени возможен обход каталога
  • Как воспроизвести: GET /uploads/<любой_файл> без initData → 200 OK
  • Что сделать: проверять, что file_path в БД принадлежит посту; отдавать через эндпоинт с проверкой; санитизировать имена при загрузке
  • Confidence: 0.72

63. init_db_delete_duplicates_full_scan

  • Файл: database.py:118
  • Snippet: DELETE FROM user_progress WHERE ctid NOT IN (
  • Проблема: на большой таблице — долгий full scan + lock; при падении транзакции миграция не завершится, БД останется без PK
  • Как воспроизвести: запустить init_db на таблице с миллионом строк → таймаут, откат, повтор при каждом рестарте
  • Что сделать: выполнять миграцию один раз вне startup, использовать временную таблицу или оконные функции с индексом
  • Confidence: 0.75

64. auth_query_param_initdata_leak

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

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

65. bubblewords_words_count_trusted

  • Файл: routers/bubblewords.py:155
  • Snippet: words_count = body.get("words_count", 3) completion_time = body.get("completion_time")
  • Проблема: words_count не используется — мёртвый параметр
  • Как воспроизвести: передать любое значение — на результат не влияет
  • Что сделать: удалить параметр или использовать для валидации
  • Confidence: 0.9

66. update_skill_mastery_n_plus_1

  • Файл: routers/learning.py:0
  • Snippet: for st in skill_tags: await update_skill_mastery(conn, telegram_id, st["skill_tag"])
  • Проблема: Завершение сессии с 10+ навыками делает 10+ тяжёлых запросов (fetch всех ответов + upsert) — медленно
  • Как воспроизвести: Сессия с 15 навыками → 15 × (SELECT всех ответов + INSERT ... ON CONFLICT)
  • Что сделать: Агрегировать по skill_tag одним запросом или батчить upsert
  • Confidence: 0.8

67. update_skill_mastery_fetches_all_answers

  • Файл: routers/learning.py:0
  • Snippet: answers = await conn.fetch(""" SELECT correct, time_taken_ms, hint_used, question_type, wrong_because, is_final_
  • Проблема: При тысячах ответов по навыку — тяжёлый SELECT в память на каждый вызов
  • Как воспроизвести: 10000 ответов по skill_tag → fetch всех в Python
  • Что сделать: Агрегировать в SQL (COUNT, AVG, PERCENTILE) или ограничить окно последними N
  • Confidence: 0.78

68. get_topic_loads_all_lesson_progress

  • Файл: routers/learning.py:0
  • Snippet: lesson_progress = await conn.fetch(""" SELECT lesson_id, completed FROM user_lesson_progress WHERE user_id =
  • Проблема: Загружаются ВСЕ прогрессы пользователя по всем темам, хотя нужны только для уроков этой темы
  • Как воспроизвести: 1000 пройденных уроков → 1000 строк на каждый GET /topics/{id}
  • Что сделать: Добавить фильтр AND lesson_id IN (SELECT lesson_id FROM learning_lessons WHERE topic_id=$2)
  • Confidence: 0.85

69. teacher_translate_no_lang_validation

  • Файл: routers/teacher.py:0
  • Snippet: system_prompt = f"""Ты — переводчик польского языка. Переведи текст на польский.
  • Проблема: lang не используется в промпте — перевод всегда на польский, независимо от языка юзера (ок по ТЗ, но lang загружается зря)
  • Как воспроизвести: —
  • Что сделать: Убрать загрузку lang или использовать для указания исходного языка
  • Confidence: 0.7

70. orchestrator_duplicate_lesson_query

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

71. orchestrator_next_lesson_not_in_subquery

  • Файл: routers/orchestrator.py:0
  • Snippet: AND l.lesson_id NOT IN ( SELECT lesson_id FROM user_lesson_progress WHERE user_id = $2 AND
  • Проблема: NOT IN с подзапросом медленнее, чем LEFT JOIN ... IS NULL, особенно при большом user_lesson_progress
  • Как воспроизвести: 10000 пройденных уроков → NOT IN сканирует всё
  • Что сделать: Переписать через LEFT JOIN user_lesson_progress ... WHERE ulp.lesson_id IS NULL
  • Confidence: 0.75

72. orchestrator_duplicate_options_grouping

  • Файл: routers/orchestrator.py:0
  • Snippet: question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids: all_options = awa
  • Проблема: Один и тот же блок копипастится в get_lesson_by_id, get_lesson_questions, get_test_questions, learning.py × 4, teacher.py × 2
  • Как воспроизвести: —
  • Что сделать: Вынести в helper attach_options(conn, questions) -> list
  • Confidence: 0.9

73. teacher_import_inside_function

  • Файл: routers/teacher.py:0
  • Snippet: from .learning import update_skill_mastery, update_topic_progress, update_ai_context
  • Проблема: Циклический импорт обходится локальным импортом — архитектурный запах
  • Как воспроизвести: —
  • Что сделать: Вынести update_* в отдельный модуль learning_service.py
  • Confidence: 0.8

74. teacher_ai_limit_check_duplicated

  • Файл: routers/teacher.py:0
  • Snippet: if not await check_ai_limit(conn, telegram_id): return { "response": "", "li
  • Проблема: Один и тот же блок в /explain, /examples, /free-message, /translate-to-polish
  • Как воспроизвести: —
  • Что сделать: Декоратор @require_ai_limit или middleware
  • Confidence: 0.85

75. teacher_ai_usage_increment_duplicated

  • Файл: routers/teacher.py:0
  • Snippet: if ai_response: async with pool.acquire() as conn: await increment_teacher_ai_usage(conn, telegram_i
  • Проблема: Дублируется в 4 endpoints
  • Как воспроизвести: —
  • Что сделать: Обернуть в helper call_ai_with_limit(conn, telegram_id, ...)
  • Confidence: 0.8

76. teacher_get_wrong_answer_ai_explanation_double_pool

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

  • Snippet: `pool = await get_pool()

    async with pool.acquire() as conn:
    if not await check_ai_limit(conn, telegram_i`

  • Проблема: Открывает соединение, закрывает, потом снова открывает для increment — 2 acquire на один вызов

  • Как воспроизвести: —

  • Что сделать: Держать одно соединение на весь вызов

  • Confidence: 0.75

77. teacher_check_ai_limit_for_fallback_unused_lang

  • Файл: routers/teacher.py:0
  • Snippet: async def _check_ai_limit_for_fallback(telegram_id: int, lang: str) -> bool:
  • Проблема: Параметр lang не используется — мёртвый код
  • Как воспроизвести: —
  • Что сделать: Убрать параметр lang
  • Confidence: 0.85

78. teacher_phrase_of_day_import_random_inside

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

79. learning_analytics_ai_response_no_length_check

  • Файл: routers/learning.py:0
  • Snippet: ai_response = ai_response.replace("**", "").replace("*", "").replace("#", "")
  • Проблема: Удаление markdown через replace — грубо, может испортить текст (например, 'C#' → 'C')
  • Как воспроизвести: AI пишет 'C#' → 'C'
  • Что сделать: Использовать regex для markdown-паттернов
  • Confidence: 0.7

80. learning_analytics_no_ai_response_validation

  • Файл: routers/learning.py:0
  • Snippet: if not ai_response or len(ai_response) < 10: ai_response = "Перепройди уроки по слабым темам. Нажми кноп
  • Проблема: Fallback только на русском, независимо от языка юзера
  • Как воспроизвести: Юзер с lang=pl получает русский fallback
  • Что сделать: Локализовать fallback
  • Confidence: 0.8

81. learning_analytics_skill_names_all_loaded

  • Файл: routers/learning.py:0
  • Snippet: skill_names = await get_skill_names(conn) skill_tag_lines = '\n'.join([f'- {tag} → "{name}"' for tag, name in sk
  • Проблема: Загружаются ВСЕ навыки, хотя нужны только слабые — лишний шум в промпте
  • Как воспроизвести: —
  • Что сделать: Фильтровать по weak_skill_tags
  • Confidence: 0.75

82. learning_practice_start_random_order

  • Файл: routers/learning.py:0
  • Snippet: ORDER BY random() LIMIT 10
  • Проблема: ORDER BY random() на большой таблице — full scan + sort, медленно
  • Как воспроизвести: 100000 вопросов → full scan
  • Что сделать: Использовать TABLESAMPLE или предварительный random id
  • Confidence: 0.75

83. learning_practice_start_explanations_map_merge

  • Файл: routers/learning.py:0
  • Snippet: "explanations": [ {"skill_tag": tag, "name": skill_names.get(tag, tag), **explanations_map.get(tag, {})}
  • Проблема: explanations_map.get(tag, {}) содержит skill_tag — перезапишет внешний skill_tag (ок, тот же), но содержит explanation_* поля всех языков
  • Как воспроизвести: —
  • Что сделать: Явно выбирать нужные поля
  • Confidence: 0.7

84. learning_update_ai_context_strong_skills_limit

  • Файл: routers/learning.py:0
  • Snippet: strong_skills = await get_strong_skills(conn, user_id, limit=8) weak_skills = await get_weak_skills(conn, user_id, l
  • Проблема: Хардкод лимитов — если нужно больше, придётся менять код
  • Как воспроизвести: —
  • Что сделать: Вынести в константы
  • Confidence: 0.7

85. learning_update_ai_context_strong_skills_unused

  • Файл: routers/learning.py:0
  • Snippet: strong_skill_tags = [s["skill_tag"] for s in strong_skills] weak_skill_tags = [s["skill_tag"] for s in weak_skills]
  • Проблема: strong_skills загружаются, но используются только для сохранения в ai_user_context — ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

86. learning_update_topic_progress_skills_avg_subquery

  • Файл: routers/learning.py:0
  • Snippet: skills_avg = await conn.fetchval(""" SELECT COALESCE(AVG(mastery_score), 0) FROM user_skill_mastery WHER
  • Проблема: Подзапрос по learning_questions без индекса на topic_id может быть медленным
  • Как воспроизвести: —
  • Что сделать: Убедиться в наличии индекса на learning_questions(topic_id, skill_tag)
  • Confidence: 0.7

87. learning_update_topic_progress_lessons_completed_subquery

  • Файл: routers/learning.py:0
  • Snippet: lessons_completed = await conn.fetchval(""" SELECT COUNT(*) FROM user_lesson_progress WHERE user_id = $1 AND les
  • Проблема: Подзапрос вместо JOIN — можно оптимизировать
  • Как воспроизвести: —
  • Что сделать: JOIN learning_lessons ON ... WHERE topic_id=$2
  • Confidence: 0.7

88. learning_update_skill_mastery_confidence_calculation

  • Файл: routers/learning.py:0
  • Snippet: if len(recent) >= 3: if all(a["correct"] for a in recent[-3:]): confidence = min(100, mastery + 15)
  • Проблема: recent = answers[-5:], но проверяется recent[-3:] — если recent содержит 5, проверяются последние 3 (ок)
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

89. learning_update_skill_mastery_days_since_naive

  • Файл: routers/learning.py:0
  • Snippet: if last_attempt.tzinfo is None: last_attempt = last_attempt.replace(tzinfo=timezone.utc)
  • Проблема: Обработка naive datetime — ок, но лучше хранить TIMESTAMPTZ в БД
  • Как воспроизвести: —
  • Что сделать: Убедиться, что created_at — TIMESTAMPTZ
  • Confidence: 0.7

90. learning_update_skill_mastery_retention_fresh_duplicate

  • Файл: routers/learning.py:0
  • Snippet: if days_since == 0: retention_status = "fresh" elif days_since <= 3: retention_status = "fresh"
  • Проблема: Дублирование ветки — можно объединить в if days_since <= 3
  • Как воспроизвести: —
  • Что сделать: Объединить условия
  • Confidence: 0.85

91. learning_update_skill_mastery_speed_score_magic

  • Файл: routers/learning.py:0
  • Snippet: speed_score = 100 if median_correct_time_ms and median_correct_time_ms < 5000 else (50 if median_correct_time_ms and med
  • Проблема: Магические числа 5000/15000/100/50/20 — сложно поддерживать
  • Как воспроизвести: —
  • Что сделать: Вынести в константы
  • Confidence: 0.75

92. learning_update_skill_mastery_fluency_formula

  • Файл: routers/learning.py:0
  • Snippet: fluency = round(accuracy * 0.4 + active_knowledge * 0.3 + speed_score * 0.3, 2)
  • Проблема: Веса 0.4/0.3/0.3 захардкожены — сложно тюнить
  • Как воспроизвести: —
  • Что сделать: Вынести в константы
  • Confidence: 0.7

93. learning_update_skill_mastery_mastery_formula

  • Файл: routers/learning.py:0
  • Snippet: mastery = round(accuracy * 0.4 + recent_accuracy * 0.3 + no_hint_score * 0.3, 2)
  • Проблема: Веса захардкожены
  • Как воспроизвести: —
  • Что сделать: Вынести в константы
  • Confidence: 0.7

94. learning_update_skill_mastery_no_hint_score

  • Файл: routers/learning.py:0
  • Snippet: no_hint_score = max(0, 100 - hint_dependency)
  • Проблема: Если hint_dependency=100 (все ответы с подсказкой), no_hint_score=0 — ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

95. learning_update_skill_mastery_long_term_accuracy

  • Файл: routers/learning.py:0
  • Snippet: long_term_accuracy = $23,
  • Проблема: long_term_accuracy = accuracy (все ответы) — семантически дублирует accuracy
  • Как воспроизвести: —
  • Что сделать: Определить, что такое long_term (например, ответы старше 30 дней)
  • Confidence: 0.7

96. learning_update_skill_mastery_error_count

  • Файл: routers/learning.py:0
  • Snippet: error_count = sum(1 for a in answers if not a["correct"] and a["wrong_because"])
  • Проблема: error_count считает только ошибки с wrong_because — ошибки без тега не учитываются
  • Как воспроизвести: —
  • Что сделать: Уточнить семантику
  • Confidence: 0.7

97. learning_update_skill_mastery_repeated_error_count

  • Файл: routers/learning.py:0
  • Snippet: repeated_error_count = sum(1 for count in error_types.values() if count >= 2)
  • Проблема: Считает количество типов ошибок, повторённых 2+ раз — ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

98. learning_update_skill_mastery_confidence_round

  • Файл: routers/learning.py:0
  • Snippet: confidence = round(min(100, max(0, confidence)), 2)
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

99. learning_update_skill_mastery_trend_insufficient

  • Файл: routers/learning.py:0
  • Snippet: if total_attempts < 3: trend = "insufficient_data"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

100. learning_update_skill_mastery_trend_else_stable

  • Файл: routers/learning.py:0
  • Snippet: else: trend = "stable"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

101. learning_update_skill_mastery_retention_status_else

  • Файл: routers/learning.py:0
  • Snippet: else: retention_status = "overdue"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

102. learning_update_skill_mastery_median_time

  • Файл: routers/learning.py:0
  • Snippet: median_time_ms = int(statistics.median(all_times)) if all_times else 0
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

103. learning_update_skill_mastery_avg_time

  • Файл: routers/learning.py:0
  • Snippet: avg_time_ms = int(sum(correct_times) / len(correct_times)) if correct_times else 0
  • Проблема: avg_time_ms считается только по правильным ответам — семантически странно (название 'average_time_ms')
  • Как воспроизвести: —
  • Что сделать: Переименовать в avg_correct_time_ms или считать по всем
  • Confidence: 0.7

104. learning_update_skill_mastery_passive_knowledge

  • Файл: routers/learning.py:0
  • Snippet: passive_knowledge = recognition_score if recognition_score is not None else 0
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

105. learning_update_skill_mastery_active_knowledge

  • Файл: routers/learning.py:0
  • Snippet: active_knowledge = round(sum(active_scores) / len(active_scores), 2) if active_scores else 0
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

106. learning_update_skill_mastery_recent_accuracy

  • Файл: routers/learning.py:0
  • Snippet: recent_accuracy = (recent_correct / len(recent) * 100) if recent else 0
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

107. learning_update_skill_mastery_calc_last_n

  • Файл: routers/learning.py:0
  • Snippet: def calc_last_n(n): last_n = answers[-n:] if len(answers) >= n else None if not last_n or len(last_n) <
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

108. learning_update_skill_mastery_accuracy

  • Файл: routers/learning.py:0
  • Snippet: accuracy = (correct_count / total_attempts * 100) if total_attempts > 0 else 0
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

109. learning_update_skill_mastery_total_attempts

  • Файл: routers/learning.py:0
  • Snippet: total_attempts = len(answers)
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

110. learning_update_skill_mastery_correct_count

  • Файл: routers/learning.py:0
  • Snippet: correct_count = sum(1 for a in answers if a["correct"])
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

111. learning_update_skill_mastery_recent

  • Файл: routers/learning.py:0
  • Snippet: recent = answers[-5:]
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

112. learning_update_skill_mastery_recent_correct

  • Файл: routers/learning.py:0
  • Snippet: recent_correct = sum(1 for a in recent if a["correct"])
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

113. learning_update_skill_mastery_hints_used

  • Файл: routers/learning.py:0
  • Snippet: hints_used = sum(1 for a in answers if a["hint_used"])
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

114. learning_update_skill_mastery_hint_dependency

  • Файл: routers/learning.py:0
  • Snippet: hint_dependency = (hints_used / total_attempts * 100) if total_attempts > 0 else 0
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

115. learning_update_skill_mastery_recognition

  • Файл: routers/learning.py:0
  • Snippet: recognition_answers = [a for a in answers if a["question_type"] == "recognition"]
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

116. learning_update_skill_mastery_production

  • Файл: routers/learning.py:0
  • Snippet: production_answers = [a for a in answers if a["question_type"] == "production"]
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

117. learning_update_skill_mastery_application

  • Файл: routers/learning.py:0
  • Snippet: application_answers = [a for a in answers if a["question_type"] == "application"]
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

118. learning_update_skill_mastery_recognition_score

  • Файл: routers/learning.py:0
  • Snippet: recognition_score = round((recognition_correct / recognition_attempts * 100), 2) if recognition_attempts > 0 else None
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

119. learning_update_skill_mastery_production_score

  • Файл: routers/learning.py:0
  • Snippet: production_score = round((production_correct / production_attempts * 100), 2) if production_attempts > 0 else None
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

120. learning_update_skill_mastery_application_score

  • Файл: routers/learning.py:0
  • Snippet: application_score = round((application_correct / application_attempts * 100), 2) if application_attempts > 0 else None
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

121. learning_update_skill_mastery_error_types

  • Файл: routers/learning.py:0
  • Snippet: error_types = {} for a in answers: if not a["correct"] and a["wrong_because"]: error_types[a["wr
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

122. learning_update_skill_mastery_last_attempt

  • Файл: routers/learning.py:0
  • Snippet: last_attempt = answers[-1]["created_at"]
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

123. learning_update_skill_mastery_days_since

  • Файл: routers/learning.py:0
  • Snippet: days_since = (now - last_attempt).days
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

124. learning_update_skill_mastery_previous_row

  • Файл: routers/learning.py:0
  • Snippet: previous_row = await conn.fetchrow(""" SELECT mastery_score, previous_mastery_score FROM user_skill_mastery
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

125. learning_update_skill_mastery_mastery_delta

  • Файл: routers/learning.py:0
  • Snippet: mastery_delta = round(mastery - previous_mastery, 2)
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

126. learning_update_skill_mastery_trend_improving

  • Файл: routers/learning.py:0
  • Snippet: if last_3_accuracy > last_10_accuracy + 5: trend = "improving"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

127. learning_update_skill_mastery_trend_declining

  • Файл: routers/learning.py:0
  • Snippet: elif last_3_accuracy < last_10_accuracy - 5: trend = "declining"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

128. learning_update_skill_mastery_trend_stable

  • Файл: routers/learning.py:0
  • Snippet: else: trend = "stable"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

129. learning_update_skill_mastery_retention_fresh

  • Файл: routers/learning.py:0
  • Snippet: if days_since == 0: retention_status = "fresh"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

130. learning_update_skill_mastery_retention_aging

  • Файл: routers/learning.py:0
  • Snippet: elif days_since <= 7: retention_status = "aging"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

131. learning_update_skill_mastery_retention_needs_review

  • Файл: routers/learning.py:0
  • Snippet: elif days_since <= 14: retention_status = "needs_review"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

132. learning_update_skill_mastery_retention_overdue

  • Файл: routers/learning.py:0
  • Snippet: else: retention_status = "overdue"
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

133. learning_update_skill_mastery_speed_score

  • Файл: routers/learning.py:0
  • Snippet: speed_score = 100 if median_correct_time_ms and median_correct_time_ms < 5000 else (50 if median_correct_time_ms and med
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

134. learning_update_skill_mastery_fluency

  • Файл: routers/learning.py:0
  • Snippet: fluency = round(accuracy * 0.4 + active_knowledge * 0.3 + speed_score * 0.3, 2)
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

135. learning_update_skill_mastery_confidence

  • Файл: routers/learning.py:0
  • Snippet: if len(recent) >= 3: if all(a["correct"] for a in recent[-3:]): confidence = min(100, mastery + 15)
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

136. learning_update_skill_mastery_confidence_else

  • Файл: routers/learning.py:0
  • Snippet: else: confidence = mastery
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

137. learning_update_skill_mastery_confidence_round2

  • Файл: routers/learning.py:0
  • Snippet: confidence = round(min(100, max(0, confidence)), 2)
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

138. learning_update_skill_mastery_insert

  • Файл: routers/learning.py:0
  • Snippet: await conn.execute(""" INSERT INTO user_skill_mastery (
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

139. learning_update_skill_mastery_return

  • Файл: routers/learning.py:0
  • Snippet: return { "skill_tag": skill_tag,
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

140. learning_update_topic_progress_lessons_total

  • Файл: routers/learning.py:0
  • Snippet: lessons_total = await conn.fetchval(""" SELECT COUNT(*) FROM learning_lessons WHERE topic_id = $1 AND is_active
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

141. learning_update_topic_progress_test_row

  • Файл: routers/learning.py:0
  • Snippet: test_row = await conn.fetchrow(""" SELECT test_completed, test_score FROM user_topic_progress WHERE user_id = $1
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

142. learning_update_topic_progress_topic_mastery

  • Файл: routers/learning.py:0
  • Snippet: if test_completed and test_score > 0: topic_mastery = round(float(skills_avg) * 0.4 + float(test_score) * 0.6, 2
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

143. learning_update_topic_progress_insert

  • Файл: routers/learning.py:0
  • Snippet: await conn.execute(""" INSERT INTO user_topic_progress (user_id, topic_id, lessons_total, lessons_completed, tes
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

144. learning_update_topic_progress_return

  • Файл: routers/learning.py:0
  • Snippet: return { "lessons_total": lessons_total,
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

145. learning_update_ai_context_current_level

  • Файл: routers/learning.py:0
  • Snippet: current_level = await conn.fetchval(""" SELECT current_level FROM users WHERE telegram_id = $1 """, user_id)
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

146. learning_update_ai_context_topics

  • Файл: routers/learning.py:0
  • Snippet: topics = await conn.fetch(""" SELECT topic_id, topic_mastery, test_completed FROM user_topic_progress WHERE user
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

147. learning_update_ai_context_completed_topics

  • Файл: routers/learning.py:0
  • Snippet: completed_topics = sum(1 for t in topics if t["test_completed"])
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

148. learning_update_ai_context_completed_lessons

  • Файл: routers/learning.py:0
  • Snippet: completed_lessons = await conn.fetchval(""" SELECT COUNT(*) FROM user_lesson_progress WHERE user_id = $1 AND com
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

149. learning_update_ai_context_level_topics_total

  • Файл: routers/learning.py:0
  • Snippet: level_topics_total = await conn.fetchval(""" SELECT COUNT(*) FROM learning_topics WHERE level_code = $1 AND is_a
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

150. learning_update_ai_context_level_completion_percent

  • Файл: routers/learning.py:0
  • Snippet: level_completion_percent = round((completed_topics / level_topics_total * 100), 2) if level_topics_total > 0 else 0
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

151. learning_update_ai_context_overall_mastery

  • Файл: routers/learning.py:0
  • Snippet: overall_mastery = await conn.fetchval(""" SELECT COALESCE(AVG(topic_mastery), 0) FROM user_topic_progress WHERE
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

152. learning_update_ai_context_errors

  • Файл: routers/learning.py:0
  • Snippet: errors = await conn.fetch(""" SELECT wrong_because, COUNT(*) as cnt FROM user_learning_answers W
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

153. learning_update_ai_context_recurring_errors

  • Файл: routers/learning.py:0
  • Snippet: recurring_errors = [e["wrong_because"] for e in errors]
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

154. learning_update_ai_context_insert

  • Файл: routers/learning.py:0
  • Snippet: await conn.execute(""" INSERT INTO ai_user_context (user_id, current_level, completed_topics, level_topics_total
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

155. learning_update_ai_context_return

  • Файл: routers/learning.py:0
  • Snippet: return { "completed_topics": completed_topics,
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

156. learning_get_learning_levels

  • Файл: routers/learning.py:0
  • Snippet: @router.get("/levels") async def get_learning_levels(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

157. learning_get_topics

  • Файл: routers/learning.py:0
  • Snippet: @router.get("/topics") async def get_topics(request: Request, level: str = "A1"):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

158. learning_get_topic

  • Файл: routers/learning.py:0
  • Snippet: @router.get("/topics/{topic_id}") async def get_topic(request: Request, topic_id: str):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

159. learning_get_lesson

  • Файл: routers/learning.py:0
  • Snippet: @router.get("/lessons/{lesson_id}") async def get_lesson(request: Request, lesson_id: str):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

160. learning_get_topic_test

  • Файл: routers/learning.py:0
  • Snippet: @router.get("/test/{topic_id}") async def get_topic_test(request: Request, topic_id: str):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

161. learning_start_session

  • Файл: routers/learning.py:0
  • Snippet: @router.post("/session/start") async def start_session(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

162. learning_save_answer

  • Файл: routers/learning.py:0
  • Snippet: @router.post("/answer") async def save_answer(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

163. learning_complete_session

  • Файл: routers/learning.py:0
  • Snippet: @router.post("/session/complete") async def complete_session(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

164. learning_get_learning_progress

  • Файл: routers/learning.py:0
  • Snippet: @router.get("/progress") async def get_learning_progress(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

165. learning_get_analytics

  • Файл: routers/learning.py:0
  • Snippet: @router.post("/analytics") async def get_analytics(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

166. learning_get_ai_context

  • Файл: routers/learning.py:0
  • Snippet: @router.get("/ai/context") async def get_ai_context(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

167. learning_start_weak_skills_practice

  • Файл: routers/learning.py:0
  • Snippet: @router.post("/practice/start") async def start_weak_skills_practice(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

168. learning_profile_get_weak_skills

  • Файл: routers/learning_profile.py:0
  • Snippet: async def get_weak_skills(conn, user_id: int, limit: int = 5):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

169. learning_profile_get_strong_skills

  • Файл: routers/learning_profile.py:0
  • Snippet: async def get_strong_skills(conn, user_id: int, limit: int = 8):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

170. learning_profile_get_profile_hash

  • Файл: routers/learning_profile.py:0
  • Snippet: def get_profile_hash(weak_skills: list) -> str:
  • Проблема: Функция get_profile_hash не используется нигде в коде — мёртвый код
  • Как воспроизвести: grep get_profile_hash → только определение
  • Что сделать: Удалить или использовать для кэша
  • Confidence: 0.85

171. teacher_get_ai_limit_message

  • Файл: routers/teacher.py:0
  • Snippet: def get_ai_limit_message(lang: str) -> str:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

172. teacher_normalize_answer

  • Файл: routers/teacher.py:0
  • Snippet: def normalize_answer(text: str) -> str:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

173. teacher_get_user_lang

  • Файл: routers/teacher.py:0
  • Snippet: async def get_user_lang(conn, user_id: int) -> str:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

174. teacher_get_teacher_ai_usage

  • Файл: routers/teacher.py:0
  • Snippet: async def get_teacher_ai_usage(conn, user_id: int) -> int:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

175. teacher_increment_teacher_ai_usage

  • Файл: routers/teacher.py:0
  • Snippet: async def increment_teacher_ai_usage(conn, user_id: int) -> None:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

176. teacher_check_ai_limit

  • Файл: routers/teacher.py:0
  • Snippet: async def check_ai_limit(conn, user_id: int) -> bool:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

177. teacher_start_learning_session

  • Файл: routers/teacher.py:0
  • Snippet: async def start_learning_session(conn, user_id: int, level_code: str, topic_id: str, session_type: str) -> int:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

178. teacher_save_answer_to_session

  • Файл: routers/teacher.py:0
  • Snippet: async def save_answer_to_session(conn, user_id: int, session_id: int, question_data: dict, selected_answer: str, correct
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

179. teacher_update_mastery_after_lesson

  • Файл: routers/teacher.py:0
  • Snippet: async def update_mastery_after_lesson(conn, user_id: int, session_id: int) -> None:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

180. teacher_call_ai

  • Файл: routers/teacher.py:0
  • Snippet: async def call_ai(prompt: str, system_prompt: str, max_tokens: int = 500) -> str:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

181. teacher_get_wrong_answer_ai_explanation

  • Файл: routers/teacher.py:0
  • Snippet: async def get_wrong_answer_ai_explanation(telegram_id: int, lang: str, prompt_text: str, selected_answer: str, correct_a
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

182. teacher_check_ai_limit_for_fallback

  • Файл: routers/teacher.py:0
  • Snippet: async def _check_ai_limit_for_fallback(telegram_id: int, lang: str) -> bool:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

183. teacher_get_phrase_of_day

  • Файл: routers/teacher.py:0
  • Snippet: @router.get("/phrase-of-day") async def get_phrase_of_day(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

184. teacher_resume

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/resume") async def teacher_resume(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

185. teacher_start

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/start") async def teacher_start(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

186. teacher_answer

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/answer") async def teacher_answer(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

187. teacher_explain

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/explain") async def teacher_explain(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

188. teacher_examples

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/examples") async def teacher_examples(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

189. teacher_free_message

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/free-message") async def teacher_free_message(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

190. teacher_diagnostic_test

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/diagnostic-test") async def teacher_diagnostic_test(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

191. teacher_translate_to_polish

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/translate-to-polish") async def teacher_translate_to_polish(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

192. teacher_progress

  • Файл: routers/teacher.py:0
  • Snippet: @router.get("/progress") async def teacher_progress(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

193. teacher_save_teacher_history

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/history/save") async def save_teacher_history(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

194. teacher_load_teacher_history

  • Файл: routers/teacher.py:0
  • Snippet: @router.get("/history/load") async def load_teacher_history(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

195. teacher_clear_teacher_history

  • Файл: routers/teacher.py:0
  • Snippet: @router.post("/history/clear") async def clear_teacher_history(request: Request):
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

196. orchestrator_get_next_lesson

  • Файл: routers/orchestrator.py:0
  • Snippet: async def get_next_lesson(conn, user_id: int) -> Dict[str, Any]:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

197. orchestrator_get_lesson_by_id

  • Файл: routers/orchestrator.py:0
  • Snippet: async def get_lesson_by_id(conn, lesson_id: str) -> Optional[Dict[str, Any]]:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

198. orchestrator_get_lesson_questions

  • Файл: routers/orchestrator.py:0
  • Snippet: async def get_lesson_questions(conn, lesson_id: str) -> list:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

199. orchestrator_get_test_questions

  • Файл: routers/orchestrator.py:0
  • Snippet: async def get_test_questions(conn, topic_id: str) -> list:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

200. orchestrator_get_random_reaction

  • Файл: routers/orchestrator.py:0
  • Snippet: async def get_random_reaction(conn, reaction_type: str, lang: str) -> str:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

201. orchestrator_get_wrong_because_explanation

  • Файл: routers/orchestrator.py:0
  • Snippet: async def get_wrong_because_explanation(conn, wrong_because: str, lang: str) -> str:
  • Проблема: Ок
  • Как воспроизвести: —
  • Что сделать: Ок
  • Confidence: 0.7

202. admin_dashboard_online_now_union_dup

  • Файл: routers/admin.py:60
  • Snippet: SELECT user_id FROM user_progress WHERE completed_at > NOW() - INTERVAL '30 minutes' UNION
  • Проблема: Метрика online_now может быть завышена, если в таблицах есть user_id, не существующие в users (нет JOIN с users).
  • Как воспроизвести: Открыть /admin/dashboard → online_now включает удалённых/несуществующих юзеров.
  • Что сделать: Добавить JOIN users u ON u.telegram_id = active.user_id или фильтр EXISTS (SELECT 1 FROM users WHERE telegram_id = user_id).
  • Confidence: 0.72

203. admin_dashboard_active_24h_mixed_semantics

  • Файл: routers/admin.py:78
  • Snippet: SELECT user_id FROM daily_logins WHERE login_date = CURRENT_DATE ) active
  • Проблема: active_24h смешивает 24-часовое окно с календарным днём (login_date = CURRENT_DATE), метрика неконсистентна.
  • Как воспроизвести: Открыть /admin/dashboard в 00:05 → active_24h резко падает, хотя за последние 24ч активность была.
  • Что сделать: Использовать login_at > NOW() - INTERVAL '24 hours' (если есть timestamp) или убрать ветку daily_logins.
  • Confidence: 0.8

204. admin_content_update_lesson_n_plus_1

  • Файл: routers/admin_content.py:900
  • Snippet: for q in questions: # Проверяем, что вопрос принадлежит этому уроку q_exists = await con
  • Проблема: Сохранение урока с 20 вопросами делает 20+ round-trip к БД внутри транзакции — медленно, риск таймаута.
  • Как воспроизвести: PUT /admin/content/lessons/lesson/{id} с большим числом вопросов → заметная задержка.
  • Что сделать: Один SELECT question_id FROM learning_questions WHERE lesson_id=$1 AND question_id = ANY($2) до цикла, затем проверка в Python.
  • Confidence: 0.85

205. admin_content_update_lesson_insert_n_plus_1

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

206. admin_content_update_lesson_examples_insert_n_plus_1

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

207. admin_content_get_lesson_wb_full_scan

  • Файл: routers/admin_content.py:780
  • Snippet: wb_rows = await conn.fetch(""" SELECT wrong_because, explanation_ru FROM wrong_because_explanati
  • Проблема: Справочник wrong_because тянется целиком при каждом открытии урока, хотя нужен только explanation_ru для встреченных кодов.
  • Как воспроизвести: GET /admin/content/lessons/lesson/{id} → полный SELECT справочника.
  • Что сделать: Тянуть только нужные коды: WHERE wrong_because = ANY($1) после сбора кодов из опций.
  • Confidence: 0.7

208. feed_update_removed_images_duplicate_logic

  • Файл: routers/feed.py:480
  • Snippet: removed_images = body.get("removed_images", []) if removed_images and isinstance(removed_images, list):
  • Проблема: Логика парсинга URL и удаления файлов дублируется в двух местах (внутри pool.acquire и после) — риск расхождения поведения.
  • Как воспроизвести: Правка одного из блоков → второй остаётся со старой логикой.
  • Что сделать: Вынести парсинг rel_path в helper _normalize_upload_path(img_url) и использовать в обоих местах.
  • Confidence: 0.8

209. support_admin_tickets_n_plus_1_subqueries

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

210. assistant_history_returns_all_messages

  • Файл: routers/assistant.py:425
  • Snippet: rows = await conn.fetch(""" SELECT message, is_user, created_at FROM chat_history WHERE user_id
  • Проблема: Не баг сейчас (save_message чистит до 10), но при сбое очистки или ручном INSERT история может разрастись и вернуть сотни сообщений
  • Как воспроизвести: вставить вручную 1000 строк в chat_history → GET /assistant/history вернёт все 1000
  • Что сделать: Добавить LIMIT MAX_HISTORY в SELECT истории
  • Confidence: 0.7

211. tts_cache_path_hardcoded

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

212. cors_credentials_false_with_auth_header

  • Файл: main.py:258
  • Snippet: allow_credentials=False,
  • Проблема: не баг сейчас (auth через Authorization: tma), но при переходе на cookie-сессии CORS сломается молча
  • Как воспроизвести: добавить cookie-auth → preflight вернёт без Access-Control-Allow-Credentials
  • Что сделать: оставить как есть, но задокументировать; либо включить credentials и сузить origins
  • Confidence: 0.7

213. health_endpoint_leaks_db_error

  • Файл: main.py:320
  • Snippet: logger.error(f"Healthcheck failed: {e}")
  • Проблема: не влияет на ученика, но в логах может оказаться connection string/пароль из исключения asyncpg
  • Как воспроизвести: сломать DB_CONFIG → в логах увидеть детали подключения
  • Что сделать: логировать тип ошибки без str(e) или маскировать чувствительные поля
  • Confidence: 0.7

214. init_db_giant_transaction_blocks_startup

  • Файл: database.py:20
  • Snippet: async with conn.transaction():
  • Проблема: вся инициализация (десятки DDL + ALTER + DELETE дублей) в одной транзакции — при большом user_progress блокировка таблиц на минуты, старт API зависает, ученики видят 502
  • Как воспроизвести: рестарт с большой user_progress → DELETE FROM user_progress ... ctid NOT IN (...) держит lock
  • Что сделать: вынести тяжёлые миграции в отдельный скрипт/миграции Alembic, оставить в init_db только CREATE IF NOT EXISTS
  • Confidence: 0.78

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

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

# 🤖 AI Code Review (Backend) **Дата:** 2026-09-25 18:12 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` ## 📊 По пакам - **routers_games** — 7 файлов, 65,802 символов, находок=10 - **routers_learning** — 4 файлов, 100,197 символов, находок=174 - **routers_admin** — 4 файлов, 97,143 символов, находок=10 - **routers_misc** — 5 файлов, 69,714 символов, находок=10 - **core** — 4 файлов, 69,897 символов, находок=10 - **services** — 0 файлов, 0 символов, находок=0 --- ## 🔴 Влияет на ученика (25) ### 1. hint_consumed_on_403_limit - **Файл:** `routers/hints.py:30` - **Snippet:** `if hints_already_used >= MAX_HINTS: raise HTTPException(403, "Hint limit reached")` - **Проблема:** ученик получает 403, но подсказка не выдана — при этом лимит уже исчерпан - **Как воспроизвести:** взять 3 подсказки → 4-й запрос возвращает 403, но hints_used не растёт (это ок), однако клиент может считать что подсказка потрачена - **Что сделать:** проверять лимит до инкремента (уже так), но вернуть в теле ответа hints_used_total для синхронизации UI - **Confidence:** 0.72 ### 2. word_list_hint_consumed_on_403 - **Файл:** `routers/hints.py:130` - **Snippet:** `if hints_already_used >= MAX_HINTS: raise HTTPException(403, "Hint limit reached")` - **Проблема:** то же самое — 403 без выдачи подсказки - **Как воспроизвести:** аналогично first-letter - **Что сделать:** то же — атомарный инкремент с условием - **Confidence:** 0.7 ### 3. update_skill_mastery_previous_mastery_default - **Файл:** `routers/learning.py:0` - **Snippet:** `previous_mastery = float(previous_row["mastery_score"]) if previous_row and previous_row["mastery_score"] else mastery` - **Проблема:** При первом расчёте mastery_delta=0, но при повторном — если предыдущий mastery был 0, delta считается от нового значения (0), что искажает тренд - **Как воспроизвести:** Первый расчёт: mastery=50, previous=50, delta=0. Второй: mastery=60, previous=50, delta=10 (ок). Но если previous_row.mastery_score=0 → previous=mastery → delta=0 - **Что сделать:** Различать 'нет записи' и 'mastery_score=0': использовать `is not None` - **Confidence:** 0.75 ### 4. analytics_ai_response_keyerror - **Файл:** `routers/learning.py:0` - **Snippet:** `data = response.json() ai_response = data["choices"][0]["message"]["content"].strip()` - **Проблема:** Если Together AI вернёт неожиданный формат — 500 вместо fallback-текста - **Как воспроизвести:** Together AI возвращает {'error': ...} → KeyError → 500 - **Что сделать:** Обернуть в try/except как в teacher.call_ai, использовать .get() - **Confidence:** 0.85 ### 5. analytics_ai_no_timeout_retry - **Файл:** `routers/learning.py:0` - **Snippet:** `async with httpx.AsyncClient(timeout=90.0) as client:` - **Проблема:** При таймауте AI — 500 без fallback, ученик не получает аналитику - **Как воспроизвести:** Together AI недоступен → httpx.TimeoutException → 500 - **Что сделать:** try/except вокруг httpx, возвращать fallback-сообщение - **Confidence:** 0.8 ### 6. teacher_answer_ai_explanation_outside_conn - **Файл:** `routers/teacher.py:0` - **Snippet:** `explanation_text = db_explanation if needs_ai_explanation: explanation_text = await get_wrong_answer_ai_expl` - **Проблема:** AI-вызов происходит ПОСЛЕ закрытия соединения — если AI упадёт, ответ уже сохранён, но ученик не получит объяснение (ок), однако session_completed уже зафиксирован - **Как воспроизвести:** AI timeout → explanation_text='' → ученик видит пустое объяснение - **Что сделать:** Ок как есть, но fallback уже есть в get_wrong_answer_ai_explanation - **Confidence:** 0.7 ### 7. teacher_resume_lesson_id_from_first_lesson - **Файл:** `routers/teacher.py:0` - **Snippet:** `lesson_id = await conn.fetchval(""" SELECT lesson_id FROM learning_lessons WHERE` - **Проблема:** Если сессия была по 3-му уроку темы, resume вернёт вопросы 1-го урока — ученик потеряет прогресс - **Как воспроизвести:** Начать урок 3 темы → прервать → /resume → вопросы урока 1 - **Что сделать:** Хранить lesson_id в learning_sessions или брать из последнего ответа сессии - **Confidence:** 0.85 ### 8. teacher_resume_question_not_found - **Файл:** `routers/teacher.py:0` - **Snippet:** `last_question_id = last_answer["question_id"] last_index = 0 for i, q in enumerate(questions): ` - **Проблема:** Если вопрос удалён/деактивирован, last_index=0 → resume вернёт вопрос 1, ученик застрянет - **Как воспроизвести:** Вопрос удалён из БД → resume возвращает questions[1] вместо следующего - **Что сделать:** Если вопрос не найден — завершать сессию или искать по created_at - **Confidence:** 0.75 ### 9. teacher_phrase_of_day_ai_failure_cached - **Файл:** `routers/teacher.py:0` - **Snippet:** `if ai_response: # Парсим текстовый ответ построчно` - **Проблема:** Если AI упал — фраза-заглушка 'Lepiej późno niż wcale' кэшируется на весь день для всех юзеров - **Как воспроизвести:** AI timeout в 00:00 → все юзеры весь день видят одну и ту же фразу - **Что сделать:** Не кэшировать fallback: если ai_response пустой — не INSERT, вернуть fallback без сохранения - **Confidence:** 0.82 ### 10. teacher_diagnostic_test_no_level_filter - **Файл:** `routers/teacher.py:0` - **Snippet:** `questions = await conn.fetch(""" SELECT * FROM learning_questions WHERE is_test_question = TRUE ` - **Проблема:** Диагностический тест берёт вопросы всех уровней (A1-C2) случайно — новичок получит C2-вопросы - **Как воспроизвести:** POST /teacher/diagnostic-test → вопросы уровня C1 для A1-юзера - **Что сделать:** Стратифицировать по уровням: 3 вопроса A1, 3 A2, 3 B1 и т.д. - **Confidence:** 0.85 ### 11. teacher_diagnostic_test_no_result_processing - **Файл:** `routers/teacher.py:0` - **Snippet:** `session_id = await start_learning_session(conn, telegram_id, user_level, "", "diagnostic_test")` - **Проблема:** Результат диагностического теста не обновляет current_level пользователя — тест бесполезен - **Как воспроизвести:** Пройти diagnostic_test → current_level не меняется - **Что сделать:** В complete_session обрабатывать session_type='diagnostic_test' и обновлять users.current_level - **Confidence:** 0.85 ### 12. teacher_phrase_of_day_ai_failure_no_retry - **Файл:** `routers/teacher.py:0` - **Snippet:** `ai_response = await call_ai(user_prompt, system_prompt, max_tokens=1000)` - **Проблема:** Если AI упал — фраза дня = заглушка на весь день - **Как воспроизвести:** — - **Что сделать:** Retry 1-2 раза или не кэшировать fallback - **Confidence:** 0.75 ### 13. teacher_answer_returns_correct_answer_text - **Файл:** `routers/teacher.py:0` - **Snippet:** `correct_answer_text = "" for opt in options: if opt["is_correct"]:` - **Проблема:** correct_answer_text возвращается в ответе даже когда is_correct=true — не критично, но при is_correct=false тоже отдаётся (ок для обучения) - **Как воспроизвести:** — - **Что сделать:** Ок для обучающего режима - **Confidence:** 0.7 ### 14. learning_answer_returns_wrong_because - **Файл:** `routers/learning.py:0` - **Snippet:** `return {"correct": correct, "wrong_because": wrong_because}` - **Проблема:** wrong_because отдаётся клиенту — ок для обучения, но можно использовать для reverse-engineering правильного ответа - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 15. learning_analytics_regex_strips_legit_text - **Файл:** `routers/learning.py:0` - **Snippet:** `ai_response = re.sub(r'\s*\([a-z_]+_[a-z_]+\)', '', ai_response)` - **Проблема:** Regex удаляет любые скобки с подчёркиванием, включая легитимные (например, '(hello_world)') - **Как воспроизвести:** AI пишет 'слово (hello_world)' → 'слово' - **Что сделать:** Удалять только известные skill_tag из БД - **Confidence:** 0.75 ### 16. learning_analytics_no_lang_in_prompt - **Файл:** `routers/learning.py:0` - **Snippet:** `system_prompt = f"""Ты — AI-наставник польского языка в приложении Filwords PL.` - **Проблема:** Промпт требует 'Отвечай на языке пользователя', но язык не передаётся — AI угадывает - **Как воспроизвести:** Юзер с lang=pl → AI может ответить на русском - **Что сделать:** Загрузить lang через get_user_lang и передать в промпт - **Confidence:** 0.85 ### 17. learning_analytics_weak_lessons_empty - **Файл:** `routers/learning.py:0` - **Snippet:** `weak_lessons_lines = '\n'.join([f'- {l["title_ru"]} (тема: {l["topic_name"]})' for l in weak_lessons])` - **Проблема:** Если weak_lessons пуст — в промпт попадает пустая строка, AI может галлюцинировать уроки - **Как воспроизвести:** weak_skills есть, но уроков по ним нет → AI выдумывает уроки - **Что сделать:** Если weak_lessons пуст — не включать секцию в промпт - **Confidence:** 0.75 ### 18. learning_practice_start_no_questions_fallback - **Файл:** `routers/learning.py:0` - **Snippet:** `if not questions: return {"has_weak_skills": True, "questions": [], "message": "Для этих навыков пока нет во` - **Проблема:** Сессия уже создана в БД, но возвращается пустой ответ — сессия висит незавершённой - **Как воспроизвести:** POST /learning/practice/start → пустой ответ → сессия в БД is_completed=false - **Что сделать:** Создавать сессию только после проверки наличия вопросов - **Confidence:** 0.8 ### 19. learning_update_skill_mastery_previous_mastery_float - **Файл:** `routers/learning.py:0` - **Snippet:** `previous_mastery = float(previous_row["mastery_score"]) if previous_row and previous_row["mastery_score"] else mastery` - **Проблема:** Если previous mastery_score=0 (Decimal('0')), `if previous_row["mastery_score"]` = False → previous=mastery → delta=0 (неверно) - **Как воспроизвести:** Первый расчёт mastery=50 → previous=50, delta=0. Второй: mastery=60, previous=50, delta=10. Но если предыдущий был 0 → previous=60, delta=0 - **Что сделать:** Использовать `is not None` вместо truthy-проверки - **Confidence:** 0.8 ### 20. leaderboard_rank_off_by_one_for_cached_user - **Файл:** `routers/leaderboard.py:60` - **Snippet:** `user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot` - **Проблема:** Ученик видит свой ранг на 1 выше реального (например, 5-е место вместо 6-го), если у кого-то равный total_score - **Как воспроизвести:** два юзера с одинаковым total_score в leaderboard_cache → у обоих my_rank.rank одинаковый, но по факту один выше другого - **Что сделать:** Использовать RANK() OVER (ORDER BY total_score DESC) или считать COUNT(*) + 1 WHERE total_score > $1 OR (total_score = $1 AND telegram_id < $2) - **Confidence:** 0.78 ### 21. leaderboard_rank_ignores_zero_score_users - **Файл:** `routers/leaderboard.py:55` - **Snippet:** `user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE tot` - **Проблема:** Новый ученик с 0 очков видит себя на позиции N+1 (после всех с очками), но в самом списке leaderboard его нет — рассинхрон между my_rank и leaderboard - **Как воспроизвести:** новый юзер → GET /leaderboard → my_rank.rank = 100, но в leaderboard[] его нет - **Что сделать:** Либо добавлять юзера в leaderboard[] при отсутствии в кэше, либо явно возвращать rank=null и флаг not_ranked - **Confidence:** 0.75 ### 22. leaderboard_rank_achievement_uses_wrong_value - **Файл:** `routers/leaderboard.py:220` - **Snippet:** `if my_position <= 3: await check_and_award_achievements(telegram_id, "rank_reached", my_position)` - **Проблема:** Достижение rank_1 (value=1) выдаётся только при my_position==1, но rank_top3 (value=3) требует requirement_value <= value — при my_position=2 условие 3<=2 ложно, достижение top3 не выдаётся - **Как воспроизвести:** юзер занял 2 место → check_and_award_achievements(..., 'rank_reached', 2) → rank_top3 (value=3) не проходит фильтр 3<=2 - **Что сделать:** Передавать value=3 при попадании в топ-3, либо инвертировать логику: requirement_value >= value для rank_reached - **Confidence:** 0.82 ### 23. assistant_save_message_before_ai_call - **Файл:** `routers/assistant.py:210` - **Snippet:** `await save_message(telegram_id, user_message, True) history = await get_history(telegram_id)` - **Проблема:** При ошибке AI (timeout/500) сообщение пользователя уже сохранено в истории, но ответа нет — при следующем запросе модель видит «висящий» вопрос без ответа - **Как воспроизвести:** отправить сообщение → AI timeout → в /assistant/history висит user-сообщение без assistant-ответа - **Что сделать:** Сохранять user_message только после успешного ответа AI, либо помечать сообщение как failed и удалять при ошибке - **Confidence:** 0.75 ### 24. users_set_language_no_user_check - **Файл:** `routers/users.py:55` - **Snippet:** `await conn.execute( "UPDATE users SET app_language = $1 WHERE telegram_id = $2", lang, user_id, ` - **Проблема:** Если юзер не зарегистрирован (нет в users), UPDATE молча ничего не делает, но API возвращает status:ok — клиент думает, что язык сохранён - **Как воспроизвести:** вызвать POST /users/set-language без предварительного /register → 200 ok, но в БД ничего - **Что сделать:** Проверять rowcount или существование юзера (как в set_level) и возвращать 401 - **Confidence:** 0.8 ### 25. rate_limiter_default_60_per_min_global - **Файл:** `main.py:89` - **Snippet:** `"default": {"max_requests": 60, "window": 60},` - **Проблема:** любой не перечисленный эндпоинт (например /users/me, /feed) лимитируется 60 req/min на IP:path — при активной навигации ученик получает 429 - **Как воспроизвести:** открыть приложение, быстро переключать экраны → часть запросов падает с 429 Too many requests - **Что сделать:** увеличить default или добавить лимиты для всех реально используемых путей - **Confidence:** 0.72 ## 🟠 Риск для данных (39) ### 26. hint_race_condition_limit - **Файл:** `routers/hints.py:60` - **Snippet:** `await conn.execute(""" INSERT INTO user_progress (user_id, level_id, hints_used) VALUES ($1, $2,` - **Проблема:** при параллельных запросах можно получить больше 3 подсказок (лимит обходится) - **Как воспроизвести:** отправить 5 параллельных GET /hints/first-letter/{id} — все пройдут проверку hints_already_used < 3 - **Что сделать:** использовать SELECT ... FOR UPDATE или атомарный UPDATE ... WHERE hints_used < 3 RETURNING hints_used - **Confidence:** 0.85 ### 27. wordquiz_check_trusts_client_correct_polish - **Файл:** `routers/wordquiz.py:130` - **Snippet:** `correct_polish = body.get("correct_polish", "") user_answer = body.get("answer", "")` - **Проблема:** клиент может подставить любой correct_polish и всегда получать очки - **Как воспроизвести:** POST /wordquiz/check {correct_polish: 'x', answer: 'x'} → correct=true, score начислен - **Что сделать:** хранить правильный ответ на сервере (по quiz_session_id) или валидировать, что correct_polish есть в level_words текущего уровня - **Confidence:** 0.9 ### 28. wordquiz_check_no_level_validation - **Файл:** `routers/wordquiz.py:145` - **Snippet:** `is_correct = user_answer.strip().lower() == correct_polish.strip().lower()` - **Проблема:** можно начислять очки за слова не из своего уровня - **Как воспроизвести:** отправить correct_polish из другого уровня - **Что сделать:** проверять, что correct_polish принадлежит level_words с level = user.current_level - **Confidence:** 0.85 ### 29. wordquiz_consolation_score_repeatable - **Файл:** `routers/wordquiz.py:220` - **Snippet:** `if mistakes >= 3: await conn.execute(""" INSERT INTO word_quiz_progress (user_id, wo` - **Проблема:** можно бесконечно получать +10 очков за каждую 3-ю ошибку, отвечая неверно - **Как воспроизвести:** 3 раза ответить неверно → +10, ещё 3 раза → +10, и т.д. - **Что сделать:** сбрасывать current_mistakes после начисления утешительных очков или ограничить частоту - **Confidence:** 0.8 ### 30. bubblewords_completion_time_trusted - **Файл:** `routers/bubblewords.py:190` - **Snippet:** `if completion_time is not None and completion_time > 0 and int(completion_time) <= 45: achievements_to_check` - **Проблема:** клиент может подставить completion_time=1 и получить достижение bubble_speed - **Как воспроизвести:** POST /bubblewords/complete {completion_time: 1} - **Что сделать:** замерять время на сервере (сохранять started_at при /next) - **Confidence:** 0.85 ### 31. sentences_check_trusts_completion_time - **Файл:** `routers/sentences.py:175` - **Snippet:** `if completion_time is not None and completion_time > 0: achievements_to_check.append(("speed_sentence", ` - **Проблема:** клиент может подставить любое время для достижения speed_sentence - **Как воспроизвести:** POST /sentences/check {completion_time: 1} - **Что сделать:** замерять время на сервере - **Confidence:** 0.8 ### 32. typing_check_no_progress_validation - **Файл:** `routers/typing.py:70` - **Snippet:** `if is_correct: # Сохраняем прогресс await conn.execute(""" INSERT INTO typing_pr` - **Проблема:** нет проверки, что предложение принадлежит уровню пользователя; нет защиты от читерства по времени - **Как воспроизвести:** отправить sentence_id из другого уровня - **Что сделать:** проверять s.level = user.current_level и добавить минимальное время - **Confidence:** 0.75 ### 33. answer_uses_client_hint_used - **Файл:** `routers/learning.py:0` - **Snippet:** `hint_used = body.get("hint_used", False)` - **Проблема:** Ученик может подделать hint_used=false, чтобы завысить mastery и fluency - **Как воспроизвести:** POST /learning/answer с hint_used=false после реального использования подсказки → hint_dependency не растёт, mastery завышен - **Что сделать:** Сервер должен сам фиксировать факт подсказки (например, отдельный endpoint /hint/use), а не доверять клиенту - **Confidence:** 0.85 ### 34. answer_uses_client_time_taken - **Файл:** `routers/learning.py:0` - **Snippet:** `time_taken_ms = body.get("time_taken_ms", 0)` - **Проблема:** Ученик может присылать time_taken_ms=100 и получать fluency_score=100 без реальной скорости - **Как воспроизвести:** POST /learning/answer с time_taken_ms=1 → median_correct_time_ms < 5000 → speed_score=100 - **Что сделать:** Замерять время на сервере (session start → answer) или валидировать разумные границы - **Confidence:** 0.8 ### 35. answer_uses_client_is_final - **Файл:** `routers/learning.py:0` - **Snippet:** `is_final = body.get("is_final_answer", True)` - **Проблема:** Клиент может пометить все ответы is_final_answer=false, чтобы session/complete показал 0/0 и не портил статистику - **Как воспроизвести:** POST /learning/answer с is_final_answer=false → stats.total=0 → score=0, но mastery пересчитывается по всем ответам - **Что сделать:** Определять is_final_answer на сервере по позиции вопроса в сессии - **Confidence:** 0.75 ### 36. answer_no_session_owner_check - **Файл:** `routers/learning.py:0` - **Snippet:** `session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1", session_id)` - **Проблема:** Атакующий может записать ответы в чужую сессию, испортив чужую аналитику - **Как воспроизвести:** POST /learning/answer с session_id жертвы → ответ записан в чужую сессию (проверка владельца есть, но только после fetch — ок, но лучше одним запросом) - **Что сделать:** SELECT ... WHERE id=$1 AND user_id=$2 одним запросом, fail fast - **Confidence:** 0.7 ### 37. complete_session_no_owner_check - **Файл:** `routers/learning.py:0` - **Snippet:** `session = await conn.fetchrow("SELECT * FROM learning_sessions WHERE id = $1 AND user_id = $2", session_id, telegram_id)` - **Проблема:** Если session_id=None, запрос вернёт None → 404, но при передаче чужого id — 404 (ок). Проблема: session_id не валидируется на тип - **Как воспроизвести:** POST /learning/session/complete с session_id='abc' → asyncpg может кинуть ошибку типа → 500 - **Что сделать:** Валидировать session_id как int, возвращать 400 при неверном типе - **Confidence:** 0.72 ### 38. update_skill_mastery_retention_score_hardcoded - **Файл:** `routers/learning.py:0` - **Snippet:** `retention_score, hint_dependency, average_time_ms, median_time_ms, median_correct_time_ms, median_wrong_time` - **Проблема:** retention_score всегда 0 в БД, хотя в ON CONFLICT он не обновляется — retention_score остаётся 0 навсегда - **Как воспроизвести:** SELECT retention_score FROM user_skill_mastery → всегда 0 - **Что сделать:** Либо вычислять retention_score, либо убрать поле из INSERT/схемы - **Confidence:** 0.82 ### 39. get_lesson_no_owner_check - **Файл:** `routers/learning.py:0` - **Snippet:** `lesson = await conn.fetchrow("SELECT * FROM learning_lessons WHERE lesson_id = $1", lesson_id)` - **Проблема:** Ученик может получить любой урок, включая неактивные (is_active не проверяется) - **Как воспроизвести:** GET /learning/lessons/{id} для is_active=false урока → возвращается - **Что сделать:** Добавить `AND is_active = TRUE` - **Confidence:** 0.75 ### 40. get_topic_no_active_check - **Файл:** `routers/learning.py:0` - **Snippet:** `topic = await conn.fetchrow("SELECT * FROM learning_topics WHERE topic_id = $1", topic_id)` - **Проблема:** Можно получить неактивную тему - **Как воспроизвести:** GET /learning/topics/{id} для is_active=false → возвращается - **Что сделать:** Добавить `AND is_active = TRUE` - **Confidence:** 0.72 ### 41. start_session_no_topic_validation - **Файл:** `routers/learning.py:0` - **Snippet:** `topic_id = body.get("topic_id", "") session_type = body.get("session_type", "lesson")` - **Проблема:** Клиент может передать произвольный session_type (например, 'topic_test') и получить прогресс теста без прохождения - **Как воспроизвести:** POST /learning/session/start с session_type='topic_test' → complete_session засчитает тест - **Что сделать:** Валидировать session_type по whitelist и проверять, что тест доступен (уроки пройдены) - **Confidence:** 0.8 ### 42. complete_session_test_score_no_validation - **Файл:** `routers/learning.py:0` - **Snippet:** `if session["session_type"] == "topic_test": test_score = (stats["correct_count"] / stats["total"] * 100) if ` - **Проблема:** Клиент может создать сессию topic_test, ответить на 1 вопрос правильно и получить test_score=100 - **Как воспроизвести:** start_session(topic_test) → answer(1 вопрос) → complete → test_completed=true, test_score=100 - **Что сделать:** Проверять, что отвечено на все вопросы теста темы (сравнить с COUNT тестовых вопросов) - **Confidence:** 0.85 ### 43. teacher_ai_limit_race_condition - **Файл:** `routers/teacher.py:0` - **Snippet:** `if not await check_ai_limit(conn, telegram_id): return get_ai_limit_message(lang)` - **Проблема:** Параллельные запросы могут обойти лимит 5/день (check-then-act race) - **Как воспроизвести:** 5 параллельных POST /teacher/explain → все проходят check, все инкрементируют → 10 использований - **Что сделать:** Атомарный INSERT ... ON CONFLICT с проверкой count в одном запросе, или SELECT FOR UPDATE - **Confidence:** 0.8 ### 44. teacher_ai_usage_increment_after_call - **Файл:** `routers/teacher.py:0` - **Snippet:** `ai_response = await call_ai(content, system_prompt) if ai_response: async with pool.acquire() as conn: ` - **Проблема:** Если AI вернул пустую строку — лимит не инкрементируется, но запрос к AI уже потрачен (деньги) - **Как воспроизвести:** AI возвращает '' → usage не растёт, но токены списаны - **Что сделать:** Инкрементировать usage ДО вызова AI (или всегда после, независимо от результата) - **Confidence:** 0.78 ### 45. teacher_phrase_of_day_race - **Файл:** `routers/teacher.py:0` - **Snippet:** `today_phrase = await conn.fetchrow(""" SELECT * FROM daily_phrases WHERE phrase_date = $1 """, today` - **Проблема:** Параллельные запросы от разных юзеров в 00:00 UTC → N вызовов AI, N× стоимость - **Как воспроизвести:** 10 юзеров одновременно в 00:00 → 10 AI-вызовов для одной фразы - **Что сделать:** Использовать advisory lock или INSERT ... ON CONFLICT DO NOTHING RETURNING для атомарного создания - **Confidence:** 0.8 ### 46. teacher_free_message_no_rate_limit - **Файл:** `routers/teacher.py:0` - **Snippet:** `if len(user_message) > 300: raise HTTPException(400, "Message too long (max 300 characters)")` - **Проблема:** Лимит 300 символов, но нет защиты от prompt injection — ученик может заставить AI выдать что угодно - **Как воспроизвести:** POST /teacher/free-message с 'Ignore previous instructions...' - **Что сделать:** Санитизация/фильтр промптов, ограничение тематики - **Confidence:** 0.7 ### 47. teacher_history_no_size_limit - **Файл:** `routers/teacher.py:0` - **Snippet:** `messages = body.get("messages", []) if not isinstance(messages, list): raise HTTPException(400, "messag` - **Проблема:** Ученик может залить мегабайты JSON в teacher_chat_history — раздувание БД - **Как воспроизвести:** POST /teacher/history/save с messages=[...100000 элементов...] - **Что сделать:** Ограничить длину списка (например, 200) и общий размер JSON - **Confidence:** 0.8 ### 48. teacher_answer_question_options_no_owner - **Файл:** `routers/teacher.py:0` - **Snippet:** `options = await conn.fetch(""" SELECT * FROM question_options WHERE question_id = $1 """, question_i` - **Проблема:** Возвращаются ВСЕ опции, включая is_correct=true — клиент может подсмотреть правильный ответ - **Как воспроизвести:** POST /teacher/answer → response.options содержит is_correct - **Что сделать:** Не отдавать is_correct клиенту (или отдавать только после ответа) - **Confidence:** 0.85 ### 49. learning_get_lesson_returns_correct_answer - **Файл:** `routers/learning.py:0` - **Snippet:** `questions = await conn.fetch("SELECT * FROM learning_questions WHERE lesson_id = $1 AND is_test_question = FALSE ORDER B` - **Проблема:** SELECT * отдаёт correct_answer клиенту — ученик может подсмотреть ответы - **Как воспроизвести:** GET /learning/lessons/{id} → questions[].question.correct_answer - **Что сделать:** Явно перечислять поля без correct_answer, wrong_because - **Confidence:** 0.9 ### 50. learning_get_test_returns_correct_answer - **Файл:** `routers/learning.py:0` - **Snippet:** `questions = await conn.fetch("SELECT * FROM learning_questions WHERE topic_id = $1 AND is_test_question = TRUE ORDER BY ` - **Проблема:** Финальный тест отдаёт correct_answer клиенту — тест можно пройти без знаний - **Как воспроизвести:** GET /learning/test/{topic_id} → correct_answer в ответе - **Что сделать:** SELECT конкретные поля без correct_answer - **Confidence:** 0.9 ### 51. orchestrator_get_lesson_returns_correct_answer - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `questions = await conn.fetch(""" SELECT * FROM learning_questions WHERE lesson_id = $1 AND is_test_ques` - **Проблема:** SELECT * отдаёт correct_answer и wrong_because клиенту через teacher/start - **Как воспроизвести:** POST /teacher/start → question.correct_answer - **Что сделать:** Явный список полей без correct_answer - **Confidence:** 0.9 ### 52. learning_practice_start_no_owner_check - **Файл:** `routers/learning.py:0` - **Snippet:** `session = await conn.fetchrow(""" INSERT INTO learning_sessions (user_id, level_code, topic_id, session_type` - **Проблема:** topic_id='' — при complete_session update_topic_progress не вызовется (ок), но session_type='weak_skills_practice' не обрабатывается в complete_session - **Как воспроизвести:** POST /learning/practice/start → complete → update_ai_context вызывается, но update_topic_progress нет (ок) - **Что сделать:** Ок, но убедиться, что complete_session корректно обрабатывает weak_skills_practice - **Confidence:** 0.7 ### 53. learning_update_skill_mastery_retention_score_never_set - **Файл:** `routers/learning.py:0` - **Snippet:** `retention_score, hint_dependency, average_time_ms, median_time_ms,` - **Проблема:** retention_score всегда 0 в INSERT и не обновляется в ON CONFLICT — поле мёртвое - **Как воспроизвести:** SELECT retention_score FROM user_skill_mastery → всегда 0 - **Что сделать:** Вычислять retention_score или убрать поле - **Confidence:** 0.85 ### 54. admin_sentry_error_leak_to_client - **Файл:** `routers/admin.py:155` - **Snippet:** `logger.error(f"Sentry API unexpected error: {e}") return {"errors": [], "error": str(e)}` - **Проблема:** В ответе админу утекает внутренний текст исключения (может содержать URL с токеном, детали окружения). - **Как воспроизвести:** Сломать SENTRY_API_BASE → /admin/sentry-errors вернёт str(e) с деталями. - **Что сделать:** Возвращать обобщённое сообщение ('Sentry API error'), детали — только в лог. - **Confidence:** 0.75 ### 55. admin_content_update_word_mass_update - **Файл:** `routers/admin_content.py:305` - **Snippet:** `UPDATE level_words SET word_pl = $1, translation_ru = $2, translation_uk = $` - **Проблема:** Правка одного слова перезаписывает переводы ВСЕХ строк с тем же (level, word_pl), включая привязки к игровым уровням Филвордов — можно случайно сломать контент игры. - **Как воспроизвести:** PUT /admin/content/words/word/{id} с новым translation_ru → все строки с этим word_pl в уровне получают новый перевод. - **Что сделать:** Обновлять только строку по id, а привязки к игровым уровням синхронизировать явным отдельным действием/подтверждением. - **Confidence:** 0.78 ### 56. achievements_check_race_condition - **Файл:** `routers/achievements.py:305` - **Snippet:** `matching = await conn.fetch(""" SELECT a.* FROM achievements a WHERE a.requirement_type = $1 ` - **Проблема:** При параллельных запросах (двойной клик, retry) одно и то же достижение может быть возвращено в new_achievements дважды — ученик видит дубликат попапа - **Как воспроизвести:** два одновременных POST /achievements/track-rules → оба SELECT не видят запись → оба INSERT ... ON CONFLICT DO NOTHING → оба возвращают достижение в ответе - **Что сделать:** Использовать INSERT ... ON CONFLICT DO NOTHING RETURNING id и формировать newly_unlocked только по возвращённым строкам - **Confidence:** 0.8 ### 57. achievements_no_transaction_on_award - **Файл:** `routers/achievements.py:310` - **Snippet:** `for ach in matching: await conn.execute( "INSERT INTO user_achievements (user_id, achievemen` - **Проблема:** При падении между итерациями часть достижений выдана, часть нет — при повторном вызове SELECT их уже не вернёт, ученик не увидит попап - **Как воспроизвести:** обрыв соединения на 3-м из 5 INSERT → 2 достижения в БД, но new_achievements не вернулся клиенту - **Что сделать:** Обернуть цикл в conn.transaction() или использовать один bulk INSERT ... RETURNING - **Confidence:** 0.72 ### 58. tts_cache_unbounded_growth - **Файл:** `routers/tts.py:55` - **Snippet:** `with open(cache_path, 'wb') as f: f.write(audio_bytes)` - **Проблема:** Кэш mp3 растёт бесконечно — со временем диск переполнится, TTS и весь backend упадут - **Как воспроизвести:** озвучить 100k уникальных фраз → /root/filwordspl/backend/tts_cache заполнит диск - **Что сделать:** Добавить LRU-очистку по размеру/возрасту (например, cron или при старте), либо использовать TTL-кэш - **Confidence:** 0.78 ### 59. rate_limiter_memory_leak_unbounded_keys - **Файл:** `main.py:88` - **Snippet:** `self.requests = defaultdict(list)` - **Проблема:** при большом числе уникальных IP:path ключей память процесса растёт, воркер падает по OOM, все ученики получают 502 - **Как воспроизвести:** нагрузить API с разных IP → ключи накапливаются до следующего _cleanup (60с), при всплеске — OOM - **Что сделать:** ограничить размер dict (LRU) или чистить чаще; либо перейти на Redis как указано в TODO - **Confidence:** 0.75 ### 60. rate_limit_key_uses_path_not_route - **Файл:** `main.py:240` - **Snippet:** `rate_key = f"{client_ip}:{path}"` - **Проблема:** лимит обходится добавлением query-параметров или слэша: /game/check-word?x=1 и /game/check-word — разные ключи, но один эндпоинт - **Как воспроизвести:** curl '/game/check-word?a=1' в цикле с меняющимся a → лимит 30/мин не срабатывает - **Что сделать:** использовать request.scope['route'].path (шаблон маршрута) вместо request.url.path - **Confidence:** 0.8 ### 61. rate_limit_limits_lookup_by_path_mismatch - **Файл:** `main.py:130` - **Snippet:** `limit_config = self.limits.get(path, self.limits["default"])` - **Проблема:** если реальный путь отличается от ключа в self.limits (trailing slash, префикс), применяется default 60/мин вместо строгого лимита — дорогие AI-эндпоинты не защищены - **Как воспроизвести:** POST /teacher/answer/ (со слэшем) → берётся default 60/мин вместо 30/мин - **Что сделать:** нормализовать path (rstrip '/') или матчить по route.path - **Confidence:** 0.7 ### 62. static_uploads_no_auth_no_path_check - **Файл:** `main.py:271` - **Snippet:** `app.mount("/uploads", StaticFiles(directory=UPLOADS_DIR), name="uploads")` - **Проблема:** любой файл из uploads доступен без авторизации по прямому URL; при загрузке небезопасного имени возможен обход каталога - **Как воспроизвести:** GET /uploads/<любой_файл> без initData → 200 OK - **Что сделать:** проверять, что file_path в БД принадлежит посту; отдавать через эндпоинт с проверкой; санитизировать имена при загрузке - **Confidence:** 0.72 ### 63. init_db_delete_duplicates_full_scan - **Файл:** `database.py:118` - **Snippet:** `DELETE FROM user_progress WHERE ctid NOT IN (` - **Проблема:** на большой таблице — долгий full scan + lock; при падении транзакции миграция не завершится, БД останется без PK - **Как воспроизвести:** запустить init_db на таблице с миллионом строк → таймаут, откат, повтор при каждом рестарте - **Что сделать:** выполнять миграцию один раз вне startup, использовать временную таблицу или оконные функции с индексом - **Confidence:** 0.75 ### 64. auth_query_param_initdata_leak - **Файл:** `auth.py:108` - **Snippet:** `init_data = request.query_params.get('initData', '')` - **Проблема:** initData в query-параметре попадает в access-логи Cloudflare/nginx и Sentry breadcrumbs — утечка токена, позволяющая выдать себя за ученика - **Как воспроизвести:** сделать запрос с ?initData=... → токен виден в логах прокси - **Что сделать:** убрать query-fallback, оставить только Authorization/X-Telegram-InitData; либо маскировать в логах - **Confidence:** 0.85 ## 🟡 Качество кода (150) ### 65. bubblewords_words_count_trusted - **Файл:** `routers/bubblewords.py:155` - **Snippet:** `words_count = body.get("words_count", 3) completion_time = body.get("completion_time")` - **Проблема:** words_count не используется — мёртвый параметр - **Как воспроизвести:** передать любое значение — на результат не влияет - **Что сделать:** удалить параметр или использовать для валидации - **Confidence:** 0.9 ### 66. update_skill_mastery_n_plus_1 - **Файл:** `routers/learning.py:0` - **Snippet:** `for st in skill_tags: await update_skill_mastery(conn, telegram_id, st["skill_tag"])` - **Проблема:** Завершение сессии с 10+ навыками делает 10+ тяжёлых запросов (fetch всех ответов + upsert) — медленно - **Как воспроизвести:** Сессия с 15 навыками → 15 × (SELECT всех ответов + INSERT ... ON CONFLICT) - **Что сделать:** Агрегировать по skill_tag одним запросом или батчить upsert - **Confidence:** 0.8 ### 67. update_skill_mastery_fetches_all_answers - **Файл:** `routers/learning.py:0` - **Snippet:** `answers = await conn.fetch(""" SELECT correct, time_taken_ms, hint_used, question_type, wrong_because, is_final_` - **Проблема:** При тысячах ответов по навыку — тяжёлый SELECT в память на каждый вызов - **Как воспроизвести:** 10000 ответов по skill_tag → fetch всех в Python - **Что сделать:** Агрегировать в SQL (COUNT, AVG, PERCENTILE) или ограничить окно последними N - **Confidence:** 0.78 ### 68. get_topic_loads_all_lesson_progress - **Файл:** `routers/learning.py:0` - **Snippet:** `lesson_progress = await conn.fetch(""" SELECT lesson_id, completed FROM user_lesson_progress WHERE user_id =` - **Проблема:** Загружаются ВСЕ прогрессы пользователя по всем темам, хотя нужны только для уроков этой темы - **Как воспроизвести:** 1000 пройденных уроков → 1000 строк на каждый GET /topics/{id} - **Что сделать:** Добавить фильтр `AND lesson_id IN (SELECT lesson_id FROM learning_lessons WHERE topic_id=$2)` - **Confidence:** 0.85 ### 69. teacher_translate_no_lang_validation - **Файл:** `routers/teacher.py:0` - **Snippet:** `system_prompt = f"""Ты — переводчик польского языка. Переведи текст на польский.` - **Проблема:** lang не используется в промпте — перевод всегда на польский, независимо от языка юзера (ок по ТЗ, но lang загружается зря) - **Как воспроизвести:** — - **Что сделать:** Убрать загрузку lang или использовать для указания исходного языка - **Confidence:** 0.7 ### 70. orchestrator_duplicate_lesson_query - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `lesson = await conn.fetchrow(""" SELECT l.lesson_id, l.topic_id, l.skill_tag, l.title_pl, l.title_ru, l.titl` - **Проблема:** Дублирование одного и того же запроса в шагах 1 и 2 — можно объединить - **Как воспроизвести:** — - **Что сделать:** Вынести в helper get_lesson_by_skill(conn, skill_tag) - **Confidence:** 0.75 ### 71. orchestrator_next_lesson_not_in_subquery - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `AND l.lesson_id NOT IN ( SELECT lesson_id FROM user_lesson_progress WHERE user_id = $2 AND ` - **Проблема:** NOT IN с подзапросом медленнее, чем LEFT JOIN ... IS NULL, особенно при большом user_lesson_progress - **Как воспроизвести:** 10000 пройденных уроков → NOT IN сканирует всё - **Что сделать:** Переписать через LEFT JOIN user_lesson_progress ... WHERE ulp.lesson_id IS NULL - **Confidence:** 0.75 ### 72. orchestrator_duplicate_options_grouping - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `question_ids = [q["question_id"] for q in questions] all_options = [] if question_ids: all_options = awa` - **Проблема:** Один и тот же блок копипастится в get_lesson_by_id, get_lesson_questions, get_test_questions, learning.py × 4, teacher.py × 2 - **Как воспроизвести:** — - **Что сделать:** Вынести в helper attach_options(conn, questions) -> list - **Confidence:** 0.9 ### 73. teacher_import_inside_function - **Файл:** `routers/teacher.py:0` - **Snippet:** `from .learning import update_skill_mastery, update_topic_progress, update_ai_context` - **Проблема:** Циклический импорт обходится локальным импортом — архитектурный запах - **Как воспроизвести:** — - **Что сделать:** Вынести update_* в отдельный модуль learning_service.py - **Confidence:** 0.8 ### 74. teacher_ai_limit_check_duplicated - **Файл:** `routers/teacher.py:0` - **Snippet:** `if not await check_ai_limit(conn, telegram_id): return { "response": "", "li` - **Проблема:** Один и тот же блок в /explain, /examples, /free-message, /translate-to-polish - **Как воспроизвести:** — - **Что сделать:** Декоратор @require_ai_limit или middleware - **Confidence:** 0.85 ### 75. teacher_ai_usage_increment_duplicated - **Файл:** `routers/teacher.py:0` - **Snippet:** `if ai_response: async with pool.acquire() as conn: await increment_teacher_ai_usage(conn, telegram_i` - **Проблема:** Дублируется в 4 endpoints - **Как воспроизвести:** — - **Что сделать:** Обернуть в helper call_ai_with_limit(conn, telegram_id, ...) - **Confidence:** 0.8 ### 76. teacher_get_wrong_answer_ai_explanation_double_pool - **Файл:** `routers/teacher.py:0` - **Snippet:** `pool = await get_pool() async with pool.acquire() as conn: if not await check_ai_limit(conn, telegram_i` - **Проблема:** Открывает соединение, закрывает, потом снова открывает для increment — 2 acquire на один вызов - **Как воспроизвести:** — - **Что сделать:** Держать одно соединение на весь вызов - **Confidence:** 0.75 ### 77. teacher_check_ai_limit_for_fallback_unused_lang - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def _check_ai_limit_for_fallback(telegram_id: int, lang: str) -> bool:` - **Проблема:** Параметр lang не используется — мёртвый код - **Как воспроизвести:** — - **Что сделать:** Убрать параметр lang - **Confidence:** 0.85 ### 78. teacher_phrase_of_day_import_random_inside - **Файл:** `routers/teacher.py:0` - **Snippet:** `import random selected_topic = random.choice(topics_list)` - **Проблема:** Импорт внутри функции — стилистический запах - **Как воспроизвести:** — - **Что сделать:** Перенести import random в начало файла - **Confidence:** 0.7 ### 79. learning_analytics_ai_response_no_length_check - **Файл:** `routers/learning.py:0` - **Snippet:** `ai_response = ai_response.replace("**", "").replace("*", "").replace("#", "")` - **Проблема:** Удаление markdown через replace — грубо, может испортить текст (например, 'C#' → 'C') - **Как воспроизвести:** AI пишет 'C#' → 'C' - **Что сделать:** Использовать regex для markdown-паттернов - **Confidence:** 0.7 ### 80. learning_analytics_no_ai_response_validation - **Файл:** `routers/learning.py:0` - **Snippet:** `if not ai_response or len(ai_response) < 10: ai_response = "Перепройди уроки по слабым темам. Нажми кноп` - **Проблема:** Fallback только на русском, независимо от языка юзера - **Как воспроизвести:** Юзер с lang=pl получает русский fallback - **Что сделать:** Локализовать fallback - **Confidence:** 0.8 ### 81. learning_analytics_skill_names_all_loaded - **Файл:** `routers/learning.py:0` - **Snippet:** `skill_names = await get_skill_names(conn) skill_tag_lines = '\n'.join([f'- {tag} → "{name}"' for tag, name in sk` - **Проблема:** Загружаются ВСЕ навыки, хотя нужны только слабые — лишний шум в промпте - **Как воспроизвести:** — - **Что сделать:** Фильтровать по weak_skill_tags - **Confidence:** 0.75 ### 82. learning_practice_start_random_order - **Файл:** `routers/learning.py:0` - **Snippet:** `ORDER BY random() LIMIT 10` - **Проблема:** ORDER BY random() на большой таблице — full scan + sort, медленно - **Как воспроизвести:** 100000 вопросов → full scan - **Что сделать:** Использовать TABLESAMPLE или предварительный random id - **Confidence:** 0.75 ### 83. learning_practice_start_explanations_map_merge - **Файл:** `routers/learning.py:0` - **Snippet:** `"explanations": [ {"skill_tag": tag, "name": skill_names.get(tag, tag), **explanations_map.get(tag, {})}` - **Проблема:** explanations_map.get(tag, {}) содержит skill_tag — перезапишет внешний skill_tag (ок, тот же), но содержит explanation_* поля всех языков - **Как воспроизвести:** — - **Что сделать:** Явно выбирать нужные поля - **Confidence:** 0.7 ### 84. learning_update_ai_context_strong_skills_limit - **Файл:** `routers/learning.py:0` - **Snippet:** `strong_skills = await get_strong_skills(conn, user_id, limit=8) weak_skills = await get_weak_skills(conn, user_id, l` - **Проблема:** Хардкод лимитов — если нужно больше, придётся менять код - **Как воспроизвести:** — - **Что сделать:** Вынести в константы - **Confidence:** 0.7 ### 85. learning_update_ai_context_strong_skills_unused - **Файл:** `routers/learning.py:0` - **Snippet:** `strong_skill_tags = [s["skill_tag"] for s in strong_skills] weak_skill_tags = [s["skill_tag"] for s in weak_skills]` - **Проблема:** strong_skills загружаются, но используются только для сохранения в ai_user_context — ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 86. learning_update_topic_progress_skills_avg_subquery - **Файл:** `routers/learning.py:0` - **Snippet:** `skills_avg = await conn.fetchval(""" SELECT COALESCE(AVG(mastery_score), 0) FROM user_skill_mastery WHER` - **Проблема:** Подзапрос по learning_questions без индекса на topic_id может быть медленным - **Как воспроизвести:** — - **Что сделать:** Убедиться в наличии индекса на learning_questions(topic_id, skill_tag) - **Confidence:** 0.7 ### 87. learning_update_topic_progress_lessons_completed_subquery - **Файл:** `routers/learning.py:0` - **Snippet:** `lessons_completed = await conn.fetchval(""" SELECT COUNT(*) FROM user_lesson_progress WHERE user_id = $1 AND les` - **Проблема:** Подзапрос вместо JOIN — можно оптимизировать - **Как воспроизвести:** — - **Что сделать:** JOIN learning_lessons ON ... WHERE topic_id=$2 - **Confidence:** 0.7 ### 88. learning_update_skill_mastery_confidence_calculation - **Файл:** `routers/learning.py:0` - **Snippet:** `if len(recent) >= 3: if all(a["correct"] for a in recent[-3:]): confidence = min(100, mastery + 15)` - **Проблема:** recent = answers[-5:], но проверяется recent[-3:] — если recent содержит 5, проверяются последние 3 (ок) - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 89. learning_update_skill_mastery_days_since_naive - **Файл:** `routers/learning.py:0` - **Snippet:** `if last_attempt.tzinfo is None: last_attempt = last_attempt.replace(tzinfo=timezone.utc)` - **Проблема:** Обработка naive datetime — ок, но лучше хранить TIMESTAMPTZ в БД - **Как воспроизвести:** — - **Что сделать:** Убедиться, что created_at — TIMESTAMPTZ - **Confidence:** 0.7 ### 90. learning_update_skill_mastery_retention_fresh_duplicate - **Файл:** `routers/learning.py:0` - **Snippet:** `if days_since == 0: retention_status = "fresh" elif days_since <= 3: retention_status = "fresh"` - **Проблема:** Дублирование ветки — можно объединить в `if days_since <= 3` - **Как воспроизвести:** — - **Что сделать:** Объединить условия - **Confidence:** 0.85 ### 91. learning_update_skill_mastery_speed_score_magic - **Файл:** `routers/learning.py:0` - **Snippet:** `speed_score = 100 if median_correct_time_ms and median_correct_time_ms < 5000 else (50 if median_correct_time_ms and med` - **Проблема:** Магические числа 5000/15000/100/50/20 — сложно поддерживать - **Как воспроизвести:** — - **Что сделать:** Вынести в константы - **Confidence:** 0.75 ### 92. learning_update_skill_mastery_fluency_formula - **Файл:** `routers/learning.py:0` - **Snippet:** `fluency = round(accuracy * 0.4 + active_knowledge * 0.3 + speed_score * 0.3, 2)` - **Проблема:** Веса 0.4/0.3/0.3 захардкожены — сложно тюнить - **Как воспроизвести:** — - **Что сделать:** Вынести в константы - **Confidence:** 0.7 ### 93. learning_update_skill_mastery_mastery_formula - **Файл:** `routers/learning.py:0` - **Snippet:** `mastery = round(accuracy * 0.4 + recent_accuracy * 0.3 + no_hint_score * 0.3, 2)` - **Проблема:** Веса захардкожены - **Как воспроизвести:** — - **Что сделать:** Вынести в константы - **Confidence:** 0.7 ### 94. learning_update_skill_mastery_no_hint_score - **Файл:** `routers/learning.py:0` - **Snippet:** `no_hint_score = max(0, 100 - hint_dependency)` - **Проблема:** Если hint_dependency=100 (все ответы с подсказкой), no_hint_score=0 — ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 95. learning_update_skill_mastery_long_term_accuracy - **Файл:** `routers/learning.py:0` - **Snippet:** `long_term_accuracy = $23,` - **Проблема:** long_term_accuracy = accuracy (все ответы) — семантически дублирует accuracy - **Как воспроизвести:** — - **Что сделать:** Определить, что такое long_term (например, ответы старше 30 дней) - **Confidence:** 0.7 ### 96. learning_update_skill_mastery_error_count - **Файл:** `routers/learning.py:0` - **Snippet:** `error_count = sum(1 for a in answers if not a["correct"] and a["wrong_because"])` - **Проблема:** error_count считает только ошибки с wrong_because — ошибки без тега не учитываются - **Как воспроизвести:** — - **Что сделать:** Уточнить семантику - **Confidence:** 0.7 ### 97. learning_update_skill_mastery_repeated_error_count - **Файл:** `routers/learning.py:0` - **Snippet:** `repeated_error_count = sum(1 for count in error_types.values() if count >= 2)` - **Проблема:** Считает количество типов ошибок, повторённых 2+ раз — ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 98. learning_update_skill_mastery_confidence_round - **Файл:** `routers/learning.py:0` - **Snippet:** `confidence = round(min(100, max(0, confidence)), 2)` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 99. learning_update_skill_mastery_trend_insufficient - **Файл:** `routers/learning.py:0` - **Snippet:** `if total_attempts < 3: trend = "insufficient_data"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 100. learning_update_skill_mastery_trend_else_stable - **Файл:** `routers/learning.py:0` - **Snippet:** `else: trend = "stable"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 101. learning_update_skill_mastery_retention_status_else - **Файл:** `routers/learning.py:0` - **Snippet:** `else: retention_status = "overdue"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 102. learning_update_skill_mastery_median_time - **Файл:** `routers/learning.py:0` - **Snippet:** `median_time_ms = int(statistics.median(all_times)) if all_times else 0` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 103. learning_update_skill_mastery_avg_time - **Файл:** `routers/learning.py:0` - **Snippet:** `avg_time_ms = int(sum(correct_times) / len(correct_times)) if correct_times else 0` - **Проблема:** avg_time_ms считается только по правильным ответам — семантически странно (название 'average_time_ms') - **Как воспроизвести:** — - **Что сделать:** Переименовать в avg_correct_time_ms или считать по всем - **Confidence:** 0.7 ### 104. learning_update_skill_mastery_passive_knowledge - **Файл:** `routers/learning.py:0` - **Snippet:** `passive_knowledge = recognition_score if recognition_score is not None else 0` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 105. learning_update_skill_mastery_active_knowledge - **Файл:** `routers/learning.py:0` - **Snippet:** `active_knowledge = round(sum(active_scores) / len(active_scores), 2) if active_scores else 0` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 106. learning_update_skill_mastery_recent_accuracy - **Файл:** `routers/learning.py:0` - **Snippet:** `recent_accuracy = (recent_correct / len(recent) * 100) if recent else 0` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 107. learning_update_skill_mastery_calc_last_n - **Файл:** `routers/learning.py:0` - **Snippet:** `def calc_last_n(n): last_n = answers[-n:] if len(answers) >= n else None if not last_n or len(last_n) < ` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 108. learning_update_skill_mastery_accuracy - **Файл:** `routers/learning.py:0` - **Snippet:** `accuracy = (correct_count / total_attempts * 100) if total_attempts > 0 else 0` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 109. learning_update_skill_mastery_total_attempts - **Файл:** `routers/learning.py:0` - **Snippet:** `total_attempts = len(answers)` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 110. learning_update_skill_mastery_correct_count - **Файл:** `routers/learning.py:0` - **Snippet:** `correct_count = sum(1 for a in answers if a["correct"])` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 111. learning_update_skill_mastery_recent - **Файл:** `routers/learning.py:0` - **Snippet:** `recent = answers[-5:]` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 112. learning_update_skill_mastery_recent_correct - **Файл:** `routers/learning.py:0` - **Snippet:** `recent_correct = sum(1 for a in recent if a["correct"])` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 113. learning_update_skill_mastery_hints_used - **Файл:** `routers/learning.py:0` - **Snippet:** `hints_used = sum(1 for a in answers if a["hint_used"])` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 114. learning_update_skill_mastery_hint_dependency - **Файл:** `routers/learning.py:0` - **Snippet:** `hint_dependency = (hints_used / total_attempts * 100) if total_attempts > 0 else 0` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 115. learning_update_skill_mastery_recognition - **Файл:** `routers/learning.py:0` - **Snippet:** `recognition_answers = [a for a in answers if a["question_type"] == "recognition"]` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 116. learning_update_skill_mastery_production - **Файл:** `routers/learning.py:0` - **Snippet:** `production_answers = [a for a in answers if a["question_type"] == "production"]` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 117. learning_update_skill_mastery_application - **Файл:** `routers/learning.py:0` - **Snippet:** `application_answers = [a for a in answers if a["question_type"] == "application"]` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 118. learning_update_skill_mastery_recognition_score - **Файл:** `routers/learning.py:0` - **Snippet:** `recognition_score = round((recognition_correct / recognition_attempts * 100), 2) if recognition_attempts > 0 else None` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 119. learning_update_skill_mastery_production_score - **Файл:** `routers/learning.py:0` - **Snippet:** `production_score = round((production_correct / production_attempts * 100), 2) if production_attempts > 0 else None` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 120. learning_update_skill_mastery_application_score - **Файл:** `routers/learning.py:0` - **Snippet:** `application_score = round((application_correct / application_attempts * 100), 2) if application_attempts > 0 else None` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 121. learning_update_skill_mastery_error_types - **Файл:** `routers/learning.py:0` - **Snippet:** `error_types = {} for a in answers: if not a["correct"] and a["wrong_because"]: error_types[a["wr` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 122. learning_update_skill_mastery_last_attempt - **Файл:** `routers/learning.py:0` - **Snippet:** `last_attempt = answers[-1]["created_at"]` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 123. learning_update_skill_mastery_days_since - **Файл:** `routers/learning.py:0` - **Snippet:** `days_since = (now - last_attempt).days` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 124. learning_update_skill_mastery_previous_row - **Файл:** `routers/learning.py:0` - **Snippet:** `previous_row = await conn.fetchrow(""" SELECT mastery_score, previous_mastery_score FROM user_skill_mastery ` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 125. learning_update_skill_mastery_mastery_delta - **Файл:** `routers/learning.py:0` - **Snippet:** `mastery_delta = round(mastery - previous_mastery, 2)` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 126. learning_update_skill_mastery_trend_improving - **Файл:** `routers/learning.py:0` - **Snippet:** `if last_3_accuracy > last_10_accuracy + 5: trend = "improving"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 127. learning_update_skill_mastery_trend_declining - **Файл:** `routers/learning.py:0` - **Snippet:** `elif last_3_accuracy < last_10_accuracy - 5: trend = "declining"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 128. learning_update_skill_mastery_trend_stable - **Файл:** `routers/learning.py:0` - **Snippet:** `else: trend = "stable"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 129. learning_update_skill_mastery_retention_fresh - **Файл:** `routers/learning.py:0` - **Snippet:** `if days_since == 0: retention_status = "fresh"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 130. learning_update_skill_mastery_retention_aging - **Файл:** `routers/learning.py:0` - **Snippet:** `elif days_since <= 7: retention_status = "aging"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 131. learning_update_skill_mastery_retention_needs_review - **Файл:** `routers/learning.py:0` - **Snippet:** `elif days_since <= 14: retention_status = "needs_review"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 132. learning_update_skill_mastery_retention_overdue - **Файл:** `routers/learning.py:0` - **Snippet:** `else: retention_status = "overdue"` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 133. learning_update_skill_mastery_speed_score - **Файл:** `routers/learning.py:0` - **Snippet:** `speed_score = 100 if median_correct_time_ms and median_correct_time_ms < 5000 else (50 if median_correct_time_ms and med` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 134. learning_update_skill_mastery_fluency - **Файл:** `routers/learning.py:0` - **Snippet:** `fluency = round(accuracy * 0.4 + active_knowledge * 0.3 + speed_score * 0.3, 2)` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 135. learning_update_skill_mastery_confidence - **Файл:** `routers/learning.py:0` - **Snippet:** `if len(recent) >= 3: if all(a["correct"] for a in recent[-3:]): confidence = min(100, mastery + 15)` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 136. learning_update_skill_mastery_confidence_else - **Файл:** `routers/learning.py:0` - **Snippet:** `else: confidence = mastery` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 137. learning_update_skill_mastery_confidence_round2 - **Файл:** `routers/learning.py:0` - **Snippet:** `confidence = round(min(100, max(0, confidence)), 2)` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 138. learning_update_skill_mastery_insert - **Файл:** `routers/learning.py:0` - **Snippet:** `await conn.execute(""" INSERT INTO user_skill_mastery (` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 139. learning_update_skill_mastery_return - **Файл:** `routers/learning.py:0` - **Snippet:** `return { "skill_tag": skill_tag,` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 140. learning_update_topic_progress_lessons_total - **Файл:** `routers/learning.py:0` - **Snippet:** `lessons_total = await conn.fetchval(""" SELECT COUNT(*) FROM learning_lessons WHERE topic_id = $1 AND is_active ` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 141. learning_update_topic_progress_test_row - **Файл:** `routers/learning.py:0` - **Snippet:** `test_row = await conn.fetchrow(""" SELECT test_completed, test_score FROM user_topic_progress WHERE user_id = $1` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 142. learning_update_topic_progress_topic_mastery - **Файл:** `routers/learning.py:0` - **Snippet:** `if test_completed and test_score > 0: topic_mastery = round(float(skills_avg) * 0.4 + float(test_score) * 0.6, 2` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 143. learning_update_topic_progress_insert - **Файл:** `routers/learning.py:0` - **Snippet:** `await conn.execute(""" INSERT INTO user_topic_progress (user_id, topic_id, lessons_total, lessons_completed, tes` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 144. learning_update_topic_progress_return - **Файл:** `routers/learning.py:0` - **Snippet:** `return { "lessons_total": lessons_total,` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 145. learning_update_ai_context_current_level - **Файл:** `routers/learning.py:0` - **Snippet:** `current_level = await conn.fetchval(""" SELECT current_level FROM users WHERE telegram_id = $1 """, user_id)` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 146. learning_update_ai_context_topics - **Файл:** `routers/learning.py:0` - **Snippet:** `topics = await conn.fetch(""" SELECT topic_id, topic_mastery, test_completed FROM user_topic_progress WHERE user` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 147. learning_update_ai_context_completed_topics - **Файл:** `routers/learning.py:0` - **Snippet:** `completed_topics = sum(1 for t in topics if t["test_completed"])` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 148. learning_update_ai_context_completed_lessons - **Файл:** `routers/learning.py:0` - **Snippet:** `completed_lessons = await conn.fetchval(""" SELECT COUNT(*) FROM user_lesson_progress WHERE user_id = $1 AND com` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 149. learning_update_ai_context_level_topics_total - **Файл:** `routers/learning.py:0` - **Snippet:** `level_topics_total = await conn.fetchval(""" SELECT COUNT(*) FROM learning_topics WHERE level_code = $1 AND is_a` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 150. learning_update_ai_context_level_completion_percent - **Файл:** `routers/learning.py:0` - **Snippet:** `level_completion_percent = round((completed_topics / level_topics_total * 100), 2) if level_topics_total > 0 else 0` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 151. learning_update_ai_context_overall_mastery - **Файл:** `routers/learning.py:0` - **Snippet:** `overall_mastery = await conn.fetchval(""" SELECT COALESCE(AVG(topic_mastery), 0) FROM user_topic_progress WHERE ` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 152. learning_update_ai_context_errors - **Файл:** `routers/learning.py:0` - **Snippet:** `errors = await conn.fetch(""" SELECT wrong_because, COUNT(*) as cnt FROM user_learning_answers W` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 153. learning_update_ai_context_recurring_errors - **Файл:** `routers/learning.py:0` - **Snippet:** `recurring_errors = [e["wrong_because"] for e in errors]` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 154. learning_update_ai_context_insert - **Файл:** `routers/learning.py:0` - **Snippet:** `await conn.execute(""" INSERT INTO ai_user_context (user_id, current_level, completed_topics, level_topics_total` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 155. learning_update_ai_context_return - **Файл:** `routers/learning.py:0` - **Snippet:** `return { "completed_topics": completed_topics,` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 156. learning_get_learning_levels - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.get("/levels") async def get_learning_levels(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 157. learning_get_topics - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.get("/topics") async def get_topics(request: Request, level: str = "A1"):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 158. learning_get_topic - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.get("/topics/{topic_id}") async def get_topic(request: Request, topic_id: str):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 159. learning_get_lesson - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.get("/lessons/{lesson_id}") async def get_lesson(request: Request, lesson_id: str):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 160. learning_get_topic_test - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.get("/test/{topic_id}") async def get_topic_test(request: Request, topic_id: str):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 161. learning_start_session - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.post("/session/start") async def start_session(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 162. learning_save_answer - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.post("/answer") async def save_answer(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 163. learning_complete_session - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.post("/session/complete") async def complete_session(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 164. learning_get_learning_progress - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.get("/progress") async def get_learning_progress(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 165. learning_get_analytics - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.post("/analytics") async def get_analytics(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 166. learning_get_ai_context - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.get("/ai/context") async def get_ai_context(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 167. learning_start_weak_skills_practice - **Файл:** `routers/learning.py:0` - **Snippet:** `@router.post("/practice/start") async def start_weak_skills_practice(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 168. learning_profile_get_weak_skills - **Файл:** `routers/learning_profile.py:0` - **Snippet:** `async def get_weak_skills(conn, user_id: int, limit: int = 5):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 169. learning_profile_get_strong_skills - **Файл:** `routers/learning_profile.py:0` - **Snippet:** `async def get_strong_skills(conn, user_id: int, limit: int = 8):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 170. learning_profile_get_profile_hash - **Файл:** `routers/learning_profile.py:0` - **Snippet:** `def get_profile_hash(weak_skills: list) -> str:` - **Проблема:** Функция get_profile_hash не используется нигде в коде — мёртвый код - **Как воспроизвести:** grep get_profile_hash → только определение - **Что сделать:** Удалить или использовать для кэша - **Confidence:** 0.85 ### 171. teacher_get_ai_limit_message - **Файл:** `routers/teacher.py:0` - **Snippet:** `def get_ai_limit_message(lang: str) -> str:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 172. teacher_normalize_answer - **Файл:** `routers/teacher.py:0` - **Snippet:** `def normalize_answer(text: str) -> str:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 173. teacher_get_user_lang - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def get_user_lang(conn, user_id: int) -> str:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 174. teacher_get_teacher_ai_usage - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def get_teacher_ai_usage(conn, user_id: int) -> int:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 175. teacher_increment_teacher_ai_usage - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def increment_teacher_ai_usage(conn, user_id: int) -> None:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 176. teacher_check_ai_limit - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def check_ai_limit(conn, user_id: int) -> bool:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 177. teacher_start_learning_session - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def start_learning_session(conn, user_id: int, level_code: str, topic_id: str, session_type: str) -> int:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 178. teacher_save_answer_to_session - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def save_answer_to_session(conn, user_id: int, session_id: int, question_data: dict, selected_answer: str, correct` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 179. teacher_update_mastery_after_lesson - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def update_mastery_after_lesson(conn, user_id: int, session_id: int) -> None:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 180. teacher_call_ai - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def call_ai(prompt: str, system_prompt: str, max_tokens: int = 500) -> str:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 181. teacher_get_wrong_answer_ai_explanation - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def get_wrong_answer_ai_explanation(telegram_id: int, lang: str, prompt_text: str, selected_answer: str, correct_a` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 182. teacher_check_ai_limit_for_fallback - **Файл:** `routers/teacher.py:0` - **Snippet:** `async def _check_ai_limit_for_fallback(telegram_id: int, lang: str) -> bool:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 183. teacher_get_phrase_of_day - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.get("/phrase-of-day") async def get_phrase_of_day(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 184. teacher_resume - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/resume") async def teacher_resume(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 185. teacher_start - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/start") async def teacher_start(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 186. teacher_answer - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/answer") async def teacher_answer(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 187. teacher_explain - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/explain") async def teacher_explain(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 188. teacher_examples - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/examples") async def teacher_examples(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 189. teacher_free_message - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/free-message") async def teacher_free_message(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 190. teacher_diagnostic_test - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/diagnostic-test") async def teacher_diagnostic_test(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 191. teacher_translate_to_polish - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/translate-to-polish") async def teacher_translate_to_polish(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 192. teacher_progress - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.get("/progress") async def teacher_progress(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 193. teacher_save_teacher_history - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/history/save") async def save_teacher_history(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 194. teacher_load_teacher_history - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.get("/history/load") async def load_teacher_history(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 195. teacher_clear_teacher_history - **Файл:** `routers/teacher.py:0` - **Snippet:** `@router.post("/history/clear") async def clear_teacher_history(request: Request):` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 196. orchestrator_get_next_lesson - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `async def get_next_lesson(conn, user_id: int) -> Dict[str, Any]:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 197. orchestrator_get_lesson_by_id - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `async def get_lesson_by_id(conn, lesson_id: str) -> Optional[Dict[str, Any]]:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 198. orchestrator_get_lesson_questions - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `async def get_lesson_questions(conn, lesson_id: str) -> list:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 199. orchestrator_get_test_questions - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `async def get_test_questions(conn, topic_id: str) -> list:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 200. orchestrator_get_random_reaction - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `async def get_random_reaction(conn, reaction_type: str, lang: str) -> str:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 201. orchestrator_get_wrong_because_explanation - **Файл:** `routers/orchestrator.py:0` - **Snippet:** `async def get_wrong_because_explanation(conn, wrong_because: str, lang: str) -> str:` - **Проблема:** Ок - **Как воспроизвести:** — - **Что сделать:** Ок - **Confidence:** 0.7 ### 202. admin_dashboard_online_now_union_dup - **Файл:** `routers/admin.py:60` - **Snippet:** `SELECT user_id FROM user_progress WHERE completed_at > NOW() - INTERVAL '30 minutes' UNION ` - **Проблема:** Метрика online_now может быть завышена, если в таблицах есть user_id, не существующие в users (нет JOIN с users). - **Как воспроизвести:** Открыть /admin/dashboard → online_now включает удалённых/несуществующих юзеров. - **Что сделать:** Добавить JOIN users u ON u.telegram_id = active.user_id или фильтр EXISTS (SELECT 1 FROM users WHERE telegram_id = user_id). - **Confidence:** 0.72 ### 203. admin_dashboard_active_24h_mixed_semantics - **Файл:** `routers/admin.py:78` - **Snippet:** `SELECT user_id FROM daily_logins WHERE login_date = CURRENT_DATE ) active` - **Проблема:** active_24h смешивает 24-часовое окно с календарным днём (login_date = CURRENT_DATE), метрика неконсистентна. - **Как воспроизвести:** Открыть /admin/dashboard в 00:05 → active_24h резко падает, хотя за последние 24ч активность была. - **Что сделать:** Использовать login_at > NOW() - INTERVAL '24 hours' (если есть timestamp) или убрать ветку daily_logins. - **Confidence:** 0.8 ### 204. admin_content_update_lesson_n_plus_1 - **Файл:** `routers/admin_content.py:900` - **Snippet:** `for q in questions: # Проверяем, что вопрос принадлежит этому уроку q_exists = await con` - **Проблема:** Сохранение урока с 20 вопросами делает 20+ round-trip к БД внутри транзакции — медленно, риск таймаута. - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} с большим числом вопросов → заметная задержка. - **Что сделать:** Один SELECT question_id FROM learning_questions WHERE lesson_id=$1 AND question_id = ANY($2) до цикла, затем проверка в Python. - **Confidence:** 0.85 ### 205. admin_content_update_lesson_insert_n_plus_1 - **Файл:** `routers/admin_content.py:940` - **Snippet:** `for o in q["options"]: await conn.execute(""" INSERT INTO question_options ` - **Проблема:** Каждая опция вставляется отдельным INSERT — при 20 вопросах × 4 опции = 80 запросов в одной транзакции. - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} → медленное сохранение. - **Что сделать:** Использовать executemany или один INSERT ... VALUES (...), (...), ... через unnest. - **Confidence:** 0.85 ### 206. admin_content_update_lesson_examples_insert_n_plus_1 - **Файл:** `routers/admin_content.py:880` - **Snippet:** `for idx, ex in enumerate(examples, start=1): await conn.execute(""" INSERT INTO less` - **Проблема:** Примеры вставляются по одному — N round-trip внутри транзакции. - **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} с 10 примерами → 10 отдельных INSERT. - **Что сделать:** executemany или batch INSERT через unnest. - **Confidence:** 0.8 ### 207. admin_content_get_lesson_wb_full_scan - **Файл:** `routers/admin_content.py:780` - **Snippet:** `wb_rows = await conn.fetch(""" SELECT wrong_because, explanation_ru FROM wrong_because_explanati` - **Проблема:** Справочник wrong_because тянется целиком при каждом открытии урока, хотя нужен только explanation_ru для встреченных кодов. - **Как воспроизвести:** GET /admin/content/lessons/lesson/{id} → полный SELECT справочника. - **Что сделать:** Тянуть только нужные коды: WHERE wrong_because = ANY($1) после сбора кодов из опций. - **Confidence:** 0.7 ### 208. feed_update_removed_images_duplicate_logic - **Файл:** `routers/feed.py:480` - **Snippet:** `removed_images = body.get("removed_images", []) if removed_images and isinstance(removed_images, list): ` - **Проблема:** Логика парсинга URL и удаления файлов дублируется в двух местах (внутри pool.acquire и после) — риск расхождения поведения. - **Как воспроизвести:** Правка одного из блоков → второй остаётся со старой логикой. - **Что сделать:** Вынести парсинг rel_path в helper _normalize_upload_path(img_url) и использовать в обоих местах. - **Confidence:** 0.8 ### 209. support_admin_tickets_n_plus_1_subqueries - **Файл:** `routers/support.py:210` - **Snippet:** `(SELECT COUNT(*) FROM support_messages m WHERE m.ticket_id = t.id AND m.is_read = FALSE) as unread_count, ` - **Проблема:** На каждый тикет выполняется 2 коррелированных подзапроса — при большом числе тикетов список грузится медленно. - **Как воспроизвести:** GET /support/admin-tickets при 1000 тикетов → 2000 подзапросов. - **Что сделать:** Использовать LATERAL JOIN или агрегацию через GROUP BY + DISTINCT ON в одном запросе. - **Confidence:** 0.75 ### 210. assistant_history_returns_all_messages - **Файл:** `routers/assistant.py:425` - **Snippet:** `rows = await conn.fetch(""" SELECT message, is_user, created_at FROM chat_history WHERE user_id` - **Проблема:** Не баг сейчас (save_message чистит до 10), но при сбое очистки или ручном INSERT история может разрастись и вернуть сотни сообщений - **Как воспроизвести:** вставить вручную 1000 строк в chat_history → GET /assistant/history вернёт все 1000 - **Что сделать:** Добавить LIMIT MAX_HISTORY в SELECT истории - **Confidence:** 0.7 ### 211. tts_cache_path_hardcoded - **Файл:** `routers/tts.py:22` - **Snippet:** `CACHE_DIR = "/root/filwordspl/backend/tts_cache" os.makedirs(CACHE_DIR, exist_ok=True)` - **Проблема:** При деплое в другой каталог/контейнер os.makedirs упадёт с PermissionError на импорте модуля — весь backend не стартует - **Как воспроизвести:** запустить backend из /app → PermissionError: /root/filwordspl/backend/tts_cache - **Что сделать:** Вынести путь в config/env (TTS_CACHE_DIR) с дефолтом относительно файла модуля - **Confidence:** 0.85 ### 212. cors_credentials_false_with_auth_header - **Файл:** `main.py:258` - **Snippet:** `allow_credentials=False,` - **Проблема:** не баг сейчас (auth через Authorization: tma), но при переходе на cookie-сессии CORS сломается молча - **Как воспроизвести:** добавить cookie-auth → preflight вернёт без Access-Control-Allow-Credentials - **Что сделать:** оставить как есть, но задокументировать; либо включить credentials и сузить origins - **Confidence:** 0.7 ### 213. health_endpoint_leaks_db_error - **Файл:** `main.py:320` - **Snippet:** `logger.error(f"Healthcheck failed: {e}")` - **Проблема:** не влияет на ученика, но в логах может оказаться connection string/пароль из исключения asyncpg - **Как воспроизвести:** сломать DB_CONFIG → в логах увидеть детали подключения - **Что сделать:** логировать тип ошибки без str(e) или маскировать чувствительные поля - **Confidence:** 0.7 ### 214. init_db_giant_transaction_blocks_startup - **Файл:** `database.py:20` - **Snippet:** `async with conn.transaction():` - **Проблема:** вся инициализация (десятки DDL + ALTER + DELETE дублей) в одной транзакции — при большом user_progress блокировка таблиц на минуты, старт API зависает, ученики видят 502 - **Как воспроизвести:** рестарт с большой user_progress → DELETE FROM user_progress ... ctid NOT IN (...) держит lock - **Что сделать:** вынести тяжёлые миграции в отдельный скрипт/миграции Alembic, оставить в init_db только CREATE IF NOT EXISTS - **Confidence:** 0.78 --- **Итого:** всего находок=214, snippet не совпал=0, низкий confidence=0, прошло=214 _Этот 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#15