Fotos de Spotters

Ruta del backoffice: backoffice/spotters

Disponible para roles: Administrador del Sistema, Administrador; el Personal de Operaciones puede ver, editar y eliminar

Descripción General

La página de Fotos de Spotters es una interfaz de moderación para fotografías de aeronaves y aeropuertos enviadas por la comunidad. Los pilotos y miembros de la comunidad envían fotos, que entran en una cola de revisión. El personal revisa cada envío y lo aprueba (otorgando Puntos al cargador) o lo rechaza (con un motivo obligatorio). Esta función fomenta la participación de la comunidad y construye una biblioteca visual de la flota de su aerolínea.

Estados de la Foto

Cada foto enviada tiene uno de tres estados:

Estado	Descripción
PENDIENTE	La foto ha sido enviada y está esperando revisión del personal. Este es el estado inicial para todos los nuevos envíos.
APROBADA	La foto ha sido revisada y aceptada. Se otorgan Puntos al cargador tras la aprobación.
RECHAZADA	La foto ha sido revisada y rechazada. Se requiere un motivo de rechazo y es visible para el cargador.

Cuadrícula de Fotos y Filtrado

La vista principal muestra las fotos en una disposición de cuadrícula con botones de filtro por estado en la parte superior. El personal puede filtrar la cuadrícula para mostrar:

• Todas las fotos -- la colección completa independientemente del estado.
• Pendientes -- solo fotos esperando revisión (la cola principal de moderación).
• Aprobadas -- solo fotos que han sido aceptadas.
• Rechazadas -- solo fotos que han sido rechazadas.

Cada tarjeta de foto en la cuadrícula muestra:

• Imagen -- una miniatura de la foto enviada.
• Sujeto -- la aeronave o aeropuerto que la foto representa.
• Cargador -- el piloto o miembro de la comunidad que envió la foto.
• Fecha -- cuándo se envió la foto.
• Insignia de estado -- un indicador visual del estado actual (pendiente, aprobada, rechazada).

Acciones del Personal

Aprobar

Aprobar una foto la marca como aceptada y activa una recompensa en Puntos para el cargador:

• Recompensa estándar: El cargador recibe SPOTTER_PHOTO_POINTS por cada foto aprobada.
• Bonificación por primera foto: Si esta es la primera foto aprobada de esa aeronave específica, el cargador recibe una bonificación adicional de SPOTTER_FIRST_PHOTO_POINTS además de la recompensa estándar. Esto incentiva a los pilotos a fotografiar aeronaves que aún no han sido capturadas.

Los Puntos se registran como una transacción con el tipo spotter.

Rechazar

Rechazar una foto requiere que el personal proporcione un motivo explicando por qué la foto fue rechazada. Motivos comunes de rechazo incluyen:

• Baja calidad o resolución de imagen.
• Identificación incorrecta del sujeto.
• Duplicado de una foto aprobada existente.
• Contenido inapropiado o fuera de tema.
• Preocupaciones de derechos de autor o atribución.

El motivo de rechazo es visible para el cargador para que entienda por qué su envío no fue aceptado y pueda mejorar futuros envíos.

Eliminar

El personal puede eliminar permanentemente una foto del sistema. Esto elimina la imagen y todos los metadatos asociados. La eliminación se reserva típicamente para contenido inapropiado o envíos de spam.

Configuración de Puntos

Configuración	Descripción
SPOTTER_PHOTO_POINTS	Puntos otorgados al cargador por cada foto aprobada.
SPOTTER_FIRST_PHOTO_POINTS	Puntos adicionales de bonificación otorgados cuando la foto es la primera foto aprobada de una aeronave específica.

Ambos valores se configuran a nivel de aerolínea y se aplican uniformemente a todas las aprobaciones de fotos de spotters.

Crédito del Fotógrafo

Donde sea que se muestre una foto de spotter en el sistema (página de flota, página de reserva, página de briefing, panel principal), el nombre del fotógrafo se muestra como una pequeña superposición de crédito en la imagen (ej., "Foto por Juan"). Esto proporciona reconocimiento por las contribuciones de la comunidad.

Cuando la imagen mostrada es la foto propia cargada del modelo (no una foto de spotter), no se muestra crédito.

Endpoints de Galería de la API Pública

Las fotos de spotters aprobadas están disponibles a través de tres endpoints de la API pública. Estos pueden ser utilizados por sitios web externos, widgets o aplicaciones para mostrar la galería de fotos de la aerolínea.

Endpoint	Descripción
GET /api/public/gallery	Todas las fotos aprobadas de la aerolínea, las más recientes primero.
GET /api/public/data/airports/{id}/gallery	Fotos aprobadas de un aeropuerto específico.
GET /api/public/data/fleet/{id}/gallery	Fotos aprobadas de una aeronave específica.

Todos los endpoints de galería soportan paginación mediante los parámetros page y per_page (por defecto 20 elementos por página, máximo 50).

Cada foto en la respuesta incluye:

Campo	Descripción
id	ID de la foto
url	URL completa de la imagen
credit	Nombre del fotógrafo
subject_type	"aircraft" o "airport"
subject_id	ID del sujeto
subject_label	Matrícula de la aeronave o código ICAO del aeropuerto
created_at	Fecha de envío (ISO 8601)

Los endpoints de flota y vuelos en vivo también incluyen un campo picture_credit junto a picture_url, proporcionando el nombre del fotógrafo cuando la imagen mostrada es una foto de spotter.