Requisitos Previos

Antes de comenzar, asegúrese de tener instalado lo siguiente en su sistema:

  • Docker Engine (20.10.0 o superior)
  • Docker Compose (v2.0.0 o superior)
  • OpenSSL (para generar certificados SSL)

Instalación de Docker

Para macOS:

  1. Descargue e instale Docker Desktop desde Docker Hub
  2. Siga el asistente de instalación
  3. Verifique la instalación:
docker --version
docker-compose --version

Para Linux (Ubuntu/Debian):

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

Verifique la instalación:

docker --version
docker-compose --version

Para Windows:

  1. Descargue e instale Docker Desktop desde Docker Hub
  2. Siga el asistente de instalación
  3. Verifique la instalación:
docker --version
docker-compose --version

Despliegue Local

Paso 1: Clonar el Repositorio

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

Paso 2: Configuración del Entorno

Cree un archivo .env en el directorio raíz:

cp .env.example .env

Edite el archivo .env para configurar sus variables de entorno:

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

Paso 3: Iniciar los Servicios

docker-compose up -d

Este comando iniciará todos los servicios necesarios:

  • API Backend (Node.js)
  • Frontend (React)
  • Base de Datos (PostgreSQL)
  • Redis (para caché y colas)

Paso 4: Verificar el Despliegue

Verifique que todos los contenedores estén funcionando:

docker-compose ps

Debería ver todos los servicios en estado “Up”.

Paso 5: Acceder a la Aplicación

Credenciales de Acceso Predeterminadas

Después de desplegar CaseBender, puede iniciar sesión con las siguientes credenciales predeterminadas:

Usuario: admin@casebender.app
Contraseña: secret1234

Por razones de seguridad, recomendamos cambiar estas credenciales predeterminadas inmediatamente después de su primer inicio de sesión.

Configuración Inicial

Crear una Cuenta de Administrador

docker-compose exec api npm run create-admin

Siga las instrucciones para crear una cuenta de administrador.

Importar Datos de Muestra (Opcional)

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

Solución de Problemas

Verificar Registros

Si encuentra problemas, verifique los registros de los contenedores:

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

Problemas Comunes

Error de Conexión a la Base de Datos

Asegúrese de que las credenciales de la base de datos en el archivo .env sean correctas y que el contenedor de PostgreSQL esté funcionando:

docker-compose ps postgres

Problemas de Permisos

Si encuentra problemas de permisos al acceder a los volúmenes de Docker:

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

Siguientes Pasos

Ahora que tiene CaseBender funcionando localmente, puede:

  1. Configurar Integraciones
  2. Personalizar Flujos de Trabajo
  3. Explorar la Gestión de Alertas
  4. Aprender sobre la Gestión de Casos