ROMFASTSQL/proxmox/vm201-windows/docs/vm201-btgo-playwright-service.md

VM 201 — btgo-playwright (Scraper Banca Transilvania George)

Obiectiv

Scraper automat pentru go.bancatransilvania.ro (Banca Transilvania): extrage solduri conturi și descarcă CSV-uri de tranzacții. Rulează ca Windows Service pe VM 201, cu notificări Telegram.

Repo: git@gitea.romfast.ro:romfast/btgo-playwright.git

---

Stack Tehnic

Componentă	Detaliu
Limbaj	Python (venv dedicat)
Browser automation	playwright==1.48.0 (Python SDK)
Mod	API Python direct: from playwright.sync_api import sync_playwright
Notificări	Telegram Bot API
Deploy	Windows Service (PowerShell wrappers)
Headless	HEADLESS=false obligatoriu

De ce Playwright Python SDK (și nu MCP / CLI)

Trei variante de a folosi Playwright; aici se folosește a treia:

1. Playwright MCP plugin — pentru Claude Code (agent control). NU se aplică.
2. Playwright CLI — pentru proiecte Node.js. NU se aplică.
3. Playwright Python SDK — dependință Python instalată în venv, folosită programatic din script. ✅ Folosită aici.

Concluzie: setup-ul actual e corect pentru acest use case. Funcționează independent de Claude.

---

Constrângere Critică: HEADLESS=false

WAF-ul Banca Transilvania detectează și blochează:

• Rularea în Docker
• Rularea headless

De aceea:

• Serviciul rulează direct pe VM 201 (Windows GUI prezent)
• Browser-ul Chromium pornește vizibil (headless=False)
• VM 201 trebuie să rămână pornit cu sesiune Windows activă

Orice migrare către container Linux / headless rupe scraper-ul la primul login.

---

Flow Aplicație

login()                  → autentificare cu user/parolă
   ↓
handle_2fa_wait()        → așteaptă confirmare 2FA (notificare Telegram)
   ↓
read_accounts()          → parsează lista de conturi + solduri
   ↓
download_transactions()  → descarcă CSV per cont
   ↓
save_results()           → persistă date + notificare Telegram (succes/eroare)

---

Deploy ca Windows Service

Serviciul este înregistrat ca Windows Service prin scripturi PowerShell din repo. Lansează python.exe din venv-ul proiectului asupra entry-point-ului scraper-ului.

Verificare rapidă pe VM 201:

# Status serviciu
Get-Service -Name "btgo-playwright*"

# Restart
Restart-Service -Name "btgo-playwright"

# Loguri
Get-EventLog -LogName Application -Source "btgo-playwright" -Newest 20

(Numele exact al serviciului și calea instalării sunt în README-ul repo-ului btgo-playwright.)

---

Dependențe Operaționale

• VM 201 pornit + sesiune Windows activă (necesar pentru HEADLESS=false)
• Acces internet către go.bancatransilvania.ro
• Acces internet către api.telegram.org
• Chromium instalat de Playwright (playwright install chromium în venv)

---

Troubleshooting

Login eșuează / WAF block

1. Verifică că serviciul rulează cu sesiune Windows activă (NU doar RDP deconectat — sesiunea trebuie să persiste). Vezi mai jos.
2. Confirmă HEADLESS=false în config / variabile mediu.
3. Verifică că nu rulează în paralel altă instanță Chromium pe profilul Playwright (lock pe user data dir).

2FA nu primește notificare

Verifică tokenul Telegram și chat_id din config. Test rapid:

curl "https://api.telegram.org/bot$TOKEN/getMe"

Sesiune Windows se închide după RDP disconnect

Pentru ca browser-ul GUI să rămână activ după RDP disconnect, sesiunea trebuie păstrată. Variante:

• tscon din alt RDP pentru a transfera sesiunea pe consola fizică
• Configurare auto-logon + serviciul lansat în sesiunea consolă

---

Referințe

• Repo: http://gitea:3000/romfast/btgo-playwright
• Playwright Python docs: https://playwright.dev/python/
• README VM 201: ../README.md

---

Ultima actualizare: 2026-04-25 Autor: Marius Mutu