# huelllla

> Plataforma ciudadana y gratuita para encontrar animales perdidos en España.

huelllla conecta a familias que han perdido a un compañero animal con voluntarios y protectoras en tiempo real mediante alertas geolocalizadas, mapa interactivo, matching automático y difusión automática en redes sociales. Activa en toda España.

## Qué hace huelllla

- Permite publicar alertas de animales perdidos con foto, ubicación geolocalizada y descripción
- Notifica automáticamente a los voluntarios y protectoras cercanos a la última ubicación del animal (por radio de distancia y por provincia) para que se movilicen al instante
- Difunde automáticamente cada alerta en redes sociales (Telegram, con grupos por provincia, y Bluesky) y la comparte en los perfiles del proyecto en Instagram y X, multiplicando el alcance más allá de la web
- Muestra un mapa interactivo con alertas activas, avistamientos y protectoras
- Aplica matching automático entre animales perdidos y animales encontrados (por especie, cercanía geográfica y fechas)
- Centraliza reportes de redes sociales sobre animales perdidos
- Ofrece un directorio de protectoras y refugios en España
- Proporciona un tablón comunitario donde voluntarios ofrecen ayuda y familias piden apoyo

## Cobertura y características

- Cobertura en las 52 provincias de España, con páginas propias por comunidad, provincia y ciudad (incluidas Ceuta y Melilla)
- Servicio 100% gratuito y sin ánimo de lucro, sin publicidad
- Publicación de una alerta en menos de dos minutos, sin coste
- Matching automático entre animales perdidos y animales encontrados
- Alertas geolocalizadas: notificación automática a los voluntarios en un radio de distancia configurable y a las protectoras cercanas, además de grupos de Telegram por provincia
- Difusión automática de cada alerta en Telegram y Bluesky, y compartida en los perfiles del proyecto en Instagram y X — una alerta llega a mucha más gente que un simple post
- Mapa interactivo en tiempo real de alertas, avistamientos y protectoras

## Quién puede usar huelllla

- Familias que han perdido a un compañero animal
- Voluntarios que quieren ayudar en búsquedas cerca de su zona
- Protectoras y asociaciones animalistas que quieren coordinarse con la red ciudadana
- Cualquier persona que encuentre un animal perdido en la calle

## Valores del proyecto

huelllla parte de una perspectiva antiespecista: los animales no humanos son sujetos, no objetos. El proyecto usa lenguaje no propietario (familiar, compañero animal) y trata el reencuentro como una cuestión de justicia, no solo de utilidad.

## Páginas principales

- [Inicio](https://huelllla.org/): Página principal con mapa y acceso a las funciones principales
- [Cómo funciona](https://huelllla.org/como-funciona/): Explicación paso a paso de cómo funciona la plataforma
- [Animales perdidos](https://huelllla.org/animales-perdidos/): Listado de alertas activas de animales perdidos
- [Animales perdidos por comunidad](https://huelllla.org/animales-perdidos/andalucia/): Páginas por comunidad autónoma (ejemplo: Andalucía)
- [Animales perdidos por provincia](https://huelllla.org/animales-perdidos/provincia/sevilla/): Páginas por provincia (ejemplo: Sevilla)
- [Animales perdidos por ciudad](https://huelllla.org/animales-perdidos/ciudad/madrid/): Páginas por ciudad, incluidas Ceuta y Melilla (ejemplo: Madrid)
- [Mapa](https://huelllla.org/mapa/): Mapa interactivo con alertas, avistamientos y protectoras
- [Encontrados](https://huelllla.org/encontrados/): Animales encontrados que aún no han sido reclamados
- [Animales reunidos](https://huelllla.org/animales-reunidos/): Animales que ya se han reencontrado con su familia
- [Animales avistados](https://huelllla.org/animales-avistados/): Avistamientos reportados por la comunidad
- [Vistos en redes sociales](https://huelllla.org/animales-en-redes-sociales/): Reportes de redes sociales centralizados
- [Buscan familia](https://huelllla.org/buscan-familia/): Animales en adopción que buscan una familia
- [Protectoras](https://huelllla.org/protectoras/): Directorio de protectoras y asociaciones en España
- [Tablón](https://huelllla.org/tablon/): Tablón comunitario de ayuda
- [Primeras 24 horas](https://huelllla.org/primeras-24h/): Guía de qué hacer en las primeras 24 horas tras la pérdida
- [Emergencias](https://huelllla.org/emergencias/): Teléfonos y recursos de emergencia por comunidad autónoma
- [Quiero ayudar](https://huelllla.org/quiero-ayudar/): Registro como voluntario

## Tecnología

Backend Django (Python), base de datos PostgreSQL en producción, mapas con Leaflet.js y OpenStreetMap, autenticación con magic links y Google OAuth, notificaciones push con Web Push API, geolocalización de alertas con notificación por radio de distancia, matching automático perdido-encontrado, y difusión automática de alertas a redes sociales mediante bots de Telegram (grupos por provincia) y Bluesky.

## Contacto y más información

- [Web oficial](https://huelllla.org): huelllla.org
- [Instagram](https://www.instagram.com/huelllla_org): @huelllla_org
- [X (Twitter)](https://x.com/huelllla): @huelllla
- [Bluesky](https://bsky.app/profile/huelllla.bsky.social): @huelllla.bsky.social