🤖 AI Review (backend): 10 задач (2026-09-24 18:22 UTC) #9

Open
opened 2026-09-24 18:22:14 +00:00 by Drobysh · 0 comments
Owner

🤖 AI Code Review (Backend)

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

📊 По пакам

  • routers — 21 файлов, 327,764 символов, находок=10
  • core — 4 файлов, 68,015 символов, находок=0
  • services — 1 файлов, 0 символов, находок=0

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

1. hint_consumed_before_word_paths_check

  • Файл: routers/hints.py:60

  • Snippet: `hints_already_used += 1

      word_paths = level["word_paths"]`
    
  • Проблема: Ученик теряет подсказку: hints_used увеличивается, но эндпоинт возвращает 404 (нет word_paths), подсказка не выдана

  • Как воспроизвести: открыть уровень без word_paths → GET /hints/first-letter/{id} → 404, но hints_used в БД +1

  • Что сделать: Перенести инкремент hints_used ПОСЛЕ проверки word_paths и found_word, либо обернуть в транзакцию с откатом

  • Confidence: 0.92

2. hint_not_random_word

  • Файл: routers/hints.py:78
  • Snippet: for word in all_level_words: if word in word_paths and word_paths[word]: found_word = word
  • Проблема: Подсказка всегда показывает первое слово из списка, а не случайное ненайденное — ученик получает бесполезную подсказку по уже найденному слову
  • Как воспроизвести: открыть уровень → взять подсказку несколько раз → всегда одно и то же слово
  • Что сделать: Фильтровать слова по прогрессу (не найденные) и выбирать random.choice из оставшихся
  • Confidence: 0.85

3. word_list_hint_consumed_on_empty

  • Файл: routers/hints.py:130

  • Snippet: `hints_already_used += 1

      # Получаем слова
      words = await conn.fetch(`
    
  • Проблема: Если у уровня нет слов, hints_used всё равно растёт, а ученик получает пустой список — подсказка потрачена впустую

  • Как воспроизвести: открыть уровень без слов → GET /hints/word-list/{id} → пустой список, hints_used +1

  • Что сделать: Сначала fetch слов, проверить len(words) > 0, и только потом инкрементить hints_used

  • Confidence: 0.85

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

4. update_word_updates_all_same_spelling

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

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

5. admin_content_word_levels_n_plus_1

  • Файл: routers/admin_content.py:180
  • Snippet: for lvl in level_rows: code = lvl["code"] # 🔧 ФИКС: только level_id IS NULL count =
  • Проблема: Дашборд контента грузится медленно: 6 уровней × 2 запроса = 12 round-trip вместо 2 GROUP BY
  • Как воспроизвести: открыть /admin/content/words/levels → 12 запросов к БД
  • Что сделать: Заменить цикл на два GROUP BY (COUNT + MAX(edited_at)) с ANY($1::text[])
  • Confidence: 0.9

6. admin_content_text_levels_n_plus_1

  • Файл: routers/admin_content.py:400
  • Snippet: for lvl in level_rows: code = lvl["code"] count = await conn.fetchval( "SELECT C
  • Проблема: Дашборд текстов грузится медленно: 6 уровней × 2 запроса = 12 round-trip
  • Как воспроизвести: открыть /admin/content/texts/levels → 12 запросов к БД
  • Что сделать: Заменить цикл на два GROUP BY (COUNT + MAX(edited_at)) с ANY($1::text[])
  • Confidence: 0.9

7. assistant_admin_stats_n_plus_1

  • Файл: routers/assistant.py:400
  • Snippet: for lang in ["pl", "ru", "uk", "en"]: count = await conn.fetchval("SELECT COUNT(*) FROM users WHERE app_lang
  • Проблема: Админ-статистика ассистента делает 10 запросов вместо 2 — медленно при росте users
  • Как воспроизвести: GET /assistant/stats/admin → 10 COUNT-запросов
  • Что сделать: Заменить два цикла на GROUP BY app_language и GROUP BY current_level
  • Confidence: 0.9

8. leaderboard_admin_stats_n_plus_1

  • Файл: routers/leaderboard.py:250
  • Snippet: for lvl in LEVELS: count = await conn.fetchval( "SELECT COUNT(*) FROM users WHERE current_le
  • Проблема: Админ-статистика лидерборда делает 6 COUNT-запросов вместо 1 GROUP BY
  • Как воспроизвести: GET /leaderboard/admin/stats → 6 запросов
  • Что сделать: Заменить цикл на один GROUP BY current_level с ANY($1::text[])
  • Confidence: 0.9

9. init_achievements_n_plus_1

  • Файл: routers/achievements.py:200
  • Snippet: for a in ACHIEVEMENTS_DATA: exists = await conn.fetchval( "SELECT 1 FROM achievements WHERE
  • Проблема: Инициализация 52 достижений делает 52 SELECT + 52 INSERT/UPDATE — медленный старт приложения
  • Как воспроизвести: запустить init_achievements() → 104 запроса
  • Что сделать: Один SELECT всех code, затем bulk INSERT ... ON CONFLICT DO UPDATE через executemany
  • Confidence: 0.85

10. duplicate_track_endpoints

  • Файл: routers/achievements.py:280
  • Snippet: @router.post("/track-teacher-menu") async def track_teacher_menu_opened(request: Request):
  • Проблема: 7 почти идентичных эндпоинтов track-* — копипаста, при добавлении нового раздела нужно править 7 мест
  • Как воспроизвести: посмотреть routers/achievements.py — track-teacher-menu, track-progress, track-cheatsheets, track-pronunciation, track-ai-assistant, track-alphabet, track-rules
  • Что сделать: Один эндпоинт POST /track/{event} с валидацией event по whitelist и вызовом check_and_award_achievements
  • Confidence: 0.8

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

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

# 🤖 AI Code Review (Backend) **Дата:** 2026-09-24 18:22 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` ## 📊 По пакам - **routers** — 21 файлов, 327,764 символов, находок=10 - **core** — 4 файлов, 68,015 символов, находок=0 - **services** — 1 файлов, 0 символов, находок=0 --- ## 🔴 Влияет на ученика (3) ### 1. hint_consumed_before_word_paths_check - **Файл:** `routers/hints.py:60` - **Snippet:** `hints_already_used += 1 word_paths = level["word_paths"]` - **Проблема:** Ученик теряет подсказку: hints_used увеличивается, но эндпоинт возвращает 404 (нет word_paths), подсказка не выдана - **Как воспроизвести:** открыть уровень без word_paths → GET /hints/first-letter/{id} → 404, но hints_used в БД +1 - **Что сделать:** Перенести инкремент hints_used ПОСЛЕ проверки word_paths и found_word, либо обернуть в транзакцию с откатом - **Confidence:** 0.92 ### 2. hint_not_random_word - **Файл:** `routers/hints.py:78` - **Snippet:** `for word in all_level_words: if word in word_paths and word_paths[word]: found_word = word` - **Проблема:** Подсказка всегда показывает первое слово из списка, а не случайное ненайденное — ученик получает бесполезную подсказку по уже найденному слову - **Как воспроизвести:** открыть уровень → взять подсказку несколько раз → всегда одно и то же слово - **Что сделать:** Фильтровать слова по прогрессу (не найденные) и выбирать random.choice из оставшихся - **Confidence:** 0.85 ### 3. word_list_hint_consumed_on_empty - **Файл:** `routers/hints.py:130` - **Snippet:** `hints_already_used += 1 # Получаем слова words = await conn.fetch(` - **Проблема:** Если у уровня нет слов, hints_used всё равно растёт, а ученик получает пустой список — подсказка потрачена впустую - **Как воспроизвести:** открыть уровень без слов → GET /hints/word-list/{id} → пустой список, hints_used +1 - **Что сделать:** Сначала fetch слов, проверить len(words) > 0, и только потом инкрементить hints_used - **Confidence:** 0.85 ## 🟠 Риск для данных (1) ### 4. update_word_updates_all_same_spelling - **Файл:** `routers/admin_content.py:280` - **Snippet:** `WHERE level = $5 AND word_pl = $6 """, word_pl, translation_ru, translation_uk, translation_en, level, old_word_` - **Проблема:** При редактировании одного слова обновляются ВСЕ строки с тем же (level, word_pl) — если в уровне есть омонимы с разными переводами, они будут перезаписаны - **Как воспроизвести:** добавить два слова 'bank' с разными переводами в A1 → отредактировать одно → оба перезаписаны - **Что сделать:** Обновлять по id, а не по (level, word_pl); либо явно ограничить level_id IS NULL для чистых слов - **Confidence:** 0.75 ## 🟡 Качество кода (6) ### 5. admin_content_word_levels_n_plus_1 - **Файл:** `routers/admin_content.py:180` - **Snippet:** `for lvl in level_rows: code = lvl["code"] # 🔧 ФИКС: только level_id IS NULL count = ` - **Проблема:** Дашборд контента грузится медленно: 6 уровней × 2 запроса = 12 round-trip вместо 2 GROUP BY - **Как воспроизвести:** открыть /admin/content/words/levels → 12 запросов к БД - **Что сделать:** Заменить цикл на два GROUP BY (COUNT + MAX(edited_at)) с ANY($1::text[]) - **Confidence:** 0.9 ### 6. admin_content_text_levels_n_plus_1 - **Файл:** `routers/admin_content.py:400` - **Snippet:** `for lvl in level_rows: code = lvl["code"] count = await conn.fetchval( "SELECT C` - **Проблема:** Дашборд текстов грузится медленно: 6 уровней × 2 запроса = 12 round-trip - **Как воспроизвести:** открыть /admin/content/texts/levels → 12 запросов к БД - **Что сделать:** Заменить цикл на два GROUP BY (COUNT + MAX(edited_at)) с ANY($1::text[]) - **Confidence:** 0.9 ### 7. assistant_admin_stats_n_plus_1 - **Файл:** `routers/assistant.py:400` - **Snippet:** `for lang in ["pl", "ru", "uk", "en"]: count = await conn.fetchval("SELECT COUNT(*) FROM users WHERE app_lang` - **Проблема:** Админ-статистика ассистента делает 10 запросов вместо 2 — медленно при росте users - **Как воспроизвести:** GET /assistant/stats/admin → 10 COUNT-запросов - **Что сделать:** Заменить два цикла на GROUP BY app_language и GROUP BY current_level - **Confidence:** 0.9 ### 8. leaderboard_admin_stats_n_plus_1 - **Файл:** `routers/leaderboard.py:250` - **Snippet:** `for lvl in LEVELS: count = await conn.fetchval( "SELECT COUNT(*) FROM users WHERE current_le` - **Проблема:** Админ-статистика лидерборда делает 6 COUNT-запросов вместо 1 GROUP BY - **Как воспроизвести:** GET /leaderboard/admin/stats → 6 запросов - **Что сделать:** Заменить цикл на один GROUP BY current_level с ANY($1::text[]) - **Confidence:** 0.9 ### 9. init_achievements_n_plus_1 - **Файл:** `routers/achievements.py:200` - **Snippet:** `for a in ACHIEVEMENTS_DATA: exists = await conn.fetchval( "SELECT 1 FROM achievements WHERE ` - **Проблема:** Инициализация 52 достижений делает 52 SELECT + 52 INSERT/UPDATE — медленный старт приложения - **Как воспроизвести:** запустить init_achievements() → 104 запроса - **Что сделать:** Один SELECT всех code, затем bulk INSERT ... ON CONFLICT DO UPDATE через executemany - **Confidence:** 0.85 ### 10. duplicate_track_endpoints - **Файл:** `routers/achievements.py:280` - **Snippet:** `@router.post("/track-teacher-menu") async def track_teacher_menu_opened(request: Request):` - **Проблема:** 7 почти идентичных эндпоинтов track-* — копипаста, при добавлении нового раздела нужно править 7 мест - **Как воспроизвести:** посмотреть routers/achievements.py — track-teacher-menu, track-progress, track-cheatsheets, track-pronunciation, track-ai-assistant, track-alphabet, track-rules - **Что сделать:** Один эндпоинт POST /track/{event} с валидацией event по whitelist и вызовом check_and_award_achievements - **Confidence:** 0.8 --- **Итого:** всего находок=10, snippet не совпал=0, низкий confidence=0, прошло=10 _Этот 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#9