README

Lemontech Events

Lemontech Events es una aplicación de gestión de eventos construida con Ruby on Rails y Docker, utilizando PostgreSQL como base de datos. Esta aplicación permite a los usuarios registrarse y autenticarse para gestionar sus eventos.

Requisitos Previos

IMPORTANTE!: Asegúrate de tener instalados los siguientes programas en tu máquina para iniciar la configuración del proyecto:

• Docker
• Docker Compose

Para levantar la aplicación por primera vez

Sigue estos pasos para configurar y levantar la aplicación por primera vez:

1. Clonar el Repositorio

Clonado y acceso al proyecto

Clona el proyecto en tu local desde el terminal y accede en el folder del proyecto

git clone https://github.com/genesisgonza05/lemontech_events.git
cd lemontech_events

2. Incorporar las variables de entorno

Copiado de las variables de entorno

Para esto, primero crea el archivo .env en la raiz del proyecto:

touch .env

Luego copia y pega este listado de variables de entorno en el archivo .env en la raiz del proyecto y guarda los cambios en el archivo.

El valor de estas variables se encuentran en el archivo de documentacion del proyecto "Documentación de LemontechEvents", solicitar este documento a un code owner.

RECAPTCHA_SITE_KEY=_request_var_to_any_code_owner_
RECAPTCHA_SECRET_KEY=_request_var_to_any_code_owner_

3. Construir Contenedores de Docker

Construcción y levantado de contenedores

Construye y levanta los contenedores de Docker por medio del siguiente comando:

docker-compose up -d

4. Disponibilizar la Base de Datos

Creación de la base de datos y set de datos iniciales

Crea la base de datos, realiza la migración y ejecuta el seed para inicializarla con datos con los siguientes 3 comandos respectivamente:

docker-compose run web rake db:create
docker-compose run web rake db:migrate
docker-compose run web rake db:seed

5. Levantar la aplicación

Despliegue de la aplicación

Una vez realizados los 4 pasos anteriores, puedes levantar la aplicación con el siguiente comando:

docker-compose up

Ya puedes ver el proyecto en tu local accediendo a la url que se genero desde la consola: http://localhost:3000/

La aplicación cuenta con un usuario precargado con datos base para pruebas: (Email: [email protected] | Password: 123456)

Levantar la aplicación frecuentemente

Una vez que has hecho la configuración inicial, puedes levantar la aplicación frecuentemente con:

docker-compose up

Para detener los contenedores:

docker-compose down

Ejecutar Pruebas

Para ejecutar las pruebas de Rspec (Unitarias):

docker-compose run test rspec

Para ejecutar las pruebas de Cucumber (de Integración):

docker-compose run test cucumber

Mailing

El proyecto cuenta con revision de emails con letter_opener_web en el ambiente de desarrollo, si deseas ver los emails enviados en tu entorno de desarrollo tan solo entra al siguiente enlace: http://localhost:3000/letter_opener