PetConnect247 — Plataforma Multipaís de Adopción de Mascotas

PetConnect247 es una plataforma SaaS multipaís y multilingüe diseñada para conectar a personas con mascotas que necesitan un hogar, servicios veterinarios, hospedaje temporal, tiendas de productos y una comunidad activa de amantes de los animales. Desarrollada en colaboración con Rafael Milla.

Alcance de la Plataforma

• 5 países: España, Portugal, Chile, Venezuela, EE.UU.
• 3 idiomas: Español, Portugués, Inglés
• 7 roles de usuario: Administrador, Usuario, Veterinario, Cuidador, Hotel, Refugio, Tienda
• Soporte de divisas: EUR, CLP, USD con conversión automática por región
• 350+ claves de traducción cubriendo toda la interfaz

Funcionalidades Principales

Sistema de Adopción

• Listado de mascotas con filtros por especie, país, ciudad, tamaño y género
• Flujo completo de adopción: solicitud → revisión por refugio → aprobación/rechazo
• Perfiles detallados de mascotas con formulario de solicitud integrado

Servicios Veterinarios y de Cuidado

• Directorio de veterinarios con filtros por especialidad y disponibilidad de urgencias 24h
• Reserva de citas con calendarios de disponibilidad y sistema de reseñas de pacientes
• Listado de cuidadores individuales y hoteles con gestión completa de reservas

Mascotas Perdidas y Encontradas

• Filtrado jerárquico de ubicación: país → región → ciudad → barrio
• Estadísticas en tiempo real: perdidas, encontradas, reunidas
• Formulario de reporte con subida de fotos e información de contacto

Dashboards Multi-Rol

• Dashboards específicos para los 7 tipos de usuario
• Refugio: CRUD de mascotas y gestión de solicitudes de adopción
• Veterinario: citas, disponibilidad, historial de pacientes y reseñas
• Admin: estadísticas globales y gestión de usuarios

Arquitectura Técnica

React 18 + Vite + TypeScript (Frontend)
           ↕  REST API (HTTPS)
FastAPI + SQLAlchemy Async (Backend)
           ↕
PostgreSQL (Supabase) + Migraciones Alembic

Seguridad y Monitoreo

• Protección anti-bot: Cloudflare Turnstile en login y registro, validado server-side vía Supabase Auth
• Seguimiento de errores: Sentry en frontend y backend — trazado 100% de transacciones, session replay
• Analytics: Google Analytics 4 con banner de consentimiento de cookies (GDPR/CCPA)
• Rate limiting: SlowAPI en todos los endpoints de la API
• Autenticación: Supabase Auth (email/contraseña + validación JWT)

Stack Tecnológico

Capa	Tecnologías
Frontend	React 18, TypeScript, Vite, Tailwind CSS, Shadcn/UI, React Router v6, TanStack Query
Backend	FastAPI, SQLAlchemy (Async), Pydantic, python-jose, AsyncPG
Base de datos	PostgreSQL en Supabase, migraciones Alembic
Despliegue	Frontend en Vercel; Backend en Render.com