UrNetwork-Stats-Dashboard-remade/UPGRADE_GUIDE.md

UrNetwork Stats Dashboard v2.0 - Upgrade Guide

🎯 Hlavní Vylepšení

1. Multi-Account Support ⭐ NOVÉ

Před:

• Sledování pouze jednoho UrNetwork účtu
• Nutnost manuálně měnit credentials v .env
• Žádná kombinovaná statistika

Po:

✓ Neomezený počet UrNetwork účtů
✓ Kombinovaná statistika ze všech účtů
✓ Individuální grafy pro každý účet
✓ Snadné přepínání mezi účty
✓ Přezdívky pro lepší orientaci
✓ Zapínání/vypínání sledování

2. Redesign UI 🎨 VYLEPŠENO

Design změny:

Před: Flat dark theme
Po:   Glassmorphism + Gradients

Barvy:
  Před: Modrá (#3b82f6)
  Po:   Fialová gradient (#667eea → #764ba2)

Efekty:
  ✓ Blur backdrop filters
  ✓ Smooth hover animations
  ✓ Shadow depth effects
  ✓ Gradient overlays
  ✓ Animated transitions

3. Lepší Bezpečnost 🔐 VYLEPŠENO

Před:

- Přihlášení pomocí UrNetwork credentials
- Hesla v .env otevřeně

Po:

✓ Oddělené admin heslo pro dashboard
✓ UrNetwork credentials bezpečně v databázi
✓ Session management
✓ HTTPS redirect podpora

4. Vylepšené Grafy 📊 ROZŠÍŘENO

Nové možnosti:

• Kombinovaný graf (všechny účty dohromady)
• Individuální grafy pro každý účet
• Barevné odlišení účtů
• Přepínání mezi pohledy
• Lepší legenda a tooltips

5. Správa Zařízení 📱 ROZŠÍŘENO

Před:

Device Name | Status | Client ID | Mode | Remove

Po:

Account | Device Name | Status | Client ID | Mode | Remove
   ↓
Označení které zařízení patří kterému účtu

📊 Srovnání Funkcí

Funkce	v1.0	v2.0
Počet účtů	1	Neomezeno
Design	Basic Dark	Glassmorphism
Grafy	Základní	Multi-account + Combined
Admin panel	UrNetwork login	Oddělené admin heslo
Webhooky	Základní	S account proměnnou
Správa účtů	Manuálně v .env	GUI správa
Toggle účtů	❌	✅
Přezdívky	❌	✅
Barevné odlišení	❌	✅
Kombinované stats	❌	✅

🚀 Upgrade Proces

Krok 1: Příprava

# 1. Zastavte běžící aplikaci
pkill -f main.py

# 2. Přejděte do složky aplikace
cd ~/urio

# 3. Stáhněte nové soubory
# (nebo je nahrajte manuálně)

Krok 2: Migrace

# Spusťte migrační skript
python3 migrate.py

Migrační skript automaticky:

1. ✓ Vytvoří zálohy (.env.backup, transfer_stats.db.backup)
2. ✓ Aktualizuje strukturu databáze
3. ✓ Přidá tabulku accounts
4. ✓ Migruje existující účet
5. ✓ Nastaví admin heslo
6. ✓ Ověří migraci

Krok 3: Test

# Spusťte novou verzi
python3 main.py

# Otevřete v prohlížeči
http://your-server:90

# Přihlaste se pomocím NOVÉHO admin hesla

Krok 4: Přidání účtů

1. Přihlaste se do dashboardu
2. Menu → Správa účtů
3. Klikněte "Přidat účet"
4. Vyplňte:
   - UrNetwork email
   - UrNetwork heslo
   - Přezdívku (např. "Domácí", "Práce")
5. Účet se automaticky ověří

🔄 Rollback (pokud něco nejde)

Obnovení zálohy

# Zastavte aplikaci
pkill -f main.py

# Obnovte zálohy
cp .env.backup .env
cp transfer_stats.db.backup transfer_stats.db
mv main.py.old main.py

# Spusťte starou verzi
python3 main.py

📱 Použití Multi-Account

Přidání druhého účtu

Příklad: Máte 2 UrNetwork účty

Účet 1 (Existující):
  Email: vlastik.novotny2005@gmail.com
  → Automaticky migrován
  → Přezdívka: "Hlavní účet"

Účet 2 (Nový):
  Email: druhy.ucet@gmail.com
  Heslo: ********
  → Přidán přes GUI
  → Přezdívka: "Pracovní účet"

Zobrazení kombinovaných dat

Veřejný dashboard:
  → Zobrazí součet dat obou účtů
  → Individual grafy pro každý účet
  → Celkové výdělky ze všech účtů

Privátní dashboard:
  → Toggle: "Kombinovaná statistika" / "Jednotlivé účty"
  → Filtr podle účtu v sekci Account & Leaderboard
  → Zařízení označená účtem

🎨 CSS Customizace

Změna barevného schématu

V main_enhanced.py, změňte CSS proměnné:

:root {
    /* Změňte tyto hodnoty pro vlastní barevné schéma */
    --primary: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    --success: #10b981;
    --danger: #ef4444;
}

Populární barevné schémata:

Modrá (Ocean):

--primary: linear-gradient(135deg, #667eea 0%, #00d4ff 100%);

Zelená (Nature):

--primary: linear-gradient(135deg, #11998e 0%, #38ef7d 100%);

Oranžová (Sunset):

--primary: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);

🐛 Časté Problémy

Problém: "Nelze se přihlásit"

Řešení:

# Zkontrolujte ADMIN_PASSWORD v .env
cat .env | grep ADMIN_PASSWORD

# Pokud chybí, přidejte ho
echo "ADMIN_PASSWORD=your_password" >> .env

Problém: "Účet se nepřidává"

Řešení:

1. Zkontrolujte UrNetwork credentials
2. Zkuste se přihlásit na bringyour.com
3. Zkontrolujte logy: tail -f nohup.out

Problém: "Chybí data po migraci"

Řešení:

# Ověřte account_id ve stats tabulce
sqlite3 transfer_stats.db "SELECT COUNT(*) FROM stats WHERE account_id IS NULL;"

# Pokud je > 0, přiřaďte manuálně
sqlite3 transfer_stats.db "UPDATE stats SET account_id = 1 WHERE account_id IS NULL;"

Problém: "Webhook nefunguje"

Řešení:

Starý formát:
  {"content": "Data: ${total_gb} GB"}

Nový formát:
  {"content": "Account: ${account}, Data: ${total_gb} GB"}
                         ^^^^^^^^^^^
                         Nová proměnná

📈 Performance Tips

Pro více než 5 účtů:

# V main_enhanced.py, upravte job interval
@scheduler.task(id="log_stats_job", trigger="cron", minute="0,30")
# místo: minute="0,15,30,45"
# Tím snížíte frekvenci API callů

Pro lepší responzivitu:

# Použijte Gunicorn místo development serveru
pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:90 main_enhanced:app

🎯 Co Dělat Dál

1. Přidejte další účty

   • Menu → Správa účtů → Přidat účet

2. Nastavte webhooky

   • Menu → Nastavení → Webhook Management
   • Použijte ${account} pro rozlišení účtů

3. Customizujte design

   • Změňte CSS proměnné podle svých preferencí

4. Monitoring

   • Zkontrolujte logy pravidelně
   • Nastavte alerting přes webhooky

📞 Podpora

• GitHub Issues: Pro bug reporty a feature requesty
• Documentation: README_CZ.md pro detailní dokumentaci
• Migration Help: migrate.py --help pro nápovědu

---

Enjoy your new multi-account dashboard! 🚀