Mensageria staff ↔ jogador

TL;DR

Mensageria interna bidirecional entre staff e jogador, com uma thread por jogador. O staff escreve a partir do perfil do jogador, o jogador a partir de seu portal. Cada mensagem do staff dispara automaticamente uma push notification ao celular do jogador. Badge de não-lidos do lado staff conta as mensagens entrantes pendentes.

Para comercial

• Problema que resolve: hoje o staff e os jogadores se comunicam por WhatsApp / SMS, sem rastreabilidade, misturado com vida privada, e sem controle da org sobre o canal. O CÉNIT centraliza essa thread dentro do app, com push notifications nativas, e deixa o histórico auditável.
• Casos de uso típicos:
  • Avisar o jogador sobre mudança de horário ou agendamento com o médico.
  • Jogador reporta dor ao PF sem ter que ligar.
  • HoP responde a uma dúvida do jogador sobre o planejamento.
• Planos que incluem: todos os planos.
• Diferencial: integração nativa com PWA + push web (não requer app store), tudo dentro do sistema multi-tenant com isolamento por organização — um staff de Org A não pode mandar mensagens a jogadores de Org B (validado no servidor).

Como a comissão técnica usa

Acesso e permissões

• Quem pode ver threads: todos os staff que têm acesso ao perfil do jogador (depende da configuração de abas visíveis da org e do papel). Na prática HoP e Diretor Esportivo têm acesso garantido; fisio, médico, nutri e psi o têm se a aba está habilitada.
• Quem recebe mensagens do jogador: se o jogador envia sem destinatário explícito, o sistema atribui ao primeiro HoP ou Diretor Esportivo da org.
• Segurança cross-tenant: o servidor valida que o jogador destino pertence à org do caller em cada envio.

Fluxos passo a passo

Lado staff:

1. Abrir perfil do jogador → aba Mensagens.
2. Ver thread com mensagens ordenadas, badge de não-lidos acima contando mensagens pendentes do jogador.
3. Escrever e enviar.
4. Automaticamente: o sistema dispara uma push notification ao jogador. Falha silenciosamente se o jogador não está inscrito ao push.

Lado jogador:

1. Push notification chega ao celular (se tem o PWA instalado e inscrição ativa).
2. Tap abre a tela de mensagens no portal do jogador.
3. O jogador responde — a mensagem fica atribuída ao primeiro HoP ou Diretor Esportivo.

Configuração relacionada

• Push notifications requerem que o cliente CÉNIT tenha configuradas as chaves VAPID para web push.
• Inscrição push do jogador: dá-se alta a partir do portal do jogador com o botão “Ativar notificações”.

FAQ / casos-limite

• “O jogador não recebe o push” — verificar que: 1) tenha o PWA instalado, 2) tenha concedido permissão de notificações, 3) tenha tocado em “Ativar notificações” em seu portal.
• “Endpoint expirado” — se o navegador do jogador invalidou a inscrição, o sistema limpa o endpoint automaticamente.
• “Mensagem vazia rejeitada” — o conteúdo não pode estar vazio nem superar os 2000 caracteres.
• “Mensagem cruzada entre orgs” — bloqueado no servidor: se o jogador destino não pertence à org do caller, o envio é rejeitado.
• “Impersonation em só leitura não envia” — durante uma impersonação de superadmin em modo só leitura, os envios ficam bloqueados.

Como o jogador vê

Player surface: SIM. É um dos poucos módulos com superfície de jogador.

• Tela: thread simples no portal do jogador, input de texto, history scroll.
• Push notifications: automáticas em cada mensagem do staff. Título: “Mensagem de [nome do staff]”. Body: primeiros 80 caracteres da mensagem.
• Badge: o portal do jogador pode mostrar badge de não-lidos.
• Sem email: a mensageria não envia email; apenas push + in-app.

Integrações

• PWA / Service Worker — o service worker lida com o evento push e mostra a notificação nativa.
• Elenco — a aba Mensagens é renderizada a partir do perfil do jogador.
• Impersonation — os envios ficam bloqueados durante impersonação em modo só leitura.

Limitações

• Sem attachments — apenas texto plano até 2000 caracteres.
• Sem grupo / broadcast — não se pode mandar a mesma mensagem a N jogadores em um único envio.
• Auto-atribuição a HoP / Diretor Esportivo: quando o jogador escreve, o destinatário é o primeiro HoP ou Diretor Esportivo encontrado. Não há UI para que o jogador escolha a quem escrever.
• Sem “lido por staff” — o sistema marca lido do lado staff quando lê mensagens do jogador. A inversa (jogador leu mensagem do staff) não está implementada.
• Sem retenção nem arquivamento — as threads crescem sem limite.