Snippet:if mistakes >= 3: await conn.execute(""" INSERT INTO word_quiz_progress (user_id, wo
Проблема: после 3 ошибок каждый следующий неверный ответ снова даёт +10 очков — ученик фармит total_score бесконечно, отвечая неправильно
Как воспроизвести: 3 раза ответить неверно → +10; 4-й раз неверно → ещё +10; и так далее без сброса current_mistakes
Что сделать: начислять утешительные 10 очков только один раз (например, при переходе mistakes с 2 на 3), либо сбрасывать current_mistakes после начисления
Confidence: 0.9
2. streak_increments_on_repeat_word
Файл:routers/game.py:168
Snippet:for word in word_paths.keys(): if word.lower() == selected_word: found_word = word
Проблема: ученик может находить одно и то же слово много раз подряд — current_streak растёт, достижение perfect_words выдаётся без реального прогресса
Как воспроизвести: найти одно слово 5 раз подряд → server_streak=5 → perfect_words
Что сделать: хранить список уже найденных слов уровня (например, в user_progress.found_words) и инкрементить streak только для нового слова
Confidence: 0.85
3. get_feed_post_no_expires_check
Файл:routers/feed.py:175
Snippet:row = await conn.fetchrow(""" SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE """, po
Проблема: Истёкший пост (expires_at < NOW()) не виден в ленте, но доступен по прямой ссылке /feed/post/{id} — юзер видит устаревшую акцию/партнёра.
Как воспроизвести: GET /feed/{section} → пост скрыт; GET /feed/post/{id} того же поста → 200 с данными.
Что сделать: Добавить в WHERE: AND (expires_at IS NULL OR expires_at > NOW()).
Confidence: 0.9
4. admin_update_feed_post_title_null
Файл:routers/feed.py:500
Snippet:title = body.get("title", existing.get(f"title_{source_language}") or "")
Проблема: Если клиент пришлёт "title": null, в БД запишется NULL вместо старого значения — заголовок поста пропадёт (fallback уйдёт на _en/_pl).
Как воспроизвести: PUT /admin/feed/post/{id} с {"title": null} → title_ru = NULL.
Что сделать: Использовать body.get("title") or existing.get(...) or "" — пустое/None значение не должно перезаписывать существующее.
Confidence: 0.75
5. rate_limit_on_static_uploads
Файл:main.py:189
Snippet:if path in ["/", "/health"]: return await call_next(request)
Проблема: Запросы к /uploads/* (картинки feed-постов) идут через rate limiter с лимитом default 60/мин. При быстром скролле карусели с 3 картинками на пост пользователь упирается в 429 и картинки не грузятся.
Как воспроизвести: открыть feed → быстро проскроллить 20+ постов с картинками → часть изображений отдаёт 429
Что сделать: Добавить префикс /uploads в исключения middleware (path.startswith('/uploads/')) или вынести StaticFiles до rate-limit middleware.
Confidence: 0.72
6. rate_limit_per_ip_not_per_user
Файл:main.py:207
Snippet:rate_key = f"{client_ip}:{path}"
Проблема: Лимит считается по IP, а не по telegram_id. Ученики в школе/офисе/CGNAT за одним NAT делят один bucket — один активный пользователь блокирует остальных. Middleware выполняется ДО auth, поэтому отличить пользователей нельзя.
Как воспроизвести: два ученика за одним Wi-Fi → один делает 30 запросов /game/check-word → второй получает 429
Что сделать: Перенести rate-limit после require_auth и ключевать по user_id (fallback на IP для неаутентифицированных).
Проблема: при параллельных запросах лимит 3 подсказки обходится — ученик получает больше подсказок, чем разрешено
Как воспроизвести: два одновременных GET /hints/first-letter/{id} при hints_used=2 → оба проходят проверку, hints_used становится 4
Что сделать: делать атомарный UPDATE ... WHERE hints_used < 3 RETURNING hints_used, либо SELECT ... FOR UPDATE внутри транзакции
Confidence: 0.78
9. complete_level_toctou_race
Файл:routers/game.py:268
Snippet:existing_progress = await conn.fetchrow( "SELECT score FROM user_progress WHERE user_id = $1 AND level_id =
Проблема: два параллельных POST /game/complete-level могут оба пройти проверку и попытаться вставить строку — второй INSERT упадёт с ошибкой БД (нет ON CONFLICT)
Как воспроизвести: два одновременных запроса на один level_id → IntegrityError на втором INSERT
Что сделать: добавить ON CONFLICT (user_id, level_id) DO NOTHING в INSERT, либо использовать SELECT ... FOR UPDATE
Проблема: нет проверки completion_time — ученик может отправить правильный ответ мгновенно (скопировав из подсказки), прогресс засчитывается
Как воспроизвести: GET /typing/hint/{id} → сразу POST /typing/check с тем же текстом → correct:true
Что сделать: добавить проверку completion_time (как в sentences.py) и/или не отдавать правильный ответ в /hint без списания лимита
Confidence: 0.7
11. completion_time_client_controlled
Файл:routers/game.py:232
Snippet:if completion_time is not None and completion_time < 5: raise HTTPException(400, "Completion time too fast. Mini
Проблема: completion_time приходит от клиента — ученик просто отправляет 5 и получает достижение speed_level, античит бесполезен
Как воспроизвести: POST /game/complete-level {level_id:1, completion_time:5} → speed_level выдан
Что сделать: замерять время на сервере (сохранять started_at при выдаче уровня и считать разницу), либо не выдавать speed-достижения по клиентскому времени
Snippet:removed_images = body.get("removed_images", []) if removed_images and isinstance(removed_images, list):
Проблема: Если UPDATE feed_posts упадёт (например, невалидный expires_at), вложения уже удалены из БД, но файлы на диске остались — пост теряет картинки без отката.
Как воспроизвести: PUT /admin/feed/post/{id} с removed_images=[...] и битым expires_at → 400, но feed_attachments уже пуст.
Что сделать: Обернуть DELETE feed_attachments и UPDATE feed_posts в одну conn.transaction(); файлы удалять только после успешного commit.
Confidence: 0.85
13. admin_upload_feed_image_mime_only
Файл:routers/feed.py:620
Snippet:content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:
Проблема: Проверяется только клиентский Content-Type. Можно залить произвольный файл (HTML/SVG/скрипт) с подделанным MIME — он попадёт в /uploads/feed/ и будет отдаваться как есть.
Как воспроизвести: curl -F 'file=@evil.html;type=image/png' /admin/feed/upload-image → файл сохранён как .png, но содержимое — HTML.
Что сделать: Проверять magic bytes (Pillow Image.open + verify) или перекодировать через PIL в безопасный формат перед сохранением.
Confidence: 0.82
14. initdata_in_query_param
Файл:auth.py:118
Snippet:if not init_data: init_data = request.query_params.get('initData', '')
Проблема: initData (подписанный токен Telegram) попадает в URL — утекает в access-логи nginx/Cloudflare, Referer, историю браузера, кэш CDN. Злоумышленник с логами может переиспользовать токен до истечения 4ч.
Как воспроизвести: открыть DevTools → Network → любой запрос deleteFeedPost → initData виден в query string и в логах сервера
Что сделать: Убрать fallback на query-параметр; передавать initData только через Authorization: tma или X-Telegram-InitData. Если нужен обход CF preflight — использовать POST с телом.
Confidence: 0.88
15. cf_ip_check_behind_nginx
Файл:main.py:197
Snippet:real_client_ip = request.client.host if request.client else "unknown"
Проблема: Если приложение стоит за nginx (reverse proxy), request.client.host = IP nginx (127.0.0.1), а не Cloudflare. _is_cloudflare_ip вернёт False, и client_ip станет 127.0.0.1 для ВСЕХ пользователей — единый rate-limit bucket, любой пользователь блокирует остальных.
Как воспроизвести: запустить за nginx → сделать 60 запросов с одного клиента → все остальные получают 429
Что сделать: Проверять X-Forwarded-For / X-Real-IP от доверенного прокси (nginx), либо явно указать список доверенных прокси и брать последний IP из XFF.
Confidence: 0.78
🟡 Качество кода (10)
16. words_count_unused
Файл:routers/bubblewords.py:152
Snippet:words_count = body.get("words_count", 3)
Проблема: поле words_count приходит от клиента, но нигде не используется — мёртвый код, вводит в заблуждение
Как воспроизвести: grep words_count в bubblewords.py — только чтение из body
Что сделать: удалить переменную или использовать её для валидации/расчёта очков
Проблема: если CSV-файл отсутствует или повреждён, init_sentences падает с FileNotFoundError и роняет старт приложения
Как воспроизвести: удалить sentences_a1.csv → запуск приложения → FileNotFoundError
Что сделать: обернуть в try/except, логировать и продолжать с остальными уровнями; либо проверять os.path.exists
Confidence: 0.75
18. hint_docstring_mismatch
Файл:routers/hints.py:9
Snippet:"""Подсказка: показывает первую букву случайного ненайденного слова"""
Проблема: докстринг обещает случайное ненайденное слово, а код возвращает первое слово с путём из word_paths — поведение не соответствует документации
Как воспроизвести: GET /hints/first-letter/{id} всегда возвращает одно и то же слово (первое в word_paths)
Что сделать: либо реализовать выбор случайного ненайденного слова (исключая уже найденные), либо поправить докстринг
Confidence: 0.72
19. admin_content_get_word_levels_n_plus_1
Файл:routers/admin_content.py:220
Snippet:count = await conn.fetchval( "SELECT COUNT(*) FROM level_words WHERE level = $1 AND level_id IS NULL", c
Проблема: Дашборд контент-менеджера открывается медленнее: 6 уровней × 2 запроса = 12 round-trip вместо одного GROUP BY.
Как воспроизвести: GET /admin/content/words/levels → в логах 12 последовательных SELECT по level_words.
Что сделать: Заменить цикл на один запрос: SELECT level, COUNT(*), MAX(edited_at) FROM level_words WHERE level = ANY($1) AND level_id IS NULL GROUP BY level.
Confidence: 0.95
20. update_lesson_n_plus_1
Файл:routers/admin_content.py:720
Snippet:for q in questions: # Проверяем, что вопрос принадлежит этому уроку q_exists = await con
Проблема: Сохранение урока с 20 вопросами и 4 опциями = ~100 последовательных запросов внутри транзакции; долгая блокировка строк и таймауты на медленной сети.
Как воспроизвести: PUT /admin/content/lessons/lesson/{id} с большим уроком → в логах десятки SELECT/UPDATE/INSERT подряд.
Что сделать: Одним запросом проверить принадлежность всех question_id (SELECT question_id FROM learning_questions WHERE lesson_id=$1 AND question_id = ANY($2)), затем батчить UPDATE/INSERT через executemany.
Confidence: 0.85
21. update_lesson_option_key_26_limit
Файл:routers/admin_content.py:690
Snippet:option_key = chr(ord('A') + idx) # A, B, C, D...
Проблема: При >26 вариантах ответа генерируются символы '[' '\' ']' и т.п. — фронт не сможет сопоставить correct_answer с вариантом.
Как воспроизвести: Отправить вопрос с 27 опциями → option_key = '[' для 27-й.
Что сделать: Ограничить число опций (например, 6) с явной ошибкой 400, либо использовать двухбуквенные ключи (AA, AB...).
Confidence: 0.8
22. admin_upload_feed_image_sync_write
Файл:routers/feed.py:665
Snippet:file_path_disk.write_bytes(content)
Проблема: Синхронная запись до 5 МБ блокирует event loop FastAPI — параллельные запросы других юзеров подвисают на время записи.
Как воспроизвести: Загрузить 5 МБ картинку → на время write_bytes другие запросы к API задерживаются.
Что сделать: Использовать aiofiles.open(...).write(content) или вынести запись в run_in_executor.
Confidence: 0.8
23. redundant_indexes_levels_sentences
Файл:database.py:640
Snippet:await conn.execute("CREATE INDEX IF NOT EXISTS idx_levels_number ON levels(level_number)")
Проблема: Дублирующие индексы: idx_levels_number покрыт idx_levels_level_number(level, level_number); idx_levels_level покрыт тем же; idx_sentences_number и idx_sentences_level покрыты idx_sentences_level_number. Лишний write-overhead и место на диске.
Как воспроизвести: SELECT indexname FROM pg_indexes WHERE tablename='levels' — увидеть 3 индекса, из которых 2 избыточны
Что сделать: Удалить idx_levels_number, idx_levels_level, idx_sentences_number, idx_sentences_level — составной (level, level_number) покрывает запросы по level и по level+number.
Confidence: 0.9
24. rate_limiter_cleanup_hardcoded_window
Файл:main.py:96
Snippet:self.requests[key] = [t for t in self.requests[key] if now - t < 60]
Проблема: Фоновый _cleanup использует жёстко зашитые 60с, а не window из self.limits. Если позже добавят лимит с window > 60с, записи будут удаляться раньше времени и лимит перестанет работать (тихая дыра в защите).
Как воспроизвести: добавить в limits запись с window=300 → cleanup удалит её записи через 60с → лимит не срабатывает
Что сделать: В _cleanup брать максимальный window из self.limits или хранить window рядом с timestamp.
Confidence: 0.8
25. user_id_type_inconsistency
Файл:auth.py:82
Snippet:user_id = user_data.get('id')
Проблема: Telegram может вернуть id как int или как строку (в зависимости от клиента). Дальше user_id уходит в SQL как BIGINT — asyncpg кинет ошибку типа, если пришла строка, и ученик получит 500 вместо входа.
Как воспроизвести: передать initData с user.id в виде строки "123" → asyncpg.DataError при INSERT/UPDATE
Что сделать: Явно приводить: user_id = int(user_data.get('id')) с обработкой ValueError → 401.
Confidence: 0.72
Итого: всего находок=25, snippet не совпал=0, низкий confidence=0, прошло=25
Этот Issue создан автоматически. Исправления делаются вручную.
# 🤖 AI Code Review (Backend)
**Дата:** 2026-09-25 16:01 UTC
**Модель:** `deepseek-ai/DeepSeek-V4.1-Flash`
**Репозиторий:** `Drobysh/filwordspl-backend`
## 📊 По пакам
- **routers_games** — 7 файлов, 63,953 символов, находок=10
- **routers_learning** — 4 файлов, 99,070 символов, находок=0
- **routers_admin** — 4 файлов, 96,370 символов, находок=8
- **routers_misc** — 5 файлов, 69,714 символов, находок=0
- **core** — 4 файлов, 69,297 символов, находок=7
- **services** — 0 файлов, 0 символов, находок=0
---
## 🔴 Влияет на ученика (6)
### 1. consolation_score_farmable
- **Файл:** `routers/wordquiz.py:200`
- **Snippet:** `if mistakes >= 3:
await conn.execute("""
INSERT INTO word_quiz_progress (user_id, wo`
- **Проблема:** после 3 ошибок каждый следующий неверный ответ снова даёт +10 очков — ученик фармит total_score бесконечно, отвечая неправильно
- **Как воспроизвести:** 3 раза ответить неверно → +10; 4-й раз неверно → ещё +10; и так далее без сброса current_mistakes
- **Что сделать:** начислять утешительные 10 очков только один раз (например, при переходе mistakes с 2 на 3), либо сбрасывать current_mistakes после начисления
- **Confidence:** 0.9
### 2. streak_increments_on_repeat_word
- **Файл:** `routers/game.py:168`
- **Snippet:** `for word in word_paths.keys():
if word.lower() == selected_word:
found_word = word
`
- **Проблема:** ученик может находить одно и то же слово много раз подряд — current_streak растёт, достижение perfect_words выдаётся без реального прогресса
- **Как воспроизвести:** найти одно слово 5 раз подряд → server_streak=5 → perfect_words
- **Что сделать:** хранить список уже найденных слов уровня (например, в user_progress.found_words) и инкрементить streak только для нового слова
- **Confidence:** 0.85
### 3. get_feed_post_no_expires_check
- **Файл:** `routers/feed.py:175`
- **Snippet:** `row = await conn.fetchrow("""
SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE
""", po`
- **Проблема:** Истёкший пост (expires_at < NOW()) не виден в ленте, но доступен по прямой ссылке /feed/post/{id} — юзер видит устаревшую акцию/партнёра.
- **Как воспроизвести:** GET /feed/{section} → пост скрыт; GET /feed/post/{id} того же поста → 200 с данными.
- **Что сделать:** Добавить в WHERE: AND (expires_at IS NULL OR expires_at > NOW()).
- **Confidence:** 0.9
### 4. admin_update_feed_post_title_null
- **Файл:** `routers/feed.py:500`
- **Snippet:** `title = body.get("title", existing.get(f"title_{source_language}") or "")`
- **Проблема:** Если клиент пришлёт "title": null, в БД запишется NULL вместо старого значения — заголовок поста пропадёт (fallback уйдёт на _en/_pl).
- **Как воспроизвести:** PUT /admin/feed/post/{id} с {"title": null} → title_ru = NULL.
- **Что сделать:** Использовать `body.get("title") or existing.get(...) or ""` — пустое/None значение не должно перезаписывать существующее.
- **Confidence:** 0.75
### 5. rate_limit_on_static_uploads
- **Файл:** `main.py:189`
- **Snippet:** `if path in ["/", "/health"]:
return await call_next(request)`
- **Проблема:** Запросы к /uploads/* (картинки feed-постов) идут через rate limiter с лимитом default 60/мин. При быстром скролле карусели с 3 картинками на пост пользователь упирается в 429 и картинки не грузятся.
- **Как воспроизвести:** открыть feed → быстро проскроллить 20+ постов с картинками → часть изображений отдаёт 429
- **Что сделать:** Добавить префикс /uploads в исключения middleware (path.startswith('/uploads/')) или вынести StaticFiles до rate-limit middleware.
- **Confidence:** 0.72
### 6. rate_limit_per_ip_not_per_user
- **Файл:** `main.py:207`
- **Snippet:** `rate_key = f"{client_ip}:{path}"`
- **Проблема:** Лимит считается по IP, а не по telegram_id. Ученики в школе/офисе/CGNAT за одним NAT делят один bucket — один активный пользователь блокирует остальных. Middleware выполняется ДО auth, поэтому отличить пользователей нельзя.
- **Как воспроизвести:** два ученика за одним Wi-Fi → один делает 30 запросов /game/check-word → второй получает 429
- **Что сделать:** Перенести rate-limit после require_auth и ключевать по user_id (fallback на IP для неаутентифицированных).
- **Confidence:** 0.75
## 🟠 Риск для данных (9)
### 7. client_controlled_correct_answer
- **Файл:** `routers/wordquiz.py:118`
- **Snippet:** `correct_polish = body.get("correct_polish", "")
user_answer = body.get("answer", "")`
- **Проблема:** ученик может отправить correct_polish="x" и answer="x" — сервер всегда считает ответ верным, очки и streak начисляются бесконечно
- **Как воспроизвести:** POST /wordquiz/check {correct_polish:"a", answer:"a", completion_time:2} → correct:true, score начислен
- **Что сделать:** сервер должен сам достать правильный ответ из level_words по word_id/level, а не доверять полю correct_polish от клиента
- **Confidence:** 0.92
### 8. hint_limit_race_condition
- **Файл:** `routers/hints.py:38`
- **Snippet:** `MAX_HINTS = 3
if hints_already_used >= MAX_HINTS:
raise HTTPException(403, "Hint limit reached")`
- **Проблема:** при параллельных запросах лимит 3 подсказки обходится — ученик получает больше подсказок, чем разрешено
- **Как воспроизвести:** два одновременных GET /hints/first-letter/{id} при hints_used=2 → оба проходят проверку, hints_used становится 4
- **Что сделать:** делать атомарный UPDATE ... WHERE hints_used < 3 RETURNING hints_used, либо SELECT ... FOR UPDATE внутри транзакции
- **Confidence:** 0.78
### 9. complete_level_toctou_race
- **Файл:** `routers/game.py:268`
- **Snippet:** `existing_progress = await conn.fetchrow(
"SELECT score FROM user_progress WHERE user_id = $1 AND level_id = `
- **Проблема:** два параллельных POST /game/complete-level могут оба пройти проверку и попытаться вставить строку — второй INSERT упадёт с ошибкой БД (нет ON CONFLICT)
- **Как воспроизвести:** два одновременных запроса на один level_id → IntegrityError на втором INSERT
- **Что сделать:** добавить ON CONFLICT (user_id, level_id) DO NOTHING в INSERT, либо использовать SELECT ... FOR UPDATE
- **Confidence:** 0.72
### 10. typing_no_min_time_check
- **Файл:** `routers/typing.py:68`
- **Snippet:** `is_correct = correct_text == user_normalized`
- **Проблема:** нет проверки completion_time — ученик может отправить правильный ответ мгновенно (скопировав из подсказки), прогресс засчитывается
- **Как воспроизвести:** GET /typing/hint/{id} → сразу POST /typing/check с тем же текстом → correct:true
- **Что сделать:** добавить проверку completion_time (как в sentences.py) и/или не отдавать правильный ответ в /hint без списания лимита
- **Confidence:** 0.7
### 11. completion_time_client_controlled
- **Файл:** `routers/game.py:232`
- **Snippet:** `if completion_time is not None and completion_time < 5:
raise HTTPException(400, "Completion time too fast. Mini`
- **Проблема:** completion_time приходит от клиента — ученик просто отправляет 5 и получает достижение speed_level, античит бесполезен
- **Как воспроизвести:** POST /game/complete-level {level_id:1, completion_time:5} → speed_level выдан
- **Что сделать:** замерять время на сервере (сохранять started_at при выдаче уровня и считать разницу), либо не выдавать speed-достижения по клиентскому времени
- **Confidence:** 0.8
### 12. admin_update_feed_post_removed_images_not_transactional
- **Файл:** `routers/feed.py:470`
- **Snippet:** `removed_images = body.get("removed_images", [])
if removed_images and isinstance(removed_images, list):`
- **Проблема:** Если UPDATE feed_posts упадёт (например, невалидный expires_at), вложения уже удалены из БД, но файлы на диске остались — пост теряет картинки без отката.
- **Как воспроизвести:** PUT /admin/feed/post/{id} с removed_images=[...] и битым expires_at → 400, но feed_attachments уже пуст.
- **Что сделать:** Обернуть DELETE feed_attachments и UPDATE feed_posts в одну conn.transaction(); файлы удалять только после успешного commit.
- **Confidence:** 0.85
### 13. admin_upload_feed_image_mime_only
- **Файл:** `routers/feed.py:620`
- **Snippet:** `content_type = (file.content_type or "").lower()
if content_type not in FEED_ALLOWED_IMAGE_TYPES:`
- **Проблема:** Проверяется только клиентский Content-Type. Можно залить произвольный файл (HTML/SVG/скрипт) с подделанным MIME — он попадёт в /uploads/feed/ и будет отдаваться как есть.
- **Как воспроизвести:** curl -F 'file=@evil.html;type=image/png' /admin/feed/upload-image → файл сохранён как .png, но содержимое — HTML.
- **Что сделать:** Проверять magic bytes (Pillow Image.open + verify) или перекодировать через PIL в безопасный формат перед сохранением.
- **Confidence:** 0.82
### 14. initdata_in_query_param
- **Файл:** `auth.py:118`
- **Snippet:** `if not init_data:
init_data = request.query_params.get('initData', '')`
- **Проблема:** initData (подписанный токен Telegram) попадает в URL — утекает в access-логи nginx/Cloudflare, Referer, историю браузера, кэш CDN. Злоумышленник с логами может переиспользовать токен до истечения 4ч.
- **Как воспроизвести:** открыть DevTools → Network → любой запрос deleteFeedPost → initData виден в query string и в логах сервера
- **Что сделать:** Убрать fallback на query-параметр; передавать initData только через Authorization: tma <initData> или X-Telegram-InitData. Если нужен обход CF preflight — использовать POST с телом.
- **Confidence:** 0.88
### 15. cf_ip_check_behind_nginx
- **Файл:** `main.py:197`
- **Snippet:** `real_client_ip = request.client.host if request.client else "unknown"`
- **Проблема:** Если приложение стоит за nginx (reverse proxy), request.client.host = IP nginx (127.0.0.1), а не Cloudflare. _is_cloudflare_ip вернёт False, и client_ip станет 127.0.0.1 для ВСЕХ пользователей — единый rate-limit bucket, любой пользователь блокирует остальных.
- **Как воспроизвести:** запустить за nginx → сделать 60 запросов с одного клиента → все остальные получают 429
- **Что сделать:** Проверять X-Forwarded-For / X-Real-IP от доверенного прокси (nginx), либо явно указать список доверенных прокси и брать последний IP из XFF.
- **Confidence:** 0.78
## 🟡 Качество кода (10)
### 16. words_count_unused
- **Файл:** `routers/bubblewords.py:152`
- **Snippet:** `words_count = body.get("words_count", 3)`
- **Проблема:** поле words_count приходит от клиента, но нигде не используется — мёртвый код, вводит в заблуждение
- **Как воспроизвести:** grep words_count в bubblewords.py — только чтение из body
- **Что сделать:** удалить переменную или использовать её для валидации/расчёта очков
- **Confidence:** 0.9
### 17. init_sentences_no_error_handling
- **Файл:** `routers/sentences.py:78`
- **Snippet:** `sentences = load_sentences_from_csv(filename)`
- **Проблема:** если CSV-файл отсутствует или повреждён, init_sentences падает с FileNotFoundError и роняет старт приложения
- **Как воспроизвести:** удалить sentences_a1.csv → запуск приложения → FileNotFoundError
- **Что сделать:** обернуть в try/except, логировать и продолжать с остальными уровнями; либо проверять os.path.exists
- **Confidence:** 0.75
### 18. hint_docstring_mismatch
- **Файл:** `routers/hints.py:9`
- **Snippet:** `"""Подсказка: показывает первую букву случайного ненайденного слова"""`
- **Проблема:** докстринг обещает случайное ненайденное слово, а код возвращает первое слово с путём из word_paths — поведение не соответствует документации
- **Как воспроизвести:** GET /hints/first-letter/{id} всегда возвращает одно и то же слово (первое в word_paths)
- **Что сделать:** либо реализовать выбор случайного ненайденного слова (исключая уже найденные), либо поправить докстринг
- **Confidence:** 0.72
### 19. admin_content_get_word_levels_n_plus_1
- **Файл:** `routers/admin_content.py:220`
- **Snippet:** `count = await conn.fetchval(
"SELECT COUNT(*) FROM level_words WHERE level = $1 AND level_id IS NULL", c`
- **Проблема:** Дашборд контент-менеджера открывается медленнее: 6 уровней × 2 запроса = 12 round-trip вместо одного GROUP BY.
- **Как воспроизвести:** GET /admin/content/words/levels → в логах 12 последовательных SELECT по level_words.
- **Что сделать:** Заменить цикл на один запрос: SELECT level, COUNT(*), MAX(edited_at) FROM level_words WHERE level = ANY($1) AND level_id IS NULL GROUP BY level.
- **Confidence:** 0.95
### 20. update_lesson_n_plus_1
- **Файл:** `routers/admin_content.py:720`
- **Snippet:** `for q in questions:
# Проверяем, что вопрос принадлежит этому уроку
q_exists = await con`
- **Проблема:** Сохранение урока с 20 вопросами и 4 опциями = ~100 последовательных запросов внутри транзакции; долгая блокировка строк и таймауты на медленной сети.
- **Как воспроизвести:** PUT /admin/content/lessons/lesson/{id} с большим уроком → в логах десятки SELECT/UPDATE/INSERT подряд.
- **Что сделать:** Одним запросом проверить принадлежность всех question_id (SELECT question_id FROM learning_questions WHERE lesson_id=$1 AND question_id = ANY($2)), затем батчить UPDATE/INSERT через executemany.
- **Confidence:** 0.85
### 21. update_lesson_option_key_26_limit
- **Файл:** `routers/admin_content.py:690`
- **Snippet:** `option_key = chr(ord('A') + idx) # A, B, C, D...`
- **Проблема:** При >26 вариантах ответа генерируются символы '[' '\\' ']' и т.п. — фронт не сможет сопоставить correct_answer с вариантом.
- **Как воспроизвести:** Отправить вопрос с 27 опциями → option_key = '[' для 27-й.
- **Что сделать:** Ограничить число опций (например, 6) с явной ошибкой 400, либо использовать двухбуквенные ключи (AA, AB...).
- **Confidence:** 0.8
### 22. admin_upload_feed_image_sync_write
- **Файл:** `routers/feed.py:665`
- **Snippet:** `file_path_disk.write_bytes(content)`
- **Проблема:** Синхронная запись до 5 МБ блокирует event loop FastAPI — параллельные запросы других юзеров подвисают на время записи.
- **Как воспроизвести:** Загрузить 5 МБ картинку → на время write_bytes другие запросы к API задерживаются.
- **Что сделать:** Использовать aiofiles.open(...).write(content) или вынести запись в run_in_executor.
- **Confidence:** 0.8
### 23. redundant_indexes_levels_sentences
- **Файл:** `database.py:640`
- **Snippet:** `await conn.execute("CREATE INDEX IF NOT EXISTS idx_levels_number ON levels(level_number)")`
- **Проблема:** Дублирующие индексы: idx_levels_number покрыт idx_levels_level_number(level, level_number); idx_levels_level покрыт тем же; idx_sentences_number и idx_sentences_level покрыты idx_sentences_level_number. Лишний write-overhead и место на диске.
- **Как воспроизвести:** SELECT indexname FROM pg_indexes WHERE tablename='levels' — увидеть 3 индекса, из которых 2 избыточны
- **Что сделать:** Удалить idx_levels_number, idx_levels_level, idx_sentences_number, idx_sentences_level — составной (level, level_number) покрывает запросы по level и по level+number.
- **Confidence:** 0.9
### 24. rate_limiter_cleanup_hardcoded_window
- **Файл:** `main.py:96`
- **Snippet:** `self.requests[key] = [t for t in self.requests[key] if now - t < 60]`
- **Проблема:** Фоновый _cleanup использует жёстко зашитые 60с, а не window из self.limits. Если позже добавят лимит с window > 60с, записи будут удаляться раньше времени и лимит перестанет работать (тихая дыра в защите).
- **Как воспроизвести:** добавить в limits запись с window=300 → cleanup удалит её записи через 60с → лимит не срабатывает
- **Что сделать:** В _cleanup брать максимальный window из self.limits или хранить window рядом с timestamp.
- **Confidence:** 0.8
### 25. user_id_type_inconsistency
- **Файл:** `auth.py:82`
- **Snippet:** `user_id = user_data.get('id')`
- **Проблема:** Telegram может вернуть id как int или как строку (в зависимости от клиента). Дальше user_id уходит в SQL как BIGINT — asyncpg кинет ошибку типа, если пришла строка, и ученик получит 500 вместо входа.
- **Как воспроизвести:** передать initData с user.id в виде строки "123" → asyncpg.DataError при INSERT/UPDATE
- **Что сделать:** Явно приводить: user_id = int(user_data.get('id')) с обработкой ValueError → 401.
- **Confidence:** 0.72
---
**Итого:** всего находок=25, snippet не совпал=0, низкий confidence=0, прошло=25
_Этот 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 (Backend)
Дата: 2026-09-25 16:01 UTC
Модель:
deepseek-ai/DeepSeek-V4.1-FlashРепозиторий:
Drobysh/filwordspl-backend📊 По пакам
🔴 Влияет на ученика (6)
1. consolation_score_farmable
routers/wordquiz.py:200if mistakes >= 3: await conn.execute(""" INSERT INTO word_quiz_progress (user_id, wo2. streak_increments_on_repeat_word
routers/game.py:168for word in word_paths.keys(): if word.lower() == selected_word: found_word = word3. get_feed_post_no_expires_check
routers/feed.py:175row = await conn.fetchrow(""" SELECT * FROM feed_posts WHERE id = $1 AND is_published = TRUE """, po4. admin_update_feed_post_title_null
routers/feed.py:500title = body.get("title", existing.get(f"title_{source_language}") or "")body.get("title") or existing.get(...) or ""— пустое/None значение не должно перезаписывать существующее.5. rate_limit_on_static_uploads
main.py:189if path in ["/", "/health"]: return await call_next(request)6. rate_limit_per_ip_not_per_user
main.py:207rate_key = f"{client_ip}:{path}"🟠 Риск для данных (9)
7. client_controlled_correct_answer
routers/wordquiz.py:118correct_polish = body.get("correct_polish", "") user_answer = body.get("answer", "")8. hint_limit_race_condition
routers/hints.py:38MAX_HINTS = 3 if hints_already_used >= MAX_HINTS: raise HTTPException(403, "Hint limit reached")9. complete_level_toctou_race
routers/game.py:268existing_progress = await conn.fetchrow( "SELECT score FROM user_progress WHERE user_id = $1 AND level_id =10. typing_no_min_time_check
routers/typing.py:68is_correct = correct_text == user_normalized11. completion_time_client_controlled
routers/game.py:232if completion_time is not None and completion_time < 5: raise HTTPException(400, "Completion time too fast. Mini12. admin_update_feed_post_removed_images_not_transactional
routers/feed.py:470removed_images = body.get("removed_images", []) if removed_images and isinstance(removed_images, list):13. admin_upload_feed_image_mime_only
routers/feed.py:620content_type = (file.content_type or "").lower() if content_type not in FEED_ALLOWED_IMAGE_TYPES:14. initdata_in_query_param
auth.py:118if not init_data: init_data = request.query_params.get('initData', '')15. cf_ip_check_behind_nginx
main.py:197real_client_ip = request.client.host if request.client else "unknown"🟡 Качество кода (10)
16. words_count_unused
routers/bubblewords.py:152words_count = body.get("words_count", 3)17. init_sentences_no_error_handling
routers/sentences.py:78sentences = load_sentences_from_csv(filename)18. hint_docstring_mismatch
routers/hints.py:9"""Подсказка: показывает первую букву случайного ненайденного слова"""19. admin_content_get_word_levels_n_plus_1
routers/admin_content.py:220count = await conn.fetchval( "SELECT COUNT(*) FROM level_words WHERE level = $1 AND level_id IS NULL", c20. update_lesson_n_plus_1
routers/admin_content.py:720for q in questions: # Проверяем, что вопрос принадлежит этому уроку q_exists = await con21. update_lesson_option_key_26_limit
routers/admin_content.py:690option_key = chr(ord('A') + idx) # A, B, C, D...22. admin_upload_feed_image_sync_write
routers/feed.py:665file_path_disk.write_bytes(content)23. redundant_indexes_levels_sentences
database.py:640await conn.execute("CREATE INDEX IF NOT EXISTS idx_levels_number ON levels(level_number)")24. rate_limiter_cleanup_hardcoded_window
main.py:96self.requests[key] = [t for t in self.requests[key] if now - t < 60]25. user_id_type_inconsistency
auth.py:82user_id = user_data.get('id')Итого: всего находок=25, snippet не совпал=0, низкий confidence=0, прошло=25
Этот Issue создан автоматически. Исправления делаются вручную.