Installazione

Prerequisiti

• Docker & Docker Compose v2.0+
• Git
• 4GB RAM minimo (8GB consigliati)
• 10GB spazio disco

Quick Start

1. Clone Repository

git clone https://github.com/auriti-web-design/prediction-odds.git
cd prediction-odds

2. Configura Environment

# Copia template
cp backend/.env.example backend/.env

# Modifica con le tue API keys
nano backend/.env

3. Avvia i Servizi

docker compose up -d

4. Verifica

# Health check
curl http://localhost:8000/health

# Logs
docker compose logs -f backend

Servizi e Porte

Servizio	Porta	URL
Frontend	3002	http://localhost:3002
Backend API	8000	http://localhost:8000
Swagger Docs	8000	http://localhost:8000/docs
PostgreSQL	5432	localhost:5432
Redis	6379	localhost:6379
pgAdmin	5050	http://localhost:5050

Comandi Docker Utili

# Avvia tutti i servizi
docker compose up -d

# Ferma tutti i servizi
docker compose down

# Rebuild dopo modifiche
docker compose up -d --build

# Logs in tempo reale
docker compose logs -f backend

# Accedi al container backend
docker compose exec backend bash

# Accedi a PostgreSQL
docker compose exec postgres psql -U postgres -d soccer_predictions

Migrazioni Database

# Applica migrazioni
docker compose exec backend alembic upgrade head

# Crea nuova migrazione
docker compose exec backend alembic revision --autogenerate -m "descrizione"

# Rollback
docker compose exec backend alembic downgrade -1

Troubleshooting

Container non parte

# Verifica logs
docker compose logs backend

# Ricostruisci immagine
docker compose build --no-cache backend
docker compose up -d

Database connection error

# Verifica che postgres sia healthy
docker compose ps

# Riavvia postgres
docker compose restart postgres

Port già in uso

# Trova processo sulla porta
lsof -i :8000

# Modifica porta in docker-compose.yml

Prossimo Passo

Configurazione - Configura API keys e preferenze