PetPal — Aplicación Móvil de Gestión de Mascotas

Aplicación móvil multiplataforma desarrollada en Flutter para centralizar el cuidado y seguimiento de mascotas: historial médico, recordatorios, documentos clínicos y estado de salud, todo organizado por mascota.

Características

• Registro y gestión de múltiples mascotas, con foto de perfil (recorte integrado en la app), número de microchip y cálculo automático de edad exacta (años, meses y días)
• Dashboard "Hoy": resumen de citas, próximas dosis y tratamientos activos de todas las mascotas, ordenado por urgencia, con una sola entrada por mascota y tipo de evento (no una por cada registro histórico)
• Buscador global: encuentra cualquier texto (nombre de vacuna, contenido de una nota, categoría de un documento, etc.) entre todas las mascotas y las 8 entidades con texto libre, sin necesitar recordar en qué mascota o pantalla está
• Historial médico completo: vacunas, medicación, desparasitación, peso y signos vitales (temperatura), cada uno con su propia pantalla, gráfico de tendencia y su lugar en el calendario unificado de la mascota. Los signos vitales alertan visualmente cuando un valor sale del rango normal. La desparasitación admite recordatorios genuinamente recurrentes (ej. "cada 3 meses"), sin necesitar crear un registro nuevo en cada ciclo: se programan los próximos 12 ciclos por adelantado, así el aviso sigue llegando aunque no abras la app durante meses
• Reemplazo de vacunas: al cargar una vacuna parecida a una ya registrada, la app pregunta si la nueva la reemplaza; una vacuna reemplazada deja de contar para la próxima dosis
• Documentos clínicos: exámenes, informes de cirugía, radiografías y recetas, organizados por categoría, con visualización diferenciada (imágenes en vista ampliada, PDFs abiertos con la app nativa del sistema)
• Catálogo de Ubicaciones: lugares reusables (clínicas, peluquerías, hoteles caninos) guardados con nombre y enlace de Google Maps, compartidos entre todas las mascotas y disponibles al agendar una cita — cada cita conserva su propia copia del lugar elegido, así que editar o eliminar una entrada del catálogo nunca modifica citas ya creadas
• Registro de alergias alimentarias, integrado al calendario
• Recordatorios confiables: notificaciones para medicación (con horarios múltiples configurables por el usuario), vacunas, desparasitación y citas veterinarias (con anticipación configurable por el usuario), cada una identificando el nombre de la mascota en el mensaje, que sobreviven a un reinicio del dispositivo, a la restauración de un backup y a la actualización de la app (al actualizar, se reprograman con el nuevo esquema de ids)
• Ficha clínica exportable en PDF, consolidando vacunas, medicación, desparasitación, peso y el índice de documentos — pensada para llevar directamente a una consulta veterinaria
• Diario de comportamiento y notas por mascota, con fotos y exportación a PDF
• Backup y restauración completa cifrada: todos los datos de la app (incluyendo imágenes y documentos adjuntos) en un solo archivo ZIP protegido con contraseña, con vista previa (fecha y mascotas incluidas) antes de confirmar el reemplazo. La restauración es atómica: si algo falla a mitad de camino, los datos actuales quedan como estaban
• Seguridad con biometría: crear o restaurar un respaldo y eliminar una mascota pide huella o desbloqueo del teléfono; si no hay huella registrada, se puede usar el PIN o el patrón
• Widget de pantalla de inicio (Android) con los recordatorios de hoy
• Gestos: en citas, documentos y medicación se elimina deslizando el elemento, con confirmación
• Guía in-app: pantalla de ayuda con explicación de cada función y cómo usarla, agrupada por categoría
• Modo oscuro, con toggle manual (claro / oscuro / según el sistema)
• Acceso a galería y cámara con manejo de permisos Android/iOS modernos
• Persistencia local con integridad referencial real (PRAGMA foreign_keys activa, borrado en cascada verificado por tests)

Stack tecnológico

• Flutter / Dart — desarrollo multiplataforma (Android / iOS)
• Riverpod — manejo de estado, con una capa de repository entre las pantallas y el acceso a datos (ver Arquitectura abajo)
• sqflite — persistencia local con integridad referencial real
• flutter_local_notifications — recordatorios y alertas locales, con manejo explícito de permisos de alarma exacta (Android 12+) y recuperación tras reinicio del dispositivo
• fl_chart — gráficos de tendencia (peso, signos vitales)
• archive — copia de seguridad ZIP con cifrado AES por contraseña
• local_auth — autenticación con huella, rostro o PIN del teléfono
• home_widget — widget de pantalla de inicio (Android)
• pdf / open_filex / share_plus — generación, visualización y exportación de documentos
• image_picker / pro_image_editor / file_picker — captura, recorte y selección de archivos e imágenes
• Gradle / Kotlin — compatibilidad con versiones recientes de Android

Arquitectura

El proyecto usa una arquitectura en capas: pantalla → provider (Riverpod) → repository → base de datos. Cada repository es acceso a datos puro (con una advertencia explícita en el código contra llamarlo directo desde una pantalla); la orquestación de efectos secundarios (programar/cancelar recordatorios, evaluar alertas de rango anormal, limpiar archivos obsoletos) vive en el provider correspondiente, que es la única puerta de escritura real para esa feature.

La migración a esta arquitectura, hecha de forma incremental (una entidad a la vez, cada una sumando exactamente una variable nueva de riesgo sobre una base ya probada), está completa: las 10 entidades del proyecto —mascotas, vacunas, medicación, desparasitación, peso, signos vitales, documentos, notas, citas y alergias alimentarias— tienen su propio repository y provider.

Estado del proyecto

En desarrollo activo. Funcionalidades implementadas y estables: perfiles, dashboard, buscador global, vacunas (con reemplazo entre aplicaciones), desparasitación (con recordatorios recurrentes), medicación, peso, signos vitales, alergias, documentos, calendario, notas, citas (con recordatorio de anticipación configurable), catálogo de ubicaciones, notificaciones, backup/restore cifrado con vista previa y protección biométrica, widget de pantalla de inicio, guía in-app, modo oscuro con toggle manual, y persistencia local con arquitectura completa (repository + Riverpod) en las 10 entidades.

Próximas funcionalidades planificadas:

• Localización a inglés
• Recordatorios recurrentes flexibles para vacunación y medicación (hoy solo disponible para desparasitación)
• Backup opcional en la nube

Testing y CI

El proyecto cuenta con una suite de más de 370 pruebas automatizadas, centrada en los puntos donde un bug puede fallar en silencio, sin lanzar ningún error visible:

• Integridad referencial y borrado en cascada, verificados contra SQLite real (no simulado) en las 17 tablas de la base de datos
• Programación y cancelación de recordatorios, incluyendo ausencia de colisión de IDs entre mascotas, horarios y rangos de fechas largos
• Orquestación correcta entre cada provider y sus efectos secundarios (recordatorios, limpieza de archivos)
• Lógica del buscador global (normalización de acentos/mayúsculas, aislamiento entre mascotas)
• Widget tests del dashboard "Hoy"

Cada push corre automáticamente flutter analyze y flutter test vía GitHub Actions (.github/workflows/ci.yml).

Instalación

1. Clona el repositorio:

git clone https://github.com/Soofiaa/pet_pal.git
cd pet_pal

2. Instala las dependencias:

flutter pub get

3. Ejecuta la aplicación:

flutter run

Requiere Flutter 3.44+ (la versión que usa el CI) y un dispositivo o emulador Android (compatibilidad con iOS en desarrollo).

Para generar una release firmada hace falta android/key.properties y el keystore correspondiente; ambos están ignorados por Git. Guardá una copia del keystore fuera de la PC: sin él no se pueden publicar actualizaciones de la app.

Para correr la suite de pruebas localmente:

flutter analyze
flutter test

Autor

Sofía Menzel — GitHub · LinkedIn