UrNetwork-Stats-Dashboard-remade/FILE_INDEX.md

# 📦 UrNetwork Stats Dashboard v2.1.1 - Complete Package

## 📥 Download All Files

Toto je kompletní balík souborů pro UrNetwork Stats Dashboard v2.1.1.

---

## 📂 Hlavní Soubory

### 🐍 Aplikace

**[main_clean.py](computer:///mnt/user-data/outputs/main_clean.py)** - ⭐ **HLAVNÍ SOUBOR**
- Kompletní Flask aplikace
- Multi-account podpora
- Čistý Cloudflare design
- Všechny opravy v2.1.1
- **Přejmenuj na `main.py` při instalaci!**
- Velikost: ~88 KB

**[main_enhanced.py](computer:///mnt/user-data/outputs/main_enhanced.py)** - Alternativa s gradienty
- Verze s fialovým gradientem a glassmorphismem
- Pro ty, kdo preferují původní v2.0 design
- Velikost: ~86 KB

---

### 📖 Dokumentace

**[README.md](computer:///mnt/user-data/outputs/README.md)** - Hlavní anglický README
- Kompletní dokumentace projektu
- Quick start guide
- Webhook příklady
- Troubleshooting

**[README_CZ.md](computer:///mnt/user-data/outputs/README_CZ.md)** - Český README
- Úplná česká dokumentace
- Rychlý start
- Webhook návod

**[QUICKSTART.md](computer:///mnt/user-data/outputs/QUICKSTART.md)** - Rychlý start
- Instalace za 5 minut
- První spuštění
- Základní konfigurace

**[WEBHOOK_GUIDE.md](computer:///mnt/user-data/outputs/WEBHOOK_GUIDE.md)** - Webhook návod
- 10+ webhook příkladů
- Discord, Slack, Telegram
- Dostupné proměnné
- Debugging tipy

**[DESIGN_COMPARISON.md](computer:///mnt/user-data/outputs/DESIGN_COMPARISON.md)** - Design dokumentace
- Srovnání v2.0 vs v2.1
- Důvody změn
- Customizace barev

**[CHART_INTERACTION.md](computer:///mnt/user-data/outputs/CHART_INTERACTION.md)** - Graf interakce
- Tooltip kdekoliv na grafu
- Jak to funguje
- Mobile optimalizace

**[FIXES_v2.1.md](computer:///mnt/user-data/outputs/FIXES_v2.1.md)** - Seznam oprav v2.1
- Všechny opravy
- Před/po srovnání
- Technické detaily

**[UPGRADE_GUIDE.md](computer:///mnt/user-data/outputs/UPGRADE_GUIDE.md)** - Upgrade průvodce
- Migrace z v1.0
- Upgrade z v2.0
- Backup strategie

**[CHANGELOG.md](computer:///mnt/user-data/outputs/CHANGELOG.md)** - Historie změn
- Všechny verze
- Co je nového
- Breaking changes

---

### 🛠️ Instalační Soubory

**[requirements.txt](computer:///mnt/user-data/outputs/requirements.txt)** - Python závislosti
```txt
Flask==3.0.0
Flask-SQLAlchemy==3.1.1
Flask-APScheduler==1.13.1
requests==2.31.0
python-dateutil==2.8.2
gunicorn==21.2.0
```

**[install.sh](computer:///mnt/user-data/outputs/install.sh)** - Automatický instalační script
- Kontrola závislostí
- Instalace balíčků
- Vytvoření složek
- Backup existujících dat

**[.gitignore](computer:///mnt/user-data/outputs/.gitignore)** - Git ignore file
- Python cache
- Virtual environments
- Database files
- Environment variables

---

### 🔧 Utility Skripty

**[migrate.py](computer:///mnt/user-data/outputs/migrate.py)** - Migrace z v1.0
- Automatický upgrade na v2.0
- Zachování dat
- Backup tvorba

**[fix_db_path.py](computer:///mnt/user-data/outputs/fix_db_path.py)** - Fix databázové cesty
- Oprava instance folder problémů
- Pro starší instalace

---

## 🚀 Rychlá Instalace

### Metoda 1: Automatická (Doporučeno)

```bash
# 1. Stáhni všechny soubory do složky
cd urnetwork-stats

# 2. Přejmenuj main_clean.py na main.py
mv main_clean.py main.py

# 3. Spusť instalační script
chmod +x install.sh
./install.sh

# 4. Spusť aplikaci
python3 main.py
```

### Metoda 2: Manuální

```bash
# 1. Stáhni soubory
cd urnetwork-stats

# 2. Přejmenuj
mv main_clean.py main.py

# 3. Instaluj závislosti
pip3 install -r requirements.txt

# 4. Vytvoř složky
mkdir -p instance

# 5. Spusť
python3 main.py
```

### Metoda 3: S Gunicorn (Produkce)

```bash
# Po instalaci závislostí
gunicorn --bind 0.0.0.0:90 --workers 4 main:app
```

---

## 📋 Checklist Po Stažení

- [ ] Stáhnout všechny soubory
- [ ] Přejmenovat `main_clean.py` → `main.py`
- [ ] Spustit `install.sh` nebo manuální instalaci
- [ ] Otevřít `http://localhost:90`
- [ ] Nastavit admin heslo
- [ ] Přidat UrNetwork účty
- [ ] (Volitelné) Nastavit webhooky
- [ ] (Volitelné) Přidat do systemd

---

## 📊 Struktura Po Instalaci

```
urnetwork-stats/
├── main.py                   # Hlavní aplikace (z main_clean.py)
├── main_enhanced.py          # Alternativa (volitelné)
├── requirements.txt          # Závislosti
├── install.sh               # Instalační script
├── migrate.py               # Migrace script
├── .gitignore               # Git ignore
├── .env                     # Config (vytvoří se automaticky)
├── instance/
│   └── transfer_stats.db    # Databáze (vytvoří se automaticky)
└── docs/
    ├── README.md
    ├── README_CZ.md
    ├── QUICKSTART.md
    ├── WEBHOOK_GUIDE.md
    ├── DESIGN_COMPARISON.md
    ├── CHART_INTERACTION.md
    ├── FIXES_v2.1.md
    ├── UPGRADE_GUIDE.md
    └── CHANGELOG.md
```

---

## 🎯 Co Potřebuješ Minimálně

Pro základní funkčnost:

1. **Povinné:**
   - `main_clean.py` (přejmenuj na `main.py`)
   - `requirements.txt`

2. **Doporučené:**
   - `README.md` nebo `QUICKSTART.md`
   - `install.sh` (usnadní instalaci)

3. **Volitelné:**
   - Všechny ostatní `.md` soubory (dokumentace)
   - `main_enhanced.py` (alternativní design)
   - `migrate.py` (jen pokud upgraduješ z v1.0)

---

## 🔄 Upgrade z Předchozí Verze

### Z v1.0 (Single Account)

```bash
# 1. Záloha
cp .env .env.backup
cp instance/transfer_stats.db instance/transfer_stats.db.backup

# 2. Stáhnout nové soubory
# (všechny soubory z tohoto balíku)

# 3. Přejmenovat
mv main_clean.py main.py

# 4. Spustit migraci
python3 migrate.py

# 5. Restart
python3 main.py
```

### Z v2.0 (Gradient Design)

```bash
# Jednoduše nahraď main.py
cp main.py main.py.v2.0.backup
mv main_clean.py main.py
python3 main.py
```

---

## 📖 První Kroky Po Instalaci

1. **Otevři prohlížeč:** `http://localhost:90`
2. **Nastav admin heslo:** (NENÍ to tvé UrNetwork heslo!)
3. **Přidej účty:**
   - Menu → Správa Účtů
   - Přidat Účet
   - Zadej UrNetwork email, heslo, přezdívku
4. **Nastav webhooky (volitelné):**
   - Menu → Nastavení
   - Webhook Management
   - Přidej Discord/Slack/Telegram URL + payload
5. **Hotovo!** Dashboard začne sbírat data každých 15 minut

---

## 🐛 Časté Problémy

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

### Chybí závislosti
```bash
pip3 install Flask Flask-SQLAlchemy Flask-APScheduler requests python-dateutil
```

### Nemůžu se přihlásit
```bash
# Zkontroluj .env
cat .env | grep ADMIN_PASSWORD
# Pokud chybí:
echo "ADMIN_PASSWORD=tvoje_heslo" >> .env
```

### Grafy neukazují text
- Ujisti se, že používáš `main_clean.py` (ne `main_enhanced.py`)
- Verze musí být v2.1+

---

## 💡 Pro Tipy

### Rychlé Testování
```bash
# Spusť bez instalace systemd
python3 main.py

# V produkci použij Gunicorn
gunicorn --bind 0.0.0.0:90 main:app
```

### Vývoj
```bash
# Debug mode
python3 main.py  # Debug je defaultně vypnutý

# Pro development změň v main.py:
app.run(host="0.0.0.0", port=90, debug=True)
```

### Backup
```bash
# Před každým upgradem
cp .env .env.backup
cp instance/transfer_stats.db instance/transfer_stats.db.backup
```

---

## 📞 Podpora

- **Issues:** Forgejo Issues
- **Dokumentace:** Všechny `.md` soubory v balíku
- **Discord:** (pokud máš komunitní server)

---

## ✅ Závěrečný Checklist

Před nahráním na server/repo zkontroluj:

- [ ] Všechny soubory staženy
- [ ] `main_clean.py` přejmenován na `main.py`
- [ ] `requirements.txt` přítomen
- [ ] `README.md` přítomen
- [ ] `install.sh` má +x práva
- [ ] `.gitignore` přítomen
- [ ] Dokumentace v `docs/` (volitelné)

---

## 🎉 Hotovo!

Máš kompletní balík souborů pro UrNetwork Stats Dashboard v2.1.1!

**Co dělat dál:**
1. Stáhni všechny soubory
2. Nahraj na server/do repozitáře
3. Spusť instalaci
4. Užij si!

**Made with ❤️ and 🤖 AI**

---

**Verze:** v2.1.1  
**Datum:** 21. listopadu 2024  
**Autor:** Vlastík (mxnticek) + Claude (Anthropic)