Fotos de Spotters

Caminho no backoffice: backoffice/spotters

Disponível para funções: Administrador do Sistema, Administrador; Equipe de Operações pode visualizar, editar e excluir

Visão Geral

A página de Fotos de Spotters é uma interface de moderação para fotografias de aeronaves e aeroportos enviadas pela comunidade. Pilotos e membros da comunidade enviam fotos, que entram em uma fila de revisão. A equipe revisa cada envio e o aprova (concedendo Pontos ao remetente) ou rejeita (com um motivo obrigatório). Este recurso incentiva o engajamento da comunidade e constrói uma biblioteca visual da frota da sua companhia aérea.

Status das Fotos

Cada foto enviada possui um de três status:

Status	Descrição
PENDENTE	A foto foi enviada e aguarda revisão da equipe. Este é o status inicial para todos os novos envios.
APROVADA	A foto foi revisada e aceita. Pontos são concedidos ao remetente na aprovação.
REJEITADA	A foto foi revisada e recusada. Um motivo de rejeição é obrigatório e visível ao remetente.

Grade de Fotos e Filtragem

A visualização principal exibe fotos em um layout de grade com botões de filtro de status no topo. A equipe pode filtrar a grade para mostrar:

• Todas as fotos -- a coleção completa independentemente do status.
• Pendentes -- apenas fotos aguardando revisão (a fila principal de moderação).
• Aprovadas -- apenas fotos que foram aceitas.
• Rejeitadas -- apenas fotos que foram recusadas.

Cada cartão de foto na grade mostra:

• Imagem -- uma miniatura da foto enviada.
• Assunto -- a aeronave ou aeroporto que a foto retrata.
• Remetente -- o piloto ou membro da comunidade que enviou a foto.
• Data/Hora -- quando a foto foi enviada.
• Selo de status -- um indicador visual do status atual (pendente, aprovada, rejeitada).

Ações da Equipe

Aprovar

Aprovar uma foto a marca como aceita e dispara uma recompensa em Pontos para o remetente:

• Recompensa padrão: O remetente recebe SPOTTER_PHOTO_POINTS para cada foto aprovada.
• Bônus de primeira foto: Se esta é a primeira foto aprovada daquela aeronave específica, o remetente recebe um bônus adicional de SPOTTER_FIRST_PHOTO_POINTS além da recompensa padrão. Isso incentiva pilotos a fotografar aeronaves que ainda não foram capturadas.

Pontos são registrados como uma transação com o tipo spotter.

Rejeitar

Rejeitar uma foto requer que a equipe forneça um motivo explicando por que a foto foi recusada. Motivos comuns de rejeição incluem:

• Baixa qualidade ou resolução de imagem.
• Identificação incorreta do assunto.
• Duplicata de uma foto aprovada existente.
• Conteúdo inapropriado ou fora do tema.
• Preocupações de direitos autorais ou atribuição.

O motivo de rejeição é visível ao remetente para que ele entenda por que seu envio não foi aceito e possa melhorar envios futuros.

Excluir

A equipe pode excluir permanentemente uma foto do sistema. Isso remove a imagem e todos os metadados associados. A exclusão é tipicamente reservada para conteúdo inapropriado ou envios de spam.

Configuração de Pontos

Configuração	Descrição
SPOTTER_PHOTO_POINTS	Pontos concedidos ao remetente para cada foto aprovada.
SPOTTER_FIRST_PHOTO_POINTS	Pontos de bônus adicionais concedidos quando a foto é a primeira foto aprovada de uma aeronave específica.

Ambos os valores são configurados no nível da companhia aérea e se aplicam uniformemente a todas as aprovações de fotos de spotters.

Crédito do Fotógrafo

Onde quer que uma foto de spotter seja exibida no sistema (página de frota, página de reserva, página de briefing, painel principal), o primeiro nome do fotógrafo é mostrado como uma pequena sobreposição de crédito na imagem (ex.: "Foto por João"). Isso proporciona reconhecimento pelas contribuições da comunidade.

Quando a imagem exibida é a foto própria carregada do modelo (não uma foto de spotter), nenhum crédito é mostrado.

Endpoints de Galeria da API Pública

As fotos de spotters aprovadas estão disponíveis através de três endpoints da API pública. Estes podem ser utilizados por sites externos, widgets ou aplicações para exibir a galeria de fotos da companhia aérea.

Endpoint	Descrição
GET /api/public/gallery	Todas as fotos aprovadas da companhia aérea, as mais recentes primeiro.
GET /api/public/data/airports/{id}/gallery	Fotos aprovadas de um aeroporto específico.
GET /api/public/data/fleet/{id}/gallery	Fotos aprovadas de uma aeronave específica.

Todos os endpoints de galeria suportam paginação através dos parâmetros page e per_page (padrão 20 itens por página, máximo 50).

Cada foto na resposta inclui:

Campo	Descrição
id	ID da foto
url	URL completa da imagem
credit	Primeiro nome do fotógrafo
subject_type	"aircraft" ou "airport"
subject_id	ID do assunto
subject_label	Matrícula da aeronave ou código ICAO do aeroporto
created_at	Data de envio (ISO 8601)

Os endpoints de frota e voos ao vivo também incluem um campo picture_credit junto a picture_url, fornecendo o primeiro nome do fotógrafo quando a imagem exibida é uma foto de spotter.