Guida Rapida

​

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

• Interfaccia Utente: http://localhost:3000
• API: http://localhost:8000
• Documentazione API: http://localhost:8000/api-docs

​

Credenziali di Accesso Predefinite

Dopo aver distribuito CaseBender, puoi accedere con le seguenti credenziali predefinite:

Nome utente: admin@casebender.app
Password: secret1234

​

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