🤖 AI Review (frontend): 34 задач (2026-09-22 13:09 UTC) #3

Open
opened 2026-09-22 13:09:17 +00:00 by Drobysh · 0 comments
Owner

🤖 AI Code Review (Frontend)

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

📊 По пакам

  • components — 26 файлов, 366,635 символов, находок=9
  • pages — 16 файлов, 379,657 символов, находок=10
  • core — 4 файлов, 36,223 символов, находок=10
  • infra — 12 файлов, 254,030 символов, находок=5

🔴 Влияет на пользователя (14)

1. teacher_menu_tracked_once

  • Файл: src/components/TeacherMenuModal.tsx:130
  • Snippet: if (!menuTrackedRef.current) { menuTrackedRef.current = true; trackTeacherMenuOpened()
  • Проблема: Событие открытия меню учителя трекается только один раз за всю сессию — достижения за повторные открытия не выдаются
  • Как воспроизвести: Открыть меню учителя → закрыть → открыть снова — второй раз trackTeacherMenuOpened не вызывается
  • Что сделать: Сбрасывать menuTrackedRef.current = false в handleClose или убрать ref и трекать при каждом isOpen
  • Confidence: 0.82

2. support_userid_nan

  • Файл: src/components/SupportChatModal.tsx:265
  • Snippet: const isMessageFromMe = (senderId: number) => senderId === Number(userId);
  • Проблема: Если getUserId() вернул null/undefined, Number(userId) = NaN — ни одно сообщение не считается «своим», все пузыри рисуются как входящие
  • Как воспроизвести: Открыть поддержку вне Telegram (userId undefined) — свои сообщения отображаются серым слева
  • Что сделать: Проверять userId на null и сравнивать как строки: String(senderId) === String(userId)
  • Confidence: 0.78

3. admin_dashboard_no_escape

  • Файл: src/components/AdminDashboardModal.tsx:90
  • Snippet: useEffect(() => { if (isOpen) { loadData(); } }, [isOpen, loadData]);
  • Проблема: Админ-панель не закрывается по Escape — приходится целиться в крестик
  • Как воспроизвести: Открыть админ-панель → нажать Escape — модалка не реагирует
  • Что сделать: Добавить useEffect с window.addEventListener('keydown') для Escape
  • Confidence: 0.85

4. feed_modal_race_on_section_change

  • Файл: src/components/FeedModal.tsx:100

  • Snippet: `useEffect(() => {
    if (!isOpen) return;

    isMountedRef.current = true;
    loadFeed();

    return () => {
    i`

  • Проблема: При смене раздела (news→partners) во время загрузки старый ответ может перезаписать новый — в ленте показываются посты не того раздела

  • Как воспроизвести: Открыть News, быстро переключить на Partners — иногда показываются новости

  • Что сделать: Использовать AbortController или счётчик запросов (requestId) вместо isMountedRef

  • Confidence: 0.72

5. HINT_AUTO_SELECTS_CORRECT

  • Файл: src/pages/PracticeViewPage.tsx:118

  • Snippet: `await saveAnswer(currentQuestion.question.question_id, correctAnswer, true, true);

    // 🔧 НОВОЕ: также отмечаем о`

  • Проблема: Ученик жмёт «💡 Подсказка» — правильный вариант автоматически выбирается и засчитывается как ответ, кнопка «Далее» активируется. Вопрос засчитывается как решённый без реального ответа ученика.

  • Как воспроизвести: Открыть /lessons/practice → нажать «💡 Подсказка» → правильный вариант подсвечивается как выбранный, «Далее» становится активной

  • Что сделать: Не вызывать setSelectedAnswers и не сохранять ответ с isFinalAnswer=true при показе подсказки. Логировать только факт подсказки (isFinalAnswer=false, пустой answer), как это сделано в LessonViewPage.handleHintClick.

  • Confidence: 0.93

6. MENU_DOUBLE_ACTION_ON_RERENDER

  • Файл: src/pages/MenuPage.tsx:118
  • Snippet: onMouseUp: () => { setPressing(null); // 🔧 Если touch уже обработал — не вызываем action повторно
  • Проблема: На мобильных (TG WebView) кнопка может сработать дважды: onTouchEnd вызывает action() и setPressing(null) → ре-рендер → создаётся новый замыкающий touchHandled=false → синтетический onMouseUp снова вызывает action(). Открываются две модалки / двойная навигация.
  • Как воспроизвести: На мобильном открыть меню → тапнуть по кнопке «🎮 Games» → иногда открывается модалка дважды или происходит двойной переход
  • Что сделать: Хранить флаг touchHandled в useRef (а не в замыкании) или использовать e.preventDefault() в onTouchEnd, либо полностью убрать onMouseUp-обработчик и полагаться только на onClick.
  • Confidence: 0.78

7. ALERT_IN_TELEGRAM_MINIAPP

  • Файл: src/pages/TeacherChatPage.tsx:640
  • Snippet: if (!analytics.has_practice_available) { alert(t('testPracticeNoWeak')); setIsStartingPractice(false);
  • Проблема: В Telegram Mini App нативный alert() блокирует WebView, выглядит чужеродно и на iOS может не отобразиться вовсе — пользователь не понимает, почему кнопка «Потренировать слабые темы» не работает.
  • Как воспроизвести: Открыть чат учителя → завершить урок → нажать «🎯 Потренировать слабые темы» при отсутствии слабых тем → появляется системный alert
  • Что сделать: Заменить alert() на кастомную модалку/тост в стиле приложения (как RulesModal или message-плашки в других страницах).
  • Confidence: 0.85

8. WORDSEARCH_STREAK_ON_ALREADY_FOUND

  • Файл: src/pages/WordSearchPage.tsx:245

  • Snippet: `if (foundWord) {
    perfectStreakRef.current += 1;

    if (!foundWordsRef.current.includes(foundWord)) {`
    
  • Проблема: perfectStreakRef увеличивается даже когда игрок повторно выделяет уже найденное слово (checkWordMatch возвращает слово, но оно уже в foundWords). Итоговый perfect streak и бонусные очки за уровень завышаются.

  • Как воспроизвести: Найти слово → снова выделить те же буквы → perfectStreak увеличивается, хотя новое слово не найдено

  • Что сделать: Перенести perfectStreakRef.current += 1 внутрь блока if (!foundWordsRef.current.includes(foundWord)).

  • Confidence: 0.88

9. BUBBLE_ERROR_MESSAGE_STUCK

  • Файл: src/pages/BubbleWordsPage.tsx:232
  • Snippet: if (firstLetterHintsUsed >= maxFirstLetterHints) { setErrorMessage('⚠️ ' + (t('noMoreFirstLetterHints') || 'No mor
  • Проблема: После исчерпания подсказок плашка «⚠️ No more hints» висит на экране бесконечно — нет таймаута автоскрытия, как у message. Пользователь думает, что игра сломалась.
  • Как воспроизвести: Открыть Bubble Words → 3 раза нажать «💡 Первая буква» → 4-й раз → плашка появляется и не исчезает
  • Что сделать: Добавить setTimeout для setErrorMessage(null) (аналогично showMessage) и очищать таймер в cleanup.
  • Confidence: 0.83

10. SILENT_REGISTER_FAILURE

  • Файл: src/App.tsx:62
  • Snippet: }) .catch(() => {});
  • Проблема: Если registerUser падает (сеть, 500, невалидный initData), пользователь не видит никакой ошибки и остаётся на пустом/неинициализированном экране без возможности повторить.
  • Как воспроизвести: Заблокировать api.filwordspl.com в DevTools → открыть Mini App → приложение молча висит без регистрации.
  • Что сделать: Показывать экран ошибки/ретрая или хотя бы toast при неудачной регистрации; логировать ошибку в Sentry.
  • Confidence: 0.82

11. USER_ID_NULL_NO_RETRY

  • Файл: src/App.tsx:38
  • Snippet: const userId = getUserId(); if (userId) {
  • Проблема: Если Telegram WebApp-скрипт ещё не загрузился к моменту mount (или initDataUnsafe пуст), регистрация вообще не выполняется и пользователь остаётся без профиля — без повторной попытки.
  • Как воспроизвести: Задержать загрузку telegram-web-app.js (throttle) → открыть Mini App → useEffect отработает один раз, userId = null, регистрация не произойдёт.
  • Что сделать: Подписаться на событие готовности Telegram (tg.ready / polling) или повторять попытку с backoff, пока userId не появится.
  • Confidence: 0.78

12. STRICTMODE_DOUBLE_REGISTER

  • Файл: src/main.tsx:7
  • Snippet: <React.StrictMode> <App /> </React.StrictMode>,
  • Проблема: В dev-режиме React 19 монтирует компоненты дважды, из-за чего registerUser и trackDailyLogin вызываются по два раза — двойные записи в БД, двойной учёт дневного логина.
  • Как воспроизвести: Запустить npm run dev → открыть приложение → в Network видно два POST /users/register.
  • Что сделать: Обернуть регистрацию в ref-флаг (useRef) или вынести инициализацию из useEffect в отдельный модуль с idempotency-ключом.
  • Confidence: 0.75

13. FETCH_NO_TIMEOUT

  • Файл: src/api.ts:5
  • Snippet: const fetchAPI = async (endpoint: string, options: RequestInit = {}) => {
  • Проблема: fetchAPI не использует AbortController/таймаут — при зависшем соединении (типично для Telegram WebView на слабой сети) запрос висит бесконечно, UI остаётся в состоянии загрузки без возможности отмены.
  • Как воспроизвести: В DevTools включить offline после отправки запроса → промис никогда не резолвится и не реджектится.
  • Что сделать: Добавить AbortController с таймаутом (например, 15с) и пробрасывать signal в fetch.
  • Confidence: 0.78

14. setState_inside_updater_side_effect

  • Файл: src/hooks/useAchievements.ts:21
  • Snippet: setAchievementQueue(prev => { if (prev.length === 0) return prev; const [next, ...rest] = prev; setAct
  • Проблема: В React 18/19 StrictMode updater-функция вызывается дважды, из-за чего setTimeout и setActiveAchievement срабатывают дважды: достижение может мигнуть/пропасть, а очередь достижений ломается (пропуск или дублирование уведомлений).
  • Как воспроизвести: Открыть приложение в dev-режиме (StrictMode), получить два достижения подряд — второе может не показаться или показаться дважды.
  • Что сделать: Убрать побочные эффекты (setActiveAchievement, setTimeout) из updater-функции setAchievementQueue; вынести логику в отдельный useEffect, реагирующий на achievementQueue и activeAchievement.
  • Confidence: 0.85

🟠 Риск для данных (6)

15. existing_image_removal_no_delete

  • Файл: src/components/FeedPostComposer.tsx:340
  • Snippet: const handleRemoveExistingImage = (index: number) => { setExistingImages((prev) => prev.filter((_, i) => i !== index
  • Проблема: Админ удаляет картинку из поста, сохраняет — картинка остаётся на сервере и снова появляется в ленте после перезагрузки
  • Как воспроизвести: Открыть пост на редактирование → нажать ✕ на существующей картинке → Сохранить → перезагрузить ленту — картинка на месте
  • Что сделать: Передавать список удалённых URL в updateFeedPost и удалять их на бэке, либо явно вызывать deleteFeedImage
  • Confidence: 0.85

16. post_created_images_failed

  • Файл: src/components/FeedPostComposer.tsx:425
  • Snippet: if (failedUploads.length > 0) { setError( Не удалось загрузить: ${failedUploads.join(', ')}. +
  • Проблема: Пост уже создан на сервере, но юзер видит ошибку и думает, что публикация не удалась — при повторной попытке создаётся дубликат поста
  • Как воспроизвести: Опубликовать пост с 3 фото, отключить сеть на 2-м аплоаде — увидеть ошибку, повторить публикацию — в ленте 2 поста
  • Что сделать: При частичном фейле сообщать «Пост создан, но фото не загрузились» и не давать повторно создавать пост; либо сначала грузить фото, потом создавать пост
  • Confidence: 0.83

17. ADMIN_FLAG_FROM_LOCALSTORAGE

  • Файл: src/pages/MenuPage.tsx:40
  • Snippet: const [isAdmin, setIsAdmin] = useState(() => { // Начальное значение из localStorage, чтобы не мигало при загрузке
  • Проблема: Флаг администратора берётся из localStorage и может быть подделан пользователем (localStorage.setItem('filwords_is_admin','1')). До ответа сервера UI показывает админ-кнопки (Дашборд, админ-чат поддержки), что раскрывает админ-функционал.
  • Как воспроизвести: В консоли WebView выполнить localStorage.setItem('filwords_is_admin','1') → перезагрузить меню → появляется кнопка «📊 Дашборд»
  • Что сделать: Не использовать localStorage как источник истины для isAdmin — инициализировать false и полагаться только на ответ registerUser/getIsAdmin; серверные эндпоинты должны проверять права.
  • Confidence: 0.75

18. INIT_DATA_IN_URL

  • Файл: src/api.ts:8
  • Snippet: const url = ${API_BASE}${endpoint}${endpoint.includes('?') ? '&' : '?'}initData=${encodeURIComponent(initData)};
  • Проблема: Telegram initData (подписанный токен авторизации) уходит в query-строку каждого запроса — попадает в логи сервера/CDN, историю браузера, Referer-заголовки и может быть перехвачен третьими сторонами.
  • Как воспроизвести: Открыть DevTools → Network → любой запрос к api.filwordspl.com → initData виден в URL целиком.
  • Что сделать: Передавать initData в заголовке Authorization (например, Authorization: tma <initData>) или в теле POST, а не в query-параметрах.
  • Confidence: 0.9

19. GET_INIT_DATA_EMPTY_STRING

  • Файл: src/telegram.ts:6
  • Snippet: return "";
  • Проблема: При отсутствии Telegram WebApp (браузер, отладка) все API-запросы уходят с пустым initData — бэк может вернуть данные анонимного/чужого пользователя или 401 без внятной ошибки.
  • Как воспроизвести: Открыть приложение в обычном браузере (не в Telegram) → запросы уходят с initData= пустым.
  • Что сделать: Бросать ошибку/редиректить на заглушку при пустом initData, а не молча отправлять пустую строку.
  • Confidence: 0.8

20. unvalidated_lang_from_url

  • Файл: src/i18n/LanguageContext.tsx:25
  • Snippet: return langFromUrl || langFromStorage || 'pl';
  • Проблема: Если в URL передать ?lang=xx (или любое невалидное значение), оно принимается как язык без проверки. В localStorage сохраняется мусор, а на бэкенд уходит setLanguage('xx') — невалидный язык в профиле пользователя.
  • Как воспроизвести: Открыть приложение по ссылке ...?lang=zzz — язык станет 'zzz', в localStorage запишется 'zzz', на сервер уйдёт запрос с невалидным языком.
  • Что сделать: Валидировать langFromUrl и langFromStorage через тот же список ['pl','ru','uk','en'] перед возвратом из useState-инициализатора.
  • Confidence: 0.9

🟡 Качество кода (14)

21. compress_fallback_objecturl_leak

  • Файл: src/components/FeedPostComposer.tsx:100
  • Snippet: img.onerror = () => reject(new Error('image load failed')); img.src = URL.createObjectURL(blob);
  • Проблема: При загрузке HEIC/старых WebView каждый вызов compressImage оставляет blob-URL в памяти — на длинной сессии память растёт
  • Как воспроизвести: Загрузить несколько HEIC-фото подряд, следить за памятью в DevTools
  • Что сделать: Сохранять URL в переменную и вызывать URL.revokeObjectURL в onload/onerror
  • Confidence: 0.8

22. animated_cat_timeout_leak

  • Файл: src/components/AnimatedCat.tsx:55
  • Snippet: setTimeout(() => { setParticles(prev => prev.filter(p => !newParticles.find(np => np.id === p.id))); }, 2000);
  • Проблема: При быстром закрытии экрана с котом таймер продолжает жить и вызывает setState на размонтированном компоненте
  • Как воспроизвести: Кликнуть по коту и сразу уйти со страницы — в консоли warning о setState на unmounted
  • Что сделать: Хранить id таймера в ref и очищать в useEffect cleanup
  • Confidence: 0.75

23. lightbox_timeout_leak

  • Файл: src/components/ImageLightbox.tsx:130
  • Snippet: setTimeout(() => { goPrev(); setOffsetX(0); setIsAnimating(false); }, 200);
  • Проблема: Если закрыть лайтбокс во время анимации свайпа, таймеры продолжают вызывать setState на размонтированном компоненте
  • Как воспроизвести: Свайпнуть картинку и мгновенно закрыть лайтбокс — warning в консоли
  • Что сделать: Хранить id таймеров в ref и очищать в useEffect cleanup
  • Confidence: 0.75

24. OBJECT_URL_LEAK_TTS

  • Файл: src/pages/TeacherChatPage.tsx:305

  • Snippet: `const audioBlob = await getTTS(polishText, 'male');
    const audioUrl = URL.createObjectURL(audioBlob);

    const `
    
  • Проблема: Каждое воспроизведение TTS создаёт blob-URL, который никогда не освобождается через URL.revokeObjectURL. При долгой сессии в чате учителя память WebView растёт, возможны лаги и падение вкладки.

  • Как воспроизвести: Открыть чат учителя → многократно нажимать 🔊 на сообщениях → в DevTools Memory видно рост числа blob-URL

  • Что сделать: После audio.onended/onerror вызывать URL.revokeObjectURL(audioUrl). Аналогично в FlashcardsPage, PronunciationPage, TypingPage, TestViewPage.

  • Confidence: 0.82

25. TESTVIEW_SAVEANSWER_MISSING_PARAMS

  • Файл: src/pages/TestViewPage.tsx:88
  • Snippet: const saveAnswer = async (questionId: string, answer: string) => { const timeTaken = Date.now() - startTimeRef.curre
  • Проблема: TestViewPage использует устаревшую сигнатуру saveLearningAnswer без isFinalAnswer/usedHint, тогда как LessonViewPage и PracticeViewPage уже передают 6 аргументов. Бэкенд может по-разному интерпретировать ответы теста и урока, что ведёт к неверной статистике.
  • Как воспроизвести: Пройти тест темы и урок — сравнить записи ответов в БД: у теста отсутствует флаг usedHint
  • Что сделать: Привести сигнатуру saveAnswer в TestViewPage к общему виду (isFinalAnswer, usedHint) и передавать их в saveLearningAnswer.
  • Confidence: 0.8

26. LEADERBOARD_O_N2_FILTER

  • Файл: src/pages/LeaderboardPage.tsx:520
  • Snippet: borderBottom: index < entries.filter(e => e.rank > 3).length - 1 ? '1px solid rgba(0,0,0,0.05)' : 'none',
  • Проблема: Внутри .map() на каждой строке таблицы заново фильтруется весь массив entries — O(n²) на 50 записях. На слабых устройствах возможны заметные лаги при отрисовке лидерборда.
  • Как воспроизвести: Открыть /leaderboard с 50 записями → в React DevTools Profiler видно повторный filter на каждом рендере строки
  • Что сделать: Вычислить restEntries = entries.filter(e => e.rank > 3) один раз до .map() и использовать restEntries.length.
  • Confidence: 0.86

27. LESSON_HARDCODED_SKILL_TAG

  • Файл: src/pages/LessonViewPage.tsx:200
  • Snippet: const isTranslationQuestion = currentQuestion?.question.skill_tag === 'how_are_you';
  • Проблема: Логика локализации вариантов ответа завязана на конкретный skill_tag 'how_are_you'. Для любого другого навыка с локализованными вариантами (optionsLanguage='user') будет показан только text_pl, что ломает UX для не-польских пользователей.
  • Как воспроизвести: Добавить урок с skill_tag != 'how_are_you' и optionsLanguage='user' → варианты отображаются на польском вместо языка пользователя
  • Что сделать: Использовать флаг optionsLanguage из данных вопроса (как в TeacherChatPage) вместо хардкода skill_tag.
  • Confidence: 0.72

28. ANY_TYPES_IN_API

  • Файл: src/api.ts:260
  • Snippet: export const getPersonalStats = (): Promise<any> =>
  • Проблема: Отсутствие типов у ответов API (getPersonalStats, getAdminStatsFromAssistant, getLessonFull, saveTeacherHistory, loadTeacherHistory, teacherStart.question и др.) — ошибки в UI-коде не ловятся компилятором, регрессии уходят в прод.
  • Как воспроизвести: Изменить поле в ответе бэка → TypeScript не подсветит ни одной ошибки в потребителях.
  • Что сделать: Описать интерфейсы ответов и заменить any на конкретные типы.
  • Confidence: 0.85

29. MISSING_RETURN_TYPES

  • Файл: src/api.ts:60
  • Snippet: export const getLevel = (levelNumber: number) => fetchAPI(/game/level/${levelNumber});
  • Проблема: Многие игровые/контентные эндпоинты (getLevel, checkWord, completeLevel, getNextSentence, getNextQuiz, getBubbleLevel, getLearningLevels, getAllAchievements, trackLogin и др.) возвращают неявный any — потребители не защищены от изменения схемы.
  • Как воспроизвести: Импортировать getLevel в компонент → тип результата any, автокомплит не работает.
  • Что сделать: Добавить явные типы возврата для всех функций API.
  • Confidence: 0.8

30. SENTRY_ERROR_FIELD_IN_SUCCESS

  • Файл: src/api.ts:78
  • Snippet: count?: number; error?: string;
  • Проблема: Тип успешного ответа getSentryErrors содержит поле error?: string, что размывает контракт: вызывающий код не понимает, это ошибка или часть данных, и может показать пустой список вместо сообщения об ошибке.
  • Как воспроизвести: Вызвать getSentryErrors при недоступном Sentry → в UI отобразится пустой список без сообщения.
  • Что сделать: Разделить типы на success/error или выбрасывать исключение при наличии error.
  • Confidence: 0.72

31. TTS_VOICE_NOT_ENCODED

  • Файл: src/api.ts:178
  • Snippet: return fetch(${API_BASE}/tts?text=${encodeURIComponent(text)}&voice=${voice}&initData=${encodeURIComponent(initData)},
  • Проблема: Параметр voice не проходит encodeURIComponent — при передаче значения со спецсимволами URL ломается и TTS не воспроизводится.
  • Как воспроизвести: Вызвать getTTS('test', 'female&x=1') → запрос уйдёт с лишним параметром.
  • Что сделать: Обернуть voice в encodeURIComponent.
  • Confidence: 0.7

32. context_value_not_memoized

  • Файл: src/i18n/LanguageContext.tsx:46
  • Snippet: <LanguageContext.Provider value={{ language, setLang, t }}>
  • Проблема: Объект value и функция t пересоздаются на каждом рендере провайдера, из-за чего все потребители useLanguage() ре-рендерятся при любом обновлении родителя — просадка производительности на больших экранах.
  • Как воспроизвести: Открыть любой экран с множеством компонентов, использующих useLanguage — лишние ре-рендеры при каждом обновлении LanguageProvider.
  • Что сделать: Обернуть value в useMemo, а t — в useCallback с зависимостью [language].
  • Confidence: 0.8

33. silent_error_swallow_setLanguage

  • Файл: src/i18n/LanguageContext.tsx:31
  • Snippet: setLanguage(language).catch(() => {});
  • Проблема: Ошибка синхронизации языка с бэкендом полностью проглатывается — при сбое сети язык на сервере остаётся старым, пользователь не узнает о проблеме, а рассинхрон между UI и профилем сохраняется.
  • Как воспроизвести: Отключить сеть, сменить язык — UI переключится, но на сервере язык не обновится, ошибка не логируется.
  • Что сделать: Логировать ошибку (console.warn/error) или показывать ненавязчивый тост; не глотать полностью.
  • Confidence: 0.75

34. untyped_any_in_useLocalized

  • Файл: src/hooks/useLocalized.ts:18
  • Snippet: return (item: any, field: string): string => {
  • Проблема: Параметр item: any отключает проверку типов — опечатки в имени поля (например, 'titel' вместо 'title') не будут пойманы компилятором и вернут пустую строку в UI.
  • Как воспроизвести: Вызвать getLocalized(lesson, 'titel') — TypeScript не выдаст ошибку, вернётся ''.
  • Что сделать: Типизировать item как Record<string, unknown> или generic , а field — как keyof T.
  • Confidence: 0.72

Итого: всего находок=37, snippet не совпал=3, низкий confidence=0, прошло=34

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

# 🤖 AI Code Review (Frontend) **Дата:** 2026-09-22 13:09 UTC **Модель:** `deepseek-ai/DeepSeek-V4.1-Flash` **Репозиторий:** `Drobysh/filwordspl-frontend` ## 📊 По пакам - **components** — 26 файлов, 366,635 символов, находок=9 - **pages** — 16 файлов, 379,657 символов, находок=10 - **core** — 4 файлов, 36,223 символов, находок=10 - **infra** — 12 файлов, 254,030 символов, находок=5 --- ## 🔴 Влияет на пользователя (14) ### 1. teacher_menu_tracked_once - **Файл:** `src/components/TeacherMenuModal.tsx:130` - **Snippet:** `if (!menuTrackedRef.current) { menuTrackedRef.current = true; trackTeacherMenuOpened()` - **Проблема:** Событие открытия меню учителя трекается только один раз за всю сессию — достижения за повторные открытия не выдаются - **Как воспроизвести:** Открыть меню учителя → закрыть → открыть снова — второй раз trackTeacherMenuOpened не вызывается - **Что сделать:** Сбрасывать menuTrackedRef.current = false в handleClose или убрать ref и трекать при каждом isOpen - **Confidence:** 0.82 ### 2. support_userid_nan - **Файл:** `src/components/SupportChatModal.tsx:265` - **Snippet:** `const isMessageFromMe = (senderId: number) => senderId === Number(userId);` - **Проблема:** Если getUserId() вернул null/undefined, Number(userId) = NaN — ни одно сообщение не считается «своим», все пузыри рисуются как входящие - **Как воспроизвести:** Открыть поддержку вне Telegram (userId undefined) — свои сообщения отображаются серым слева - **Что сделать:** Проверять userId на null и сравнивать как строки: String(senderId) === String(userId) - **Confidence:** 0.78 ### 3. admin_dashboard_no_escape - **Файл:** `src/components/AdminDashboardModal.tsx:90` - **Snippet:** `useEffect(() => { if (isOpen) { loadData(); } }, [isOpen, loadData]);` - **Проблема:** Админ-панель не закрывается по Escape — приходится целиться в крестик - **Как воспроизвести:** Открыть админ-панель → нажать Escape — модалка не реагирует - **Что сделать:** Добавить useEffect с window.addEventListener('keydown') для Escape - **Confidence:** 0.85 ### 4. feed_modal_race_on_section_change - **Файл:** `src/components/FeedModal.tsx:100` - **Snippet:** `useEffect(() => { if (!isOpen) return; isMountedRef.current = true; loadFeed(); return () => { i` - **Проблема:** При смене раздела (news→partners) во время загрузки старый ответ может перезаписать новый — в ленте показываются посты не того раздела - **Как воспроизвести:** Открыть News, быстро переключить на Partners — иногда показываются новости - **Что сделать:** Использовать AbortController или счётчик запросов (requestId) вместо isMountedRef - **Confidence:** 0.72 ### 5. HINT_AUTO_SELECTS_CORRECT - **Файл:** `src/pages/PracticeViewPage.tsx:118` - **Snippet:** `await saveAnswer(currentQuestion.question.question_id, correctAnswer, true, true); // 🔧 НОВОЕ: также отмечаем о` - **Проблема:** Ученик жмёт «💡 Подсказка» — правильный вариант автоматически выбирается и засчитывается как ответ, кнопка «Далее» активируется. Вопрос засчитывается как решённый без реального ответа ученика. - **Как воспроизвести:** Открыть /lessons/practice → нажать «💡 Подсказка» → правильный вариант подсвечивается как выбранный, «Далее» становится активной - **Что сделать:** Не вызывать setSelectedAnswers и не сохранять ответ с isFinalAnswer=true при показе подсказки. Логировать только факт подсказки (isFinalAnswer=false, пустой answer), как это сделано в LessonViewPage.handleHintClick. - **Confidence:** 0.93 ### 6. MENU_DOUBLE_ACTION_ON_RERENDER - **Файл:** `src/pages/MenuPage.tsx:118` - **Snippet:** `onMouseUp: () => { setPressing(null); // 🔧 Если touch уже обработал — не вызываем action повторно ` - **Проблема:** На мобильных (TG WebView) кнопка может сработать дважды: onTouchEnd вызывает action() и setPressing(null) → ре-рендер → создаётся новый замыкающий touchHandled=false → синтетический onMouseUp снова вызывает action(). Открываются две модалки / двойная навигация. - **Как воспроизвести:** На мобильном открыть меню → тапнуть по кнопке «🎮 Games» → иногда открывается модалка дважды или происходит двойной переход - **Что сделать:** Хранить флаг touchHandled в useRef (а не в замыкании) или использовать e.preventDefault() в onTouchEnd, либо полностью убрать onMouseUp-обработчик и полагаться только на onClick. - **Confidence:** 0.78 ### 7. ALERT_IN_TELEGRAM_MINIAPP - **Файл:** `src/pages/TeacherChatPage.tsx:640` - **Snippet:** `if (!analytics.has_practice_available) { alert(t('testPracticeNoWeak')); setIsStartingPractice(false); ` - **Проблема:** В Telegram Mini App нативный alert() блокирует WebView, выглядит чужеродно и на iOS может не отобразиться вовсе — пользователь не понимает, почему кнопка «Потренировать слабые темы» не работает. - **Как воспроизвести:** Открыть чат учителя → завершить урок → нажать «🎯 Потренировать слабые темы» при отсутствии слабых тем → появляется системный alert - **Что сделать:** Заменить alert() на кастомную модалку/тост в стиле приложения (как RulesModal или message-плашки в других страницах). - **Confidence:** 0.85 ### 8. WORDSEARCH_STREAK_ON_ALREADY_FOUND - **Файл:** `src/pages/WordSearchPage.tsx:245` - **Snippet:** `if (foundWord) { perfectStreakRef.current += 1; if (!foundWordsRef.current.includes(foundWord)) {` - **Проблема:** perfectStreakRef увеличивается даже когда игрок повторно выделяет уже найденное слово (checkWordMatch возвращает слово, но оно уже в foundWords). Итоговый perfect streak и бонусные очки за уровень завышаются. - **Как воспроизвести:** Найти слово → снова выделить те же буквы → perfectStreak увеличивается, хотя новое слово не найдено - **Что сделать:** Перенести perfectStreakRef.current += 1 внутрь блока if (!foundWordsRef.current.includes(foundWord)). - **Confidence:** 0.88 ### 9. BUBBLE_ERROR_MESSAGE_STUCK - **Файл:** `src/pages/BubbleWordsPage.tsx:232` - **Snippet:** `if (firstLetterHintsUsed >= maxFirstLetterHints) { setErrorMessage('⚠️ ' + (t('noMoreFirstLetterHints') || 'No mor` - **Проблема:** После исчерпания подсказок плашка «⚠️ No more hints» висит на экране бесконечно — нет таймаута автоскрытия, как у message. Пользователь думает, что игра сломалась. - **Как воспроизвести:** Открыть Bubble Words → 3 раза нажать «💡 Первая буква» → 4-й раз → плашка появляется и не исчезает - **Что сделать:** Добавить setTimeout для setErrorMessage(null) (аналогично showMessage) и очищать таймер в cleanup. - **Confidence:** 0.83 ### 10. SILENT_REGISTER_FAILURE - **Файл:** `src/App.tsx:62` - **Snippet:** `}) .catch(() => {});` - **Проблема:** Если registerUser падает (сеть, 500, невалидный initData), пользователь не видит никакой ошибки и остаётся на пустом/неинициализированном экране без возможности повторить. - **Как воспроизвести:** Заблокировать api.filwordspl.com в DevTools → открыть Mini App → приложение молча висит без регистрации. - **Что сделать:** Показывать экран ошибки/ретрая или хотя бы toast при неудачной регистрации; логировать ошибку в Sentry. - **Confidence:** 0.82 ### 11. USER_ID_NULL_NO_RETRY - **Файл:** `src/App.tsx:38` - **Snippet:** `const userId = getUserId(); if (userId) {` - **Проблема:** Если Telegram WebApp-скрипт ещё не загрузился к моменту mount (или initDataUnsafe пуст), регистрация вообще не выполняется и пользователь остаётся без профиля — без повторной попытки. - **Как воспроизвести:** Задержать загрузку telegram-web-app.js (throttle) → открыть Mini App → useEffect отработает один раз, userId = null, регистрация не произойдёт. - **Что сделать:** Подписаться на событие готовности Telegram (tg.ready / polling) или повторять попытку с backoff, пока userId не появится. - **Confidence:** 0.78 ### 12. STRICTMODE_DOUBLE_REGISTER - **Файл:** `src/main.tsx:7` - **Snippet:** `<React.StrictMode> <App /> </React.StrictMode>,` - **Проблема:** В dev-режиме React 19 монтирует компоненты дважды, из-за чего registerUser и trackDailyLogin вызываются по два раза — двойные записи в БД, двойной учёт дневного логина. - **Как воспроизвести:** Запустить `npm run dev` → открыть приложение → в Network видно два POST /users/register. - **Что сделать:** Обернуть регистрацию в ref-флаг (useRef) или вынести инициализацию из useEffect в отдельный модуль с idempotency-ключом. - **Confidence:** 0.75 ### 13. FETCH_NO_TIMEOUT - **Файл:** `src/api.ts:5` - **Snippet:** `const fetchAPI = async (endpoint: string, options: RequestInit = {}) => {` - **Проблема:** fetchAPI не использует AbortController/таймаут — при зависшем соединении (типично для Telegram WebView на слабой сети) запрос висит бесконечно, UI остаётся в состоянии загрузки без возможности отмены. - **Как воспроизвести:** В DevTools включить offline после отправки запроса → промис никогда не резолвится и не реджектится. - **Что сделать:** Добавить AbortController с таймаутом (например, 15с) и пробрасывать signal в fetch. - **Confidence:** 0.78 ### 14. setState_inside_updater_side_effect - **Файл:** `src/hooks/useAchievements.ts:21` - **Snippet:** `setAchievementQueue(prev => { if (prev.length === 0) return prev; const [next, ...rest] = prev; setAct` - **Проблема:** В React 18/19 StrictMode updater-функция вызывается дважды, из-за чего setTimeout и setActiveAchievement срабатывают дважды: достижение может мигнуть/пропасть, а очередь достижений ломается (пропуск или дублирование уведомлений). - **Как воспроизвести:** Открыть приложение в dev-режиме (StrictMode), получить два достижения подряд — второе может не показаться или показаться дважды. - **Что сделать:** Убрать побочные эффекты (setActiveAchievement, setTimeout) из updater-функции setAchievementQueue; вынести логику в отдельный useEffect, реагирующий на achievementQueue и activeAchievement. - **Confidence:** 0.85 ## 🟠 Риск для данных (6) ### 15. existing_image_removal_no_delete - **Файл:** `src/components/FeedPostComposer.tsx:340` - **Snippet:** `const handleRemoveExistingImage = (index: number) => { setExistingImages((prev) => prev.filter((_, i) => i !== index` - **Проблема:** Админ удаляет картинку из поста, сохраняет — картинка остаётся на сервере и снова появляется в ленте после перезагрузки - **Как воспроизвести:** Открыть пост на редактирование → нажать ✕ на существующей картинке → Сохранить → перезагрузить ленту — картинка на месте - **Что сделать:** Передавать список удалённых URL в updateFeedPost и удалять их на бэке, либо явно вызывать deleteFeedImage - **Confidence:** 0.85 ### 16. post_created_images_failed - **Файл:** `src/components/FeedPostComposer.tsx:425` - **Snippet:** `if (failedUploads.length > 0) { setError( `Не удалось загрузить: ${failedUploads.join(', ')}. ` + ` - **Проблема:** Пост уже создан на сервере, но юзер видит ошибку и думает, что публикация не удалась — при повторной попытке создаётся дубликат поста - **Как воспроизвести:** Опубликовать пост с 3 фото, отключить сеть на 2-м аплоаде — увидеть ошибку, повторить публикацию — в ленте 2 поста - **Что сделать:** При частичном фейле сообщать «Пост создан, но фото не загрузились» и не давать повторно создавать пост; либо сначала грузить фото, потом создавать пост - **Confidence:** 0.83 ### 17. ADMIN_FLAG_FROM_LOCALSTORAGE - **Файл:** `src/pages/MenuPage.tsx:40` - **Snippet:** `const [isAdmin, setIsAdmin] = useState(() => { // Начальное значение из localStorage, чтобы не мигало при загрузке ` - **Проблема:** Флаг администратора берётся из localStorage и может быть подделан пользователем (localStorage.setItem('filwords_is_admin','1')). До ответа сервера UI показывает админ-кнопки (Дашборд, админ-чат поддержки), что раскрывает админ-функционал. - **Как воспроизвести:** В консоли WebView выполнить localStorage.setItem('filwords_is_admin','1') → перезагрузить меню → появляется кнопка «📊 Дашборд» - **Что сделать:** Не использовать localStorage как источник истины для isAdmin — инициализировать false и полагаться только на ответ registerUser/getIsAdmin; серверные эндпоинты должны проверять права. - **Confidence:** 0.75 ### 18. INIT_DATA_IN_URL - **Файл:** `src/api.ts:8` - **Snippet:** `const url = `${API_BASE}${endpoint}${endpoint.includes('?') ? '&' : '?'}initData=${encodeURIComponent(initData)}`;` - **Проблема:** Telegram initData (подписанный токен авторизации) уходит в query-строку каждого запроса — попадает в логи сервера/CDN, историю браузера, Referer-заголовки и может быть перехвачен третьими сторонами. - **Как воспроизвести:** Открыть DevTools → Network → любой запрос к api.filwordspl.com → initData виден в URL целиком. - **Что сделать:** Передавать initData в заголовке Authorization (например, `Authorization: tma <initData>`) или в теле POST, а не в query-параметрах. - **Confidence:** 0.9 ### 19. GET_INIT_DATA_EMPTY_STRING - **Файл:** `src/telegram.ts:6` - **Snippet:** `return "";` - **Проблема:** При отсутствии Telegram WebApp (браузер, отладка) все API-запросы уходят с пустым initData — бэк может вернуть данные анонимного/чужого пользователя или 401 без внятной ошибки. - **Как воспроизвести:** Открыть приложение в обычном браузере (не в Telegram) → запросы уходят с `initData=` пустым. - **Что сделать:** Бросать ошибку/редиректить на заглушку при пустом initData, а не молча отправлять пустую строку. - **Confidence:** 0.8 ### 20. unvalidated_lang_from_url - **Файл:** `src/i18n/LanguageContext.tsx:25` - **Snippet:** `return langFromUrl || langFromStorage || 'pl';` - **Проблема:** Если в URL передать ?lang=xx (или любое невалидное значение), оно принимается как язык без проверки. В localStorage сохраняется мусор, а на бэкенд уходит setLanguage('xx') — невалидный язык в профиле пользователя. - **Как воспроизвести:** Открыть приложение по ссылке ...?lang=zzz — язык станет 'zzz', в localStorage запишется 'zzz', на сервер уйдёт запрос с невалидным языком. - **Что сделать:** Валидировать langFromUrl и langFromStorage через тот же список ['pl','ru','uk','en'] перед возвратом из useState-инициализатора. - **Confidence:** 0.9 ## 🟡 Качество кода (14) ### 21. compress_fallback_objecturl_leak - **Файл:** `src/components/FeedPostComposer.tsx:100` - **Snippet:** `img.onerror = () => reject(new Error('image load failed')); img.src = URL.createObjectURL(blob);` - **Проблема:** При загрузке HEIC/старых WebView каждый вызов compressImage оставляет blob-URL в памяти — на длинной сессии память растёт - **Как воспроизвести:** Загрузить несколько HEIC-фото подряд, следить за памятью в DevTools - **Что сделать:** Сохранять URL в переменную и вызывать URL.revokeObjectURL в onload/onerror - **Confidence:** 0.8 ### 22. animated_cat_timeout_leak - **Файл:** `src/components/AnimatedCat.tsx:55` - **Snippet:** `setTimeout(() => { setParticles(prev => prev.filter(p => !newParticles.find(np => np.id === p.id))); }, 2000);` - **Проблема:** При быстром закрытии экрана с котом таймер продолжает жить и вызывает setState на размонтированном компоненте - **Как воспроизвести:** Кликнуть по коту и сразу уйти со страницы — в консоли warning о setState на unmounted - **Что сделать:** Хранить id таймера в ref и очищать в useEffect cleanup - **Confidence:** 0.75 ### 23. lightbox_timeout_leak - **Файл:** `src/components/ImageLightbox.tsx:130` - **Snippet:** `setTimeout(() => { goPrev(); setOffsetX(0); setIsAnimating(false); }, 200);` - **Проблема:** Если закрыть лайтбокс во время анимации свайпа, таймеры продолжают вызывать setState на размонтированном компоненте - **Как воспроизвести:** Свайпнуть картинку и мгновенно закрыть лайтбокс — warning в консоли - **Что сделать:** Хранить id таймеров в ref и очищать в useEffect cleanup - **Confidence:** 0.75 ### 24. OBJECT_URL_LEAK_TTS - **Файл:** `src/pages/TeacherChatPage.tsx:305` - **Snippet:** `const audioBlob = await getTTS(polishText, 'male'); const audioUrl = URL.createObjectURL(audioBlob); const ` - **Проблема:** Каждое воспроизведение TTS создаёт blob-URL, который никогда не освобождается через URL.revokeObjectURL. При долгой сессии в чате учителя память WebView растёт, возможны лаги и падение вкладки. - **Как воспроизвести:** Открыть чат учителя → многократно нажимать 🔊 на сообщениях → в DevTools Memory видно рост числа blob-URL - **Что сделать:** После audio.onended/onerror вызывать URL.revokeObjectURL(audioUrl). Аналогично в FlashcardsPage, PronunciationPage, TypingPage, TestViewPage. - **Confidence:** 0.82 ### 25. TESTVIEW_SAVEANSWER_MISSING_PARAMS - **Файл:** `src/pages/TestViewPage.tsx:88` - **Snippet:** `const saveAnswer = async (questionId: string, answer: string) => { const timeTaken = Date.now() - startTimeRef.curre` - **Проблема:** TestViewPage использует устаревшую сигнатуру saveLearningAnswer без isFinalAnswer/usedHint, тогда как LessonViewPage и PracticeViewPage уже передают 6 аргументов. Бэкенд может по-разному интерпретировать ответы теста и урока, что ведёт к неверной статистике. - **Как воспроизвести:** Пройти тест темы и урок — сравнить записи ответов в БД: у теста отсутствует флаг usedHint - **Что сделать:** Привести сигнатуру saveAnswer в TestViewPage к общему виду (isFinalAnswer, usedHint) и передавать их в saveLearningAnswer. - **Confidence:** 0.8 ### 26. LEADERBOARD_O_N2_FILTER - **Файл:** `src/pages/LeaderboardPage.tsx:520` - **Snippet:** `borderBottom: index < entries.filter(e => e.rank > 3).length - 1 ? '1px solid rgba(0,0,0,0.05)' : 'none',` - **Проблема:** Внутри .map() на каждой строке таблицы заново фильтруется весь массив entries — O(n²) на 50 записях. На слабых устройствах возможны заметные лаги при отрисовке лидерборда. - **Как воспроизвести:** Открыть /leaderboard с 50 записями → в React DevTools Profiler видно повторный filter на каждом рендере строки - **Что сделать:** Вычислить restEntries = entries.filter(e => e.rank > 3) один раз до .map() и использовать restEntries.length. - **Confidence:** 0.86 ### 27. LESSON_HARDCODED_SKILL_TAG - **Файл:** `src/pages/LessonViewPage.tsx:200` - **Snippet:** `const isTranslationQuestion = currentQuestion?.question.skill_tag === 'how_are_you';` - **Проблема:** Логика локализации вариантов ответа завязана на конкретный skill_tag 'how_are_you'. Для любого другого навыка с локализованными вариантами (optionsLanguage='user') будет показан только text_pl, что ломает UX для не-польских пользователей. - **Как воспроизвести:** Добавить урок с skill_tag != 'how_are_you' и optionsLanguage='user' → варианты отображаются на польском вместо языка пользователя - **Что сделать:** Использовать флаг optionsLanguage из данных вопроса (как в TeacherChatPage) вместо хардкода skill_tag. - **Confidence:** 0.72 ### 28. ANY_TYPES_IN_API - **Файл:** `src/api.ts:260` - **Snippet:** `export const getPersonalStats = (): Promise<any> =>` - **Проблема:** Отсутствие типов у ответов API (getPersonalStats, getAdminStatsFromAssistant, getLessonFull, saveTeacherHistory, loadTeacherHistory, teacherStart.question и др.) — ошибки в UI-коде не ловятся компилятором, регрессии уходят в прод. - **Как воспроизвести:** Изменить поле в ответе бэка → TypeScript не подсветит ни одной ошибки в потребителях. - **Что сделать:** Описать интерфейсы ответов и заменить `any` на конкретные типы. - **Confidence:** 0.85 ### 29. MISSING_RETURN_TYPES - **Файл:** `src/api.ts:60` - **Snippet:** `export const getLevel = (levelNumber: number) => fetchAPI(`/game/level/${levelNumber}`);` - **Проблема:** Многие игровые/контентные эндпоинты (getLevel, checkWord, completeLevel, getNextSentence, getNextQuiz, getBubbleLevel, getLearningLevels, getAllAchievements, trackLogin и др.) возвращают неявный `any` — потребители не защищены от изменения схемы. - **Как воспроизвести:** Импортировать getLevel в компонент → тип результата `any`, автокомплит не работает. - **Что сделать:** Добавить явные типы возврата для всех функций API. - **Confidence:** 0.8 ### 30. SENTRY_ERROR_FIELD_IN_SUCCESS - **Файл:** `src/api.ts:78` - **Snippet:** `count?: number; error?: string;` - **Проблема:** Тип успешного ответа getSentryErrors содержит поле `error?: string`, что размывает контракт: вызывающий код не понимает, это ошибка или часть данных, и может показать пустой список вместо сообщения об ошибке. - **Как воспроизвести:** Вызвать getSentryErrors при недоступном Sentry → в UI отобразится пустой список без сообщения. - **Что сделать:** Разделить типы на success/error или выбрасывать исключение при наличии `error`. - **Confidence:** 0.72 ### 31. TTS_VOICE_NOT_ENCODED - **Файл:** `src/api.ts:178` - **Snippet:** `return fetch(`${API_BASE}/tts?text=${encodeURIComponent(text)}&voice=${voice}&initData=${encodeURIComponent(initData)}`,` - **Проблема:** Параметр `voice` не проходит encodeURIComponent — при передаче значения со спецсимволами URL ломается и TTS не воспроизводится. - **Как воспроизвести:** Вызвать getTTS('test', 'female&x=1') → запрос уйдёт с лишним параметром. - **Что сделать:** Обернуть voice в encodeURIComponent. - **Confidence:** 0.7 ### 32. context_value_not_memoized - **Файл:** `src/i18n/LanguageContext.tsx:46` - **Snippet:** `<LanguageContext.Provider value={{ language, setLang, t }}>` - **Проблема:** Объект value и функция t пересоздаются на каждом рендере провайдера, из-за чего все потребители useLanguage() ре-рендерятся при любом обновлении родителя — просадка производительности на больших экранах. - **Как воспроизвести:** Открыть любой экран с множеством компонентов, использующих useLanguage — лишние ре-рендеры при каждом обновлении LanguageProvider. - **Что сделать:** Обернуть value в useMemo, а t — в useCallback с зависимостью [language]. - **Confidence:** 0.8 ### 33. silent_error_swallow_setLanguage - **Файл:** `src/i18n/LanguageContext.tsx:31` - **Snippet:** `setLanguage(language).catch(() => {});` - **Проблема:** Ошибка синхронизации языка с бэкендом полностью проглатывается — при сбое сети язык на сервере остаётся старым, пользователь не узнает о проблеме, а рассинхрон между UI и профилем сохраняется. - **Как воспроизвести:** Отключить сеть, сменить язык — UI переключится, но на сервере язык не обновится, ошибка не логируется. - **Что сделать:** Логировать ошибку (console.warn/error) или показывать ненавязчивый тост; не глотать полностью. - **Confidence:** 0.75 ### 34. untyped_any_in_useLocalized - **Файл:** `src/hooks/useLocalized.ts:18` - **Snippet:** `return (item: any, field: string): string => {` - **Проблема:** Параметр item: any отключает проверку типов — опечатки в имени поля (например, 'titel' вместо 'title') не будут пойманы компилятором и вернут пустую строку в UI. - **Как воспроизвести:** Вызвать getLocalized(lesson, 'titel') — TypeScript не выдаст ошибку, вернётся ''. - **Что сделать:** Типизировать item как Record<string, unknown> или generic <T extends object>, а field — как keyof T. - **Confidence:** 0.72 --- **Итого:** всего находок=37, snippet не совпал=3, низкий confidence=0, прошло=34 _Этот 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-frontend#3