UrNetwork-Stats-Dashboard-r.../README_CZ.md

173 lines
5.3 KiB
Markdown
Raw Normal View History

2025-11-21 22:39:41 +01:00
# UrNetwork Stats Dashboard - Vylepšená Multi-Account Verze v2.1
🇨🇿 **Český README** | [🇬🇧 English README](README.md)
---
## 🌟 Rychlé Odkazy
- 🚀 [Rychlý Start](QUICKSTART.md) - Spusť za 5 minut
- 📊 [Návod na Webhooky](WEBHOOK_GUIDE.md) - Discord, Slack, Telegram příklady
- 🎨 [Porovnání Designů](DESIGN_COMPARISON.md) - Proč tento design?
- 🔄 [Průvodce Upgradem](UPGRADE_GUIDE.md) - Migrace z v1.0
- 📝 [Changelog](CHANGELOG.md) - Historie verzí
---
## O Projektu
Toto je **výrazně vylepšená multi-account verze** původního [UrNetwork Stats Dashboard](https://github.com/techroy23/UrNetwork-Stats-Dashboard). Sleduj neomezený počet UrNetwork účtů s krásnými grafy, real-time aktualizacemi a webhook notifikacemi.
**Co je nového ve v2.1:**
- 🎯 **Multi-Account Podpora** - Sleduj neomezený počet UrNetwork účtů
- 🎨 **Čistý Design** - Cloudflare-inspirovaný tmavý vzhled
- 📊 **Lepší Grafy** - Bílý text, tooltip kdekoliv na grafu
- 🔐 **Oddělená Auth** - Admin heslo nezávislé na UrNetwork
-**Denní Čištění** - Auto-mazání dat starších 7 dní
- 📱 **Mobilní Optimalizace** - Touch-friendly rozhraní
> **Vylepšeno AI:** v2.0+ vytvořeno s Claude (Anthropic) pro lepší UX, multi-account podporu a moderní design.
---
## ✨ Klíčové Funkce
### 🎯 Multi-Account Správa
- ✅ Sleduj neomezený počet UrNetwork účtů současně
- ✅ Kombinované statistiky ze všech účtů
- ✅ Individuální grafy pro každý účet
- ✅ Vlastní přezdívky pro snadnou identifikaci
- ✅ Zapni/vypni účty bez smazání
- ✅ Barevně odlišené pro snadné rozpoznání
### 📊 Pokročilá Vizualizace
- ✅ Interaktivní Chart.js grafy s tooltipem **kdekoliv na grafu**
- ✅ Celková data, Placená vs Neplacená, Delta grafy
- ✅ Bílý čitelný text na všech grafech (konec mrákání!)
- ✅ Mapa světa ukazující lokace poskytovatelů
- ✅ Real-time aktualizace každou minutu
### ⚙️ Automatizace
- ✅ Sběr dat každých 15 minut
- ✅ Denní čištění (ponechává posledních 7 dní)
- ✅ Webhook notifikace (Discord, Slack, Telegram)
- ✅ Správa zařízení napříč všemi účty
### 🎨 Moderní UI
- ✅ Čistý Cloudflare-inspirovaný tmavý vzhled
- ✅ Bez gradientů (lepší viditelnost grafů)
- ✅ Modrá akcent barva (#3b82f6)
- ✅ Plně responzivní (mobil, tablet, desktop)
- ✅ Podpora češtiny a angličtiny
---
## 🚀 Rychlý Start
```bash
# 1. Klonovat repozitář
git clone https://forgejo.plainrock127.xyz/mxnticek/UrNetwork-Stats-Dashboard-remade
cd UrNetwork-Stats-Dashboard-remade
# 2. Instalovat závislosti
pip install Flask Flask-SQLAlchemy Flask-APScheduler requests python-dateutil
# 3. Spustit
python main.py
# 4. Otevřít prohlížeč
# http://localhost:90
```
**První Spuštění:**
1. Nastav své **admin heslo** (NENÍ to tvé UrNetwork heslo!)
2. Přidej své UrNetwork účty (email + heslo + přezdívka)
3. Hotovo! Dashboard začne sbírat data každých 15 minut
📖 **Potřebuješ více detailů?** Viz [QUICKSTART.md](QUICKSTART.md)
---
## 📊 Nastavení Webhooků - Rychlé Příklady
### Discord - Jednoduchý
```json
{
"content": "📊 **${account}**: ${total_gb} GB"
}
```
### Discord - Bohatý Embed (Doporučeno)
```json
{
"username": "UrNetwork Bot",
"embeds": [{
"title": "⚡ ${account} - Nová Data!",
"color": 3901635,
"fields": [
{"name": "💰 Placená", "value": "`${paid_gb} GB`", "inline": true},
{"name": "📡 Neplacená", "value": "`${unpaid_gb} GB`", "inline": true},
{"name": "💾 Celkem", "value": "**${total_gb} GB**", "inline": false}
],
"footer": {"text": "UrNetwork Stats"},
"timestamp": "${update_time}"
}]
}
```
### Telegram
```json
{
"chat_id": "TVOJE_CHAT_ID",
"text": "📊 *${account}*\n💾 Celkem: ${total_gb} GB\n💰 Placená: ${paid_gb} GB\n📡 Neplacená: ${unpaid_gb} GB",
"parse_mode": "Markdown"
}
```
**Dostupné Proměnné:**
- `${account}` - Přezdívka účtu
- `${paid_gb}` - Placená data v GB
- `${unpaid_gb}` - Neplacená data v GB
- `${total_gb}` - Celková data v GB
- `${update_time}` - Časová značka
📖 **Kompletní webhook návod:** [WEBHOOK_GUIDE.md](WEBHOOK_GUIDE.md)
---
## 🎨 Proč Tento Design?
Po rozsáhlém testování jsme zvolili **čistý Cloudflare-inspirovaný design** protože:
1. **Lepší Viditelnost Grafů** - Pevné tmavé pozadí = lepší kontrast
2. **Profesionální Vzhled** - Napodobuje enterprise dashboardy
3. **Bez Únav Očí** - Čisté barvy bez gradientů
4. **Výkon** - Žádné blur efekty = rychlejší rendering
5. **Přístupnost** - Vysoké kontrastní poměry
**Barevné Schéma:**
```css
Pozadí: #0c0d0e (Tmavá)
Primární: #3b82f6 (Modrá)
Text: #e5e7eb (Světlá)
Úspěch: #10b981 (Zelená)
Chyba: #ef4444 (Červená)
```
📖 **Detaily designu:** [DESIGN_COMPARISON.md](DESIGN_COMPARISON.md)
---
## 🙏 Poděkování
- **Originál:** [techroy23/UrNetwork-Stats-Dashboard](https://github.com/techroy23/UrNetwork-Stats-Dashboard)
- **v2.0+ Vylepšeno:** Claude (Anthropic AI)
- **Design Inspirace:** Cloudflare, Vercel
- **Speciální Díky:** Vlastík (mxnticek) za testování
---
**Verze:** v2.1.1 | **Poslední Aktualizace:** 21. listopadu 2024
**Vytvořeno s ❤️ a 🤖 AI**