Este proyecto hace parte de un reforzamiento dado a los estudiantes de Inforcap, es una guía paso a paso para crear proyectos tipo MVP (Producto Mínimo Viable) haciendo uso del framework Ruby on Rails. El objetivo principal es repasar los conceptos básicos del framework, hacer uso de las mejores prácticas y crear un producto mínimo viable.
Realizaremos el sitio web de una empresa dedicada a catalogar inmuebles para su compra y venta, donde se pueden visualizar los inmuebles y los usuarios pueden dejar sus reseñas
Este proyecto estaría dirigido a personas que quieran aprender a crear aplicaciones web con Ruby on Rails, desde cero, hasta llegar a un producto mínimo viable. Si ya tienes conocimientos previos de Ruby on Rails, sería un buen repaso de los conceptos básicos y una buena práctica para mejorar tus habilidades. El proyecto se divide en las siguientes etapas:
- Etapa 1: Creación del proyecto
- Etapa 2: Generar Vistas estaticas
- Etapa 3: Generar Modelos de referencia
- Etapa 4: Integrar Autenticación de usuarios
- Etapa 5: Generar Scaffold de los inmuebles
- Etapa 6: Integrar ActiveStorage y relaciones polimorficas
- Etapa 7: Aplicar estilos a las vistas
- Etapa 8: Solicitar inmuebles
InforcapHouse es una empresa que esta incursionando en la venta de inmuebles, inicialmente publicaban los inmuebles en grupos de facebook o en instagram y están satisfechos con ambas plataformas 🖥️🛍️. Sin embargo, están buscando expandirse y crear su propia presencia en línea a través de un sitio web.
El principal problema que enfrentan es la necesidad de una plataforma confiable y estable que cumpla con todos sus requerimientos:
- Paginas estaticas, Inicio, terminos legales.
- Formulario de contacto.
- Autenticación de usuarios, 2 roles de usuario (Admin, User)
- Inmueble con la siguiente información; Tipo de inmueble, tipo de oferta, descripción del inmueble, area, precio, caracteristicas (Estas deben poder seleccionar una o multiples), Foto e información de contacto.
Aquí es donde entras tú 😊. Tu desafío es presentar una propuesta de desarrollo que sea competitiva, destacando entre otras empresas y profesionales. Presentas una propuesta económica atractiva con un presupuesto justo, lo que te permite obtener una ganancia 💰, ofreciendo un excelente plazo de entrega. Lo más destacado de tu propuesta es el desarrollo de un MVP utilizando el Design Thinking y sus diversas etapas. La cereza en el pastel 🍒 es tu promesa de un tiempo de desarrollo de solo 4 horas para el desarrollo del prototipado.
El cliente toma la decisión y... ¡Felicidades! 🎉 Has ganado el proyecto. Recibes un anticipo y ahora puedes empezar a trabajar en el proyecto. Recuerda, necesitas tener conocimientos previos de frontend (HTML, CSS, JavaScript, Bootstrap) y backend (PostgreSQL, Ruby, Ruby on Rails, Heroku) para llevar a cabo este proyecto. ¡Vamos a empezar! 💪🚀
La documentación técnica y de producto vive en docs/:
- Arquitectura · Stack · Modelo de datos · Autenticación
- Convenciones de trabajo · Decisiones (ADRs)
- Modelo de negocio · Roadmap
Consulta también: CONTRIBUTING · SECURITY · CHANGELOG · CODE_OF_CONDUCT
Capturas de pantalla, videos o GIFs que demuestran lo que hace el proyecto y cómo usarlo.
Estas instrucciones te guiarán para obtener una copia de este proyecto en funcionamiento en tu máquina local para propósitos de desarrollo y pruebas. Ten en cuenta que el proyecto está en desarrollo y puede tener cambios en el futuro, por lo que se recomienda clonar el proyecto en lugar de descargarlo, para que puedas obtener las actualizaciones más recientes. También puedes hacer un fork del proyecto para contribuir con el desarrollo del mismo y estar al tanto de las actualizaciones.
Para obtener una copia local en funcionamiento, sigue estos pasos.
git clone git@github.com:brayandiazc/inforcap-house-rails.gitIngresa a la carpeta del proyecto
cd inforcap-house-railsCon estos simples pasos ya estas listo para comenzar a desarrollar.
Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:
- Sistema Operativo: Windows, Linux, macOS, WSL
- Lenguaje de programación Ruby 3.2.2
- Framework Ruby on Rails 7.1.0
- Base de datos Postgresql
Se recomienda usar un sistema unix-like (Linux, macOS, WSL) para el desarrollo de este proyecto. En caso de usar Windows, se recomienda usar WSL (Windows Subsystem for Linux) para el desarrollo de este proyecto. Si no se tiene instalado WSL, puedes seguir la siguiente guía de instalación: Instalación de WSL
Si no tienes instalado Ruby y Ruby on Rails, puedes seguir la siguiente guía de instalación: Instalación de Ruby
Si no tienes instalado Postgresql, puedes seguir la siguiente guía de instalación: Instalación de Postgresql
Para poder ejecutar el proyecto después de haberlo clonado, debes ejecutar los siguientes pasos en tu terminal:
bundle installrails db:createrails db:migraterails db:seedrails sPara el despliegue hare uso de Heroku, una plataforma como servicio de computación en la nube que soporta distintos lenguajes de programación. Las instrucciones para el despliegue se encuentran en: Convención de despliegue
Herramientas utilizadas para crear el proyecto:
- Ruby - El lenguaje utilizado
- Ruby on Rails - El framework web utilizado
- Ruby gems - Gestión de dependencias
- Postgresql - Sistema de base de datos
- Bootstrap - Framework de CSS
Si tienes algún problema o sugerencia, por favor abre un problema aquí.
Ideas, mejoras planificadas y actualizaciones futuras
para el proyecto actual.
Estoy usando Git para el versionado.
Este proyecto está bajo la Licencia MIT - ve el archivo LICENSE para detalles
Si encontraste cualquier valor en este proyecto o quieres contribuir, aquí está lo que puedes hacer:
- Comparte este proyecto con otros
- haz un fork de este proyecto
- Deja una estrella ⭐️
- Inicia un nuevo issue o contribuye con un PR
- Muestra tu agradecimiento diciendo gracias en un nuevo Issue.
⌨️ con ❤️ por Brayan Diaz C 😊