Дата: 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 — клиентские, легко подделать
Проблема: клиент присылает perfect_streak, completion_time, hints_used — всё это можно подделать в DevTools. Достижения и очки выдаются по клиентским данным.
Что сделать: хранить started_at сессии на сервере (в user_progress или отдельной таблице), считать completion_time на бэке. hints_used — только из БД.
Критерий: подделка completion_time=5 в DevTools не даёт достижение «за 30 секунд».
Проблема: двойной вызов 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.
Проблема: мёртвый код. Логика генерации сетки дублируется в 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 создан автоматически. Исправления делаются вручную._
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-20 17:36 UTC
Модель:
deepseek-ai/DeepSeek-V4.1-FlashРепозиторий:
Drobysh/filwordspl-backend🔴 Критично
1. Timing attack при сравнении HMAC
auth.py:60if calculated_hash != received_hash:— обычное сравнение строк уязвимо к timing-атаке. Атакующий может побайтово подобрать hash.hmac.compare_digest(calculated_hash, received_hash).!= received_hashне находит совпадений; используетсяcompare_digest.2. Rate limiter не работает за прокси
main.py:96-99client_ip = request.client.host— за Cloudflare/nginx это IP прокси. Все пользователи получают один bucket → либо все блокируются, либо никто.X-Forwarded-For(первый адрес) с fallback наrequest.client.host. Убедиться, что nginx/Cloudflare передаёт заголовок.3. Достижение
speed_levelвыдаётся неверноrouters/game.py:243-245completion_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; передача реального времени решит проблему).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 не изолирован.user_level_progress(user_id, level, last_completed)), либо считатьlast_completedчерезMAX(level_number)изuser_progress WHERE level = current_level.5. Подсказки не расходуются
routers/hints.py:20-60hints_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.6. Хардкод Telegram ID в скриптах сброса
full_reset.py:11,reset_my_progress.py:12USER_ID = 6694989403— если скрипт случайно запустят на проде, снесут прогресс конкретного юзера. Нет подтверждения.sys.argv[1], добавитьinput("Type YES to confirm: ")перед удалением.7.
init_db()пересоздаёт materialized view на каждом стартеmain.py:180-200DROP MATERIALIZED VIEW IF EXISTS leaderboard_cache+CREATEна каждом запуске. При активных запросах к view — блокировки, ошибки. ПлюсCREATE MATERIALIZED VIEW IF NOT EXISTSпослеDROP— бессмысленно.CREATE ... IF NOT EXISTSбезDROP.8.
MAX_INITDATA_AGE = 24 часа— слишком долгоconfig.py:2460 * 60(1 час) или15 * 60.9.
perfect_countиcompletion_time— клиентские, легко подделатьrouters/game.py:110,routers/game.py:180,routers/sentences.py:190perfect_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[,\,]и т.д. — невалидные ключи.len(options_raw) <= 26с явной ошибкой 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-310check_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 bytesrouters/feed.py:520-560content_type(клиентский). Можно загрузить.php/.htmlсContent-Type: image/png— файл сохранится и будет доступен по/uploads/feed/....imghdr/Pillow) после чтения. Отдавать статику сContent-Disposition: attachmentилиX-Content-Type-Options: nosniff..htmlс фейковым MIME возвращает 400.15.
except:без типа вarchive_old_data.pyarchive_old_data.py:95,archive_old_data.py:180except:ловитKeyboardInterruptиSystemExit. При повреждённом JSON молча теряются данные.except (json.JSONDecodeError, OSError) as e: logger.warning(...).16.
services/grid_generator.pyиservices/word_bank.py— пустыеservices/grid_generator.py,services/word_bank.pyadd_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.pyopen(...).read()→replace()→write()исходников. Опасны при повторном запуске (могут затереть ручные правки), засоряют репо.18.
check_wordне проверяет доступ к уровнюrouters/game.py:100-140level_idлюбого уровня и получитьfound: true. Нет проверки, что уровень принадлежитcurrent_levelпользователя.level["level"] == user["current_level"](как вcomplete_level).19.
admin_statsв leaderboard — 6 запросов в циклеrouters/leaderboard.py:230-235for 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-130DELETE ... 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).🟢 Желательно
21.
@app.on_event("startup")устарелmain.py:170lifespancontext manager.22.
require_auth— мёртвый блокauth.py:95-99if not init_data: # Try from body... pass— ничего не делает, вводит в заблуждение.pass-заглушек вrequire_auth.23. Дублирование логики «фразы дня»
generate_daily_phrase.pyиrouters/teacher.py:320-420services/daily_phrase.py, использовать в обоих.24.
bubblewords.split_word_into_parts— fallback с суффиксомrouters/bubblewords.py:80-85"a.abc1.0"— пользователь видит мусор в пузырях.25.
admin_delete_feed_post— удаление файлов вне транзакцииrouters/feed.py:490-520orphan_filesдля последующей очистки cron'ом.Этот Issue создан автоматически. Исправления делаются вручную.