♻️ ReTrueque

Proyecto MVP | NO COUNTRY s17-11-n-java-next

📑 Índice

1. Descripción
2. Requerimientos Funcionales
3. Equipo
4. Herramientas
5. Links

📝 Descripción

ReTrueque conecta a personas que ofrecen servicios del hogar (electricistas, albañilería, limpieza, mecánica, fotografía, clases de idioma) con usuarios que necesitan de estos servicios, según sus preferencias y disponibilidad.

Nuestra plataforma simplifica el intercambio de servicios, permitiendo a quienes no tienen los recursos económicos acceder a servicios a través del trueque. Únete a nuestra comunidad para intercambiar servicios de manera segura y confiable.

ReTrueque es intuitiva y fácil de usar, disponible en Web y Mobile. Ofrecemos transparencia en las interacciones y la posibilidad de contactar rápidamente a proveedores de servicios, coordinando de forma efectiva a través de WhatsApp o correo electrónico.

⚙️ Requerimientos Funcionales

1. Registro y creación de perfil: Los usuarios se registran en la app y crean un perfil detallado, indicando los servicios que ofrecen y los que buscan.
2. Búsqueda de servicios: Los usuarios pueden buscar servicios específicos utilizando filtros como ubicación, categoría, y disponibilidad.
3. Solicitud de intercambio: Una vez encontrado un servicio de interés, el usuario puede enviar una solicitud de intercambio al proveedor del servicio.
4. Aceptación y negociación: El proveedor del servicio revisa la solicitud y, si está interesado, puede aceptarla o negociar los términos del intercambio.
5. Confirmación del intercambio: Una vez acordados los términos, ambos usuarios confirman el intercambio a través de la app.
6. Realización del servicio: Los usuarios realizan los servicios acordados en el intercambio.
7. Evaluación y comentarios: Después de completar el intercambio, los usuarios pueden dejar comentarios y calificaciones sobre su experiencia.
8. Sistema de puntos: La app puede incluir un sistema de puntos o créditos que los usuarios ganan al ofrecer servicios y pueden usar para solicitar otros servicios.
9. Soporte y resolución de conflictos: La app ofrece soporte al usuario y mecanismos para resolver cualquier conflicto que pueda surgir durante el intercambio.

👤 Rol de USER

1. Registro y Login: Creación de cuenta y acceso a la app.
2. Verificación de Identidad: Proceso de verificación para asegurar la autenticidad de los usuarios.
3. Publicación de Servicios: Los usuarios pueden publicar los servicios que ofrecen, seleccionando categorías y añadiendo detalles.
4. Disponibilidad: Los usuarios pueden cargar su disponibilidad para ofrecer servicios.
5. Búsqueda y Filtros: En la página principal, los usuarios pueden ver un resumen de los servicios filtrados por ubicación (geolocalización) y categorías.
6. Conexión entre Partes: Los usuarios interesados en un servicio pueden contactar con otro usuario a través de WhatsApp o email.
7. Comentarios y Calificaciones: Los consumidores pueden dejar comentarios y calificaciones sobre los servicios recibidos.
8. Confirmación de Intercambio: Ambos usuarios deben aprobar mutuamente el intercambio para confirmarlo.
9. Historial de Intercambios: Registro de todos los intercambios realizados por el usuario.

🛠️ Rol de ADMIN

1. Gestión de Usuarios: Registro, login y verificación de identidad de los usuarios.
2. Moderación de Contenidos: Supervisión de los servicios publicados y comentarios.
3. Gestión de Categorías: Definición y limitación de las categorías disponibles.
4. Soporte y Resolución de Conflictos: Atención a problemas y resolución de disputas entre usuarios.
5. Análisis y Reportes: Generación de reportes sobre el uso de la app y popularidad de servicios.

✨ Características Adicionales

• Sin Chat Interno: La comunicación se realiza exclusivamente a través de WhatsApp o email.
• Sin Notificaciones: No se enviarán notificaciones?
• Limitación de Categorías: Las categorías de servicios estarán limitadas según lo definido por el ADMIN.

👥 Equipo

Project Manager Matias Acevedo

Diseño UX/UI Joaquín Peña

Diseño UX/UI Malena De Arriba

Diseño UX/UI Natalia Caniza

Frontend Orlando Cardenas

Frontend Pedro Núñez

Frontend Luiggi R. Pérez

Frontend Victor Maye

Backend Alexander Machicado

Backend Edgar Camberos

QA Tester Arnoldo Felce

QA Tester Benjamin Matos

QA Tester Gladys Ferreira

QA Tester Gisela Lago

Team Leader Orlando Quintero

🛠️ Herramientas Utilizadas

• 🖥️ Frontend:

  • Framework: Next.js
  • Lenguajes: TypeScript, JavaScript
  • Estilos: TailwindCSS, Tailwind Merge, Radix UI
  • Manejo de Estado: Zustand, React Hook Form
  • Validaciones: Zod
  • Autenticación: Nookies, JsonWebToken
  • Consultas y Caché: Tanstack React Query
  • Carouseles: Embla Carousel
  • Íconos: React Icons, Lucide React

• 🔧 Backend:

  • Framework: Spring Boot 3.3.3
  • Lenguaje: Java 17
  • Base de Datos: PostgreSQL, MySQL
  • ORM: Hibernate
  • Migraciones de Base de Datos: Flyway (Soporte para PostgreSQL y MySQL)
  • Seguridad: Spring Security, JWT
  • Validaciones: Spring Boot Validation
  • Email: Spring Boot Starter Mail
  • Documentación de API: Springdoc OpenAPI
  • Mapeo de Objetos: MapStruct
  • Almacenamiento en la Nube: AWS S3
  • Anotaciones: Lombok

• 🧪 Tester:

  • API Testing: Postman, Swagger
  • QA Manual: Google Sheets para seguimiento de pruebas
  • Gestión de Proyectos y Seguimiento: Jira, Test Monitor, Excel
  • Mapeo Mental y Diagramas: Freemind, Miro

• 🎨 UX/UI:

  • Diseño: Figma
  • Prototipos y Flujos: Figma para mockups y prototipos interactivos

• 🗂️ Organización:

  • Comunicación: Discord, Slack, Google Meet
  • Colaboración Visual: Miro
  • Control de Versiones: GitHub

🔗 Links

• Frontend Deploy: s17-11-n-java-next-urev on Render
• Miro Board: Miro Collaboration Board
• Backend Swagger: Swagger UI
• Figma Diseño: Figma Design
• Figma Prototipo: Figma Prototype
• Pruebas del Equipo Tester: Google Sheets Testing

📸 Capturas de Pantalla

---

🎆 Agradecimientos 🎇