APP para rentar bicicletas

Descripción

Esta es una aplicación web para la renta de bicicletas. Fue creada con Typescript + React en sus últimas versiones.

El aspecto visual no se tomó tan en cuenta durante el desarrollo como sí otros detalles más relacionados con el funcionamiento, arquitectura y diseño a nivel técnico de la solución.

📃 En este link te contamos con más detalle el proceso que seguimos en el desarrollo: PROYECTO BIKE RENTALS

Características generales

• Presenta el listado de bicicletas disponibles ⚡
• Calcula el precio del alquiler ⚡
• Presenta una vista detalle de la bicicleta seleccionada. ⚡
• Permite generar una solicitud de renta de la bicicleta seleccionada ⚡

Características del desarrollo

• Utiliza docker y .devcontainer para facilitar un ambiente de desarrollo homogéneo
• Sigue los principios SOLID y utiliza el patrón de diseño Factory Method
• Creada desde el inicio con i18n en 2 idiomas
• Utiliza Material UI + styled components para los estilos

Pasos para iniciar la aplicación en su localhost

La aplicación sólo requiere que Docker y Docker Compose estén instalados en su sistema. Adicional, los puertos 1234, 1235 y 1080 de su sistema deben estar disponibles (lo más probable es que ya lo estén).

Por favor asegúrese de seguir los pasos de instalación de dichas herramientas en caso de que aún no las tenga instaladas.

• Instalar Docker
• Instalar Docker Compose

Podemos comprobar la instalación de docker y docker compose de la siguiente manera:

docker --version
docker-compose --version

Estos comandos retornan las respectivas versiones de Docker y de Docker Compose.

⚠ Si usted desea, puede ejecutar el siguiente comando para asegurarse que ningún contenedor docker esté en ejecución ya que podría interferir con el arranque de nuestro aplicativo.

⚠ Tenga cuidado, este comando va a detener todos los contenedores ejecutándose en su equipo actualmente. El siguiente comando es opcional.

docker stop $(docker ps -q -a)

Una vez instalados Docker y Docker Compose, procedemos con los pasos para iniciar nuestra aplicación.

Estos comandos fueron probados con Powershell (windows), bash (linux) y zsh (mac)

Paso 1

Clonamos el actual repositorio e ingresamos a la carpeta del proyecto

git clone https://github.com/serranomorante/bike_rentals
cd bike_rentals

Paso 2

Una vez dentro de la carpeta del proyecto, ejecutamos estos comandos uno por uno en el siguiente orden:

docker network create my_bike_rentals_local_network
docker-compose -f local.yml build
docker compose -f local.builder.yml run --rm install
docker-compose -f local.yml up -d

Una vez completado este paso, sin cerrar la consola de comando, nos dirigimos a nuestro navegador de preferencia y buscamos la siguiente url: localhost:1234 Y desde ahí podemos comenzar a navegar por el aplicativo.

Decisiones en el desarrollo

¿Por qué utilizamos el Factory Pattern?

📃 Recuerda que en el siguiente link te contamos con más detalle el proceso que seguimos: PROYECTO BIKE RENTALS

Al utilizar Factory Pattern le estamos permitiendo a nuestra aplicación ser extensible en el tiempo ya que toda funcionalidad se desarrolla sobre una abstración en vez de desarrollar directamente sobre la implementación.

En este caso, si bien ahora mismo la nuestra es una app de renta de bicicletas, el modelo de negocio bien podría expandirse a la renta Scooters, Motocicletas o cualquier cosa sobre ruedas.

Es por esto que aplicamos el Factory Pattern para que a nivel de código nuestra aplicación NO se limite a interactuar únicamente con bicicletas sino que pueda expandirse e interactuar con otro tipo de vehículos para movilización.