UrNetwork-Stats-Dashboard-remade/QUICKSTART.md

# 🚀 UrNetwork Stats Dashboard v2.0 - QUICK START

## 📦 Balíček obsahuje:

```
urnetwork-stats-v2/
├── main_enhanced.py          # Hlavní aplikace (přejmenovat na main.py)
├── migrate.py                # Migrační skript pro upgrade
├── install.sh                # Instalační skript pro nové instalace
├── README_CZ.md              # Kompletní dokumentace
├── UPGRADE_GUIDE.md          # Průvodce upgradem
└── QUICKSTART.md             # Tento soubor
```

## ⚡ Pro NOVOU instalaci (prázdná složka)

```bash
# 1. Nahrajte všechny soubory do složky
cd ~/urnetwork-stats

# 2. Přejmenujte hlavní soubor
mv main_enhanced.py main.py

# 3. Spusťte instalační skript
bash install.sh

# 4. Spusťte aplikaci
python3 main.py

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

## 🔄 Pro UPGRADE existující instalace

```bash
# 1. Zazálohujte současnou složku
cd ~
cp -r urio urio_backup

# 2. Nahrajte POUZE tyto soubory do existující složky:
#    - main_enhanced.py → přejmenovat na main.py
#    - migrate.py

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

# 4. Spusťte migraci
cd ~/urio
python3 migrate.py

# 5. Spusťte novou verzi
python3 main.py

# 6. Přihlaste se novým admin heslem
http://your-server:90
```

## 🎯 První kroky po instalaci

### 1. Nastavení Admin Hesla
- Při první návštěvě nastavíte admin heslo
- **DŮLEŽITÉ:** Toto není vaše UrNetwork heslo!
- Toto heslo používáte pro přihlášení do dashboardu

### 2. Přidání UrNetwork Účtů
```
Dashboard → Správa účtů → Přidat účet

Vyplňte:
  ✓ UrNetwork email (vlastik.novotny2005@gmail.com)
  ✓ UrNetwork heslo
  ✓ Přezdívka (např. "Domácí účet")
```

### 3. Zobrazení Dat
- **Veřejný pohled**: Kombinované statistiky všech účtů
- **Privátní dashboard**: Detailní grafy a správa
- **Správa účtů**: Přidávání/odebírání účtů

## 🆘 Rychlá pomoc

### Nemohu se přihlásit
```bash
# Zkontrolujte .env soubor
cat .env | grep ADMIN_PASSWORD

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

### Aplikace neběží
```bash
# Zkontrolujte logy
tail -f nohup.out

# Nebo spusťte v popředí pro debugging
python3 main.py
```

### Port 90 je obsazený
```python
# V main.py změňte poslední řádek:
app.run(host="0.0.0.0", port=8080, debug=False)
#                              ^^^^
#                              Změňte číslo portu
```

### Upgrade selhal
```bash
# Obnovte zálohu
cd ~
rm -rf urio
mv urio_backup urio
cd urio
python3 main.py
```

## 📚 Detailní dokumentace

- **README_CZ.md** - Kompletní feature list a použití
- **UPGRADE_GUIDE.md** - Detailní průvodce upgradem
- **GitHub Issues** - Pro reportování problémů

## 🎨 Screenshots

### Veřejný Dashboard
```
┌─────────────────────────────────────────┐
│ Celkem placených dat    │ 45.234 GB     │
│ Celkem neplacených dat  │ 12.456 GB     │
│ Aktivní účty            │ 3             │
│ Výdělky (30 dní)        │ $125.67       │
└─────────────────────────────────────────┘

Graf: Kombinovaná data ze všech účtů
Graf: Domácí účet
Graf: Pracovní účet
Graf: Server účet

Mapa: Lokace poskytovatelů
```

### Správa Účtů
```
┌──────────────────────────────────────────────┐
│ Přezdívka      │ Username         │ Stav    │
├──────────────────────────────────────────────┤
│ [Domácí účet]  │ vlastik@...      │ Aktivní │
│ [Pracovní]     │ work@...         │ Aktivní │
│ [Server]       │ server@...       │ Neaktivní│
└──────────────────────────────────────────────┘
```

## 🔥 Hlavní Nové Funkce

✅ **Multi-Account** - Sledujte více UrNetwork účtů
✅ **Glassmorphism Design** - Moderní UI s blur efekty
✅ **Kombinované Stats** - Agregovaná data všech účtů
✅ **Individuální Grafy** - Graf pro každý účet zvlášť
✅ **Barevné Odlišení** - Každý účet má svou barvu
✅ **Admin Heslo** - Oddělené od UrNetwork credentials
✅ **Toggle Účtů** - Zapínání/vypínání sledování
✅ **Přezdívky** - Pojmenujte si účty jak chcete

## 💡 Tipy

### Pro více než 3 účty
- Snižte frekvenci fetchování v kódu (z 15 na 30 minut)
- Používejte přezdívky pro lepší přehled

### Pro produkční nasazení
- Nastavte `FORCE_HTTPS=True` v .env
- Použijte Gunicorn místo development serveru
- Nastavte systemd service pro autostart

### Webhooky
```json
{
  "content": "📊 **${account}**\n💾 Data: ${total_gb} GB\n🕐 ${update_time}"
}
```

## 📞 Kontakt & Podpora

- Original project: techroy23/UrNetwork-Stats-Dashboard
- Enhanced by: Claude/Anthropic
- Issues & Questions: GitHub Issues

---

**Enjoy! 🎉**

Pro detaily viz README_CZ.md