🚀 Release Notes

Novidades do Sistema

Histórico completo de versões, funcionalidades e melhorias do eMerchan

Versão Atual

v1.4.21+221 → v1.4.52  |  Março–Abril 2026

eMerchan v1.4.52

Vales / Adiantamentos (novo módulo completo), Sistema de Comunicados com segmentação e push, Validação GPS para liderança, Reembolso como módulo independente, EPI Almoxarifado melhorado, Promotores x Agências (Varejo) com novo layout, Controle de EPI, Menu Personalizável, ZapSign, Módulo Seguros e muito mais.

Ver novas features ↓

Novas Features

Funcionalidades de destaque — Março/Abril 2026

💰

Vales / Adiantamentos

novo

Novo módulo completo para gestão de vales e adiantamentos. RH cria, edita e gerencia vales com filtro por status, busca de promotor com autocomplete (suporta 400+ funcionários), cards resumo com quantidade e valor total, e filtro por período. Promotores consultam seus vales na tela “Meus Vales”. Integrado ao Financeiro — nova coluna “Vales” em Contas a Pagar com total pendente por promotor.

Ver documentação →
🔔

Sistema de Comunicados

novo

Avisos segmentados no app: painel admin com CRUD completo, segmentação por nível de acesso e agência, 3 modos de exibição (Overlay, Banner), 3 tipos visuais (Novidade, Aviso, Urgente), período configurável e link de ação opcional. Notificação push automática ao entregar EPI.

📍

Validação GPS para Liderança

novo

Foto de tarefa agora exige proximidade de 400m do estabelecimento para Gerentes, Supervisores e Líderes. Check-in/check-out automático vinculado à O.S., com marca d’água da posição real e cálculo de distância OSRM.

💳

Reembolso

melhorado

Novo módulo independente dentro do menu Operações: Combustível, Pedágio, Alimentação, Estacionamento e Outros. Campo valor com máscara de moeda R$.

🏛

Promotores x Agências (Varejo)

melhorado

Novo layout com abas “Por O.S.” e “Por Cadastro”. Identifica promotores com cadastro ativo em 2+ agências, mostra marcas, lojas e dia da semana. Export CSV, cache 24h, filtros compactos com date range picker.

🩺

Controle de EPI

novo

Novo módulo para gestão de EPIs integrado ao RH, com dashboard visual, controle de estoque, entregas por funcionário, recolhimento de inativos e compra rápida por agência.

🟢 Dashboard com Semáforo Verde para EPIs em dia, amarelo para itens vencendo em menos de 1 mês e vermelho para vencidos, ausentes ou inativos
📦 Estoque Central e por Líder Entradas, saídas, transferências e saldo calculado automaticamente por item
📝 Entrega e Histórico Entrega multi-item com origem central ou líder, registro no perfil do promotor e preenchimento legado
🔔 Alertas e Notificações Troca por vida útil, recolhimento de inativos, estoque baixo e acompanhamento das pendências em notificações

Menu: RH > Controle de EPI  •  Nível: RH  •  Versão: v1.4.52

Menu Personalizado por Usuário

novo

Cada usuário pode reorganizar os itens do menu por drag and drop, com preferências salvas por usuário e por ambiente (Agências / Redes).

🔀 Drag and Drop Reordene os itens principais do menu arrastando para a posição desejada
📂 Subitens por Grupo Modal de organização para reordenar subitens dentro de cada grupo do menu
🌐 Ambientes Separados Preferências independentes para Agências e Redes de Varejo
💾 Cache Local SharedPreferences para abrir rápido com fallback automático para a ordem padrão do sistema
❘ Separadores Customizáveis Separadores viraram itens reais: criar, arrastar, alternar entre sutil/forte e remover. Dashboard fixo no topo; Versão e Logout fixos no rodapé

Menu: Configurações > Organizar Menu  •  Versões: v1.4.25+225 e v1.4.35+235

ZapSign — Assinatura Digital

novo

Documentos de usuários e clientes podem ser enviados para assinatura digital via ZapSign. O signatário recebe um e-mail com link para assinar, e o status é atualizado automaticamente via webhook.

🔐 Config por Agência Token seguro em subcollection, suporte sandbox e produção, envio por email e/ou WhatsApp
📄 Envio de Documentos Botão “Enviar p/ Assinatura” nos documentos de usuários e clientes (indústrias)
🔔 Webhooks Automáticos 3 endpoints separados (assinado, recusado, lido) — status atualizado em tempo real
🏷 Badges de Status Cinza (pendente), laranja (aberto), verde (assinado), vermelho (recusado) nos documentos
🔔 Notificação Automática Ao enviar para assinatura, cria notificação de leitura para o usuário automaticamente
✅ Verificação pela Rede Badge “Assinado Digitalmente” read-only + link para PDF assinado na verificação

Menu: Configurações da Agência > ZapSign  •  Versões: v1.4.31+231 e v1.4.33+233

🛡

Módulo Seguros — Parceria com Seguradora

novo

Funcionários podem solicitar seguro pessoal (vida) ou veicular (carro/moto) diretamente pelo app. Admin gerencia propostas, acompanha status e controla vencimentos.

👤 Solicitação pelo Funcionário Formulário com dados pessoais e do veículo, acompanhamento de status pelo app
💼 Gestão Admin (RH+) Dialog fullscreen com edição de status, seguradora, valor, datas e observações
📅 Controle de Vencimento Badge “Vencendo em X dias” quando cobertura < 30 dias
⚙ Ativação por Agência Flag segurosAtivo nas Configurações — menu aparece apenas quando habilitado

Menu: Seguros (admin) / Meu Seguro (funcionário)  •  Versões: v1.4.32+232 e v1.4.33+233

📋

Notas Fiscais de Promotores

novo

Promotores CLT/Free com CNPJ podem enviar notas fiscais pelo app. O Financeiro recebe, altera status e anexa comprovante de pagamento.

📥 Envio pelo Promotor Arquivo, valor descrito e período de trabalho — menu “Minhas N.F.” (só quando CPF contém CNPJ)
💰 Gestão Financeiro Filtro por período/status, alteração de status (Enviado → Recebido → Pago) e upload de comprovante

Versão: v1.4.32+232

📊

Relatórios para Redes de Varejo

novo

Duas novas páginas de relatório no menu Redes: Relatório de Visitas (check-ins) e Relatório O.S. (ordens de serviço), com filtros avançados e modal de detalhes.

👤 Relatório de Visitas Cards com hora de check-in/check-out, fotos e status da O.S., filtros por rede, estabelecimento e promotor
📋 Relatório O.S. Cruzamento com check-ins, modal de detalhes com serviços e fotos, filtros por rede, promotor e cliente

Menu: Redes de Varejo > Relatório de Visitas / Relatório O.S.  •  Versão: v1.4.30+230

🔔

Notificações de Documentos

novo

Botão de sininho na seção de documentos do usuário para enviar notificação direta. Suporte a tipos Leitura, Resposta Obrigatória e Bloqueante.

📣 Dialog Completo Seleção de tipo, documento opcional, título e mensagem editáveis, dica visual com destaque vermelho para bloqueante

Versão: v1.4.34+234

👥

Gestão de Parceiros — Redes de Varejo

novo

As redes de varejo agora gerenciam a documentação e o status das agências parceiras diretamente pelo painel. O totem bloqueia automaticamente promotores de agências com status irregular.

👤 Usuários dos Parceiros Nova página no menu Redes: seleção de agência, listagem com busca por nome, CPF ou e-mail
📋 Verificação de Documentos Modal com docs compartilhados vs. particulares, label descritivo e badge "Atualizado DD/MM"
🔒 Status por Parceiro Autorizado (verde), Atenção (amarelo), Bloqueado (vermelho), Pendente (azul — automático)
🚫 Bloqueio no Totem Parceiro bloqueado = modal obrigatório sem opção de continuar. Atenção = aviso com opção de prosseguir
🔔 Notificação Automática Push FCM para a agência ao alterar status. Leitura obrigatória para nível Suporte+
📊 Cards de Resumo Totais na página Redes (agregado) e no Dashboard da Agência (por rede), incluindo totalPendentes
🔄 Auto-Pendente Ao atualizar docs com status bloqueado/atenção, status muda automaticamente para "Pendente"
🚩 Badge no Check-In Manual Status do parceiro visível (informativo) na tela de detalhes e check-in/check-out pelo encarregado

Menu: Redes > Usuários dos Parceiros  •  Versões: v1.4.27+227 e v1.4.28+228

🤝

Coligadas — Compartilhamento de Atendimentos

novo exclusivo eMerchan

Duas empresas se conectam e passam a compartilhar atendimentos. O vínculo é feito por um código seguro — uma empresa presta o serviço, a outra paga. Agendamentos, Ordens de Serviço e dashboards de BI ficam automaticamente integrados entre as duas empresas.

1
Gerar Código
2
Enviar à Parceira
3
Vincular
4
Criar Contratos
🔑 Código de Vínculo Código XXXX-XXXX válido por 72h, uso único — seguro e rastreável
📄 Contrato com Coligada Dropdown na criação de contrato — quem cria presta o serviço, a coligada paga
🔄 Propagação Automática Dados da coligada (ID, nome, CNPJ) propagados do contrato → agendamento → O.S. → BigQuery
📊 BI Integrado 3 colunas novas no BigQuery (fato_os e fato_agendamento) — relatórios filtráveis por coligada
🔒 Imutável Coligada definida na criação do contrato, não pode ser alterada depois — garante integridade
✅ Gestão de Parcerias Lista de coligadas com status ativa/inativa, desativação a qualquer momento
Tela de Coligadas - Gerar código de vínculo e lista de parcerias ativas

Menu: Roteiro Planejamento > Coligadas  •  Sem coligada = serviço próprio (comportamento normal)

Ver treinamento completo →
💬

Grupos WhatsApp V2

novo

Nova página de gestão de grupos WhatsApp com DataTable unificada, filter chips com contadores, seletor de grupo via modal e dialog de configurações centralizado.

📚 Tabela Unificada Cliente, Contrato, Grupo WPP e Configurações em uma única visão com scroll horizontal
🏷 Filter Chips Todos / Sem grupo / Com grupo — clicáveis com contadores
⚙ Dialog de Configurações Switches, dropdown de dia fixo e envio de mensagem de teste direto pelo dialog
📦

Import CSV Padronizado

novo

Importação em massa de Indústrias, Usuários e Estabelecimentos via CSV com auto-detecção de header, validação completa e import em lote via WriteBatch.

🔍 Auto-Detecção Detecta delimitador (;/,/tab), mapeia colunas por header com aliases normalizados
✅ Validação Completa Campos obrigatórios, duplicatas no CSV e na base, nível e setor (usuários)
📥 Export & Modelos Export da base atual, export de divergências e download de modelo .xlsx
📷

Ocultar Foto por Tarefa

novo

Permite que o promotor conclua uma tarefa sem enviar foto quando não for adequado fotografar o produto. A tarefa fica marcada como concluída com flag de foto ocultada.

Regra: a opção não aparece em tarefas com texto “antes” ou “pós” (fotos de antes/depois continuam obrigatórias).

Últimas Atualizações

Builds v1.4.21 → v1.4.52  |  04/03 → 04/04/2026

v1.4.52
04/04/2026
  • Vales / Adiantamentos — novo módulo: RH com CRUD completo, filtro por status, busca com autocomplete (400+ funcionários), cards resumo, filtro por período, máscara R$novo
  • Meus Vales — tela read-only para promotores consultarem histórico pessoalnovo
  • Financeiro A Pagar — nova coluna “Vales” com total pendente por promotormelhorado
v1.4.51
01/04/2026
  • Contratos — fix switch de desativação travado; ao selecionar nova data, reativa o estabelecimentofix
  • Consolidada — O.S. canceladas removidas de toda a tela, separadas em lista própria com export Excelmelhorado
  • O.S. Suporte — pesquisas abrem em modo promotor; pode concluir O.S. com pesquisas pendentesfix
  • Faltas Promotores — botão Exportar Excel (promotor, setor, qtd O.S., datas)novo
  • Promotores x Agências (Varejo) — novo layout com abas “Por O.S.” e “Por Cadastro”, identifica promotores em 2+ agências, export CSVnovo
v1.4.50
31/03/2026
  • EPI Almoxarifado — fix dropdown Item vazio, layout Estoque Baixo com barra de progresso visual e ícones por gravidadefix
  • EPI Entrega — nova seção “Forma de entrega” (Em mãos / Correios / Mercado Livre) com date pickernovo
  • Reembolso — campo valor com máscara de moeda PT-BR (R$)melhorado
  • Totem Check-In — fix seleção de agência e visitas duplicadasfix
v1.4.49
30/03/2026
  • Validação GPS Liderança — foto de tarefa exige proximidade de 400m, marca d’água com posição realnovo
  • Parada automática vinculada à O.S. — check-in/check-out automático com foto e distância OSRMnovo
  • Menu Operações — novo submenu: Check-In, Almoço/Intervalo, Check-Out, Paradas, Reembolso, Históricomelhorado
  • Extrato Financeiro — restrito a nível ≤ Financeirofix
v1.4.48
29/03/2026
  • Sistema de Comunicados — painel admin, segmentação por nível e agência, 3 modos (Overlay/Banner), 3 tipos (Novidade/Aviso/Urgente), período configurável, link de açãonovo
  • Push EPI — notificação automática ao entregar EPI para promotornovo
v1.4.47
29/03/2026
  • Controle de EPI — novo módulo com dashboard por semáforo, filtros por status, seção de inativos com recolhimento pendente e botão “Já recolhido”novo
  • Catálogo e estoque de EPIs — cadastro de itens por categoria, tamanhos disponíveis, vida útil, estoque mínimo, estoque central e transferências para líderesnovo
  • Entrega, legado e recompra — entregas multi-item com histórico no promotor, preenchimento de EPIs anteriores ao sistema e link de compra configurado por agêncianovo
  • Alertas e notificações — avisos de troca por vida útil, estoque baixo e recolhimento de inativos registrados em notificaçõesnovo
v1.4.35+235
13/03/2026
  • Menu Personalizado por Usuário — nova página “Organizar Menu” em Configurações, reordenação por drag and drop dos itens principais e subitens, preferências por ambiente (Agências/Redes), persistência por usuário/agência, cache local com fallback para ordem padrãonovo
v1.4.34+234
13/03/2026
  • Notificações de Documentos — botão sininho na seção de documentos do usuário, dialog com tipo (Leitura / Resposta Obrigatória / Bloqueante), documento opcional, título e mensagem editáveisnovo
  • Notificação automática ZapSign — ao enviar documento para assinatura digital, cria notificação de leitura automaticamentenovo
  • Layout Observações e Documentos — headers com ícone + título + badge de contagem + botão “Adicionar” alinhado à direita, seções separadas por Dividermelhorado
v1.4.33+233
13/03/2026
  • Seguros — melhorias de gestão e UX — dialog fullscreen para admin, edição completa do solicitante, suporte a modo edição, dark theme com cores compatíveismelhorado
  • ZapSign para Clientes (Indústrias) — DocumentosModel estendido, widget DocumentosAnexos com flag do Firestore, badge e botão de assinaturanovo
  • Documentos Anexos — novo layout — FilterChips por categoria (Todos/Particulares/Compartilhados) com contadores, busca (5+ docs), cards com ícone arredondado e badgemelhorado
v1.4.32+232
13/03/2026
  • Notas Fiscais de Promotores — nova coleção notasFiscaisPromotor, menu “Minhas N.F.” para promotores com CNPJ, envio com arquivo/valor/período, gestão pelo Financeironovo
  • Módulo Seguros — SeguroModel (vida + veicular), página admin com filtros e gestão, página funcionário para solicitar e acompanhar, flag segurosAtivo, controle de vencimentonovo
  • Categoria de documento renomeada — “Compartilhado com Convênios” → “Compartilhado com Redes Varejos Parceiras”melhorado
  • Notificações — gerenciamento protegido contra carga antes de auth/empresa selecionadafix
v1.4.31+231
13/03/2026
  • Integração ZapSign — Assinatura Digital — Cloud Functions para envio + 3 webhooks, config por agência (token seguro, sandbox/produção), service Flutter, badges de status, toggle nas configuraçõesnovo
  • Documentação ZapSign na Verificação (Redes) — badge “Assinado Digitalmente” read-only + link para PDF assinadonovo
v1.4.30+230
13/03/2026
  • Relatório de Visitas (Redes) — nova página com filtros por rede, estabelecimento, promotor e status, cards com hora de check-in/check-out e fotosnovo
  • Relatório O.S. (Redes) — cruzamento com check-ins, modal de detalhes com serviços e fotos, filtros por rede, promotor, cliente e statusnovo
  • Menu Redes de Varejo agrupado — Documentações + Relatório de Visitas + Relatório O.S. no footermelhorado
v1.4.29+229
13/03/2026
  • Check-In com Agendamento sem Roteirização — promotores com agendamento ativo mas sem O.S. roteirizada aparecem no checkin manual e totem, O.S. real gerada no momento do checkinnovo
  • Verificação de Status do Parceiro no Totem — consulta statusParceiro do Firestore, bloqueio sem opção de continuar, atenção/pendente com opção de prosseguirnovo
  • Badge status parceiro no Check-In Manual — puramente informativo, encarregado pode liberar manualmentemelhorado
v1.4.28+228
12/03/2026
  • Rastreio de Reenvio de Documentos Parceiros — campo dtUltimaAtualizacao em DocumentosModel, auto-preenchido ao salvar docsnovo
  • Auto-Pendente — ao salvar usuário com status bloqueado/atenção e docs compartilhados atualizados, status muda para “pendente” automaticamentenovo
  • Status “Pendente” (azul) — novo status no enum StatusUsuarioParceironovo
  • Badge “Atualizado DD/MM/YYYY” — nos documentos do modal de verificaçãomelhorado
  • totalPendentes — no ParceiroResumoModel e cards de resumo (página Redes + Dashboard)melhorado
  • Verificação de Status no Check-In do Promotor (Totem) — consulta statusParceiro direto do Firestore ao logar no totemnovo
  • Bloqueado no Totem — modal obrigatório sem opção de continuar, volta para tela inicialnovo
  • Atenção no Totem — modal de aviso com opção “Continuar mesmo assim”novo
  • Status Parceiro no Check-In Manual — badge colorido com status na página DetalhesPromotorPage e EfetuarCheckinPromotorWidget (informativo, não bloqueia)novo
v1.4.27+227
12/03/2026
  • Usuários dos Parceiros (Redes de Varejo) — nova página no menu Redes (nível ≤ Suporte), seleção de agência, listagem com busca por nome/CPF/emailnovo
  • Categorização de Documentos — Para Avaliação da Rede / Particular da Agência + campo Label. Docs antigos recebem defaults automaticamentenovo
  • Modal de Verificação de Documentos — docs compartilhados vs particulares, verificação pela rede de varejonovo
  • Alteração de Status — Autorizado/Atenção/Bloqueado manual pela rede, salvo no Firestore (campo statusParceiro) com fallback auto-calculadonovo
  • Notificação Automática — notificação de leitura para agência (nível ≤ Suporte), push FCM via trigger onNotificacaoEntregaCriadanovo
  • Coleção Helper parceiros_resumo — totais desnormalizados (usuarios, autorizados, atencao, bloqueados, docsCompartilhados), atualizado automaticamentebackend
  • Cards de Resumo Parceiros — página Redes (totais agregados) + Dashboard Agência (totais por rede)novo
v1.4.25+225
07/03/2026
  • Coligadas (Parcerias entre Empresas) — vínculo por código entre tenants (XXXX-XXXX, 72h, uso único), tela de cadastro, dropdown de coligada no contrato (imutável), dados propagados até BigQuerynovoexclusivo
  • Totem Check-In: Agendamentos sem O.S. roteirizada — promotor pode fazer check-in em lojas com agendamento sem roteiro (sem promotor atribuído), busca agendamentos não roteirizados na rede/estabelecimento, geração automática de O.S. no Firestore ao confirmar, seleção de agência (múltiplas) e seleção de indústrias com checkboxesnovo
  • Totem: Validação de CPF — bloqueio de CPFs inválidos (sequências repetidas: 000, 111, 222, etc.) no check-in e check-outmelhorado
  • Totem: Filtro de nível no CPF — busca por CPF filtrada por nível (Gerente a PromotorFreeTemp) para excluir clientes/admins. Requer índice composto no Firestoremelhorado
  • Check-in Manual: Paridade com Totem — agendamentos sem promotor atribuído agora aparecem na listagem manual, geração de O.S. por agendamentoIds para agendamentos sem promotormelhorado
  • Financeiro/Pagar — correção do saldo em conta zerando ao trocar segmented (CLT/Free), confirmação antes de informar pagamento, correção do label de nível (Free → Promotor Free, CLT → Promotor CLT)fix
  • Menu Personalizado: Separadores — separadores viraram itens reais do layout: podem ser criados, arrastados, alternados entre sutil/forte e removidos. Dashboard fixo no topo; Versão e Logout fixos no rodapémelhorado
  • BigQuery: 3 colunas novas — coligadaId, coligadaNome, coligadaCnpj em fato_os e fato_agendamentobackend
  • CSV Import: campos coligada — default vazio (sem coligada = serviço próprio)melhorado
v1.4.24+224
05/03/2026
  • Grupos WhatsApp V2 — nova página com DataTable unificada, filter chips com contadores, seletor de grupo via modal, dialog de configurações centralizado com envio de mensagem de testenovo
  • Import Roteiro CSV: frequências — suporte a MENSAL e QUINZENAL, auto-detecção de grupos WPP existentes, clienteFaturamento por nomemelhorado
  • Detalhamento de O.S. em /atendimentos — modal de detalhes com status, semana, cliente, loja, setor e botão copiar IDnovo
  • Cadastro de Estabelecimento — setor disponível já no cadastro novo (sem precisar reabrir)melhorado
  • Ocultar foto por tarefa — permite concluir tarefa sem foto quando não for adequado fotografar (não aparece em tarefas “antes” ou “pós”)novo
  • Ocultar valores dashboard promotor — flag no cadastro de usuários oculta saldo, saque e histórico financeiro do promotor freenovo
v1.4.23+223
05/03/2026
  • Chat IA BigQuery: busca parcial — LIKE por palavra em promotorNome, estabelecimentoNome, clienteNome, redeNome, setorNomemelhorado
  • Fix: campo de data corrigido — dateVisita → dateVisitaAgendamentoOS em visitas_consolidado, visitas_por_dia, visitas_por_promotorfix
  • Chat IA: timeout 60s — cota por consultas (não tokens), numAnoSemana e dataHoje enviados automaticamentemelhorado
v1.4.22+222
04/03/2026
  • Fix: Agendamentos sem dados do estabelecimento — safety net com fallback fetch do Firestore em createRoteiroAtualizacao() e createRoteiroInicial()fix
v1.4.21+221
04/03/2026
  • Import CSV padronizado — Indústrias, Usuários e Estabelecimentos com auto-detecção de header, validação completa e import em lote via WriteBatchnovo
  • Ferramentas > Validação — Indústrias e Usuários com widgets de import em modo somente leituramelhorado
  • Cloud Function: Faltas do Dia Anterior (8h) — CRON seg-sáb, cruza O.S. com check-ins, notifica RH e gestores por setornovo
  • Cloud Function: Lembrete O.S. Incompletas (19h) — CRON seg-sáb, lembrete individual ao promotor + alerta aos gestoresnovo

Builds Anteriores

Builds v1.4.13 → v1.4.20  |  25/02 → 01/03/2026

v1.4.20+220
01/03/2026
  • Otimização login: lazy loading — carrega apenas 1 empresa no login (antes: 42+ = 84+ reads Firestore), demais em backgroundnovo
  • Cliente Rede Parceira: O.S. avulsa automática — O.S. gerada no check-in (totem + manual) com checkout automático sem exigir fotosnovo
  • Gerar O.S. Avulsa — botão no modal de atendimento, seleção de data (30 dias atrás até 90 à frente), lista de últimas O.S. com statusnovo
  • Fix: foto duplicava no Firestore — _selectedImage mantinha bytes da foto anterior ao voltar sem tirar fotofix
  • Fix: marca d'água e path usavam data errada — Cloud Functions corrigidas para usar data original da fotofix
  • Fix O.S. avulsa: campos faltantes — numAnoSemana calculado em YYYYWW, contratoStatus adicionado, formato de data corrigidofix
  • Roteirização Inteligente (I.A.) — feature completa: coleta de dados, plano GPT-4.1-mini, grade comparativa, KM OSRM antes/depois, aplicar/reverter com snapshot 30 diasnovoexclusivo
  • Rota Supervisores — planejamento de visitas recorrentes com filtros em cascata (Setor → Responsável → Rede → Lojas) e salvamento em lotenovo
  • Notificação de Faltas (8h) — cruza O.S. agendadas do dia anterior com check-ins, notifica RH e gestores por setornovo
  • Lembrete de Atendimentos Incompletos (19h) — lembrete individual ao promotor + alerta aos gestores sobre promotores sem visitasnovo
  • Crashlytics — chave 'appCamera' para identificar câmera selecionada
v1.4.19+219
28/02/2026
  • Fix CRÍTICO: fotos offline duplicavam no Firestore — 3 fotos viravam 6 porque PENDING_OFFLINE não era filtrado antes de adicionar foto realfix crítico
  • Fix: WhatsApp duplicado — conclusão re-disparava por dados sujos (corrigido pelo mesmo fix)fix
v1.4.18+218
27/02/2026
  • Fix CRÍTICO: fotos duplicavam visualmente — cópia defensiva do array, campo separado _pendingOfflinePhotos, filtro de PENDINGs no spreadfix crítico
  • Fix CRÍTICO: datas incorretas em visitas offline — cache de outro dia retornava data errada; corrigido em 5 métodos de uploadfix crítico
  • Fix CRÍTICO: sync offline em loop infinito — _retryUpload retornava true fixo; corrigido em 4 métodos de uploadfix crítico
  • Fotos offline renderizadas lado a lado — itens individuais no Wrap (100x100)melhorado
v1.4.17+217
27/02/2026
  • Mapa de Acessos — tabela visual de menus x níveis de acesso (SuperAdmin até Suporte)novo
  • Fix Web debug — FirebaseCrashlytics protegido com kIsWebfix
  • Fix Calendário swap — dia já selecionado agora responde ao clickfix
v1.4.16+216
26/02/2026
  • Financeiro A Pagar: calendário range — seletor de período com data exata para fechamento de pagamentonovo
  • Financeiro A Pagar: Pro-Rata — cálculo proporcional para contratos novos e rescisões dentro do períodonovo
  • Financeiro A Pagar: nível descritivo — exibe "Promotor CLT", "Gerente", etc. ao invés de siglasmelhorado
  • Financeiro A Pagar: loading e pré-carga — spinner inicial, pré-carrega setores/usuários, elimina rebuildsmelhorado
  • Paradas: página admin — convertida para rota regular com botão recalcular distâncias OSRMmelhorado
  • Menu RH e Financeiro reorganizado — itens priorizados, B.I.s reduzidos, reordenação por nível de acessomelhorado
  • KM Roteiros: fila queue-based — CRON 3AM grava fila, CRON 3:30AM consome em lotes de 5 promotores, suporte a 5000+backend
  • KM Roteiros: fixes — campo cancelado no .select(), const para evitar race condition, Firestore transaction no upsertbackend
  • Roteiros O.S. — responsivo mobile, loading isolado por dia, fix shadow de variávelmelhorado
v1.4.13+213
25/02/2026
  • Swap para gestores — Gerente, Supervisor e Promotor Líder podem fazer swap de atendimentosnovo
  • Bloqueio visita duplicada configurável — switch por indústria (campo bloquearAtendimentoDuplicado)novo
  • Setores Relatórios — busca por nome, exportação Excel com 2 abas (Resumo + Detalhado)novo
  • Setor Modal melhorado — promotor fantasma corrigido, nível correto via batch query, export individualmelhorado
  • Kick streaming — força logout também quando nível do usuário é alteradomelhorado
  • Planejamento: tooltip — exibe numAnoSemana e últimas 2 O.S. geradas com statusmelhorado
  • Notificações para gestores — veem superiores em Destinatários, promotores via Meus Setoresmelhorado
  • Fix 4 crashs fatais — Null check, Future already completed, Google Fonts download offlinefix

v1.4 — Nova Era (Base)

v1.4.0 → v1.4.10  |  Fevereiro 2025 → Fevereiro 2026

🔔

Notificações

Sistema completo de notificações — CRUD, sininho em tempo real, push FCM (Android, Web e iOS)novo
Áudio e foto nas notificações — gravação WAV, paste de imagem, galeria, player com velocidade 1x/1.5x/2xnovo
Notificação bloqueante — estabelecimento trava foto da fachada até leitura; indústria bloqueia entrada na O.S.
Automação de swap de rota — consolida alterações e notifica promotor + gestor (consolidado por setor)novo
Faltas do dia anterior (8h) — cruza O.S. agendadas com check-ins, notifica RH (lista completa) e gestores (por setor) com nome e telefonenovo
Check-in pendente do dia (9h) — notifica promotor CLT sem check-in + resumo por setor para gestores com deep link para ligarnovo
Atendimentos incompletos (19h) — lembrete individual ao promotor com contagem de visitas pendentes + alerta para gestores sobre promotores sem nenhuma visitanovo
Switch por agência — ativa/desativa notificações automáticas em lote para todos os usuários
🤖

Chat I.A.

Acesso a banco de dados — consultas interativas ao Firestore (4 coleções) e BigQuery (5 templates)novo
Entrada de voz — gravação de áudio com transcrição automática via Groq Whispernovo
Envio de imagem — paste via Cmd+V / Ctrl+V com OCR via Groq Visionnovo
Consulta de setores — quantidade de promotores, liderança, cidade e status
Controle de cotas — badge de uso diário em tempo real no header do chat
📅

Planejamento

Planejamento Cliente — carga sob demanda, filtro por estabelecimento, exportação Excelnovo
Modal O.S. comparativo — semana passada vs semana atual por numAnoSemana
Drag & Drop — cards arrastáveis com alerta de duplicidade (loja + contrato + dia)melhorado
Zona de drop visual — destaque laranja, modal de conflito e controles de reordenação

Suspensão de Contratos

Tratamento da O.S. configurável — admin escolhe: Cobrada, Cancelada ou Não Realizadanovo
Histórico com reativação — auditoria completa com exportação Excel
💰

Financeiro

Valor por Visita — migração do campo valor de total mensal para valor unitário por visitamelhorado
Modal O.S. Free — layout modernizado com chips coloridos por tipo de cliente
📍

Operacional

Paradas do Promotor — distância real — cálculo por ruas (OSRM) substituindo linha reta (Haversine)novo
Check-in supervisores — paradas com cálculo de distância
Conclusão de O.S. sem WhatsApp — fluxo alternativo de finalização
Estoque por dia da semana — controle de dia para estoque/validade (contrato)
📊

B.I. / Relatórios

Dashboards de rede — novos painéis com layout, gestores e métricasnovo
Monitoramento por Loja — novo dashboard dedicado
🚀

Outros

Book HTML / PDF — novo formato de book de coligada e cliente
treinamentos.emerchan.com.br — domínio, server e módulo de treinamentonovo
Novo layout do app — O.S., estoque, menu e responsividade geralmelhorado

v1.3 — Estabilização

~65 builds  |  Fevereiro 2025 → Fevereiro 2025

📸 Câmera e Mídia
  • Câmera nativa CameraX — Android Camera 3 com processamento de imagem otimizado
  • Fotos antes/depois — comparação visual de pré-reposição para WhatsApp e book
  • Compressão inteligente — fotos de campo otimizadas (800px, 60% qualidade)
💰 Financeiro Freelancer
  • Dashboard financeiro — acompanhamento de pagamentos, propostas e saques
  • Relatórios de pagamento — consolidação por cliente e por promotor
  • Propostas de pagamento — criação e aprovação com exportação
🏙 Coligadas e Redes
  • Área de coligadas — gestão de O.S. por empresa coligada
  • Check-in por rede — promotores de rede com check-in individual
  • Importação de dados — import de redes e PDVs em lote
🔌 Modo Offline
  • Funcionamento sem internet — app funciona offline com sincronização automática
  • 6 versões de evolução — aprimoramento progressivo do banco local (v1→v6)
  • Sincronização inteligente — dados enviados automaticamente ao retomar conexão
🛒 Estoque e Preços
  • Controle de preços com OCR — registro de preço de produto via câmera
  • Estoque com data limite — controle de validade obrigatório por contrato
  • Detecção de ruptura — alerta automático de falta de produto com foto
📄 Contratos e Aprovações
  • Solicitação de aprovação — fluxo de aprovação de contratos
  • Consolidação financeira — relatórios financeiros por contrato
  • Geração de book — relatório visual automático por contrato

Versões Anteriores

Histórico desde o primeiro protótipo

v1.2 — Infraestrutura Offline ~16 builds  |  Jul–Ago 2025
  • Ponto eletrônico — check-in com foto, almoço, retorno e check-out com timestamps
  • Banco offline v1→v6 — evolução progressiva do suporte offline
  • Promotor na loja — nova arquitetura para equipe em campo
  • Histórico de itinerário — rota de viagem com planejamento otimizado
  • Exportação Excel — relatórios multi-formato com tratamento numérico
  • Bloqueio por estoque — serviços bloqueados quando estoque/validade obrigatório
v1.1 — Base do Sistema ~90 builds  |  Nov 2024–Jun 2025
  • Integração WhatsApp — mensagens automáticas em grupos com rastreamento de entrega
  • Relatórios consolidados — dashboards BigQuery (PowerBI para InNove)
  • Sistema financeiro — propostas de pagamento, saques e acompanhamento freelancer
  • Galeria de fotos — fotos de pré-reposição para grupos WhatsApp, antes/depois
  • Orçamentos — criação a partir de contratos, geração PDF, interação com cliente
  • Controle de quilometragem — cálculo automático e otimização de rota via API externa
  • Estoque e validade — inventário por estabelecimento com controle de data
  • Geração mensal de O.S. — escalas quinzenais alternadas e planejamento automático
  • Detecção de duplicidade — proteção contra visitas duplicadas por contrato/loja
  • Suporte a redes/PDV — importação de dados e check-ins específicos por rede
v1.0 — MVP ~50 builds  |  Jul–Ago 2024
  • Ordem de Serviço (O.S.) — tarefa diária do promotor (pendentes, semanal, diário)
  • Upload de fotos — captura em campo com compressão automática
  • Swap de promotor — reatribuição de O.S. entre membros da equipe
  • Gestão de suprimentos — pedidos pendentes com fluxo de aprovação
  • Mapa de setores — visualização geográfica e atribuição de promotores
  • Contratos — criação, acompanhamento de status e geração de O.S. vinculada
  • Rastreamento GPS — localização em tempo real com raio de 400m para conclusão
  • Alertas de ruptura — reporte de falta de produto com foto para WhatsApp
  • Roteiro diário — agendamento automático por promotor
  • Painel administrativo — gestão de usuários, estabelecimentos e setores
v0.x — Protótipo ~32 builds  |  Nov 2023
  • Navegação por nível — menu dinâmico baseado no papel do usuário
  • Geocodificação — resolução de endereço para coordenadas no mapa
  • Agenda e atendimentos — criação de agenda com geração automática de atendentes
  • Sistema de orçamentos — propostas com geração PDF e envio por e-mail
  • Autenticação — login com acesso por nível (Coordenador, Gerente, etc.)
  • Integração com mapas — visualização de setores com marcadores Google Maps
  • Assinatura digital — revisão e assinatura de contratos por e-mail