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
This commit is contained in:
@@ -0,0 +1,322 @@
|
||||
"""
|
||||
Admin AI Router — универсальный AI-помощник в админке.
|
||||
|
||||
🔧 НОВОЕ (02.10.2026): floating AI widget в admin frontend.
|
||||
|
||||
Использует DeepSeek V4 Pro 0813 через Together AI:
|
||||
- Модель: deepseek-ai/DeepSeek-V4-Pro-0813
|
||||
- Reasoning: отключён для скорости (можно включить через body)
|
||||
- Rate limit: 60 запросов/час на админа
|
||||
"""
|
||||
import logging
|
||||
import time
|
||||
from collections import defaultdict
|
||||
from typing import Optional
|
||||
|
||||
import httpx
|
||||
from fastapi import APIRouter, Request, HTTPException
|
||||
from auth import require_auth
|
||||
from config import TOGETHER_API_KEY, ADMIN_IDS
|
||||
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
router = APIRouter(prefix="/admin/ai", tags=["admin-ai"])
|
||||
|
||||
TOGETHER_API_URL = "https://api.together.xyz/v1/chat/completions"
|
||||
|
||||
# 🔧 НОВОЕ (02.10.2026): DeepSeek V4 Pro — flagship, 1M контекст, 30+ языков
|
||||
DEFAULT_MODEL = "deepseek-ai/DeepSeek-V4-Pro-0813"
|
||||
|
||||
# In-memory rate limit (60/час на юзера)
|
||||
_admin_ai_usage: dict[int, list[float]] = defaultdict(list)
|
||||
_ADMIN_AI_RATE_LIMIT = 60
|
||||
_ADMIN_AI_RATE_WINDOW = 3600 # 1 час
|
||||
|
||||
|
||||
DEFAULT_SYSTEM_PROMPT = """Ты — помощник преподавателя польского языка в приложении Filwords PL (Telegram Mini App для изучения польского).
|
||||
|
||||
Помогаешь создавать учебный контент:
|
||||
- Задания для уроков (recognition — выбор варианта A/B/C/D)
|
||||
- Дистракторы (неправильные, но похожие по смыслу варианты)
|
||||
- Переводы на польский, русский, украинский, английский
|
||||
- Грамматические пояснения
|
||||
|
||||
ПРАВИЛА:
|
||||
1. Отвечай на языке пользователя (по умолчанию — русский).
|
||||
2. Не используй markdown. Просто текст.
|
||||
3. Для заданий-recognition: дай РОВНО 4 варианта (A, B, C, D).
|
||||
4. Один вариант — правильный (отметь явно).
|
||||
5. Три других — похожие по смыслу (та же часть речи, тот же контекст).
|
||||
6. Указывай wrong_because для неправильных: wrong_word, wrong_case, wrong_context, wrong_gender, wrong_sentence_type, wrong_translation.
|
||||
7. Если просят перевод — дай на все 4 языка (PL, RU, UK, EN).
|
||||
8. Если просят контекст из БД — используй его, не выдумывай."""
|
||||
|
||||
|
||||
def _check_rate_limit(user_id: int) -> bool:
|
||||
"""Проверка: не превысил ли админ лимит."""
|
||||
now = time.time()
|
||||
# Чистим старые записи
|
||||
_admin_ai_usage[user_id] = [
|
||||
t for t in _admin_ai_usage[user_id]
|
||||
if now - t < _ADMIN_AI_RATE_WINDOW
|
||||
]
|
||||
return len(_admin_ai_usage[user_id]) < _ADMIN_AI_RATE_LIMIT
|
||||
|
||||
|
||||
def _increment_usage(user_id: int) -> None:
|
||||
_admin_ai_usage[user_id].append(time.time())
|
||||
|
||||
|
||||
@router.post("/chat")
|
||||
async def admin_ai_chat(request: Request):
|
||||
"""
|
||||
🔧 НОВОЕ (02.10.2026): admin_ai_chat —
|
||||
универсальный AI-помощник в админке.
|
||||
|
||||
Тело:
|
||||
{
|
||||
"message": "Придумай 4 варианта к заданию: ...",
|
||||
"system_prompt": "опционально, переопределить дефолт",
|
||||
"model": "deepseek-ai/DeepSeek-V4-Pro-0813", // опционально
|
||||
"reasoning": false, // опционально, по умолчанию false
|
||||
"context": "опционально, длинный контекст" // например, вся тема целиком
|
||||
}
|
||||
|
||||
Возвращает:
|
||||
{
|
||||
"response": "...",
|
||||
"model_used": "deepseek-ai/DeepSeek-V4-Pro-0813",
|
||||
"tokens_used": 123
|
||||
}
|
||||
"""
|
||||
telegram_id, _ = await require_auth(request)
|
||||
|
||||
if telegram_id not in ADMIN_IDS:
|
||||
raise HTTPException(403, "Access denied")
|
||||
|
||||
if not _check_rate_limit(telegram_id):
|
||||
raise HTTPException(429, f"Rate limit exceeded ({_ADMIN_AI_RATE_LIMIT}/hour)")
|
||||
|
||||
if not TOGETHER_API_KEY:
|
||||
raise HTTPException(500, "TOGETHER_API_KEY not configured")
|
||||
|
||||
body = await request.json()
|
||||
message = (body.get("message") or "").strip()
|
||||
system_prompt = (body.get("system_prompt") or "").strip() or DEFAULT_SYSTEM_PROMPT
|
||||
model = (body.get("model") or "").strip() or DEFAULT_MODEL
|
||||
reasoning_enabled = bool(body.get("reasoning", False))
|
||||
context = (body.get("context") or "").strip()
|
||||
|
||||
if not message:
|
||||
raise HTTPException(400, "message is required")
|
||||
|
||||
if len(message) > 4000:
|
||||
raise HTTPException(400, "message too long (max 4000)")
|
||||
|
||||
# Собираем user content: context + message
|
||||
user_content = message
|
||||
if context:
|
||||
user_content = f"Контекст из БД:\n{context}\n\nЗадача:\n{message}"
|
||||
|
||||
# Отправляем в Together
|
||||
try:
|
||||
async with httpx.AsyncClient(timeout=120.0) as client:
|
||||
response = await client.post(
|
||||
TOGETHER_API_URL,
|
||||
headers={
|
||||
"Authorization": f"Bearer {TOGETHER_API_KEY}",
|
||||
"Content-Type": "application/json",
|
||||
},
|
||||
json={
|
||||
"model": model,
|
||||
"messages": [
|
||||
{"role": "system", "content": system_prompt},
|
||||
{"role": "user", "content": user_content},
|
||||
],
|
||||
"max_tokens": 2000,
|
||||
"temperature": 1.0, # 🔧 DeepSeek рекомендует 1.0
|
||||
"reasoning": {"enabled": reasoning_enabled},
|
||||
},
|
||||
)
|
||||
except httpx.TimeoutException:
|
||||
raise HTTPException(504, "AI timeout (120s)")
|
||||
|
||||
if response.status_code != 200:
|
||||
logger.error(f"[admin_ai] Together error: {response.status_code} {response.text[:300]}")
|
||||
raise HTTPException(500, f"AI error: {response.status_code}")
|
||||
|
||||
data = response.json()
|
||||
|
||||
# Извлекаем ответ
|
||||
try:
|
||||
message_obj = data["choices"][0]["message"]
|
||||
ai_response = message_obj.get("content") or message_obj.get("reasoning_content") or ""
|
||||
except (KeyError, IndexError, TypeError) as e:
|
||||
logger.error(f"[admin_ai] parse error: {e}")
|
||||
raise HTTPException(500, "AI returned invalid response")
|
||||
|
||||
if not ai_response:
|
||||
raise HTTPException(500, "AI returned empty response")
|
||||
|
||||
# Считаем токены
|
||||
usage = data.get("usage", {})
|
||||
tokens_used = usage.get("total_tokens", 0)
|
||||
|
||||
_increment_usage(telegram_id)
|
||||
|
||||
logger.info(
|
||||
f"[admin_ai] user={telegram_id} model={model} tokens={tokens_used}"
|
||||
)
|
||||
|
||||
return {
|
||||
"response": ai_response.strip(),
|
||||
"model_used": model,
|
||||
"tokens_used": tokens_used,
|
||||
}
|
||||
|
||||
|
||||
@router.post("/translate")
|
||||
async def admin_ai_translate(request: Request):
|
||||
"""
|
||||
🔧 НОВОЕ (02.10.2026): admin_ai_translate —
|
||||
перевод текста на 4 языка (PL, RU, UK, EN).
|
||||
|
||||
Тело:
|
||||
{
|
||||
"text": "Podstawowe powitania",
|
||||
"source_lang": "pl",
|
||||
"target_langs": ["ru", "uk", "en"] // опционально, по умолчанию все кроме source
|
||||
}
|
||||
|
||||
Возвращает:
|
||||
{
|
||||
"translations": {"ru": "...", "uk": "...", "en": "..."},
|
||||
"source_lang": "pl"
|
||||
}
|
||||
"""
|
||||
telegram_id, _ = await require_auth(request)
|
||||
|
||||
if telegram_id not in ADMIN_IDS:
|
||||
raise HTTPException(403, "Access denied")
|
||||
|
||||
if not _check_rate_limit(telegram_id):
|
||||
raise HTTPException(429, f"Rate limit exceeded ({_ADMIN_AI_RATE_LIMIT}/hour)")
|
||||
|
||||
if not TOGETHER_API_KEY:
|
||||
raise HTTPException(500, "TOGETHER_API_KEY not configured")
|
||||
|
||||
body = await request.json()
|
||||
text = (body.get("text") or "").strip()
|
||||
source_lang = (body.get("source_lang") or "pl").strip().lower()
|
||||
target_langs = body.get("target_langs") or ["ru", "uk", "en"]
|
||||
|
||||
if not text:
|
||||
raise HTTPException(400, "text is required")
|
||||
|
||||
if len(text) > 3000:
|
||||
raise HTTPException(400, "text too long (max 3000)")
|
||||
|
||||
if source_lang not in ("pl", "ru", "uk", "en"):
|
||||
raise HTTPException(400, f"Invalid source_lang: {source_lang}")
|
||||
|
||||
# Валидация target_langs
|
||||
valid_langs = {"pl", "ru", "uk", "en"}
|
||||
target_langs = [l for l in target_langs if l in valid_langs and l != source_lang]
|
||||
|
||||
if not target_langs:
|
||||
raise HTTPException(400, "No valid target_langs")
|
||||
|
||||
lang_names = {
|
||||
"pl": "Polish", "ru": "Russian", "uk": "Ukrainian", "en": "English",
|
||||
}
|
||||
|
||||
source_name = lang_names[source_lang]
|
||||
targets_str = ", ".join([f'"{l}": "{lang_names[l]}"' for l in target_langs])
|
||||
|
||||
system_prompt = f"""Ты — переводчик. Переведи текст с {source_name} на указанные языки.
|
||||
|
||||
Верни СТРОГО JSON (без markdown, без пояснений) в формате:
|
||||
{{
|
||||
{targets_str}
|
||||
}}
|
||||
|
||||
ПРАВИЛА:
|
||||
- Переводи ТОЧНО, сохраняя смысл и стиль.
|
||||
- Для терминов и названий — используй общепринятые варианты.
|
||||
- Если текст — название урока/темы, переводи как название (с заглавной буквы).
|
||||
- Если текст — объяснение, сохраняй переносы строк и форматирование.
|
||||
- Не добавляй ничего кроме JSON."""
|
||||
|
||||
user_prompt = f"Текст для перевода:\n{text}"
|
||||
|
||||
try:
|
||||
async with httpx.AsyncClient(timeout=60.0) as client:
|
||||
response = await client.post(
|
||||
TOGETHER_API_URL,
|
||||
headers={
|
||||
"Authorization": f"Bearer {TOGETHER_API_KEY}",
|
||||
"Content-Type": "application/json",
|
||||
},
|
||||
json={
|
||||
"model": DEFAULT_MODEL,
|
||||
"messages": [
|
||||
{"role": "system", "content": system_prompt},
|
||||
{"role": "user", "content": user_prompt},
|
||||
],
|
||||
"max_tokens": 1500,
|
||||
"temperature": 0.3, # Для перевода — низкая
|
||||
"reasoning": {"enabled": False},
|
||||
},
|
||||
)
|
||||
except httpx.TimeoutException:
|
||||
raise HTTPException(504, "AI timeout")
|
||||
|
||||
if response.status_code != 200:
|
||||
logger.error(f"[admin_ai] translate error: {response.status_code} {response.text[:300]}")
|
||||
raise HTTPException(500, f"AI error: {response.status_code}")
|
||||
|
||||
data = response.json()
|
||||
|
||||
try:
|
||||
message_obj = data["choices"][0]["message"]
|
||||
raw = (message_obj.get("content") or "").strip()
|
||||
except (KeyError, IndexError, TypeError):
|
||||
raise HTTPException(500, "AI returned invalid response")
|
||||
|
||||
# Парсим JSON (снимаем ```json ... ``` если AI обернул)
|
||||
import re as _re
|
||||
import json as _json
|
||||
|
||||
if raw.startswith("```"):
|
||||
raw = _re.sub(r'^```(?:json)?\s*', '', raw)
|
||||
raw = _re.sub(r'\s*```$', '', raw)
|
||||
|
||||
json_match = _re.search(r'\{.*\}', raw, _re.DOTALL)
|
||||
if not json_match:
|
||||
logger.error(f"[admin_ai] no JSON in response: {raw[:200]}")
|
||||
raise HTTPException(500, "AI returned no JSON")
|
||||
|
||||
try:
|
||||
parsed = _json.loads(json_match.group(0))
|
||||
except _json.JSONDecodeError as e:
|
||||
logger.error(f"[admin_ai] JSON parse error: {e}, raw={raw[:300]}")
|
||||
raise HTTPException(500, "AI returned invalid JSON")
|
||||
|
||||
translations = {}
|
||||
for lang in target_langs:
|
||||
value = parsed.get(lang, "")
|
||||
translations[lang] = str(value).strip() if value else ""
|
||||
|
||||
tokens_used = data.get("usage", {}).get("total_tokens", 0)
|
||||
_increment_usage(telegram_id)
|
||||
|
||||
logger.info(
|
||||
f"[admin_ai] translate user={telegram_id} "
|
||||
f"{source_lang} → {target_langs} tokens={tokens_used}"
|
||||
)
|
||||
|
||||
return {
|
||||
"translations": translations,
|
||||
"source_lang": source_lang,
|
||||
"tokens_used": tokens_used,
|
||||
}
|
||||
Reference in New Issue
Block a user