367 lines
8.1 KiB
Markdown
367 lines
8.1 KiB
Markdown
# 📦 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)
|