🤖 AI Review (backend): 10 задач (2026-09-23 15:55 UTC) #5

Open
opened 2026-09-23 15:55:35 +00:00 by Drobysh · 0 comments
Owner

🤖 AI Code Review (Backend)

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

📊 По пакам

  • routers — 21 файлов, 311,607 символов, находок=10
  • core — 4 файлов, 57,945 символов, находок=0
  • services — 1 файлов, 0 символов, находок=0

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

1. client_controlled_hints_game

  • Файл: routers/game.py:130
  • Snippet: hints_used = min(max(0, hints_used), 3)
  • Проблема: Клиент сам присылает hints_used=0 и получает максимальный score=100, даже если реально использовал подсказки. Читерство и завышенные очки в лидерборде.
  • Как воспроизвести: POST /game/complete-level {level_id, hints_used: 0, completion_time: 10} → score=100, хотя подсказки использовались
  • Что сделать: Читать hints_used из user_progress.hints_used (серверный счётчик, который инкрементится в /hints/*) и использовать его для расчёта score.
  • Confidence: 0.9

2. client_controlled_hints_bubblewords

  • Файл: routers/bubblewords.py:148
  • Snippet: hints_used = min(max(0, hints_used), 3) score = max(10, 100 - hints_used * 10)
  • Проблема: Клиент присылает hints_used=0 и получает score=100. Очки завышены, достижение bubble_perfect выдаётся без реального прохождения без подсказок.
  • Как воспроизвести: POST /bubblewords/complete {hints_used: 0, words_count: 3} → score=100, достижение bubble_perfect
  • Что сделать: Считать hints_used на сервере (например, из bubble_words_progress или отдельной таблицы), не доверять body.
  • Confidence: 0.9

3. client_controlled_mistakes_wordquiz

  • Файл: routers/wordquiz.py:175
  • Snippet: score = max(10, 50 - (mistakes * 20))
  • Проблема: Клиент присылает mistakes=0 и получает 50 очков за каждый правильный ответ, даже если ошибался. Очки завышены.
  • Как воспроизвести: POST /wordquiz/check {correct_polish, answer, mistakes: 0} → score=50
  • Что сделать: Считать mistakes на сервере (например, по количеству wrong-ответов в текущей сессии/слове), не доверять body.
  • Confidence: 0.88

4. sentence_hint_no_limit

  • Файл: routers/sentences.py:11
  • Snippet: @router.get("/{sentence_id}/hint") async def get_sentence_hint(sentence_id: int, request: Request): """Получить прав
  • Проблема: Докстринг обещает 'одноразово', но лимита нет. Ученик может дёргать эндпоинт бесконечно и получать правильный ответ, обходя игру.
  • Как воспроизвести: GET /sentences/42/hint → возвращает sentence_pl. Повторные вызовы работают без ограничений.
  • Что сделать: Добавить таблицу sentence_hints_used (user_id, sentence_id, used_at) и проверять/инкрементить в той же транзакции, как в routers/hints.py.
  • Confidence: 0.85

5. typing_hint_no_limit

  • Файл: routers/typing.py:88
  • Snippet: @router.get("/hint/{sentence_id}") async def get_typing_hint(request: Request, sentence_id: int): """Возвращает прав
  • Проблема: Ученик может бесконечно получать правильный ответ через /typing/hint/{id} и вставлять его в поле ввода — раздел 'Печать' теряет смысл.
  • Как воспроизвести: GET /typing/hint/42 → correct_answer. Повторные вызовы без ограничений.
  • Что сделать: Ввести лимит подсказок на предложение (таблица typing_hints_used) и инкрементить при выдаче.
  • Confidence: 0.85

6. online_now_counts_all_today_logins

  • Файл: routers/admin.py:60
  • Snippet: SELECT user_id FROM daily_logins WHERE login_date = CURRENT_DATE
  • Проблема: Админ видит завышенный 'online_now': в него попадают все, кто заходил сегодня, а не за последние 30 минут. Метрика бесполезна для мониторинга.
  • Как воспроизвести: Открыть /admin/dashboard в 23:00 — online_now покажет всех, кто заходил с 00:00, а не активных сейчас.
  • Что сделать: Заменить на daily_logins с полем timestamp (login_at) и фильтром > NOW() - INTERVAL '30 minutes', либо убрать эту ветку UNION.
  • Confidence: 0.82

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

7. feed_attachment_order_collision

  • Файл: routers/feed.py:480
  • Snippet: order_number = current_count # 0, 1, 2
  • Проблема: Если удалить вложение с order_number=0, а затем загрузить новое, оно получит order_number=1 и столкнётся с уже существующим вложением. Порядок картинок в посте ломается.
  • Как воспроизвести: Загрузить 2 картинки (order 0,1) → удалить первую → загрузить новую → order_number=1, дубль с существующей
  • Что сделать: Использовать MAX(order_number)+1 вместо COUNT(*), либо добавить UNIQUE(post_id, order_number) и обрабатывать конфликт.
  • Confidence: 0.78

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

8. admin_content_summary_n_plus_1

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

  • Snippet: `for lvl in level_rows:
    code = lvl["code"]

          topics_total = await conn.fetchval("""
            `
    
  • Проблема: Дашборд контент-менеджера делает 6 уровней × 5 запросов = 30 round-trip к БД на каждый GET /admin/content/summary. При росте числа уровней/таблиц деградирует.

  • Как воспроизвести: GET /admin/content/summary → 30+ запросов в логах asyncpg

  • Что сделать: Собрать одним запросом с GROUP BY level_code по каждой таблице (learning_topics, learning_lessons, level_words, sentences) и объединить в Python.

  • Confidence: 0.85

9. learning_get_lesson_n_plus_1

  • Файл: routers/learning.py:340
  • Snippet: for q in questions: options = await conn.fetch("SELECT * FROM question_options WHERE question_id = $1", q["q
  • Проблема: GET /learning/lessons/{id} делает N+1 запросов (по одному на каждый вопрос). При 10 вопросах — 11 запросов вместо 2.
  • Как воспроизвести: GET /learning/lessons/a1_greetings_l01 → в логах 1 запрос на questions + N на options
  • Что сделать: Один запрос: SELECT * FROM question_options WHERE question_id = ANY($1::text[]) и сгруппировать в Python по question_id.
  • Confidence: 0.85

10. assistant_personal_stats_n_plus_1

  • Файл: routers/assistant.py:320
  • Snippet: for level in LEVELS: # Филворды ws_total = await conn.fetchval("SELECT COUNT(*) FROM levels WHER
  • Проблема: GET /assistant/stats/personal делает 6 уровней × 6 запросов = 36 round-trip. Медленно на слабом соединении.
  • Как воспроизвести: GET /assistant/stats/personal → 36+ запросов в логах
  • Что сделать: Агрегировать одним запросом с GROUP BY level по каждой таблице (levels, sentences, user_progress, sentence_progress, word_quiz_progress, bubble_words_progress).
  • Confidence: 0.85

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

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

# 🤖 AI Code Review (Backend) **Дата:** 2026-09-23 15:55 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` ## 📊 По пакам - **routers** — 21 файлов, 311,607 символов, находок=10 - **core** — 4 файлов, 57,945 символов, находок=0 - **services** — 1 файлов, 0 символов, находок=0 --- ## 🔴 Влияет на ученика (6) ### 1. client_controlled_hints_game - **Файл:** `routers/game.py:130` - **Snippet:** `hints_used = min(max(0, hints_used), 3)` - **Проблема:** Клиент сам присылает hints_used=0 и получает максимальный score=100, даже если реально использовал подсказки. Читерство и завышенные очки в лидерборде. - **Как воспроизвести:** POST /game/complete-level {level_id, hints_used: 0, completion_time: 10} → score=100, хотя подсказки использовались - **Что сделать:** Читать hints_used из user_progress.hints_used (серверный счётчик, который инкрементится в /hints/*) и использовать его для расчёта score. - **Confidence:** 0.9 ### 2. client_controlled_hints_bubblewords - **Файл:** `routers/bubblewords.py:148` - **Snippet:** `hints_used = min(max(0, hints_used), 3) score = max(10, 100 - hints_used * 10)` - **Проблема:** Клиент присылает hints_used=0 и получает score=100. Очки завышены, достижение bubble_perfect выдаётся без реального прохождения без подсказок. - **Как воспроизвести:** POST /bubblewords/complete {hints_used: 0, words_count: 3} → score=100, достижение bubble_perfect - **Что сделать:** Считать hints_used на сервере (например, из bubble_words_progress или отдельной таблицы), не доверять body. - **Confidence:** 0.9 ### 3. client_controlled_mistakes_wordquiz - **Файл:** `routers/wordquiz.py:175` - **Snippet:** `score = max(10, 50 - (mistakes * 20))` - **Проблема:** Клиент присылает mistakes=0 и получает 50 очков за каждый правильный ответ, даже если ошибался. Очки завышены. - **Как воспроизвести:** POST /wordquiz/check {correct_polish, answer, mistakes: 0} → score=50 - **Что сделать:** Считать mistakes на сервере (например, по количеству wrong-ответов в текущей сессии/слове), не доверять body. - **Confidence:** 0.88 ### 4. sentence_hint_no_limit - **Файл:** `routers/sentences.py:11` - **Snippet:** `@router.get("/{sentence_id}/hint") async def get_sentence_hint(sentence_id: int, request: Request): """Получить прав` - **Проблема:** Докстринг обещает 'одноразово', но лимита нет. Ученик может дёргать эндпоинт бесконечно и получать правильный ответ, обходя игру. - **Как воспроизвести:** GET /sentences/42/hint → возвращает sentence_pl. Повторные вызовы работают без ограничений. - **Что сделать:** Добавить таблицу sentence_hints_used (user_id, sentence_id, used_at) и проверять/инкрементить в той же транзакции, как в routers/hints.py. - **Confidence:** 0.85 ### 5. typing_hint_no_limit - **Файл:** `routers/typing.py:88` - **Snippet:** `@router.get("/hint/{sentence_id}") async def get_typing_hint(request: Request, sentence_id: int): """Возвращает прав` - **Проблема:** Ученик может бесконечно получать правильный ответ через /typing/hint/{id} и вставлять его в поле ввода — раздел 'Печать' теряет смысл. - **Как воспроизвести:** GET /typing/hint/42 → correct_answer. Повторные вызовы без ограничений. - **Что сделать:** Ввести лимит подсказок на предложение (таблица typing_hints_used) и инкрементить при выдаче. - **Confidence:** 0.85 ### 6. online_now_counts_all_today_logins - **Файл:** `routers/admin.py:60` - **Snippet:** `SELECT user_id FROM daily_logins WHERE login_date = CURRENT_DATE` - **Проблема:** Админ видит завышенный 'online_now': в него попадают все, кто заходил сегодня, а не за последние 30 минут. Метрика бесполезна для мониторинга. - **Как воспроизвести:** Открыть /admin/dashboard в 23:00 — online_now покажет всех, кто заходил с 00:00, а не активных сейчас. - **Что сделать:** Заменить на daily_logins с полем timestamp (login_at) и фильтром > NOW() - INTERVAL '30 minutes', либо убрать эту ветку UNION. - **Confidence:** 0.82 ## 🟠 Риск для данных (1) ### 7. feed_attachment_order_collision - **Файл:** `routers/feed.py:480` - **Snippet:** `order_number = current_count # 0, 1, 2` - **Проблема:** Если удалить вложение с order_number=0, а затем загрузить новое, оно получит order_number=1 и столкнётся с уже существующим вложением. Порядок картинок в посте ломается. - **Как воспроизвести:** Загрузить 2 картинки (order 0,1) → удалить первую → загрузить новую → order_number=1, дубль с существующей - **Что сделать:** Использовать MAX(order_number)+1 вместо COUNT(*), либо добавить UNIQUE(post_id, order_number) и обрабатывать конфликт. - **Confidence:** 0.78 ## 🟡 Качество кода (3) ### 8. admin_content_summary_n_plus_1 - **Файл:** `routers/admin_content.py:60` - **Snippet:** `for lvl in level_rows: code = lvl["code"] topics_total = await conn.fetchval(""" ` - **Проблема:** Дашборд контент-менеджера делает 6 уровней × 5 запросов = 30 round-trip к БД на каждый GET /admin/content/summary. При росте числа уровней/таблиц деградирует. - **Как воспроизвести:** GET /admin/content/summary → 30+ запросов в логах asyncpg - **Что сделать:** Собрать одним запросом с GROUP BY level_code по каждой таблице (learning_topics, learning_lessons, level_words, sentences) и объединить в Python. - **Confidence:** 0.85 ### 9. learning_get_lesson_n_plus_1 - **Файл:** `routers/learning.py:340` - **Snippet:** `for q in questions: options = await conn.fetch("SELECT * FROM question_options WHERE question_id = $1", q["q` - **Проблема:** GET /learning/lessons/{id} делает N+1 запросов (по одному на каждый вопрос). При 10 вопросах — 11 запросов вместо 2. - **Как воспроизвести:** GET /learning/lessons/a1_greetings_l01 → в логах 1 запрос на questions + N на options - **Что сделать:** Один запрос: SELECT * FROM question_options WHERE question_id = ANY($1::text[]) и сгруппировать в Python по question_id. - **Confidence:** 0.85 ### 10. assistant_personal_stats_n_plus_1 - **Файл:** `routers/assistant.py:320` - **Snippet:** `for level in LEVELS: # Филворды ws_total = await conn.fetchval("SELECT COUNT(*) FROM levels WHER` - **Проблема:** GET /assistant/stats/personal делает 6 уровней × 6 запросов = 36 round-trip. Медленно на слабом соединении. - **Как воспроизвести:** GET /assistant/stats/personal → 36+ запросов в логах - **Что сделать:** Агрегировать одним запросом с GROUP BY level по каждой таблице (levels, sentences, user_progress, sentence_progress, word_quiz_progress, bubble_words_progress). - **Confidence:** 0.85 --- **Итого:** всего находок=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#5