Scan de placa QR → perfil público + push con cooldown

petid-landingpetid-apipetid-client
actualizado 2026-09-02

Objetivo

Quien encuentra una mascota escanea el QR de la placa y ve info de contacto — sin necesitar login — mientras el dueño recibe un aviso, sin que escaneos repetidos lo saturen de notificaciones.

Cómo empieza

GET público en petid-landing a la página del código de la placa (sin JWT).

Pasos principales

La página llama a GetPublicPetProfileUseCase.execute(publicCode) en petid-api (sin autenticación, ruta pública).
Busca el PetTag por publicCode, luego la mascota, el owner, su Profile, Settings y Tenant — todo en paralelo.
Arma el perfil: email solo si settings.showEmail, phone solo si settings.showPhone (toggles de “mascota perdida” en Settings del owner).
Si hay owner y tag.canNotify(now) es true → marca lastNotifiedAt = now y emite PetTagScannedEvent (push al owner).

Reglas de negocio

Cooldown de 10 minutos (NOTIFY_COOLDOWN_MS, pet-tag.entity.ts): canNotify() compara now - lastNotifiedAt. Sin lastNotifiedAt (primer scan) siempre notifica. El perfil se sigue mostrando en cada scan — lo que se throttlea es solo el push, no la visibilidad del perfil.
La visibilidad de contacto es por-mascota-vía-owner, no por-tag: es el Settings del dueño, no algo configurable por placa individual.

Interacciones

petid-landing → petid-api (GetPublicPetProfileUseCase) → evento → petid-api/notification-api → push a petid-client.

Dónde seguir mirando

petid-api/src/domain/pet-tags/pet-tag.entity.ts (canNotify)
petid-api/src/application/pet-tags/get-public-pet-profile.use-case.ts
Settings toggles: petid-client settings.tsx sección “Mascota perdida” (showEmail/showPhone)

Casos especiales

El endpoint es público — no hay guard, cualquiera con el código puede consultarlo. La única protección de datos sensibles es el toggle de visibilidad, no autenticación.
Un scan mientras el cooldown está activo sigue devolviendo el perfil normalmente — el usuario que escaneó nunca sabe si se avisó o no al dueño.