Проблема: При нескольких воркерах 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 создан автоматически. Исправления делаются вручную._
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
🤖 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:30hints_already_used = progress["hints_used"] if progress else 02. sentence_hint_free
routers/sentences.py:12return { "sentence_pl": row["sentence_pl"], }🟠 Риск для данных (8)
3. client_controls_hints_used
routers/game.py:205hints_used = min(max(0, hints_used), 3)4. client_controls_bubble_hints
routers/bubblewords.py:175hints_used = min(max(0, hints_used), 3) score = max(10, 100 - hints_used * 10)5. client_controls_quiz_mistakes
routers/wordquiz.py:155score = max(10, 50 - (mistakes * 20))6. archive_no_transaction
archive_old_data.py:45moved = await conn.execute(""" INSERT INTO user_learning_answers_archive (user_id, skill_tag, correct, wrong_bec7. xff_trusted_without_validation
main.py:130forwarded = request.headers.get("x-forwarded-for") if forwarded: client_ip = forwarded.split(",")[0].strip()8. upload_only_mime_check
routers/feed.py:470content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:9. destructive_script_deletes_progress
generate_levels_v2.py:175await conn.execute("DELETE FROM user_progress")10. analytics_no_rate_limit
routers/learning.py:620@router.post("/analytics") async def get_analytics(request: Request):🟡 Качество кода (5)
11. drop_matview_on_startup
main.py:175await conn.execute("DROP MATERIALIZED VIEW IF EXISTS leaderboard_cache")12. create_table_in_endpoint
routers/teacher.py:340await conn.execute(""" CREATE TABLE IF NOT EXISTS daily_phrases (13. dead_code_in_require_auth
auth.py:105if not init_data: # Пробуем из тела для POST запросов # (некоторые клиенты могут отправлять initData в т14. in_memory_rate_limiter
main.py:40class RateLimiter: def __init__(self): self.requests = defaultdict(list)15. migrations_on_every_startup
database.py:40await conn.execute(""" ALTER TABLE levels DROP CONSTRAINT IF EXISTS levels_level_number_key """)Статистика фильтрации: всего=15, нет файла=0, snippet не совпал=0, низкий confidence=0, прошло=15
Этот Issue создан автоматически. Исправления делаются вручную.