El objetivo de este proyecto es realizar una prueba técnica en una aplicación web Ruby on Rails con una arquitectura similar a la de https://savy.co.
Para empezar a trabajar el ejercicio haz un fork de este repositorio en tu cuenta de github como se indica en este link
Si ya tienes configurado un ambiente de desarrollo de Ruby on Rails puedes saltarte este paso,de lo contrario puedes elegir entre realizar el desarroll en un ambiente Cloud, o instalar localmente las dependencias del proyecto.
Para comenzar a trabajar en el ejercicio sin realizar la instalación local del ambiente de Ruby on Rails, se recomienda usar Cloud 9 IDE.
Una vez hayas hecho el fork del proyecto en tu github, podrás entrar a Cloud 9 y sincronizar el respositorio con el ambiente de desarrollo virtual.
Esta opción está especialmente recomendada para las personas que tienen como ambiente de trabajo Windows, pues es el sistema operativo en el que se tienden a encontrar más problemas de configuración.
Seguir las instrucciones de este link (https://gorails.com/setup/ubuntu/18.10)
Seguir las instrucciones de este link (https://gorails.com/setup/osx/10.13-high-sierra)
-
Instalar ruby 2.6.3: windows
-
Desde la consola de comandos en modo administrador instalar bundler:
gem install bundler -
Desde la consola de comandos en modo administrador instalar bundler:
gem install rails 5.2.2 -
Instalar PostgresSQL 10 usando el instalador en (https://www.postgresql.org/download/windows/)
-
Ingresar a la consola de Postgres (se puede encontrar buscándola en el menú de inicio y buscando SQL Shell (psql))
-
Desde la consola de Postgres crear un rol con el usuario actual de windows. IMPORTANTE: El rol debe tener en cuenta las mayúsculas y minúsculas del nombre de usuario, por lo tanto debe ir entre comillas para que se cree correctamente:
Ejemplo, si mi usuario de windows es Felipe, el comando para crear el rol sería:
CREATE ROLE "Felipe" SUPERUSER;
Por favor tener en cuenta las comillas.
El proyecto de pruebas se entrega en estado funcional, con datos iniciales y con sus respectivas pruebas unitarias y de integración.
- Simple Form para la generación de formularios link
- Bootstrap 4 para los estilos link
- Minitest para las pruebas unitarias link
Para iniciar el proyecto se deben seguir los siguientes pasos:
-
Descargar el código
git clone https://github.com/usuario-github/xavy.git -
Instalar las librerias del proyecto
bundle install -
Ejecutar el comando
bundle exec rails app:update:bin -
Crear la base de datos
bundle exec rails db:create -
Ejecutar las migraciones
bundle exec rails db:migrate -
Cargar los datos de prueba
bundle exec rails db:seed -
Ejecutar la aplicación
bundle exec rails server -
Entrar a http://localhost:3000 para ver la aplicación
-
Entrar a http://localhost:3000/admin para ver el panel de administrador
Comandos adicionales:
-
Ejecutar las pruebas unitarias
rails test -
Abrir la consola de rails (permite ejecutar comandos usando las clases definidas dentro del proyecto)
rails console
PD: Antes de ejecutar las pruebas unitarias es posible que se deba crear/actualizar la base de datos de pruebas.
rails db:create RAILS_ENV=test
rails db:migrate RAILS_ENV=test
Nota respecto a la base de datos: El proyecto está configurado para usar la base de datos postgresql por default, sin embargo no es obligatorio. Si prefieres trabajar con alguna de las otras bases de datos disponibles en Rails como MySql, Sqlite3, etc. recuerda cambiar el archivo config/database.yml y actualizar el Gemfile para usar la librería correcta:
Ejemplo: Gemfile
# Reemplazar sqlite3 por pg
gem 'pg'
#gem 'sqlite3', git: "https://github.com/larskanis/sqlite3-ruby", branch: "add-gemspec"
Ejemplo: database.yml usando postgresql.
# config/database.yml
default: &default
adapter: postgresql
encoding: unicode
pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
development:
<<: *default
database: savy_development
# The specified database role being used to connect to postgres.
# To create additional roles in postgres see `$ createuser --help`.
# When left blank, postgres will use the default role. This is
# the same name as the operating system user that initialized the database.
#username: savy
# The password associated with the postgres role (username).
#password:
test:
<<: *default
database: savy_test
production:
<<: *default
database: savy_production
username: deploy
password: <%= ENV['SAVY_DATABASE_PASSWORD'] %>
Xavy.com es un directorio de centros de Fitness and Wellness. La aplicación está estructurada en dos partes. Una parte pública donde de pueden consultar los distintos centros con sus respectivas actividades y una parte para que los administradores de la aplicación puedan actualizar la información de los centros.
Por petición de nuestros usuarios, se quiere permitir que los centros deportivos puedan seleccionar entre las dificultades (bajo, medio, alto) para cada de las actividades. Igualmente los usuarios deben poder consultar la dificultad de cada actividad desde el directorio.
Igualmente se quiere poder "taggear" las distintas actividades con una o más categorías para que los usuarios puedan poner en contexto los nombres de las distintas actividades que ofrecen loscentros. Estas categorías se deben crear a través de la interfaz del administrador y se deben poder asignar a las actividades.
Por último, nuestros usuarios han expresado que sienten dificultad al momento de encontrar los centros deportivos. Una queja común es que salen demasiados resultados, y no hay una forma de filtrarlos. Por lo tanto, queremos ofrecerles a los usuarios la posibilidad de filtrar los centros deportivos que aparecen en el índice según su nombre. Para esto debemos desarrollar un formulario en la lista de centros que permita ingresar un texto y filtrar los centros desplegados según este filtro.
==============================BONUS==================================================
Nuestro equipo de diseño determinó que para brindar la mejor experiencia de usuario, debemos ofrecerla posibilidad de filtrar los resultados según los Tags de categorías que fueron desarrollados en el segundo punto de este ejercicio, adicional al filtro por nombre de centro.
El desarrollo de los requerimientos es libre. No hay marcas de #TODO, ni sitos específicos donde se debe escribir el código. Cada persona está en libertad de desarrollar la solución que le parezca apropiada. Lo importante es la justificación. Si se considera necesario se permite agregar librerías tanto en ruby como en javascript para completar el ejercicio.
El código del ejercicio se debe sincronizar con la copia personal del proyecto en github y enviar el link a sistemas(at)savy.co.
Opcionalmente se puede hacer un despliegue (gratuito) a heroku e inlcuir la URL del proyecto par que sea más fácil revisarlo.
Una versión demo de la aplicación se puede encontrar en https://xavy.herokuapp.com/