# 🐳 Docker Quick Start

## Запуск за 3 шага

### 1️⃣ Создайте .env файл

**Windows:**
```cmd
copy .env.example .env
notepad .env
```

**Linux/Mac:**
```bash
cp .env.example .env
nano .env
```

**Укажите в .env:**
```env
TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather
```

### 2️⃣ Запустите

**Windows:**
```cmd
start.bat
```

**Linux/Mac:**
```bash
chmod +x start.sh
./start.sh
```

**Или через docker-compose:**
```bash
docker-compose up -d
```

### 3️⃣ Готово! 🎉

Бот запущен и работает в фоне.

## Управление

### Просмотр логов
```bash
docker-compose logs -f
```
*(Ctrl+C для выхода)*

### Остановка
```bash
docker-compose down
```

### Перезапуск
```bash
docker-compose restart
```

### Статус
```bash
docker-compose ps
```

## Makefile (для удобства)

Если установлен `make`:

```bash
make help     # Показать все команды
make up       # Запустить
make down     # Остановить
make logs     # Логи
make restart  # Перезапуск
make shell    # Войти в контейнер
make backup   # Создать backup данных
```

## Где хранятся данные?

```
./data/             → Пользовательские данные
  ├── users.json          (учетные данные, зашифрованные)
  └── .encryption_key     (ключ шифрования)

./logs/             → Логи бота

./temp_documents/   → Временные файлы (Excel/XML)
```

**⚠️ ВАЖНО:** Сделайте backup `./data/.encryption_key`!

## Обновление бота

```bash
# Остановка
docker-compose down

# Обновление кода
git pull

# Пересборка и запуск
docker-compose build
docker-compose up -d
```

**Или через Makefile:**
```bash
make update
```

## Troubleshooting

### "docker-compose: command not found"

Установите Docker и Docker Compose:
- [Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
- [Docker Desktop for Mac](https://docs.docker.com/desktop/install/mac-install/)
- [Docker Engine for Linux](https://docs.docker.com/engine/install/)

### Бот не запускается

```bash
# Проверьте логи
docker-compose logs

# Проверьте .env файл
cat .env  # Linux/Mac
type .env  # Windows
```

### Недостаточно прав (Linux)

```bash
# Добавьте пользователя в группу docker
sudo usermod -aG docker $USER

# Выйдите и войдите заново
```

## Полная документация

📖 [docs/DOCKER_GUIDE.md](DOCKER_GUIDE.md) - Подробное руководство

## Нужна помощь?

1. Проверьте [docs/DOCKER_GUIDE.md](DOCKER_GUIDE.md)
2. Посмотрите логи: `docker-compose logs -f`
3. Проверьте статус: `docker-compose ps`