🌊 Волна 18: frontend #7 — юзабилити + Ł + типы (8 багов)

Продуктовые:
- OPEN_DASHBOARD_EVENT_LOST: убран гейт isAdmin из слушателя (App.tsx)
- achievement_filter_removes_duplicates: фильтр по ссылке (useAchievements.ts)
- alphabet_l_wrong_pronunciation: Ł = [w] как в 'water' (alphabet.ts)
- diacritics_l_wrong_description: Ł = [w], не носовое 'у' (diacritics.ts)

Качество:
- RETRY_TIMER_LEAK_STRICTMODE: таймер retry в ref (App.tsx)
- DEAD_CODE_GET_IS_ADMIN_FALLBACK: убрана мёртвая ветка (App.tsx)
- TTS_NO_CONTENT_TYPE_CHECK: проверка audio/ (api.ts)
- EMPTY_INIT_DATA_AUTH_HEADER: понятная ошибка (api.ts)

Пропущено осознанно:
- INIT_DATA_IN_URL_DELETE_FEED (Cloudflare preflight-кеш)

Аудит v5: Issue #7, frontend 8/9 задач
This commit is contained in:
2026-09-24 21:06:55 +03:00
parent 5c27b98f4b
commit 97392c553a
5 changed files with 105 additions and 31 deletions
+41 -23
View File
@@ -18,7 +18,9 @@ import PracticeViewPage from './pages/PracticeViewPage';
import TeacherChatPage from './pages/TeacherChatPage'; import TeacherChatPage from './pages/TeacherChatPage';
import TypingPage from './pages/TypingPage'; import TypingPage from './pages/TypingPage';
import AdminDashboardModal from './components/AdminDashboardModal'; import AdminDashboardModal from './components/AdminDashboardModal';
import { registerUser, trackDailyLogin, getIsAdmin } from './api'; // 🔧 ФИКС (25.09.2026): DEAD_CODE_GET_IS_ADMIN_FALLBACK —
// getIsAdmin больше не нужен: registerUser гарантирует is_admin: boolean.
import { registerUser, trackDailyLogin } from './api';
import { getUserId } from './telegram'; import { getUserId } from './telegram';
function AppContent() { function AppContent() {
@@ -35,6 +37,10 @@ function AppContent() {
// счётчик попыток registerUser. // счётчик попыток registerUser.
const registerRetryCountRef = useRef(0); const registerRetryCountRef = useRef(0);
// 🔧 ФИКС (25.09.2026): RETRY_TIMER_LEAK_STRICTMODE —
// таймер retry в ref, чтобы cleanup мог его достать.
const registerRetryTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
// 🔧 ФИКС (24.09.2026): STALE_CLOSURE_NAVIGATE_SETLANG — // 🔧 ФИКС (24.09.2026): STALE_CLOSURE_NAVIGATE_SETLANG —
// navigate и setLang в useRef, чтобы избежать stale closure // navigate и setLang в useRef, чтобы избежать stale closure
// при useEffect с []. // при useEffect с [].
@@ -72,7 +78,6 @@ function AppContent() {
// защита от двойного запуска tryRegister в StrictMode. // защита от двойного запуска tryRegister в StrictMode.
let retries = 0; let retries = 0;
const MAX_RETRIES = 5; const MAX_RETRIES = 5;
let retryTimeoutId: ReturnType<typeof setTimeout> | null = null;
const tryRegister = () => { const tryRegister = () => {
// 🔧 Двойная защита: если register УЖЕ прошёл — выходим // 🔧 Двойная защита: если register УЖЕ прошёл — выходим
@@ -82,7 +87,7 @@ function AppContent() {
if (!userId) { if (!userId) {
retries++; retries++;
if (retries < MAX_RETRIES) { if (retries < MAX_RETRIES) {
retryTimeoutId = setTimeout(tryRegister, 300 * retries); registerRetryTimeoutRef.current = setTimeout(tryRegister, 300 * retries);
return; return;
} }
// После MAX_RETRIES сдаёмся // После MAX_RETRIES сдаёмся
@@ -101,18 +106,10 @@ function AppContent() {
}); });
// 🔧 ФИКС (23.09.2026): ADMIN_FLAG_FROM_LOCALSTORAGE — не пишем в localStorage. // 🔧 ФИКС (23.09.2026): ADMIN_FLAG_FROM_LOCALSTORAGE — не пишем в localStorage.
if (typeof data.is_admin === 'boolean') { // 🔧 ФИКС (25.09.2026): DEAD_CODE_GET_IS_ADMIN_FALLBACK —
setIsAdmin(data.is_admin); // ветка else была недостижима: тип registerUser гарантирует
} else { // is_admin: boolean. Убрали мёртвый код и лишний сетевой запрос.
getIsAdmin() setIsAdmin(data.is_admin);
.then((adminData) => {
setIsAdmin(adminData.is_admin);
})
.catch((e) => {
// 🔧 ФИКС (24.09.2026): SILENT_ERROR_SWALLOWING_APP
console.warn('[App] getIsAdmin failed:', e);
});
}
const langFromStorage = localStorage.getItem('filwords_lang'); const langFromStorage = localStorage.getItem('filwords_lang');
@@ -130,34 +127,55 @@ function AppContent() {
// повторяем попытку с backoff (макс 3 попытки). // повторяем попытку с backoff (макс 3 попытки).
if (registerRetryCountRef.current < 3) { if (registerRetryCountRef.current < 3) {
registerRetryCountRef.current++; registerRetryCountRef.current++;
retryTimeoutId = setTimeout(tryRegister, 2000 * registerRetryCountRef.current); registerRetryTimeoutRef.current = setTimeout(tryRegister, 2000 * registerRetryCountRef.current);
} }
}); });
}; };
tryRegister(); tryRegister();
// 🔧 ФИКС (24.09.2026): RETRY_TIMEOUT_NOT_CLEANED — // 🔧 ФИКС (25.09.2026): RETRY_TIMER_LEAK_STRICTMODE —
// очищаем таймер retry при unmount. // таймер retry храним в ref, а не в локальной переменной эффекта.
// В StrictMode cleanup первого эффекта отрабатывает раньше, чем
// registerUser упадёт и запланирует retry — локальная переменная
// уже «мертва», и таймер утекает. Ref живёт между рендерами.
return () => { return () => {
if (retryTimeoutId) clearTimeout(retryTimeoutId); if (registerRetryTimeoutRef.current) {
clearTimeout(registerRetryTimeoutRef.current);
registerRetryTimeoutRef.current = null;
}
}; };
// eslint-disable-next-line react-hooks/exhaustive-deps // eslint-disable-next-line react-hooks/exhaustive-deps
}, []); }, []);
// 🔧 Слушаем событие "open-dashboard" из MenuPage — открывает модалку дашборда // 🔧 Слушаем событие "open-dashboard" из MenuPage — открывает модалку дашборда
// 🔧 ФИКС (25.09.2026): OPEN_DASHBOARD_EVENT_LOST —
// убираем гейт isAdmin из слушателя. Событие может прийти раньше,
// чем registerUser вернёт is_admin=true, и клик по кнопке «терялся».
// Права проверяются при рендере модалки: {showDashboard && isAdmin && ...}.
// Побочный эффект: если не-админ кликнет — showDashboard станет true,
// но модалка не отрендерится (isAdmin=false), и при следующем рендере
// с isAdmin=true она НЕ откроется сама. Поэтому сбрасываем showDashboard
// при false-значении isAdmin — см. эффект ниже.
useEffect(() => { useEffect(() => {
const handleOpenDashboard = () => { const handleOpenDashboard = () => {
if (isAdmin) { setShowDashboard(true);
setShowDashboard(true);
}
}; };
window.addEventListener('open-dashboard', handleOpenDashboard); window.addEventListener('open-dashboard', handleOpenDashboard);
return () => { return () => {
window.removeEventListener('open-dashboard', handleOpenDashboard); window.removeEventListener('open-dashboard', handleOpenDashboard);
}; };
}, [isAdmin]); }, []);
// 🔧 ФИКС (25.09.2026): OPEN_DASHBOARD_EVENT_LOST (часть 2) —
// если модалка «запрошена», но юзер не админ — закрываем и сбрасываем флаг,
// чтобы состояние не зависло в true.
useEffect(() => {
if (showDashboard && !isAdmin) {
setShowDashboard(false);
}
}, [showDashboard, isAdmin]);
useEffect(() => { useEffect(() => {
window.scrollTo(0, 0); window.scrollTo(0, 0);
+44
View File
@@ -198,6 +198,16 @@ const fetchWithTimeout = async (
const fetchAPI = async (endpoint: string, options: RequestInit = {}) => { const fetchAPI = async (endpoint: string, options: RequestInit = {}) => {
const initData = getInitData(); const initData = getInitData();
// 🔧 ФИКС (25.09.2026): EMPTY_INIT_DATA_AUTH_HEADER —
// если initData пустой (приложение открыто вне Telegram),
// уходил заголовок 'Authorization: tma ' и сервер отвечал 401
// с неинформативной ошибкой. Теперь бросаем понятную ошибку.
if (!initData) {
throw new Error(
'Telegram initData недоступен. Откройте приложение через Telegram.'
);
}
// 🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — initData теперь в заголовке Authorization, // 🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — initData теперь в заголовке Authorization,
// а не в query-строке. Токен больше не попадает в логи сервера, Referer, // а не в query-строке. Токен больше не попадает в логи сервера, Referer,
// историю браузера и кеш Cloudflare. // историю браузера и кеш Cloudflare.
@@ -379,6 +389,13 @@ export const getNextPronunciationWord = () =>
export const getTTS = async (text: string, voice: string = 'female'): Promise<Blob> => { export const getTTS = async (text: string, voice: string = 'female'): Promise<Blob> => {
const initData = getInitData(); const initData = getInitData();
// 🔧 ФИКС (25.09.2026): EMPTY_INIT_DATA_AUTH_HEADER — см. fetchAPI.
if (!initData) {
throw new Error(
'Telegram initData недоступен. Откройте приложение через Telegram.'
);
}
// 🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — initData в заголовке. // 🔧 ФИКС (23.09.2026): INIT_DATA_IN_URL — initData в заголовке.
// Заодно: voice теперь кодируется через encodeURIComponent (TTS_VOICE_NOT_ENCODED). // Заодно: voice теперь кодируется через encodeURIComponent (TTS_VOICE_NOT_ENCODED).
const url = `${API_BASE}/tts?text=${encodeURIComponent(text)}&voice=${encodeURIComponent(voice)}`; const url = `${API_BASE}/tts?text=${encodeURIComponent(text)}&voice=${encodeURIComponent(voice)}`;
@@ -395,6 +412,25 @@ export const getTTS = async (text: string, voice: string = 'female'): Promise<Bl
const errorText = await res.text(); const errorText = await res.text();
throw new Error(`API Error: ${res.status} - ${errorText}`); throw new Error(`API Error: ${res.status} - ${errorText}`);
} }
// 🔧 ФИКС (25.09.2026): TTS_NO_CONTENT_TYPE_CHECK —
// если сервер вернул 200 с JSON-ошибкой (например, лимит TTS),
// клиент молча возвращал JSON как Blob и пытался проиграть как аудио.
//
// ⚠️ ВАЖНО: на некоторых деплоях /tts отдаёт `application/octet-stream`
// вместо явного `audio/*`. Разрешаем оба варианта, но блокируем JSON/HTML,
// чтобы поймать реальные ошибки и captive-portal'ы.
const contentType = res.headers.get('content-type') || '';
const isAudio = contentType.includes('audio/');
const isOctetStream = contentType.includes('application/octet-stream');
if (!isAudio && !isOctetStream) {
const text = await res.text();
throw new Error(
`TTS Error: expected audio, got ${contentType}. Body: ${text.slice(0, 200)}`
);
}
return res.blob(); return res.blob();
}; };
@@ -961,6 +997,14 @@ export const uploadFeedImage = async (
order_number: number; order_number: number;
}> => { }> => {
const initData = getInitData(); const initData = getInitData();
// 🔧 ФИКС (25.09.2026): EMPTY_INIT_DATA_AUTH_HEADER — см. fetchAPI.
if (!initData) {
throw new Error(
'Telegram initData недоступен. Откройте приложение через Telegram.'
);
}
const url = `${API_BASE}/admin/feed/upload-image`; const url = `${API_BASE}/admin/feed/upload-image`;
// Определяем имя с правильным расширением // Определяем имя с правильным расширением
+7 -1
View File
@@ -89,7 +89,13 @@ export const polishAlphabet: AlphabetLetter[] = [
}, },
{ {
upper: "Ł", lower: "ł", upper: "Ł", lower: "ł",
pronunciation_pl: "nosowe 'u'", pronunciation_ru: "у (носовое)", pronunciation_uk: "у (носове)", pronunciation_en: "nasal 'u'", // 🔧 ФИКС (25.09.2026): alphabet_l_wrong_pronunciation —
// Ł произносится как английское [w] (как в "water"), НЕ как носовое "у".
// Мы учили юзеров неправильному произношению — исправлено.
pronunciation_pl: "jak angielskie 'w' (jak w 'water')",
pronunciation_ru: "как английское 'w' (как в 'water')",
pronunciation_uk: "як англійське 'w' (як у 'water')",
pronunciation_en: "like English 'w' (as in 'water')",
example_pl: "łódź", example_ru: "лодка", example_uk: "човен", example_en: "boat" example_pl: "łódź", example_ru: "лодка", example_uk: "човен", example_en: "boat"
}, },
{ {
+7 -5
View File
@@ -98,11 +98,13 @@ export const polishDiacritics: Diacritic[] = [
}, },
{ {
letter: "Ł ł", letter: "Ł ł",
pronunciation: "у (носовое)", // 🔧 ФИКС (25.09.2026): diacritics_l_wrong_description —
description_pl: "Wymawia się jak nosowe 'u', nie jak rosyjskie Л.", // Ł произносится как английское [w] (как в "water"), НЕ как носовое "у".
description_ru: "Произносится как носовое 'у', не как русская Л.", pronunciation: "как англ. 'w'",
description_uk: "Вимовляється як носове 'у', не як російська Л.", description_pl: "Wymawia się jak angielskie 'w' (jak w 'water'), nie jak rosyjskie Л.",
description_en: "Pronounced as a nasal 'u', not like the Russian Л.", description_ru: "Произносится как английское 'w' (как в 'water'), а не как русское Л.",
description_uk: "Вимовляється як англійське 'w' (як у 'water'), а не як російське Л.",
description_en: "Pronounced like English 'w' (as in 'water'), not like Russian Л.",
example_pl: "łódź", example_pl: "łódź",
example_ru: "лодка", example_ru: "лодка",
example_uk: "човен", example_uk: "човен",
+6 -2
View File
@@ -31,8 +31,12 @@ export const useAchievements = () => {
// Берём первый из очереди как active // Берём первый из очереди как active
const next = achievementQueue[0]; const next = achievementQueue[0];
setActiveAchievement(next); setActiveAchievement(next);
// Убираем его из очереди // 🔧 ФИКС (25.09.2026): achievement_filter_removes_duplicates —
setAchievementQueue(prev => prev.filter(a => a.id !== next.id || a.icon !== next.icon || a.name !== next.name)); // раньше фильтр сравнивал по id/icon/name и удалял ОБА одинаковых
// элемента очереди (текущий и такой же по содержанию). Если одно
// достижение попадало в очередь дважды — второе не показывалось.
// Теперь удаляем строго по ссылке на объект: prev.filter(a => a !== next).
setAchievementQueue(prev => prev.filter(a => a !== next));
// Таймаут: через 3 сек снимаем active // Таймаут: через 3 сек снимаем active
if (achievementTimeoutRef.current) clearTimeout(achievementTimeoutRef.current); if (achievementTimeoutRef.current) clearTimeout(achievementTimeoutRef.current);