47 lines
4.1 KiB
Markdown
47 lines
4.1 KiB
Markdown
# 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`
|