Upload app.py

app.py

@@ -0,0 +1,272 @@
+"""
+Генератор разноуровневых заданий по информатике (10 класс)
+Интерфейс: Gradio
+Модель: Groq API (Llama 3.3 70B, бесплатно)
+"""
+
+import os
+import json
+import re
+import gradio as gr
+from groq import Groq
+
+try:
+    import spaces  # доступно только внутри HuggingFace Spaces
+except ImportError:
+    # Локальный запуск / среда без пакета spaces — создаём "пустышку",
+    # чтобы декоратор @spaces.GPU ниже не ломал код вне Spaces.
+    class _DummySpaces:
+        @staticmethod
+        def GPU(fn):
+            return fn
+    spaces = _DummySpaces()
+
+# ---------------------------------------------------------------------------
+# Конфигурация
+# ---------------------------------------------------------------------------
+
+# Ключ читается из переменной окружения / Secret на HuggingFace Spaces.
+# Локально можно временно задать через: export GROQ_API_KEY="ваш_ключ"
+# Клиент создаём лениво (внутри функции), чтобы отсутствие ключа
+# не роняло всё приложение при старте, а показывало понятную ошибку в интерфейсе.
+MODEL_NAME = "openai/gpt-oss-120b"
+
+TOPICS = [
+    "Системы счисления и перевод чисел",
+    "Логические основы компьютера (алгебра логики)",
+    "Кодирование текстовой, графической и звуковой информации",
+    "Алгоритмизация и основные алгоритмические конструкции",
+    "Основы программирования на Python",
+    "Массивы и работа с данными",
+    "Файлы и файловая система",
+    "Базы данных: структура и SQL-запросы",
+    "Компьютерные сети и передача данных",
+    "Информационная безопасность",
+    "Моделирование и формализация",
+    "Электронные таблицы: формулы и функции",
+    "Другая тема (ввести вручную)",
+]
+
+LEVEL_LABELS = {
+    "базовый": "🟢 Базовый уровень",
+    "средний": "🟡 Средний уровень",
+    "продвинутый": "🔴 Продвинутый уровень",
+}
+
+SYSTEM_PROMPT_TEMPLATE = """Ты — опытный методист по информатике, разрабатывающий разноуровневые учебные задания для учеников 10 класса. Твоя задача — сгенерировать задания по указанной теме урока в строгом соответствии с параметрами ниже.
+
+ОПРЕДЕЛЕНИЯ УРОВНЕЙ СЛОЖНОСТИ:
+- БАЗОВЫЙ: воспроизведение факта, определения или простого алгоритма. Одно действие, прямое применение изученного правила без дополнительных условий.
+- СРЕДНИЙ: применение знания в новой, но похожей ситуации. Требует 2-3 логических шага, комбинирования известных понятий.
+- ПРОДВИНУТЫЙ: анализ, синтез или обоснование решения в нестандартной ситуации. Требует самостоятельного выбора подхода, объяснения хода рассуждений, работы с неполными данными.
+
+ВХОДНЫЕ ПАРАМЕТРЫ:
+Тема урока: {topic}
+Количество заданий:
+- базовый уровень: {n_basic}
+- средний уровень: {n_medium}
+- продвинутый уровень: {n_advanced}
+
+ТРЕБОВАНИЯ К КАЖДОМУ ЗАДАНИЮ:
+1. Задание должно быть строго по указанной теме, соответствовать программе информатики 10 класса.
+2. Формулировка — чёткая, однозначная, понятная ученику без дополнительных пояснений учителя.
+3. К каждому заданию обязательно приложи:
+   - правильный ответ или чёткий критерий проверки (по чему учитель поймёт, что ответ верный)
+   - краткий методический комментарий (2-3 предложения): что именно проверяет задание и как его использовать на уроке
+4. Не ��овторяй формулировки и контекст между заданиями одного уровня — каждое задание должно проверять разные аспекты темы.
+5. Если для темы нужен код — используй Python и заключай код в тройные обратные кавычки.
+
+ФОРМАТ ОТВЕТА:
+Верни ТОЛЬКО валидный JSON без какого-либо текста до или после, без markdown-разметки вокруг JSON. Структура:
+
+{{
+  "тема": "название темы",
+  "задания": [
+    {{
+      "уровень": "базовый",
+      "задание": "текст задания",
+      "ответ": "правильный ответ или критерий проверки",
+      "комментарий": "методический комментарий"
+    }}
+  ]
+}}
+
+Если количество заданий для какого-то уровня равно 0 — не включай задания этого уровня в массив вообще.
+
+ВАЖНО:
+- Отвечай только на русском языке, без англицизмов и калек с английского.
+- Не придумывай факты, формулы или синтаксис языков программирования, в которых не уверен — если сомневаешься в деталях, выбери более простую и точно проверенную формулировку.
+- Не используй персональные данные учеников или реальных людей в примерах.
+"""
+
+
+# ---------------------------------------------------------------------------
+# Логика генерации
+# ---------------------------------------------------------------------------
+
+def extract_json(raw_text: str) -> dict:
+    """Достаёт JSON из ответа модели, даже если он обёрнут в markdown-блок."""
+    text = raw_text.strip()
+
+    # Убираем возможные ```json ... ``` обёртки
+    fence_match = re.search(r"```(?:json)?\s*(.*?)\s*```", text, re.DOTALL)
+    if fence_match:
+        text = fence_match.group(1).strip()
+
+    # На случай, если модель добавила текст до/после JSON — вырезаем { ... }
+    start = text.find("{")
+    end = text.rfind("}")
+    if start != -1 and end != -1 and end > start:
+        text = text[start:end + 1]
+
+    return json.loads(text)
+
+
+def build_topic(dropdown_value: str, custom_topic: str) -> str:
+    """Определяет итоговую тему: из списка или введённую вручную."""
+    if dropdown_value == "Другая тема (ввести вручную)" or not dropdown_value:
+        topic = custom_topic.strip()
+    else:
+        topic = dropdown_value.strip()
+        if custom_topic.strip():
+            # Если пользователь и выбрал тему, и что-то написал в поле "своя тема" —
+            # приоритет отдаём ручному вводу, так как это явное намерение.
+            topic = custom_topic.strip()
+    return topic
+
+
+def render_level_html(level_key: str, tasks: list) -> str:
+    """Рендерит HTML-блок карточек для одного уровня сложности."""
+    if not tasks:
+        return ""
+
+    label = LEVEL_LABELS.get(level_key, level_key.capitalize())
+    cards = []
+    for i, task in enumerate(tasks, start=1):
+        cards.append(f"""
+        <div style="border:1px solid #e0e0e0; border-radius:10px; padding:16px; margin-bottom:12px; background:#fafafa;">
+            <div style="font-weight:600; margin-bottom:8px; color:#333;">Задание {i}</div>
+            <div style="margin-bottom:10px; white-space:pre-wrap;">{task.get('задание', '—')}</div>
+            <div style="margin-bottom:8px; padding:10px; background:#eef7ee; border-radius:6px;">
+                <b>Ответ / критерий проверки:</b><br>
+                <span style="white-space:pre-wrap;">{task.get('ответ', '—')}</span>
+            </div>
+            <div style="padding:10px; background:#eef2f9; border-radius:6px;">
+                <b>Методический комментарий:</b><br>
+                {task.get('комментарий', '—')}
+            </div>
+        </div>
+        """)
+
+    return f"""
+    <div style="margin-bottom:24px;">
+        <h3 style="margin-bottom:10px;">{label}</h3>
+        {''.join(cards)}
+    </div>
+    """
+
+
+@spaces.GPU
+def generate_tasks(dropdown_value, custom_topic, n_basic, n_medium, n_advanced):
+    topic = build_topic(dropdown_value, custom_topic)
+
+    if not topic:
+        return "<p style='color:red;'>Пожалуйста, укажите тему урока — выберите из списка или введите свою.</p>"
+
+    if n_basic == 0 and n_medium == 0 and n_advanced == 0:
+        return "<p style='color:red;'>Укажите хотя бы одно задание хотя бы на одном уровне.</p>"
+
+    if not os.environ.get("GROQ_API_KEY"):
+        return "<p style='color:red;'>Не найден GROQ_API_KEY. Добавьте ключ в Secrets (HuggingFace Spaces) или переменные окружения.</p>"
+
+    prompt = SYSTEM_PROMPT_TEMPLATE.format(
+        topic=topic,
+        n_basic=n_basic,
+        n_medium=n_medium,
+        n_advanced=n_advanced,
+    )
+
+    try:
+        client = Groq(api_key=os.environ.get("GROQ_API_KEY"))
+        response = client.chat.completions.create(
+            model=MODEL_NAME,
+            messages=[
+                {"role": "system", "content": prompt},
+                {"role": "user", "content": f"Сгенерируй задания по теме: {topic}"},
+            ],
+            temperature=0.7,
+            max_tokens=3000,
+        )
+        raw_output = response.choices[0].message.content
+    except Exception as e:
+        return f"<p style='color:red;'>Ошибка при обращении к модели: {e}</p>"
+
+    try:
+        data = extract_json(raw_output)
+    except (json.JSONDecodeError, ValueError):
+        # Фолбэк: показываем как есть, чтобы не терять результат работы модели
+        safe_text = raw_output.replace("<", "&lt;").replace(">", "&gt;")
+        return f"""
+        <p style='color:#b8860b;'>Не удалось разобрать ответ модели как JSON.
+        Показан необработанный результат:</p>
+        <pre style='white-space:pre-wrap; background:#f5f5f5; padding:12px; border-radius:8px;'>{safe_text}</pre>
+        """
+
+    tasks = data.get("задания", [])
+    by_level = {"базовый": [], "средний": [], "продвинутый": []}
+    for t in tasks:
+        level = t.get("уровень", "").strip().lower()
+        if level in by_level:
+            by_level[level].append(t)
+
+    html_parts = [f"<h2>Тема: {data.get('тема', topic)}</h2>"]
+    for level_key in ["базовый", "средний", "продвинутый"]:
+        html_parts.append(render_level_html(level_key, by_level[level_key]))
+
+    if not tasks:
+        html_parts.append("<p style='color:red;'>Модель не вернула ни одного задания. Попробуйте ещё раз.</p>")
+
+    return "".join(html_parts)
+
+
+# ---------------------------------------------------------------------------
+# Интерфейс Gradio
+# ---------------------------------------------------------------------------
+
+with gr.Blocks(title="Генератор разноуровневых заданий") as demo:
+    gr.Markdown("""
+    # 🎓 Генератор разноуровневых заданий
+    ### Информатика, 10 класс
+    Выберите тему (или введите свою), укажите количество заданий на каждый уровень сложности — и получите готовый комплект с ответами и методическими комментариями.
+    """)
+
+    with gr.Row():
+        with gr.Column(scale=1):
+            topic_dropdown = gr.Dropdown(
+                choices=TOPICS,
+                label="Тема урока",
+                value=TOPICS[0],
+            )
+            custom_topic_input = gr.Textbox(
+                label="Своя тема (если нужна тема не из списка — впишите здесь)",
+                placeholder="Например: Рекурсивные алгоритмы",
+            )
+
+            gr.Markdown("**Количество заданий по уровням:**")
+            n_basic = gr.Slider(0, 5, value=2, step=1, label="🟢 Базовый уровень")
+            n_medium = gr.Slider(0, 5, value=2, step=1, label="🟡 Средний уровень")
+            n_advanced = gr.Slider(0, 5, value=1, step=1, label="🔴 Продвинутый уровень")
+
+            generate_btn = gr.Button("Сгенерировать задания", variant="primary")
+
+        with gr.Column(scale=2):
+            output_html = gr.HTML(label="Результат")
+
+    generate_btn.click(
+        fn=generate_tasks,
+        inputs=[topic_dropdown, custom_topic_input, n_basic, n_medium, n_advanced],
+        outputs=output_html,
+    )
+
+if __name__ == "__main__":
+    demo.launch()