Files
filwordspl-backend/routers/learning_data/__init__.py
T
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

81 lines
3.8 KiB
Python

"""
Learning Data Package — данные всех уровней.
Каждый уровень в отдельном файле.
🔧 ОБНОВЛЕНО (02.10.2026): seed_data_only_if_empty —
файлы level_*.py остаются в репозитории как АРХИВ,
но при старте бэкенда контент НЕ перезаписывается, если
в БД уже есть данные.
Причины:
- Контент правится через админку → правки в БД.
- Если seed запускать всегда — правки затираются.
- Уровни (learning_levels) гарантированно создаются — они статичны.
Управление:
- Переменная окружения SEED_LEARNING_DATA=true в .env → заливаем файлы.
- По умолчанию false → пропускаем seed, если данные уже есть.
Для fresh install (пустая БД): seed запустится автоматически,
т.к. проверка «learning_topics пуст» проходит.
"""
import logging
import os
from database import get_pool
from . import level_a1, level_a2, level_b1, level_b2, level_c1, level_c2
logger = logging.getLogger(__name__)
async def init_learning_data():
"""Инициализирует уровни и (опционально) контент из файлов."""
pool = await get_pool()
async with pool.acquire() as conn:
# ============ УРОВНИ (всегда, они статичны) ============
levels = [
("A1", "Poziom A1", "Уровень A1", "Рівень A1", "Level A1", 1),
("A2", "Poziom A2", "Уровень A2", "Рівень A2", "Level A2", 2),
("B1", "Poziom B1", "Уровень B1", "Рівень B1", "Level B1", 3),
("B2", "Poziom B2", "Уровень B2", "Рівень B2", "Level B2", 4),
("C1", "Poziom C1", "Уровень C1", "Рівень C1", "Level C1", 5),
("C2", "Poziom C2", "Уровень C2", "Рівень C2", "Level C2", 6),
]
for code, pl, ru, uk, en, sort in levels:
await conn.execute("""
INSERT INTO learning_levels (code, name_pl, name_ru, name_uk, name_en, sort_order)
VALUES ($1, $2, $3, $4, $5, $6)
ON CONFLICT (code) DO NOTHING
""", code, pl, ru, uk, en, sort)
logger.info("[seed] learning_levels ensured (A1-C2)")
# ============ ПРОВЕРКА: нужен ли seed контента? ============
force_seed = os.getenv("SEED_LEARNING_DATA", "false").lower() == "true"
topics_count = await conn.fetchval("""
SELECT COUNT(*) FROM learning_topics
""") or 0
if topics_count > 0 and not force_seed:
logger.info(
f"[seed] learning_topics not empty ({topics_count} topics) — "
f"skipping content seed. Установи SEED_LEARNING_DATA=true в .env "
f"для принудительной перезаливки."
)
return
# ============ SEED КОНТЕНТА (fresh install ИЛИ force) ============
if force_seed:
logger.warning("[seed] SEED_LEARNING_DATA=true — принудительная перезаливка контента")
else:
logger.info("[seed] Empty DB detected — seeding content from level_*.py files")
await level_a1.init_level_a1(conn)
await level_a2.init_level_a2(conn)
await level_b1.init_level_b1(conn)
await level_b2.init_level_b2(conn)
await level_c1.init_level_c1(conn)
await level_c2.init_level_c2(conn)
logger.info("[seed] Learning content initialized from files")