módulo de parceiros/conveniados

gistfile1.txt

Resumo des recursos desenvolvidos no módulo de parceiros/conveniados:

Cadastro ampliado de parceiros/conveniados com nome fantasia, categoria, percentual de desconto, descrição do benefício, endereço completo, telefone, WhatsApp, site, logo, status, datas de vigência, observações, código interno, código público e CAPT/código da loja.

Novas rotas administrativas para gestão completa de convênios:
GET /convenios, POST /convenios, GET /convenios/:id, PUT /convenios/:id, DELETE /convenios/:id, além do alias REST /partners.

Listagem pública de convênios por tenant:
GET /convenios/public?tenant_id=...

Portal do filiado melhorado para consulta de parceiros, com filtros por nome, categoria, cidade e bairro.

Exibição mais completa dos parceiros no portal, incluindo logo, nome fantasia, desconto, telefone/WhatsApp, site, localização e link “Como chegar”.

Geolocalização opcional no portal: o filiado pode buscar parceiros próximos, visualizar distância estimada e ordenar os convênios por proximidade.

Validação pública de carteirinha por QR seguro usando URL /validate/:token, sem expor CPF, nome, tenant_id ou affiliate_id.

Criação de token opaco validation_token para carteirinhas, mantendo compatibilidade com QR Codes antigos.

Página pública de validação sem login em /validate/:token.

APIs públicas de validação:
GET /validate/:token e POST /validate.

Registro enriquecido das validações em partner_validations, incluindo parceiro, benefício, filiado/dependente, resultado, código informado, token, IP, user-agent, navegador, sistema operacional, dispositivo, geolocalização opcional e tempo da operação.

Proteções antifraude na validação pública, com bloqueio de muitas tentativas inválidas por token/IP e bloqueio de reutilização excessiva do mesmo token no mesmo parceiro.

Relatório de uso da carteirinha expandido com períodos day, week, month, quarter e year.

Indicadores gerenciais para convênios: total de validações, parceiros com uso, filiados únicos atendidos e percentual da base ativa utilizando convênios.

Rankings e agrupamentos por parceiro, parceiros menos utilizados, período, categoria, cidade, filiado e dependente.

Alertas gerenciais para uso excessivo e tentativas inválidas.