# BIgo Reader - Quick Start Guide

## 🚀 Быстрый старт

### Запуск приложения

Из корневой директории BIgo:

```bash
python -m bigo_reader
```

Или из директории bigo_reader:

```bash
cd bigo_reader
python -m bigo_reader
```

### Первый запуск

1. Откроется главное окно BIgo Reader
2. Выберите **File → Open Database...**
3. Укажите файл `.sqlite` с базой данных книг
4. Автоматически откроется первая книга из базы

### Навигация

- **◀ Prev / Next ▶** - переход между страницами
- **Page:** - прямой ввод номера страницы
- **📑 Contents** - оглавление книги
- **Diagram:** - выбор диаграммы на текущей странице

### Закладки

1. Перейдите на нужную страницу
2. Нажмите **🔖 Bookmark**
3. Введите название закладки
4. **Bookmarks → Manage Bookmarks** для просмотра всех закладок

## ⚙️ Настройки

### Авто-открытие диаграмм

- **View → Auto Open First Diagram** - автоматически открывать первую диаграмму при переходе на страницу

### Размер шрифта

- **Ctrl++** - увеличить
- **Ctrl+-** - уменьшить

### Файлы конфигурации

**Windows:**
```
C:\Users\<ИМЯ>\.bigo_reader\
├── config.json    # Настройки приложения
└── session.json   # Текущая сессия чтения
```

## 📖 Основные функции

### ✅ Реализовано

- Открытие баз данных SQLite
- Чтение текста страниц
- Навигация по страницам (Prev/Next)
- Список диаграмм на странице
- Закладки (добавление)
- Изменение размера шрифта
- Автосохранение сессии
- Список недавних файлов

### 🚧 В разработке

- Просмотр диаграмм (diagram viewer)
- Выбор книги из базы
- Оглавление книги
- Поиск по тексту
- Менеджер закладок

## 🐛 Текущие ограничения

1. **Выбор книги** - пока автоматически выбирается первая книга из базы
2. **Просмотр диаграмм** - пока только список, просмотр в разработке
3. **Оглавление** - заглушка, будет реализовано
4. **Поиск** - заглушка, будет реализовано

## 📝 Следующие шаги разработки

1. **Интеграция diagram_viewer** - из существующего модуля bigo_book
2. **Диалог выбора книги** - при открытии базы с несколькими книгами
3. **Оглавление** - диалог с деревом разделов (Book_Parts)
4. **Поиск** - диалоги поиска в странице и по всей книге
5. **Менеджер закладок** - окно управления закладками

## 🔧 Тестирование

Для тестирования нужна база данных BIgo с таблицами:
- `Books`
- `Book_Pages`
- `Book_Dias`
- `Book_Pages_Dias`

Можно использовать:
- Существующие базы из `bigo_book/db/`
- Создать новую через `bigo_books_db.py`
- Создать BookShelf через **Tools → Create BookShelf**

## 📚 Структура проекта

```
bigo_reader/
├── __init__.py           # Модуль инициализации
├── __main__.py           # Точка входа
├── README.md             # Полная документация
├── requirements.txt      # Зависимости
│
├── core/                 # Ядро приложения
│   ├── app.py            # Главный класс ReaderApp
│   ├── config.py         # ConfigManager
│   └── session.py        # SessionManager
│
├── ui/                   # Интерфейс
│   └── main_window.py    # MainReaderWindow (tk.Tk)
│
├── data/                 # Работа с данными
│   ├── db_manager.py     # DatabaseManager
│   └── models.py         # Модели данных
│
└── features/             # Функции
    ├── text_reader.py    # Чтение текста
    ├── bookmarks.py      # Закладки
    ├── search.py         # Поиск
    └── navigation.py     # Навигация
```

## 💡 Советы

1. **Восстановление сессии** - при повторном запуске автоматически откроется последняя книга на последней странице

2. **Недавние файлы** - **File → Recent Files** содержит последние 10 открытых баз

3. **Горячие клавиши** - см. полный список в README.md

4. **Логи** - файл `bigo_reader.log` в директории запуска

## 🆘 Решение проблем

**Проблема:** Не открывается база данных
- Проверьте, что файл существует
- Убедитесь, что база содержит нужные таблицы
- Посмотрите логи в `bigo_reader.log`

**Проблема:** Не показывается текст
- Проверьте, что в таблице `Book_Pages` есть поле `Text`
- Убедитесь, что страница существует для выбранной книги

**Проблема:** Не работают горячие клавиши
- Убедитесь, что окно в фокусе
- На Mac используйте Cmd вместо Ctrl

## 📧 Обратная связь

Для вопросов и предложений см. основной README.md проекта BIgo.
