¡Presentamos MASCOTICOS: Tu comunidad para el bienestar animal!
Más que una tienda, MASCOTICOS es un espacio donde los amantes de los animales se conectan y comparten su pasión.
Nuestra misión:
Fortalecer el vínculo entre las personas y sus mascotas.
Brindar una plataforma segura y confiable para encontrar productos y servicios de calidad para el bienestar animal.
Construir una comunidad comprometida con la protección y el cuidado de los animales.
¿Qué puedes encontrar en MASCOTICOS?
Mercado: Sube anuncios de productos o servicios para mascotas, desde comida y juguetes hasta paseadores y peluqueros caninos. Encuentra todo lo que necesitas para el bienestar de tu peludo amigo.
Localizador GPS: No pierdas de vista a tu perro en tiempo real con nuestro sistema de rastreo GPS. Disfruta de paseos más seguros y tranquilos.
Descuentos exclusivos: Accede a ofertas y promociones especiales en productos y servicios para tu mascota. Ahorra dinero mientras cuidas de tu mejor amigo.
Comunidad: Conéctate con otros amantes de los animales, comparte experiencias, consejos y fotos de tus peluditos. ¡Forma parte de una comunidad que entiende el amor por las mascotas!
MASCOTICOS: ¡Más que una aplicación, una comunidad!
Descarga la aplicación ahora y únete a la comunidad que está cambiando el mundo de los animales y sus compañeros.
¡Empieza a disfrutar de todos los beneficios que MASCOTICOS tiene para ti y tu mascota!
| BRANCH | Description |
|---|---|
| main | Rama principal. Aquí alojamos solo los resultados finales de cada historia de usuario |
| dev | Rama de desarrollo. Aquí juntamos el trabajo individual para unificarlo |
| feature-details | Rama de creacion de deatils, para crear, mergear y borrar. |
| feature-form | Rama de desarrollo de la parte del formulario, mergeo y borrado |
| feature-home | Rama para implementar pagina principal a la aplicacion, mergeo y borrado |
| feature-footer | Rama para implementar el footer a todas las paginas, mergeo y borrado |
| dev_get | Rama para implementar los métodos get de la parte de backend |
| test | Rama para la comprobacion y desarrollo de los test |
| feature-put | Rama para desarrolar metodo PUT en backend |
| feature-card | Rama de desarrollo para anuncio especifico en Frontend |
Nos han pedido que hagamos un marketplace a tema libre, nosotros hemos decidido hacerlo sobre servicios y productos para animales!
Empezaremos haciendo un sistema de creacion de anuncions, de modo que podamos añadir anuncios de servicios ofrecidos para ellos y de productos destinados para nuestros grandes compañeros. De cara a facilitar la vida de ellos y nuestra, se nos pide que, si es posible, proporcionemos un escalado de la aplicación de cara a mejorarla en un futuro y tener nuevas funcionalidades de una manera sencilla. Por ejemplo, añadir un registro de usuarios, y funciones extras.
🛠️ Las funcionalidades básicas que cubre la aplicación web son las siguientes:
- Publicar un anuncio en la aplicación.
- Poder visualizar todos los anuncios en una pagina principal.
- Un base de datos donde guardemos todos los anuncios disponibles.
- Una pagina individual para cada producto especifico.
- Tener la posibilidad de poder subir un producto o un servicio ( diferenciado por categoria ).
- Buscador para anuncios por categoria.
- Login de usuario para poder poder guardar anuncios como favoritos.
- Geolocalizacion para diferentes servicios ( como por ejemplo paseo de mascotas ).
- Sistema de VIP para tener acceso a subir anuncios premium, mejor posicionados.
- Sistema de descuento para nuestros integrantes.
Hemos utilizado Miro para crear tableros donde tener accesibles todos los documentos de planificación: historias de usuario, kanban y funciones.
-
Para poder inicializar el proyecto necesitaremos un editor de codigo fuente, por ejemplo VS CODE: https://code.visualstudio.com/download
-
Necesitaremos instalar JAVA 17 para poder levantar el backend o tocar codigo: https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
-
Necesitaremos iniciar nuestro proyecto react en nuestro editor, abriendo el terminal con este comando:https://carlosazaustre.es/react-vite
-
En este caso como el proyecto ya esta iniciado valdra con poner en el terminal:
pnpm install, esto instalara todas las dependencias necesarias. -
Tendremos que instalar una libreria de React que se llama MaterialUI, en el terminal insertaremos el siguiente codigo:
pnpm install @mui/material @emotion/react @emotion/styled @mui/styled-engine-sc styled-componentscon esto veremos UX de nuestra pagina con los componentes que hemos utilizado. -
Para la base de datos la tenemos a traves de PostgreSQL, puedes acceder a traves de este enlace:https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
-
Una vez todo instalado usaremos el comando
./mvnw spring-boot:runpara levantar el backend ynpm run devpara levantar el frontend -
Si nos sale un error de JAVA_HOME es por el tema de las variables de entorno, os dejo una pequeña guia para poder realizarlo sin problema justo aqui de bajo.
-
Para poder realizar los test desarrollados lo podremos hacer desde backend con el comando
npm testy de la misma manera desde el backend con el comando./mvnw test
Edita las variables de entorno:
Windows:
Busca "Sistema" en el menú Inicio y selecciona "Propiedades del sistema".
Haz clic en "Configuración avanzada del sistema".
En la pestaña "Opciones avanzadas", haz clic en "Variables de entorno".
En la sección "Variables del sistema", busca la variable "JAVA_HOME". Si no existe, crea una nueva.
Edita el valor de "JAVA_HOME" para que apunte a la ruta de la carpeta de instalación de Java (por ejemplo, C:\Program Files\Java\jdk-19).
Crea una nueva variable de entorno llamada "PATH" si no existe.
Agrega al final del valor de "PATH" la siguiente línea: ;%JAVA_HOME%\bin.
macOS:
Abre "Preferencias del sistema".
Selecciona "Perfil".
Haz clic en "Avanzado".
Haz clic en el botón "+".
En el campo "Nombre", escribe "JAVA_HOME".
En el campo "Valor", escribe la ruta de la carpeta de instalación de Java (por ejemplo, /Library/Java/JavaVirtualMachines/jdk19.jdk/Contents/Home).
Haz clic en el botón "+".
En el campo "Nombre", escribe "PATH".
En el campo "Valor", escribe export PATH=$PATH:$JAVA_HOME/bin.
Cierra la ventana de "Preferencias del sistema".
Home: Anuncios disponibles
Anuncio: Anuncio espececifico
Form: Añadir un nuevo anuncio disponible
Introducing MASCOTICOS: Your community for animal welfare!
More than a store, MASCOTICOS is a space where animal lovers connect and share their passion.
Our mission:
Strengthen the bond between people and their pets.
Provide a safe and reliable platform to find quality products and services for animal welfare.
Build a community committed to the protection and care of animals.
What can you find at MASCOTICOS?
Marketplace: Upload ads for products or services for pets, from food and toys to dog walkers and groomers. Find everything you need for the well-being of your furry friend.
GPS Locator: Never lose sight of your dog in real time with our GPS tracking system. Enjoy safer and more peaceful walks.
Exclusive Discounts: Access special offers and promotions on products and services for your pet. Save money while taking care of your best friend.
Community: Connect with other animal lovers, share experiences, tips and photos of your furry friends. Be part of a community that understands the love for pets!
MASCOTICOS: More than an app, a community!
Download the app now and join the community that is changing the world of animals and their companions.
Start enjoying all the benefits that MASCOTICOS has for you and your pet! git branches
| BRANCH | Description |
|---|---|
| main | Main branch. Here we only host the final results of each user story |
| dev | Development branch. Here we merge individual work to unify it |
| feature-details | Branch for creating details, to create, merge and delete. |
| feature-form | Development branch for the form part, merge and delete |
| feature-home | Branch to implement main page to the application, merge and delete |
| feature-footer | Branch to implement the footer to all pages, merge and delete |
We have been asked to make a free-theme marketplace, we have decided to make it about services and products for animals!
We will start by creating an ad creation system, so that we can add ads for services offered for them and products intended for our great companions.
In order to make their and our lives easier, we are asked to, if possible, provide a scaling of the application in order to improve it in the future and have new functionalities in a simple way. For example, adding a user registration, and extra functions.
Publish an ad on the application.
To be able to visualize all the ads on a main page.
A database where we store all the available ads.
An individual page for each specific product.
Have the possibility of being able to upload a product or a service (differentiated by category).
Search engine for ads by category.
User login to be able to save ads as favorites.
Geolocation for different services (such as pet walking).
VIP system to have access to upload premium ads, better positioned.
Discount system for our members.
We have used Miro to create dashboards where all planning documents are accessible: user stories, kanban and roles.
-
In order to initialize the project we need a source code editor, e.g. VS CODE: https://code.visualstudio.com/download
-
We will need to install JAVA 17 to be able to lift the backend or touch code.: https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html
-
We will need to start our react project in our editor, by opening the terminal with this command:https://carlosazaustre.es/react-vite
-
In this case as the project is already started it will be enough to put in the terminal:
pnpm install, this will install all the necessary dependencies. -
We will have to install a React library called MaterialUI, in the terminal we will insert the following code:
pnpm install @mui/material @emotion/react @emotion/styled @mui/styled-engine-sc styled-componentswith this we will see the UX of our page with the components that we have used. -
For the database we have it through PostgreSQL, you can access through this link:https://www.enterprisedb.com/downloads/postgres-postgresql-downloads