Что сделать: При пустом ответе AI возвращать нейтральный fallback-текст, а не пустую строку.
Confidence: 0.82
🟠 Риск для данных (3)
5. initdata_in_query_param
Файл:auth.py:96
Snippet:if not init_data: init_data = request.query_params.get('initData', '')
Проблема: initData (подписанный токен Telegram) попадает в URL, а значит в access-логи nginx/uvicorn, логи Cloudflare, историю браузера, Referer-заголовки и кэши прокси — токен можно перехватить и переиспользовать до истечения MAX_INITDATA_AGE (4 часа).
Как воспроизвести: Открыть DevTools → Network → любой запрос deleteFeedPost → initData виден в query string; проверить access.log сервера — там полный initData.
Что сделать: Убрать fallback на query-параметр; для deleteFeedPost использовать POST с телом или заголовком Authorization: tma . Если fallback обязателен — ограничить его только одним эндпоинтом и логировать предупреждение.
Confidence: 0.88
6. duplicate_delete_keeps_wrong_row
Файл:database.py:152
Snippet:DELETE FROM user_progress a USING user_progress b WHERE a.ctid < b.ctid
Проблема: При миграции user_id INTEGER→BIGINT удаляются дубли, но остаётся строка с максимальным ctid (физическое расположение), а не с максимальным completed_at/score, как обещает комментарий. У части учеников может пропасть лучший результат по уровню.
Как воспроизвести: Создать две строки user_progress с одинаковыми (user_id, level_id), но разными score/completed_at → запустить init_db → проверить, какая строка осталась.
Что сделать: Заменить условие на сохранение строки с максимальным completed_at (или score): DELETE ... WHERE a.ctid <> (SELECT ctid FROM user_progress c WHERE c.user_id=a.user_id AND c.level_id=a.level_id ORDER BY c.completed_at DESC NULLS LAST, c.score DESC LIMIT 1).
Проблема: В продакшене открыты /docs, /redoc и /openapi.json — любой может увидеть полную схему API, включая админские эндпоинты, и использовать её для атак.
Как воспроизвести: Открыть https:///docs и https:///openapi.json — возвращается полная спецификация.
Что сделать: FastAPI(..., docs_url=None, redoc_url=None, openapi_url=None) в проде, либо закрыть эти пути basic-auth/allowlist по IP.
Confidence: 0.72
🟡 Качество кода (10)
8. admin_content_lesson_levels_n_plus_1
Файл:routers/admin_content.py:600
Snippet: `for lvl in level_rows:
code = lvl["code"]
Что сделать: Один запрос WHERE question_id = ANY($1) + группировка в Python.
Confidence: 0.88
13. orchestrator_n_plus_1_options
Файл:routers/orchestrator.py:100
Snippet:questions_data = [] for q in questions: options = await conn.fetch(""" SELECT * FROM question_op
Проблема: get_lesson_by_id / get_lesson_questions / get_test_questions делают N+1 по options — тормозит чат-учителя.
Как воспроизвести: POST /teacher/start → get_lesson_by_id
Что сделать: Один запрос WHERE question_id = ANY($1) + группировка в Python.
Confidence: 0.88
14. cf_ip_check_per_request
Файл:main.py:138
Snippet:for cidr in CF_IPS: try: if ip in ipaddress.ip_network(cidr, strict=False):
Проблема: На каждый HTTP-запрос парсится 22 CIDR-сети Cloudflare — лишняя нагрузка на CPU в middleware, который выполняется для всех запросов.
Как воспроизвести: Профилировать rate_limit_middleware под нагрузкой — видно постоянные вызовы ipaddress.ip_network.
Что сделать: Один раз на старте скомпилировать CF_IPS в список ipaddress.IPv4Network/IPv6Network и хранить в модуле; в _is_cloudflare_ip использовать готовые объекты.
Confidence: 0.8
15. init_db_slow_startup
Файл:database.py:22
Snippet:async def init_db(): pool = await get_pool() async with pool.acquire() as conn:
Проблема: На каждом рестарте выполняется ~40 запросов к information_schema + десятки CREATE/ALTER внутри одной транзакции — старт приложения затягивается, а долгая транзакция держит блокировки на таблицах.
Как воспроизвести: Замерить время init_db() на пустой и на большой БД — секунды на каждом рестарте.
Что сделать: Вынести авто-миграции в отдельный скрипт/миграционный фреймворк (alembic), а init_db оставить только для CREATE TABLE IF NOT EXISTS без information_schema-проверок.
Проблема: Если создание materialized view или init_db упадёт после создания cleanup_task, lifespan выбросит исключение до yield — shutdown-часть не выполнится, задача останется висеть (в тестах/перезапусках — утечка).
Как воспроизвести: Смоделировать ошибку в CREATE MATERIALIZED VIEW → проверить, что cleanup_task не отменён.
Что сделать: Оборачивать startup-часть в try/except с отменой уже созданных задач, либо создавать cleanup_task последней после успешной инициализации БД.
Проблема: Мёртвая переменная — first_name извлекается, но нигде не используется и не возвращается из verify_telegram_initdata.
Как воспроизвести: grep first_name по проекту — используется только в этой строке.
Что сделать: Удалить строку либо вернуть first_name из функции, если он нужен вызывающему коду.
Confidence: 0.9
Итого: всего находок=17, snippet не совпал=0, низкий confidence=0, прошло=17
Этот Issue создан автоматически. Исправления делаются вручную.
# 🤖 AI Code Review (Backend)
**Дата:** 2026-09-24 17:06 UTC
**Модель:** `deepseek-ai/DeepSeek-V4.1-Flash`
**Репозиторий:** `Drobysh/filwordspl-backend`
## 📊 По пакам
- **routers** — 21 файлов, 322,654 символов, находок=10
- **core** — 4 файлов, 67,164 символов, находок=7
- **services** — 1 файлов, 0 символов, находок=0
---
## 🔴 Влияет на ученика (4)
### 1. hint_consumed_before_word_check
- **Файл:** `routers/hints.py:40`
- **Snippet:** `if progress:
await conn.execute(
"UPDATE user_progress SET hints_used = hints_used + 1 WHERE`
- **Проблема:** Ученик теряет подсказку, если у уровня нет слов: hints_used растёт, но подсказка не выдаётся (404).
- **Как воспроизвести:** Открыть уровень без слов → взять подсказку → 404, но hints_used уже +1
- **Что сделать:** Сначала проверить наличие слов, только потом инкрементить hints_used (или откатывать в той же транзакции).
- **Confidence:** 0.9
### 2. hint_fake_first_cell
- **Файл:** `routers/hints.py:75`
- **Snippet:** `if not found_word:
# Если пути не нашлись — берём любое слово
found_word = all_level_words[0]
`
- **Проблема:** Ученик получает подсказку с координатой [0,0], которая не соответствует слову — подсветка в сетке неверная.
- **Как воспроизвести:** Взять подсказку на уровне, где word_paths пуст → first_cell = [0,0]
- **Что сделать:** Если пути нет — вернуть 404/500, а не фейковую координату.
- **Confidence:** 0.85
### 3. leaderboard_rank_wrong_for_uncached_user
- **Файл:** `routers/leaderboard.py:55`
- **Snippet:** `user_rank = await conn.fetchval("""
SELECT COUNT(*) + 1 FROM leaderboard_cache
WHERE total_score`
- **Проблема:** Пользователь, которого ещё нет в leaderboard_cache, видит себя на 1 месте в рейтинге, хотя у него 0 очков.
- **Как воспроизвести:** Новый юзер → GET /leaderboard → my_rank.rank = 1
- **Что сделать:** Если подзапрос вернул NULL — считать rank по COUNT(*) + 1 без сравнения, либо явно обрабатывать отсутствие строки.
- **Confidence:** 0.88
### 4. teacher_ai_explanation_empty_on_failure
- **Файл:** `routers/teacher.py:250`
- **Snippet:** `if ai_response:
async with pool.acquire() as conn:
await increment_teacher_ai_usage(conn, telegram_i`
- **Проблема:** Если AI упал, но лимит не исчерпан — ученик получает пустое объяснение ошибки вместо текста.
- **Как воспроизвести:** Отключить TOGETHER_API_KEY → ответить неверно → explanation = ''
- **Что сделать:** При пустом ответе AI возвращать нейтральный fallback-текст, а не пустую строку.
- **Confidence:** 0.82
## 🟠 Риск для данных (3)
### 5. initdata_in_query_param
- **Файл:** `auth.py:96`
- **Snippet:** `if not init_data:
init_data = request.query_params.get('initData', '')`
- **Проблема:** initData (подписанный токен Telegram) попадает в URL, а значит в access-логи nginx/uvicorn, логи Cloudflare, историю браузера, Referer-заголовки и кэши прокси — токен можно перехватить и переиспользовать до истечения MAX_INITDATA_AGE (4 часа).
- **Как воспроизвести:** Открыть DevTools → Network → любой запрос deleteFeedPost → initData виден в query string; проверить access.log сервера — там полный initData.
- **Что сделать:** Убрать fallback на query-параметр; для deleteFeedPost использовать POST с телом или заголовком Authorization: tma <initData>. Если fallback обязателен — ограничить его только одним эндпоинтом и логировать предупреждение.
- **Confidence:** 0.88
### 6. duplicate_delete_keeps_wrong_row
- **Файл:** `database.py:152`
- **Snippet:** `DELETE FROM user_progress a
USING user_progress b
WHERE a.ctid < b.ctid
`
- **Проблема:** При миграции user_id INTEGER→BIGINT удаляются дубли, но остаётся строка с максимальным ctid (физическое расположение), а не с максимальным completed_at/score, как обещает комментарий. У части учеников может пропасть лучший результат по уровню.
- **Как воспроизвести:** Создать две строки user_progress с одинаковыми (user_id, level_id), но разными score/completed_at → запустить init_db → проверить, какая строка осталась.
- **Что сделать:** Заменить условие на сохранение строки с максимальным completed_at (или score): DELETE ... WHERE a.ctid <> (SELECT ctid FROM user_progress c WHERE c.user_id=a.user_id AND c.level_id=a.level_id ORDER BY c.completed_at DESC NULLS LAST, c.score DESC LIMIT 1).
- **Confidence:** 0.78
### 7. fastapi_docs_exposed
- **Файл:** `main.py:218`
- **Snippet:** `app = FastAPI(title="Filwords PL API", lifespan=lifespan)`
- **Проблема:** В продакшене открыты /docs, /redoc и /openapi.json — любой может увидеть полную схему API, включая админские эндпоинты, и использовать её для атак.
- **Как воспроизвести:** Открыть https://<host>/docs и https://<host>/openapi.json — возвращается полная спецификация.
- **Что сделать:** FastAPI(..., docs_url=None, redoc_url=None, openapi_url=None) в проде, либо закрыть эти пути basic-auth/allowlist по IP.
- **Confidence:** 0.72
## 🟡 Качество кода (10)
### 8. admin_content_lesson_levels_n_plus_1
- **Файл:** `routers/admin_content.py:600`
- **Snippet:** `for lvl in level_rows:
code = lvl["code"]
topics_count = await conn.fetchval("""
`
- **Проблема:** Дашборд уроков грузится медленно: 6 уровней × 3 запроса = 18 round-trip.
- **Как воспроизвести:** GET /admin/content/lessons/levels
- **Что сделать:** Заменить цикл на GROUP BY level_code (как уже сделано в /summary).
- **Confidence:** 0.9
### 9. admin_content_lesson_topics_n_plus_1
- **Файл:** `routers/admin_content.py:700`
- **Snippet:** `for r in rows:
topic_id = r["topic_id"]
lessons_count = await conn.fetchval("""
`
- **Проблема:** Список тем уровня делает 2 запроса на каждую тему — при 20 темах это 40 round-trip.
- **Как воспроизвести:** GET /admin/content/lessons/level/A1/topics
- **Что сделать:** Один GROUP BY topic_id для lessons_count и test_questions_count.
- **Confidence:** 0.9
### 10. admin_content_get_lesson_n_plus_1
- **Файл:** `routers/admin_content.py:800`
- **Snippet:** `for q in questions_rows:
options_rows = await conn.fetch("""
SELECT option_key, text_pl, tex`
- **Проблема:** WYSIWYG-редактор урока грузится медленно: N+1 по options.
- **Как воспроизвести:** GET /admin/content/lessons/lesson/{id}
- **Что сделать:** Один запрос WHERE question_id = ANY($1) + группировка в Python (как в learning.py).
- **Confidence:** 0.9
### 11. teacher_progress_n_plus_1
- **Файл:** `routers/teacher.py:700`
- **Snippet:** `for level in levels:
code = level["code"]
topics_total = await conn.fetchval("""
`
- **Проблема:** GET /teacher/progress делает 2 запроса на каждый из 6 уровней — 12 round-trip.
- **Как воспроизвести:** GET /teacher/progress
- **Что сделать:** GROUP BY level_code для topics_total и topics_completed.
- **Confidence:** 0.88
### 12. teacher_diagnostic_test_n_plus_1
- **Файл:** `routers/teacher.py:800`
- **Snippet:** `questions_data = []
for q in questions:
options = await conn.fetch("""
SELECT * FROM`
- **Проблема:** Диагностический тест грузится медленно: 15 вопросов × 1 запрос = 15 round-trip.
- **Как воспроизвести:** POST /teacher/diagnostic-test
- **Что сделать:** Один запрос WHERE question_id = ANY($1) + группировка в Python.
- **Confidence:** 0.88
### 13. orchestrator_n_plus_1_options
- **Файл:** `routers/orchestrator.py:100`
- **Snippet:** `questions_data = []
for q in questions:
options = await conn.fetch("""
SELECT * FROM question_op`
- **Проблема:** get_lesson_by_id / get_lesson_questions / get_test_questions делают N+1 по options — тормозит чат-учителя.
- **Как воспроизвести:** POST /teacher/start → get_lesson_by_id
- **Что сделать:** Один запрос WHERE question_id = ANY($1) + группировка в Python.
- **Confidence:** 0.88
### 14. cf_ip_check_per_request
- **Файл:** `main.py:138`
- **Snippet:** `for cidr in CF_IPS:
try:
if ip in ipaddress.ip_network(cidr, strict=False):`
- **Проблема:** На каждый HTTP-запрос парсится 22 CIDR-сети Cloudflare — лишняя нагрузка на CPU в middleware, который выполняется для всех запросов.
- **Как воспроизвести:** Профилировать rate_limit_middleware под нагрузкой — видно постоянные вызовы ipaddress.ip_network.
- **Что сделать:** Один раз на старте скомпилировать CF_IPS в список ipaddress.IPv4Network/IPv6Network и хранить в модуле; в _is_cloudflare_ip использовать готовые объекты.
- **Confidence:** 0.8
### 15. init_db_slow_startup
- **Файл:** `database.py:22`
- **Snippet:** `async def init_db():
pool = await get_pool()
async with pool.acquire() as conn:`
- **Проблема:** На каждом рестарте выполняется ~40 запросов к information_schema + десятки CREATE/ALTER внутри одной транзакции — старт приложения затягивается, а долгая транзакция держит блокировки на таблицах.
- **Как воспроизвести:** Замерить время init_db() на пустой и на большой БД — секунды на каждом рестарте.
- **Что сделать:** Вынести авто-миграции в отдельный скрипт/миграционный фреймворк (alembic), а init_db оставить только для CREATE TABLE IF NOT EXISTS без information_schema-проверок.
- **Confidence:** 0.82
### 16. cleanup_task_leak_on_startup_failure
- **Файл:** `main.py:175`
- **Snippet:** `cleanup_task = asyncio.create_task(rate_limiter.start_cleanup())
from database import get_pool`
- **Проблема:** Если создание materialized view или init_db упадёт после создания cleanup_task, lifespan выбросит исключение до yield — shutdown-часть не выполнится, задача останется висеть (в тестах/перезапусках — утечка).
- **Как воспроизвести:** Смоделировать ошибку в CREATE MATERIALIZED VIEW → проверить, что cleanup_task не отменён.
- **Что сделать:** Оборачивать startup-часть в try/except с отменой уже созданных задач, либо создавать cleanup_task последней после успешной инициализации БД.
- **Confidence:** 0.7
### 17. unused_first_name
- **Файл:** `auth.py:78`
- **Snippet:** `first_name = user_data.get('first_name', '')`
- **Проблема:** Мёртвая переменная — first_name извлекается, но нигде не используется и не возвращается из verify_telegram_initdata.
- **Как воспроизвести:** grep first_name по проекту — используется только в этой строке.
- **Что сделать:** Удалить строку либо вернуть first_name из функции, если он нужен вызывающему коду.
- **Confidence:** 0.9
---
**Итого:** всего находок=17, snippet не совпал=0, низкий confidence=0, прошло=17
_Этот 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-24 17:06 UTC
Модель:
deepseek-ai/DeepSeek-V4.1-FlashРепозиторий:
Drobysh/filwordspl-backend📊 По пакам
🔴 Влияет на ученика (4)
1. hint_consumed_before_word_check
routers/hints.py:40if progress: await conn.execute( "UPDATE user_progress SET hints_used = hints_used + 1 WHERE2. hint_fake_first_cell
routers/hints.py:75if not found_word: # Если пути не нашлись — берём любое слово found_word = all_level_words[0]3. leaderboard_rank_wrong_for_uncached_user
routers/leaderboard.py:55user_rank = await conn.fetchval(""" SELECT COUNT(*) + 1 FROM leaderboard_cache WHERE total_score4. teacher_ai_explanation_empty_on_failure
routers/teacher.py:250if ai_response: async with pool.acquire() as conn: await increment_teacher_ai_usage(conn, telegram_i🟠 Риск для данных (3)
5. initdata_in_query_param
auth.py:96if not init_data: init_data = request.query_params.get('initData', '')6. duplicate_delete_keeps_wrong_row
database.py:152DELETE FROM user_progress a USING user_progress b WHERE a.ctid < b.ctid7. fastapi_docs_exposed
main.py:218app = FastAPI(title="Filwords PL API", lifespan=lifespan)🟡 Качество кода (10)
8. admin_content_lesson_levels_n_plus_1
Файл:
routers/admin_content.py:600Snippet: `for lvl in level_rows:
code = lvl["code"]
Проблема: Дашборд уроков грузится медленно: 6 уровней × 3 запроса = 18 round-trip.
Как воспроизвести: GET /admin/content/lessons/levels
Что сделать: Заменить цикл на GROUP BY level_code (как уже сделано в /summary).
Confidence: 0.9
9. admin_content_lesson_topics_n_plus_1
Файл:
routers/admin_content.py:700Snippet: `for r in rows:
topic_id = r["topic_id"]
Проблема: Список тем уровня делает 2 запроса на каждую тему — при 20 темах это 40 round-trip.
Как воспроизвести: GET /admin/content/lessons/level/A1/topics
Что сделать: Один GROUP BY topic_id для lessons_count и test_questions_count.
Confidence: 0.9
10. admin_content_get_lesson_n_plus_1
routers/admin_content.py:800for q in questions_rows: options_rows = await conn.fetch(""" SELECT option_key, text_pl, tex11. teacher_progress_n_plus_1
Файл:
routers/teacher.py:700Snippet: `for level in levels:
code = level["code"]
`
Проблема: GET /teacher/progress делает 2 запроса на каждый из 6 уровней — 12 round-trip.
Как воспроизвести: GET /teacher/progress
Что сделать: GROUP BY level_code для topics_total и topics_completed.
Confidence: 0.88
12. teacher_diagnostic_test_n_plus_1
routers/teacher.py:800questions_data = [] for q in questions: options = await conn.fetch(""" SELECT * FROM13. orchestrator_n_plus_1_options
routers/orchestrator.py:100questions_data = [] for q in questions: options = await conn.fetch(""" SELECT * FROM question_op14. cf_ip_check_per_request
main.py:138for cidr in CF_IPS: try: if ip in ipaddress.ip_network(cidr, strict=False):15. init_db_slow_startup
database.py:22async def init_db(): pool = await get_pool() async with pool.acquire() as conn:16. cleanup_task_leak_on_startup_failure
Файл:
main.py:175Snippet: `cleanup_task = asyncio.create_task(rate_limiter.start_cleanup())
from database import get_pool`
Проблема: Если создание materialized view или init_db упадёт после создания cleanup_task, lifespan выбросит исключение до yield — shutdown-часть не выполнится, задача останется висеть (в тестах/перезапусках — утечка).
Как воспроизвести: Смоделировать ошибку в CREATE MATERIALIZED VIEW → проверить, что cleanup_task не отменён.
Что сделать: Оборачивать startup-часть в try/except с отменой уже созданных задач, либо создавать cleanup_task последней после успешной инициализации БД.
Confidence: 0.7
17. unused_first_name
auth.py:78first_name = user_data.get('first_name', '')Итого: всего находок=17, snippet не совпал=0, низкий confidence=0, прошло=17
Этот Issue создан автоматически. Исправления делаются вручную.