# Análise dos ERPs legados e roadmap do N4STi Gestão

Data da análise inicial: 20/09/2026.

## Fontes analisadas

- ERP comercial legado em `C:\Users\adm\Downloads\htdocs\comercial`.
- ERP industrial legado em `C:\Users\adm\Downloads\htdocs\industrial`.
- Central de Ajuda do Bling, especialmente vendas, frente de caixa, estoque e integrações.
- Código, banco, testes e manual do N4STi Gestão.

Os legados devem ser usados para recuperar regras de negócio e relatórios conhecidos pelos usuários. O código não deve ser transplantado diretamente: ele mistura apresentação, SQL e regra de negócio, possui muitas cópias por empresa e versões de arquivos, e não oferece o isolamento multiempresa exigido pelo sistema atual.

## Capacidades encontradas nos legados

### Comercial

- Orçamentos, pedidos, compras, estoque, financeiro, boletos e NF-e.
- Ordens de serviço e chamados.
- CT-e e manifestos.
- Importações, exportações, relatórios e auditoria.

### Industrial

- Ordem de produção, histórico da OP, apontamento manual e por máquina.
- Estrutura/composição, processos, seções, máquinas e tempos/paradas.
- Controle de qualidade e produto não conforme.
- Estoques separados de fios, tecidos, produto físico e produto para NF.
- Rolos, cones, caixas, paletes, etiquetas e QR Code.
- Romaneio vinculado a pedido, OP, qualidade, local e estoque.
- Programação de pedidos, intenção de pedido e pronta-entrega.
- Inventário por rolo, departamento e responsável.
- Almoxarifado com departamento, fornecedor, produto e auditoria.
- IQF (Índice de Qualificação de Fornecedor), anexos e itens avaliados.
- Projetos e subprojetos.
- Indicadores e relatórios operacionais.

## Comparação e decisões de produto

| Área | N4STi atual | Legado/Bling | Próxima entrega recomendada |
|---|---|---|---|
| Cadastros | Clientes, fornecedores e produtos com guias | Muitos campos, porém telas fragmentadas | Endereços, contatos, vendedor, condição de pagamento e validação progressiva |
| Vendas | Orçamento, pedido, impressão e geração de nota | Programação, pronta-entrega e múltiplos relatórios | Assistente de venda, parcelas, expedição e devolução |
| Fiscal | NF-e/NFC-e/NFS-e estruturadas e XML preliminar | Grande histórico de regras fiscais | Homologação por provedor/SEFAZ, DANFE/NFC-e/NFS-e oficiais e eventos |
| Estoque | Saldo, reserva, movimentação e requisição | Lote, rolo, local, etiquetas, romaneio e inventário | Endereçamento, lote/série/validade, inventário e picking |
| Almoxarifado | Solicitante, destino, retirada e comprovante | Departamento, OP, fornecedor e auditoria | Aprovação, centro de custo, assinatura digital e devolução |
| Compras | Pedido e recebimento | Follow-up e avaliação de fornecedor | Cotação, aprovação, recebimento parcial e IQF |
| Produção | OP e industrialização externa | Máquina, processo, apontamento, parada e qualidade | Roteiro, capacidade, apontamento, perdas, qualidade e custo real |
| Financeiro | Títulos, liquidação parcial e estorno | Caixa, boleto e relatórios extensos | Contas bancárias, conciliação, caixa/PDV, DRE e fluxo de caixa |
| Omnichannel | Estrutura de canais e Mercado Livre | Bling possui conectores e sincronização | Catálogo central, anúncios, pedidos, estoque/preço e fila de erros |
| Logística | Base limitada | Romaneio, locais, volumes, paletes e etiquetas | Separação, conferência, embalagem, romaneio e rastreio |
| Serviços | NFS-e inicial | OS/chamados no comercial | Ordem de serviço, agenda, equipamentos e SLA |
| Loja virtual | Não implementada | Integrações de loja do Bling | Vitrine SaaS por subdomínio, checkout e API pública segura |

## Ordem segura de implementação

1. Completar o núcleo operacional: cadastros, venda, parcelas, estoque endereçado, expedição e devolução.
2. Homologar documentos fiscais com provedores reais e implementar eventos e documentos auxiliares oficiais.
3. Entregar PDV/caixa com abertura, suprimento, sangria, vendas pendentes e fechamento auditável.
4. Evoluir compras, inventário, lotes/séries/validade, etiquetas e avaliação de fornecedor.
5. Evoluir produção com roteiro, recursos, apontamentos, qualidade, rastreabilidade e custos.
6. Completar omnichannel/Mercado Livre com filas idempotentes, reconciliação e tratamento de erros.
7. Entregar loja virtual multiempresa e API versionada, antes de automatizar DNS/subdomínios.
8. Entregar editor de layouts com componentes seguros, versões e pré-visualização para orçamento/pedido.

## Critérios obrigatórios por módulo

- Isolamento por grupo, empresa e estabelecimento.
- Permissões por ação e trilha de auditoria.
- Estados explícitos; documentos confirmados não podem ser alterados silenciosamente.
- Operações financeiras, fiscais e de estoque devem ser transacionais e idempotentes.
- Mensagens devem dizer qual campo está errado, por que ele é necessário e como corrigir.
- Ajuda contextual deve abrir no módulo e no fluxo em uso.
- Testes unitários, integração com banco e roteiro de ponta a ponta antes da publicação.
- Recursos fiscais só podem ser chamados de “emissão” após homologação real; XML preliminar não equivale a autorização fiscal.

## Observações da análise

O legado industrial mostra que “estoque” não é um único saldo: a operação usava localização, departamento, rolos, OP, transferência, qualidade e romaneio. Portanto, a evolução deve preservar uma visão simples para iniciantes e liberar rastreabilidade avançada conforme o tipo do produto e o módulo habilitado.

O mesmo vale para produção: a OP básica é apenas o começo. Para ser funcional na indústria, o sistema precisa distinguir planejado, liberado, em produção, parado, parcialmente produzido, em qualidade, concluído e cancelado, mantendo consumo, perdas, subprodutos, operador, máquina e horários.