🤖 AI Review (backend): 25 задач (2026-09-25 16:01 UTC) #13

Open
opened 2026-09-25 16:01:56 +00:00 by Drobysh · 0 comments
Owner

🤖 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 или 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 создан автоматически. Исправления делаются вручную.

# 🤖 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 создан автоматически. Исправления делаются вручную._
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#13