🌊 Волна 7: frontend качество кода (8 багов)

Типизация:
- untyped_any_in_useLocalized: generic <T extends Record<string, unknown>> (useLocalized.ts)
- ANY_TYPES_IN_API + MISSING_RETURN_TYPES: интерфейсы для критичных функций (api.ts)
- SENTRY_ERROR_FIELD_IN_SUCCESS: разделение success/error (api.ts)

Производительность:
- context_value_not_memoized: useMemo + useCallback (LanguageContext.tsx)

Логика:
- TESTVIEW_SAVEANSWER_MISSING_PARAMS: единая сигнатура saveAnswer (TestViewPage.tsx)
- LESSON_HARDCODED_SKILL_TAG: optionsLanguage вместо хардкода (LessonViewPage.tsx)
- silent_error_swallow_setLanguage: логирование ошибки (LanguageContext.tsx)

Аудит: Issue #3, frontend 8/34 задач
This commit is contained in:
2026-09-23 18:09:47 +03:00
parent 97541e78ec
commit 10f5559176
5 changed files with 237 additions and 45 deletions
+181 -30
View File
@@ -7,6 +7,173 @@ const API_BASE = 'https://api.filwordspl.com';
// запрос висел бесконечно, UI оставался в состоянии загрузки.
const FETCH_TIMEOUT_MS = 15000;
// ============ 🔧 ТИПЫ ОТВЕТОВ (23.09.2026) ============
// Fix: ANY_TYPES_IN_API + MISSING_RETURN_TYPES + SENTRY_ERROR_FIELD_IN_SUCCESS
export interface Achievement {
code: string;
icon: string;
name: string;
}
export interface GameProgress {
last_completed_level: number;
total_score: number;
current_level?: string;
}
export interface GameLevel {
level: {
id: number;
level_number: number;
grid_size: number;
grid_letters: string[][];
word_paths: Record<string, [number, number][]>;
level: string;
};
words: Array<{ word_pl: string; translation: string }>;
progress: {
completed: boolean;
hints_used: number;
score: number;
};
}
export interface CheckWordResponse {
status: string;
found: boolean;
word?: string;
new_achievements?: Achievement[];
}
export interface CompleteLevelResponse {
status: string;
score: number;
already_completed: boolean;
new_achievements?: Achievement[];
}
export interface NextSentenceResponse {
completed?: boolean;
message?: string;
id?: number;
sentence_number?: number;
words?: string[];
correct_words?: string[];
translation?: string;
difficulty?: number;
level?: string;
}
export interface CheckSentenceResponse {
correct: boolean;
correct_words?: string[];
already_completed?: boolean;
score?: number;
completed_at?: string;
new_achievements?: Achievement[];
error?: string;
}
export interface NextQuizResponse {
correct_polish: string;
translation: string;
options: string[];
difficulty: string;
}
export interface CheckQuizResponse {
correct: boolean;
score?: number;
correct_streak: number;
new_achievements?: Achievement[];
consolation_score?: number;
error?: string;
}
export interface BubbleLevelResponse {
words: Array<{ word_pl: string; translation: string; parts: string[] }>;
bubbles: Array<{ text: string; word_pl: string }>;
level: number;
}
export interface CompleteBubbleResponse {
status: string;
score: number;
completion_time?: number;
new_achievements?: Achievement[];
}
export interface LearningLevel {
code: string;
name_pl: string;
name_ru: string;
name_uk: string;
name_en: string;
sort_order: number;
is_active: boolean;
}
export interface LearningLevelsResponse {
levels: LearningLevel[];
}
export interface AchievementListItem {
id: number;
code: string;
category: string;
icon: string;
name_pl: string;
name_ru: string;
name_uk: string;
name_en: string;
description_pl: string;
description_ru: string;
description_uk: string;
description_en: string;
unlocked: boolean;
unlocked_at: string | null;
}
export interface AchievementsListResponse {
achievements: AchievementListItem[];
unlocked: number;
total: number;
}
export interface TrackLoginResponse {
status?: string;
new_achievements?: Achievement[];
}
// 🔧 ФИКС (23.09.2026): SENTRY_ERROR_FIELD_IN_SUCCESS —
// разделили success и error-типы. error теперь отдельно, не в success.
export interface SentryError {
id: string;
short_id: string;
title: string;
culprit: string;
level: string;
count: number;
user_count: number;
first_seen: string;
last_seen: string;
permalink: string;
priority: string;
}
export interface SentryErrorsSuccess {
errors: SentryError[];
count?: number;
}
export interface SentryErrorsError {
error: string;
}
export type SentryErrorsResponse = SentryErrorsSuccess | SentryErrorsError;
// ============ FETCH WRAPPER ============
const fetchAPI = async (endpoint: string, options: RequestInit = {}) => {
const initData = getInitData();
@@ -72,40 +239,24 @@ export const getAdminDashboard = (): Promise<{
}> =>
fetchAPI('/admin/dashboard');
export const getSentryErrors = (): Promise<{
errors: Array<{
id: string;
short_id: string;
title: string;
culprit: string;
level: string;
count: number;
user_count: number;
first_seen: string;
last_seen: string;
permalink: string;
priority: string;
}>;
count?: number;
error?: string;
}> =>
export const getSentryErrors = (): Promise<SentryErrorsResponse> =>
fetchAPI('/admin/sentry-errors');
// ============ Прогресс ============
export const fetchProgress = (): Promise<{ last_completed_level: number; total_score: number; current_level?: string }> =>
export const fetchProgress = (): Promise<GameProgress> =>
fetchAPI('/game/progress');
// ============ Игра ============
export const getLevel = (levelNumber: number) =>
export const getLevel = (levelNumber: number): Promise<GameLevel> =>
fetchAPI(`/game/level/${levelNumber}`);
export const checkWord = (levelId: number, cells: number[][]) =>
export const checkWord = (levelId: number, cells: number[][]): Promise<CheckWordResponse> =>
fetchAPI('/game/check-word', {
method: 'POST',
body: JSON.stringify({ level_id: levelId, cells }),
});
export const completeLevel = (levelId: number, hintsUsed: number, completionTime?: number, perfectStreak?: number) =>
export const completeLevel = (levelId: number, hintsUsed: number, completionTime?: number, perfectStreak?: number): Promise<CompleteLevelResponse> =>
fetchAPI('/game/complete-level', {
method: 'POST',
body: JSON.stringify({
@@ -131,10 +282,10 @@ export const getAdminStats = () =>
fetchAPI('/leaderboard/admin/stats');
// ============ Предложения ============
export const getNextSentence = () =>
export const getNextSentence = (): Promise<NextSentenceResponse> =>
fetchAPI('/sentences/next');
export const checkSentence = (sentenceId: number, words: string[], completionTime?: number) =>
export const checkSentence = (sentenceId: number, words: string[], completionTime?: number): Promise<CheckSentenceResponse> =>
fetchAPI('/sentences/check', {
method: 'POST',
body: JSON.stringify({
@@ -148,10 +299,10 @@ export const getSentenceHint = (sentenceId: number) =>
fetchAPI(`/sentences/${sentenceId}/hint`);
// ============ Word Quiz ============
export const getNextQuiz = () =>
export const getNextQuiz = (): Promise<NextQuizResponse> =>
fetchAPI('/wordquiz/next');
export const checkQuizAnswer = (correctPolish: string, answer: string, mistakes: number, completionTime?: number) =>
export const checkQuizAnswer = (correctPolish: string, answer: string, mistakes: number, completionTime?: number): Promise<CheckQuizResponse> =>
fetchAPI('/wordquiz/check', {
method: 'POST',
body: JSON.stringify({
@@ -166,10 +317,10 @@ export const getQuizProgress = () =>
fetchAPI('/wordquiz/progress');
// ============ Bubble Words ============
export const getBubbleLevel = () =>
export const getBubbleLevel = (): Promise<BubbleLevelResponse> =>
fetchAPI('/bubblewords/next');
export const completeBubbleLevel = (hintsUsed: number, wordsCount: number, completionTime?: number) =>
export const completeBubbleLevel = (hintsUsed: number, wordsCount: number, completionTime?: number): Promise<CompleteBubbleResponse> =>
fetchAPI('/bubblewords/complete', {
method: 'POST',
body: JSON.stringify({
@@ -244,7 +395,7 @@ export const getAdminStatsFromAssistant = (): Promise<any> =>
fetchAPI('/assistant/stats/admin');
// ============ Уроки (Learning) ============
export const getLearningLevels = () =>
export const getLearningLevels = (): Promise<LearningLevelsResponse> =>
fetchAPI('/learning/levels');
export const getLearningTopics = (level: string) =>
@@ -314,13 +465,13 @@ export const getTypingProgress = (): Promise<{ total: number; completed: number;
fetchAPI('/typing/progress');
// ============ Достижения ============
export const getAllAchievements = () =>
export const getAllAchievements = (): Promise<AchievementsListResponse> =>
fetchAPI('/achievements');
export const getUserAchievements = () =>
fetchAPI('/achievements/user');
export const trackLogin = () =>
export const trackLogin = (): Promise<TrackLoginResponse> =>
fetchAPI('/achievements/track-login', { method: 'POST' });
export const trackTeacherMenuOpened = () =>