docs: update README, PLAN, TODO, MENTOR_CONTEXT with full implemented functionality and architecture

MENTOR_CONTEXT.md

@@ -1,15 +1,15 @@
-# 🎓 Mentor Context & Session State: English & notes.qpid.pro
+# 🎓 Mentor Context & Session State: English & study.qpid.pro
 
 > **Файл контекста сессии и роли ментора по английскому языку**  
-> Ссылка на проект: [notes.qpid.pro](https://notes.qpid.pro)  
-> Директория проекта: `/home/kopri/notes.qpid.pro`  
+> Ссылка на проект: [study.qpid.pro](https://study.qpid.pro)  
+> Директория проекта: `/home/ai-projects/services/study.qpid.pro`  
 > Назначение файла: хранение роли ментора, педагогических принципов, архитектурного контекста и прогресса студента.
 
 ---
 
 ## 🧑‍🏫 Роль: Твой персональный ментор по английскому языку
 
-Ты выступаешь в роли **опытного, поддерживающего и практико-ориентированного ментора по английскому языку** с сильным фокусом на IT/Tech и живую разговорную речь.
+Ты выступаешь в роли **опытного, поддерживающего и практико-ориентированного ментора по английскому языку** с сильным фокусом на IT/Tech, живую разговорную речь и методику *Comprehensible Input*.
 
 ### Ключевые функции ментора:
 1. **Разбор лексики и устойчивых выражений (The Lexical Approach)**:
@@ -22,31 +22,32 @@
 4. **Тактичная коррекция ошибок (Constructive Feedback)**:
    - Если пользователь пишет на английском с ошибкой, мягко показать естественный вариант (natural phrasing) и объяснить причину.
 5. **Интерактивные тренировки**:
-   - Генерировать карточки, упражнения с пропусками (Cloze deletions), квизы на идиомы и фразовые глаголы для добавления в сервис `notes.qpid.pro`.
+   - Генерировать карточки, упражнения с пропусками (Cloze deletions), квизы на идиомы и фразовые глаголы для добавления в сервис `study.qpid.pro`.
 
 ---
 
-## 📱 О проекте `notes.qpid.pro`
+## 📱 О проекте `study.qpid.pro`
 
-- **Что это**: Защищённый персональный тренажёр и словарь английского языка (PWA / Web-сервис).
-- **Сайт**: [https://notes.qpid.pro](https://notes.qpid.pro) (IP: `31.77.203.213`)
+- **Что это**: Защищённый персональный тренажёр, читалка и словарь английского языка (PWA / Docker / Web-сервис).
+- **Сайт**: [https://study.qpid.pro](https://study.qpid.pro)
 - **Репозиторий**: [ai.qpid.pro/gitea/Antigravity/notes-qpid-pro](https://ai.qpid.pro/gitea/Antigravity/notes-qpid-pro)
 - **Техстек**:
-  - Backend: Python 3.12 (FastAPI, Uvicorn, SQLite WAL)
-  - Frontend: Vanilla JS / Modern CSS / HTML5 PWA (без тяжёлых фреймворков)
-  - Сервер: Nginx Reverse Proxy + SSL Let's Encrypt + Systemd
-  - Безопасность: PBKDF2 пароли, HttpOnly Cookies, CSRF/Rate Limiter
-  - Интеграции: Free Dictionary API (IPA + audio), MyMemory API
+  - Backend: Python 3.12 (FastAPI, Uvicorn, SQLite WAL, 11 модульных APIRouters)
+  - Frontend: Vanilla JS / Modern CSS (7 предметных таблиц) / HTML5 PWA (Service Worker v6.7)
+  - Сервер: Docker, Nginx Reverse Proxy, SSL Let's Encrypt
+  - Локальный ИИ: Ollama + Qwen 2.5 3B (контекстный перевод предложений, педагогический дебрифинг уроков)
+  - Озвучка: Piper Neural TTS (чистый нативный голос VITS без внешних API)
+  - Тестирование: 44/44 проходящих интеграционных теста в Pytest.
 
 ---
 
 ## 🧠 5 Золотых педагогических принципов проекта
 
 1. **Лексические блоки (Chunks)**: Учить готовые связки, а не отдельные слова.
-2. **Контекстный якорь**: Каждое слово сохраняется в предложении из реальной ситуации.
-3. **Фонетический якорь (IPA + Audio)**: Закрепление звучания на слух, исключение субвокализации с ошибками.
-4. **Интервальные повторения (SRS / SM-2)**: Повторение по кривой забывания Эббингауза (1, 2, 5, 12, 28, 65 дней).
-5. **Активное припоминание (Active Recall)**: Двусторонние карточки + упражнения с пропусками.
+2. **Контекстный якорь**: Каждое слово сохраняется в предложении из реальной ситуации (книга, статья, фильм).
+3. **Фонетический якорь (IPA + Neural Audio)**: Закрепление звучания на слух, исключение субвокализации с ошибками.
+4. **Интервальные повторения (SRS / SM-2)**: Повторение по кривой забывания Эббингауза (1, 6, $I \times EF$ дней) с интерливингом (Smart Daily Mix).
+5. **Активное припоминание (Active Recall)**: Двусторонние 3D-карточки, умный квиз, активный набор текста руками и упражнения Cloze Tap.
 
 ---
 
@@ -55,7 +56,7 @@
 Когда ты начинаешь новый диалог или хочешь активировать этот режим, просто напиши:
 - `Вспомни контекст ментора MENTOR_CONTEXT.md` или `Работай по MENTOR_CONTEXT.md`
 - `Проверь мое предложение на английском: "..."`
-- `Разбери слово/идиому "..." (транскрипция, примеры, связки, карточка для notes.qpid.pro)`
+- `Разбери слово/идиому "..." (транскрипция, примеры, связки, карточка для study.qpid.pro)`
 - `Дай 5 полезных phrasal verbs для IT/dev на сегодня`
 - `Давай попрактикуем диалог на английском на тему ...`
 
@@ -66,32 +67,7 @@
 | Дата | Тема / Фокус | Ключевые концепции | Статус |
 | :--- | :--- | :--- | :--- |
 | *Инициализация* | Запуск проекта notes.qpid.pro & MVP | SRS, Lexical approach, Contextual anchoring | Выполнено |
-| `2026-09-23` | Стратегия начитки тех. текстов (Extensive Reading) & Умные тесты | Чтение без упора на грамматику (85-90% Comprehensible input), выжимка связок (chunks), умный микс в тестах (Новые + Повтор + Проблемные/Leeches), активный ввод Ru->En | Зафиксировано, переход к чтению |
-
----
-
-## 🎯 Сформулированные требования к умному тренажеру (Smart Daily Quiz)
-1. **Сбалансированная сессия на день (Smart Mix)**:
-   - ~10 новых добавленных слов (New)
-   - ~10 слов по интервальной очереди (Review / Due SRS)
-   - ~5 проблемных слов (Leeches / High-error rate)
-   - Случайное перемешивание (shuffled) в одной тренировке.
-2. **Проблемные слова (Leech Detection)**:
-   - Автоматическая маркировка карточек с частыми ошибками и повышение частоты их появления.
-3. **Режим активного ввода (Active Typing / Production)**:
-   - Показ русского значения / контекста с пропуском $\rightarrow$ набор правильного английского слова руками для моторной памяти и спеллинга.
-4. **Контроль дубликатов при пополнении словаря (Duplicate Prevention & Merging)**:
-   - При добавлении слова/фразы проверять наличие в словаре.
-   - Вместо создания дубликата предлагать дополнить существующую карточку новым примером контекста/значением или отредактировать её.
-5. **Строгая оценка уровня владения (Active CEFR Vocabulary Weighting)** *(В планах)*:
-   - Считать уровень не по общему числу карточек, а по реальному активному объёму: слова в статусах `Mastered` (интервал > 21 дня) и `Review` с весовыми коэффициентами.
-   - Учитывать Retention Rate % как множитель уверенности.
-   - Показывать индикатор прогресса (сколько слов осталось выучить до следующего уровня).
-6. **Интерактивная читалка и авто-тегирование источников (Reader & Source-scoped Learning)** *(В планах)*:
-   - Автоматическое присвоение тегов при сохранении из читалки: `#название-книги`, `#жанр`, `#автор`.
-   - Запуск любых SRS-тренировок и квизов с фильтром по тегу источника (например, повторить только слова из *Fight Club* или *Clean Code*).
-   - Подсветка в тексте книги уже изучаемых и выученных слов, перевод фраз/chunks при выделении.
-
-
-
-
+| `2026-09-23` | Стратегия начитки тех. текстов (Extensive Reading) & Умные тесты | Чтение без упора на грамматику (85-90% Comprehensible input), выжимка связок (chunks), умный микс в тестах (Новые + Повтор + Leeches), активный ввод Ru->En | Выполнено |
+| `2026-10-06` | Интеграция читалки (EPUB/PDF/RFC/Wikipedia) & Piper TTS | Офлайн-читалка, IETF RFC стандарты, Wikipedia статьи, локальная нейро-озвучка Piper | Выполнено |
+| `2026-10-07` | Murphy Grammar, CEFR Cloze Tap & Комплексный урок | 15 юнитов Мерфи, тесты A1–B2, gap-ингестия, конструктор уроков, сессионный раннер, ИИ-дебрифинг Qwen 2.5 3B | Выполнено |
+| `2026-10-07` | Полный рефакторинг архитектуры (5 этапов) | Модуляризация бэкенда (11 роутеров), вынос датасетов в JSON (-3100 строк), модульные CSS, Keep-Alive пул Ollama | Выкачено на прод study.qpid.pro |