Проблема: Ученик жмёт «💡 Подсказка» — правильный вариант автоматически выбирается и засчитывается как ответ, кнопка «Далее» активируется. Вопрос засчитывается как решённый без реального ответа ученика.
Как воспроизвести: Открыть /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.
Проблема: В Telegram Mini App нативный alert() блокирует WebView, выглядит чужеродно и на iOS может не отобразиться вовсе — пользователь не понимает, почему кнопка «Потренировать слабые темы» не работает.
Как воспроизвести: Открыть чат учителя → завершить урок → нажать «🎯 Потренировать слабые темы» при отсутствии слабых тем → появляется системный alert
Что сделать: Заменить alert() на кастомную модалку/тост в стиле приложения (как RulesModal или message-плашки в других страницах).
if (!foundWordsRef.current.includes(foundWord)) {`
Проблема: perfectStreakRef увеличивается даже когда игрок повторно выделяет уже найденное слово (checkWordMatch возвращает слово, но оно уже в foundWords). Итоговый perfect streak и бонусные очки за уровень завышаются.
Как воспроизвести: Найти слово → снова выделить те же буквы → perfectStreak увеличивается, хотя новое слово не найдено
Что сделать: Перенести perfectStreakRef.current += 1 внутрь блока if (!foundWordsRef.current.includes(foundWord)).
Проблема: После исчерпания подсказок плашка «⚠️ 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 не появится.
Проблема: В dev-режиме React 19 монтирует компоненты дважды, из-за чего registerUser и trackDailyLogin вызываются по два раза — двойные записи в БД, двойной учёт дневного логина.
Как воспроизвести: Запустить npm run dev → открыть приложение → в Network видно два POST /users/register.
Что сделать: Обернуть регистрацию в ref-флаг (useRef) или вынести инициализацию из useEffect в отдельный модуль с idempotency-ключом.
Проблема: fetchAPI не использует AbortController/таймаут — при зависшем соединении (типично для Telegram WebView на слабой сети) запрос висит бесконечно, UI остаётся в состоянии загрузки без возможности отмены.
Как воспроизвести: В DevTools включить offline после отправки запроса → промис никогда не резолвится и не реджектится.
Что сделать: Добавить AbortController с таймаутом (например, 15с) и пробрасывать signal в fetch.
Проблема: В 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; серверные эндпоинты должны проверять права.
Проблема: 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, а не молча отправлять пустую строку.
Проблема: Если в URL передать ?lang=xx (или любое невалидное значение), оно принимается как язык без проверки. В localStorage сохраняется мусор, а на бэкенд уходит setLanguage('xx') — невалидный язык в профиле пользователя.
Как воспроизвести: Открыть приложение по ссылке ...?lang=zzz — язык станет 'zzz', в localStorage запишется 'zzz', на сервер уйдёт запрос с невалидным языком.
Что сделать: Валидировать langFromUrl и langFromStorage через тот же список ['pl','ru','uk','en'] перед возвратом из useState-инициализатора.
Проблема: Каждое воспроизведение TTS создаёт blob-URL, который никогда не освобождается через URL.revokeObjectURL. При долгой сессии в чате учителя память WebView растёт, возможны лаги и падение вкладки.
Как воспроизвести: Открыть чат учителя → многократно нажимать 🔊 на сообщениях → в DevTools Memory видно рост числа blob-URL
Что сделать: После audio.onended/onerror вызывать URL.revokeObjectURL(audioUrl). Аналогично в FlashcardsPage, PronunciationPage, TypingPage, TestViewPage.
Проблема: TestViewPage использует устаревшую сигнатуру saveLearningAnswer без isFinalAnswer/usedHint, тогда как LessonViewPage и PracticeViewPage уже передают 6 аргументов. Бэкенд может по-разному интерпретировать ответы теста и урока, что ведёт к неверной статистике.
Как воспроизвести: Пройти тест темы и урок — сравнить записи ответов в БД: у теста отсутствует флаг usedHint
Что сделать: Привести сигнатуру saveAnswer в TestViewPage к общему виду (isFinalAnswer, usedHint) и передавать их в saveLearningAnswer.
Проблема: Внутри .map() на каждой строке таблицы заново фильтруется весь массив entries — O(n²) на 50 записях. На слабых устройствах возможны заметные лаги при отрисовке лидерборда.
Как воспроизвести: Открыть /leaderboard с 50 записями → в React DevTools Profiler видно повторный filter на каждом рендере строки
Что сделать: Вычислить restEntries = entries.filter(e => e.rank > 3) один раз до .map() и использовать restEntries.length.
Проблема: Логика локализации вариантов ответа завязана на конкретный skill_tag 'how_are_you'. Для любого другого навыка с локализованными вариантами (optionsLanguage='user') будет показан только text_pl, что ломает UX для не-польских пользователей.
Как воспроизвести: Добавить урок с skill_tag != 'how_are_you' и optionsLanguage='user' → варианты отображаются на польском вместо языка пользователя
Что сделать: Использовать флаг optionsLanguage из данных вопроса (как в TeacherChatPage) вместо хардкода skill_tag.
Проблема: Отсутствие типов у ответов API (getPersonalStats, getAdminStatsFromAssistant, getLessonFull, saveTeacherHistory, loadTeacherHistory, teacherStart.question и др.) — ошибки в UI-коде не ловятся компилятором, регрессии уходят в прод.
Как воспроизвести: Изменить поле в ответе бэка → TypeScript не подсветит ни одной ошибки в потребителях.
Что сделать: Описать интерфейсы ответов и заменить any на конкретные типы.
Проблема: Многие игровые/контентные эндпоинты (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.
Проблема: Параметр 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) или показывать ненавязчивый тост; не глотать полностью.
Проблема: Параметр 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 создан автоматически. Исправления делаются вручную._
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 (Frontend)
Дата: 2026-09-22 13:09 UTC
Модель:
deepseek-ai/DeepSeek-V4.1-FlashРепозиторий:
Drobysh/filwordspl-frontend📊 По пакам
🔴 Влияет на пользователя (14)
1. teacher_menu_tracked_once
src/components/TeacherMenuModal.tsx:130if (!menuTrackedRef.current) { menuTrackedRef.current = true; trackTeacherMenuOpened()2. support_userid_nan
src/components/SupportChatModal.tsx:265const isMessageFromMe = (senderId: number) => senderId === Number(userId);3. admin_dashboard_no_escape
src/components/AdminDashboardModal.tsx:90useEffect(() => { if (isOpen) { loadData(); } }, [isOpen, loadData]);4. feed_modal_race_on_section_change
Файл:
src/components/FeedModal.tsx:100Snippet: `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:118Snippet: `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:118onMouseUp: () => { setPressing(null); // 🔧 Если touch уже обработал — не вызываем action повторно7. ALERT_IN_TELEGRAM_MINIAPP
src/pages/TeacherChatPage.tsx:640if (!analytics.has_practice_available) { alert(t('testPracticeNoWeak')); setIsStartingPractice(false);8. WORDSEARCH_STREAK_ON_ALREADY_FOUND
Файл:
src/pages/WordSearchPage.tsx:245Snippet: `if (foundWord) {
perfectStreakRef.current += 1;
Проблема: 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:232if (firstLetterHintsUsed >= maxFirstLetterHints) { setErrorMessage('⚠️ ' + (t('noMoreFirstLetterHints') || 'No mor10. SILENT_REGISTER_FAILURE
src/App.tsx:62}) .catch(() => {});11. USER_ID_NULL_NO_RETRY
src/App.tsx:38const userId = getUserId(); if (userId) {12. STRICTMODE_DOUBLE_REGISTER
src/main.tsx:7<React.StrictMode> <App /> </React.StrictMode>,npm run dev→ открыть приложение → в Network видно два POST /users/register.13. FETCH_NO_TIMEOUT
src/api.ts:5const fetchAPI = async (endpoint: string, options: RequestInit = {}) => {14. setState_inside_updater_side_effect
src/hooks/useAchievements.ts:21setAchievementQueue(prev => { if (prev.length === 0) return prev; const [next, ...rest] = prev; setAct🟠 Риск для данных (6)
15. existing_image_removal_no_delete
src/components/FeedPostComposer.tsx:340const handleRemoveExistingImage = (index: number) => { setExistingImages((prev) => prev.filter((_, i) => i !== index16. post_created_images_failed
src/components/FeedPostComposer.tsx:425if (failedUploads.length > 0) { setError(Не удалось загрузить: ${failedUploads.join(', ')}.+17. ADMIN_FLAG_FROM_LOCALSTORAGE
src/pages/MenuPage.tsx:40const [isAdmin, setIsAdmin] = useState(() => { // Начальное значение из localStorage, чтобы не мигало при загрузке18. INIT_DATA_IN_URL
src/api.ts:8const url =${API_BASE}${endpoint}${endpoint.includes('?') ? '&' : '?'}initData=${encodeURIComponent(initData)};Authorization: tma <initData>) или в теле POST, а не в query-параметрах.19. GET_INIT_DATA_EMPTY_STRING
src/telegram.ts:6return "";initData=пустым.20. unvalidated_lang_from_url
src/i18n/LanguageContext.tsx:25return langFromUrl || langFromStorage || 'pl';🟡 Качество кода (14)
21. compress_fallback_objecturl_leak
src/components/FeedPostComposer.tsx:100img.onerror = () => reject(new Error('image load failed')); img.src = URL.createObjectURL(blob);22. animated_cat_timeout_leak
src/components/AnimatedCat.tsx:55setTimeout(() => { setParticles(prev => prev.filter(p => !newParticles.find(np => np.id === p.id))); }, 2000);23. lightbox_timeout_leak
src/components/ImageLightbox.tsx:130setTimeout(() => { goPrev(); setOffsetX(0); setIsAnimating(false); }, 200);24. OBJECT_URL_LEAK_TTS
Файл:
src/pages/TeacherChatPage.tsx:305Snippet: `const audioBlob = await getTTS(polishText, 'male');
const audioUrl = URL.createObjectURL(audioBlob);
Проблема: Каждое воспроизведение 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:88const saveAnswer = async (questionId: string, answer: string) => { const timeTaken = Date.now() - startTimeRef.curre26. LEADERBOARD_O_N2_FILTER
src/pages/LeaderboardPage.tsx:520borderBottom: index < entries.filter(e => e.rank > 3).length - 1 ? '1px solid rgba(0,0,0,0.05)' : 'none',27. LESSON_HARDCODED_SKILL_TAG
src/pages/LessonViewPage.tsx:200const isTranslationQuestion = currentQuestion?.question.skill_tag === 'how_are_you';28. ANY_TYPES_IN_API
src/api.ts:260export const getPersonalStats = (): Promise<any> =>anyна конкретные типы.29. MISSING_RETURN_TYPES
src/api.ts:60export const getLevel = (levelNumber: number) => fetchAPI(/game/level/${levelNumber});any— потребители не защищены от изменения схемы.any, автокомплит не работает.30. SENTRY_ERROR_FIELD_IN_SUCCESS
src/api.ts:78count?: number; error?: string;error?: string, что размывает контракт: вызывающий код не понимает, это ошибка или часть данных, и может показать пустой список вместо сообщения об ошибке.error.31. TTS_VOICE_NOT_ENCODED
src/api.ts:178return fetch(${API_BASE}/tts?text=${encodeURIComponent(text)}&voice=${voice}&initData=${encodeURIComponent(initData)},voiceне проходит encodeURIComponent — при передаче значения со спецсимволами URL ломается и TTS не воспроизводится.32. context_value_not_memoized
src/i18n/LanguageContext.tsx:46<LanguageContext.Provider value={{ language, setLang, t }}>33. silent_error_swallow_setLanguage
src/i18n/LanguageContext.tsx:31setLanguage(language).catch(() => {});34. untyped_any_in_useLocalized
src/hooks/useLocalized.ts:18return (item: any, field: string): string => {Итого: всего находок=37, snippet не совпал=3, низкий confidence=0, прошло=34
Этот Issue создан автоматически. Исправления делаются вручную.