Notificacoes

O sistema de notificacoes da plataforma AgrSis envia alertas por 3 canais diferentes, com controle granular tanto a nivel global (admin) quanto individual (usuario).

Canais de Envio

Tipos de Notificacao

O enum NotificationType define todos os tipos de notificacao organizados por contexto.

Notificacoes do Produtor

Notificacoes do Fornecedor

Notificacoes de Avaliacao e Entrega

Notificacoes de Assinatura e Pagamento

Notificacoes do Admin

Destinatario por Tipo

Alguns tipos de notificacao sao enviados para multiplos perfis. Os metodos isForProducer(), isForSupplier() e isForAdmin() no enum definem quais tipos se aplicam a cada perfil.

Notificacoes compartilhadas entre perfis:

• award_pending_confirmation, award_confirmed, award_declined, award_confirmation_expired, analysis_deadline_extended -- enviadas tanto para produtor quanto fornecedor e admin
• review_negotiation_available, review_negotiation_reminder, delivery_review_available, delivery_review_reminder -- enviadas para produtor e fornecedor
• order_in_analysis -- enviada para produtor e fornecedor

Configuracao Global (Admin)

O model NotificationChannelConfig (tabela notification_channel_config) permite ao admin habilitar ou desabilitar canais por tipo de notificacao.

Se um canal esta desabilitado globalmente, ele nao sera utilizado para nenhum usuario, independente das preferencias individuais.

Preferencias Individuais do Usuario

O model NotificationSetting (tabela notification_settings) armazena as preferencias de cada usuario por tipo de notificacao.

Valores padrao

Quando um usuario recebe uma notificacao de um tipo que ainda nao tem configuracao, o sistema cria automaticamente via getOrCreateDefault():

Metodos disponiveis

• shouldSendInApp() -- verifica se in-app esta habilitado
• shouldSendEmail() -- verifica se email esta habilitado
• shouldSendWhatsApp() -- verifica se WhatsApp esta habilitado
• getEnabledChannels() -- retorna array com canais habilitados
• toggleChannel(channel, enabled) -- altera um canal especifico

Fluxo de Envio

O NotificationService coordena o envio em todos os canais com a seguinte logica:

1. Verificar preferencia do usuario (NotificationSetting)
   └── Se in_app desabilitado → nao cria notificacao
2. Criar registro Notification (in-app)
3. Verificar configuracao global (NotificationChannelConfig)
4. Para cada canal habilitado globalmente:
   └── Verificar preferencia do usuario
       ├── Email habilitado? → enfileirar NotificationMail
       └── WhatsApp habilitado? → enfileirar SendWhatsAppNotificationJob

Idempotencia

Para evitar notificacoes duplicadas, o sistema verifica se ja existe uma notificacao com o mesmo type e proposal_uuid antes de criar. Essa verificacao e feita especificamente para PROPOSAL_RECEIVED.

Canal Email

O email e enviado via NotificationMail (Mailable que implementa ShouldQueue).

Estrutura do email

Resolucao de URLs

O NotificationService resolve URLs relativas para absolutas baseado no perfil do usuario:

Canal WhatsApp

O envio e feito via SendWhatsAppNotificationJob, um Job que implementa ShouldQueue.

Configuracao do Job

Anti-spam (Delay Incremental)

O NotificationService implementa um mecanismo anti-spam para evitar envio massivo de mensagens WhatsApp em um unico request:

private static int $whatsappDispatchCount = 0;

// Cada mensagem adiciona 3 segundos de delay
$delay = self::$whatsappDispatchCount * 3;
self::$whatsappDispatchCount++;

Exemplo pratico: ao publicar uma cotacao que notifica 10 fornecedores:

• Fornecedor 1: enviado imediatamente (delay 0s)
• Fornecedor 2: enviado apos 3s
• Fornecedor 3: enviado apos 6s
• ...
• Fornecedor 10: enviado apos 27s

O contador e estatico e se reseta a cada request HTTP. Isso evita que a Z-API bloqueie o numero por envio excessivo.

Notificacoes In-App

Operacoes disponiveis

Estrutura do registro (tabela notifications)

Cenarios de Notificacao

Publicacao de cotacao

Quando uma cotacao e publicada, o NotificationService::notifyOrderPublished() busca fornecedores dentro do raio de fornecimento usando calculo de distancia por coordenadas (formula de Haversine). Apenas fornecedores com:

• Endereco ativo com latitude/longitude
• Status ativo (supplier e user)
• Dentro do raio definido na cotacao

Proposta aceita

O notifyProposalAccepted() notifica:

1. O fornecedor vencedor com YOUR_PROPOSAL_ACCEPTED
2. Todos os outros fornecedores que enviaram proposta com YOUR_PROPOSAL_LOST

Cancelamento/Revogacao de cotacao

O notifyOrderStatusChangedForSuppliers() notifica todos os fornecedores participantes, incluindo motivo e observacoes quando disponveis.

Adjudicacao (Award)

O fluxo de adjudicacao gera multiplas notificacoes:

1. notifyAwardPendingConfirmation() -- notifica vencedor, produtor e demais participantes
2. notifyAwardConfirmed() -- notifica produtor, vencedor e demais (encerramento)
3. notifyAwardDeclined() -- notifica todos e reabre prazo de analise
4. notifyAwardConfirmationExpired() -- notifica todos sobre expiracao do prazo