ShadowPath

ShadowPath je prohlížečová hra inspirovaná DnD a hodem kostkou, která kombinuje prvky incremental game s automatizací. Hráč se vydává na temnou cestu plnou nebezpečí, kde musí strategicky volit své akce a zdokonalovat své schopnosti.

🚀 Technologie

• Backend: Go (Golang)
• Frontend: Vue.js 3 + Vite
• Databáze: MariaDB
• Kontejnerizace: Docker + Docker Compose
• Vývojové nástroje: Air (hot-reload pro backend), Node.js + npm (frontend), PhpMyAdmin (pro správu databáze)

🔧 Požadavky

Než začnete, ujistěte se, že máte nainstalováno:

• Docker
• Docker Compose
• Make (volitelné, ale doporučené)

🛠️ Instalace a spuštění projektu

1️⃣ Naklonujte repozitář

git clone https://github.com/tvoje_repo/shadowpath.git
cd shadowpath

2️⃣ Vytvoř .env soubor podle .env.example a uprav porty podle potřeby

cp .env.example .env

3️⃣ Postavte Docker image a spusťte projekt

make build  # Zbuildí backend a frontend
make up     # Spustí všechny služby

4️⃣ Otevřete hru ve svém prohlížeči

http://localhost:5173  # Frontend
http://localhost:9090  # Backend API
http://localhost:8080  # PhpMyAdmin (login: root / password)

🔄 Vývoj a hot-reload

Backend (Golang + Air)

Backend podporuje hot-reload pomocí Air. Pokud chcete sledovat změny v kódu v reálném čase:

make logs  # Sleduje logy backendu
make sh-backend  # Připojí se do backend kontejneru

Každá změna v main.go a dalších souborech spustí automatickou rekompilaci.

Frontend (Vue.js + Vite)

Frontend také podporuje hot-reload:

make sh-frontend  # Připojí se do frontend kontejneru

Veškeré změny v src/ se projeví okamžitě v prohlížeči.

💾 Správa databáze

Projekt používá MariaDB, ke které se lze připojit pomocí PhpMyAdmin:

• URL: http://localhost:8080
• Uživatel: root
• Heslo: password

Pokud chcete nahrát základní strukturu databáze:

docker-compose exec mariadb mysql -u root -p < database/schema.sql

💡 Jak přispívat

Pokud chcete přispět do projektu:

1. Forkněte si repozitář
2. Vytvořte feature branch (git checkout -b feature/nova-funkce)
3. Udělejte změny a commitujte (git commit -m 'Přidání nové funkce')
4. Pošlete pull request

📜 Licence

Tento projekt je open-source a licencován pod MIT licencí.