btgo-playwright/deployment/windows/QUICK_START.md

🚀 Quick Start - BTGO Telegram Bot pe VM Windows

Ghid rapid pentru deployment în 5 minute.

✅ Pre-requisites Checklist

• Windows Server/Desktop cu GUI (pentru browser vizibil)
• Python 3.11+ instalat în PATH
• Cont Administrator pe Windows
• Bot Telegram creat cu @BotFather
• Credențiale BTGO (LOGIN_ID + PAROLA)

---

📥 Pas 1: Clone Repository (pe VM)

cd E:\proiecte
git clone <repo-url> btgo-playwright
cd btgo-playwright

Sau copiază manualmente folderul pe VM.

---

⚙️ Pas 2: Configurare .env

REM Copiază template
copy .env.example .env

REM Editează cu Notepad
notepad .env

Configurare minimă necesară:

# TELEGRAM
TELEGRAM_BOT_TOKEN=123456:ABC-DEF...  # De la @BotFather
TELEGRAM_ALLOWED_USER_IDS=123456789   # Telegram User ID-ul tău

# BTGO
LOGIN_ID=your_btgo_username
PAROLA=your_btgo_password

# SCRAPER
HEADLESS=false  # ⚠️ CRITICAL: NU schimba în true!

Cum afli User ID-ul tău:

REM După ce ai setat TELEGRAM_BOT_TOKEN în .env
python get_telegram_chat_id.py
REM Trimite un mesaj bot-ului în Telegram
REM Script-ul va afișa User ID-ul

---

🚀 Pas 3: Deploy Automat

Right-click pe deploy.ps1 → "Run with PowerShell" (ca Administrator)

SAU din PowerShell Administrator:

cd deployment\windows\scripts
.\deploy.ps1

Scriptul va instala:

• ✅ Dependențe Python
• ✅ Playwright browsers
• ✅ Serviciu Windows
• ✅ Auto-start la boot

Durată: ~2-3 minute

---

✅ Pas 4: Verificare

1. Verifică serviciul rulează

sc query BTGOTelegramBot

Output așteptat:

STATE              : 4  RUNNING

2. Verifică logs

deployment\windows\scripts\view_logs.bat

Sau direct:

type logs\telegram_bot_stdout.log

Ar trebui să vezi:

[2025-11-06 10:15:23] [INFO] Bot inițializat. Useri autorizați: [123456789]
[2025-11-06 10:15:23] [INFO] Bot pornit. Așteaptă comenzi...

3. Testează în Telegram

1. Deschide Telegram
2. Caută bot-ul tău (numele setat la @BotFather)
3. Trimite /start

Răspuns așteptat:

🤖 BTGO Scraper Trigger Bot

Comenzi disponibile:
• /scrape - Rulează scraper-ul
• /status - Status sistem
• /help - Ajutor

4. Trimite /scrape pentru test complet

Flow 2FA:

• Bot răspunde: "🤖 BTGO Scraper pornit... Așteaptă 2FA pe telefon!"
• Primești notificare pe telefon în George App
• Aprobi 2FA
• Bot trimite fișierele (solduri + tranzacții CSV)

---

🎉 Gata!

Serviciul rulează acum non-stop pe VM. La reboot, pornește automat.

---

📋 Comenzi Utile Day-to-Day

Meniu Interactiv (Cel mai ușor!)

# Right-click → "Run with PowerShell" (ca Admin)
deployment\windows\scripts\menu.ps1

Comenzi Directe PowerShell

# Status rapid
.\status.ps1

# Restart serviciu (după modificări cod)
.\restart_service.ps1

# View logs live
.\view_logs.ps1

# Oprește serviciu
Stop-Service BTGOTelegramBot

# Pornește serviciu
Start-Service BTGOTelegramBot

# Restart serviciu
Restart-Service BTGOTelegramBot

---

🔄 Update Cod (după modificări)

# Pe VM
cd E:\proiecte\btgo-playwright
git pull

# Restart serviciu (PowerShell)
deployment\windows\scripts\restart_service.ps1

# SAU folosește meniul interactiv
deployment\windows\scripts\menu.ps1
# → Selectează opțiunea 6 (Restart)

---

🐛 Troubleshooting Rapid

Serviciul nu pornește

# Verifică logs
type logs\telegram_bot_stderr.log

Erori comune:

"ModuleNotFoundError":

python -m pip install -r requirements.txt
deployment\windows\scripts\restart_service.bat

"TELEGRAM_BOT_TOKEN nu este setat":

• Verifică .env există și conține token-ul
• Token-ul trebuie pe o singură linie, fără spații extra

"Access Denied" în browser:

• Verifică HEADLESS=false în .env
• Nu folosi Docker/headless mode

Bot nu răspunde în Telegram

1. Verifică serviciul:

   sc query BTGOTelegramBot
   

2. Testează manual:

   REM Oprește serviciul
   net stop BTGOTelegramBot
   
   REM Rulează manual pentru debug
   python telegram_trigger_bot.py
   
   REM Trimite /start în Telegram
   REM Vezi output-ul direct în terminal
   

3. Verifică firewall:

   • Bot-ul trebuie să acceseze api.telegram.org (port 443)

Scraper-ul timeout-ează la 2FA

În .env:

TIMEOUT_2FA_SECONDS=600  # Crește la 10 minute

Apoi restart:

deployment\windows\scripts\restart_service.bat

---

📞 Ajutor Suplimentar

• README complet: deployment\windows\README.md
• Setup Telegram: TELEGRAM_BOT_SETUP.md
• Documentație proiect: CLAUDE.md

---

Enjoy! 🎉