🤖 AI Review (backend): 17 задач (2026-09-24 17:06 UTC) #8

Open
opened 2026-09-24 17:06:21 +00:00 by Drobysh · 0 comments
Owner

🤖 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 . Если 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:///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"]

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

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