# Notes (notes.qpid.pro)

> **Защищённый персональный тренажёр и словарь английского языка.**  
> Создан для быстрого и надёжного расширения словарного запаса (общий английский, фразовые глаголы, идиомы, профессиональные термины) без отвлечения от чтения и просмотра контента.

---

## 🎯 Концепция и методика
Чтение статей, книг или просмотр видео на английском часто тормозится незнакомыми словами и выражениями. Обычный переводчик даёт мгновенный ответ, но слово сразу забывается. Ручные списки превращаются в «кладбище информации».

Проект решает эту проблему по принципу **«автомата Калашникова»**:
1. **Безопасность**: сервис работает на белом IP, защищён авторизацией (сессии, хэширование паролей, защита от брутфорса).
2. **Мгновенный поиск и перевод**: фокус на строке ввода, каскадный перевод (словарная статья + толкование + русский перевод).
3. **Контекстный якорь**: сохранение слова вместе с живым предложением (где встретилось выражение).
4. **Фонетическое закрепление**: нативное аудио-произношение (US/UK) и транскрипция IPA.
5. **Интервальные повторения (SRS / SM-2)**: встроенные карточки для перевода слов в долговременную память.

---

## 📂 Документация проекта

- 📚 [**Источники бесплатных книг (BOOKS_SOURCES.md)**](BOOKS_SOURCES.md) — проверенные каталоги адаптированных книг (A1–C1) и оригинальной классики в EPUB/TXT для читалки.
- 📋 [**План функционала и архитектура (PLAN.md)**](PLAN.md) — детальный план итераций: от защищённого MVP до умных интервальных тренажёров.
- 🎓 [**Методология и педагогика (PEDAGOGY.md)**](PEDAGOGY.md) — методические правила эффективного освоения языка: лексические связки (chunks), контекст, фонетика, кривая забывания Эббингауза.
- ✅ [**Очередь задач и бэклог (TODO.md)**](TODO.md) — текущий статус реализации оптимизаций и фичей.

---

## 🛠 Технический стек

- **Backend**: Python 3.12 (FastAPI / Uvicorn)
- **Database**: SQLite (WAL mode — надёжность, автономность, бэкап в один файл)
- **Безопасность**: Защищённые сессии (HttpOnly cookies), PBKDF2-HMAC-SHA256, Rate Limiting
- **Frontend**: Vanilla HTML5 / Modern CSS / ES6+ JavaScript (PWA, горячие клавиши, мгновенный отклик)
- **Внешние API**: Free Dictionary API (IPA + audio), MyMemory Translation API
- **Веб-сервер**: Nginx Reverse Proxy + SSL Let's Encrypt (`notes.qpid.pro`)
- **Репозиторий проекта**: [Gitea (ai.qpid.pro/gitea/Antigravity/notes-qpid-pro)](https://ai.qpid.pro/gitea/Antigravity/notes-qpid-pro)

---

## 🌐 Информация об окружении

- **URL сервиса**: [https://notes.qpid.pro](https://notes.qpid.pro)
- **IP сервера**: `31.77.203.213`
- **Каталог проекта**: [`/home/kopri/notes.qpid.pro`](file:///home/kopri/notes.qpid.pro)
- **Git Remote**: `http://127.0.0.1:3000/Antigravity/notes-qpid-pro.git`