...

app/drawings.py

@@ -0,0 +1,111 @@
+drawings = [
+    r"""
+        \   |   /      
+          .-'-.       
+      ― (  ☀  ) ―    
+          '-.-'        
+        /  |  \        
+            ️
+
+           ___I_      
+         /\-_--\     
+        /  \_-__\    
+       | [] | [] |    
+       |____|____|   
+    """,
+
+    r"""
+  ╔════════════════════════════════════════════╗
+  ║                                            ║
+  ║                                            ║
+  ║                                            ║
+  ║    РА    РО    РУ    РЫ                    ║
+  ║   ┌─┐   ┌─┐   ┌─┐   ┌─┐                    ║
+  ║   │Р│   │Р│   │Р│   │Р│                    ║
+  ║   └─┘   └─┘   └─┘   └─┘                   ║
+  ║                                           ║
+  ║      ( )  ← "Язычок!"                      ║
+  ║     /___\                                  ║
+  ║      | |                                   ║
+  ║                                            ║
+  ║   ░░░░░░░░░                                ║
+  ║   ░      ░ ← "Это море!"                   ║
+  ║   ░  ><  ░                                ║
+  ║   ░░░░░░░░░                                ║
+  ║                                            ║
+  ║   O   O   O ← "Шарики!"                    ║
+  ║    \ | /                                   ║
+  ║     \|/                                    ║
+  ║      "Фуух!" (дуем)                        ║
+  ║                                            ║
+  ║   АБВГДЕЁЖ ← "Азбука"                     ║
+  ║     \_____/                                ║
+  ║      "Ура!"                                ║
+  ║                                            ║
+  ║   ♪~ ♪~ ♪~ ← "Пою звуки!"                 ║
+  ║                                            ║
+  ╚════════════════════════════════════════════╝
+    """,
+
+    r"""
+    _________________________________________________
+   /                                                 \
+  |       ( )                                        |
+  |      /___\  ← "Язычок на горке!"                 |
+  |       / \                                        |
+  |     _/   \_                                      |
+  |    |       |                                     |
+  |    |  ДОМ  | ← "А это где звук живет!"           |
+  |    |_______|                                     |
+  |                                                   |
+  |    *     *     *                                  |
+  |     \   |   /   ← "Дуем на свечки!"              |
+  |      \  |  /                                     |
+  |       "Оооо"                                     |
+  |                                                   |
+  |     ♪   ♪   ♪                                    |
+  |     "Пою гласные!"                               |
+   \_________________________________________________/ \
+    """,
+    r"""
+      _________________________________________________
+     /                                                 \
+    |    РА    РО    РУ                                |
+    |   ┌──┐  ┌──┐  ┌──┐                               |
+    |   │★ │  │★ │  │★ │ ← "Звездные слоги"           |
+    |   └──┘  └──┘  └──┘                               |
+    |                                                   |
+    |      .-.                                          |
+    |     ( О ) ← "Луна!"                              |
+    |      `-'                                          |
+    |     /    \                                        |
+    |    /      \                                       |
+    |   "А-а-а-а!" (кричит в космос)                    |
+    |                                                   |
+    |    ∞∞∞∞∞∞∞∞∞                                     |
+    |    "Ракета летит!"                               |
+     \_________________________________________________/ \
+      """,
+    r"""
+      _________________________________________________
+     /                                                 \
+    |     .-.       .-.                                 |
+    |    ( Р )     ( Ш ) ← "Эти звуки дружат!"          |
+    |     `-'       `-'                                 |
+    |      |         |                                  |
+    |     / \       / \                                 |
+    |    "Р-р-р"  "Ш-ш-ш"                               |
+    |                                                   |
+    |       O    O    O                                 |
+    |        \  |  /   ← Шарики для дыхания             |
+    |         \ | /                                     |
+    |          "Фууух!"                                 |
+    |                                                   |
+    |    ░░░░░░░░░░░░░░░                                |
+    |    ░           ░ ← "А это море!"                 |
+    |    ░   ><((((°> ░                                |
+    |    ░           ░                                 |
+    |    ░░░░░░░░░░░░░░░                                |
+     \_________________________________________________/
+    """,
+    ]

app/knowledge_base/check_list.md

@@ -0,0 +1,41 @@
+📋 ЧЕК-ЛИСТ: Как выбрать Target Language для урока
+По материалу страницы
+
+Есть ли выделенные слова, грамматические конструкции, выражения?
+
+Присутствуют ли готовые списки лексики, примеры диалогов, грамматические таблицы?
+
+По теме урока
+
+Какие языковые средства необходимы, чтобы говорить на заданную тему?
+
+Какие ключевые слова или фразы необходимы для выполнения основной задачи урока?
+
+По цели занятия
+
+Требуется развитие навыков речи, слушания, чтения, письма?
+
+Какая языковая поддержка нужна для достижения цели?
+
+По возрасту и уровню учащихся
+
+Возраст: Нужно ли упростить язык для младших/младших подростков?
+
+Уровень:
+
+A1–A2 → простые слова, базовые структуры (3–5 единиц)
+
+B1–B2 → более сложные выражения, фразовые глаголы, конструкции (5–7 единиц)
+
+C1–C2 → идиомы, формулы дискурса, редкие слова (7–9 единиц)
+
+По типу языка
+
+Лексика, грамматика, функциональный язык, произношение, идиомы, фразовые глаголы.
+
+Иногда комбинация (например: модальные глаголы + фразы для просьб).
+
+По практическому применению
+
+Какие языковые единицы учащиеся реально смогут использовать в финальной части (Production)?
+

app/knowledge_base/test.md

@@ -0,0 +1,13 @@
+
+Фрагмент:
+"Упражнение 1b (стр. 8) – табличка «What information is on each card?»
+– Ученики в тетрадях отмечают крестиком (X), какую информацию (full name, expiry date и т.д.) они видят на каждой карте."
+
+Комментарий:
+Хорошо бы в плане сделать набросок таблички в плане, чтобы учитель сразу понимал, как это организовать
+
+В промпт:
+Используй в плане условные визуальные схемы при необходимости. 
+Например, если нужно что-то нарисовать на доске или какую-то таблицу вынести в тетрадь - приведи общий (для понимания сути) набросок в плане
+
+Проверка:

app/knowledge_base/test_samples/PPP_Spotlight 5_1.md

@@ -0,0 +1,166 @@
+user
+Ты — опытый ESL-методист. Ты помогаешь учителям составлять грамотные и интересные планы занятий.
+Разработай план урока на материале загруженной страницы учебника. Максимально опирайся на этот материал. 
+Перед тем как генерировать план, обдумай этапы урока по методологии PPP (Presentation-Practice-Production). с учетом всех вводных параметров занятия.
+Будь гибким: адаптируй идеи под реальный контекст занятия, проявляй педагогическое чутьё, не копируй механически структуру. Главная цель — сделать урок живым и полезным!
+На всех этапах урока используй материал страницы как основной источник. Указывай номера упражнений в плане.
+
+Параметры занятия:
+- УМК: попробуй определи визуально через логотипы, заголовки, структуру
+- Уровень УМК по CEFR: определи по сложности текста/упражнений или по названию учебника 
+- Тема: выяви через ключевые слова/изображения на странице
+- Цель: сформулируй как 'К концу урока ученики смогут...'
+- Продолжительность: 60 мин
+- Количество учеников: 10 чел
+- Возраст: 11-12 лет (учти: дети: фокус на играх, движении, визуалах, коротких активностях)
+- Методология занятия: PPP (Presentation-Practice-Production)
+- Целевой язык: определи самостоятельно по загруженной странице,
+- Дополнительная информация от учителя: не указано
+- Оборудование/инвентарь: стандартный класс + проектор
+- Необходимость домашнего задания: не требуется 
+
+
+
+[МЕТОДИКА PPP]
+📝 Чек-лист перед генерацией этапов урока:
+Кто мои ученики? (Возраст, уровень CEFR, сильные/слабые стороны)
+Что за материал на странице? (Лексика, грамматика, темы — что важно освоить?)
+Какая цель урока? (Что ученики должны уметь делать к концу?)
+Какая активность наиболее естественна для этого контекста? (Диалог, игра, проект, обсуждение?)
+Какой тип упражнений соответствует целям? (Контролируемые / полуконтролируемые / свободная практика?)
+Нужно ли предусмотреть поддержку слабых учеников? (Подсказки, шаблоны, парная работа)
+Как я дам обратную связь после практики? (Похвала + 1–2 рекомендации для улучшения)
+
+Перед разработкой этапа задай себе краткий вопросник (чек-лист выше), чтобы лучше почувствовать уровень учеников, специфику материала и выбрать подходящие активности.
+Ориентируйся на содержание страницы, параметры урока и свое "учительское чутье".
+
+Presentation (20–25% времени) — Выбери главный target language (лексика или структура) по материалу страницы. — Введите новое языковое содержимое через три канала: понимание (meaning), форма (form), произношение (pronunciation). — Определите количество новых языковых единиц в зависимости от уровня CEFR и возраста учащихся, чтобы обеспечить оптимальное усвоение материала. — Предусмотри, где эти единицы будут представлены письменно (доска, раздатки, заметки). — Дополни план идеями для активации внимания: короткий диалог, обсуждение картинки, мини-видео.
+Этап 2: Practice (30–40% времени занятия)
+
+Построй этап на базе target language, выбранного на предыдущей фазе.
+Используй материал страницы учебника как основу для упражнений (переформатируй задания при необходимости, но сохраняй их смысл и структуру).
+
+Организуй 2–3 упражнения, начиная с полностью контролируемых к более свободным:
+Controlled Practice:
+— drills (substitution, transformation, repetition);
+— sentence formation exercises;
+— simple gap-fills, где нет вариативности в ответах.
+
+Semi-controlled Practice:
+— gap-fills с выбором из нескольких возможных ответов;
+— matching (словосочетание–перевод, начало–конец предложения);
+— guided sentence or dialogue completion.
+
+Цель этапа: закрепить понимание значения, формы и произношения целевого языка.
+Подбирай тип упражнений, учитывая возраст, уровень CEFR, продолжительность урока и количество учеников (пары, мини-группы и т.д.).
+Продумай, как предоставить минимальный фидбэк (например, общее исправление ошибок после каждого упражнения).
+
+Этап 3: Production (25–35% времени занятия)
+
+Построй задание на свободное использование target language.
+Используй материал страницы как отправную точку для ситуации, но адаптируй или дополни её, чтобы задание требовало активного создания речи учениками.
+Возможные типы заданий:
+- Ролевые игры (role plays): в парах, мини-группах;
+- Мини-проекты: например, создать постер, сценарий, презентацию;
+- Обсуждения и дебаты;
+- Симуляции реальных ситуаций;
+- Storytelling (рассказывание истории, дополнение истории по картинкам);
+- Игры на использование языка (интервью, "Find someone who...", викторины).
+
+Обязательно оставь место для устной обратной связи после задания:
+- Сначала позитив: что получилось хорошо;
+- Потом мягкие рекомендации: 2–3 главных направления для улучшения (аккуратность, использование новых выражений, беглость).
+Подбирай активность с учётом возраста, уровня и характера группы (например, подростки предпочитают соревновательные задания, взрослые — практические кейсы).
+
+** Корректировки длительности этапов для разных уровней**:
+Начинающие (A1-A2):
+• Увеличить Practice до 45-50% (больше повторений и структурированных упражнений).
+• Сократить Production до 20% (менее сложные задания).
+
+Продвинутые (B2-C1):
+• Сократить Presentation до 15% (быстрый ввод материала).
+• Увеличить Production до 35-40% (больше дискуссий/кейсов).
+
+
+
+#######################
+
+
+План урока «Who are you?» (УМК: предп. «English World» Starter, стр. 8)
+Уровень CEFR: A1
+Тема: Формы удостоверений личности и личные данные
+Цель: К концу урока ученики смогут узнать и назвать четыре вида карт: identity card, driving licence, credit card, membership card;
+задавать и отвечать на вопросы о личных данных: name, address, postcode, telephone number;
+уметь произносить и писать своё имя и адрес по буквам. Возраст: 11–12 лет Продолжительность: 60 мин Класс: 10 человек Оборудование: проектор, доска, маркеры, распечатанные карточки (А, B, C, D) и бланки «VIDEOWORLD» для практики, карточки-анкеты для ролевой игры. Домашнее задание: не задаётся
+
+Подготовительный чек-лист (для себя, учитель): 
+• Ученики A1, 11–12 лет, нуждаются в большом количестве визуальной поддержки, движениях и парной работе. • Материал: лексика (4 типа карт), функциональный язык (запрос личных данных, правописание по буквам), восприятие на слух и чтение диалога. • Основная цель – научить узнавать карты и заполнять анкету, задавая и отвечая на вопросы. • Поддержка слабых: раздатки с подсказками (список слов, таблица букв).
+Этап 1. Presentation (12 мин, 20%)
+1.1. Введение темы (2 мин)
+– Показать на проекторе четыре картинки карточек (A–D).
+– Вопрос к классу: What are these? (слайд/доска)
+– Ученики называют то, что понимают; записать ключевые слова на доске: identity card, driving licence, credit card, membership card.
+
+1.2. Meaning–Form–Pronunciation (10 мин)
+a) Meaning
+– Картинки по очереди: учитель показывает Identity card – What is this? – обозначает функ­цию (to prove who you are).
+– Аналогично с driving licence (to drive), credit card (to pay), membership card (to enter a club).
+b) Form
+– На доске выписать каждое словосочетание, подчеркнуть раздельность слов и правописание.
+– Попросить учеников прочитать по цепочке (substitution drill): “This is a …”
+c) Pronunciation
+– Чак-репит (choral drilling) с акцентом на /aɪˌden.tɪ.ti kɑːd/, /draɪ.vɪŋ ˈlaɪ.səns/, /ˈkre.dɪt kɑːd/, /ˈmem.bə.ʃɪp kɑːd/.
+– Индивидуальные повторы для слабых (teacher monitors).
+
+Доп. функционал: фраза «How do you spell that?»
+– Учитель моделирует мини-диалог с учеником у доски, спрашивает имя и просит написать по буквам.
+
+
+Этап 2. Practice (25 мин, 40%)
+2.1. Controlled Practice (10 мин)
+Упражнение 1a (стр. 8):
+– В парах ученики смотрят на карточки A–D и подписывают их тип (credit card, driving licence, identity card, sports/membership card).
+– Проверка хором, учитель исправляет.
+
+Упражнение 1b (стр. 8) – табличка «What information is on each card?»
+– Ученики в тетрадях отмечают крестиком (X), какую информацию (full name, expiry date и т.д.) они видят на каждой карте.
+– Короткий общий разбор (teacher elicits ответы).
+
+2.2. Semi-controlled Practice (15 мин)
+Упражнение 2b (стр. 8) – заполнение Membership Card (VIDEOWORLD)
+– Раздать карточки-анкету и текст диалога (сокращённо).
+– В парах один читает реплики Penny, другой – Jane; заполняют поля Name, Surname, Address, Postcode, Phone Number, Membership Number.
+– После – сравнение в группах, учитель вешает заполненный бланк на доску и сверяет.
+
+Упражнение 3 (стр. 8) – What are these numbers?
+– Индивидуально: ученики подписывают к цифрам (1–10; 2–7125 9990; 3–SW1 4TA).
+– Обсуждение в парах, общий фидбэк.
+
+Этап 3. Production (18 мин, 30%)
+Ролевая игра «Join the club»
+3.1. Подготовка (3 мин)
+– Раздать каждому ученику карточку-анкету (аналог видеомира) с незаполненными полями.
+– Разделить класс на тройки: receptionist + 2 new members.
+
+3.2. Ролевая игра (10 мин)
+– Receptionist задаёт вопросы:
+– What’s your name? How do you spell that?
+– Where do you live? What’s your postcode?
+– What’s your telephone number?
+– Новые члены отвечают и заполняют анкету.
+– Меняются ролями, переходят к следующему партнёру.
+
+3.3. Отзыв и коррекция (5 мин)
+– Собрать 2–3 пары к доске, попросить кратко провести интервью и показать заполненные анкеты.
+– Позитивная обратная связь:
+– «Great pronunciation of postcode!»
+– «Well done using full sentences!»
+– Рекомендации:
+– «Don’t forget to spell your surname slower.»
+– «Use the phrase “I live at…” for address.»
+
+Итого:
+Presentation 12 мин (20%)
+Practice 25 мин (40%)
+Production 18 мин (30%)
+Оставшиеся 5 мин – организационные моменты, переходы, быстрый чектест на доске: “Match the word to the picture” для закрепления.

app/knowledge_base/tips.md

@@ -0,0 +1,173 @@
+ИДЕИ:
+Вынести рекомендации по занятию и рефлексию в отдельный блок четко
+Структура и форматирование - четко
+
+
+
+
+
+PPP
+
+Важные нюансы:
+Гибкость:
+
+Если студенты не усвоили материал на Practice, сократите Production и добавьте упражнение.
+
+Для уроков с грамматикой увеличьте Presentation на 5-10%.
+
+Домашнее задание:
+
+Не включается в тайминг. Дается в конце Production (2-3 минуты на объяснение).
+
+Обратная связь:
+
+Часть Production (последние 3-5 минут).
+
+
+1. **Presentation (20-25% времени занятия)**  
+   - Введите ЦЕЛЕВЫЙ ЯЗЫК (минимум 5 языковых единиц) через контекст: короткий диалог, картинку или видео, фокусируясь на значении → форме → произношении
+   - Используй визуалы или реальные объекты, чтобы зацепить внимание и активировать схемы учащихся.  
+
+2. **Practice (30-40% времени занятия)**  
+   - Два–три контролируемых упражнения: drills (substitution, transformation), gap-fills, matching.  
+   - Немедленно корректируй ошибки вежливо, поддерживая мотивацию 
+
+3. **Production (25-35% времени занятия)**  
+   - Ролевые игры или мини-проект, где ученики свободно используют выученный язык (диалог, обсуждение)
+   - Фидбэк после: отметь сильные стороны, затем укажи 2–3 точки для улучшения 
+
+
+Возраст учащихся также влияет на восприятие нового материала:​
+
+Дети (6–12 лет): Предпочтительны визуальные и игровые методы подачи материала.
+
+Подростки (13–17 лет): Эффективны групповые проекты и обсуждения актуальных тем.
+
+Взрослые: Целесообразно использовать профессиональные контексты и дискуссии.
+
+
+Что может считаться target language (целевым языком) на уроке английского:
+
+
+Категория	Примеры
+Лексика (vocabulary)	Тематические слова и выражения: еда, путешествия, эмоции
+Грамматика (grammar)	Времена, модальные глаголы, условные предложения, артикли
+Функциональный язык (functional language)	Фразы для общения: просьбы, советы, приглашения, извинения
+Фразовые глаголы (phrasal verbs)	Turn up, break down, look after
+Идиомы (idioms)	"Break the ice", "Hit the books"
+Произношение (pronunciation features)	Интонация вопросов, соединение слов (linking sounds), ударение
+Орфография (spelling patterns)	Правила написания: окончания -ing, суффиксы и префиксы
+Синтаксис (syntax)	Порядок слов в вопросах, порядок прилагательных
+Функции дискурса (discourse markers)	Well, actually, you know, I mean...
+Социальные формы речи (register)	Формальный/неформальный стиль общения
+
+
+
+1. Контролируемые упражнения (Controlled Practice)
+Фокус на точности, минимум свободы.
+
+Тип упражнения	Описание	Источник
+Repetition drills	Хоровое или индивидуальное повторение целевых фраз/звуков.	
+Substitution drills	Замена одной части фразы другой (e.g., “I like tea” → “She likes coffee”).	
+Transformation drills	Преобразование предложений (утвердит. → вопросит.).	
+Gap-fill (cloze) exercises	Заполнение пропусков в тексте или диалоге.	
+Matching activities	Сопоставление слов с определениями, картинок с предложениями.	
+Multiple-choice questions	Выбор правильного варианта из нескольких.	
+True/False (Correct/Incorrect)	Оценка утверждений как верных/неверных.	
+Sentence completion	Дописать конец предложения по образцу.	
+Dictation	Прослушивание и письменная запись целевых фраз/предложений.	
+Sentence jumbles	Распутать перемешанные слова в предложение.	
+Error correction tasks	Найти и исправить ошибки в примерах.	
+Controlled dialogues	Чтение/роль по готовому сценарию с жёсткими подсказками.	
+
+
+2. Полу-контролируемые упражнения (Semi-controlled Practice)
+Введение элемента свободы, но с опорой на целевой язык.
+
+Тип упражнения	Описание	Источник
+Pair Q&A	Пары задают друг другу вопросы по шаблону (info-gap).	
+Brainstorming	Генерация идей/слов по теме, опора на целевой язык.	
+Fill-in-the-blank dialogues	Заполнение пропусков в диалоге, затем разыгрывание его.	
+Story-telling with pictures	Составление рассказа по серии картинок, с включением ЦЯ.	
+Rank & Share	Ранжирование элементов по критериям, обсуждение в парах/группах.	
+Find someone who… (info-gap)	Опрос одноклассников по списку вопросов, отчёт о результатах.	
+Vocab Taboo	Объяснение слова, не называя его, остальные угадывают.	
+Speak-to-Draw	Инструкции с предлогами: один описывает, другой рисует.	
+Interview role-play	Создание вопросов-интервью и инсценировка.	
+Directed paired conversation	Парная беседа по заданным вопросам без дальнейших подсказок.	
+Story completion	Продолжить начало рассказа, данное учителем или в тексте.	
+Information gap maps/charts	Заполнение таблиц/карт данными, обмен информацией в парах.	
+
+
+3. Переходное (linking) упражнение к Production
+Готовит к свободному применению, смешивая контролируемые и свободные элементы.
+
+Тип упражнения	Описание	Источник
+Semi-scripted role-play	Диалог с частичными подсказками, затем свободное продолжение.	
+Information-gap mini-project	Сбор информации в парах/группах и представление результатов (карточки, плакаты).	
+Guided discussion	Обсуждение вопросов со списком ключевых фраз, затем открытый обмен мнениями.	
+Sentence-prompt stories	Закончить историю, начатую учителем, по опорным фразам.	
+
+
+3. Production (25–35% времени)
+Цель: предоставить ученикам возможность свободно применять target language в реалистичной коммуникативной задаче 
+barefootteflteacher.com
+.
+
+Что включить в план
+Задача с реальным смыслом: выберите активность, где результат важен (мини-проект, презентация, интервью) 
+TESOL Pop
+.
+
+Фиксация продукта: предусмотреть запись (доска, тетради, совместный файл) итоговых высказываний или артефактов 
+Go Overseas
+.
+
+Групповая динамика: парная или групповая работа с минимальными подсказками по форме 
+TeachingEnglish
+.
+
+Обратная связь: этап peer-review или teacher feedback — сначала положительное, затем 2–3 совета по улучшению 
+barefootteflteacher.com
+.
+
+Дифференциация: для смешанных уровней предложить базовый и продвинутый варианты задачи 
+barefootteflteacher.com
+.
+
+Типы Production-активностей
+Модель может выбирать из следующих вариантов в зависимости от параметров урока:
+
+
+Тип активности	Описание
+Ролевые игры (Role-play)	Ситуации из реальной жизни (покупка, интервью)
+Дискуссии (Discussion)	Групповые дебаты или круглые столы
+Мини-проекты (Mini-projects)	Совместное создание плаката, видео или презентации
+Интервью (Interview)	Ученики берут друг у друга интервью по теме
+Storytelling	Рассказ истории на основе картинок или подсказок
+Problem-solving tasks	Решение кейсовых задач, планирование мероприятия
+Peer teaching	Ученики обучают друг друга элементам target language
+
+
+    Действуй в рамках методологии, но мысли широко и оставайся гибким, предлагай творческие варианты, соответстующие контексту занятия.
+Действуй творчески, не фанатично: опирайся на заданные параметры (тема, уровень, возраст, инвентарь) и используй «учительское чутьё» при выборе задач, сохраняя свободу внутри методической структуры .
+
+Пример мини-шаблона (пример few-shot):
+— Presentation: ввести Past Continuous через картинку и вопрос “What were they doing?”  
+— Practice: 2 упражнения: gap-fills (5 предлож.), substitution drill (3 примера).  
+— Production: ролевой диалог “рассказать о выходных”; 5 мин свободной беседы.  
+— Feedback: praise + 2 рекомендац.
+
+📝 Чек-лист перед генерацией этапов урока:
+Кто мои ученики? (Возраст, уровень CEFR, сильные/слабые стороны)
+Что за материал на странице? (Лексика, грамматика, темы — что важно освоить?)
+Какая цель урока? (Что ученики должны уметь делать к концу?)
+Какая активность наиболее естественна для этого контекста? (Диалог, игра, проект, обсуждение?)
+Какой тип упражнений соответствует целям? (Контролируемые / полуконтролируемые / свободная практика?)
+Нужно ли предусмотреть поддержку слабых учеников? (Подсказки, шаблоны, парная работа)
+Как я дам обратную связь после практики? (Похвала + 1–2 рекомендации для улучшения)    
+
+
+
+    Поддерживай тёплый, естественный тон плана. Если в материале заметен интересный или забавный момент, можешь кратко его отметить — но главное внимание уделяй целям урока и развитию учеников.
+    

app/prompt_builder/prompt_sketches.md

@@ -0,0 +1,284 @@
+def build_prompt(params):
+    base_prompt = f"""
+    Ты — опытный ESL-методист. Помоги учителю создать структурированный и увлекательный план урока, 
+    максимально используя материалы загруженной страницы учебника. Действуй строго в рамках методологии {params['methodology']},
+    но предлагай неочевидные идеи там, где это уместно.
+
+    Параметры занятия:
+    - УМК: {params.get('textbook') or "анализируй визуально: логотипы, заголовки, структуру"}
+    - Уровень CEFR: {params.get('cefr') or "определи по: длине предложений, сложности лексики, грамматическим структурам"}
+    - Тема: {params.get('topic') or "выяви через ключевые слова/изображения на странице"}
+    - Цель: {params.get('goal') or "сформулируй как 'К концу урока ученики смогут...' + действие с целевым языком"}
+    - Длительность: {params['duration']} мин
+    - Возраст: {params['age']}
+    - Инвентарь: {params.get('inventory') or "стандартный класс + проектор"}
+    - ДЗ: {'Обязательно' if params['hw_required'] else 'Не требуется'}
+
+    Особые требования:
+    """
+
+    methodology_advice = METHODOLOGY_TIPS.get(params['methodology'], "")
+    return base_prompt + methodology_advice
+
+METHODOLOGY_TIPS = {
+    "PPP (Presentation-Practice-Production)": """
+    [ДЕТАЛЬНАЯ ИНСТРУКЦИЯ ДЛЯ PPP]
+    
+    1. PRESENTATION (20-25% времени)
+    ✔ Обязательно:
+    - Используй 1-2 элемента со страницы как контекст (диалог/текст/картинки)
+    - Выдели 5-7 языковых единиц (подсвети рамкой/цветом на странице)
+    - Включи работу с формой: таблица на доске с примерами из материалов
+    ✨ Креатив:
+    - "Создайте мем с фразой из текста"
+    - "Найдите самое странное предложение и объясните его"
+    
+    2. PRACTICE (30-45% времени)
+    ✔ Обязательно:
+    - 2 базовых упражнения ИЗ УЧЕБНИКА (gap-fill/matching/transformation)
+    - 1 активность с адаптацией материала (примеры ↓)
+    🎯 Дифференциация:
+    - Начинающие: добавь шаблоны/опции выбора
+    - Продвинутые: "Дополните предложения деталями"
+    🔥 Альтернативы:
+    - "Grammar Auction" с предложениями из текста
+    - "Find Someone Who..." с целевой лексикой
+    
+    3. PRODUCTION (25-35% времени)
+    ✔ Обязательно:
+    - Реальная коммуникация (не механические упражнения)
+    - Минимум 5 случаев использования целевого языка
+    💡 Идеи:
+    - "Снимите 30-секундный TikTok-обзор текста"
+    - Ролевая игра "Интервью с персонажем учебника"
+    
+    4. ДОПОЛНИТЕЛЬНО
+    ⏱ Тайминг-подсказки:
+    - На 60 мин: P(15) → Pr(25) → Pd(20)
+    - На 90 мин: P(20) → Pr(35) → Pd(30)
+    📝 ДЗ (если нужно):
+    - "Напишите альтернативный финал истории с 8 целевыми словами"
+    - "Создайте диалог-продолжение упражнения 5B"
+    
+    ❗ Важно:
+    - 70% контента должно быть с загруженной страницы
+    - Для детей добавь движение/игры
+    - Для взрослых — кейсы/дискуссии
+    """,
+
+    "TTT (Test-Teach-Test)": """
+    [МЕТОДИКА TTT]
+    ... (оставьте ваш текущий контент)
+    """
+}
+
+
+
+
+
+“Цель урока:
+– Навыковая: Speaking (рассказать о своём опыте);
+– Языковая: Grammar (Present Perfect для выражения жизненного опыта);
+– Коммуникативная: Fluency (свободный диалог в парах);
+– Жизненная: Collaboration (спланировать совместную поездку).”
+
+METHODOLOGY_TIPS = {
+    "PPP (Presentation-Practice-Production)": """
+    [МЕТОДИКА PPP - ДЕТАЛЬНАЯ ИНСТРУКЦИЯ]
+    
+    АНАЛИЗ МАТЕРИАЛА УЧЕБНИКА:
+    1. Определи ключевой языковой фокус (лексика/грамматика) из текста и упражнений
+    2. Выдели 5-7 целевых слов/фраз или 1 грамматическую структуру
+    3. Найди подходящий контекст (диалог, текст, картинки) для презентации
+    
+    ПЛАН УРОКА:
+    
+    === PRESENTATION (20-25% времени) ===
+    Цель: Ввести язык в осмысленном контексте
+    • Используй материалы со страницы:
+      - Если есть диалог: "Прочитайте/прослушайте диалог из упр. X. Вопрос: What's the main problem?"
+      - Если текст: "Найдите 3 слова, описывающие [тему]"
+      - Если картинки: "Опишите фото из учебника. What do you see?"
+    • Явно выдели целевой язык:
+      - Создай таблицу на доске с примерами из учебника
+      - Сфокусируйся на: форме, значении, произношении
+      - Используй элиситацию: "What words describe [topic]?" → дополняй ответы
+    
+    === PRACTICE (30-40% времени) ===
+    Цель: Контролируемое применение языка
+    • Адаптируй упражнения со страницы:
+      - Упражнения на подстановку (gap-fills) → "Выполните упр. 3A индивидуально"
+      - Трансформации (rewriting) → "Измените предложения, как в примере из упр. 5B"
+      - Мини-диалоги → "В парах разыграйте диалог, заменив выделенные фразы"
+    • Прогрессия сложности:
+      1. Полностью контролируемые задания (из учебника)
+      2. Полу-контролируемые (частично измененные примеры)
+      3. Подготовка к Production (например, "Составьте 3 вопроса для партнера")
+    
+    === PRODUCTION (25-30% времени) ===
+    Цель: Свободное использование языка
+    • Создай коммуникативную активность на основе материалов:
+      - Ролевые игры: "Student A: Tourist (use phrases from p.X), Student B: Guide"
+      - Творческие задания: "Напишите email, используя 5 слов с доски"
+      - Обсуждения: "В группах решите: What's the best solution for [problem from text]?"
+    • Критерии:
+      - Минимум 5-7 реплик/предложений с целевым языком
+      - Минимальное вмешательство учителя
+      - Реальный обмен информацией (не механическое повторение)
+    
+    ДОПОЛНИТЕЛЬНО:
+    • Дифференциация: 
+      - Для сильных: "Добавьте 2 своих примера"
+      - Для слабых: "Используйте шаблон из рамки"
+    • Обратная связь:
+      - Исправь 2-3 типичные ошибки после Production
+      - Похвали успешное использование языка
+    • Домашнее задание (если требуется):
+      - Свяжи с уроком: "Напишите диалог, развивающий историю из учебника"
+    
+    ПРИМЕР ДЛЯ СТРАНИЦЫ С ТЕМОЙ "TRAVEL":
+    1. Presentation: Карта из учебника → "Какие места вы узнаёте? What can you do there?" → введение фраз (book a ticket, pack luggage)
+    2. Practice: Упр. на заполнение пропусков в диалоге аэропорта → преобразование утверждений в вопросы
+    3. Production: Ролевая игра "Lost luggage" с использованием 5 фраз с урока
+    """,
+}
+
+
+
+
+
+
+
+
+
+
+
+промпт должен явно указать модели:
+
+Анализировать визуальный контент,
+
+Извлекать из него ключевые элементы для PPP,
+
+Строить план урока на основе распознанного материала.
+
+Вот как будет выглядеть финальный промпт:
+
+Промпт для генерации PPP-плана на основе фото страницы учебника
+Role: Ты — AI-ассистент для учителей английского, экспертно владеющий методологие�� PPP.
+Goal: Создать структурированный план урока, строго соответствующий материалам на загруженной странице учебника.
+
+Шаг 1: Анализ страницы учебника
+(Эти инструкции получает модель, но не пользователь)
+
+Определи:
+
+Тема урока (напр., "Travel", "Food", "Past Continuous").
+
+CEFR уровень (A1, B2 и т.д.) — по сложности текста/упражнений.
+
+Целевой язык:
+
+Лексика (минимум 5 ключевых слов/фраз из текста/заданий).
+
+Грамматика (напр., Present Perfect, модальные глаголы).
+
+Тип заданий на странице (gap-fill, диалоги, чтение).
+
+Если данные неясны:
+
+Спроси: «На странице нет явной темы. Уточните: это урок по грамматике (какой?) или лексике (какой теме?)».
+
+Если фото размыто/нечитаемо: «Не удалось распознать текст. Загрузите более четкое фото или укажите тему вручную».
+
+Шаг 2: Генерация PPP-плана
+Инструкции для модели:
+Используй только материалы с загруженной страницы. Если учитель ввел параметры (тема, уровень), проверь их соответствие контенту учебника.
+
+1. Presentation (20-25% времени)
+Контекст:
+
+«Используй изображения/заголовки с фото страницы для ввода в тему. Пример:
+
+Если на странице есть картинки с людьми в аэропорту: «Покажите фото из учебника. Спросите: ‘What do you see? Have you ever been in this situation?’».
+
+Если текст — диалог: «Проиграйте аудио/прочитайте диалог. Задайте вопрос: ‘What’s the main problem?»».
+
+Целевой язык:
+
+«Выдели из текста/упражнений:
+
+Лексика: 5-7 ключевых слов (напр., из заголовка или выделенных в учебнике).
+
+Грамматика: конструкция, которая повторяется (напр., условные предложения).
+
+Как презентовать:
+
+Создай таблицу на доске с примерами из текста.
+
+Используй упражнение №X с фото страницы для элиситации (напр., gap-fill с пропущенными глаголами).
+
+2. Practice (30-40% времени)
+Задания:
+
+«Адаптируй упражнения с фото страницы:
+
+Если есть matching (сопоставление): «Раздайте карточки из упр. 3. В парах сопоставьте слова с определениями».
+
+Если есть ролевая игра: «Разыграйте диалог из учебника, заменив выделенные фразы на свои».
+
+Дифференциация:
+
+Для mixed уровней: «Advanced: добавьте 2 своих примера. Beginners: используйте словарь со стр. X».
+
+3. Production (25-30% времени)
+Активность:
+
+«Создай задание, расширяющее тему учебника. Примеры:
+
+Если на странице текст про путешествия: «Смоделируйте ситуацию: вы в аэропорту. Разработайте диалог ‘Lost Luggage’ с 5 фразами из урока».
+
+Если грамматика: Past Continuous: «Напишите историю ‘What Were You Doing When…?’ используя 4 примера из учебника».
+
+4. Homework & Feedback
+ДЗ: Если на странице есть письменное задание (напр., «Write an email»), используй его. Если нет: «Напишите 10 предложений, используя слова из таблицы на доске».
+
+Коррекция: «Выберите 2 частые ошибки из Production. Напишите, как исправить (напр., неправильный порядок слов в Present Perfect)».
+
+Пример работы промпта
+Фото страницы: Учебник "English File Pre-Intermediate", стр. 78 — текст про экологию, упражнения на Present Perfect, слова: recycle, pollution, environment.
+Параметры учителя: Длительность — 45 мин, возраст — подростки 14 лет.
+
+Сгенерированный план:
+
+Presentation (10 мин):
+
+Обсуждение картинки с загрязненным парком из учебника: «What’s wrong here? What would you do?».
+
+Выписать на доску слова: recycle, pollution, environment. Добавить примеры из текста.
+
+Хоровая отработка произношения.
+
+Practice (20 мин):
+
+Упр. 2A (gap-fill с Present Perfect): «Сделайте индивидуально, потом проверка в парах».
+
+Ролевая игра: «Student A: Environmental activist. Student B: Mayor. Discuss solutions (use 3 words from the board)».
+
+Production (15 мин):
+
+Проект: «Создайте плакат ‘Save Our Park’ с 5 советами на основе урока (используйте Present Perfect: ‘We have recycled...’)».
+
+ДЗ: «Напишите письмо мэру с 3 предложениями из вашего плаката».
+
+Критические моменты для промпта:
+Жесткая привязка к контенту учебника:
+
+«Не придумывай слова/грамматику — бери только с фото страницы».
+
+Проверка на противоречия:
+
+«Если учитель указал тему ‘Food’, а на странице текст про спорт — предупреди: ‘Тема урока не совпадает с учебником. Использовать спортивную лексику?’».
+
+Работа с визуалом:
+
+«Если на странице есть схемы/таблицы — используй их для наглядности в Presentation».

app/quotes.py

@@ -0,0 +1,35 @@
+quotes = [
+    "<em>«Речь - не только средство общения, но и орудие мышления.»</em><br>Р.Е. Левина, 'Основы теории и практики логопедии' (1968)",
+    "<em>«Это естественная форма деятельности ребенка, и именно через игру можно эффективно воздействовать на речевые нарушения»</em><br> Г.А. Волкова",
+    "<em>«Все свои замечания и исправления педагог должен делать тактично, не раздражая и не обижая ребенка, но искренно сочувствуя ему»</em><br> М.Е. Хватцев",
+    "<em>«Логопед должен быть и врачом, и педагогом, и психологом.»</em><br>С.С. Ляпидевский, 'Невропатология' (1965)",
+    "<em>«Речь - это зеркало души, отражающее её состояние.»</em><br>В.К. Орфинская, 'Методы работы при алалии' (1963)",
+    "<em>«Коррекция речи - это создание условий для естественного развития.»</em><br>О.В. Правдина, 'Логопедия' (1973)",
+    "<em>«Заикание - не болезнь, а привычка, которую можно изменить.»</em><br>Ф.А. Рау, 'Заикание и его преодоление' (1948)",
+    "<em>«Логопед открывает ребёнку мир, где слова обретают смысл.»</em><br>Т.Б. Филичева, 'Логопедическая работа в специальном детском саду' (1987)",
+    "<em>«Заикание - вызов, который можно преодолеть.»</em><br>В.И. Селивёрстов, 'Заикание у детей' (1994)",
+    "<em>«Речевая патология - не тупик, а особый путь развития.»</em><br>Е.М. Мастюкова, 'Ребёнок с отклонениями в развитии' (1992)",
+    "<em>«Дислексия - иной способ восприятия текста.»</em><br>О.Б. Иншакова, 'Альбом для логопеда' (2003)",
+    "<em>«Ребёнок с нарушением речи - прежде всего ребёнок.»</em><br>Г.В. Чиркина, 'Коррекция нарушений речи' (2009)",
+    "<em>«Логопедия - это наука о возможностях.»</em><br>Т.Г. Визель, 'Основы нейропсихологии' (2005)",
+    "<em>«Игра - главный инструмент в работе с речью.»</em><br>Е.А. Стребелева, 'Коррекционно-педагогическая помощь' (2008)",
+    "<em>«Речь формируется в диалоге, а не в упражнениях.»</em><br>А.В. Ястребова, 'Преодоление общего недоразвития речи' (1999)",
+    "<em>«Мотивация - двигатель речевого развития.»</em><br>Л.Г. Парамонова, 'Логопедия для всех' (2002)",
+    "<em>«Ошибки в речи - это ступени к правильному произношению.»</em><br>Т.А. Ткаченко, 'Если дошкольник плохо говорит' (2001)",
+    "<em>«Ребёнок учится говорить, когда ему есть что сказать.»</em><br>С.Н. Шаховская, 'Логопедическая работа с детьми' (1985)",
+    "<em>«Логопед не исправляет речь, а помогает ей развиваться.»</em><br>В.К. Воробьёва, 'Методика развития речи' (2006)",
+    "<em>«Речевые нарушения - это сигналы, а не приговор.»</em><br>Р.И. Лалаева, 'Логопедическая работа в коррекционных классах' (1998)",
+    "<em>«Главное в логопедии - видеть личность за дефектом.»</em><br>Б.М. Гриншпун, 'Дефектология и логопедия' (1983)",
+
+    # Зарубежные
+    "<em>«Речь - это мост между мыслью и действием.»</em><br>Чарльз Ван Райпер (1954)",
+    "<em>«Заикание - это не то, что у тебя есть, это то, что ты делаешь.»</em><br>Оливер Бладстайн (1987)",
+    "<em>«Логопедия - это не исправление ошибок, а раскрытие потенциала.»</em><br>Рэймонд Д. Кент (1994)",
+    "<em>«Язык рождается из потребности человека соединиться с другим человеком.»</em><br>Роман Якобсон (1960)",
+    "<em>«Говорить - значит быть человеком.»</em><br>Пол Брока (1861)",
+    "<em>«Лучший способ помочь ребёнку заговорить - это слушать.»</em><br>Элейн Силлман",
+    "<em>«Даже самая сложная речь начинается с одного слова.»</em><br>Барри Гутар (1982)",
+    "<em>«Молчание — это не отсутствие речи, а её начало.»</em><br>Питер Рэминг (1985)",
+    "<em>«Если вы видите в человеке то, чего он в себе не видит, — он этим становится.»</em><br>Виктор Франкл",
+    "<em>«Ожидания взрослых напрямую влияют на прогресс ребёнка»</em><br>Пигмалилион в классе, Р. Розенталь и Л. Джекобсон (1968)"
+]

app/styles.css

@@ -0,0 +1,69 @@
+/* Основной фон */
+/*.gradio-container {
+    background-color: #fef3c7;
+} */
+
+/* Заголовок */
+/* .main-title h2 { */
+  text-align: left;
+  font-size: 2rem;
+  margin: 0; /* Убираем отступы вокруг заголовка */
+  /*color: #003366;*/
+  margin-bottom: -5px; !important /* Убираем отступ снизу заголовка */
+  padding: 0;
+}
+
+
+/* Цитата */
+.quote-block {
+  text-align: left;
+  /*font-style: italic;*/
+  padding: 0;
+  margin: -1px 0 0 0; /* верхний небольшой отступ, снизу чуть больше */
+  /*max-width: 30em;*/ /* ограничиваем ширину, чтобы не тянулась на всю строку */
+  line-height: 1.4em;
+}
+
+
+/* .left-col {  */
+/*   background-color: #CDE8FA; /* более тёмный голубой */
+/*   padding: 20px; */
+  /* Можно и цвет текста подкорректировать */
+/*   color: #003366; */
+/*  } */
+
+.right-col {
+  background-color: #F0FAFF; /* посветлее */
+  padding: 0px;
+  color: #fef3c7;
+}
+
+  /* Поле для конспекта */
+#plan-output {
+  border: 2px dashed #bbb;
+  border-radius: 12px;
+  background-color: ##f5f5f5;
+  padding: 20px;
+  min-height: 1050px;
+  font-style: italic;
+  color: #555;
+  box-shadow: 0 2px 6px rgba(0,0,0,0.05);
+}
+
+/*#f5f5f5*/
+
+/* Стилизуем заголовок аккордеона (самую "кнопку") */
+.feedback-button {
+    font-weight: bold;
+    text-align: center;
+    background-color: #f1f1f1;
+    padding: 12px 18px;
+    border-radius: 10px;
+    margin-top: 12px;
+}
+
+.feedback-confirmation {
+    display: block !important;
+    margin-top: 10px;
+    color: green;
+}