PetConnect247 — Multi-Country Pet Adoption Platform

PetConnect247 is a multilingual SaaS platform designed to connect people with pets in need of homes, veterinary services, temporary lodging, pet stores, and an active animal welfare community. Built in collaboration with Rafael Milla.

Platform Scope

• 5 countries: Spain, Portugal, Chile, Venezuela, USA
• 3 languages: Spanish, Portuguese, English
• 7 user roles: Administrator, User, Veterinarian, Caregiver, Hotel, Shelter, Store
• Currency support: EUR, CLP, USD with automatic regional price conversion
• 350+ translation keys covering the entire interface

Core Features

Adoption System

• Pet listings with filters by species, country, city, size, and gender
• Complete adoption workflow: application → shelter review → approval/rejection
• Detailed pet profiles with adoption request forms

Veterinary & Care Services

• Veterinary directory with specialty filters and 24/7 emergency flags
• Appointment booking with availability calendars and patient review system
• Individual caregiver and pet hotel listings with full reservation management

Lost & Found

• Hierarchical location filtering: country → region → city → neighborhood
• Real-time statistics: lost, found, reunited
• Public report form with photo uploads and contact information

Multi-Role Dashboards

• Role-specific dashboards for all 7 user types
• Shelter dashboard: pet CRUD, adoption request management
• Veterinarian dashboard: appointments, availability, patient records, reviews
• Admin panel: platform-wide statistics, user management

Technical Architecture

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

Security & Monitoring

• Anti-bot protection: Cloudflare Turnstile on login and registration, validated server-side via Supabase Auth
• Error tracking: Sentry in both frontend and backend — 100% transaction tracing, session replay
• Analytics: Google Analytics 4 with cookie consent banner (GDPR/CCPA)
• Rate limiting: SlowAPI on all API endpoints
• Authentication: Supabase Auth (email/password + JWT validation)

Technology Stack

Layer	Technologies
Frontend	React 18, TypeScript, Vite, Tailwind CSS, Shadcn/UI, React Router v6, TanStack Query
Backend	FastAPI, SQLAlchemy (Async), Pydantic, python-jose, AsyncPG
Database	PostgreSQL on Supabase, Alembic migrations
Deployment	Frontend on Vercel; Backend on Render.com