mxnticek/UrNetwork-Stats-Dashboard-remade
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
UrNetwork-Stats-Dashboard-r.../FILE_INDEX.md
VlastikYoutubeKo 709f362194 Update to v2.1.1 - Clean Design
2025-11-21 22:39:41 +01:00

8.1 KiB
Raw Blame History

📦 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 - ⭐ 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 - 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 - Hlavní anglický README

  • Kompletní dokumentace projektu
  • Quick start guide
  • Webhook příklady
  • Troubleshooting

README_CZ.md - Český README

  • Úplná česká dokumentace
  • Rychlý start
  • Webhook návod

QUICKSTART.md - Rychlý start

  • Instalace za 5 minut
  • První spuštění
  • Základní konfigurace

WEBHOOK_GUIDE.md - Webhook návod

  • 10+ webhook příkladů
  • Discord, Slack, Telegram
  • Dostupné proměnné
  • Debugging tipy

DESIGN_COMPARISON.md - Design dokumentace

  • Srovnání v2.0 vs v2.1
  • Důvody změn
  • Customizace barev

CHART_INTERACTION.md - Graf interakce

  • Tooltip kdekoliv na grafu
  • Jak to funguje
  • Mobile optimalizace

FIXES_v2.1.md - Seznam oprav v2.1

  • Všechny opravy
  • Před/po srovnání
  • Technické detaily

UPGRADE_GUIDE.md - Upgrade průvodce

  • Migrace z v1.0
  • Upgrade z v2.0
  • Backup strategie

CHANGELOG.md - Historie změn

  • Všechny verze
  • Co je nového
  • Breaking changes

🛠️ Instalační Soubory

requirements.txt - Python závislosti

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 - Automatický instalační script

  • Kontrola závislostí
  • Instalace balíčků
  • Vytvoření složek
  • Backup existujících dat

.gitignore - Git ignore file

  • Python cache
  • Virtual environments
  • Database files
  • Environment variables

🔧 Utility Skripty

migrate.py - Migrace z v1.0

  • Automatický upgrade na v2.0
  • Zachování dat
  • Backup tvorba

fix_db_path.py - Fix databázové cesty

  • Oprava instance folder problémů
  • Pro starší instalace

🚀 Rychlá Instalace

Metoda 1: Automatická (Doporučeno)

# 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í

# 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)

# 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)

# 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)

# 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ý

# Změň v main.py poslední řádek:
app.run(host="0.0.0.0", port=8080, debug=False)

Chybí závislosti

pip3 install Flask Flask-SQLAlchemy Flask-APScheduler requests python-dateutil

Nemůžu se přihlásit

# 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í

# Spusť bez instalace systemd
python3 main.py

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

Vývoj

# 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

# 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)