Files
notes-qpid-pro/README.md
T

3.6 KiB

Notes (notes.qpid.pro)

Персональный тренажёр и словарь технического английского языка для сетевого инженера.
Создан для быстрого снятия языкового барьера при чтении RFC, документации Cisco/Juniper, Linux networking и технических статей.


🎯 Миссия проекта

При чтении технической документации постоянные переключения на переводчик выбивают из мысли, а ручная запись слов в блокнот превращается в «кладбище информации».

Проект решает эту проблему по принципу «автомата Калашникова»:

  1. Мгновенный поиск и перевод без отвлечения от чтения.
  2. Контекстный якорь: сохранение слова вместе с живым предложением из документации.
  3. Фонетическое закрепление: нативное произношение (US/UK) и транскрипция IPA, чтобы говорить на митингах уверенно.
  4. Интервальные повторения (SRS / SM-2): умная система карточек (как в Anki), напоминая слова ровно тогда, когда мозг готов их забыть.

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


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

  • 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)

🚀 Быстрый старт (Разработка)

# Клонирование / переход в каталог проекта:
cd /home/kopri/notes.qpid.pro

# Создание виртуального окружения Python:
python3 -m venv venv
source venv/bin/activate

# Запуск будет доступен после развертывания Фазы 1

🌐 Информация о сервере и инфраструктуре

  • URL сервиса: 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)