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)

# 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

# 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

# Zkontrolujte .env soubor
cat .env | grep ADMIN_PASSWORD

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

Aplikace neběží

# Zkontrolujte logy
tail -f nohup.out

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

Port 90 je obsazený

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

Upgrade selhal

# 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

{
  "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