diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e473a15
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,89 @@
+# Обновление бота - Поиск заказов
+
+## ✅ Исправлено
+
+1. **Проблема с командой /orders** - добавлено детальное логирование и обработка ошибок
+2. **Глобальный обработчик ошибок** - все ошибки теперь логируются и пользователь получает понятное сообщение
+
+## 🆕 Новые возможности
+
+### Команда поиска заказа по номеру
+
+Теперь вы можете искать заказы по номеру командой `/search`
+
+**Использование:**
+```
+/search 00001
+/search СЧ-123
+/search Заказ
+```
+
+**Как работает:**
+1. Отправьте команду `/search` с номером заказа
+2. Бот найдет все подходящие заказы в МойСклад
+3. Выберите нужный заказ из списка результатов
+4. Далее работа идет как обычно: выбор типа документа и формата
+
+## 📋 Обновленные команды
+
+- `/start` - Приветствие и описание бота
+- `/orders` - Показать последние 10 заказов
+- `/search <номер>` - **НОВОЕ!** Найти заказ по номеру
+- `/help` - Справка по командам
+
+## 🔍 Примеры использования
+
+### Просмотр последних заказов:
+```
+/orders
+```
+
+### Поиск конкретного заказа:
+```
+/search 00042
+```
+
+### Поиск по части номера:
+```
+/search СЧ-2024
+```
+
+## 🛠️ Технические улучшения
+
+1. **Детальное логирование** - теперь все действия логируются для отладки
+2. **Обработка исключений** - добавлены try-catch блоки для всех критических операций
+3. **Глобальный error_handler** - перехватывает все необработанные ошибки
+4. **Информативные сообщения** - пользователь получает понятные сообщения об ошибках
+
+## 🚀 Запуск
+
+После обновления просто перезапустите бота:
+
+```bash
+python main.py
+```
+
+Бот автоматически:
+- Проверит подключение к МойСклад
+- Проверит токен Telegram
+- Запустит все обработчики
+
+## 📝 Логи
+
+Теперь в логах вы увидите:
+- Какой пользователь отправил команду
+- Сколько заказов найдено
+- Детали всех ошибок с трассировкой
+
+Пример лога:
+```
+INFO - Команда /orders от пользователя 123456789
+INFO - Запрос к API МойСклад...
+INFO - Получено заказов: 10
+```
+
+## ⚠️ Примечания
+
+- Поиск работает по частичному совпадению (можно искать часть номера)
+- Максимум показывается 10 результатов поиска
+- Если заказ не найден, бот предложит использовать /orders
diff --git a/docs/DOCKER_CHANGELOG.md b/docs/DOCKER_CHANGELOG.md
new file mode 100644
index 0000000..f28adde
--- /dev/null
+++ b/docs/DOCKER_CHANGELOG.md
@@ -0,0 +1,226 @@
+# Docker Containerization - 3 ноября 2025
+
+## 🐳 Добавлена поддержка Docker
+
+### Что добавлено
+
+1. **Dockerfile**
+   - Базовый образ: Python 3.11-slim
+   - Многоступенчатая установка зависимостей
+   - Volumes для персистентных данных
+   - Healthcheck для мониторинга
+   - Оптимизирован размер образа
+
+2. **docker-compose.yml**
+   - Полная оркестрация сервиса
+   - Управление ресурсами (CPU/RAM)
+   - Автоматический перезапуск
+   - Логирование с ротацией
+   - Изолированная сеть
+
+3. **Скрипты запуска**
+   - `start.sh` / `start.bat` - запуск (Linux/Windows)
+   - `stop.sh` / `stop.bat` - остановка (Linux/Windows)
+   - Автоматическое создание директорий
+   - Проверка наличия .env
+
+4. **Makefile**
+   - 20+ команд для управления
+   - `make up` - запуск
+   - `make down` - остановка
+   - `make logs` - логи
+   - `make backup` - создание backup
+   - `make test` / `make lint` - разработка
+
+5. **Документация**
+   - `docs/DOCKER_GUIDE.md` - полное руководство (120+ строк)
+   - `docs/DOCKER_QUICKSTART.md` - быстрый старт
+   - Примеры использования
+   - Troubleshooting
+
+6. **Обновлён user_manager.py**
+   - Поддержка переменной `DATA_DIR`
+   - Автоматическое создание директорий
+   - Совместимость с Docker volumes
+
+### Изменения в существующих файлах
+
+**`.env.example`:**
+- Удалены `MOYSKLAD_LOGIN` и `MOYSKLAD_PASSWORD`
+- Добавлена `TZ=Europe/Moscow` для Docker
+- Комментарий о многопользовательской системе
+
+**.gitignore:**
+- Добавлена директория `data/` (для Docker volumes)
+- Добавлена директория `logs/`
+
+**README.md:**
+- Добавлен раздел "Вариант 1: Docker (рекомендуется)"
+- Обновлены инструкции по запуску
+- Ссылки на Docker документацию
+
+### Структура директорий для Docker
+
+```
+BUH_bot/
+├── Dockerfile
+├── docker-compose.yml
+├── .dockerignore
+├── Makefile
+├── start.sh / start.bat
+├── stop.sh / stop.bat
+├── data/                    # Volume: пользовательские данные
+│   ├── users.json
+│   └── .encryption_key
+├── logs/                    # Volume: логи
+└── temp_documents/          # Volume: временные файлы
+```
+
+### Volumes (персистентные данные)
+
+1. **`./data/` → `/app/data`**
+   - `users.json` - зашифрованные credentials пользователей
+   - `.encryption_key` - ключ шифрования
+
+2. **`./logs/` → `/app/logs`**
+   - Логи работы бота
+
+3. **`./temp_documents/` → `/app/temp_documents`**
+   - Временные XML/Excel файлы
+
+### Конфигурация контейнера
+
+**Ресурсы:**
+- CPU: 0.5 cores (limit), 0.25 cores (reservation)
+- RAM: 512MB (limit), 256MB (reservation)
+
+**Restart policy:**
+- `unless-stopped` - автоматический перезапуск кроме явной остановки
+
+**Healthcheck:**
+- Интервал: 30 секунд
+- Timeout: 10 секунд
+- Retries: 3
+- Start period: 40 секунд
+
+**Логирование:**
+- Driver: json-file
+- Max size: 10MB per file
+- Max files: 3 (30MB total)
+
+### Использование
+
+#### Быстрый старт (Windows):
+```cmd
+copy .env.example .env
+notepad .env
+start.bat
+```
+
+#### Быстрый старт (Linux/Mac):
+```bash
+cp .env.example .env
+nano .env
+chmod +x start.sh
+./start.sh
+```
+
+#### С Makefile:
+```bash
+make help      # Показать команды
+make up        # Запустить
+make logs      # Логи
+make down      # Остановить
+make backup    # Backup данных
+```
+
+### Преимущества Docker-версии
+
+1. **Изоляция**
+   - Независимое окружение
+   - Нет конфликтов с системными пакетами
+
+2. **Простота развертывания**
+   - Один образ для всех платформ
+   - Не нужно устанавливать Python и зависимости
+
+3. **Управление ресурсами**
+   - Ограничение CPU/RAM
+   - Предсказуемое потребление ресурсов
+
+4. **Надёжность**
+   - Автоматический перезапуск
+   - Healthcheck для мониторинга
+   - Логирование с ротацией
+
+5. **Масштабируемость**
+   - Легко добавить reverse proxy (nginx)
+   - Готово к Docker Swarm / Kubernetes
+
+### Совместимость
+
+- ✅ Windows 10/11 (Docker Desktop)
+- ✅ macOS (Docker Desktop)
+- ✅ Linux (Docker Engine)
+- ✅ Windows Server 2016+
+- ✅ Raspberry Pi (ARM)
+
+### Миграция с локальной версии
+
+Существующие пользователи могут:
+
+1. Продолжить использовать локальную версию (`python bot.py`)
+2. Перейти на Docker:
+   ```bash
+   # Скопировать данные
+   mkdir data
+   mv users.json data/
+   mv .encryption_key data/
+   
+   # Запустить в Docker
+   ./start.sh
+   ```
+
+Данные полностью совместимы!
+
+### Следующие шаги
+
+Планируется добавить:
+- [ ] Docker Hub образ для быстрого деплоя
+- [ ] Kubernetes манифесты
+- [ ] CI/CD pipeline (GitHub Actions)
+- [ ] Мониторинг (Prometheus + Grafana)
+- [ ] Nginx reverse proxy для webhook режима
+
+### Тестирование
+
+Протестировано на:
+- ✅ Windows 11 + Docker Desktop
+- ✅ Ubuntu 22.04 + Docker Engine
+- ✅ macOS Sonoma + Docker Desktop
+
+### Безопасность
+
+- Credentials не попадают в образ (через .dockerignore)
+- Volumes для чувствительных данных
+- Logs с ротацией (предотвращение переполнения диска)
+- Изолированная сеть
+
+### Размер образа
+
+- Базовый образ: ~150MB
+- С зависимостями: ~300MB
+- Итого: **~300MB** (сжатый ~120MB)
+
+### Дополнительные материалы
+
+- [docs/DOCKER_GUIDE.md](DOCKER_GUIDE.md) - Полное руководство
+- [docs/DOCKER_QUICKSTART.md](DOCKER_QUICKSTART.md) - Быстрый старт
+- [docs/MULTI_USER_AUTH.md](MULTI_USER_AUTH.md) - Система авторизации
+- [docs/MIGRATION_GUIDE.md](MIGRATION_GUIDE.md) - Миграция на многопользовательскую версию
+
+---
+
+**Автор:** Docker containerization  
+**Дата:** 3 ноября 2025  
+**Версия:** 1.0
diff --git a/docs/DOCKER_GUIDE.md b/docs/DOCKER_GUIDE.md
new file mode 100644
index 0000000..54560cb
--- /dev/null
+++ b/docs/DOCKER_GUIDE.md
@@ -0,0 +1,493 @@
+# Docker Development & Deployment Guide
+
+## 📦 Структура Docker-окружения
+
+```
+BUH_bot/
+├── Dockerfile                 # Образ контейнера
+├── docker-compose.yml         # Оркестрация
+├── .dockerignore             # Исключения при сборке
+├── start.sh / start.bat      # Скрипт запуска (Linux/Windows)
+├── stop.sh / stop.bat        # Скрипт остановки (Linux/Windows)
+├── .env                      # Переменные окружения
+└── .env.example              # Пример конфигурации
+```
+
+## 🚀 Быстрый старт
+
+### 1. Подготовка
+
+**Linux/Mac:**
+```bash
+# Клонируем репозиторий
+git clone <repo_url>
+cd BUH_bot
+
+# Создаём .env из примера
+cp .env.example .env
+
+# Редактируем .env и указываем TELEGRAM_BOT_TOKEN
+nano .env
+```
+
+**Windows:**
+```cmd
+git clone <repo_url>
+cd BUH_bot
+
+copy .env.example .env
+notepad .env
+```
+
+### 2. Запуск
+
+**Linux/Mac:**
+```bash
+chmod +x start.sh stop.sh
+./start.sh
+```
+
+**Windows:**
+```cmd
+start.bat
+```
+
+**Или напрямую через docker-compose:**
+```bash
+docker-compose up -d
+```
+
+### 3. Проверка статуса
+
+```bash
+# Статус контейнера
+docker-compose ps
+
+# Логи в реальном времени
+docker-compose logs -f
+
+# Последние 100 строк логов
+docker-compose logs --tail=100
+```
+
+### 4. Остановка
+
+**Linux/Mac:**
+```bash
+./stop.sh
+```
+
+**Windows:**
+```cmd
+stop.bat
+```
+
+**Или напрямую:**
+```bash
+docker-compose down
+```
+
+## 🏗️ Dockerfile
+
+### Основные особенности:
+
+- **Базовый образ:** `python:3.11-slim` (легкий, ~150MB)
+- **Рабочая директория:** `/app`
+- **Volumes:** 
+  - `/app/data` - пользовательские данные (users.json, .encryption_key)
+  - `/app/logs` - логи бота
+  - `/app/temp_documents` - временные файлы
+- **Healthcheck:** Проверка работоспособности каждые 30 секунд
+- **Multi-stage build:** Нет (можно добавить для уменьшения размера)
+
+### Сборка образа вручную:
+
+```bash
+# Сборка
+docker build -t buh_bot:latest .
+
+# Запуск
+docker run -d \
+  --name buh_bot \
+  --env-file .env \
+  -v $(pwd)/data:/app/data \
+  -v $(pwd)/logs:/app/logs \
+  -v $(pwd)/temp_documents:/app/temp_documents \
+  buh_bot:latest
+```
+
+## 🎛️ Docker Compose
+
+### Конфигурация
+
+```yaml
+version: '3.8'
+
+services:
+  buh_bot:
+    build: .
+    container_name: buh_bot
+    restart: unless-stopped
+    
+    environment:
+      - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
+      - MOYSKLAD_API_URL=${MOYSKLAD_API_URL}
+      - TZ=Europe/Moscow
+    
+    volumes:
+      - ./data:/app/data
+      - ./logs:/app/logs
+      - ./temp_documents:/app/temp_documents
+    
+    deploy:
+      resources:
+        limits:
+          cpus: '0.5'
+          memory: 512M
+```
+
+### Полезные команды:
+
+```bash
+# Пересборка образа
+docker-compose build --no-cache
+
+# Запуск с выводом логов
+docker-compose up
+
+# Перезапуск
+docker-compose restart
+
+# Остановка и удаление контейнера
+docker-compose down
+
+# Остановка + удаление volumes
+docker-compose down -v
+
+# Просмотр логов конкретного сервиса
+docker-compose logs buh_bot
+
+# Вход в контейнер
+docker-compose exec buh_bot bash
+
+# Просмотр использования ресурсов
+docker stats buh_bot
+```
+
+## 📁 Volumes и данные
+
+### Bind Mounts (текущая конфигурация)
+
+Данные хранятся на хосте в директориях:
+- `./data/` → `/app/data` - users.json, .encryption_key
+- `./logs/` → `/app/logs` - логи бота
+- `./temp_documents/` → `/app/temp_documents` - временные документы
+
+**Преимущества:**
+- Простой доступ к данным с хоста
+- Легко делать backup
+- Данные сохраняются после `docker-compose down`
+
+**Backup:**
+```bash
+# Создание backup
+tar -czf backup-$(date +%Y%m%d).tar.gz data/ logs/
+
+# Восстановление
+tar -xzf backup-20250103.tar.gz
+```
+
+### Named Volumes (альтернатива)
+
+В `docker-compose.yml` можно использовать named volumes:
+
+```yaml
+volumes:
+  - bot_data:/app/data
+  - bot_logs:/app/logs
+
+volumes:
+  bot_data:
+    driver: local
+  bot_logs:
+    driver: local
+```
+
+**Преимущества:**
+- Управляются Docker
+- Лучшая производительность на Windows/Mac
+
+**Backup named volumes:**
+```bash
+# Создание backup
+docker run --rm -v bot_data:/data -v $(pwd):/backup \
+  alpine tar czf /backup/data-backup.tar.gz -C /data .
+
+# Восстановление
+docker run --rm -v bot_data:/data -v $(pwd):/backup \
+  alpine tar xzf /backup/data-backup.tar.gz -C /data
+```
+
+## 🔐 Безопасность
+
+### Environment Variables
+
+**Важно:** Никогда не коммитьте `.env` в Git!
+
+```bash
+# .env должен быть в .gitignore
+echo ".env" >> .gitignore
+```
+
+### Секреты (для продакшена)
+
+Для production рекомендуется использовать Docker secrets:
+
+```yaml
+services:
+  buh_bot:
+    secrets:
+      - telegram_token
+      
+secrets:
+  telegram_token:
+    file: ./secrets/telegram_token.txt
+```
+
+### Ключ шифрования
+
+Критически важно сохранить `.encryption_key`!
+
+```bash
+# Backup ключа
+cp data/.encryption_key data/.encryption_key.backup
+
+# Или в безопасное место
+cp data/.encryption_key ~/secure-backup/
+```
+
+Если ключ будет утерян, все пользовательские credentials станут недоступны.
+
+## 📊 Мониторинг
+
+### Логи
+
+```bash
+# Все логи
+docker-compose logs
+
+# Последние 100 строк
+docker-compose logs --tail=100
+
+# Следить за логами
+docker-compose logs -f
+
+# Логи с временными метками
+docker-compose logs -t
+```
+
+### Ресурсы
+
+```bash
+# Использование CPU/RAM в реальном времени
+docker stats buh_bot
+
+# Информация о контейнере
+docker inspect buh_bot
+
+# Процессы внутри контейнера
+docker-compose top
+```
+
+### Healthcheck
+
+Контейнер проверяет свою работоспособность каждые 30 секунд:
+
+```bash
+# Проверка health status
+docker inspect --format='{{.State.Health.Status}}' buh_bot
+```
+
+Статусы:
+- `healthy` - всё работает
+- `unhealthy` - проблемы (3 неудачных проверки)
+- `starting` - контейнер запускается
+
+## 🔄 Обновление
+
+### Обновление кода
+
+```bash
+# Остановка бота
+docker-compose down
+
+# Получение обновлений
+git pull
+
+# Пересборка образа
+docker-compose build
+
+# Запуск
+docker-compose up -d
+```
+
+### Обновление зависимостей
+
+После изменения `requirements.txt`:
+
+```bash
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+## 🐛 Troubleshooting
+
+### Контейнер не запускается
+
+```bash
+# Проверить логи
+docker-compose logs
+
+# Проверить конфигурацию
+docker-compose config
+
+# Запустить в foreground режиме
+docker-compose up
+```
+
+### Проблемы с правами доступа
+
+**Linux:**
+```bash
+# Изменить владельца директорий
+sudo chown -R $USER:$USER data logs temp_documents
+
+# Или дать полные права (не рекомендуется для продакшена)
+chmod -R 777 data logs temp_documents
+```
+
+### Ошибка "port already in use"
+
+Если используются дополнительные сервисы с портами:
+```bash
+# Найти процесс использующий порт
+netstat -tulpn | grep :8443
+
+# Или
+lsof -i :8443
+
+# Остановить конфликтующий контейнер
+docker stop <container_name>
+```
+
+### Контейнер падает с OOM (Out of Memory)
+
+Увеличить лимит памяти в `docker-compose.yml`:
+```yaml
+deploy:
+  resources:
+    limits:
+      memory: 1G  # было 512M
+```
+
+### Нет места на диске
+
+```bash
+# Очистка неиспользуемых образов
+docker image prune -a
+
+# Очистка всего неиспользуемого
+docker system prune -a --volumes
+
+# Проверка использования места
+docker system df
+```
+
+## 🚀 Production Deployment
+
+### Использование Docker Swarm
+
+```bash
+# Инициализация Swarm
+docker swarm init
+
+# Деплой stack
+docker stack deploy -c docker-compose.yml buh_bot_stack
+
+# Масштабирование (если нужно)
+docker service scale buh_bot_stack_buh_bot=2
+
+# Просмотр сервисов
+docker stack services buh_bot_stack
+
+# Удаление stack
+docker stack rm buh_bot_stack
+```
+
+### Использование с nginx (reverse proxy)
+
+Если планируется использовать webhook режим:
+
+```yaml
+# docker-compose.yml
+services:
+  buh_bot:
+    # ... существующая конфигурация
+    expose:
+      - "8443"
+    
+  nginx:
+    image: nginx:alpine
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./nginx.conf:/etc/nginx/nginx.conf
+      - ./certs:/etc/nginx/certs
+```
+
+### CI/CD пример (GitHub Actions)
+
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy Bot
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      
+      - name: Build and push Docker image
+        run: |
+          docker build -t myregistry/buh_bot:latest .
+          docker push myregistry/buh_bot:latest
+      
+      - name: Deploy to server
+        run: |
+          ssh user@server "cd /app/buh_bot && \
+            docker-compose pull && \
+            docker-compose up -d"
+```
+
+## 📚 Дополнительные ресурсы
+
+- [Docker Documentation](https://docs.docker.com/)
+- [Docker Compose Documentation](https://docs.docker.com/compose/)
+- [Best practices for writing Dockerfiles](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/)
+- [Docker security best practices](https://docs.docker.com/engine/security/)
+
+## 🎯 Checklist перед деплоем
+
+- [ ] `.env` файл создан и заполнен
+- [ ] `TELEGRAM_BOT_TOKEN` указан корректно
+- [ ] Директории `data/`, `logs/`, `temp_documents/` созданы
+- [ ] Docker и Docker Compose установлены
+- [ ] Backup `.encryption_key` сделан
+- [ ] Логирование настроено
+- [ ] Healthcheck работает
+- [ ] Тестовый запуск выполнен успешно
diff --git a/docs/DOCKER_QUICKSTART.md b/docs/DOCKER_QUICKSTART.md
new file mode 100644
index 0000000..91a0800
--- /dev/null
+++ b/docs/DOCKER_QUICKSTART.md
@@ -0,0 +1,153 @@
+# 🐳 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`
diff --git a/docs/PRODUCTION_DEPLOYMENT.md b/docs/PRODUCTION_DEPLOYMENT.md
new file mode 100644
index 0000000..6e25240
--- /dev/null
+++ b/docs/PRODUCTION_DEPLOYMENT.md
@@ -0,0 +1,436 @@
+# Production Deployment Guide
+
+## 🎯 Архитектура Production
+
+```
+┌─────────────────────────────────────────────────┐
+│               Production Stack                   │
+├─────────────────────────────────────────────────┤
+│                                                  │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
+│  │  Nginx   │  │ BUH Bot  │  │Prometheus│     │
+│  │  Proxy   │→ │ (Main)   │← │Monitoring│     │
+│  └──────────┘  └──────────┘  └──────────┘     │
+│                      ↓              ↓           │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
+│  │ Grafana  │← │ Node     │  │cAdvisor  │     │
+│  │Dashboard │  │ Exporter │  │Containers│     │
+│  └──────────┘  └──────────┘  └──────────┘     │
+│                      ↓                          │
+│  ┌──────────────────────────────────┐          │
+│  │      Watchtower (Auto-update)    │          │
+│  └──────────────────────────────────┘          │
+└─────────────────────────────────────────────────┘
+```
+
+## 📋 Компоненты
+
+### Основные сервисы
+
+1. **buh_bot** - Telegram бот (главный сервис)
+   - Использует готовый образ из registry
+   - Автоматический перезапуск
+   - Healthcheck каждые 30 секунд
+   - Limits: 1 CPU, 1GB RAM
+
+2. **nginx** - Reverse proxy
+   - Rate limiting
+   - SSL termination (опционально)
+   - Health endpoints
+   - Logs rotation
+
+### Мониторинг
+
+3. **prometheus** - Сбор метрик
+   - Retention: 30 дней
+   - Port: 9090
+   - Метрики хоста и контейнеров
+
+4. **grafana** - Визуализация
+   - Дашборды
+   - Алерты
+   - Port: 3000
+
+5. **node_exporter** - Метрики хоста
+   - CPU, RAM, Disk, Network
+   - Port: 9100
+
+6. **cadvisor** - Метрики контейнеров
+   - Docker metrics
+   - Port: 8080
+
+### Автоматизация
+
+7. **watchtower** - Автообновление
+   - Проверка обновлений каждый час
+   - Автоматический pull и restart
+   - Очистка старых образов
+
+## 🚀 Развертывание
+
+### Шаг 1: Подготовка образа
+
+#### Вариант А: Использование GitHub Container Registry
+
+1. **Форкните репозиторий** на GitHub
+
+2. **Включите GitHub Actions:**
+   - Settings → Actions → Allow all actions
+
+3. **Создайте тег и запушьте:**
+   ```bash
+   git tag v1.0.0
+   git push origin v1.0.0
+   ```
+
+4. **GitHub Actions автоматически:**
+   - Соберёт образ
+   - Запустит тесты
+   - Опубликует в `ghcr.io/your-username/buh_bot`
+
+#### Вариант Б: Локальная сборка
+
+```bash
+# Авторизация в registry
+docker login ghcr.io
+
+# Сборка и публикация
+chmod +x build-image.sh
+./build-image.sh
+```
+
+**Windows:**
+```cmd
+docker login ghcr.io
+build-image.bat
+```
+
+### Шаг 2: Настройка сервера
+
+```bash
+# Установка Docker и Docker Compose
+curl -fsSL https://get.docker.com | sh
+sudo usermod -aG docker $USER
+
+# Клонирование конфигурации
+git clone <your-repo>
+cd BUH_bot
+```
+
+### Шаг 3: Конфигурация
+
+```bash
+# Создание .env.prod
+cp .env.prod.example .env.prod
+nano .env.prod
+```
+
+**Обязательные переменные:**
+```env
+TELEGRAM_BOT_TOKEN=your_production_token
+DOCKER_USERNAME=your_github_username
+GRAFANA_PASSWORD=secure_password_here
+```
+
+### Шаг 4: Создание директорий
+
+```bash
+# Директории для данных
+sudo mkdir -p /var/lib/buh_bot/data
+sudo mkdir -p /var/log/buh_bot
+sudo mkdir -p /var/tmp/buh_bot
+
+# Права доступа
+sudo chown -R $USER:$USER /var/lib/buh_bot
+sudo chown -R $USER:$USER /var/log/buh_bot
+sudo chown -R $USER:$USER /var/tmp/buh_bot
+```
+
+### Шаг 5: Деплой
+
+```bash
+chmod +x deploy-prod.sh
+./deploy-prod.sh
+```
+
+**Windows:**
+```cmd
+deploy-prod.bat
+```
+
+## 📊 Мониторинг
+
+### Grafana
+
+Откройте: `http://your-server:3000`
+
+**Логин по умолчанию:**
+- Username: `admin`
+- Password: (из .env.prod `GRAFANA_PASSWORD`)
+
+**Готовые дашборды:**
+- Docker Containers
+- Host Metrics
+- Bot Statistics
+
+### Prometheus
+
+Откройте: `http://your-server:9090`
+
+**Полезные запросы:**
+```promql
+# CPU использование бота
+rate(container_cpu_usage_seconds_total{name="buh_bot_prod"}[5m])
+
+# Память бота
+container_memory_usage_bytes{name="buh_bot_prod"} / 1024 / 1024
+
+# Uptime
+time() - container_start_time_seconds{name="buh_bot_prod"}
+```
+
+### cAdvisor
+
+Откройте: `http://your-server:8080`
+
+Подробная информация о контейнерах в реальном времени.
+
+## 🔧 Управление
+
+### Логи
+
+```bash
+# Все сервисы
+docker-compose -f docker-compose.prod.yml logs -f
+
+# Только бот
+docker-compose -f docker-compose.prod.yml logs -f buh_bot
+
+# Последние 100 строк
+docker-compose -f docker-compose.prod.yml logs --tail=100 buh_bot
+```
+
+### Статус
+
+```bash
+# Статус контейнеров
+docker-compose -f docker-compose.prod.yml ps
+
+# Healthcheck
+docker inspect --format='{{.State.Health.Status}}' buh_bot_prod
+
+# Использование ресурсов
+docker stats buh_bot_prod
+```
+
+### Перезапуск
+
+```bash
+# Перезапуск бота
+docker-compose -f docker-compose.prod.yml restart buh_bot
+
+# Перезапуск всех сервисов
+docker-compose -f docker-compose.prod.yml restart
+
+# Остановка
+docker-compose -f docker-compose.prod.yml down
+
+# Остановка + удаление volumes
+docker-compose -f docker-compose.prod.yml down -v
+```
+
+### Обновление
+
+```bash
+# Ручное обновление
+docker-compose -f docker-compose.prod.yml pull
+docker-compose -f docker-compose.prod.yml up -d
+
+# Автообновление (через Watchtower)
+# Настроено автоматически, проверка каждый час
+```
+
+## 💾 Backup
+
+### Автоматический backup
+
+Настройте cronjob:
+
+```bash
+# Редактирование crontab
+crontab -e
+
+# Добавьте (backup каждый день в 2:00)
+0 2 * * * /path/to/backup.sh
+```
+
+**backup.sh:**
+```bash
+#!/bin/bash
+BACKUP_DIR="/var/backups/buh_bot/$(date +%Y%m%d_%H%M%S)"
+mkdir -p "$BACKUP_DIR"
+cp -r /var/lib/buh_bot/data/* "$BACKUP_DIR/"
+find /var/backups/buh_bot/ -type d -mtime +30 -exec rm -rf {} +
+```
+
+### Ручной backup
+
+```bash
+# Создание backup
+tar -czf buh_bot_backup_$(date +%Y%m%d).tar.gz \
+  /var/lib/buh_bot/data \
+  /var/log/buh_bot
+
+# Восстановление
+tar -xzf buh_bot_backup_20250103.tar.gz -C /
+```
+
+## 🔒 Безопасность
+
+### 1. Firewall
+
+```bash
+# UFW (Ubuntu)
+sudo ufw allow 22/tcp    # SSH
+sudo ufw allow 80/tcp    # HTTP
+sudo ufw allow 443/tcp   # HTTPS
+sudo ufw enable
+
+# Закрыть порты мониторинга извне
+# (доступ только через SSH tunnel)
+```
+
+### 2. SSL/TLS
+
+Для webhook режима установите SSL:
+
+```bash
+# Certbot для Let's Encrypt
+sudo apt install certbot
+sudo certbot certonly --standalone -d your-domain.com
+
+# Скопируйте сертификаты
+sudo cp /etc/letsencrypt/live/your-domain.com/fullchain.pem nginx/ssl/
+sudo cp /etc/letsencrypt/live/your-domain.com/privkey.pem nginx/ssl/
+
+# Раскомментируйте SSL блок в nginx/nginx.conf
+```
+
+### 3. Secrets
+
+Не храните секреты в Git:
+
+```bash
+# Проверка
+git secrets --scan
+
+# Ротация токенов
+# Регулярно меняйте TELEGRAM_BOT_TOKEN в .env.prod
+```
+
+### 4. Updates
+
+```bash
+# Обновление системы
+sudo apt update && sudo apt upgrade -y
+
+# Обновление Docker
+sudo apt install docker-ce docker-ce-cli containerd.io
+```
+
+## 📈 Масштабирование
+
+### Docker Swarm
+
+```bash
+# Инициализация swarm
+docker swarm init
+
+# Деплой stack
+docker stack deploy -c docker-compose.prod.yml buh_bot
+
+# Масштабирование (если нужно несколько реплик)
+docker service scale buh_bot_buh_bot=3
+```
+
+### Kubernetes
+
+Для Kubernetes создайте манифесты на основе docker-compose.prod.yml:
+
+```bash
+# Конвертация в k8s манифесты
+kompose convert -f docker-compose.prod.yml
+```
+
+## 🆘 Troubleshooting
+
+### Бот не запускается
+
+```bash
+# Проверить логи
+docker-compose -f docker-compose.prod.yml logs buh_bot
+
+# Проверить конфигурацию
+docker-compose -f docker-compose.prod.yml config
+
+# Проверить переменные окружения
+docker exec buh_bot_prod env
+```
+
+### Ошибка "image not found"
+
+```bash
+# Проверить доступ к registry
+docker pull ghcr.io/your-username/buh_bot:latest
+
+# Авторизоваться заново
+docker logout ghcr.io
+docker login ghcr.io
+```
+
+### Высокое использование ресурсов
+
+```bash
+# Увеличить лимиты в docker-compose.prod.yml
+deploy:
+  resources:
+    limits:
+      cpus: '2.0'
+      memory: 2G
+```
+
+### Проблемы с volumes
+
+```bash
+# Проверить права
+ls -la /var/lib/buh_bot/data
+
+# Исправить права
+sudo chown -R 1000:1000 /var/lib/buh_bot/data
+```
+
+## 📞 Поддержка
+
+- 📖 [DOCKER_GUIDE.md](DOCKER_GUIDE.md) - Docker основы
+- 📖 [DOCKER_QUICKSTART.md](DOCKER_QUICKSTART.md) - Быстрый старт
+- 🐛 GitHub Issues - Сообщить о проблеме
+
+## ✅ Checklist
+
+Перед production деплоем:
+
+- [ ] Образ собран и опубликован в registry
+- [ ] `.env.prod` настроен (особенно `TELEGRAM_BOT_TOKEN`)
+- [ ] Grafana пароль изменён с дефолтного
+- [ ] Директории созданы на хосте
+- [ ] Firewall настроен
+- [ ] SSL сертификаты установлены (если нужен webhook)
+- [ ] Backup настроен
+- [ ] Мониторинг проверен
+- [ ] Healthcheck работает
+- [ ] Логи ротируются
+- [ ] Документация обновлена
+
+---
+
+**Production готов!** 🚀