From 53dd982e38de170f79e2cbcceaa901da985883b1 Mon Sep 17 00:00:00 2001
From: "Andrew K. Choi" <a.choi@smartsoltech.kr>
Date: Mon, 17 Nov 2025 15:14:59 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=B0=20=D1=88=D0=BF=D0=B0=D1=80=D0=B3=D0=B0=D0=BB?=
 =?UTF-8?q?=D0=BA=D0=B0=20=D0=BF=D0=BE=20=D0=B1=D1=8B=D1=81=D1=82=D1=80?=
 =?UTF-8?q?=D0=BE=D0=BC=D1=83=20=D0=B4=D0=B5=D0=BF=D0=BB=D0=BE=D1=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 DEPLOY_QUICKSTART.md | 100 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)
 create mode 100644 DEPLOY_QUICKSTART.md

diff --git a/DEPLOY_QUICKSTART.md b/DEPLOY_QUICKSTART.md
new file mode 100644
index 0000000..4a61b02
--- /dev/null
+++ b/DEPLOY_QUICKSTART.md
@@ -0,0 +1,100 @@
+# 🚀 Быстрый деплой бота с внешним PostgreSQL
+
+## Шаг 1: Подготовка PostgreSQL
+
+```bash
+# Подключитесь к PostgreSQL
+psql -U postgres
+
+# Создайте пользователя и БД
+CREATE USER bot_user WITH PASSWORD 'secure_password_here';
+CREATE DATABASE lottery_bot OWNER bot_user;
+GRANT ALL PRIVILEGES ON DATABASE lottery_bot TO bot_user;
+
+# Выход
+\q
+```
+
+## Шаг 2: Настройка .env.prod
+
+```bash
+# Скопируйте пример
+cp .env.prod.example .env.prod
+
+# Отредактируйте .env.prod
+nano .env.prod
+```
+
+**Заполните:**
+```env
+# Telegram
+BOT_TOKEN=your_bot_token_from_botfather
+ADMIN_IDS=123456789,987654321
+
+# PostgreSQL (замените на свои данные)
+DATABASE_URL=postgresql+asyncpg://bot_user:secure_password@localhost:5432/lottery_bot
+```
+
+## Шаг 3: Деплой
+
+### Вариант A: Docker (рекомендуется)
+
+```bash
+# Билд и запуск
+make docker-deploy
+
+# Или вручную:
+docker-compose build
+docker-compose up -d
+docker exec -it lottery_bot alembic upgrade head
+```
+
+### Вариант B: Локально
+
+```bash
+# Установка
+make install
+
+# Миграции
+source .venv/bin/activate
+alembic upgrade head
+
+# Запуск
+make bot-start
+```
+
+## Шаг 4: Проверка
+
+```bash
+# Проверить подключение к БД
+make docker-test-db
+
+# Логи
+make docker-logs
+
+# Статус
+make docker-status
+```
+
+## 📋 Полезные команды
+
+```bash
+# Остановка
+docker-compose down
+
+# Перезапуск
+docker-compose restart
+
+# Логи в реальном времени
+docker-compose logs -f bot
+
+# Бэкап БД
+pg_dump -U bot_user lottery_bot > backup.sql
+
+# Восстановление БД
+psql -U bot_user lottery_bot < backup.sql
+```
+
+## 🔥 Проблемы?
+
+См. [EXTERNAL_DB_SETUP.md](./EXTERNAL_DB_SETUP.md) раздел "Troubleshooting"