Prerequisiti

Prima di iniziare, assicurati di avere installato quanto segue sul tuo sistema:
  • Docker Engine (20.10.0 o superiore)
  • Docker Compose (v2.0.0 o superiore)
  • OpenSSL (per generare certificati SSL)

Installazione di Docker

Per macOS:

  1. Scarica e installa Docker Desktop da Docker Hub
  2. Segui la procedura guidata di installazione
  3. Verifica l’installazione:
docker --version
docker-compose --version

Per Linux (Ubuntu/Debian):

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
Verifica l’installazione:
docker --version
docker-compose --version

Per Windows:

  1. Scarica e installa Docker Desktop da Docker Hub
  2. Segui la procedura guidata di installazione
  3. Verifica l’installazione:
docker --version
docker-compose --version

Distribuzione Locale

Passo 1: Clonare il Repository

git clone https://github.com/casebender/casebender.git
cd casebender

Passo 2: Configurazione dell’Ambiente

Crea un file .env nella directory principale:
cp .env.example .env
Modifica il file .env per configurare le tue variabili d’ambiente:
DB_HOST=postgres
DB_PORT=5432
DB_NAME=casebender
DB_USER=postgres
DB_PASSWORD=your_secure_password

REDIS_HOST=redis
REDIS_PORT=6379

JWT_SECRET=your_jwt_secret_key

Passo 3: Avviare i Servizi

docker-compose up -d
Questo comando avvierà tutti i servizi necessari:
  • API Backend (Node.js)
  • Frontend (React)
  • Database (PostgreSQL)
  • Redis (per cache e code)

Passo 4: Verificare la Distribuzione

Verifica che tutti i container siano in esecuzione:
docker-compose ps
Dovresti vedere tutti i servizi con stato “Up”.

Passo 5: Accedere all’Applicazione

Credenziali di Accesso Predefinite

Dopo aver distribuito CaseBender, puoi accedere con le seguenti credenziali predefinite:
Nome utente: admin@casebender.app
Password: secret1234
Per motivi di sicurezza, si consiglia vivamente di modificare queste credenziali predefinite subito dopo il primo accesso.

Configurazione Iniziale

Creare un Account Amministratore

docker-compose exec api npm run create-admin
Segui le istruzioni per creare un account amministratore.

Importare Dati di Esempio (Opzionale)

docker-compose exec api npm run import-sample-data

Risoluzione dei Problemi

Verificare i Log

Se riscontri problemi, controlla i log dei container:
docker-compose logs -f api
docker-compose logs -f frontend
docker-compose logs -f postgres

Problemi Comuni

Errore di Connessione al Database

Assicurati che le credenziali del database nel file .env siano corrette e che il container PostgreSQL sia in esecuzione:
docker-compose ps postgres

Problemi di Permessi

Se riscontri problemi di permessi nell’accesso ai volumi Docker:
sudo chown -R $(whoami):$(whoami) ./data

Passi Successivi

Ora che hai CaseBender in esecuzione localmente, puoi:
  1. Configurare Integrazioni
  2. Personalizzare Flussi di Lavoro
  3. Esplorare la Gestione degli Avvisi
  4. Imparare sulla Gestione dei Casi