58 lines
3.6 KiB
Markdown
58 lines
3.6 KiB
Markdown
# Notes (notes.qpid.pro)
|
|
|
|
> **Персональный тренажёр и словарь технического английского языка для сетевого инженера.**
|
|
> Создан для быстрого снятия языкового барьера при чтении RFC, документации Cisco/Juniper, Linux networking и технических статей.
|
|
|
|
---
|
|
|
|
## 🎯 Миссия проекта
|
|
При чтении технической документации постоянные переключения на переводчик выбивают из мысли, а ручная запись слов в блокнот превращается в «кладбище информации».
|
|
|
|
Проект решает эту проблему по принципу **«автомата Калашникова»**:
|
|
1. **Мгновенный поиск и перевод** без отвлечения от чтения.
|
|
2. **Контекстный якорь**: сохранение слова вместе с живым предложением из документации.
|
|
3. **Фонетическое закрепление**: нативное произношение (US/UK) и транскрипция IPA, чтобы говорить на митингах уверенно.
|
|
4. **Интервальные повторения (SRS / SM-2)**: умная система карточек (как в Anki), напоминая слова ровно тогда, когда мозг готов их забыть.
|
|
|
|
---
|
|
|
|
## 📂 Документация проекта
|
|
|
|
- 📋 [**План функционала и архитектура (PLAN.md)**](file:///home/kopri/notes.qpid.pro/PLAN.md) — детальный роадмап от базового MVP до умных тренажёров памяти.
|
|
- 🎓 [**Методология и педагогика (PEDAGOGY.md)**](file:///home/kopri/notes.qpid.pro/PEDAGOGY.md) — руководство по эффективному изучению сетевого английского: почему изолированные слова не работают, сила лексических связок (chunks), алгоритм SM-2.
|
|
|
|
---
|
|
|
|
## 🛠 Технический стек
|
|
|
|
- **Backend**: Python 3.12 (FastAPI / Uvicorn)
|
|
- **Database**: SQLite (WAL mode, надёжность и быстрые снимки)
|
|
- **Frontend**: Vanilla HTML5 / Modern CSS / 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)
|
|
|
|
---
|
|
|
|
## 🚀 Быстрый старт (Разработка)
|
|
|
|
```bash
|
|
# Клонирование / переход в каталог проекта:
|
|
cd /home/kopri/notes.qpid.pro
|
|
|
|
# Создание виртуального окружения Python:
|
|
python3 -m venv venv
|
|
source venv/bin/activate
|
|
|
|
# Запуск будет доступен после развертывания Фазы 1
|
|
```
|
|
|
|
---
|
|
|
|
## 🌐 Информация о сервере и инфраструктуре
|
|
|
|
- **URL сервиса**: [https://notes.qpid.pro](https://notes.qpid.pro)
|
|
- **IP-адрес сервера**: `31.77.203.213`
|
|
- **Каталог на сервере**: `/home/kopri/notes.qpid.pro`
|
|
- **Git Remote**: `http://127.0.0.1:3000/Antigravity/notes-qpid-pro.git` (зеркалируется в Gitea)
|