paulinaquintero/pueblos-magicos

Turi, Recomendaciones sobre Pueblos Mágicos

¿Qué es Turi?

Pueblos mágicos es una Página Web que tiene como objetivo mostrar recomendaciones sobre que hacer en los diferentes pueblos mágicos dentro de la República Mexicana.

En esta primer etapa Turi solo mostrará la información de los pueblos mágicos de 2 estados dentro de la República como lo son: ESTADO DE MÉXICO E HIDALGO.

En cada recomendación el usuario podrá conocer información como:

• Los costos aproximados por visitar las atracciones más populares dentro del pueblo.
• Ubicacion aproximada desde el centro del pueblo.

Ademas de esto, los usuarios que se registren en la página pueden dejar comentarios, calificaciones y/o reseñas sobre las recomendaciones que ya se encuentran publicadas para de este modo los otros usuarios sepan si es información confiable o no.

¿Cómo funciona Turi?

Turi cuenta con las siguientes opciones de menú, los cuales se describiran a detalle más adelante:

• Home: Página inicial del sitio.

• Pueblos Mágicos: Listado de todos los pueblos mágicos disponiles actualmente.

• Comunidad: Comunidad registrada en Turi.

• Soporte: Listado de desarrolladores que crearon Turi.

• Iniciar sesión: Permite el inicio de sesión para usuarios registrados.

• Registrate: Pemite registrarse a los nuevos usuarios.

Home

Dentro del Home de Turi podrás encontrar las siguientes secciones:

• Slider de bienvenida con imagenes de los diferentes pueblos mágicos.

• Ultimas recomendaciones, en esta sección podrás encontrar las ultimás 3 recomendaciones hechas por TURI para los usuarios, al dar click en la recomendación de tu preferencia esta te llevara a la información detallada.

• Conoce todas nuestras recomendaciones, en esta sección se comparte un poco de información sobre la belleza de nuestro país y de que se podra encontrar en TURI. Dando click al botón de "Ir al listado" este te redireccionará a la página donde encontraras el listado de los pueblos mágicos disponibles.

• Por ultimó, podrás visualizar nuestro footer que te llevará directamente a las redes sociales de Turi. (Aún no disponibles).

Pueblos mágicos

Dentro del está página te mostramos el listado de los pueblos magicos que cuentan con una guía de recomendaciones hecha por Turi.

Además de permitirte filtar por estado dichas recomendaciones.

Para poder filtar solo necesitas:

• Dar click sobre "Todos los pueblos" que te desplegará todas las opciones disponibles para seleccionar. Seleccionas el Pueblo de tu agrado y das click en "Buscar", así Turi filtrará las recomendaciones hechas que coincidan con el pueblo que seleccionaste.

Por ultimó, podras encontrar un paginador que te permitira navegar dentro de todas las recomendaciones en caso de existir más de 3.

Ahora, ya que decidiste que pueblo quieres conocer, da click al botón naranja para ir a su informacion detallada.

Ejemplo seleccionemos: " Valle de Bravo"

Una vez demos click veremos las siguientes secciones:

• Nombre del Pueblo mágico seleccionado.

• Información general del pueblo mágico, en este caso: Valle de bravo.

• ¿Que hacer en Valle de Bravo? Aquí surge la magia de Turi, las recomendaciones de actividades que puedes hacer en Valle de bravo, sus lugares más conocidos que te recomendamos visitar, el costo de entrada, la distancia de centro de pueblo a dicha atracción y el tipo de atracción al que pertenece.

• Comentarios de la reseña. En esta sección se muestran los comentarios hechos por usuarios registrados dentro de Turi. Esta sección es un carrucel de comentarios que contienen cards con la foto el usuario, su comentario, nombre y puntuación que le dio a la reseña hecha por Turi. En caso de no existir nigun comentario para la reseña esta sección no se mostrará.

• Dejanos un comentario Aquí el usuario podrá escribir su comentario y dar la puntuación para la reseña en cuestión.

Para poder hacer un comentario, da click en el botón naranja, luego de esto te saldrá un modal como el siguiente:

En el cual podrás agregar:

• El comentario
• Calificaciión, con base de 1 a 5 estrellas, elige la que te parezca conveniente.
• Da click en enviar y verás tu comentario en la sección de arriba.

¿Cómo puedo comenzar a usar localmente Turi?

Para comenzar a usar Turi localmente:

• Clona el repositorio y una vez clonado, instalá las dependencias necesarias ejecutando el siguiente comando:

npm install

Levanta el proyecto con el siguiente comando:

npm start

IMPORTANTE

Actualmente los datos mostrados por TURI son extraidos de una API local hecha con Json Server, por lo cual es necesario ejecutar json server para visualizar los datos y/o actualizaciones hechas para esto:

• Entra al proyecto previamente clonado y con las dependencias instaladas y en la consola de comandos de tu preferencia ingresa al folder llamado "fake-backend".

Una vez en el directorio mencionado instala las dependencias con el siguiente comando:

npm install

por utlimo levanta el proyecto con el comando:

npm run start

Y listo, deberás de poder ver el siguiente mensaje y visualizar la información.

Features

TURI es desarrollada usando tecnologías como:

• 💡 REACTJS: Biblioteca Javascript de código abierto diseñada para crear interfaces de usuario.

• 🎨 SASS: Preprocesador CSS que se interpreta o compila en hojas de estilo en cascada.

• 📱 Responsive: Diseñada para visualizarse en distintos tamaños de pantalla.

• ⚙️ Best Practices: Flujo de trabajo sólido para mantener el código limpio y estructurado.

• 📨 Json Server: Paquete que nos permite crear una API localmente de manera sencilla através de un archivo JSON.

¿Quienes mantienen y contribuyen a TURI?

Kevin Henry López Vázquez	Paulina Valeria Quintero Mucito	Jesrig Soid Pineda Salinas	Laura Raquel Vazquez Sanchez
[email protected]	[email protected]	[email protected]	[email protected]

GRACIAS POR USAR TURI

¿Cómo se ve TURI en la Web?

Puedes visitar nuestra página y visualizar cómo se ve actualmente TURI, visitando: TURI.