...

app/test_gradio.py

@@ -1,24 +1,22 @@
 import os
+import logging
+import tempfile
+from datetime import datetime
 from dotenv import load_dotenv
 from openai import OpenAI
 import gradio as gr
+from docx import Document
 import requests
-import logging
 from typing import Optional
 
-# Настройка логирования
-logging.basicConfig(
-    level=logging.INFO,
-    format='%(asctime)s - %(levelname)s - %(message)s'
-)
-
-# Загрузка переменных окружения
+# --- Настройка ---
+logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
 load_dotenv()
 api_key = os.getenv("API_KEY_openai")
 client = OpenAI(api_key=api_key) if api_key else None
-VS_ID = os.getenv("VECTOR_STORE_ID", "")
-
+VS_ID = os.getenv("VECTOR_STORE_ID", "")  # vector store for file_search if needed
 
+# --- Утилиты ---
 def upload_to_catbox(file_bytes: bytes) -> str:
     """Загружает файл на catbox.moe и возвращает URL"""
     try:
@@ -31,100 +29,142 @@ def upload_to_catbox(file_bytes: bytes) -> str:
         response.raise_for_status()
         return response.text.strip()
     except Exception as e:
-        logging.error(f"Ошибка загрузки: {e}")
+        logging.error(f"Ошибка загрузки изображения: {e}")
         raise gr.Error("Не удалось загрузить изображение")
 
 
+def generate_docx(text: str) -> str:
+    """Сохраняет текст в .docx и возвращает путь"""
+    doc = Document()
+    for line in text.split("\n"):
+        doc.add_paragraph(line)
+    tmp = tempfile.gettempdir()
+    path = os.path.join(tmp, f"lesson_plan_{datetime.now().strftime('%Y%m%d%H%M%S')}.docx")
+    doc.save(path)
+    return path
+
+# --- Основная функция генерации ---
 def generate_lesson_plan(
+    image_path: Optional[str],
     textbook: str,
-    subject: str,
-    methodology: str,
-    duration: int,
+    cefr: str,
+    topic: str,
+    goal: str,
+    format_type: str,
+    num_students: int,
+    age: str,
+    adults: bool,
+    level_match: int,
     hw_required: bool,
-    file_search: bool,
-    image_path: Optional[str] = None
+    web_search: bool
 ) -> str:
-    """Генерация детального плана урока"""
+    # Валидация API клиента
     if not client:
-        raise gr.Error("API ключ не настроен или некорректен")
-
-    image_url = None
-    if image_path:
-        try:
-            with open(image_path, "rb") as f:
-                image_url = upload_to_catbox(f.read())
-        except Exception as e:
-            logging.error(f"Image error: {e}")
-
-    # Параметры
-    content = [
-        {"type": "message",
-         "content": (
-             f"Создай план урока:\n"
-             f"- Учебник: {textbook}\n"
-             f"- Предмет: {subject}\n"
-         )
-         }
+        raise gr.Error("API ключ не настроен")
+    # Проверка наличия изображения
+    if not image_path:
+        return "❗ Загрузите фото страницы учебника для генерации урока"
+
+    # Загружаем изображение и получаем URL
+    try:
+        with open(image_path, "rb") as f:
+            image_url = upload_to_catbox(f.read())
+    except Exception as e:
+        logging.error(f"Image upload error: {e}")
+        raise gr.Error("Не удалось загрузить изображение")
+
+    # Собираем текстовый prompt
+    params_list = [
+        f"- **Учебник**: {textbook}",
+        f"- **CEFR-уровень**: {cefr or 'не задан'}",
+        f"- **Тема**: {topic or 'не указана'}",
+        f"- **Цель занятия**: {goal or 'не указана'}",
+        f"- **Формат**: {format_type} ({num_students} {'ребёнок' if num_students==1 else 'детей'})",
+        f"- **Возраст**: {'взрослые' if adults else age}",
+        f"- **Соответствие уровня учебника**: {['below','on-level','above','mixed'][level_match]}",
+        f"- **Домашнее задание**: {'да' if hw_required else 'нет'}"
     ]
-    if image_url:
-        content.append({
-            "type": "image_url",
-            "image_url": {"url": image_url}
-        })
-
-    # Инструмент file_search (при наличии)
-    tools = None
+    if web_search:
+        params_list.append("- **Используется web search**: да")
+
+    prompt_text = "Параметры занятия:\n" + "\n".join(params_list)
+
+    # Формируем input массив для vision + text
+    input_array = [
+        {"type": "input_text", "text": prompt_text},
+        {"type": "input_image", "image_url": image_url}
+    ]
+
+    # Опции инструментов
+    tools = []
     tool_choice = None
-    include = None
-    if file_search and VS_ID:
-        tools = [{
-            "type": "file_search",
-            "vector_store_ids": [VS_ID],
-            "max_num_results": 10
-        }]
-        tool_choice = {"type": "file_search"}
-        include = ["file_search_call.results"]
+    # web_search заглушка
+    if web_search:
+        tools.append({"type": "web_search_preview", "search_context_size": "medium", "user_location": {"type": "approximate", "country": "RU"}})
+        tool_choice = {"type": "web_search_preview"}
 
+    # Вызов LLM
     try:
         response = client.responses.create(
-            instructions="Ты эксперт-педагог. Составь детальный план урока.",
-            input=param_vision,
+            instructions="Ты эксперт-педагог. Составь детальный план урока по заданным параметрам и изображению страницы учебника.",
+            input=input_array,
             model="gpt-4o-mini",
-            tools=tools,
+            tools=tools or None,
             tool_choice=tool_choice,
-            include=include,
-            max_output_tokens=2000
+            include=["file_search_call.results"],
+            max_output_tokens=2000,
+            reasoning={"effort": "medium"},
+            stream=False
         )
         return response.output_text
+
     except Exception as e:
         logging.error(f"Generation error: {e}")
         raise gr.Error(f"Ошибка генерации: {e}")
 
-
-# Интерфейс Gradio
-with gr.Blocks(title="Генератор уроков") as app:
+# --- Gradio UI ---
+with gr.Blocks(title="AI-Генератор уроков по фото учебника") as app:
     with gr.Row():
-        with gr.Column():
-            image = gr.Image(label="Фото страницы учебника (опционально)", type="filepath")
-            textbook = gr.Textbox(label="Учебник*", placeholder="Название учебника")
-            subject = gr.Textbox(label="Предмет*", placeholder="Название предмета")
-            methodology = gr.Dropdown(
-                label="Методика*",
-                choices=["PPP", "TTT", "Интерактивная"],
-                value="PPP"
-            )
-            with gr.Accordion("Дополнительно"):
-                duration = gr.Slider(15, 120, 45, step=5, label="Длительность (мин)")
-                hw_required = gr.Checkbox(label="Домашнее задание")
-                file_search = gr.Checkbox(label="Поиск в базах документов")
-            btn = gr.Button("Сгенерировать", variant="primary")
-        with gr.Column():
-            output = gr.Markdown("## План урока")
+        with gr.Column(scale=1):  # левый блок
+            image = gr.Image(label="Фото страницы учебника*", type="filepath")
+            textbook = gr.Textbox(label="Учебник*", placeholder="Название учебника, напр. English File Beginner")
+            cefr = gr.Dropdown(label="CEFR-уровень", choices=["A1","A2","B1","B2","C1","C2"], value="", info="необязательно")
+            topic = gr.Textbox(label="Тема", placeholder="напр. Daily routines", info="необязательно")
+            goal = gr.Textbox(label="Цель занятия", placeholder="напр. практика Present Simple в вопросах", info="необязательно")
+            format_type = gr.Radio(label="Формат занятия", choices=["Индивидуальное","Групповое"], value="Групповое")
+            num_students = gr.Slider(label="Количество детей*", minimum=2, maximum=40, value=4, step=1)
+            adults = gr.Checkbox(label="Взрослые", info="деактивирует поле возраст")
+            age = gr.Textbox(label="Возраст*", placeholder="напр. 10–11")
+            def toggle_age(adult_checked):
+                return gr.update(interactive=not adult_checked)
+            adults.change(fn=toggle_age, inputs=[adults], outputs=[age])
+
+            level_match = gr.Slider(label="Соответствие уровня учебника", minimum=0, maximum=3, step=1, value=1,
+                                    info="0=below,1=on-level,2=above,3=mixed")
+
+            hw_required = gr.Checkbox(label="Домашнее задание")
+            web_search = gr.Checkbox(label="Доп. материалы из интернета")
+            btn = gr.Button("Сгенерировать план", variant="primary")
+
+        with gr.Column(scale=2):  # правый блок
+            output = gr.Markdown("## План урока появится здесь...")
+            download_btn = gr.DownloadButton(label="⬇️ Скачать .docx", visible=False)
+
+    # Коллбек генерации
+    def on_generate(image, textbook, cefr, topic, goal, format_type, num_students, age, adults, level_match, hw_required, web_search):
+        # проверка
+        if not image or not textbook or (not age and not adults):
+            return gr.update(value="❗ Заполните обязательные поля: фото, учебник, возраст или 'взрослые'"), gr.update(visible=False)
+        text = generate_lesson_plan(image, textbook, cefr, topic, goal, format_type, num_students, age, adults, level_match, hw_required, web_search)
+        docx_path = None
+        if not text.startswith("❗"):
+            docx_path = generate_docx(text)
+        return gr.update(value=text), gr.update(visible=bool(docx_path), value=docx_path)
 
     btn.click(
-        fn=generate_lesson_plan,
-        inputs=[image, textbook, subject, methodology, duration, hw_required, file_search],
-        outputs=output
+        fn=on_generate,
+        inputs=[image, textbook, cefr, topic, goal, format_type, num_students, age, adults, level_match, hw_required, web_search],
+        outputs=[output, download_btn]
     )
 
 if __name__ == "__main__":

docs/architecture.md

@@ -1,3 +1,44 @@
+Я разрабатываю AI-ассистента для учителей английского. Туда загружаешь фото страниц учебника, а также задаешь параметры. 
+На выходе получаешь план урока. Фото считывается через vision. Везде используется API openai, эндпоинт responses (2025 год, 
+это самый актуальный эндпоинт). Интерфейс реализуется на Gradio. Vision работает через загрузку в него временного url 
+изображения страницы учебника. Блоки параметров: 1) Занятия - тема, основная цель, название учебника, уровень учебника 
+(по CEFR, выпадающий список)  2) Методика (выпадающий список, там PPP, TTT и другие актуальные подходы и методики ESL - 5 разных). 
+Занятие: кол-во учеников (ползунок от 2 до 40 и чекбокс "индивидуальное занятие", нажатие которого деактивирует ползунок), 
+время занятия (ползунок от 20 до 120 минут), возраст (свободное поле с placeholder "напр. 10-11", и чекбокс "врослые", 
+нажатие которого деактивирует свободное поле с возрастом), соответствие класса уровню - ползунок с 3 позициями mixed ability
+(предложи варианты, ведь бывает что учебник ниже уровня большинства, бывает наоборот ниже, бывает что в примерно в уровень, 
+бывает полный mixed ability). Дальше - ччекбокс наличия домашнего задания, под ним - чекбокс доп. материалов из интернета.  
+Обязательные поля должны быть заполнены для активации генерции, иначе при нажатии кнопки создания урока на месте плана урока 
+возникает сообщение о необходимости заполнить обязательные поля. Оформлен интерфейс в 2 колонки - левая с настройками (1/3 ширины),
+правая с планом урока (2/3 ширины). Я тебе вышлю имеющуюся у меня заготовку - здесь корректна инициализация клиента, правильные 
+названия эндпоинтов и моделей. Но здесь практически всё пока не то, что нужно - image_url сейчас подключается по условию, но оно 
+должно всегда попадать в LLM для генерации и другое. Прежде чем начнем писать код, проговори всё, и задай если нужно вопросы. Код не пиши.
+
+На вопросы: 1. методики - давай пока оставим эти 2 - PPP и TTT. По умолчанию - PPP, так что поле необязательное (значение по умолчанию уже есть) 2.метки для уровня: 
+“below”, “on-level”, “above”, “mixed” 3. Да, правильно 4. Если фото не загружено - урок не генерируется (это ключевая функция ассистента - создавать урок по загруженной странице) 
+5. Формат вывода - markdown внутри правого поля внутри Gradio - ок, но docx-экспорт через кнопку должен тоже быть (так же, как в приложении из примера) 6. 
+6. Заглушка web search - она не возвращает ничего, в prompt можно ее добавить при условии нажатия чекбокса как "используется web search 
+7. (пусть модель просто видит эту строчку если чекбокс нажат, а если отжат - там ничего) 7. Достаточно слайдера, о котором говорили выше. 
+8. Что еще забыли -- параметры тема и цель занятия. Тема необязательная, цель - тоже необязательная. Все настройки делим на блоки (аналогично тому 
+9. как  в приложении примере есть блоки "ребенок" и "занятие"). В начале - блок "занятие" (учебник, уровень, тема, цель"), затем - ��ласс (кол-во детей 
+10. (обязательное поле), возраст (обязательно), соответствие уровню учебника. Потом чекбоксы - наличие ДЗ и доп. материалы из интернета. Во всех полях 
+11. со свободным ответом должны быть плейсхолдеры с релевантным текстом-подсказкой
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 мне нужно сделать простое приложение по генерации планов уроков на базе предоставленной фотографии страницы учебника. 
 Для интерфейса используем streamlit. Логика такая - экран делится не левую и правую части. В левой части область загрузки 
 фотографии страницы учебника + поля заполнения и настройки (они появляются после успешной загрузки).