🤖 AI Review: 15 задач (2026-09-21 17:08 UTC) #2

Open
opened 2026-09-21 17:08:06 +00:00 by Drobysh · 0 comments
Owner

🤖 AI Code Review

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


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

1. hints_not_tracked

  • Файл: routers/hints.py:30
  • Snippet: hints_already_used = progress["hints_used"] if progress else 0
  • Проблема: Подсказки не списываются: ученик может брать первую букву и список слов бесконечно, очки за уровень не снижаются
  • Как воспроизвести: открыть уровень → взять подсказку → hints_used в user_progress не растёт → взять ещё раз
  • Что сделать: UPDATE user_progress SET hints_used = hints_used + 1 в той же транзакции, что и выдача подсказки; либо отдельная таблица hint_usage
  • Confidence: 0.95

2. sentence_hint_free

  • Файл: routers/sentences.py:12
  • Snippet: return { "sentence_pl": row["sentence_pl"], }
  • Проблема: Подсказка «показать правильное предложение» не списывает очки и не трекается — можно смотреть ответ бесконечно
  • Как воспроизвести: GET /sentences/{id}/hint → правильный ответ без последствий
  • Что сделать: Трекать использование подсказки (например, отдельная таблица sentence_hints) и снижать score при проверке
  • Confidence: 0.85

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

3. client_controls_hints_used

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

4. client_controls_bubble_hints

  • Файл: routers/bubblewords.py:175
  • Snippet: hints_used = min(max(0, hints_used), 3) score = max(10, 100 - hints_used * 10)
  • Проблема: Клиент присылает hints_used=0 → всегда 100 очков в Bubble Words
  • Как воспроизвести: POST /bubblewords/complete с {"hints_used":0} → score=100
  • Что сделать: Считать hints_used на сервере (например, из bubble_words_progress или отдельной таблицы)
  • Confidence: 0.92

5. client_controls_quiz_mistakes

  • Файл: routers/wordquiz.py:155
  • Snippet: score = max(10, 50 - (mistakes * 20))
  • Проблема: Клиент присылает mistakes=0 → всегда 50 очков за слово, независимо от реальных ошибок
  • Как воспроизвести: POST /wordquiz/check с {"mistakes":0} → score=50
  • Что сделать: Считать mistakes на сервере (например, через отдельный эндпоинт /wordquiz/wrong-answer)
  • Confidence: 0.9

6. archive_no_transaction

  • Файл: archive_old_data.py:45
  • Snippet: moved = await conn.execute(""" INSERT INTO user_learning_answers_archive (user_id, skill_tag, correct, wrong_bec
  • Проблема: Если DELETE упадёт после INSERT — дубли в архиве; если INSERT упадёт после DELETE — потеря данных
  • Как воспроизвести: прервать процесс между INSERT и DELETE → рассинхрон
  • Что сделать: Обернуть INSERT + DELETE в async with conn.transaction()
  • Confidence: 0.85

7. xff_trusted_without_validation

  • Файл: main.py:130
  • Snippet: forwarded = request.headers.get("x-forwarded-for") if forwarded: client_ip = forwarded.split(",")[0].strip()
  • Проблема: Клиент может подделать X-Forwarded-For и обойти rate-limit, подставляя разные IP
  • Как воспроизвести: curl -H 'X-Forwarded-For: 1.2.3.4' ... → новый bucket лимита
  • Что сделать: Доверять XFF только от известных прокси (Cloudflare/nginx), либо использовать cf-connecting-ip приоритетно
  • Confidence: 0.85

8. upload_only_mime_check

  • Файл: routers/feed.py:470
  • Snippet: content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:
  • Проблема: Клиент может подделать content_type и загрузить произвольный файл (например, HTML/SVG с XSS) под видом image/png
  • Как воспроизвести: загрузить .html с Content-Type: image/png → файл сохранится и отдастся через /uploads
  • Что сделать: Проверять magic bytes (Pillow/ imghdr) и/или перекодировать через Pillow в безопасный формат
  • Confidence: 0.82

9. destructive_script_deletes_progress

  • Файл: generate_levels_v2.py:175
  • Snippet: await conn.execute("DELETE FROM user_progress")
  • Проблема: Скрипт удаляет ВЕСЬ прогресс всех пользователей по филвордам, предложениям, квизу и пузырям без подтверждения
  • Как воспроизвести: python3 generate_levels_v2.py → весь прогресс игр стёрт
  • Что сделать: Добавить подтверждение (input YES) и/или флаг --force, как в full_reset.py
  • Confidence: 0.9

10. analytics_no_rate_limit

  • Файл: routers/learning.py:620
  • Snippet: @router.post("/analytics") async def get_analytics(request: Request):
  • Проблема: Эндпоинт вызывает дорогой AI (MiniMax-M3) без отдельного лимита — только default 60/мин, что позволяет выжигать бюджет
  • Как воспроизвести: 60 POST /learning/analytics в минуту → 60 AI-вызовов
  • Что сделать: Добавить "/learning/analytics" в rate_limiter.limits с лимитом 5-10/мин
  • Confidence: 0.85

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

11. drop_matview_on_startup

  • Файл: main.py:175
  • Snippet: await conn.execute("DROP MATERIALIZED VIEW IF EXISTS leaderboard_cache")
  • Проблема: При каждом рестарте бэкенда рейтинг полностью пересоздаётся — тяжёлый запрос, лидерборд недоступен несколько секунд
  • Как воспроизвести: перезапустить uvicorn → в логах DROP + CREATE MATERIALIZED VIEW
  • Что сделать: Использовать CREATE MATERIALIZED VIEW IF NOT EXISTS без DROP; для изменения схемы — отдельная миграция
  • Confidence: 0.88

12. create_table_in_endpoint

  • Файл: routers/teacher.py:340
  • Snippet: await conn.execute(""" CREATE TABLE IF NOT EXISTS daily_phrases (
  • Проблема: DDL выполняется на каждый GET /teacher/phrase-of-day — лишняя нагрузка и блокировки на проде
  • Как воспроизвести: GET /teacher/phrase-of-day → в логах CREATE TABLE IF NOT EXISTS
  • Что сделать: Перенести CREATE TABLE в database.py init_db()
  • Confidence: 0.9

13. dead_code_in_require_auth

  • Файл: auth.py:105
  • Snippet: if not init_data: # Пробуем из тела для POST запросов # (некоторые клиенты могут отправлять initData в т
  • Проблема: Мёртвый код — комментарий обещает чтение из тела, но ничего не делает
  • Как воспроизвести: отправить initData только в теле POST → 401
  • Что сделать: Удалить блок или реализовать чтение из тела (await request.json())
  • Confidence: 0.95

14. in_memory_rate_limiter

  • Файл: main.py:40
  • Snippet: class RateLimiter: def __init__(self): self.requests = defaultdict(list)
  • Проблема: При нескольких воркерах uvicorn (--workers 4) лимиты не работают — каждый воркер считает свои
  • Как воспроизвести: uvicorn --workers 4 → 4× превышение лимита
  • Что сделать: Использовать Redis (или slowapi с Redis backend) для общего счётчика
  • Confidence: 0.88

15. migrations_on_every_startup

  • Файл: database.py:40
  • Snippet: await conn.execute(""" ALTER TABLE levels DROP CONSTRAINT IF EXISTS levels_level_number_key """)
  • Проблема: На каждый старт бэкенда — десятки ALTER TABLE / information_schema запросов, замедляет запуск и создаёт блокировки
  • Как воспроизвести: перезапустить uvicorn → в логах десятки ALTER TABLE
  • Что сделать: Вынести миграции в отдельный скрипт (alembic / migrate.py), запускать вручную или через CI
  • Confidence: 0.85

Статистика фильтрации: всего=15, нет файла=0, snippet не совпал=0, низкий confidence=0, прошло=15

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

# 🤖 AI Code Review **Дата:** 2026-09-21 17:08 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` --- ## 🔴 Влияет на ученика (2) ### 1. hints_not_tracked - **Файл:** `routers/hints.py:30` - **Snippet:** `hints_already_used = progress["hints_used"] if progress else 0` - **Проблема:** Подсказки не списываются: ученик может брать первую букву и список слов бесконечно, очки за уровень не снижаются - **Как воспроизвести:** открыть уровень → взять подсказку → hints_used в user_progress не растёт → взять ещё раз - **Что сделать:** UPDATE user_progress SET hints_used = hints_used + 1 в той же транзакции, что и выдача подсказки; либо отдельная таблица hint_usage - **Confidence:** 0.95 ### 2. sentence_hint_free - **Файл:** `routers/sentences.py:12` - **Snippet:** `return { "sentence_pl": row["sentence_pl"], }` - **Проблема:** Подсказка «показать правильное предложение» не списывает очки и не трекается — можно смотреть ответ бесконечно - **Как воспроизвести:** GET /sentences/{id}/hint → правильный ответ без последствий - **Что сделать:** Трекать использование подсказки (например, отдельная таблица sentence_hints) и снижать score при проверке - **Confidence:** 0.85 ## 🟠 Риск для данных (8) ### 3. client_controls_hints_used - **Файл:** `routers/game.py:205` - **Snippet:** `hints_used = min(max(0, hints_used), 3)` - **Проблема:** Клиент присылает hints_used=0 → всегда 100 очков за уровень, даже если реально использовал подсказки - **Как воспроизвести:** POST /game/complete-level с {"level_id":1,"hints_used":0} → score=100 - **Что сделать:** Считать hints_used на сервере из user_progress.hints_used, а не доверять телу запроса - **Confidence:** 0.93 ### 4. client_controls_bubble_hints - **Файл:** `routers/bubblewords.py:175` - **Snippet:** `hints_used = min(max(0, hints_used), 3) score = max(10, 100 - hints_used * 10)` - **Проблема:** Клиент присылает hints_used=0 → всегда 100 очков в Bubble Words - **Как воспроизвести:** POST /bubblewords/complete с {"hints_used":0} → score=100 - **Что сделать:** Считать hints_used на сервере (например, из bubble_words_progress или отдельной таблицы) - **Confidence:** 0.92 ### 5. client_controls_quiz_mistakes - **Файл:** `routers/wordquiz.py:155` - **Snippet:** `score = max(10, 50 - (mistakes * 20))` - **Проблема:** Клиент присылает mistakes=0 → всегда 50 очков за слово, независимо от реальных ошибок - **Как воспроизвести:** POST /wordquiz/check с {"mistakes":0} → score=50 - **Что сделать:** Считать mistakes на сервере (например, через отдельный эндпоинт /wordquiz/wrong-answer) - **Confidence:** 0.9 ### 6. archive_no_transaction - **Файл:** `archive_old_data.py:45` - **Snippet:** `moved = await conn.execute(""" INSERT INTO user_learning_answers_archive (user_id, skill_tag, correct, wrong_bec` - **Проблема:** Если DELETE упадёт после INSERT — дубли в архиве; если INSERT упадёт после DELETE — потеря данных - **Как воспроизвести:** прервать процесс между INSERT и DELETE → рассинхрон - **Что сделать:** Обернуть INSERT + DELETE в async with conn.transaction() - **Confidence:** 0.85 ### 7. xff_trusted_without_validation - **Файл:** `main.py:130` - **Snippet:** `forwarded = request.headers.get("x-forwarded-for") if forwarded: client_ip = forwarded.split(",")[0].strip()` - **Проблема:** Клиент может подделать X-Forwarded-For и обойти rate-limit, подставляя разные IP - **Как воспроизвести:** curl -H 'X-Forwarded-For: 1.2.3.4' ... → новый bucket лимита - **Что сделать:** Доверять XFF только от известных прокси (Cloudflare/nginx), либо использовать cf-connecting-ip приоритетно - **Confidence:** 0.85 ### 8. upload_only_mime_check - **Файл:** `routers/feed.py:470` - **Snippet:** `content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:` - **Проблема:** Клиент может подделать content_type и загрузить произвольный файл (например, HTML/SVG с XSS) под видом image/png - **Как воспроизвести:** загрузить .html с Content-Type: image/png → файл сохранится и отдастся через /uploads - **Что сделать:** Проверять magic bytes (Pillow/ imghdr) и/или перекодировать через Pillow в безопасный формат - **Confidence:** 0.82 ### 9. destructive_script_deletes_progress - **Файл:** `generate_levels_v2.py:175` - **Snippet:** `await conn.execute("DELETE FROM user_progress")` - **Проблема:** Скрипт удаляет ВЕСЬ прогресс всех пользователей по филвордам, предложениям, квизу и пузырям без подтверждения - **Как воспроизвести:** python3 generate_levels_v2.py → весь прогресс игр стёрт - **Что сделать:** Добавить подтверждение (input YES) и/или флаг --force, как в full_reset.py - **Confidence:** 0.9 ### 10. analytics_no_rate_limit - **Файл:** `routers/learning.py:620` - **Snippet:** `@router.post("/analytics") async def get_analytics(request: Request):` - **Проблема:** Эндпоинт вызывает дорогой AI (MiniMax-M3) без отдельного лимита — только default 60/мин, что позволяет выжигать бюджет - **Как воспроизвести:** 60 POST /learning/analytics в минуту → 60 AI-вызовов - **Что сделать:** Добавить "/learning/analytics" в rate_limiter.limits с лимитом 5-10/мин - **Confidence:** 0.85 ## 🟡 Качество кода (5) ### 11. drop_matview_on_startup - **Файл:** `main.py:175` - **Snippet:** `await conn.execute("DROP MATERIALIZED VIEW IF EXISTS leaderboard_cache")` - **Проблема:** При каждом рестарте бэкенда рейтинг полностью пересоздаётся — тяжёлый запрос, лидерборд недоступен несколько секунд - **Как воспроизвести:** перезапустить uvicorn → в логах DROP + CREATE MATERIALIZED VIEW - **Что сделать:** Использовать CREATE MATERIALIZED VIEW IF NOT EXISTS без DROP; для изменения схемы — отдельная миграция - **Confidence:** 0.88 ### 12. create_table_in_endpoint - **Файл:** `routers/teacher.py:340` - **Snippet:** `await conn.execute(""" CREATE TABLE IF NOT EXISTS daily_phrases (` - **Проблема:** DDL выполняется на каждый GET /teacher/phrase-of-day — лишняя нагрузка и блокировки на проде - **Как воспроизвести:** GET /teacher/phrase-of-day → в логах CREATE TABLE IF NOT EXISTS - **Что сделать:** Перенести CREATE TABLE в database.py init_db() - **Confidence:** 0.9 ### 13. dead_code_in_require_auth - **Файл:** `auth.py:105` - **Snippet:** `if not init_data: # Пробуем из тела для POST запросов # (некоторые клиенты могут отправлять initData в т` - **Проблема:** Мёртвый код — комментарий обещает чтение из тела, но ничего не делает - **Как воспроизвести:** отправить initData только в теле POST → 401 - **Что сделать:** Удалить блок или реализовать чтение из тела (await request.json()) - **Confidence:** 0.95 ### 14. in_memory_rate_limiter - **Файл:** `main.py:40` - **Snippet:** `class RateLimiter: def __init__(self): self.requests = defaultdict(list)` - **Проблема:** При нескольких воркерах uvicorn (--workers 4) лимиты не работают — каждый воркер считает свои - **Как воспроизвести:** uvicorn --workers 4 → 4× превышение лимита - **Что сделать:** Использовать Redis (или slowapi с Redis backend) для общего счётчика - **Confidence:** 0.88 ### 15. migrations_on_every_startup - **Файл:** `database.py:40` - **Snippet:** `await conn.execute(""" ALTER TABLE levels DROP CONSTRAINT IF EXISTS levels_level_number_key """)` - **Проблема:** На каждый старт бэкенда — десятки ALTER TABLE / information_schema запросов, замедляет запуск и создаёт блокировки - **Как воспроизвести:** перезапустить uvicorn → в логах десятки ALTER TABLE - **Что сделать:** Вынести миграции в отдельный скрипт (alembic / migrate.py), запускать вручную или через CI - **Confidence:** 0.85 --- **Статистика фильтрации:** всего=15, нет файла=0, snippet не совпал=0, низкий confidence=0, прошло=15 _Этот 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#2