Antigravity
3098d3016d
- Add resolve_context_sentence_for_term to replace placeholder blanks and lookup authentic sentences from cefr_questions or books - Fix dual mistake ingestion in process_cefr_answer to assign distinct context to target and chosen distractor - Provide authentic context_sentence in options_breakdown and pass it via data-context in cefr.js - Add repair_mismatched_cefr_contexts in database.py to automatically repair cards with placeholder blanks - Bump Service Worker cache to notes-v5.9 - Add test_cefr_context_resolution_and_repair covering resolution, dual ingestion, manual add, and DB repair
Notes (notes.qpid.pro)
Защищённый персональный тренажёр и словарь английского языка.
Создан для быстрого и надёжного расширения словарного запаса (общий английский, фразовые глаголы, идиомы, профессиональные термины) без отвлечения от чтения и просмотра контента.
🎯 Концепция и методика
Чтение статей, книг или просмотр видео на английском часто тормозится незнакомыми словами и выражениями. Обычный переводчик даёт мгновенный ответ, но слово сразу забывается. Ручные списки превращаются в «кладбище информации».
Проект решает эту проблему по принципу «автомата Калашникова»:
- Безопасность: сервис работает на белом IP, защищён авторизацией (сессии, хэширование паролей, защита от брутфорса).
- Мгновенный поиск и перевод: фокус на строке ввода, каскадный перевод (словарная статья + толкование + русский перевод).
- Контекстный якорь: сохранение слова вместе с живым предложением (где встретилось выражение).
- Фонетическое закрепление: нативное аудио-произношение (US/UK) и транскрипция IPA.
- Интервальные повторения (SRS / SM-2): встроенные карточки для перевода слов в долговременную память.
📂 Документация проекта
- 📚 Источники бесплатных книг (BOOKS_SOURCES.md) — проверенные каталоги адаптированных книг (A1–C1) и оригинальной классики в EPUB/TXT для читалки.
- 📋 План функционала и архитектура (PLAN.md) — детальный план итераций: от защищённого MVP до умных интервальных тренажёров.
- 🎓 Методология и педагогика (PEDAGOGY.md) — методические правила эффективного освоения языка: лексические связки (chunks), контекст, фонетика, кривая забывания Эббингауза.
- ✅ Очередь задач и бэклог (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)
🌐 Информация об окружении
- 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