Commit Graph
32 Commits
Author SHA1 Message Date
Drobysh 80b7f6b419 feat(admin_wordsearch): exclude_maxed_words — не отдавать слова с usage_count >= 5
Слова, использованные в 5+ уровнях, «выгорают» — больше не возвращаются
в конструктор. Админ не может случайно повторно использовать слово.

- get_csv_words: WHERE COALESCE(u.usage_count, 0) < 5
- Хардкод 5 = MAX_USAGE_COUNT (в будущем — в константу)
2026-10-03 17:20:28 +00:00
Drobysh 98ac403675 feat(admin): уроки + AI-помощник + повторы + отчёт по теме
Backend:
- admin_ai.py: POST /admin/ai/chat + /admin/ai/translate (DeepSeek V4 Pro 0813)
  * rate limit 60/час, reasoning отключён, context support
  * перевод на 4 языка через JSON mode
- admin_content.py: CRUD уроков/тем + генератор теста
  * GET /lessons/tree — дерево уровней/тем/уроков
  * POST /lessons/topic — создание темы
  * POST /lessons/lesson — создание урока (транзакция)
  * DELETE /lessons/lesson/{id} — каскадное удаление
  * GET /lessons/topic/{id}/questions — вопросы для генератора
  * POST /lessons/test/generate — генерация теста с перемешиванием
  * POST /lessons/lesson/{id}/add-question — добавление вопроса в edit-режиме
- learning.py: attempt_number + revised + revision_of_id
  * show_correct_answer с 3-й попытки
  * session/complete возвращает report (percent, message, weak_skills, next_topic)
- learning_data/__init__.py: seed только при пустой БД
  * SEED_LEARNING_DATA=true для принудительной перезаливки
- main.py: подключение admin_ai router
- database.py: миграция revised + revision_of_id
2026-10-02 12:47:56 +00:00
Drobysh 8c46a78aed feat(feed): /admin/feed/stats — счётчики для бейджа черновиков
- total / drafts / published / pinned одним запросом
- COUNT(*) FILTER — быстро, без N+1
- Нужно для бейджа в сайдбаре админки
2026-10-01 17:37:40 +00:00
Drobysh 75b10c536b fix(hints): word_list не расходует лимит подсказок 2026-10-01 11:43:29 +00:00
Drobysh daa79dd43e feat: last_completed_by_level (per-level прогресс) + полный total_score + пагинация 2026-09-30 17:49:09 +00:00
Drobysh aebeaa833f feat: пагинация /words/all + /texts/all + CRUD текстов + глобальные дубликаты 2026-09-30 16:57:54 +00:00
Drobysh 0755533ae1 feat: пагинация для /words/all + GET texts/all + DELETE text + глобальные дубликаты 2026-09-30 16:46:28 +00:00
Drobysh 7bbce67cc4 feat(words): единый источник csv_words + CRUD + глобальная проверка дубликатов 2026-09-30 12:35:43 +00:00
Drobysh 6d0d1b5001 feat(words): единый источник csv_words — wordquiz, bubblewords, pronunciation + CRUD 2026-09-30 12:17:15 +00:00
Drobysh 2d82d615c7 fix(wordsearch): json.dumps для JSONB + usage_count reflect current levels 2026-09-30 09:53:58 +00:00
Drobysh 247eca55d1 fix(wordsearch): JSONB-строка → JSON.parse в admin_wordsearch + фронт 2026-09-30 09:35:15 +00:00
Drobysh 7dbfcbe760 feat(wordsearch): конструктор уровней + csv_words + word_usage + приоритет ручных в игре 2026-09-29 15:31:13 +00:00
Drobysh c4814d8442 refactor(lectures): упрощена модель — уровень+язык+файл, admin/list + preview 2026-09-27 10:35:03 +00:00
Drobysh 453db5b91c 🔐 Admin auth + Lectures backend
Новое:
- routers/admin_auth.py — JWT-логин для админки
- auth.py — двухрежимная авторизация (X-Admin-Token + Telegram)
- config.py — ADMIN_LOGIN, ADMIN_PASSWORD_HASH, ADMIN_JWT_SECRET,
              FRONTEND_ORIGINS (admin.filwordspl.com), ADMIN_TOKEN_USER_ID
- main.py — CORS для admin-домена, X-Admin-Token в allow_headers
- routers/lectures.py — 6 эндпоинтов для лекций (PDF/HTML)
- database.py — таблица lectures
- smoke_test_report.md — отчёт робота
2026-09-27 07:54:32 +00:00
Drobysh f7859783d3 📄 Lectures: backend для раздела «Обучение»
Новое:
- Таблица lectures (PDF/HTML, привязка к уровню, скачивание)
- routers/lectures.py — 6 эндпоинтов:
  - GET  /learning/lectures?level=A1 — список
  - GET  /learning/lecture/{id} — метаданные
  - GET  /learning/lecture/{id}/download — скачать файл
  - POST /admin/lectures/upload — загрузить (multipart)
  - PUT  /admin/lectures/{id} — редактировать
  - DELETE /admin/lectures/{id} — удалить
- Регистрация роутера в main.py
- Миграция в database.py::init_db()

Проверено: GET /learning/lectures → 200, {level:A1, lectures:[]}
2026-09-26 16:46:29 +00:00
Drobysh f7a4bf5c71 🌊 Волна 23: быстрые фиксы (N+1, индексы, rate limiter, options)
- admin_content get_word_levels: 12 запросов → 1 GROUP BY
- admin_content update_lesson: валидация >26 options (option_key overflow)
- database.py: удалены дубли индексов levels/sentences
- main.py RateLimiter._cleanup: использует max(window) из limits

Аудит v10: быстрые фиксы
2026-09-25 18:07:09 +00:00
Drobysh eda9bbd92c 🔧 ФИКС: completed/already_completed не путают подсказку с завершением
Проблема: hints.py создаёт строку user_progress с score=0,
completed_at=NULL (пометка о подсказке). Но:
- get_level: completed = progress is not None → показывал 'Уже пройдено!'
- complete_level: already_completed = True при любой строке →
  last_completed_level НЕ обновлялся → следующие уровни недоступны

Фикс: completed / already_completed = completed_at IS NOT NULL
ИЛИ score > 0. Строка от подсказки больше не считается пройденным уровнем.
2026-09-25 17:47:44 +00:00
Drobysh 6ce33b0ce1 🌊 Волна 21: backend — 4 фикса (сессии, hints, complete_level)
- start_session: реальный level_code из learning_topics (не доверяем клиенту)
- teacher_answer: проверка владельца сессии (user_id)
- hints.py: UPSERT вместо UPDATE (лимит 3 подсказки для новых юзеров)
- game.py complete_level: ON CONFLICT DO UPDATE (не падаем с unique violation,
  если юзер брал подсказку → строка user_progress уже есть)

Аудит v10 backend: критичные фиксы
2026-09-25 17:08:46 +00:00
Drobysh 555bf44db2 🌊 Волна 19: backend — 6 фиксов (hints + N+1 + logger) 2026-09-25 10:09:13 +00:00
Drobysh 3d75a00046 🌊 Волна 17: backend #8 — баги + N+1 (16 багов)
Продуктовые:
- hint_consumed_before_word_check: сначала проверка слов, потом инкремент (hints.py)
- hint_fake_first_cell: 404 вместо [0,0] (hints.py)
- leaderboard_rank_wrong_for_uncached_user: корректный rank (leaderboard.py)
- teacher_ai_explanation_empty_on_failure: fallback-текст (teacher.py)

Данные:
- duplicate_delete_keeps_wrong_row: оставляем лучшую строку (database.py)

Security:
- fastapi_docs_exposed: /docs скрыт в проде (main.py)
- cf_ip_check_per_request: предкомпиляция CF_IPS (main.py)

N+1:
- admin_content_lesson_levels_n_plus_1: 3 GROUP BY (admin_content.py)
- admin_content_lesson_topics_n_plus_1: 2 GROUP BY (admin_content.py)
- admin_content_get_lesson_n_plus_1: ANY + группировка (admin_content.py)
- teacher_progress_n_plus_1: 2 GROUP BY (teacher.py)
- teacher_diagnostic_test_n_plus_1: ANY + группировка (teacher.py)
- orchestrator_n_plus_1_options: ANY + группировка (orchestrator.py)

Качество:
- cleanup_task_leak_on_startup_failure: cleanup после init (main.py)
- unused_first_name: удалена мёртвая переменная (auth.py)

Пропущено осознанно:
- initdata_in_query_param (fallback deleteFeedPost)
- init_db_slow_startup (Alembic, отдельная задача)

Аудит v5: Issue #8, backend 16/17 задач
2026-09-24 17:35:14 +00:00
Drobysh 4152b4b2c4 🌊 Волна 14: backend #6 — security + БД (8 багов + бонус)
Security:
- cf_connecting_ip_spoof: whitelist CF_IPS, доверие только от Cloudflare (config.py + main.py)

БД:
- get_pool_race: asyncio.Lock вокруг create_pool (database.py)
- init_db_no_transaction: обёрнут в conn.transaction() (database.py)
- drop_constraint_cascade: убран CASCADE (database.py)
- add_pk_on_duplicates: DELETE дублей перед ADD PK (database.py)
- redundant_index_users_telegram: удалены дубли индексов (database.py)
- fstring_sql_migration: whitelist regex (database.py)

Качество:
- cleanup_task_not_cancelled: cancel в shutdown (main.py)

Бонус:
- removed_images: обработка удалённых картинок в feed.py (TODO из v1)

Пропущено осознанно:
- matview_if_not_exists_stale (Alembic, отдельно)
- initdata_in_query_param (fallback для deleteFeedPost)

Аудит v3: Issue #6, backend 8/10 задач
2026-09-24 15:43:13 +00:00
Drobysh 742337fb14 🌊 Волна 11: backend N+1 + метрики (5 багов)
- online_now_counts_all_today_logins: убрана ветка daily_logins, фильтр 30 мин (admin.py)
- assistant_personal_stats_n_plus_1: 36 → 6 запросов через GROUP BY (assistant.py)
- learning_get_lesson_n_plus_1: ANY + группировка options, + get_topic_test (learning.py)
- feed_attachment_order_collision: MAX(order_number)+1 + UNIQUE (feed.py + database.py)
- admin_content_summary_n_plus_1: 30 → 6 запросов через GROUP BY (admin_content.py)

Аудит v2: Issue #5, backend 10/10 задач — закрыто!
2026-09-24 09:31:13 +00:00
Drobysh e9ebaf3351 🌊 Волна 10: backend client-controlled + лимиты (5 багов)
- client_controlled_hints_game: hints_used из user_progress (game.py + database.py)
- client_controlled_hints_bubblewords: current_hints_used из bubble_words_progress (bubblewords.py + database.py)
- client_controlled_mistakes_wordquiz: current_mistakes из word_quiz_progress (wordquiz.py + database.py)
- sentence_hint_no_limit: таблица sentence_hints_used + лимит 1 раз (sentences.py + database.py)
- typing_hint_no_limit: таблица typing_hints_used + лимит 1 раз (typing.py + database.py)

Аудит v2: Issue #5, backend 5/10 задач
2026-09-24 08:58:02 +00:00
Drobysh 037b340cee 🌊 Волна 9: серверный perfect_streak + rate limiter doc (2 бага)
- client_controlled_achievement_values: current_streak в user_progress,
  сервер считает streak в check_word, complete_level читает из БД
  (game.py + database.py)
- inmemory_rate_limiter: docstring + TODO на Redis (main.py)
  Сейчас воркер один — проблема неактуальна.

Аудит: Issue #4, backend 2/20 задач
2026-09-23 15:45:56 +00:00
Drobysh 6a870e691b 🌊 Волна 8: backend качество (4 бага)
- admin_level_counts_n_plus_1: один GROUP BY вместо 6 запросов (admin.py)
- duplicate_index_typing_progress: удалён дубль индекса (database.py)
- teacher_create_table_on_every_request: DDL в init_db (teacher.py + database.py)
- on_event_deprecated: lifespan-контекст (main.py)

drop_matview_on_startup + leaderboard_refresh_30s — уже в Волне 1.

Аудит: Issue #4, backend 4/20 задач
2026-09-23 15:27:37 +00:00
Drobysh 26629fc2ae 🔧 Fix indentation in hints.py (регрессия Волны 1)
Блок с инкрементом hints_used потерял отступ при вставке —
бэк падал с IndentationError, uvicorn не стартовал.

Восстановлены 8 пробелов внутри async with pool.acquire() as conn
в обоих эндпоинтах (first-letter, word-list).
2026-09-23 12:38:29 +00:00
Drobysh 3922ae2286 🌊 Волна 2: backend дедлоки пула (3 бага)
- achievements_nested_pool_acquire_sentences: вынос check_and_award_achievements
  за пределы async with pool.acquire() (sentences.py)
- achievements_nested_pool_acquire_wordquiz: то же (wordquiz.py)
- achievements_nested_pool_acquire_bubblewords: то же (bubblewords.py)

Паттерн скопирован из game.py (эталон).
Собираем данные внутри блока → закрываем блок → вызываем достижения.

Аудит: Issue #4, backend 3/20 задач
2026-09-23 11:52:11 +00:00
Drobysh f2715b7593 🌊 Волна 1: backend продукты + security (12 багов)
Продуктовые фиксы:
- hints_not_incremented: лимит 3 подсказки теперь работает (hints.py)
- assistant_quota_burned_on_ai_failure: лимит не списывается при ошибке AI (assistant.py)
- learning_save_answer_missing_session_check: 500 → 404 + проверка владельца (learning.py)
- teacher_hardcoded_a1_level: реальный уровень из users вместо 'A1' (teacher.py, 3 места)

Security:
- hardcoded_default_admin: пустой дефолт ADMIN_IDS (config.py)
- double_unquote_initdata: убран повторный unquote (auth.py)
- auth_error_leak: обобщённая ошибка вместо str(e) (auth.py)
- xforwarded_for_spoof: доверяем только cf-connecting-ip (main.py)
- initdata_age_24h: 24ч → 4ч (config.py)

Качество:
- drop_matview_on_startup: убран DROP при рестарте (main.py)
- leaderboard_refresh_30s: 30с → 300с (main.py)
- teacher_create_table_on_every_request: TODO на вынос DDL (teacher.py)

Аудит: Issue #4, backend 12/20 задач
2026-09-23 11:41:26 +00:00
Drobysh 30b3a0f724 feat(content): переделаны темы A1 1-3 по новому промпту (22.09.2026) 2026-09-22 14:17:43 +00:00
Drobysh b0fa43f652 fix(teacher): lesson_id из learning_lessons, безопасный content AI (22.09.2026) 2026-09-22 12:57:40 +00:00
Drobysh 7393e7e82a fix(learning): hint_used читается из body, а не захардкожен (22.09.2026) 2026-09-22 10:33:54 +00:00
Drobysh 033adf023e initial commit (backend) 2026-09-20 11:45:58 +00:00