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:**
```css
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
```bash
# 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
```bash
# 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
```bash
# 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
```bash
# 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é:

```css
: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):**
```css
--primary: linear-gradient(135deg, #667eea 0%, #00d4ff 100%);
```

**Zelená (Nature):**
```css
--primary: linear-gradient(135deg, #11998e 0%, #38ef7d 100%);
```

**Oranžová (Sunset):**
```css
--primary: linear-gradient(135deg, #f093fb 0%, #f5576c 100%);
```

## 🐛 Časté Problémy

### Problém: "Nelze se přihlásit"
**Řešení:**
```bash
# 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í:**
```bash
# 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ů:
```python
# 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:
```bash
# 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! 🚀**