B2Sync Monorepo & Satélites Firebird 2.5 ⇄ MySQL 8.4 / Postgres Build Catálogo v2.5.5

Resumo Técnico dos Projetos B2Sync.*

Visão consolidada da arquitetura distribuída B2Sync: sincronização bidirecional offline-first entre bancos legados Firebird nas filiais e nuvem REST, painéis gerenciais reativos, esteira de bipagem e expedição térmica, automação de WhatsApp, e-commerce multi-gateway, live commerce em tempo real e força de vendas PWA.

12 Módulos & Projetos no Ecossistema
Bidirecional Sincronismo PULL/PUSH (Firebird ⇄ API)
Zero-Loss Locks Transacionais & Hex ISO-8859-1
Auto-Update Polling Reativo de Versão & Cache Busting

🗺️ Topologia Geral do Ecossistema B2Sync.*

Como os módulos locais (Matriz/Filiais/Depósito) conversam com o núcleo B2Sync.Api e alimentam os canais operacionais e de venda:

flowchart TD
    subgraph Edge["🏢 Operação Local (Matriz, Filiais & Depósitos)"]
        FB[("Firebird 2.5\nATRATIVA1 / ATRATIVA2 / DEPOSITO")]
        SYNC["B2Sync (b2sync.exe)\nSincronizador C# .NET 8\nPULL/PUSH + AES-256 + NCM BrasilAPI"]
        FB <-->|Literais HEX ISO-8859-1| SYNC
    end

    subgraph Core["⚡ Núcleo Cloud & Mensageria"]
        API["B2Sync.Api (Node.js + Sequelize)\nJWT • RuleTab • Contador Atômico • Soft-Delete"]
        MYSQL[("MySQL 8.4 / Postgres\nMulti-Tenant / Multiempresa")]
        WPP["B2Sync.Whatsapp\nwhatsapp-web.js + QR Code Engine"]
        API <--> MYSQL
    end

    subgraph Operacional["🛠️ Gestão, Expedição & Abastecimento"]
        DASH["B2Sync.Dashboard (v1)\n& B2Sync.Frontend (Bento v2)"]
        FECH["B2Sync.Fechamento (v2.5.5)\nEsteira Bipagem • Cupom 80mm • Etiqueta 100x150"]
        REQ["B2Sync.Requisicao\nPedidos Loja ➔ CD • Romaneio PDF"]
    end

    subgraph CanaisVenda["🛒 Canais Digitais & Força de Vendas"]
        COMM["B2Sync.b2commerce\nStorefront + Stripe / PagSeguro / MercadoPago"]
        VENDA["B2Sync.b2venda\nLive Commerce Socket.IO + PIX Único"]
        FORCE["B2Force (PWA Next.js 15)\nVenda Rápida Offline IndexedDB + Balcão"]
        PDF["b2PDF (React 19 + pdf-lib)\nEditor Visual de PDF Fullstack"]
    end

    SYNC <-->|REST Paginado + Delta DHSINC| API
    API <--> DASH & FECH & REQ
    API <--> COMM & VENDA
    FECH & COMM & VENDA -->|Disparo Automático| WPP
        

📦 Catálogo Detalhado de Projetos (B2Sync.*)

01 • /B2Sync Produção v1.1.0

B2Sync (Sincronizador C# .NET 8)

Integrador desktop/serviço Windows (b2sync.exe) executado localmente na Matriz e Filiais para sincronismo incremental bidirecional (PULL/PUSH) entre o ERP legado Firebird e a nuvem.

  • Anti-Mojibake Firebird 2.5: Gravação com literais hexadecimais (FbSqlLiteral ISO-8859-1) eliminando corrupção de acentuação.
  • Segurança AES-256: Criptografia de ConnectionString e credentials.enc via linha de comando.
  • Auto-NCM Inteligente (--atribui-ncm): Consulta automática à BrasilAPI com cache por palavra-chave para preencher NCMs zerados antes do PUSH.
  • Flags Operacionais: Suporte a --force-date, --reset-sinc, --debug, --log e --confirmacao.
02 • /B2Sync.Api Produção v1.0.0

B2Sync.Api (Core REST & RuleTab Engine)

Backend central multiempresa (também empacotado em b2sync_api_cpanel para Phusion Passenger) que orquestra permissões de sincronismo, catálogo, vendas, caixas e contadores atômicos.

  • Sincronismo Incremental: Filtro por COALESCE(alteracao, inclusao) > dataAlteracao com escopo por empresa no token JWT.
  • Motor RuleTab CRUD: Controle granular por origem e tabela (envia, recebe, inclui, altera, exclui).
  • Gerador Atômico de PKs (/contador/proximo): Usa transações com SELECT ... FOR UPDATE para impedir colisão de IDs entre filiais offline.
  • Soft-Delete Nativo: Exclusão lógica (excluido = 1) propagada automaticamente para todas as filiais.
03 • /B2Sync.Dashboard Produção v2.4.14

B2Sync.Dashboard (Painel Gerencial & Auditoria)

Aplicação web SPA para gestão multiempresa de Produtos, Empresas, Vendas, VBs, Caixas, Pessoas e simulação de segurança das regras RuleTab.

  • Sincronização Incremental no Browser: Mescla deltas em tempo real e remove registros com soft-delete.
  • Console Tamper / RuleTab: Permite simular adulteração de permissões no localStorage para auditar bloqueios 403 Forbidden da API.
  • Auto-Update Banner: Polling a cada 30s em /version.json com banner interativo de atualização imediata sem cache.
04 • /B2Sync.Frontend Next-Gen v2 (Bento)

B2Sync.Frontend (UI Bento Grid v2)

Evolução do frontend administrativo em React com arquitetura visual Bento Grid, experiência fluida de navegação e componentes modulares desacoplados.

  • Layout Bento Grid: Visualização densa e ergonômica de KPIs operacionais e financeiros.
  • UpdateNotificationToast: Verificação assíncrona a cada 60s em version.json com recarga limpa de assets.
  • Base para Novos Módulos: Preparado para acoplar os módulos de Live Commerce e E-commerce.
05 • /B2Sync.Fechamento Produção v2.5.5

B2Sync.Fechamento (Esteira, Bipagem & Térmica)

Sistema operacional Mobile-First para bancada de expedição, esteira de bipagem de pedidos, fechamento de caixa e emissão de documentos térmicos.

  • Esteira Hands-Free: Bipagem contínua via leitor USB/Bluetooth ou câmera do celular com debounce anti-duplicidade (2s) e proteção contra regressão de etapa.
  • Impressão Térmica & Etiquetas: Comprovante de Venda (58mm/80mm com QR Code VENDA:emp:cod), Etiqueta de Envio (100x150mm com Code 128) e Cupom de Fechamento de Caixa.
  • Auto-Reload Silencioso: Monitora /health a cada 10s para manter a bancada sempre na última build.
06 • /B2Sync.Whatsapp Produção v1.0.0

B2Sync.Whatsapp (Motor Próprio de Mensageria)

API própria de integração com WhatsApp para disparo automatizado de comprovantes de fechamento, avisos de mudança de etapa na esteira e cobranças PIX.

  • Pareamento Duplo: Geração e leitura de QR Code de sessão tanto no terminal quanto via painel web próprio.
  • Templates Dinâmicos: Mensagens personalizadas por etapa do pedido (Separação, Embalagem, Aguardando Coleta, Enviado).
  • Integração Direta: Consumido nativamente pelo B2Sync.Fechamento, B2Commerce e B2Venda.
07 • /b2sync-requisicao Protótipos Homologados

B2Sync.Requisicao (Abastecimento Loja ➔ CD)

Subsistema de abastecimento e distribuição multiempresa entre unidades consumidoras (Lojas, Filiais, Pastelarias) e unidades fornecedoras (Depósitos Centrais e Fábricas).

  • Conversor Fardo × Unidade: Cálculo instantâneo $\text{Total} = (\text{Qtd FD} \times \text{Contém}) + \text{Qtd UN}$ com apuração de estoque em loja.
  • Romaneio de Separação PDF: Agrupamento automático por departamento (Alimentícios, Bebidas, Limpeza, Embalagem, Doces) e peso total em KG.
  • Dupla Interface: Disponível em versão UI/UX Moderno e Perfect Pixel Win32/Delphi.
08 • /B2Sync.b2commerce v1.0.0 Fullstack

B2Sync.b2commerce (Loja Virtual Multi-Gateway)

Storefront e backend de e-commerce acoplados ao catálogo da B2Sync.Api com reserva preventiva de estoque e múltiplos provedores de pagamento.

  • Adapter Multi-Gateway (IPaymentGateway): Suporte simultâneo a Stripe, PagSeguro (PagBank) e Mercado Pago (PIX, Cartão e Boleto).
  • State Machine Anti-Overbooking: Ciclo controlado (DRAFT ➔ RESERVED ➔ PAYMENT_PENDING ➔ PAID / EXPIRED).
  • Webhooks Transacionais: Confirmação automática de pagamento com baixa de estoque e notificação via WhatsApp.
09 • /B2Sync.b2venda MVP Live Commerce

B2Sync.b2venda (Live Commerce em Tempo Real)

Plataforma de vendas ao vivo (Live Commerce) para estoques limitados, substituindo o controle manual em papel por fila de prioridade em milissegundos via WebSockets.

  • Sacola da Live & Tolerância Configurável: Regra de irrevogabilidade com limite ajustável de desistências por cliente (devolvendo a peça ao estoque ativo ao vivo).
  • Sincronia Instantânea: Atualização de estoque em tempo real via Socket.IO e locks transacionais.
  • Checkout Unificado Pós-Live: Consolida todas as reservas da cliente em um único pedido e gera um PIX Único enviado no WhatsApp.
10 • /B2Sync.Tests QA & Integração

B2Sync.Tests (Suíte Automatizada .NET)

Suíte de testes automatizados em C# (SyncIntegratorTests.cs) dedicada a validar a integridade do motor de sincronismo, criptografia e resiliência entre Firebird e API.

  • Validação de Ciclo PULL/PUSH: Garante que o marcador RULETAB.DHSINC nunca perca registros editados concorrentemente.
  • Testes de Encoding & Criptografia: Verifica literais hexadecimais ISO-8859-1 e descriptografia de credenciais.
11 • /b2force Produção PWA

B2Force (Força de Vendas & Balcão Offline-First)

Aplicação PWA para vendas externas na rua/intervalo de empresas (Modo Venda Rápida / Ambulante), vendas no caixa físico (Modo Balcão) e gestão completa de fiados.

  • Arquitetura Offline-First: Escrita otimista local em IndexedDB (idb) com fila de sincronização automática ao recuperar conexão.
  • Gestão de Fiados & Comissões: Controle de inadimplência, histórico por cliente e dashboards em Recharts.
12 • /b2pdf Produção v1.0.0

b2PDF (Editor Visual de PDF Fullstack)

Aplicação web completa (pdf.inbm2.com.br) para edição direta de textos existentes em documentos PDF, inserção de anotações e organização de páginas no navegador.

  • Edição Nativa de Texto: Mapeia coordenadas via pdfjs-dist, aplica máscara whiteout patch e reescreve vetorialmente com pdf-lib.
  • Gestão de Páginas: Miniaturas em tempo real, rotação (90°/180°/270°), duplicação, exclusão e reordenação visual.
13 • /B2Sync.Permissoes Arquitetura & RBAC v2

B2Sync.Permissoes (RBAC por Grupo + Override Individual)

Motor central de controle de acesso e privilégios granulares por módulos e itens de menu (inbm2.com.br/permissoes), unificando permissões por Grupo (Perfis) e exceções individuais Tri-State.

  • Matriz CRUD+E por Item de Menu: Controle independente de VIEW, CREATE, UPDATE, DELETE, EXPORT e SPECIAL em cada aba e módulo.
  • Herança Híbrida Tri-State: Permite vincular o usuário a um Grupo e aplicar overrides individuais (HERDAR, PERMITIR, NEGAR) com precedência matemática Deny-Overrides.
  • Retrocompatibilidade Automática: Gera o payload effectivePermissions e sincroniza automaticamente allowedTabs no JWT e no Refresh Token.

🔄 Matriz de Atualização, Versionamento & Ambientes

Módulo / Projeto Versão Atual Tecnologia Base Mecanismo de Auto-Update / Telemetria
B2Sync (Sincronizador) v1.1.0 C# .NET 8.0 + Firebird 2.5 Logs diários em log_api/AAAA-MM-DD.log + Flag --confirmacao
B2Sync.Api v1.0.0 Node.js + Express + Sequelize (MySQL/PG) Endpoint /health + Restart automático via Phusion Passenger (/tmp/restart.txt)
B2Sync.Dashboard v2.4.14 Vanilla JS SPA + Express + PDFKit Polling a cada 30s em /version.json + Banner interativo "Atualizar agora"
B2Sync.Frontend (Bento v2) v2.0.0 React + Vite + Modern CSS Polling a cada 60s em ./version.json + Toast React (UpdateNotificationToast)
B2Sync.Fechamento v2.5.5 JS Mobile-First + Express Polling a cada 10s em ${apiBaseUrl}/health com Auto-Reload silencioso na bancada
B2Sync.Whatsapp v1.0.0 Node.js + whatsapp-web.js Monitoramento de sessão ativa via QR Code Web e Terminal
B2Sync.Requisicao v1.0.0-proto HTML5 / Modern CSS / Win32 Pixel-Perfect Hospedado em inbm2.com.br/requisicao
B2Sync.b2commerce v1.0.0 React 19 + Node/TS + Multi-Gateway Webhooks em tempo real (Stripe, PagSeguro e Mercado Pago)
B2Sync.b2venda v0.1.0-mvp React + Socket.IO + Node.js Sincronização instantânea de sacola e estoque via WebSockets
B2Force v1.0.0 Next.js 15 PWA + IndexedDB + MySQL Service Worker (/sw.js) + Fila de Sincronismo Offline Otimista
b2PDF v1.0.0 React 19 + TypeScript + pdf-lib Produção ativa em pdf.inbm2.com.br