multi photos - in process

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -4,8 +4,8 @@
 
 #bot/config.py
 .env
-
-
+Materials/
+dev/
 __pycache__/
 .idea/
 .idea/workspace.xml

TASKS.md

@@ -18,23 +18,51 @@
 [ ] загрузка нескольких страниц учебника
 [ ] интеграция настроек
 [ ] мотивационный блок в приложении - напр. цитата из педагогики, мотивационная, каждый раз новая
+[ ] ФГОСи методреки как гайдлайн (интересная проверка как будет выстроен урок по ним)
+[ ] версия - без материала. Полностью с нуля по web search составленный урок
+[ ] построение портрета ученика - по региону, описанию школы
 
+[ ] сравнить gpt-4.1 и o4-mini
+[ ] вынести в промпте в отдельный блок рекомендации по занятияю и classroom management (по запросу - дополнительная опция)
+[ ] генерация частей урока - захотел переделал вступление, и каждое задание - отдельно
 
+[ ] можно превратить в интерактивный обучающий курс. Где части плана объясняются, поясняется методика, даются ссылки на видео с уроками и тд. Вдохновение: https://maxenglishcorner.com/lessons/teaching-ideas/teaching-ideas-7-lesson-planning-ppp-model/
+[ ] эту идею описать в портфолио как продолжение MVP
 
+[ ]
 ## in progress
-[ ]  базовый MVP: загрузка > url > LLM1 > настройки > LLM2 > план урока и возможность скачать. Streamlit
-[ ] проверка различных основных учебников
+[ ] интерфейс, аналогичный logoKonspekt
+[ ] автозаполнение поля Учебник (по словарю)
+[ ] закомментить параметры, которые не будут в релизе - прописать к ним логику развития
+[ ] 2-3 страницы в input
+[ ] web search
+
 
-[ ] проверка Responses API - web_search, vision
 
 ## done
 [x] базовая проверка LP через LLM -- фото страницы Spotlight 6 + gpt4o = успешно
 [x] проверка Responses API - работа с БЗ -- работает успешно через официальный openai ResponsesAPI ()
 [x] UI приложения базово - Layout, набор регуляторов 
-
-
+[x] проверка Responses API - web_search, vision
+[x]  базовый MVP: загрузка > url > LLM1 > настройки > LLM2 > план урока и возможность скачать. Streamlit
+[x] проверка различных основных учебников
+[x] промпт для методики PPP - динамический
+[x] параметры корректно передаются в промпт динамически
 
 Нужен ли поиск по web?
     Да, если это подкрепляет vision
 Нужен ли поиск по БЗ? 
-    Да, если нужны коллекции материалов
+    Да, если нужны коллекции материалов
+
+Название учебника (+edition) + Номер страниц учебника:
+    + web search:
+        поиск аудио к конкретным учебникам (если в открытом доступе)
+
+Описания методик
+
+Примеры хороших планов ESL
+
+LLM + web_search + инструкция: найди дополнительный материал в соответствии с общим контекстом урока:
+    Интеграция релевантных материалов в план
+
+LLM + file_search: интеграция в план занятий из базы

app/.gradio/certificate.pem

@@ -0,0 +1,31 @@
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----

app/drawings.py

@@ -0,0 +1,108 @@
+drawings = [
+    # 1. Доска с началом урока
+    r"""
+      _________________________________
+     |                                 |
+     |      W E L C O M E !            |
+     |                                 |
+     |   Today's Plan:                 |
+     |   • Warm-up: [_____]            |
+     |   • New words: [_____]          |
+     |   • Game: [_____]               |
+     |   • Project: [_____]            |
+     |                                 |
+     |   \                             |
+     |    \   (^_^)                    |
+     |     `--|_|--'                   |
+     |       / \                       |
+     |_________________________________|
+    """,
+
+    # 3. Работа в группах
+    r"""
+      .─────────────────.
+     |    _____  _____   |
+     |   /     \/     \  |
+     |  |  o  ||  o  |  |
+     |   \____/\_____/   |
+     |                   |
+     |   "Let's share!"  |
+     |    /\       /\    |
+     |   /  \_____/  \   |
+     |  |   GROUP 1   |  |
+     '─────────────────'
+    """,
+
+    # 4. Обсуждение
+    r"""
+       _______________________
+      /                       \
+     |    ?       ?       ?    |
+     |   / \     / \     / \   |
+     |                         |
+     |       IDEA STORM        |
+     |                         |
+     |    o     o     o        |
+     |   <|>   <|>   <|>       |
+     |    /\    /\    /\       |
+     \_________________________/
+    """,
+
+    # 5. Активное занятие
+    r"""
+      ╔═════════════════════╗
+      ║    RUN AND FIND!    ║
+      ╠═════════════════════╣
+      ║                     ║
+      ║    (\_/)    (•.•)   ║
+      ║   / >☆< \  / > < \  ║
+      ║                     ║
+      ║  "I found yellow!"  ║
+      ║                     ║
+      ╚═════════════════════╝
+    """,
+
+    # 6. Творческий проект
+    r"""
+       .-------------------.
+      |      ___            |
+      |     /   \      ✏️   |
+      |    |     |     ___  |
+      |     \___/     /   \ |
+      |              |     ||
+      |    OUR       \___/ |
+      |    POSTER!         |
+      |       \_____/      |
+      |        |   |       |
+      '-------------------'
+    """,
+
+    # 7. Время вопросов
+    r"""
+      ________________________
+     |                        |
+     |   ?             ?      |
+     |  / \           / \     |
+     |                        |
+     |     "But why...?"      |
+     |         \              |
+     |          \    (｡◕‿◕｡) |
+     |           \____________|
+     |                        |
+     |________________________|
+    """,
+
+    # 8. Успех
+    r"""
+       ╭───────────────────╮
+       │                   │
+       │     ★ ★ ★ ★ ★     │
+       │                   │
+       │   WE DID IT!      │
+       │    \             │
+       │     \   \(^o^)/  │
+       │     __\________   │
+       │                   │
+       ╰───────────────────╯
+    """
+]

app/knowledge_base/LP_shots.py

@@ -0,0 +1,243 @@
+LP_PPP_1 = f"""
+CLASS - - - Intermediate level, 4 students
+THEME FOR CLASS - - - Pollution
+TARGET LANGUAGE (TL) - - - 1st and 2nd conditonals
+OBJECTIVE FOR CLASS - - - By the end of the class the students should be able to know the difference between
+first and second conditionals and be able to use both forms while speaking about pollution.
+MATERIALS - - - 
+ ● 3 pictures to be used in the CONTEXT stage (from Pixabay)
+ ●Handout 1 - Reading: Article about air pollution plus corresponding reading exercises
+ citation: (This article was written by Katy Daigle and has been adapted from
+ https://www.sciencenewsforstudents.org/article/air-pollution-shortening-lives-worldwide)
+ ●Handout 2 - Worksheet for PRACTICE activities with summary reference chart at top of page
+
+---
+1. CONTEXT or WARMER/THEME
+
+OBJECTIVE(S) 
+●To get the students speaking and communicating a little in English.
+●To orientate students to begin thinking of different kinds of pollution. There are three
+pictures (one each of air, land and water pollution).
+
+MATERIALS 
+3 pictures from Pixabay
+(different kinds of pollution: air, land & water)
+Students are placed into pairs (more intimate groups this way, and more students will be speaking) and given 3
+pictures. Together they have to
+1) Describe each picture individually
+2) Decide what all three pictures have in common
+Teacher monitors and helps out a little if there are problems with vocabulary
+After the pair-work the teacher asks the students to say what they came up with
+
+
+2. INTRODUCTION
+
+OBJECTIVE(S) 
+● To pre-teach some vocabulary found in the reading (ex: lifespan)
+●To orientate students to some of the content (concepts) in the article
+
+MATERIALS 
+none, other than the whiteboard
+
+
+●Elicit the meaning of ‘lifespan’ from the class
+●Ask the students to answer the question written on the board:
+What are some common causes for shorter life spans in some countries? (for example diet, pollution and cancer)
+
+
+3. INPUT TASK 1: READING FOR GIST
+
+OBJECTIVE(S) 
+● To have the students get a general idea of what the text is about
+without getting bogged down with unfamiliar vocabulary or some unclear parts or ideas
+MATERIALS Handout 1 with article and two sets of questions. One set is for
+this task where the students have to decide which of the three given titles is most suitable
+●The students are given a handout which contains both the article to read and two sets of questions. The students are
+asked to fold their papers so they could focus completely on that first task (and not reading ahead to see what is next on
+the handout).
+●Students understand the task before they begin reading and are given only one minute to decide which title would be
+best for the article.
+●After one minute students are asked not only for their answer, but also why the other options were not correct or
+suitable.
+
+
+4. INPUT TASK 2: READING FOR DETAILS
+
+OBJECTIVE(S) ● 
+To have the students get a better idea of what the text is about
+by quickly scanning it for specific information
+MATERIALS Handout 1 with article and two sets of questions. This task is the
+second set of 3 questions found at the bottom of the article
+
+● Students are told to look at Section 2 on their handout
+●We go over the questions so the students understand what they have to read for
+●Students work out the answers individually but can check with other students
+●The answers are elicited and explained.
+
+5. PRESENTATION
+
+OBJECTIVE(S) 
+● To familiarize the students with how the first and second
+conditionals are formed and to know what situations are appropriate to use which one
+MATERIALS 
+The form, concepts and examples are written on the board
+
+●Ask the students what they know about the grammatical structure of conditionals.
+●Focus on what they know about the first and second conditionals and write the information on the board in a clear and
+organized way (which resembles the chart in Handout 2.
+●Review the key points by asking different students comprehension check questions to see what they understand and
+how well they are retaining the key information.
+
+6. PRACTICE 1 CORRECT SENTENCES
+
+OBJECTIVE(S) ● To test for level of understanding as students apply some of the
+recently reviewed key concepts by correcting 4 sentences with errors emphasizing those
+points.
+MATERIALS Handout 2 with a chart for reference of key idea (#1) and the task
+of correcting the four sentences (#2)
+
+●Point out the 4 sentences in Section 2 and tell the students to correct them.
+●Monitor the students while they are working to see what they find difficult.
+●Elicit the answers and their explanations / Also deal with their doubts as we go over their answers.
+●Review the key points before going on to Practice 2
+
+7a. PRACTICE 2a WRITE & USE QUESTIONS 1-ST CONDITIONAL
+
+OBJECTIVE(S) 
+● To have the students come up with their own sentences using the
+first conditional structure for an appropriate situation, matching the form with the function
+● To have the students become familiar with incorporating the TL into their speaking
+MATERIALS 
+Handout 2 Section #3
+●Focus on only the first conditional as the TL (target language) and elicit the key points to orientate the students.
+●Students look at Section #3 on Handout 2 and teacher elicits different possible questions they could ask in that form.
+●Students individually write first conditional questions to ask a partner in the class. Teacher monitors and helps.
+●Model the coming speaking application by having one student ask another his/her question and the partner replies.
+Encourage them to explore a little further by changing it into a ‘mini one-minute conversation’ through asking followup questions and volunteering comments or details.
+●Place students in pairs and have them take turns with their questions which lead them to their mini conversations.
+●Give some feedback when they are finished, looking both at the target language used and their development of the
+mini conversations.
+
+7b. PRACTICE 2b WRITE & USE QUESTIONS 2ND CONDITIONAL
+
+OBJECTIVE(S) 
+● To have the students come up with their own sentences using the
+second conditional structure for an appropriate situation, matching the form with the
+function
+● To have the students become familiar with incorporating the TL into their speaking
+MATERIALS Handout 2 Section #4
+●Focus on only the second conditional and elicit the key points to orientate the students.
+●Basically the same procedure as the previous exercise, but now for Section 4 and focusing on the second conditional.
+
+7c. PRACTICE 3 PREPARE FOR DISCUSSION 
+
+OBJECTIVE(S) 
+● To help students prepare for coming discussion
+MATERIALS Handout 2 Section #5
+ Some prompts in Section #6 they can use in their conversation
+●Tell the students that soon they will have a discussion about the theme of air pollution. They are to talk about how
+bad it is and what can be done about it. Elicit some possible sentences/questions for the two conditionals as examples.
+●Students each write one first conditional sentence or question and another one in the second conditional that they
+might use in that discussion.
+●Teacher monitors and helps.
+●Because there are only four students, place them all in the same group and tell them they are enjoying a cup of coffee
+together. They are to imagine that the conversation has turned to air pollution and without referring to their notes, they
+talk about how bad the situation is and speculate what could be done about it, using occasionally, if it’s appropriate, the
+first or second conditional. The main focus is to have a conversation and that they should explore the theme.
+●Go over the expressions in Section #6 that they can use while speaking and write them on the board as prompts
+●Teacher listens and steps in, if necessary, to guide and encourage the students to explore the theme in their
+conversation.
+●Give some feedback when they are finished, looking both at the target language used and their development of the
+discussion.
+
+
+8. PRODUCTION
+
+OBJECTIVE(S) 
+● To use the two conditionals in a Production speaking activity
+MATERIALS 
+none 
+
+●Tell the students they are going to have one more conversation using the first and second conditional. This time it
+will be about land and water pollution or pollution in general.
+●Tell them they can think for a couple of minutes about what they may say or ask about that theme. Remind them of
+some of the things that came up in the previous speaking activity. Also tell them that the teacher will not be
+participating; that it will be just their conversation.
+●Students speak for about 5 minutes.
+●Give some feedback when they are finished, looking both at the target language used and their development of the
+discussion.
+"""
+
+LP_PPP_2 = f"""
+1 OBJECTIVES
+By the end of the class the students should be able to use the past continuous while engaging in a conversation about what they did last weekend
+
+2 CONTEXT
+●Show some pictures of people doing fun or relaxing things and students describe them (learning the relevant vocabulary such as the action verbs – reading a book, playing tennis, etc)
+●Then the students ask the teacher questions to find out what s/he did last weekend or typically does on the weekend. (It’s fine if the students don’t use the past continuous and they shouldn’t be expected to if they haven’t been taught it yet. In fact, the past continuous isn’t part of the lesson plan until later in the Presentation stage).
+
+3 INPUT TASK 1: READING FOR GIST
+Best title
+●Write on the board 3 titles and tell the students they have to decide which one (A, B or C) is the most suitable for the reading. 
+●Give the students the reading and 60 seconds to complete the task. 
+●Ask the students to say their choice(s) and say why. When all the choices have been gone over, tell them the correct answer.
+
+4 INPUT TASK 2: READING FOR SPECIFIC INFORMATION
+●Give the students a handout with six sentences. All six sentences reflect what happened in the text they just read, but each sentence has one mistake. Students are asked to look at the example of the first sentence and make similar corrections for the remaining five. NOTE: These mistakes reflect understanding the contents of the text, NOT any grammar errors. Ex: Julie went to the market on Saturday. Friday 
+●Students complete task individually, compare answers with another student, then go over their answers as a class.
+© maxenglishcorner.com 2020 PPP lesson planning example 2 
+
+5 PRESENTATION 1
+PAST CONTINUOUS: Form & Ongoing Action in Past
+●Write on the board two sentences found in the first paragraph of the text. Ex: There was a lot of traffic. Lots of people were going to the beach.
+●Elicit the names of the two verb forms and write them above the examples. 
+●Elicit the structure of each. (regular verb in past simple form = verb + ED) (past continuous verb has 2 parts: be auxiliary in past + verb in ING form) ●Elicit how to create the negative forms and write those sentences on the board ●Elicit how to create a WH question (and answer) ●Elicit how to create a YES/NO question (and positive & negative answer) ●Elicit when to use the past continuous. (Focus on Concepts 1 & 2 but accept others) These concepts are explained in Part D of The PPP Model Explained and refer to particular situations that would be appropriate for using the past continuous. You want the students to understand that they can use the past continuous form when describing a general situation happening in the past (ex: It was raining yesterday), or when a particular action lasted for a period of time and you want to bring attention to that (ex: It was raining all night).
+●Before continuing on to the Practice tasks, ask different students comprehension check questions, testing them on what they understand of what has been presented so far. 
+6 PRACTICE set 1
+PRACTICE 1-1
+●Give students worksheet. Explain exercise 1-1: There are 5 gap-fill sentences to complete, writing the past continuous form with the provided prompts. Ex: She __________ football yesterday. (not play) (She wasn’t playing football yesterday.)
+●Students do it individually, check in pairs, then go over answers with class
+PRACTICE 1-2
+●Exercise 2 on worksheet. Students invent answers to respond to WH and Yes/No questions. Ex: What were they doing? __________ (They were sleeping. – for example) Was he studying? (+) __________ OR (-) __________ (Yes, he was. OR No, he wasn’t.) ●Model one or two examples first.
+●As above, students do it individually, check in pairs, then the answers are gone over
+PRACTICE 1-3
+Have the students ask you past continuous questions about your last weekend. Encourage both WH & Yes/No questions. Allow other questions too, like past simple and present simple, and if they make mistakes, guide them by eliciting the right form of question to ask or the key elements which would help them decide which form to use.
+7 PRESENTATION 2
+PAST CONTINUOUS: Action happening at a specific time in the past
+●Write on the board the following question and answer: What were you doing at ten o’clock last night? I was watching TV.
+●Elicit if the action was for a duration (ex: for 3 hours) (No), a description in general (ex: the sun was shining) (No) or for an action happening (in progress) at a specific time in the past (Yes!)
+© maxenglishcorner.com 2020 PPP lesson planning example 2
+●Point out that this is a different function (situation to use the verb tense). Ask students if there are any changes to the form in the question or answer. (No)
+●Draw a time line (see Concept #5) As in Presentation 1, the past continuous can be used in different situations. In this case it is for a continuous action happening at a certain point in time in the past.
+●Elicit or provide more WH questions: - - What were you watching on TV (at that time)? - - Who were you watching TV with (at that time)? - - What were you doing at 11:00 last night?
+●And elicit some Yes/No questions:
+- - Were you watching TV at 10:30? (Yes, I was. // No, I wasn’t.) - - Were you eating at 6:15?
+8 PRACTICE set 2
+PRACTICE 2-1
+●Students write questions to ask partner about last night (with specific times). If students seem to be able to handle it, ask them to write two WH questions and two Yes/No questions. If not, do 3 WH questions only. ●Teacher monitors and helps/guides when necessary.
+PRACTICE 2-2
+●Students are placed into pairs. One student is to ask a WH question, and the other answers it. Model first with two students so they are clear on the task instructions. Then students carry out the task and the teacher monitors. ●In the same pairs, students change roles.
+PRACTICE 2-3
+●If only WH questions were done previously, then repeat tasks 2-1 and 2-2 but for Yes/No questions this time.
+9 PRESENTATION 3
+Focus on enriching the students’ approach to speaking
+●Teacher goes into ‘hot seat’ role where students have to ask WH and Yes/No questions about what s/he was doing yesterday. ●Teacher points out that simply asking a list of unrelated questions soon exhausts the activity. The students can enrich their speaking by 1) asking follow-up questions – not all of which have to be in the past continuous form (ex: Do you do that every night?) 2) making comments – (ex: That’s interesting. Me too. I was doing that too.) 3) volunteering information about themselves – I don’t like to watch TV. I prefer to do other things in my free time…..) ●Teacher chooses one student to be in the hot seat and the class asks that person about her/his day yesterday. The teacher encourages follow-up questions, comments from the class, as well as volunteering information about themselves.
+© maxenglishcorner.com 2020 PPP lesson planning example 2 10 PRACTICE set 3
+PRACTICE 3-1
+●Students are divided into groups of 3 or 4, one person in each group is in the hot seat, and they ask and speak about yesterday. (Some questions and sentences are in the past continuous, but many aren’t.) Teacher monitors. ●After a few minutes the teacher tells the students to select a new person for the hot seat. Teacher monitors.
+After a few more minutes teacher stops activity and addresses class, offering a little feedback (such as encouragement, advice and eliciting corrections to some mistakes).
+PRACTICE 3-2 Dress Rehearsal for Production Speaking Activity
+●Students stay in the same groups. Rather than focusing on just one person who is in a hot seat role, tell them to imagine they are having a coffee together and a short conversation about what they did yesterday. Encourage the people to all participate, volunteer information, make comments and ask questions, including follow-up questions.
+●Teacher monitors and prompts them as the students attempt to have a conversation for five minutes.
+●At the end of the activity, teacher gives some feedback such as tips, recognition of what they were doing well, some corrections on mistakes made when using the past simple or continuous, and more encouragement for everyone to participate in the conversation.
+11 PRODUCTION
+●The teacher changes the groups so there are new members in each group.
+●The students are told to do the same thing as before, only now the theme of their conversation is to talk about last weekend. They can find out how their weekends were similar or different, and if the weekend was unusual or like every other weekend.
+●This time the teacher does not intervene and s/he tells them so. They will have up to 5 minutes to speak about the theme and the teacher will not be participating or helping in any way. It is up to them to maintain the conversation.
+●The students engage in their conversations the best they can.
+12 FEEDBACK
+●As with the dress rehearsal, the teacher gives feedback in the form of corrections, tips and reminders, and pointing out what the students did well.
+HOMEWORK
+●The students have to write 150 words about what they did last weekend, including at least one example of the past continuous for Concept 1* and at least one example of Concept 5*.
+*NOTE: ‘Concept 1’ and ‘Concept 5’ are not the official names or numbers of these referenced situations. They were only used for the purposes of this article and can be seen as they were presented in The PPP Model Explained, Section D. They could very easily be called Situation 1 and Situation 2 or any other title that the teacher may prefer to use.
+"""

app/knowledge_base/Methods.md

@@ -0,0 +1,113 @@
+1. Логика построения урока: цепочка решений
+Диагностика входных данных
+
+Учитель отмечает: учебник, страница, тема, уровень, возраст, цель (в широком смысле).
+
+LLM сканирует страницу, извлекает явные элементы (лексика в рамке, заголовки, упражнения) и составляет первичный список «возможного целевого языка» (слов, структур, функций).
+
+Выбор целевого языка (teacher-in-the-loop)
+
+LLM выдаёт 2–3 кандидатуры “target language” (например, “Present Perfect for life experiences”, “Vocabulary: holiday activities”), на основе чего есть на странице.
+
+Учитель подтверждает или уточняет (дописывает свой вариант).
+
+Построение плана по фазам PPP
+
+Presentation: LLM предлагает контекст-активность, опираясь на выбранный target language.
+
+Practice: LLM генерирует контролируемые упражнения по выбранному языку.
+
+Production: LLM предлагает коммуникативное задание, где ученики применяют язык.
+
+Учитель верифицирует и дорабатывает
+
+Промпт закладывает, что LLM после генерации каждого этапа спрашивает: “Нужны ли дополнительные опоры (чек-лист, подсказки)?”
+
+Учитель вносит правки, модель «догружает» до финальной версии.
+
+
+
+
+
+
+
+
+
+
+Метод PPP даёт прочный каркас, а гибкость в упражнениях позволяет адаптировать урок под возраст и уровень учеников.
+
+
+Методика | Суть | Когда применять
+PPP (Presentation-Practice-Production) | Чёткая трёхступенчатая структура: презентация языка → контролируемая практика → свободное применение. | Уровни A1–B1, акцент на грамматике/лексике, нуждается в высокой структурированности урока .
+TTT (Test-Teach-Test) | Сначала диагностическое задание (тест), затем целевое обучение, затем повторный тест. | Подготовка к экзаменам (IELTS, TOEFL), уровни B1+, когда важно оценить и проработать пробелы .
+ESA (Engage-Study-Activate) | Гибкая чередующаяся модель: вовлечение → изучение → активизация. | Когда нужна вариативность, интеграция коммуникативных задач и языкового разборе; подходит для всех уровней .
+TBL (Task-Based Learning) | Урок строится вокруг смысловой задачи; языковой фокус после выполнения. | Коммуникативная практика, survival-skills, взрослые/подростки B1+; длительные проекты .
+TPR (Total Physical Response) | Физические действия в ответ на языковые команды. | Младшие школьники, A1–A2, ввод глагольной лексики, сниженная тревожность .
+PBL (Project-Based Learning) | Долгосрочные проекты по проблемному вопросу. | Школьный возраст, смешанные уровни, междисциплинарные темы, развивает крит. мышление и навыки 21 века .
+CLIL (Content and Language Integrated Learning) | Изучение предмета (науки, истории) через ИЯ. | Когда цель — одновременно развивать предметные и языковые компетенции; старшие классы .
+Лексический подход | Фокус на лексических «чанках» (collocations), а не на грамматике. | Расширение говорения и понимания «нативных» фраз, уровни B1+ .
+Грамматико-переводной (GTM) | Изучение грамматических правил + перевод. | Академические группы, старшие подростки/студенты, чтение литературы .
+Прямой метод | Полное погружение: только ИЯ, индуктивное изучение грамматики. | Низкие-средние уровни, малые группы, когда цель — устная беглость .
+Аудиолингвальный (ALM) | Повторение, имитация, структурные упражнения. | Быстрая отработка структур, курсы в языковых лабораториях, уровни A1–B1 .
+
+
+Параметр | Рекомендации по выбору методики
+CEFR-уровень | A1–A2: PPP, TPR, ALM; B1–B2: ESA, TBL, Лексический; B2–C1: CLIL, TBL, GTM (для чтения) .
+Возраст | Дети (6–10): TPR, ESA; Подростки (11–17): PPP, ESA, PBL; Взрослые: TBL, CLIL, GTM .
+Количество учеников | Индивидуально/малые группы: Direct Method, ALM, TTT; Большие группы: ESA, PPP, TBL .
+Тема и цель | Грамматика/лексика: PPP, ALM; Коммуникация: ESA, TBL; Проект/исследование: PBL, CLIL .
+Длительность | 30–45 мин: PPP, TPR; 60–90 мин: ESA, TBL; более 1 урока: PBL, CLIL .
+Оборудование | Минимум (доска, карточки): PPP, Direct; Tech-rich (видео, интернет): ESA, CLIL, PBL .
+Доп. сведения от учителя | Экзаменационная цель → TTT; Особенности учеников (интересы) → ESA, PBL .
+
+
+Гибкость vs. структура
+
+Укажите, где методика должна быть жёстко соблюдена (этапы PPP) и где возможна вариативность (ESA-фазы, творческие задания).
+
+Примеры
+
+Приведите 1–2 коротких образца активности (не целый план), чтобы задать тон (например, «групповое задание: спланировать…»).
+
+Критерии качества
+
+Опишите, на что обратить внимание: достижение цели, интересность, соответствие уровню, баланс навыков.
+
+Творческий простор
+
+Добавьте фразу: «Предлагай нестандартные идеи, но обосновывай их ссылкой на методику».
+
+Итого, для надёжного промпта достаточно:
+
+кратких описаний методик (экстракты),
+
+чёткого перечисления ваших параметров,
+
+примеров активностей,
+
+критериев оценки.
+
+
+
+
+Класс цели | Подкласс / тип | Пример формулировки цели | Когда актуально
+1. Навыковые (Skills) Macmillan Education ELT 
+ | • Чтение (Reading) | «Уметь находить в тексте информацию по конкретному вопросу» | Подготовка к экзаменам, работа с аутентичными текстами
+ | • Аудирование (Listening) | «Понимать основную идею аудиозаписи на бытовую тему» | Уроки восприятия речи, фильмы, аудиоматериалы
+ | • Говорение (Speaking) | «Свободно рассказать о своём вчерашнем дне» | Коммуникативные уроки, ролевые игры
+ | • Письмо (Writing) | «Написать письмо–запрос на английском языке» | Деловой английский, подготовка к письменным заданиям
+2. Языковые (Language) 
+ | • Лексика (Vocabulary) | «Выучить 15 новых слов по теме “Путешествия”» | Уроки лексического развития
+ | • Грамматика (Grammar) | «Освоить Past Perfect для описания завершённых действий» | Фокусные грамматические занятия
+ | • Функциональный язык (Functions) | «Уметь просить и давать указания (imperatives)» | Диалоговые ситуации, телефонирование
+ | • Произношение (Pronunciation) | «Отрабатывать звуки /θ/ и /ð/ в словах и предложениях» | Фонетические тренировки
+3. Стратегии (Strategies) 
+ | • Learning strategies | «Научиться конспектировать аудиотекст» | Развитие автономии, подготовка к академическим целям
+ | • Reading strategies | «Использовать сканирование (skimming) для общей идеи» | Работа с большим объемом текста
+4. Коммуникативные (Communicative) 
+ | • Fluency vs Accuracy | «Развить беглость речи при рассказе истории» | Свободное общение, дискуссии
+ | • Interaction skills | «Уметь поддержать беседу в паре по заданной теме» | Парная/групповая работа
+5. Междисциплинарные / жизненные (Life & 21st-C) 
+ | • Critical thinking | «Анализировать и критиковать аргументы в тексте» | Старшие классы, CLIL-проекты
+ | • Collaboration skills | «Совместно спланировать школьное мероприятие» | Проектная работа (PBL)
+ | • Cultural awareness | «Понимать различия в межкультурном общении» | CLIL, межкультурные обмены

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/inspire.md

@@ -0,0 +1,9 @@
+The theories behind it, the materials and activities that become part of it, the suggestions and the models one can follow, all have to deal with the inevitable:  
+that it is only a plan and whatever shape it takes, it is to be used in the classroom.
+
+
+Креативные варианты:
+
+«Создайте мем с фразой из текста и обсудите её значение».
+
+«Найдите «странное» предложение в тексте и объясните, почему оно выделяется».

app/knowledge_base/lesson_frameworks.md

@@ -0,0 +1 @@
+ва  ва

app/knowledge_base/test.md

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

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/textbooks.py

@@ -0,0 +1,79 @@
+# Список учебников для автоподстановки (серия + уровень)
+TEXTBOOKS = [
+    # Spotlight
+    "Spotlight Starter", "Spotlight 2", "Spotlight 3", "Spotlight 4",
+    "Spotlight 5", "Spotlight 6", "Spotlight 7", "Spotlight 8",
+    "Spotlight 9", "Spotlight 10", "Spotlight 11",
+
+    # English File
+    "English File Beginner", "English File Elementary", "English File Pre-Intermediate",
+    "English File Intermediate", "English File Upper-Intermediate", "English File Advanced",
+
+    # Headway
+    "Headway Beginner", "Headway Elementary", "Headway Pre-Intermediate",
+    "Headway Intermediate", "Headway Upper-Intermediate", "Headway Advanced",
+
+    # Solutions
+    "Solutions Elementary", "Solutions Pre-Intermediate", "Solutions Intermediate",
+    "Solutions Upper-Intermediate", "Solutions Advanced",
+
+    # Grammar in Use
+    "Basic Grammar in Use", "English Grammar in Use", "Advanced Grammar in Use",
+
+    # Starlight
+    "Starlight 2", "Starlight 3", "Starlight 4", "Starlight 5",
+    "Starlight 6", "Starlight 7", "Starlight 8", "Starlight 9",
+    "Starlight 10", "Starlight 11",
+
+    # Другие популярные
+    "Family and Friends Starter", "Family and Friends 1", "Family and Friends 2",
+    "Family and Friends 3", "Family and Friends 4", "Family and Friends 5",
+    "Family and Friends 6",
+    "Cutting Edge Starter", "Cutting Edge Elementary", "Cutting Edge Pre-Intermediate",
+    "Cutting Edge Intermediate", "Cutting Edge Upper-Intermediate", "Cutting Edge Advanced",
+    "Round-Up Starter", "Round-Up 1", "Round-Up 2", "Round-Up 3",
+    "Round-Up 4", "Round-Up 5", "Round-Up 6",
+
+    # Для взрослых (General English)
+    "Global Beginner", "Global Elementary", "Global Pre-Intermediate",
+    "Global Intermediate", "Global Upper-Intermediate", "Global Advanced",
+
+    "New English File Beginner", "New English File Elementary", "New English File Pre-Intermediate",
+    "New English File Intermediate", "New English File Upper-Intermediate", "New English File Advanced",
+
+    "Navigate A1", "Navigate A2", "Navigate B1", "Navigate B1+", "Navigate B2", "Navigate C1",
+
+    "Innovations Beginner", "Innovations Elementary", "Innovations Pre-Intermediate",
+    "Innovations Intermediate", "Innovations Upper-Intermediate", "Innovations Advanced",
+
+    "Speakout Starter", "Speakout Elementary", "Speakout Pre-Intermediate",
+    "Speakout Intermediate", "Speakout Upper-Intermediate", "Speakout Advanced",
+
+    # Бизнес-английский
+    "Market Leader Beginner", "Market Leader Elementary", "Market Leader Pre-Intermediate",
+    "Market Leader Intermediate", "Market Leader Upper-Intermediate", "Market Leader Advanced",
+
+    "Business Result Starter", "Business Result Elementary", "Business Result Pre-Intermediate",
+    "Business Result Intermediate", "Business Result Upper-Intermediate", "Business Result Advanced",
+
+    # Экзаменационные курсы
+    "Complete IELTS Bands 4-5", "Complete IELTS Bands 5-6.5", "Complete IELTS Bands 6.5-7.5",
+    "Objective First", "Objective Advanced", "Objective Proficiency",
+    "Ready for IELTS", "Ready for Advanced", "Ready for Proficiency",
+
+    # Для академических целей
+    "Academic Vocabulary in Use", "Grammar for Academic Purposes",
+    "Oxford EAP Beginner", "Oxford EAP Elementary", "Oxford EAP Pre-Intermediate",
+    "Oxford EAP Intermediate", "Oxford EAP Upper-Intermediate", "Oxford EAP Advanced",
+
+    # Специализированные
+    "English for Medicine", "English for IT", "English for Engineers",
+    "Legal English", "Financial English", "English for Tourism",
+
+    # Детские курсы (добавлено для полноты)
+    "Academy Stars Starter", "Academy Stars 1", "Academy Stars 2",
+    "Academy Stars 3", "Academy Stars 4", "Academy Stars 5", "Academy Stars 6",
+
+    "Guess What! 1", "Guess What! 2", "Guess What! 3", "Guess What! 4",
+
+]

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/main.py

@@ -0,0 +1,486 @@
+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
+from typing import Optional
+
+import random
+from app.quotes import quotes
+from app.drawings import drawings
+from app.knowledge_base.textbooks import TEXTBOOKS
+# --- Настройка ---
+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", "")  # vector store for file_search if needed
+
+# --- Утилиты ---
+def upload_to_catbox(file_bytes: bytes) -> str:
+    """Загружает файл на catbox.moe и возвращает URL"""
+    try:
+        response = requests.post(
+            "https://catbox.moe/user/api.php",
+            files={"fileToUpload": file_bytes},
+            data={"reqtype": "fileupload"},
+            timeout=10
+        )
+        response.raise_for_status()
+        return response.text.strip()
+    except Exception as 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
+
+# названия textbooks для автозаполнения поля Учебник
+import json
+
+## Сохраняем отзыв через POST в google-таблицу
+GOOGLE_SHEET_URL = os.getenv("FEEDBACK_GS_URL")
+
+def save_feedback(comment, rate):
+    payload = {
+        "comment": comment,
+        "rate": rate
+    }
+    try:
+        requests.post(GOOGLE_SHEET_URL, json=payload, timeout=3)
+    except Exception as e:
+        print(f"Ошибка при отправке отзыва: {e}")
+
+### ОСНОВНАЯ ФУНКЦИЯ ГЕНЕРАЦИИ
+def generate_lesson_plan(
+        image_path: Optional[str],
+        textbook: str,
+        cefr: str,
+        topic: str,
+        goal: str,
+        format_type: str,
+        num_students: int,
+        age: str,
+        adults: bool,
+        level_match: int,
+        duration: int,
+        inventory: str,
+        extra_info: str,
+        methodology: str,
+        target_language: str,
+        hw_required: bool,
+        web_search: bool
+        # repetition: bool,
+        # application: bool,
+        # analysis: bool,
+        # creativity: bool
+) -> str:
+
+    # Валидация API клиента
+    if not client:
+        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
+    lesson_params = {
+        'methodology': methodology,
+        'target_language': target_language, # для PPP
+        'textbook': textbook,
+        'cefr': cefr,
+        'topic': topic,
+        'goal': goal,
+        'num_students': num_students,
+        'age': 'Взрослые' if adults else age,
+        'level_match': level_match,
+        'duration': duration,
+        'inventory': inventory,
+        'hw_required': hw_required,
+        'extra_info': extra_info
+    }
+
+    # Получаем готовый промпт
+    from app.prompt_builder.prompt import build_prompt
+    full_prompt = build_prompt(lesson_params)
+
+    # Собираем входные данные согласно API
+    input_content = [
+        {
+            "type": "input_text",
+            "text": full_prompt
+        },
+        {
+            "type": "input_image",
+            "image_url": image_url,
+            "detail": "high"
+        }
+    ]
+
+    # Опции инструментов
+    tools = []
+    tool_choice = None
+    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(
+            input=[{"role": "user", "content": input_content}],
+            model="o4-mini", #  gpt-4o-mini    gpt-4.1
+            tools=tools or None,
+            tool_choice=tool_choice,
+            max_output_tokens=8192,
+            reasoning= {"effort":"medium"},
+            stream=False
+        )
+        return response.output_text
+
+    except Exception as e:
+        logging.error(f"Generation error: {e}")
+        raise gr.Error(f"Ошибка генерации: {e}")
+
+
+
+########## ИНТЕРФЕЙС
+# Случайный рисунок в блокноте
+drawing = random.choice(drawings)
+# Текст с подсказкой и рисунком в блокноте
+hint_text = f"""Здесь появится план занятия — заполните вводные и нажмите кнопку **Создать план**<br>
+Создание может занять до 1 минуты
+<pre>
+{drawing}
+</pre>
+"""
+
+#ТЕМА И СТИЛИ
+### css привязывать именно так
+#theme='earneleh/paris'
+theme = gr.themes.Base(
+    secondary_hue="rose",
+    neutral_hue="stone",
+).set(
+    body_background_fill='*primary_50',
+    body_text_color='*primary_900',
+    body_text_size='*text_lg',
+    body_text_color_subdued='*primary_700',
+    body_text_weight='600',
+)
+css_path = os.path.join(os.path.dirname(__file__), "styles.css")
+
+# ИНТЕРФЕЙС
+with gr.Blocks(theme=theme, css_paths=css_path) as app:
+    advanced_settings_visible = gr.State(value=False)  # Импортируем gr.State для хранения состояния
+    feedback_visible = gr.State(False)  # Хранит, открыт ли блок отзыва
+
+    gr.Markdown("# План урока английского языка", elem_classes=["main-title"])
+    quote_box = gr.Markdown(random.choice(quotes), elem_classes=["quote-block"])
+    with gr.Row():
+        with gr.Column(elem_classes=["left-col"], scale=1):
+            image = gr.Image(
+                label="Фото страницы учебника*",
+                type="filepath",
+                height=0,  # Автоматическая высота
+                container=False  # Не растягивать контейнер
+            )
+
+            # Блок 1: Учебник
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 📚 Учебник", elem_classes=["block-title"])
+                textbook = gr.Textbox(label="Название учебника", placeholder="напр. English File Beginner", elem_id="textbook_input")
+
+                cefr = gr.Dropdown(label="Уровень", choices=["", "A1", "A2", "B1", "B2", "C1", "C2"],
+                                   value="", info="Выберите уровень")
+            # Блок 2: Класс
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 👥 Класс", elem_classes=["block-title"])
+                format_type = gr.Radio(label="Формат занятия", choices=["Индивидуальное", "Групповое"],
+                                       value="Групповое")
+
+                with gr.Group(visible=True) as group_settings:
+                    num_students = gr.Slider(label="Количество учеников", minimum=1, maximum=40,
+                                             value=10, step=1, info="Для групповых занятий")
+
+                with gr.Group() as age_group:
+                    age = gr.Textbox(label="Возраст", placeholder="напр. 10–11", interactive=True)
+                    adults = gr.Checkbox(label="Взрослые")
+
+                level_match = gr.Dropdown(label = "Уровень учеников относительно учебника",
+                    choices = ["ниже", "на уровне", "выше", "mixed"], value = "на уровне")
+
+            # Блок 3: Занятие
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 📄 Занятие", elem_classes=["block-title"])
+                topic = gr.Textbox(label="Тема", placeholder="напр. Daily routines")
+                goal = gr.Textbox(label="Цель", placeholder="К концу урока ученики смогут...")
+                duration = gr.Slider(label="Длительность (мин)", minimum=30, maximum=180, value=60, step=5)
+                inventory = gr.Textbox(label="Инвентарь", placeholder="по умолчанию - доска и проектор")
+                extra_info = gr.Textbox(label="Допонительная информация", placeholder="Класс весёлый и взвинченный после физкультуры")
+
+            # Блок 4: Методика
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 🎓 Методика", elem_classes=["block-title"])
+                methodology = gr.Dropdown(label="Методика преподавания",
+                                          choices=["PPP (Presentation-Practice-Production)",
+                                                   "TTT (Test-Teach-Test)"],
+                                          value="PPP (Presentation-Practice-Production)")
+                target_language = gr.Textbox(
+                    label="Target language",
+                    placeholder="Например: 'I have been to...' 'How long have you...?' (Present Perfect experience)",
+                    visible=True  # По умолчанию видно, так как PPP выбран
+                )
+
+                # advanced_btn = gr.Button(value="➕ Продвинутые настройки (в разработке", size="sm")
+                #
+                # # Блок продвинутых настроек, изначально скрыт
+                # with gr.Column(visible=False) as advanced_block:
+                #     gr.Markdown("**💡 Уровни задач (таксономия):**")
+                #     repetition = gr.Checkbox(label="Повторение")
+                #     application = gr.Checkbox(label="Применение")
+                #     analysis = gr.Checkbox(label="Анализ")
+                #     creativity = gr.Checkbox(label="Творчество")
+
+                hw_required = gr.Checkbox(label="Домашнее задание")
+                web_search = gr.Checkbox(label="Доп. материалы из интернета")
+
+            btn = gr.Button("Создать план", variant="primary", size="lg")
+
+        # Правая колонка — результат (output)
+        with gr.Column(elem_classes=["right-col"], scale=2):
+            # Общий блок-панель для правой колонки
+            with gr.Column(variant="panel"):  # <<< Главная панель
+                gr.Markdown("### План урока", elem_classes=["block-title"])  # Заголовок ВНУТРИ панели
+                # Блок с выводом плана
+                output = gr.Markdown(
+                    hint_text,
+                    elem_id="plan-output"
+                )
+                # Кнопка скачивания (оставляем внутри панели)
+                download_btn = gr.DownloadButton(
+                    label="⬇️ Скачать .docx",
+                    visible=False
+                )
+            # Кнопка "Помогите нам стать лучше"
+            feedback_btn = gr.Button("💬 Помогите нам стать лучше", elem_classes=["feedback-button"])
+
+            # Скрытый блок с обратной связью
+            with gr.Column(visible=False) as feedback_block:
+                gr.Markdown("_Спасибо, что попробовали! Как вам?_\n_Ваши наблюдения и замечания помогают нам расти._")
+
+
+                def toggle_feedback_block(current_visible):
+                    return (
+                        gr.update(visible=not current_visible),  # показать/скрыть блок
+                        not current_visible,  # обновить состояние
+                        gr.update(visible=False)  # скрыть благодарность при открытии/закрытии
+                    )
+                feedback_text = gr.Textbox(
+                    label="Ваше наблюдение или комментарий",
+                    placeholder="Например: 'Для 3 лет лексика подбирается неправильно — какая там 'машина', максимум - 'би-би'",
+                    lines=4
+                )
+
+                rating = gr.Radio(
+                    choices=["1", "2", "3", "4", "5"],
+                    label="Оценка"
+                )
+
+                send_feedback = gr.Button("📩 Отправить отзыв")
+
+                feedback_confirmation = gr.Markdown(
+                    visible=False,
+                    elem_classes=["feedback-confirmation"]
+                )
+
+            # <-- Блок благодарности — ВНЕ feedback_block, но СРАЗУ ПОСЛЕ
+            with gr.Column(visible=False) as feedback_confirmation:
+                gr.Markdown("✅ Спасибо! Ваш комментарий передан и, возможно, уже сегодня ассистент станет полезнее :)")
+
+            # Остальное
+            gr.Markdown(
+                """
+                🙌 Если вас заинтересовал проект, мы приглашаем
+                👉 [присоединиться к Telegram-группе](https://t.me/+yN9BSJ1DJxxjZmJi)
+                """
+            )
+
+    ### --- Логика интерфейса ---
+    ## Доп. настройки
+    # def toggle_advanced_settings(visible):
+    #     return gr.update(visible=not visible), not visible
+
+    # advanced_btn.click(
+    #     fn=toggle_advanced_settings,
+    #     inputs=[advanced_settings_visible],
+    #     outputs=[advanced_block, advanced_settings_visible]
+    # )
+
+    # Формат занятия - видимость поля если выбрано групповое
+    def toggle_format(selected_format):
+        return gr.update(visible=selected_format == "Групповое")
+    format_type.change(fn=toggle_format, inputs=format_type, outputs=group_settings)
+
+    # Возраст - деактивация поля если нажато "Взрослые"
+    def toggle_age(adult_checked):
+        return gr.update(interactive=not adult_checked)
+    adults.change(fn=toggle_age, inputs=adults, outputs=age)
+
+    # Функция для переключения видимости Target language
+    def toggle_target_language(methodology_value):
+        return gr.update(visible=methodology_value == "PPP (Presentation-Practice-Production)")
+    methodology.change(fn=toggle_target_language, inputs=methodology, outputs=target_language)
+
+    # JS для автодополнения
+    app.load(
+        None,
+        None,
+        js=f"""
+        const textbooks = {TEXTBOOKS};
+
+        function setupAutocomplete() {{
+            const input = document.getElementById('textbook_input');
+            if (!input) return;
+
+            const datalist = document.createElement('datalist');
+            datalist.id = 'textbook_suggestions';
+
+            textbooks.forEach(book => {{
+                const option = document.createElement('option');
+                option.value = book;
+                datalist.appendChild(option);
+            }});
+
+            input.setAttribute('list', datalist.id);
+            document.body.appendChild(datalist);
+        }}
+
+        // Запускаем после загрузки
+        if (document.readyState === 'complete') {{
+            setupAutocomplete();
+        }} else {{
+            document.addEventListener('DOMContentLoaded', setupAutocomplete);
+        }}
+        """
+    )
+    ### СПИСОК ВСЕХ ПАРАМЕТРОВ ИНТЕРФЕЙСА
+    all_inputs = [
+        image,  # Gradio компонент, соответствует image_path в функциях
+        textbook,
+        cefr,
+        topic,
+        goal,
+        format_type,
+        num_students,
+        age,
+        adults,
+        level_match,
+        duration,
+        inventory,
+        extra_info,
+        methodology,
+        target_language,
+        hw_required,
+        web_search
+        # repetition,
+        # application,
+        # analysis,
+        # creativity
+    ]
+
+    # Коллбек генерации
+    def on_generate(
+            image_path: Optional[str],  # Переименовано из image
+            textbook: str,
+            cefr: str,
+            topic: str,
+            goal: str,
+            format_type: str,
+            num_students: int,
+            age: str,
+            adults: bool,
+            level_match: int,
+            duration: int,
+            inventory: str,
+            extra_info: str,
+            methodology: str,
+            target_language: str,
+            hw_required: bool,
+            web_search: bool
+            # repetition: bool,
+            # application: bool,
+            # analysis: bool,
+            # creativity: bool
+    ):
+        # Проверка обязательных полей
+        if not image_path or (not adults and not age):
+            return gr.update(value="❗ Заполните обязательные поля (отмечены *)"), gr.update(visible=False)
+
+        # Собираем все аргументы в словарь
+        kwargs = locals()
+
+        # Генерация плана
+        text = generate_lesson_plan(**kwargs)
+
+        # Создание DOCX
+        docx_path = generate_docx(text) if not text.startswith("❗") else None
+        return gr.update(value=text), gr.update(visible=bool(docx_path), value=docx_path)
+
+    btn.click(
+        fn=on_generate,
+        inputs=all_inputs,
+        outputs=[output, download_btn]
+    )
+
+    # Логика: показать форму по нажатию на кнопку
+    feedback_btn.click(
+        fn=toggle_feedback_block,
+        inputs=[feedback_visible],
+        outputs=[feedback_block, feedback_visible, feedback_confirmation]
+    )
+
+    # Логика отправки обратной связи
+    def send_feedback_fn(comment, rate):
+        save_feedback(comment, rate)  # Сохраняем отзыв
+        return (
+            gr.update(visible=False),  # свернуть форму
+            False,  # сбросить состояние
+            gr.update(
+                value="✅ Спасибо! Ваш комментарий передан, и, возможно, уже сегодня ассистент станет полезнее :)",
+                visible=True
+            )
+        )
+
+    send_feedback.click(
+        fn=send_feedback_fn,
+        inputs=[feedback_text, rating],
+        outputs=[feedback_block, feedback_visible, feedback_confirmation]
+    )
+
+
+if __name__ == "__main__":
+    app.launch()

app/prompt_builder/methodology.py

@@ -0,0 +1,18 @@
+METHODOLOGY_DATA = {
+    "PPP": {
+        "structure": "3 этапа: Presentation → Practice → Production",
+        "key_points": [
+            "Четкое разделение этапов",
+            "Контролируемая практика перед свободным использованием",
+            "Пример: Демонстрация диалога → Упражнения на подстановку → Ролевая игра"
+        ]
+    },
+    "TTT": {
+        "structure": "Test → Teach → Test",
+        "key_points": [
+            "Диагностика текущего уровня перед обучением",
+            "Фокус на пробелах в знаниях",
+            "Пример: Предварительный квиз → Объяснение проблемных мест → Финальное задание"
+        ]
+    }
+}

app/prompt_builder/prompt.py

@@ -0,0 +1,257 @@
+def build_prompt(params):
+    # с обработкой пустых значений
+    def clean_value(value, default):
+        if value is None:
+            return default
+        if isinstance(value, str) and value.strip() == '':
+            return default
+        return value
+
+    # Создаем базовый промпт как список строк
+    prompt_base = [
+        f"""
+Ты — опытный ESL-методист. Ты помогаешь учителям составлять грамотные и интересные планы занятий.
+Разработай план урока на материале загруженной страницы учебника. Максимально опирайся на этот материал. 
+Перед тем как генерировать план, обдумай этапы урока по методологии {params['methodology']} с учетом всех вводных параметров занятия.
+Будь гибким: адаптируй идеи под реальный контекст занятия, проявляй педагогическое чутьё, не копируй механически структуру. Главная цель — сделать урок живым и полезным!
+На всех этапах урока используй материал страницы как основной источник. Указывай номера упражнений в плане.
+Используй в плане условные визуальные схемы при необходимости - например, если нужно что-то нарисовать на доске или какую-то таблицу вынести в тетрадь - приведи общий (для понимания сути) набросок в плане.
+
+Параметры занятия:
+- УМК: {clean_value(params.get('textbook'), "попробуй определи визуально через логотипы, заголовки, структуру")}
+- Уровень УМК по CEFR: {clean_value(params.get('cefr'), "определи по сложности текста/упражнений или по названию учебника")}
+- Тема: {clean_value(params.get('topic'), "выяви через ключевые слова/изображения на странице")}
+- Цель: {clean_value(params.get('goal'), "сформулируй сам 'К концу урока ученики смогут...'")}
+- Возраст: {params['age']} лет (учти: {_get_age_group_comment(params['age'])})
+- Продолжительность: {params['duration']} мин
+- Количество учеников: {params['num_students']} чел
+- Методология занятия: {params['methodology']}
+- Соответствие класса (ученика) уровню учебника: {params['level_match']} ({_get_level_match_comment(params['level_match'])})
+- Target language: {params.get('target_language') or 'определи самостоятельно по загруженной странице'}
+- Оборудование/инвентарь: {params.get('inventory') or "стандартный класс + проектор"}
+
+"""
+    ]
+
+    # Добавляем дополнительную информацию ТОЛЬКО если она есть
+    if params.get('extra_info'):
+        prompt_base.append(f"- Дополнительная информация от учителя: {params['extra_info']}\n")
+    if params.get('hw_required'):
+        prompt_base.append("- Разработай домашнее задание, логично вытекающее из урока\n")
+
+    # Объединяем все части в одну строку
+    base_prompt = "".join(prompt_base)
+
+    # Добавляем советы по методике
+    methodology_advice = METHODOLOGY_TIPS.get(params['methodology'], "")
+
+    return base_prompt + methodology_advice
+
+
+def is_empty_or_whitespace(text):
+    """Проверяет, является ли текст пустым или содержит только пробельные символы"""
+    return text is None or (isinstance(text, str) and text.strip() == '')
+
+def _get_level_match_comment(level):
+    comments = {
+        'ниже': "материал проще уровня учеников - добавь усложнённые элементы",
+        'на уровне': "материал соответствует уровню учеников",
+        'выше': "материал сложнее уровня учеников - предусмотри дополнительные объяснения",
+        'mixed': "в группе разные уровни - подготовь дифференцированные задания"
+    }
+    return comments.get(level, "учти соответствие уровня материала и учеников")
+
+def _get_age_group_comment(age):
+    try:
+        # Преобразуем в строку на случай, если возраст пришёл как число
+        age_str = str(age).strip()
+
+        # Удаляем все нецифровые символы, кроме разделителей (пробел, дефис, запятая)
+        cleaned = ''.join(c if c.isdigit() or c in ' -,' else ' ' for c in age_str)
+
+        # Разбиваем по возможным разделителям
+        for separator in ['-', ' ', ',']:
+            if separator in cleaned:
+                age_parts = cleaned.split(separator)
+                # Берём первый попавшийся числовой элемент
+                for part in age_parts:
+                    if part.strip().isdigit():
+                        age_int = int(part.strip())
+                        break
+                break
+        else:
+            # Если не нашли разделителей - пробуем преобразовать целиком
+            age_int = int(cleaned) if cleaned.isdigit() else 0
+
+        # Определяем возрастную группу
+        if 6 <= age_int <= 12:
+            return "дети: фокус на играх, движении, визуалах, коротких активностях"
+        elif 13 <= age_int <= 17:
+            return "подростки: актуальные темы (напр. соцсети, игры), групповые проекты, элемент соревнования"
+        elif age_int > 17:
+            return "взрослые: кейсы из реальной жизни, профессиональные контексты, дискуссии"
+        else:
+            return "дошкольники: игровое обучение, максимальная наглядность, частая смена деятельности"
+
+    except (ValueError, AttributeError, TypeError):
+        return "учти возрастные особенности группы"
+
+
+
+METHODOLOGY_TIPS = {
+    "PPP (Presentation-Practice-Production)": """
+    [МЕТОДИКА PPP]
+    
+Быстрый чек‑лист перед каждым этапом:
+
+Кто мои ученики? (возраст, уровень CEFR)
+Какие части страницы взять за основу урока? (тексты, задания, изображения)
+Какая цель урока? (что ученики должны уметь к концу)
+Какие упражнения подойдут? (контролируемые/полуконтролируемые/свободные)
+Как поддержать слабых учеников? (подсказки, шаблоны, парная работа)
+
+Перед каждым этапом прогоняй чек‑лист, ориентируйся на страницу, параметры урока и свое учительское чутье.
+
+Этап 1: Presentation (20–25% времени)
+
+1) Contextualisation (5–7 мин)
+— Придумай живую ситуацию (вопрос, загадку, картинку, мини-историю), связанную с темой страницы.
+— Ситуация должна логично вести к нужным языковым элементам.
+— Через эту ситуацию естественно выведи target language (лексика, грамматика, выражения).
+
+Контекст не должен быть искусственным: старайся строить ситуацию так, чтобы все target language звучали там естественно и логично. 
+Если надо, немного адаптируй формулировки LT для лучшего встраивания.
+
+2) Target Language Discovery
+— Помоги ученикам самим «заметить» и «вывести» target language через вопросы (eliciting).
+— Затем закрепи его по методу COW:
+• Concept: объяснение смысла через примеры и вопросы.
+• Oral: устная практика (с акцентом на важные для произношения моменты).
+• Written: письменная фиксация (укажи, где будет письменная фиксация - доска/слайды/раздатки etc).
+
+Параметры объема TL:
+• A1–A2 (6–12 лет): 3–5 единиц
+• A2–B1 (13–17 лет): 5–7 единиц
+• B2+: 7–10 единиц
+
+
+Справка:
+    Виды target language:
+    Лексика (vocabulary)	Тематические слова и выражения: еда, путешествия, эмоции etc.
+    Грамматика (grammar)	Времена, модальные глаголы, условные предложения, артикли etc.
+    Функциональный язык (functional language)	Фразы для общения: просьбы, советы, приглашения, извинения etc.
+    Фразовые глаголы (phrasal verbs)	Turn up, break down, look after etc.
+    Идиомы (idioms)	"Break the ice", "Hit the books" etc.
+    Произношение (pronunciation features)	Интонация вопросов, соединение слов (linking sounds), ударение etc.
+    Орфография (spelling patterns)	Правила написания: окончания -ing, суффиксы и префиксы etc.
+    Синтаксис (syntax)	Порядок слов в вопросах, порядок прилагательных etc.
+    Функции дискурса (discourse markers)	Well, actually, you know, I mean... etc.
+    Социальные формы речи (register)	Формальный/неформальный стиль общения etc.
+
+
+Этап 2: Practice (30–40% времени занятия)
+Цель этапа: помочь ученикам отработать target language под контролем учителя, чтобы укрепить понимание формы и значения.
+Построй этап на базе target language, выбранного на предыдущей фазе.
+Используй материал страницы учебника как основу для упражнений (переформатируй задания при необходимости, но сохраняй их смысл и структуру).
+
+Организуй 2–3 контролируемых или полуконтролируемых упражнения.
+
+Если у тебя есть пространство для маневра, начни с упражнений с высокой степенью контроля (чтобы ученики не допускали ошибок).
+Постепенно ослабляй контроль, подводя к этапу Production.
+
+Подбирая тип упражнений, учитывая возраст, уровень CEFR, продолжительность урока и количество учеников (пары, мини-группы и т.д.).
+Продумай, как предоставить минимальный фидбэк (например, общее исправление ошибок после каждого упражнения).
+
+Справка:
+    Неполный список возможных типов упражнений для этапа Practice:
+    Controlled drills -	Substitution, transformation, repetition drills.
+    Gap-fills	- Вставка пропущенных слов, структур или фраз.
+    Matching -	Соотнесение вопросов и ответов, слов и определений.
+    Sentence completion -	Завершение предложений целевыми структурами.
+    Reordering	Перестановка - элементов для создания правильных предложений.
+    Controlled dialogues -	Диалоги с частично заданной структурой.
+    Information gap activities - (контролируемые)	Обмен недостающей информацией по чётким правилам.
+
+
+Этап 3: Production (25–35% времени занятия)
+Цель этапа: Дать ученикам возможность свободно и творчески использовать target language в реальной коммуникации.
+Построй задание на свободное использование target language.
+Используй материал страницы как отправную точку для ситуации, но адаптируй или дополни её, чтобы задание требовало активного создания речи учениками.
+
+Справка:
+Возможные типы заданий (можешь использовать и другие варианты по своему усмотрению):
+
+    Role-play | Разыгрывание реальных ситуаций.
+    Discussion / Debate | Обсуждение темы урока.
+    Mini-project | Создание плаката, презентации, мини-видео.
+    Interview | Ученики задают друг другу вопросы.
+    Storytelling | Придумывание и рассказывание историй.
+    Problem-solving task | Решение задач и кейсов.
+    Peer teaching | Объяснение новой лексики друг другу.
+    Игры на использование языка | "Find someone who...", викторины и т.д.
+
+Подбирай активность с учётом возраста, уровня и характера группы (например, подростки предпочитают соревновательные задания, взрослые — практические кейсы).
+
+** Корректировки длительности этапов для разных уровней**:
+Начинающие (A1-A2):
+• Увеличить Practice до 45-50% (больше повторений и структурированных упражнений).
+• Сократить Production до 20% (менее сложные задания).
+
+Продвинутые (B2-C1):
+• Сократить Presentation до 15% (быстрый ввод материала).
+• Увеличить Production до 35-40% (больше дискуссий/кейсов).
+
+    """,
+
+    "TTT (Test-Teach-Test)": """
+    [МЕТОДИКА TTT]
+    Обязательные этапы:
+    1. Test (10 мин): Диагностический тест
+    2. Teach (15 мин): Объяснение проблемных мест
+    3. Test (20 мин): Применение в новой ситуации
+    Пример: предтест на времена → объяснение Past Perfect → кейсы
+    """
+}
+
+
+
+
+# Этап 1 :Presentation (20–25% времени)
+#    — Выбери главный target language (лексика или структура) по материалу страницы.
+#    - Придумай общий контекст для всех target language (д
+#    Начни урок с некоего интересного объекта, вопроса, иллюстрации, короткого видео, загадки или чего угодно еще, чтобы заинтриговать учеников и задать контекст.
+#    — Введи target language по методике: понимание (concept), звуковая форма (oral), письменная форма (written).
+#    — Определите количество новых языковых единиц в зависимости от уровня CEFR и возраста учащихся, чтобы обеспечить оптимальное усвоение материала.
+#    — Предусмотри, где эти единицы будут представлены письменно (доска, раздатки, заметки).
+#    — Дополни план идеями для активации внимания: короткий диалог, обсуждение картинки, мини-видео.
+
+
+EXTRA_CASES = f"""
+    Особые указания:
+     Если учебник и возраст явно конфликтуют (напр., медицинский английский для детей 6 лет):
+   - Предупреди: "Материал требует адаптации. Предлагаю упрощённый вариант: [идея]"
+   - Сохрани 2-3 ключевых элемента страницы, но измени контекст
+   Пример: 
+   Текст про хирургию → "Лечим плюшевых зверей: bandage, medicine, hurt"
+   
+    1. Всегда сохраняй структуру выбранной методики, но меняй:
+       - Тип активностей (игры ↔ кейсы)
+       - Длительность этапов (дети: чаще сменяй задания)
+       - Степень автономии (подростки: больше групповой работы)
+
+    2. Если учебник явно не подходит по возрасту:
+       - Шаг 1: Выдели ключевые элементы страницы (текст/упражнения/картинки)
+       - Шаг 2: Переупакуй их в подходящий формат:
+         Пример: 
+         Учебник для взрослых → урок для детей 10 лет:
+         • Текст о бизнесе → "Создай магазин мечты"
+         • Сложные термины → "Придумай смешные названия для товаров"
+         • Графики → "Нарисуй идеальный график каникул"
+
+    3. Дифференциация внутри группы:
+       - Для mixed ages: предложи 2 варианта одного задания
+       Пример: 
+       "Basic: Используй слова из рамки. Advanced: Добавь 3 прилагательных"
+"""
+
+

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,118 @@
+
+quotes = [
+    "<em>«Хороший план — это гибкая структура, готовая к импровизации»</em><br>",
+    "<em>«Ошибки ученика — это дорожки к его пониманию, а не провалы»</em><br>",
+    "<em>«Обратная связь должна быть 'зеленой' — отмечай сильные стороны прежде, чем указывать на слабые»</em><br>",
+    "<em>«Каждый этап урока — это возможность для ученика стать активным соавтором обучения»</em><br>",
+    "<em>«Контекст важнее слова: учи не словам, а ситуациям их использования»</em><br>",
+    "<em>«Scaffolding — это временные колёсики, которые мы убираем, когда ученики готовы ехать сами»</em><br>",
+    "<em>«Коммуникация важнее совершенства формы»</em><br>",
+    "<em>«Ваш план урока — как волшебный амулет, который защитит вас от того, чтобы быть съеденным заживо»</em><br>Скотт Торнбери",
+    "<em>«Каждый урок — это маленький эксперимент, а не экзамен»</em><br>",
+    "<em>«Самый ценный ресурс урока — внимание учителя к человеку, а не к программе»</em><br>",
+    "<em>«Учитель — не носитель знаний, он — архитектор обучающего пространства»</em><br>",
+    "<em>«Concept checking — это не тест, а приглашение к диалогу»</em><br>",
+    "<em>«<em>«Человеческие существа всегда учились методом проб и ошибок, и изучение нового языка не исключение»</em><br>Джим Скривенер",
+    "<em>«Задача учителя — создать потребность в языке, а не навязать материал»</em><br>",
+    "<em>«Настоящее планирование освобождает учителя учителя на занятии - слушать, отмечать, реагировать (философия ELT)",
+    "<em>«Рефлексия учителя — мощнейший инструмент профессионального роста»</em><br>",
+    "<em>«Уроки — это лаборатория: экспериментируй, наблюдай, делай выводы»</em><br>",
+    "<em>«Материалы — лишь топливо; подлинный двигатель урока — взаимодействие»</em><br>",
+    "<em>«Персонализация отвлечёт от учебника, но приведёт к истинному усвоению»</em><br>",
+    "<em>«Урок без элемента игры — как картина без цвета»</em><br>",
+    "<em>«Комбинируя структуры и свободу, мы создаём условия для открытия нового»</em><br>",
+    "<em>«План занятия — это обещание, которое ты даёшь своим ученикам.»</em><br>",
+    "<em>«Образовательная цель оживает только в момент, когда ученики её делают своей.»</em><br>"
+]
+
+
+
+
+#
+#
+# quotes = [
+#
+# "<em>«»</em><br>
+# "<em>«»</em><br>
+#
+#
+# «Один из величайших врагов успешного преподавания — это скука учеников.»
+# — Джереми Хармер
+#
+# «Преподавание — это живое, творческое, личное, межличностное искусство.»
+# — Джим Скривенер
+#
+# ваш план урока — как волшебный амулет, который защитит вас от того, чтобы быть съеденным заживо.
+# — Скотт Торнбери
+#
+#
+# «Забудьте о методологии. Ученикам просто нужно больше практики.»
+# — Джим Скривенер
+#
+# «Человеческие существа всегда учились методом проб и ошибок, и изучение нового языка не исключение.»
+# — Джим Скривенер
+#
+# More Than English
+# "A lesson plan is not a script. It is a map drawn with care, so we can wander with freedom."
+# — inspired
+# by
+# Scott
+# Thornbury
+#
+# "True planning liberates the teacher: the mind is free to listen, to notice, to respond."
+# — Anonymous(inspired
+# by
+# ELT
+# teaching
+# philosophy)
+#
+# "When we plan with the learner in mind, the lesson becomes a journey, not a checklist."
+# — based
+# on
+# ideas
+# by
+# Penny
+# Ur
+#
+# "Good teaching is prepared spontaneity. Planning gives wings to presence."
+# — inspired
+# by
+# Jim
+# Scrivener
+#
+# "Language teaching is not about control. It is about building spaces where real communication can happen."
+# — reflections
+# on
+# Communicative
+# Language
+# Teaching(CLT)
+#
+# "The art of teaching is not filling time. It is filling hearts."
+# — Anonymous
+#
+# "We plan not because we mistrust the learner, but because we trust the encounter."
+# — A
+# thought
+# from the CELTA
+# world
+#
+# «Ошибки — это дыхание обучения. Если их нет, ученик задохнулся.»
+# — Переосмысление подхода к ошибкам в Communicative Methodology
+#
+# «Учитель не держит знания в руках. Он строит мосты через незнание.»
+# — Переосмысление роли учителя в Humanistic Teaching
+#
+# «Хорошая обратная связь — это не красная ручка, а зелёная кисть.»
+# — Философия positive feedback, CELTA
+#
+#
+# «Мы не обучаем языку. Мы создаём пространство, в котором язык рождается.»
+# — Jim Scrivener, свободная интерпретация идей Demand High Teaching
+#
+# "A teacher without a plan is like a ship without a sail; a teacher chained to a plan is like a ship in a bottle."
+# — based
+# on
+# ELT
+# training
+# aphorisms
+# # Зарубежные

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;
+}

app/test_502.py

@@ -0,0 +1,23 @@
+import gradio as gr
+
+def greet(name):
+    return f"Привет, {name}!"
+
+demo = gr.Interface(
+    fn=greet,
+    inputs=gr.Textbox(label="Введите ваше имя"),
+    outputs=gr.Textbox(label="Приветствие")
+)
+
+if __name__ == "__main__":
+    # Отключаем проверку localhost и пробуем разные порты
+    try:
+        demo.launch(
+            server_port=7860,
+            prevent_thread_lock=True,  # Не блокировать основной поток
+            show_error=True,          # Показывать детальные ошибки
+            inbrowser=True            # Автоматически открывать браузер
+        )
+        input("Нажмите Enter чтобы остановить сервер...")  # Держим сервер активным
+    except Exception as e:
+        print(f"Ошибка: {e}")

app/test_gradio.py

@@ -0,0 +1,486 @@
+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
+from typing import Optional
+
+import random
+from app.quotes import quotes
+from app.drawings import drawings
+from app.knowledge_base.textbooks import TEXTBOOKS
+# --- Настройка ---
+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", "")  # vector store for file_search if needed
+
+# --- Утилиты ---
+def upload_to_catbox(file_bytes: bytes) -> str:
+    """Загружает файл на catbox.moe и возвращает URL"""
+    try:
+        response = requests.post(
+            "https://catbox.moe/user/api.php",
+            files={"fileToUpload": file_bytes},
+            data={"reqtype": "fileupload"},
+            timeout=10
+        )
+        response.raise_for_status()
+        return response.text.strip()
+    except Exception as 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
+
+# названия textbooks для автозаполнения поля Учебник
+import json
+
+## Сохраняем отзыв через POST в google-таблицу
+GOOGLE_SHEET_URL = os.getenv("FEEDBACK_GS_URL")
+
+def save_feedback(comment, rate):
+    payload = {
+        "comment": comment,
+        "rate": rate
+    }
+    try:
+        requests.post(GOOGLE_SHEET_URL, json=payload, timeout=3)
+    except Exception as e:
+        print(f"Ошибка при отправке отзыва: {e}")
+
+### ОСНОВНАЯ ФУНКЦИЯ ГЕНЕРАЦИИ
+def generate_lesson_plan(
+        image_path: Optional[str],
+        textbook: str,
+        cefr: str,
+        topic: str,
+        goal: str,
+        format_type: str,
+        num_students: int,
+        age: str,
+        adults: bool,
+        level_match: int,
+        duration: int,
+        inventory: str,
+        extra_info: str,
+        methodology: str,
+        target_language: str,
+        hw_required: bool,
+        web_search: bool
+        # repetition: bool,
+        # application: bool,
+        # analysis: bool,
+        # creativity: bool
+) -> str:
+
+    # Валидация API клиента
+    if not client:
+        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
+    lesson_params = {
+        'methodology': methodology,
+        'target_language': target_language, # для PPP
+        'textbook': textbook,
+        'cefr': cefr,
+        'topic': topic,
+        'goal': goal,
+        'num_students': num_students,
+        'age': 'Взрослые' if adults else age,
+        'level_match': level_match,
+        'duration': duration,
+        'inventory': inventory,
+        'hw_required': hw_required,
+        'extra_info': extra_info
+    }
+
+    # Получаем готовый промпт
+    from app.prompt_builder.prompt import build_prompt
+    full_prompt = build_prompt(lesson_params)
+
+    # Собираем входные данные согласно API
+    input_content = [
+        {
+            "type": "input_text",
+            "text": full_prompt
+        },
+        {
+            "type": "input_image",
+            "image_url": image_url,
+            "detail": "high"
+        }
+    ]
+
+    # Опции инструментов
+    tools = []
+    tool_choice = None
+    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(
+            input=[{"role": "user", "content": input_content}],
+            model="o4-mini", #  gpt-4o-mini    gpt-4.1
+            tools=tools or None,
+            tool_choice=tool_choice,
+            max_output_tokens=8192,
+            reasoning= {"effort":"medium"},
+            stream=False
+        )
+        return response.output_text
+
+    except Exception as e:
+        logging.error(f"Generation error: {e}")
+        raise gr.Error(f"Ошибка генерации: {e}")
+
+
+
+########## ИНТЕРФЕЙС
+# Случайный рисунок в блокноте
+drawing = random.choice(drawings)
+# Текст с подсказкой и рисунком в блокноте
+hint_text = f"""Здесь появится план занятия — заполните вводные и нажмите кнопку **Создать план**<br>
+Создание может занять до 1 минуты
+<pre>
+{drawing}
+</pre>
+"""
+
+#ТЕМА И СТИЛИ
+### css привязывать именно так
+#theme='earneleh/paris'
+theme = gr.themes.Base(
+    secondary_hue="rose",
+    neutral_hue="stone",
+).set(
+    body_background_fill='*primary_50',
+    body_text_color='*primary_900',
+    body_text_size='*text_lg',
+    body_text_color_subdued='*primary_700',
+    body_text_weight='600',
+)
+css_path = os.path.join(os.path.dirname(__file__), "styles.css")
+
+# ИНТЕРФЕЙС
+with gr.Blocks(theme=theme, css_paths=css_path) as app:
+    advanced_settings_visible = gr.State(value=False)  # Импортируем gr.State для хранения состояния
+    feedback_visible = gr.State(False)  # Хранит, открыт ли блок отзыва
+
+    gr.Markdown("# План урока английского языка", elem_classes=["main-title"])
+    quote_box = gr.Markdown(random.choice(quotes), elem_classes=["quote-block"])
+    with gr.Row():
+        with gr.Column(elem_classes=["left-col"], scale=1):
+            image = gr.Image(
+                label="Фото страницы учебника*",
+                type="filepath",
+                height=0,  # Автоматическая высота
+                container=False  # Не растягивать контейнер
+            )
+
+            # Блок 1: Учебник
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 📚 Учебник", elem_classes=["block-title"])
+                textbook = gr.Textbox(label="Название учебника", placeholder="напр. English File Beginner", elem_id="textbook_input")
+
+                cefr = gr.Dropdown(label="Уровень", choices=["", "A1", "A2", "B1", "B2", "C1", "C2"],
+                                   value="", info="Выберите уровень")
+            # Блок 2: Класс
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 👥 Класс", elem_classes=["block-title"])
+                format_type = gr.Radio(label="Формат занятия", choices=["Индивидуальное", "Групповое"],
+                                       value="Групповое")
+
+                with gr.Group(visible=True) as group_settings:
+                    num_students = gr.Slider(label="Количество учеников", minimum=1, maximum=40,
+                                             value=10, step=1, info="Для групповых занятий")
+
+                with gr.Group() as age_group:
+                    age = gr.Textbox(label="Возраст", placeholder="напр. 10–11", interactive=True)
+                    adults = gr.Checkbox(label="Взрослые")
+
+                level_match = gr.Dropdown(label = "Уровень учеников относительно учебника",
+                    choices = ["ниже", "на уровне", "выше", "mixed"], value = "на уровне")
+
+            # Блок 3: Занятие
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 📄 Занятие", elem_classes=["block-title"])
+                topic = gr.Textbox(label="Тема", placeholder="напр. Daily routines")
+                goal = gr.Textbox(label="Цель", placeholder="К концу урока ученики смогут...")
+                duration = gr.Slider(label="Длительность (мин)", minimum=30, maximum=180, value=60, step=5)
+                inventory = gr.Textbox(label="Инвентарь", placeholder="по умолчанию - доска и проектор")
+                extra_info = gr.Textbox(label="Допонительная информация", placeholder="Класс весёлый и взвинченный после физкультуры")
+
+            # Блок 4: Методика
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 🎓 Методика", elem_classes=["block-title"])
+                methodology = gr.Dropdown(label="Методика преподавания",
+                                          choices=["PPP (Presentation-Practice-Production)",
+                                                   "TTT (Test-Teach-Test)"],
+                                          value="PPP (Presentation-Practice-Production)")
+                target_language = gr.Textbox(
+                    label="Target language",
+                    placeholder="Например: 'I have been to...' 'How long have you...?' (Present Perfect experience)",
+                    visible=True  # По умолчанию видно, так как PPP выбран
+                )
+
+                # advanced_btn = gr.Button(value="➕ Продвинутые настройки (в разработке", size="sm")
+                #
+                # # Блок продвинутых настроек, изначально скрыт
+                # with gr.Column(visible=False) as advanced_block:
+                #     gr.Markdown("**💡 Уровни задач (таксономия):**")
+                #     repetition = gr.Checkbox(label="Повторение")
+                #     application = gr.Checkbox(label="Применение")
+                #     analysis = gr.Checkbox(label="Анализ")
+                #     creativity = gr.Checkbox(label="Творчество")
+
+                hw_required = gr.Checkbox(label="Домашнее задание")
+                web_search = gr.Checkbox(label="Доп. материалы из интернета")
+
+            btn = gr.Button("Создать план", variant="primary", size="lg")
+
+        # Правая колонка — результат (output)
+        with gr.Column(elem_classes=["right-col"], scale=2):
+            # Общий блок-панель для правой колонки
+            with gr.Column(variant="panel"):  # <<< Главная панель
+                gr.Markdown("### План урока", elem_classes=["block-title"])  # Заголовок ВНУТРИ панели
+                # Блок с выводом плана
+                output = gr.Markdown(
+                    hint_text,
+                    elem_id="plan-output"
+                )
+                # Кнопка скачивания (оставляем внутри панели)
+                download_btn = gr.DownloadButton(
+                    label="⬇️ Скачать .docx",
+                    visible=False
+                )
+            # Кнопка "Помогите нам стать лучше"
+            feedback_btn = gr.Button("💬 Помогите нам стать лучше", elem_classes=["feedback-button"])
+
+            # Скрытый блок с обратной связью
+            with gr.Column(visible=False) as feedback_block:
+                gr.Markdown("_Спасибо, что попробовали! Как вам?_\n_Ваши наблюдения и замечания помогают нам расти._")
+
+
+                def toggle_feedback_block(current_visible):
+                    return (
+                        gr.update(visible=not current_visible),  # показать/скрыть блок
+                        not current_visible,  # обновить состояние
+                        gr.update(visible=False)  # скрыть благодарность при открытии/закрытии
+                    )
+                feedback_text = gr.Textbox(
+                    label="Ваше наблюдение или комментарий",
+                    placeholder="Например: 'Для 3 лет лексика подбирается неправильно — какая там 'машина', максимум - 'би-би'",
+                    lines=4
+                )
+
+                rating = gr.Radio(
+                    choices=["1", "2", "3", "4", "5"],
+                    label="Оценка"
+                )
+
+                send_feedback = gr.Button("📩 Отправить отзыв")
+
+                feedback_confirmation = gr.Markdown(
+                    visible=False,
+                    elem_classes=["feedback-confirmation"]
+                )
+
+            # <-- Блок благодарности — ВНЕ feedback_block, но СРАЗУ ПОСЛЕ
+            with gr.Column(visible=False) as feedback_confirmation:
+                gr.Markdown("✅ Спасибо! Ваш комментарий передан и, возможно, уже сегодня ассистент станет полезнее :)")
+
+            # Остальное
+            gr.Markdown(
+                """
+                🙌 Если вас заинтересовал проект, мы приглашаем
+                👉 [присоединиться к Telegram-группе](https://t.me/+yN9BSJ1DJxxjZmJi)
+                """
+            )
+
+    ### --- Логика интерфейса ---
+    ## Доп. настройки
+    # def toggle_advanced_settings(visible):
+    #     return gr.update(visible=not visible), not visible
+
+    # advanced_btn.click(
+    #     fn=toggle_advanced_settings,
+    #     inputs=[advanced_settings_visible],
+    #     outputs=[advanced_block, advanced_settings_visible]
+    # )
+
+    # Формат занятия - видимость поля если выбрано групповое
+    def toggle_format(selected_format):
+        return gr.update(visible=selected_format == "Групповое")
+    format_type.change(fn=toggle_format, inputs=format_type, outputs=group_settings)
+
+    # Возраст - деактивация поля если нажато "Взрослые"
+    def toggle_age(adult_checked):
+        return gr.update(interactive=not adult_checked)
+    adults.change(fn=toggle_age, inputs=adults, outputs=age)
+
+    # Функция для переключения видимости Target language
+    def toggle_target_language(methodology_value):
+        return gr.update(visible=methodology_value == "PPP (Presentation-Practice-Production)")
+    methodology.change(fn=toggle_target_language, inputs=methodology, outputs=target_language)
+
+    # JS для автодополнения
+    app.load(
+        None,
+        None,
+        js=f"""
+        const textbooks = {TEXTBOOKS};
+
+        function setupAutocomplete() {{
+            const input = document.getElementById('textbook_input');
+            if (!input) return;
+
+            const datalist = document.createElement('datalist');
+            datalist.id = 'textbook_suggestions';
+
+            textbooks.forEach(book => {{
+                const option = document.createElement('option');
+                option.value = book;
+                datalist.appendChild(option);
+            }});
+
+            input.setAttribute('list', datalist.id);
+            document.body.appendChild(datalist);
+        }}
+
+        // Запускаем после загрузки
+        if (document.readyState === 'complete') {{
+            setupAutocomplete();
+        }} else {{
+            document.addEventListener('DOMContentLoaded', setupAutocomplete);
+        }}
+        """
+    )
+    ### СПИСОК ВСЕХ ПАРАМЕТРОВ ИНТЕРФЕЙСА
+    all_inputs = [
+        image,  # Gradio компонент, соответствует image_path в функциях
+        textbook,
+        cefr,
+        topic,
+        goal,
+        format_type,
+        num_students,
+        age,
+        adults,
+        level_match,
+        duration,
+        inventory,
+        extra_info,
+        methodology,
+        target_language,
+        hw_required,
+        web_search
+        # repetition,
+        # application,
+        # analysis,
+        # creativity
+    ]
+
+    # Коллбек генерации
+    def on_generate(
+            image_path: Optional[str],  # Переименовано из image
+            textbook: str,
+            cefr: str,
+            topic: str,
+            goal: str,
+            format_type: str,
+            num_students: int,
+            age: str,
+            adults: bool,
+            level_match: int,
+            duration: int,
+            inventory: str,
+            extra_info: str,
+            methodology: str,
+            target_language: str,
+            hw_required: bool,
+            web_search: bool
+            # repetition: bool,
+            # application: bool,
+            # analysis: bool,
+            # creativity: bool
+    ):
+        # Проверка обязательных полей
+        if not image_path or (not adults and not age):
+            return gr.update(value="❗ Заполните обязательные поля (отмечены *)"), gr.update(visible=False)
+
+        # Собираем все аргументы в словарь
+        kwargs = locals()
+
+        # Генерация плана
+        text = generate_lesson_plan(**kwargs)
+
+        # Создание DOCX
+        docx_path = generate_docx(text) if not text.startswith("❗") else None
+        return gr.update(value=text), gr.update(visible=bool(docx_path), value=docx_path)
+
+    btn.click(
+        fn=on_generate,
+        inputs=all_inputs,
+        outputs=[output, download_btn]
+    )
+
+    # Логика: показать форму по нажатию на кнопку
+    feedback_btn.click(
+        fn=toggle_feedback_block,
+        inputs=[feedback_visible],
+        outputs=[feedback_block, feedback_visible, feedback_confirmation]
+    )
+
+    # Логика отправки обратной связи
+    def send_feedback_fn(comment, rate):
+        save_feedback(comment, rate)  # Сохраняем отзыв
+        return (
+            gr.update(visible=False),  # свернуть форму
+            False,  # сбросить состояние
+            gr.update(
+                value="✅ Спасибо! Ваш комментарий передан, и, возможно, уже сегодня ассистент станет полезнее :)",
+                visible=True
+            )
+        )
+
+    send_feedback.click(
+        fn=send_feedback_fn,
+        inputs=[feedback_text, rating],
+        outputs=[feedback_block, feedback_visible, feedback_confirmation]
+    )
+
+
+if __name__ == "__main__":
+    app.launch()

app/test_gradio_test.py

@@ -0,0 +1,527 @@
+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
+from typing import Optional
+
+import random
+from app.quotes import quotes
+from app.drawings import drawings
+from app.knowledge_base.textbooks import TEXTBOOKS
+# --- Настройка ---
+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", "")  # vector store for file_search if needed
+
+# --- Утилиты ---
+def upload_to_catbox(file_bytes: bytes) -> str:
+    """Загружает файл на catbox.moe и возвращает URL"""
+    try:
+        response = requests.post(
+            "https://catbox.moe/user/api.php",
+            files={"fileToUpload": file_bytes},
+            data={"reqtype": "fileupload"},
+            timeout=10
+        )
+        response.raise_for_status()
+        return response.text.strip()
+    except Exception as 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
+
+# названия textbooks для автозаполнения поля Учебник
+import json
+
+## Сохраняем отзыв через POST в google-таблицу
+GOOGLE_SHEET_URL = os.getenv("FEEDBACK_GS_URL")
+
+def save_feedback(comment, rate):
+    payload = {
+        "comment": comment,
+        "rate": rate
+    }
+    try:
+        requests.post(GOOGLE_SHEET_URL, json=payload, timeout=3)
+    except Exception as e:
+        print(f"Ошибка при отправке отзыва: {e}")
+
+### ОСНОВНАЯ ФУНКЦИЯ ГЕНЕРАЦИИ
+def generate_lesson_plan(
+        main_image_path: Optional[str],
+        extra_images: Optional[list[str]],
+        textbook: str,
+        cefr: str,
+        topic: str,
+        goal: str,
+        format_type: str,
+        num_students: int,
+        age: str,
+        adults: bool,
+        level_match: int,
+        duration: int,
+        inventory: str,
+        extra_info: str,
+        methodology: str,
+        target_language: str,
+        hw_required: bool,
+        web_search: bool
+        # repetition: bool,
+        # application: bool,
+        # analysis: bool,
+        # creativity: bool
+) -> str:
+
+    # Валидация
+    if not main_image_path:
+        return "❗ Загрузите хотя бы главную страницу"
+
+    # Собираем все пути изображений
+    image_paths = [main_image_path]
+    if extra_images:
+        if len(extra_images) > 2:
+            return "❗ Максимум 2 дополнительные страницы"
+        image_paths.extend(extra_images)
+
+    # Валидация API клиента
+    if not client:
+        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
+    lesson_params = {
+        'methodology': methodology,
+        'target_language': target_language, # для PPP
+        'textbook': textbook,
+        'cefr': cefr,
+        'topic': topic,
+        'goal': goal,
+        'num_students': num_students,
+        'age': 'Взрослые' if adults else age,
+        'level_match': level_match,
+        'duration': duration,
+        'inventory': inventory,
+        'hw_required': hw_required,
+        'extra_info': extra_info
+    }
+
+    # Получаем готовый промпт
+    from app.prompt_builder.prompt import build_prompt
+    full_prompt = build_prompt(lesson_params)
+
+    # Собираем входные данные согласно API
+    input_content = [
+        {
+            "type": "input_text",
+            "text": full_prompt
+        },
+        {
+            "type": "input_image",
+            "image_url": image_url,
+            "detail": "high"
+        }
+    ]
+
+    # Опции инстр��ментов
+    tools = []
+    tool_choice = None
+    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(
+            input=[{"role": "user", "content": input_content}],
+            model="o4-mini", #  gpt-4o-mini    gpt-4.1
+            tools=tools or None,
+            tool_choice=tool_choice,
+            max_output_tokens=8192,
+            reasoning= {"effort":"medium"},
+            stream=False
+        )
+        return response.output_text
+
+    except Exception as e:
+        logging.error(f"Generation error: {e}")
+        raise gr.Error(f"Ошибка генерации: {e}")
+
+
+
+########## ИНТЕРФЕЙС
+# Случайный рисунок в блокноте
+drawing = random.choice(drawings)
+# Текст с подсказкой и рисунком в блокноте
+hint_text = f"""Здесь появится план занятия — заполните вводные и нажмите кнопку **Создать план**<br>
+Создание может занять до 1 минуты
+<pre>
+{drawing}
+</pre>
+"""
+
+#ТЕМА И СТИЛИ
+### css привязывать именно так
+#theme='earneleh/paris'
+theme = gr.themes.Base(
+    secondary_hue="rose",
+    neutral_hue="stone",
+).set(
+    body_background_fill='*primary_50',
+    body_text_color='*primary_900',
+    body_text_size='*text_lg',
+    body_text_color_subdued='*primary_700',
+    body_text_weight='600',
+)
+css_path = os.path.join(os.path.dirname(__file__), "styles.css")
+
+# ИНТЕРФЕЙС
+with gr.Blocks(theme=theme, css_paths=css_path) as app:
+    advanced_settings_visible = gr.State(value=False)  # Импортируем gr.State для хранения состояния
+    feedback_visible = gr.State(False)  # Хранит, открыт ли блок отзыва
+
+    gr.Markdown("# План урока английского языка", elem_classes=["main-title"])
+    quote_box = gr.Markdown(random.choice(quotes), elem_classes=["quote-block"])
+    with gr.Row():
+        with gr.Column(variant="panel"):
+            # Основной загрузчик (с камерой)
+            main_image = gr.Image(
+                label="Главная страница учебника*",
+                type="filepath",
+                source="upload",  # разрешаем и загрузку, и камеру
+                tool=None,  # или "editor" если нужно редактирование
+                height=300
+            )
+
+            # Дополнительные страницы (до 2х)
+            extra_images = gr.File(
+                label="Дополнительные страницы (макс. 2)",
+                file_types=["image"],
+                file_count="multiple",
+                height=100,
+                visible=False  # по умолчанию скрыт
+            )
+
+            # Переключатель
+            show_extra = gr.Checkbox(
+                label="Добавить страницы (разворот)",
+                value=False
+            )
+
+            # Блок 1: Учебник
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 📚 Учебник", elem_classes=["block-title"])
+                textbook = gr.Textbox(label="Название учебника", placeholder="напр. English File Beginner", elem_id="textbook_input")
+
+                cefr = gr.Dropdown(label="Уровень", choices=["", "A1", "A2", "B1", "B2", "C1", "C2"],
+                                   value="", info="Выберите уровень")
+            # Блок 2: Класс
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 👥 Класс", elem_classes=["block-title"])
+                format_type = gr.Radio(label="Формат занятия", choices=["Индивидуальное", "Групповое"],
+                                       value="Групповое")
+
+                with gr.Group(visible=True) as group_settings:
+                    num_students = gr.Slider(label="Количество учеников", minimum=1, maximum=40,
+                                             value=10, step=1, info="Для групповых занятий")
+
+                with gr.Group() as age_group:
+                    age = gr.Textbox(label="Возраст", placeholder="напр. 10–11", interactive=True)
+                    adults = gr.Checkbox(label="Взрослые")
+
+                level_match = gr.Dropdown(label = "Уровень учеников относительно учебника",
+                    choices = ["ниже", "на уровне", "выше", "mixed"], value = "на уровне")
+
+            # Блок 3: ��анятие
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 📄 Занятие", elem_classes=["block-title"])
+                topic = gr.Textbox(label="Тема", placeholder="напр. Daily routines")
+                goal = gr.Textbox(label="Цель", placeholder="К концу урока ученики смогут...")
+                duration = gr.Slider(label="Длительность (мин)", minimum=30, maximum=180, value=60, step=5)
+                inventory = gr.Textbox(label="Инвентарь", placeholder="по умолчанию - доска и проектор")
+                extra_info = gr.Textbox(label="Допонительная информация", placeholder="Класс весёлый и взвинченный после физкультуры")
+
+            # Блок 4: Методика
+            with gr.Column(variant="panel"):
+                gr.Markdown("### 🎓 Методика", elem_classes=["block-title"])
+                methodology = gr.Dropdown(label="Методика преподавания",
+                                          choices=["PPP (Presentation-Practice-Production)",
+                                                   "TTT (Test-Teach-Test)"],
+                                          value="PPP (Presentation-Practice-Production)")
+                target_language = gr.Textbox(
+                    label="Target language",
+                    placeholder="Например: 'I have been to...' 'How long have you...?' (Present Perfect experience)",
+                    visible=True  # По умолчанию видно, так как PPP выбран
+                )
+
+                # advanced_btn = gr.Button(value="➕ Продвинутые настройки (в разработке", size="sm")
+                #
+                # # Блок продвинутых настроек, изначально скрыт
+                # with gr.Column(visible=False) as advanced_block:
+                #     gr.Markdown("**💡 Уровни задач (таксономия):**")
+                #     repetition = gr.Checkbox(label="Повторение")
+                #     application = gr.Checkbox(label="Применение")
+                #     analysis = gr.Checkbox(label="Анализ")
+                #     creativity = gr.Checkbox(label="Творчество")
+
+                hw_required = gr.Checkbox(label="Домашнее задание")
+                web_search = gr.Checkbox(label="Доп. материалы из интернета")
+
+            btn = gr.Button("Создать план", variant="primary", size="lg")
+
+        # Правая колонка — результат (output)
+        with gr.Column(elem_classes=["right-col"], scale=2):
+            # Общий блок-панель для правой колонки
+            with gr.Column(variant="panel"):  # <<< Главная панель
+                gr.Markdown("### План урока", elem_classes=["block-title"])  # Заголовок ВНУТРИ панели
+                # Блок с выводом плана
+                output = gr.Markdown(
+                    hint_text,
+                    elem_id="plan-output"
+                )
+                # Кнопка скачивания (оставляем внутри панели)
+                download_btn = gr.DownloadButton(
+                    label="⬇️ Скачать .docx",
+                    visible=False
+                )
+            # Кнопка "Помогите нам стать лучше"
+            feedback_btn = gr.Button("💬 Помогите нам стать лучше", elem_classes=["feedback-button"])
+
+            # Скрытый блок с обратной связью
+            with gr.Column(visible=False) as feedback_block:
+                gr.Markdown("_Спасибо, что попробовали! Как вам?_\n_Ваши наблюдения и замечания помогают нам расти._")
+
+
+                def toggle_feedback_block(current_visible):
+                    return (
+                        gr.update(visible=not current_visible),  # показать/скрыть блок
+                        not current_visible,  # обновить состояние
+                        gr.update(visible=False)  # скрыть благодарность при открытии/закрытии
+                    )
+                feedback_text = gr.Textbox(
+                    label="Ваше наблюдение или комментарий",
+                    placeholder="Например: 'Для 3 лет лексика подбирается неправильно — какая там 'машина', максимум - 'би-би'",
+                    lines=4
+                )
+
+                rating = gr.Radio(
+                    choices=["1", "2", "3", "4", "5"],
+                    label="Оценка"
+                )
+
+                send_feedback = gr.Button("📩 Отправить отзыв")
+
+                feedback_confirmation = gr.Markdown(
+                    visible=False,
+                    elem_classes=["feedback-confirmation"]
+                )
+
+            # <-- Блок благодарности — ВНЕ feedback_block, но СРАЗУ ПОСЛЕ
+            with gr.Column(visible=False) as feedback_confirmation:
+                gr.Markdown("✅ Спасибо! Ваш комментарий передан и, возможно, уже сегодня ассистент станет полезнее :)")
+
+            # Остальное
+            gr.Markdown(
+                """
+                🙌 Если вас заинтересовал проект, мы приглашаем
+                👉 [присоединиться к Telegram-группе](https://t.me/+yN9BSJ1DJxxjZmJi)
+                """
+            )
+
+    ### --- Логика интерфейса ---
+
+    # Показываем/скрываем блок загрузки доп. изображений
+    def toggle_extra_images(show: bool):
+        return gr.update(visible=show)
+
+
+    show_extra.change(
+        fn=toggle_extra_images,
+        inputs=show_extra,
+        outputs=extra_images
+    )
+
+    ## Доп. настройки
+    # def toggle_advanced_settings(visible):
+    #     return gr.update(visible=not visible), not visible
+
+    # advanced_btn.click(
+    #     fn=toggle_advanced_settings,
+    #     inputs=[advanced_settings_visible],
+    #     outputs=[advanced_block, advanced_settings_visible]
+    # )
+
+    # Формат занятия - видимость поля если выбрано групповое
+    def toggle_format(selected_format):
+        return gr.update(visible=selected_format == "Групповое")
+    format_type.change(fn=toggle_format, inputs=format_type, outputs=group_settings)
+
+    # Возраст - деактивация поля если нажато "Взрослые"
+    def toggle_age(adult_checked):
+        return gr.update(interactive=not adult_checked)
+    adults.change(fn=toggle_age, inputs=adults, outputs=age)
+
+    # Функция для переключения видимости Target language
+    def toggle_target_language(methodology_value):
+        return gr.update(visible=methodology_value == "PPP (Presentation-Practice-Production)")
+    methodology.change(fn=toggle_target_language, inputs=methodology, outputs=target_language)
+
+    # JS для автодополнения
+    app.load(
+        None,
+        None,
+        js=f"""
+        const textbooks = {TEXTBOOKS};
+
+        function setupAutocomplete() {{
+            const input = document.getElementById('textbook_input');
+            if (!input) return;
+
+            const datalist = document.createElement('datalist');
+            datalist.id = 'textbook_suggestions';
+
+            textbooks.forEach(book => {{
+                const option = document.createElement('option');
+                option.value = book;
+                datalist.appendChild(option);
+            }});
+
+            input.setAttribute('list', datalist.id);
+            document.body.appendChild(datalist);
+        }}
+
+        // Запускаем после загрузки
+        if (document.readyState === 'complete') {{
+            setupAutocomplete();
+        }} else {{
+            document.addEventListener('DOMContentLoaded', setupAutocomplete);
+        }}
+        """
+    )
+    ### СПИСОК ВСЕХ ПАРАМЕТРОВ ИНТЕРФЕЙСА
+    all_inputs = [
+        image,  # Gradio компонент, соответствует image_path в функциях
+        textbook,
+        cefr,
+        topic,
+        goal,
+        format_type,
+        num_students,
+        age,
+        adults,
+        level_match,
+        duration,
+        inventory,
+        extra_info,
+        methodology,
+        target_language,
+        hw_required,
+        web_search
+        # repetition,
+        # application,
+        # analysis,
+        # creativity
+    ]
+
+    # Коллбек генерации
+    def on_generate(
+            image_path: Optional[str],  # Переименовано из image
+            textbook: str,
+            cefr: str,
+            topic: str,
+            goal: str,
+            format_type: str,
+            num_students: int,
+            age: str,
+            adults: bool,
+            level_match: int,
+            duration: int,
+            inventory: str,
+            extra_info: str,
+            methodology: str,
+            target_language: str,
+            hw_required: bool,
+            web_search: bool
+            # repetition: bool,
+            # application: bool,
+            # analysis: bool,
+            # creativity: bool
+    ):
+        # Проверка обязательных полей
+        if not image_path or (not adults and not age):
+            return gr.update(value="❗ Заполните обязательные поля (отмечены *)"), gr.update(visible=False)
+
+        # Собираем все аргументы в словарь
+        kwargs = locals()
+
+        # Генерация плана
+        text = generate_lesson_plan(**kwargs)
+
+        # Создание DOCX
+        docx_path = generate_docx(text) if not text.startswith("❗") else None
+        return gr.update(value=text), gr.update(visible=bool(docx_path), value=docx_path)
+
+    btn.click(
+        fn=on_generate,
+        inputs=[main_image, extra_images, all_inputs],
+        outputs=[output, download_btn]
+    )
+
+    # Логика: показать форму по нажатию на кнопку
+    feedback_btn.click(
+        fn=toggle_feedback_block,
+        inputs=[feedback_visible],
+        outputs=[feedback_block, feedback_visible, feedback_confirmation]
+    )
+
+    # Логика отправки обратной связи
+    def send_feedback_fn(comment, rate):
+        save_feedback(comment, rate)  # Сохраняем отзыв
+        return (
+            gr.update(visible=False),  # свернуть форму
+            False,  # сбросить состояние
+            gr.update(
+                value="✅ Спасибо! Ваш комментарий передан, и, возможно, уже сегодня ассистент станет полезнее :)",
+                visible=True
+            )
+        )
+
+    send_feedback.click(
+        fn=send_feedback_fn,
+        inputs=[feedback_text, rating],
+        outputs=[feedback_block, feedback_visible, feedback_confirmation]
+    )
+
+
+if __name__ == "__main__":
+    app.launch()

docs/architecture.md

@@ -1,3 +1,55 @@
+Я разрабатываю 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. со свободным ответом должны быть плейсхолдеры с релевантным текстом-подсказкой
+
+
+
+
+
+Собираем все параметры в all_inputs (это список Gradio-компонентов).
+
+Передаём их в on_generate через inputs=all_inputs.
+
+Внутри on_generate используем locals(), чтобы автоматически получить словарь всех аргументов.
+
+Распаковываем их в generate_lesson_plan(**kwargs).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 мне нужно сделать простое приложение по генерации планов уроков на базе предоставленной фотографии страницы учебника. 
 Для интерфейса используем streamlit. Логика такая - экран делится не левую и правую части. В левой части область загрузки 
 фотографии страницы учебника + поля заполнения и настройки (они появляются после успешной загрузки). 
@@ -16,6 +68,15 @@
 Длительное хранение загруженных изображений не требуется, поэтому решение tmpfiles.org подходит.
 
 
+
+Upload Image → (if auto_detect) → Vision API → Update Textbook Field → Show Form
+            ↘ (else) → Show Form Immediately
+
+uploaded_image → upload_to_catbox() → public_url → передача в OpenAI
+
+
+
+
 Structured Outputs через response_format с JSON Schema , так как:
 
 

docs/notes.md

@@ -0,0 +1,69 @@
+Сложности двух аспектов:
+Технические и архитектурные (
+Как сделать ссылку при file search называемой и кликабельной? через временные ссылки, s3 хранилище
+А если сделать стриминг ответа (чтобы построчно выводил), то эта логика ломается - как в этом случае добавить ссылки?
+Как добиться от file search лучшего обобщения материала, если он заточен под retrieval? Модели с reasoning + большее значение max_num_results
+Как деплоить MVP? Мое решение - HF Spaces + Gradio. Бесплатно, нативно, итеративно.
+
+Как дать такой UX чтобы заинтересованные результатом пользователи перешли в телеграм-группу тестировки? Сделать кнопку отзыва и перехода в группу после того, как генерация вызвана? 
+А ведь заинтересованный пользователь захочет скачать план занятия, значит под этой кнопкой скачивания мы и добавим кнопку "помочь проекту", внутри которого - блок отзыва + переход в тг-группу
+Результат: конверсия около 50% (количество срабатываний генерации (по логам openai / количество вступлений в тг-группу))
+
+
+Как достать номер страницы при file search? Reasoning
+
+Как тестировать на баги? Начни с самых нетипичных случаев поведения - они часто случатся, и ты потеряешь клиентов
+Ты должен четко понимать ценность продукта
+Если базовой ценности нет, то все остальное вокруг - пустая трата времени (ну или изучение новых навыков для другого проекта, имеющего ценность)
+Ценность может быть определена только клиентом.
+Поэтому наиболее ценный продукт - там где я и разработчик и клиент.
+Проверим эту гипотезу на TeacherAss
+
+
+В Конспекте Логопеда провал как раз в том, что я не смог контролировать ценность. Там нужно привлечение экспертной среды, которая будет всем - глазами, ушами, чутьем этого ассистента.
+
+Обнаружено:
+- Общие указания не работают. Если хочешь конкретно-заточенный воспроизводимый результат, нужно конкретно затачивать и смотреть что воспроизводится.
+- Без экспертности (внутренней или внешней) продукт не построить
+- ИИ напрямую не дает такую экспертность т.к. является живым носителем потребности - нужны живые люди - их боли, жалобы и прочее
+- В проекте использовал свою боль - люблю делать хорошие уроки, всё по ESL, PPP там, TTT, через контекст, но не хватало времени.
+Нужно чтобы кто-то очень чутко помогал мне, вдохновлял меня, чтобы я занимался не поиском материала, а творческой приятной деятельностью планирования,
+которое и является сутью моей работы. 
+И ведь все классные методики давно известны, верно? Но их надо "прожить" через себя, впитать.
+- А если ты начинающий, то ты можешь готовиться часами, всё выверяя. И это правильно.
+но асситент сделает этот процесс приятным
+
+
+
+TeacherAss:
+Каеие методические указания дать? Насколько детально?
+Какую методологию выбрать при каких параметрах? Например, если фокус на Reading? Vocabulary? И т.п.
+
+
+
+-- ЛогоКонспект
+Чего на самом деле хотят клиенты-логопеды? Им нужен рабочий конспект для каких целей? Они часто говорят что он "не по стандарту",
+те конспекты они используют возможно для некой отчетности. Нужно четко разграничивать для чего испольщовать конспект - чтобы сделать лучше занятие или для снятия рутины с отчетности.
+Здесь сразу разделение на государственные и частные практики.
+
+----
+Может быть много разных характеристик:
+Шкала творчества урока (от сухого до безумного)
+Шкала энергичности класса (тихий - значит надо вывести из себя/стоящий на ушах - надо успокоить)
+Рекомендации для учителя по classroom management - Как опция
+
+
+ИДЕИ ДЛЯ РАЗВИТИЯ:
+* генерация частей урока - захотел переделал вступление, и каждое задание - отдельно
+То есть сделать такой конструктор занятия. С элементами.
+Это требует четкой полноценной базы знаний. Какая методика с каким уровнем лучше, с каким возрастом. И так далее.
+
+* Функционал для онлайн - уроков: здесь акцент на презентации, интерактиве, электронных материалах и активностях (напр. Кахут)
+
+Для тестирования огромное поле:
+Какие методики лучше работают с какими параметрами - возраст, учебник (напр. можно ли выстроить PBL на материале spotlight) и т.п.
+
+
+Чтобы разработать AI-помощника который будет методично создавать планы уроков, например, необходимо:
+быть методистом
+Если 1 человек объединяет эти навык, это хорошо, но команда все равно нужна по разным направлениям. И методисты, и разработчики и UX/FB

requirements.txt

@@ -0,0 +1,8 @@
+python-dotenv
+python-docx
+openai
+gradio
+requests
+pillow
+
+