feat(reader): remember reading position across refresh, add chapter progress bar, and plan PDF support
This commit is contained in:
@@ -120,7 +120,42 @@
|
||||
|
||||
---
|
||||
|
||||
### 6. 🔌 Пул соединений HTTP (`httpx.AsyncClient` с Keep-Alive)
|
||||
### 6. 📖 Запоминание позиции чтения и прогресс главы (Scroll position, Chapter Progress & Auto-restore)
|
||||
- [x] **Индикатор прогресса текущей главы**:
|
||||
- Тонкий неоновый прогресс-бар в шапке читалки (`reader-chapter-progress-bar`), плавно показывающий процент прочитанного в текущей главе.
|
||||
- Процентный бейдж в центре тулбара читалки рядом с выбором главы (`reader-scroll-pct-badge`, например `42%`).
|
||||
- [x] **Автоматическое сохранение позиции чтения**:
|
||||
- Отслеживание скролла читалки в реальном времени (`handleReaderScroll`).
|
||||
- Мгновенное сохранение в `localStorage` (`notes_book_{id}_pos`: номер главы, точные пиксели `scrollTop`, доля прогресса `fraction`).
|
||||
- Фоновая отправка прогресса на бэкенд (`PUT /api/books/{id}/progress`) с дебаунсом 800 мс.
|
||||
- Гарантированная фиксация позиции при закрытии/обновлении страницы через `beforeunload` + `navigator.sendBeacon`.
|
||||
- [x] **Бесшовное восстановление чтения при перезагрузке страницы**:
|
||||
- Сервис запоминает активный экран и ID открытой книги (`notes_active_book_id`).
|
||||
- При обновлении страницы (`F5` или свайп на телефоне) приложение автоматически открывает читалку на той же книге, той же главе и восстанавливает точную позицию скролла вплоть до пикселя.
|
||||
|
||||
---
|
||||
|
||||
### 7. 📑 Поддержка чтения PDF (Cisco CCNA, O'Reilly & Tech Books с оглавлением и текстовым слоем)
|
||||
- [ ] **Легковесный Pure-Python парсер (`pypdf`, Zero C-Dependency)**:
|
||||
- Подключение `pypdf` (< 400 КБ, чистый Python, без раздувания Docker-образа и без системных библиотек `poppler-utils` / `mupdf`).
|
||||
- [ ] **Извлечение оглавления и закладок PDF (`reader.outline`)**:
|
||||
- Извлечение авторского оглавления (ToC / Bookmarks), стандартного для книг Cisco Press (CCNA Official Cert Guide), O'Reilly и Wiley.
|
||||
- Разбивка книги на логические главы и разделы (`Part I`, `Chapter 1`, `Chapter 2`) точно по оглавлению автора.
|
||||
- [ ] **Fallback-разбивка при отсутствии оглавления**:
|
||||
- При отсутствии PDF-закладок — автоопределение заголовков через regex (`Chapter \d+`, `Глава \d+`) или группировка страниц порциями по ~12–15 страниц.
|
||||
- [ ] **Очистка шума и колонтитулов**:
|
||||
- Фильтрация повторяющихся верхних/нижних колонтитулов («CCNA 200-301 Official Cert Guide», «Page 45 of 900»).
|
||||
- [ ] **Сохранение CLI/Console блоков**:
|
||||
- Распознавание консольного вывода и команд сетевого оборудования (`Router# show ip interface brief`, `Switch(config)#`) и оборачивание в блоки кода Markdown для читалки с кнопкой «Копировать».
|
||||
- [ ] **Защита от сканов без OCR (Scanned PDF Guard)**:
|
||||
- Валидация наличия текстового слоя: если суммарный объём извлечённого текста < 100 слов, возврат информативной ошибки с предложением использовать текстовый PDF или OCR.
|
||||
- [ ] **Интеграция в интерфейс читалки**:
|
||||
- Разрешение загрузки `.pdf` в `<input type="file" accept=".epub,.txt,.md,.pdf">`.
|
||||
- Обновление кнопки в библиотеке: `📁 Загрузить EPUB / PDF / TXT`.
|
||||
|
||||
---
|
||||
|
||||
### 8. 🔌 Пул соединений HTTP (`httpx.AsyncClient` с Keep-Alive)
|
||||
- [ ] В [`app/dictionary.py`](file:///home/ai-projects/services/study.qpid.pro/app/dictionary.py) создать синглтон-клиент `get_http_client()` с пулом соединений:
|
||||
```python
|
||||
limits = httpx.Limits(max_keepalive_connections=10, max_connections=20)
|
||||
@@ -130,7 +165,7 @@
|
||||
|
||||
---
|
||||
|
||||
### 7. 🗄️ Тюнинг SQLite PRAGMA и составных индексов
|
||||
### 9. 🗄️ Тюнинг SQLite PRAGMA и составных индексов
|
||||
- [ ] В [`app/database.py`](file:///home/ai-projects/services/study.qpid.pro/app/database.py):
|
||||
- Вынести `PRAGMA journal_mode=WAL;` в `init_db()` (убрать избыточный вызов при каждом запросе).
|
||||
- Включить параметры производительности памяти Linux:
|
||||
@@ -143,13 +178,13 @@
|
||||
|
||||
---
|
||||
|
||||
### 8. ✂️ Де-блоатинг внешних парсеров (YAGNI)
|
||||
### 10. ✂️ Де-блоатинг внешних парсеров (YAGNI)
|
||||
- [ ] Удалить лишний сетевой опрос Datamuse (`fetch_datamuse`) — он дублирует определения и перегружает ответ нерелевантными рифмами.
|
||||
- [ ] Упростить хрупкий regex-парсинг разметки Wikitext, опираясь на стабильные REST JSON эндпоинты.
|
||||
|
||||
---
|
||||
|
||||
### 9. 📚 Локальный оффлайн-словарь (99%+ покрытия со словоформами, SQLite 10–20 МБ)
|
||||
### 11. 📚 Локальный оффлайн-словарь (99%+ покрытия со словоформами, SQLite 10–20 МБ)
|
||||
- [ ] Создать в SQLite таблицу:
|
||||
```sql
|
||||
CREATE TABLE IF NOT EXISTS offline_dictionary (
|
||||
@@ -171,7 +206,7 @@
|
||||
|
||||
---
|
||||
|
||||
### 10. 🧩 Модульность фронтенда на нативных ES-модулях (без Webpack/Vite)
|
||||
### 12. 🧩 Модульность фронтенда на нативных ES-модулях (без Webpack/Vite)
|
||||
- [ ] Перевести [`app/static/js/app.js`](file:///home/ai-projects/services/study.qpid.pro/app/static/js/app.js) на нативный браузерный синтаксис `<script type="module">`.
|
||||
- [ ] Выделить модули с нативным `import/export`:
|
||||
- `modules/reader.js` — читалку, блок-парсер и навигацию по главам.
|
||||
|
||||
Reference in New Issue
Block a user