⚡ B2Sync Platform Engenharia
⚠️ Diagnóstico Crítico de Produção

Plano Estratégico de Correções B2Sync

Análise detalhada de causa-raiz técnica, mapeamento de código fonte e plano de ação em 3 fases para os 8 problemas operacionais relatados no Fechamento, Etiquetas, WhatsApp e Motor de Sincronismo C#.

Falha Bloqueante de UI
Bipar Itens
ReferenceError: biparProdutoConferencia
Divergência de Dados
Data -1 Dia
Bug UTC 'Z' vs Fuso Brasília no C# SyncEngine
Expedição & Etiquetas
Fallbacks Falsos
Remoção de Fone Base, "Centro" e "Prazo Domingo"
Arquitetura de Deploy
v2.7.1
cPanel FTP + /tmp/restart.txt + Cache Busting

🔍 Diagnóstico de Causa-Raiz & Soluções Mapeadas

1. Telefone 43...(Base) Exibido Indevidamente para Clientes
Crítico Frontend • app.js
Sintoma: Clientes sem telefone cadastrado no ERP apareciam na tela com 43 5558-9455 (Base). Ao tentar enviar mensagem via WhatsApp, o sistema abria conversa para o próprio número fixo da base Apucarana, retornando o erro: "O número +55 43 5558-9455 não está no WhatsApp".
// Linhas app.js:5043, 4639, 3556, 1797
const foneExibido = rawFone ? rawFone : `<span style="color:var(--text-muted);" title="Contato padrão Base Apucarana">43 5558-9455 (Base)</span>`;
❌ Comportamento Atual (Errado)
Preenche o cliente com o número fixo da matriz se o banco vier nulo, gerando confusão e disparo inútil de WhatsApp.
✅ Comportamento Novo (Exigido)
Se não houver CELULAR ou FONE no banco, não exibir nada (--) e bloquear disparo de WhatsApp com alerta Toast amigável.
Ação Corretiva: Eliminar fallbacks hardcoded da base. Validar regex de telefone antes de disparar o WhatsApp API.
2. Cidade/Bairro Exibindo Código IBGE (4122107) e Forçando "Centro"
Integridade Frontend • app.js
Sintoma: Na esteira de expedição e nas etiquetas, a coluna Cidade/Bairro exibia números puros do código IBGE (ex: 4122107) quando cidadeRef vinha nulo, e forçava Bairro: Centro mesmo quando o cliente não possuía bairro.
// Linhas app.js:5045-5047
const nomeCidade = cliente.cidadeRef ? cliente.cidadeRef.nome : (cliente.municipio || cliente.cidade || "Apucarana");
const bairroStr = (cliente.bairro && String(cliente.bairro).trim() !== "") ? cliente.bairro : "Centro";
Regra de Negócio Oficial:
• Se tiver Bairro: mostrar o Bairro.
• Se NÃO tiver Bairro: mostrar o Nome do Município (resolvendo o código IBGE via tabela/cache de cidades ou cliente.municipio). Nunca exibir código numérico puro nem forçar "Centro".
3. Remoção Completa da Referência Inútil "(Prazo: Domingo)"
Limpeza de UX Frontend & Templates
Sintoma: Textos em toda a interface exibiam Dia: Quarta-feira (Prazo: Domingo) e Prazo: Dom. Essa referência a domingo não possui nenhuma utilidade operacional e poluía a esteira e os cupons.
// Linhas app.js:1813, 3593, 4665, 4704, 5093
const diaPrazoStr = `${diaSemana} • Prazo: Domingo`;
<strong style="color:#38bdf8;">Prazo: Dom</strong>
Ação Corretiva: Remover a menção a prazo em todos os locais. Manter estritamente o Dia da Semana e a Data de Emissão (ex: Quarta-feira • 21/10/2026).
4. Falha Bloqueante: "Conferência de Produtos, não passa daqui"
Bug de Execução Frontend • index.html & app.js
Sintoma: Ao tentar conferir os itens do pedido bipando o código de barras ou SKU no modal "Itens da Venda", o leitor não respondia e o DevTools emitia o erro fatal:
Uncaught ReferenceError: biparProdutoConferencia is not defined at HTMLButtonElement.onclick ((index):984).
// index.html:983-984
<input type="text" id="conferencia-produto-input" onkeypress="if(event.key === 'Enter') biparProdutoConferencia(this.value)">
<button type="button" class="btn-primary btn-small" onclick="biparProdutoConferencia(...)">Bipar</button>
Ação Corretiva: Implementar a função global biparProdutoConferencia(codigoBipado) em app.js, realizando a busca por EAN/SKU/Código, marcando o item como conferido, emitindo o bip sonoro de sucesso e atualizando o contador dinâmico 0/2 Conferidos.
5. Motor de Sincronismo B2Sync: Data de Emissão Recuando 1 Dia
Causa-Raiz Descoberta C# • SyncEngine.cs
Sintoma: Ao sincronizar uma venda cadastrada hoje (ex: 27/10/2026), o sistema grava na API a data de ontem (26/10/2026), atrasando os relatórios em -1 dia.
Causa-Raiz Técnica: O banco Firebird armazena colunas do tipo DATE como 2026-10-27 00:00:00 em horário local. O serializador C# do SyncEngine.cs formatava a data forçando um sufixo 'Z' (Zulu / UTC): "2026-10-27T00:00:00Z". Como o Brasil está no fuso UTC-3, ao converter na API Node.js/PostgreSQL ou no navegador do cliente, 00:00:00 UTC vira 21:00:00 do dia anterior (26/10)!
// B2Sync/SyncEngine.cs:2376
else if (val is DateTime dt) dict[keyName] = dt.ToString("yyyy-MM-ddTHH:mm:ss'Z'"); // ❌ BUG TIMEZONE UTC!
❌ Como está gravando
"2026-10-27T00:00:00Z" → Navegador UTC-3 interpreta como 26/10/2026 21:00
✅ Como deve gravar
"2026-10-27" ou dt.ToString("yyyy-MM-dd") (Data pura sem timezone UTC forçado)
Ação Corretiva: Tratar campos de data pura (DATE) em SyncEngine.cs gerando apenas yyyy-MM-dd, garantindo a integridade transacional sem deslocamento de fuso.
6. Central WhatsApp Web: Failed to fetch localhost:3003/status
Rede & HTTPS Frontend • app.js
Sintoma: Na tela do WhatsApp Web, ao clicar em "Reiniciar Conexão" ocorria Erro ao reiniciar serviço: Failed to fetch e no console múltiplos net::ERR_CONNECTION_REFUSED http://localhost:3003/status.
// index.html:656 & app.js:2950
<input type="text" id="wa-server-url-input" value="http://localhost:3003">
Ação Corretiva: Em ambiente HTTPS na nuvem, o navegador bloqueia conexões locais desprotegidas ou sem o serviço rodando no cliente. Criar validação de conectividade com fallback para o gateway oficial https://wa.atrativa.inbm2.com.br ou exibir banner instrutivo caso o microserviço local precise ser iniciado.
7. Erro 401 (Unauthorized) e Falha ao Despachar (Em Transporte)
Segurança & Sessão API & Frontend
Sintoma: Ao tentar despachar um pedido para "5. Em Transporte", a tela travava e o console acumulava respostas 401 nos endpoints /empresas, /resumo e /vendas devido a token expirado sem refresh automático bem sucedido.
Ação Corretiva: Ajustar o interceptor window.fetch para renovar o token contra o endpoint correto da API e, em caso de expiração irrecuperável, abrir modal de re-autenticação rápida sem perder os dados preenchidos no modal de despacho.
8. Etiquetas de Envio (100x150mm e 80mm) com Dados Errados
Expedição Frontend • app.js
Sintoma: A etiqueta gerada para o cliente preenchia automaticamente dados artificiais (Telefone da Base, Bairro Centro, CEP 86800-110, "PRAZO: DOMINGO"), mascarando falhas cadastrais reais.
Ação Corretiva: Limpar todos os placeholders artificiais. A etiqueta deve imprimir estritamente os dados reais do cliente; caso falte algum dado essencial, deve exibir o aviso ⚠️ REVISAR CADASTRO.

🚀 Roadmap de Implementação em 3 Fases

1
Fase 1: Correções Imediatas no Frontend (B2Sync.Fechamento)
Prioridade Máxima
  • Implementação de biparProdutoConferencia() no app.js (fim do ReferenceError).
  • Remoção definitiva do número da base Apucarana dos dados do cliente e bloqueio de WhatsApp fantasma.
  • Aplicação estrita da regra Cidade/Bairro (mostrar Bairro; se não houver, Nome do Município; erradicar código IBGE).
  • Expurgo completo da menção "Prazo: Domingo" da esteira, etiquetas e cupons.
  • Saneamento dos dados impressos na etiqueta térmica 100x150mm.
  • Resolução dos erros de sessão 401 com re-login gracioso no despacho.
2
Fase 2: Motor de Sincronismo C# (B2Sync)
Core Sync
  • Correção em SyncEngine.cs:2376 para não adicionar 'Z' em colunas de tipo DATE.
  • Compilação e geração dos binários atualizados no Windows (dotnet build -c Release).
  • Teste de conciliação com envio de venda do dia e verificação da data intacta na API.
3
Fase 3: Versionamento, Deploy cPanel & Notificação
Entrega Oficial
  • Incremento obrigatório de versão para v2.7.1 (package.json, index.html e cache busting app.js?v=2.7.1).
  • Deploy via FTP para o cPanel da Atrativa e acionamento do /tmp/restart.txt.
  • Disparo de notificação push no celular via AGY Hub (b2sync-net.js notify).