🤖 AI Review: список задач (2026-09-20 17:36 UTC) #1

Open
opened 2026-09-20 17:36:54 +00:00 by Drobysh · 0 comments
Owner

🤖 AI Code Review

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


🔴 Критично

1. Timing attack при сравнении HMAC

  • Файл: auth.py:60
  • Проблема: if calculated_hash != received_hash: — обычное сравнение строк уязвимо к timing-атаке. Атакующий может побайтово подобрать hash.
  • Что сделать: заменить на hmac.compare_digest(calculated_hash, received_hash).
  • Критерий: grep по != received_hash не находит совпадений; используется compare_digest.

2. Rate limiter не работает за прокси

  • Файл: main.py:96-99
  • Проблема: client_ip = request.client.host — за Cloudflare/nginx это IP прокси. Все пользователи получают один bucket → либо все блокируются, либо никто.
  • Что сделать: брать IP из X-Forwarded-For (первый адрес) с fallback на request.client.host. Убедиться, что nginx/Cloudflare передаёт заголовок.
  • Критерий: два разных пользователя за прокси имеют разные rate-limit bucket'ы.

3. Достижение speed_level выдаётся неверно

  • Файл: routers/game.py:243-245
  • Проблема: при completion_time <= 60 всегда передаётся value=60. Значит достижение «за 30 секунд» (ws_speed_30) выдаётся даже за 45 секунд.
  • Что сделать: передавать фактическое int(completion_time), а не константу 60. Проверить логику check_and_award_achievements для speed_level (там requirement_value <= $2 — для 30-секундного достижения value=30, для 60-секундного value=60; передача реального времени решит проблему).
  • Критерий: за 45 секунд выдаётся только speed_60, за 25 — оба.

4. last_completed_level — глобальный, не по уровням

  • Файл: routers/game.py:70-71, database.py (users)
  • Проблема: last_completed_level — одно число на пользователя. Пройдя A1 до 50-го уровня, юзер получает доступ к A2 уровням 1–51 (проверка level_number > last_completed + 1). Прогресс по A2 не изолирован.
  • Что сделать: хранить прогресс per-level (например, user_level_progress(user_id, level, last_completed)), либо считать last_completed через MAX(level_number) из user_progress WHERE level = current_level.
  • Критерий: переход на A2 начинается с уровня 1, а не с 51.

5. Подсказки не расходуются

  • Файл: routers/hints.py:20-60
  • Проблема: hints_used читается, но нигде не инкрементируется. Пользователь может запрашивать подсказки бесконечно, а complete_level посчитает hints_used=0 и выдаст 100 очков.
  • Что сделать: при выдаче подсказки делать INSERT ... ON CONFLICT DO UPDATE SET hints_used = hints_used + 1 в user_progress (создавая запись с completed_at = NULL), либо отдельная таблица user_hints.
  • Критерий: после 3 подсказок 4-я возвращает 403/лимит.

6. Хардкод Telegram ID в скриптах сброса

  • Файл: full_reset.py:11, reset_my_progress.py:12
  • Проблема: USER_ID = 6694989403 — если скрипт случайно запустят на проде, снесут прогресс конкретного юзера. Нет подтверждения.
  • Что сделать: брать ID из sys.argv[1], добавить input("Type YES to confirm: ") перед удалением.
  • Критерий: запуск без аргумента падает с ошибкой; без подтверждения ничего не удаляется.

7. init_db() пересоздаёт materialized view на каждом старте

  • Файл: main.py:180-200
  • Проблема: DROP MATERIALIZED VIEW IF EXISTS leaderboard_cache + CREATE на каждом запуске. При активных запросах к view — блокировки, ошибки. Плюс CREATE MATERIALIZED VIEW IF NOT EXISTS после DROP — бессмысленно.
  • Что сделать: вынести создание view в отдельную миграцию/скрипт. На старте делать только CREATE ... IF NOT EXISTS без DROP.
  • Критерий: рестарт API не роняет активные запросы к leaderboard.

8. MAX_INITDATA_AGE = 24 часа — слишком долго

  • Файл: config.py:24
  • Проблема: Telegram рекомендует 1 час. За 24 часа украденный initData можно использовать для доступа к чужому аккаунту.
  • Что сделать: уменьшить до 60 * 60 (1 час) или 15 * 60.
  • Критерий: initData старше 1 часа отклоняется.

9. perfect_count и completion_time — клиентские, легко подделать

  • Файл: routers/game.py:110, routers/game.py:180, routers/sentences.py:190
  • Проблема: клиент присылает perfect_streak, completion_time, hints_used — всё это можно подделать в DevTools. Достижения и очки выдаются по клиентским данным.
  • Что сделать: хранить started_at сессии на сервере (в user_progress или отдельной таблице), считать completion_time на бэке. hints_used — только из БД.
  • Критерий: подделка completion_time=5 в DevTools не даёт достижение «за 30 секунд».

10. option_key = chr(ord('A') + idx) — ломается на 27+ опциях

  • Файл: routers/admin_content.py:640
  • Проблема: при 27 опциях получится [, \, ] и т.д. — невалидные ключи.
  • Что сделать: ограничить len(options_raw) <= 26 с явной ошибкой 400.
  • Критерий: POST с 27 опциями возвращает 400.

🟡 Важно

11. teacher_start/teacher_resume хардкодят level_code="A1"

  • Файл: routers/teacher.py:520, routers/teacher.py:640
  • Проблема: при создании сессии всегда пишется "A1", игнорируя current_level пользователя. Аналитика по уровням будет врать.
  • Что сделать: брать current_level из users и передавать в start_learning_session.
  • Критерий: сессия для юзера с current_level='B1' пишет level_code='B1'.

12. get_wrong_answer_ai_explanation — запутанная логика

  • Файл: routers/teacher.py:290-310
  • Проблема: двойной вызов check_ai_limit, вспомогательная _check_ai_limit_for_fallback только для одного места, ветка else возвращает пустую строку или сообщение о лимите — неочевидно.
  • Что сделать: переписать: один раз проверить лимит, при исчерпании вернуть get_ai_limit_message(lang), иначе вызвать AI и инкрементировать.
  • Критерий: функция читается с одного прохода, _check_ai_limit_for_fallback удалена.

13. API_PUBLIC_URL и CACHE_DIR захардкожены

  • Файл: routers/feed.py:44, routers/tts.py:17
  • Проблема: "https://api.filwordspl.com" и "/root/filwordspl/backend/tts_cache" — не конфигурируемы, ломаются при смене домена/пути.
  • Что сделать: вынести в config.py как API_PUBLIC_URL и TTS_CACHE_DIR (env-переменные с дефолтами).
  • Критерий: смена домена через .env не требует правки кода.

14. admin_upload_feed_image — нет проверки magic bytes

  • Файл: routers/feed.py:520-560
  • Проблема: проверяется только content_type (клиентский). Можно загрузить .php/.html с Content-Type: image/png — файл сохранится и будет доступен по /uploads/feed/....
  • Что сделать: проверять magic bytes (imghdr/Pillow) после чтения. Отдавать статику с Content-Disposition: attachment или X-Content-Type-Options: nosniff.
  • Критерий: загрузка .html с фейковым MIME возвращает 400.

15. except: без типа в archive_old_data.py

  • Файл: archive_old_data.py:95, archive_old_data.py:180
  • Проблема: except: ловит KeyboardInterrupt и SystemExit. При повреждённом JSON молча теряются данные.
  • Что сделать: except (json.JSONDecodeError, OSError) as e: logger.warning(...).
  • Критерий: Ctrl+C во время архивации не глотается.

16. services/grid_generator.py и services/word_bank.py — пустые

  • Файл: services/grid_generator.py, services/word_bank.py
  • Проблема: мёртвый код. Логика генерации сетки дублируется в add_levels.py и generate_levels_v2.py.
  • Что сделать: либо удалить пустые файлы, либо перенести туда общую логику try_place_word/fill_empty_cells/generate_grid и использовать в обоих скриптах.
  • Критерий: нет пустых модулей; генерация сетки в одном месте.

17. fix_learning.py и fix_review.py — одноразовые патчи в репо

  • Файл: fix_learning.py, fix_review.py
  • Проблема: скрипты, которые open(...).read() → replace() → write() исходников. Опасны при повторном запуске (могут затереть ручные правки), засоряют репо.
  • Что сделать: удалить после применения. Правки внести в исходники напрямую.
  • Критерий: файлов нет в репозитории.

18. check_word не проверяет доступ к уровню

  • Файл: routers/game.py:100-140
  • Проблема: любой авторизованный юзер может отправить level_id любого уровня и получить found: true. Нет проверки, что уровень принадлежит current_level пользователя.
  • Что сделать: добавить проверку level["level"] == user["current_level"] (как в complete_level).
  • Критерий: запрос к чужому уровню возвращает 403.

19. admin_stats в leaderboard — 6 запросов в цикле

  • Файл: routers/leaderboard.py:230-235
  • Проблема: for lvl in LEVELS: SELECT COUNT(*) ... — 6 round-trip'ов. Аналогично в admin.py:60-65.
  • Что сделать: один запрос SELECT current_level, COUNT(*) FROM users GROUP BY current_level и собрать dict в Python.
  • Критерий: один запрос вместо шести.

20. save_message в assistant — NOT IN с подзапросом

  • Файл: routers/assistant.py:120-130
  • Проблема: DELETE ... WHERE id NOT IN (SELECT id ... ORDER BY id DESC LIMIT 10) — на больших историях медленно, и NOT IN с NULL-ами опасен.
  • Что сделать: DELETE FROM chat_history WHERE user_id = $1 AND id < (SELECT id FROM chat_history WHERE user_id = $1 ORDER BY id DESC OFFSET 9 LIMIT 1).
  • Критерий: EXPLAIN показывает Index Scan, а не Seq Scan.

🟢 Желательно

21. @app.on_event("startup") устарел

  • Файл: main.py:170
  • Проблема: в FastAPI 0.109+ deprecated, будет удалён.
  • Что сделать: перейти на lifespan context manager.
  • Критерий: нет warning'ов при старте.

22. require_auth — мёртвый блок

  • Файл: auth.py:95-99
  • Проблема: if not init_data: # Try from body... pass — ничего не делает, вводит в заблуждение.
  • Что сделать: удалить блок или реализовать чтение из тела.
  • Критерий: нет pass-заглушек в require_auth.

23. Дублирование логики «фразы дня»

  • Файл: generate_daily_phrase.py и routers/teacher.py:320-420
  • Проблема: одна и та же логика генерации/парсинга фразы в двух местах. При правке промпта легко забыть второе.
  • Что сделать: вынести в services/daily_phrase.py, использовать в обоих.
  • Критерий: промпт и парсер в одном файле.

24. bubblewords.split_word_into_parts — fallback с суффиксом

  • Файл: routers/bubblewords.py:80-85
  • Проблема: при конфликте возвращает части вида "a.abc1.0" — пользователь видит мусор в пузырях.
  • Что сделать: при неудаче за 50 попыток — исключать слово из уровня (выбирать другое), а не портить UI.
  • Критерий: в пузырях нет частей с точками и хешами.

25. admin_delete_feed_post — удаление файлов вне транзакции

  • Файл: routers/feed.py:490-520
  • Проблема: если процесс упадёт между DELETE из БД и удалением файлов — останутся orphan-файлы. Обратная ситуация (файл удалён, БД не обновлена) тоже возможна.
  • Что сделать: логировать orphan-файлы в отдельную таблицу orphan_files для последующей очистки cron'ом.
  • Критерий: есть механизм очистки orphan-файлов.

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

# 🤖 AI Code Review **Дата:** 2026-09-20 17:36 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-backend` --- ## 🔴 Критично ### 1. Timing attack при сравнении HMAC - **Файл:** `auth.py:60` - **Проблема:** `if calculated_hash != received_hash:` — обычное сравнение строк уязвимо к timing-атаке. Атакующий может побайтово подобрать hash. - **Что сделать:** заменить на `hmac.compare_digest(calculated_hash, received_hash)`. - **Критерий:** grep по `!= received_hash` не находит совпадений; используется `compare_digest`. ### 2. Rate limiter не работает за прокси - **Файл:** `main.py:96-99` - **Проблема:** `client_ip = request.client.host` — за Cloudflare/nginx это IP прокси. Все пользователи получают один bucket → либо все блокируются, либо никто. - **Что сделать:** брать IP из `X-Forwarded-For` (первый адрес) с fallback на `request.client.host`. Убедиться, что nginx/Cloudflare передаёт заголовок. - **Критерий:** два разных пользователя за прокси имеют разные rate-limit bucket'ы. ### 3. Достижение `speed_level` выдаётся неверно - **Файл:** `routers/game.py:243-245` - **Проблема:** при `completion_time <= 60` всегда передаётся `value=60`. Значит достижение «за 30 секунд» (`ws_speed_30`) выдаётся даже за 45 секунд. - **Что сделать:** передавать фактическое `int(completion_time)`, а не константу 60. Проверить логику `check_and_award_achievements` для `speed_level` (там `requirement_value <= $2` — для 30-секундного достижения value=30, для 60-секундного value=60; передача реального времени решит проблему). - **Критерий:** за 45 секунд выдаётся только `speed_60`, за 25 — оба. ### 4. `last_completed_level` — глобальный, не по уровням - **Файл:** `routers/game.py:70-71`, `database.py` (users) - **Проблема:** `last_completed_level` — одно число на пользователя. Пройдя A1 до 50-го уровня, юзер получает доступ к A2 уровням 1–51 (проверка `level_number > last_completed + 1`). Прогресс по A2 не изолирован. - **Что сделать:** хранить прогресс per-level (например, `user_level_progress(user_id, level, last_completed)`), либо считать `last_completed` через `MAX(level_number)` из `user_progress WHERE level = current_level`. - **Критерий:** переход на A2 начинается с уровня 1, а не с 51. ### 5. Подсказки не расходуются - **Файл:** `routers/hints.py:20-60` - **Проблема:** `hints_used` читается, но нигде не инкрементируется. Пользователь может запрашивать подсказки бесконечно, а `complete_level` посчитает `hints_used=0` и выдаст 100 очков. - **Что сделать:** при выдаче подсказки делать `INSERT ... ON CONFLICT DO UPDATE SET hints_used = hints_used + 1` в `user_progress` (создавая запись с `completed_at = NULL`), либо отдельная таблица `user_hints`. - **Критерий:** после 3 подсказок 4-я возвращает 403/лимит. ### 6. Хардкод Telegram ID в скриптах сброса - **Файл:** `full_reset.py:11`, `reset_my_progress.py:12` - **Проблема:** `USER_ID = 6694989403` — если скрипт случайно запустят на проде, снесут прогресс конкретного юзера. Нет подтверждения. - **Что сделать:** брать ID из `sys.argv[1]`, добавить `input("Type YES to confirm: ")` перед удалением. - **Критерий:** запуск без аргумента падает с ошибкой; без подтверждения ничего не удаляется. ### 7. `init_db()` пересоздаёт materialized view на каждом старте - **Файл:** `main.py:180-200` - **Проблема:** `DROP MATERIALIZED VIEW IF EXISTS leaderboard_cache` + `CREATE` на каждом запуске. При активных запросах к view — блокировки, ошибки. Плюс `CREATE MATERIALIZED VIEW IF NOT EXISTS` после `DROP` — бессмысленно. - **Что сделать:** вынести создание view в отдельную миграцию/скрипт. На старте делать только `CREATE ... IF NOT EXISTS` без `DROP`. - **Критерий:** рестарт API не роняет активные запросы к leaderboard. ### 8. `MAX_INITDATA_AGE = 24 часа` — слишком долго - **Файл:** `config.py:24` - **Проблема:** Telegram рекомендует 1 час. За 24 часа украденный initData можно использовать для доступа к чужому аккаунту. - **Что сделать:** уменьшить до `60 * 60` (1 час) или `15 * 60`. - **Критерий:** initData старше 1 часа отклоняется. ### 9. `perfect_count` и `completion_time` — клиентские, легко подделать - **Файл:** `routers/game.py:110`, `routers/game.py:180`, `routers/sentences.py:190` - **Проблема:** клиент присылает `perfect_streak`, `completion_time`, `hints_used` — всё это можно подделать в DevTools. Достижения и очки выдаются по клиентским данным. - **Что сделать:** хранить `started_at` сессии на сервере (в `user_progress` или отдельной таблице), считать `completion_time` на бэке. `hints_used` — только из БД. - **Критерий:** подделка `completion_time=5` в DevTools не даёт достижение «за 30 секунд». ### 10. `option_key = chr(ord('A') + idx)` — ломается на 27+ опциях - **Файл:** `routers/admin_content.py:640` - **Проблема:** при 27 опциях получится `[`, `\`, `]` и т.д. — невалидные ключи. - **Что сделать:** ограничить `len(options_raw) <= 26` с явной ошибкой 400. - **Критерий:** POST с 27 опциями возвращает 400. ## 🟡 Важно ### 11. `teacher_start`/`teacher_resume` хардкодят `level_code="A1"` - **Файл:** `routers/teacher.py:520`, `routers/teacher.py:640` - **Проблема:** при создании сессии всегда пишется `"A1"`, игнорируя `current_level` пользователя. Аналитика по уровням будет врать. - **Что сделать:** брать `current_level` из `users` и передавать в `start_learning_session`. - **Критерий:** сессия для юзера с `current_level='B1'` пишет `level_code='B1'`. ### 12. `get_wrong_answer_ai_explanation` — запутанная логика - **Файл:** `routers/teacher.py:290-310` - **Проблема:** двойной вызов `check_ai_limit`, вспомогательная `_check_ai_limit_for_fallback` только для одного места, ветка `else` возвращает пустую строку или сообщение о лимите — неочевидно. - **Что сделать:** переписать: один раз проверить лимит, при исчерпании вернуть `get_ai_limit_message(lang)`, иначе вызвать AI и инкрементировать. - **Критерий:** функция читается с одного прохода, `_check_ai_limit_for_fallback` удалена. ### 13. `API_PUBLIC_URL` и `CACHE_DIR` захардкожены - **Файл:** `routers/feed.py:44`, `routers/tts.py:17` - **Проблема:** `"https://api.filwordspl.com"` и `"/root/filwordspl/backend/tts_cache"` — не конфигурируемы, ломаются при смене домена/пути. - **Что сделать:** вынести в `config.py` как `API_PUBLIC_URL` и `TTS_CACHE_DIR` (env-переменные с дефолтами). - **Критерий:** смена домена через `.env` не требует правки кода. ### 14. `admin_upload_feed_image` — нет проверки magic bytes - **Файл:** `routers/feed.py:520-560` - **Проблема:** проверяется только `content_type` (клиентский). Можно загрузить `.php`/`.html` с `Content-Type: image/png` — файл сохранится и будет доступен по `/uploads/feed/...`. - **Что сделать:** проверять magic bytes (`imghdr`/`Pillow`) после чтения. Отдавать статику с `Content-Disposition: attachment` или `X-Content-Type-Options: nosniff`. - **Критерий:** загрузка `.html` с фейковым MIME возвращает 400. ### 15. `except:` без типа в `archive_old_data.py` - **Файл:** `archive_old_data.py:95`, `archive_old_data.py:180` - **Проблема:** `except:` ловит `KeyboardInterrupt` и `SystemExit`. При повреждённом JSON молча теряются данные. - **Что сделать:** `except (json.JSONDecodeError, OSError) as e: logger.warning(...)`. - **Критерий:** Ctrl+C во время архивации не глотается. ### 16. `services/grid_generator.py` и `services/word_bank.py` — пустые - **Файл:** `services/grid_generator.py`, `services/word_bank.py` - **Проблема:** мёртвый код. Логика генерации сетки дублируется в `add_levels.py` и `generate_levels_v2.py`. - **Что сделать:** либо удалить пустые файлы, либо перенести туда общую логику `try_place_word`/`fill_empty_cells`/`generate_grid` и использовать в обоих скриптах. - **Критерий:** нет пустых модулей; генерация сетки в одном месте. ### 17. `fix_learning.py` и `fix_review.py` — одноразовые патчи в репо - **Файл:** `fix_learning.py`, `fix_review.py` - **Проблема:** скрипты, которые `open(...).read()` → `replace()` → `write()` исходников. Опасны при повторном запуске (могут затереть ручные правки), засоряют репо. - **Что сделать:** удалить после применения. Правки внести в исходники напрямую. - **Критерий:** файлов нет в репозитории. ### 18. `check_word` не проверяет доступ к уровню - **Файл:** `routers/game.py:100-140` - **Проблема:** любой авторизованный юзер может отправить `level_id` любого уровня и получить `found: true`. Нет проверки, что уровень принадлежит `current_level` пользователя. - **Что сделать:** добавить проверку `level["level"] == user["current_level"]` (как в `complete_level`). - **Критерий:** запрос к чужому уровню возвращает 403. ### 19. `admin_stats` в leaderboard — 6 запросов в цикле - **Файл:** `routers/leaderboard.py:230-235` - **Проблема:** `for lvl in LEVELS: SELECT COUNT(*) ...` — 6 round-trip'ов. Аналогично в `admin.py:60-65`. - **Что сделать:** один запрос `SELECT current_level, COUNT(*) FROM users GROUP BY current_level` и собрать dict в Python. - **Критерий:** один запрос вместо шести. ### 20. `save_message` в assistant — `NOT IN` с подзапросом - **Файл:** `routers/assistant.py:120-130` - **Проблема:** `DELETE ... WHERE id NOT IN (SELECT id ... ORDER BY id DESC LIMIT 10)` — на больших историях медленно, и `NOT IN` с NULL-ами опасен. - **Что сделать:** `DELETE FROM chat_history WHERE user_id = $1 AND id < (SELECT id FROM chat_history WHERE user_id = $1 ORDER BY id DESC OFFSET 9 LIMIT 1)`. - **Критерий:** EXPLAIN показывает Index Scan, а не Seq Scan. ## 🟢 Желательно ### 21. `@app.on_event("startup")` устарел - **Файл:** `main.py:170` - **Проблема:** в FastAPI 0.109+ deprecated, будет удалён. - **Что сделать:** перейти на `lifespan` context manager. - **Критерий:** нет warning'ов при старте. ### 22. `require_auth` — мёртвый блок - **Файл:** `auth.py:95-99` - **Проблема:** `if not init_data: # Try from body... pass` — ничего не делает, вводит в заблуждение. - **Что сделать:** удалить блок или реализовать чтение из тела. - **Критерий:** нет `pass`-заглушек в `require_auth`. ### 23. Дублирование логики «фразы дня» - **Файл:** `generate_daily_phrase.py` и `routers/teacher.py:320-420` - **Проблема:** одна и та же логика генерации/парсинга фразы в двух местах. При правке промпта легко забыть второе. - **Что сделать:** вынести в `services/daily_phrase.py`, использовать в обоих. - **Критерий:** промпт и парсер в одном файле. ### 24. `bubblewords.split_word_into_parts` — fallback с суффиксом - **Файл:** `routers/bubblewords.py:80-85` - **Проблема:** при конфликте возвращает части вида `"a.abc1.0"` — пользователь видит мусор в пузырях. - **Что сделать:** при неудаче за 50 попыток — исключать слово из уровня (выбирать другое), а не портить UI. - **Критерий:** в пузырях нет частей с точками и хешами. ### 25. `admin_delete_feed_post` — удаление файлов вне транзакции - **Файл:** `routers/feed.py:490-520` - **Проблема:** если процесс упадёт между DELETE из БД и удалением файлов — останутся orphan-файлы. Обратная ситуация (файл удалён, БД не обновлена) тоже возможна. - **Что сделать:** логировать orphan-файлы в отдельную таблицу `orphan_files` для последующей очистки cron'ом. - **Критерий:** есть механизм очистки orphan-файлов. --- _Этот 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#1