Proyecto fin de ciclo

¡Bienvenido a DogWalkz 🐾 — una plataforma diseñada para programar paseos para tus perros de forma fácil y cómoda!

Descripción

DogWalkz es una aplicación móvil que conecta a dueños de perros con paseadores profesionales de manera segura, sencilla e intuitiva. Ofrece un registro fácil, seguimiento de paseos en tiempo real, un sistema de pagos seguro y una comunidad basada en reseñas para garantizar un servicio de alta calidad. Diseñada para dueños de mascotas ocupados y paseadores profesionales, DogWalkz simplifica el proceso de gestionar paseos de perros de forma segura y transparente.
Construida con un stack tecnológico Flutter + Supabase, además de incorporar tecnologías modernas como OAuth2.0 para la autenticación por redes sociales, la app es multiplataforma y multilingüe, lo que la hace accesible para una audiencia global.
DogWalkz no solo resuelve una necesidad real, sino que también abre oportunidades para un negocio escalable a través de comisiones y servicios premium.

Instalación / Puesta en marcha

Note

Si deseas probar la aplicación directamente en tu dispositivo Android, puedes instalar el archivo APK directamente desde aquí: ⬇️ Descargar APK

1. Instalar SDK de Flutter

Primero, debemos instalar Flutter en nuestra máquina.

• Windows:

  1. Descarga la última versión estable del SDK de Flutter desde el sitio web oficial.
  2. Extrae el archivo zip y colócalo en la ubicación deseada (por ejemplo, C:\src\flutter).
  3. Agrega Flutter a las variables de entorno del sistema:
     • Busca "Variables de Entorno" en Windows.
     • Edita la variable Path y añade la ruta completa al directorio flutter/bin.
  4. Ejecuta lo siguiente en una terminal para verificar:

     flutter doctor

• macOS:

  1. Instalar Flutter via Homebrew:

     brew install --cask flutter

     O realiza la descarga manualmente desde Flutter downloads.

  2. Verificar Instalación:

     flutter doctor

• Linux:

  1. Descarga la última versión estable del SDK de Flutter desde Flutter downloads.
  2. Extrae el fichero tar:

     tar xf flutter_linux_*.tar.xz

  3. Añade Flutter a la variable Path:

     export PATH="$PATH:`pwd`/flutter/bin"

  4. Verificar la instalación:

     flutter doctor

---

2. Instalar requisitos adicionales

• Instala un editor como VS Code o Android Studio.

• Para el desarrollo móvil:

  • Instala Android Studio y configura el SDK de Android.
  • Para el desarrollo en iOS (solo en macOS): Instala Xcode.

• Instala los complementos de Flutter y Dart en tu IDE.

• Acepta las licencias de Android ejecutando:

  flutter doctor --android-licenses
  

---

3. Clonar el Repositorio Dogwalkz

Se puede clonar por HTTPS o SSH:

• Via HTTPS:

  git clone https://gitlab.com/iesleliadoura/DAM2/alejandro-manuel-patino Dogwalkz
  cd Dogwalkz

• Via SSH:

  git clone [email protected]:iesleliadoura/DAM2/alejandro-manuel-patino Dogwalkz
  cd Dogwalkz

---

4. Obtener dependencias

Instala todos los paquetes requeridos de Flutter:

flutter pub get

---

5. Ejecutar la aplicación

Para ejecutar la aplicación en un dispositivo o emulador:

flutter run

---

6. Verificar la configuración

Finalmente, verifica que todo esté instalado correctamente:

flutter doctor

Resuelve cualquier problema pendiente si es necesario.

Tip

En caso de error en la libreria de internalización(Applocalizations) ejecute en terminal:

flutter gen-l10n

Este comando genera las clases y métodos getter para poder acceder a las cadenas localizadas

Uso

DogWalkz está diseñado para ser intuitivo y sencillo tanto para dueños de perros como para paseadores profesionales.

• Dueños de perros:

  1. Regístrate o inicia sesión en la aplicación.
  2. Crea tu perfil de usuario.
  3. Agrega la información de tu perro (nombre, raza, tamaño, sociabilidad).
  4. Reserva un paseo, sigue el recorrido de tu perro en tiempo real y paga de forma segura al finalizar.
  5. Califica y deja una reseña del paseador después del paseo.

• Paseadores de perros:

  1. Regístrate o inicia sesión en la aplicación.
  2. Configura tu perfil de paseador activando la opción correspondiente en tu perfil de usuario y completando los campos requeridos: experiencia, tamaños de perros preferidos, identificación...
  3. Acepta solicitudes de paseo de los dueños de perros.
  4. Inicia y completa el paseo mientras eres rastreado para mayor transparencia.
  5. Recibe el pago una vez que el paseo sea completado y revisado.

Note

Asegúrate de tener fondos en tu monedero virtual y de que tu perfil esté debidamente completado antes de reservar o aceptar paseos.

Sobre el autor

Mi nombre es Alejandro Patiño, soy un desarrollador junior especializado en desarrollo móvil multiplataforma.
Mi principal fortaleza es crear aplicaciones rápidas, escalables e intuitivas utilizando Flutter Framework, lo que me permite desarrollar aplicaciones nativas, tanto para Android como iOS desde una única base de código.

Actualmente, estoy trabajando como alumno en prácticas en QBitDynamics, donde sigo ampliando mis conocimientos en proyectos móviles.
Tengo un fuerte enfoque en crear código limpio y bien documentado, priorizando el desarrollo de diseños UI/UX intuitivos para garantizar una experiencia fluida y atractiva.

Elegí desarrollar DogWalkz porque combina mi amor por la programación con la solución de problemas reales cotidianos. Los servicios para mascotas están creciendo rápidamente, y creo que esta aplicación ofrece una solución valiosa y escalable en un mercado de alta demanda.

Actualmente vivo en Ribeira, España, y estoy abierto a nuevas oportunidades y colaboraciones.

Puedes contactarme en:

---

Licencia

Este software es propietario. Todos los derechos están reservados por el autor. No se permite utilizar, modificar, distribuir ni copiar el software sin el permiso explícito del autor.

Para más detalles, consulta el archivo LICENSE.

Índice

1. Anteproyecto
   • 1.1. Idea
   • 1.2. Necesidades
2. Análisis
3. Planificación
4. Diseño
5. Implantación
   • 5.1 Implementación
   • 5.2 Producción

Links

• Flutter

  • Instalación de Flutter — Guía oficial para instalar Flutter en Windows, macOS y Linux.
  • Documentación de Flutter — Documentación Oficial de Flutter.
  • Pub.dev — Repositorio oficial de paquetes para Flutter y Dart.

• Supabase

  • Supabase Docs — Documentación de Supabase, necesario para crear el backend del proyecto.

• Entornos de Desarrollo

  • Visual Studio Code — Editor de código multiplataforma recomendado.
  • Plugins de Flutter y Dart para VS Code — Extensiones necesarias para desarrollar con Flutter.
  • Android Studio — IDE para el desarrollo y emulación de apps Android.
  • Instalar SDK de Android — Guía para instalar y configurar el SDK de Android.

• Desarrollo IOS (solo macOS)

  • Instalación de Xcode — IDE para el desarrollo de apps IOS.

• OAuth2.0

  • OAuth Docs — Documentación necesaria para la implementación del protocolo OAuth2.0.

• Stripe

  • Stripe Docs — Documentación de Stripe, necesario para implementar las pasarelas y configurar la conexión con la API.

• Código Fuente del Proyecto

  • DogWalkz en GitLab — código fuente del proyecto.

---