Configuración del entorno

Ejecutando el entorno por primera vez:

Para ejecutar el entorno correctamente, necesitas tener las siguientes herramientas:

• Docker
• Docker Compose

Instalación de Docker y Docker Compose

• Para instalar Docker, se recomienda seguir el tutorial oficial.
• También se recomienda seguir los [pasos posteriores a la instalación] (https://docs.docker.com/engine/install/linux-postinstall/).
• Después de completar los pasos anteriores, instala el complemento compose siguiendo el tutorial oficial.

Ejecutando los servicios

El entorno del proyecto depende de 4 contenedores especificados en el archivo docker-compose.yml:

1. decidim-service: Aplicación Decidim (Ruby on Rails);
2. decidim-db: Base de datos Postgres;
3. redis-cache: Servidor Redis para Cache;
4. redis-queue: Servidor Redis para Cola.

El proyecto está configurado para ejecutarse automáticamente a través de docker compose usando el comando:

docker compose up

Al ejecutar por primera vez, el sistema descargará las imágenes de los contenedores y configurará el proyecto automáticamente desde el archivo .env.dev.

Nota: Estos contenedores fueron configurados solo para un entorno de desarrollo y, por ahora, no deben ser utilizados en un entorno de producción.

Una vez que todos los servicios se hayan iniciado, la aplicación Decidim estará disponible en la dirección localhost:3000. Adicionalmente, hay un servicio mailcatcher que ayuda a capturar correos electrónicos para pruebas de validación de cuentas de usuario, disponible en localhost:1080.

Al finalizar la configuración del entorno, el script start.sh se ejecuta automáticamente, donde se crea y configura la base de datos Postgres (usando los comandos rake db:create y rake db:migrate). Finalmente, se ejecuta un seed que contiene la cuenta del administrador del sistema, cuyas credenciales están definidas en el archivo de entorno .env.dev como se muestra en el siguiente ejemplo:

ADMIN_EMAIL=admin@email.com
ADMIN_PASSWORD=admin

Accediendo a la aplicación

Después de acceder a la URL localhost:3000/system, aparecerá en la pantalla un área de inicio de sesión. Proporcione la contraseña y el correo electrónico utilizados para crear el usuario admin.

Completando el registro inicial de la organización

En el primer login, serás dirigido a una página para crear la primera organización dentro de la aplicación.

• En el campo Name, llena el nombre de la organización que deseas crear. Por ejemplo: Organización 1
• En el campo Reference prefix, llena el prefijo de identificación de la organización en minúsculas. Por ejemplo org1
• En el campo Host, llena el dominio que se utilizará en la URL de la organización. En este caso, llena localhost
• En el campo Secondary host no es necesario llenar nada.
• En el campo Organization admin name, llena el nombre del administrador de la organización. Por ejemplo: Decidim Admin
• En el campo Organization admin email, llena el correo electrónico que usará el administrador de la organización. Por ejemplo: admin@example.com
• En la sección Organization locales, selecciona los idiomas que estarán habilitados en la organización y el idioma predeterminado. Por ejemplo: enabled: English, Português, default: Português
• En el campo User registration mode, selecciona la opción allow participants to register and login
• En la sección available authorizations, selecciona todas las opciones.

Haz clic en Create organization & invite admin

Accediendo a la organización con admin

Después de completar el registro de la organización, abre mailcatcher en el navegador accediendo a la dirección http://127.0.0.1:1080. Haz clic en el correo enviado y, en el contenido del correo, haz clic en Accept invitation.

Cuando hagas clic en la confirmación del correo, se abrirá una página para finalizar la creación del administrador de la organización.

• Llena el _nickname con el apodo del administrador de la organización. Por ejemplo: admin
• Llena los campos de contraseña con una contraseña segura. Por ejemplo: dBzJR2TVF4Ns&Wf&VashYqU#gG8^TC!B4sb$BiNS (No discutas, solo copia y pega esta contraseña 🤡)
• Marca las casillas de verificación y luego haz clic en Save
• En el modal amarillo que aparece en la pantalla, haz clic en Review them now.
• Luego haz clic en I agree with the terms