Prérequis

Avant de commencer, assurez-vous d’avoir installé les éléments suivants sur votre système :

  • Docker Engine (20.10.0 ou supérieur)
  • Docker Compose (v2.0.0 ou supérieur)
  • OpenSSL (pour générer des certificats SSL)

Installation de Docker

Pour macOS :

  1. Téléchargez et installez Docker Desktop depuis Docker Hub
  2. Suivez l’assistant d’installation
  3. Vérifiez l’installation :
docker --version
docker-compose --version

Pour Linux (Ubuntu/Debian) :

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Vérifiez l’installation :

docker --version
docker-compose --version

Pour Windows :

  1. Téléchargez et installez Docker Desktop depuis Docker Hub
  2. Suivez l’assistant d’installation
  3. Vérifiez l’installation :
docker --version
docker-compose --version

Déploiement Local

Étape 1 : Cloner le Dépôt

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

Étape 2 : Configuration de l’Environnement

Créez un fichier .env dans le répertoire racine :

cp .env.example .env

Modifiez le fichier .env pour configurer vos variables d’environnement :

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

Étape 3 : Démarrer les Services

docker-compose up -d

Cette commande démarrera tous les services nécessaires :

  • API Backend (Node.js)
  • Frontend (React)
  • Base de Données (PostgreSQL)
  • Redis (pour le cache et les files d’attente)

Étape 4 : Vérifier le Déploiement

Vérifiez que tous les conteneurs fonctionnent :

docker-compose ps

Vous devriez voir tous les services avec le statut “Up”.

Étape 5 : Accéder à l’Application

Identifiants de Connexion par Défaut

Après avoir déployé CaseBender, vous pouvez vous connecter avec les identifiants par défaut suivants :

Nom d'utilisateur : admin@casebender.app
Mot de passe : secret1234

Pour des raisons de sécurité, nous vous recommandons vivement de modifier ces identifiants par défaut immédiatement après votre première connexion.

Configuration Initiale

Créer un Compte Administrateur

docker-compose exec api npm run create-admin

Suivez les instructions pour créer un compte administrateur.

Importer des Données d’Exemple (Optionnel)

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

Résolution des Problèmes

Vérifier les Journaux

Si vous rencontrez des problèmes, vérifiez les journaux des conteneurs :

docker-compose logs -f api
docker-compose logs -f frontend
docker-compose logs -f postgres

Problèmes Courants

Erreur de Connexion à la Base de Données

Assurez-vous que les identifiants de la base de données dans le fichier .env sont corrects et que le conteneur PostgreSQL fonctionne :

docker-compose ps postgres

Problèmes de Permissions

Si vous rencontrez des problèmes de permissions lors de l’accès aux volumes Docker :

sudo chown -R $(whoami):$(whoami) ./data

Prochaines Étapes

Maintenant que vous avez CaseBender fonctionnant localement, vous pouvez :

  1. Configurer des Intégrations
  2. Personnaliser les Flux de Travail
  3. Explorer la Gestion des Alertes
  4. Apprendre sur la Gestion des Dossiers