# Roadmap operacional — 10 fases

Atualizado em 25/09/2026. Uma fase só é concluída após fluxo de interface, validação de erros, teste com banco, teste ponta a ponta e documentação de uso. **Parcial não significa pronta para operação completa.**

| Fase | Escopo | Situação | Próxima condição de aceite |
|---|---|---|---|
| 1 | Lote, série, validade, endereçamento, inventário | Parcial | Revisar todos os caminhos de movimentação, reconciliação de saldo e concorrência |
| 2 | Separação, conferência, volumes, etiquetas, romaneio | Parcial | Conferência persistida, volumes e etiquetas vinculados ao despacho |
| 3 | Devolução e troca | Parcial | Completar acerto financeiro, nota fiscal de devolução e troca vinculada |
| 4 | Frente de caixa/PDV | Parcial | Vincular vendas, pagamentos e NFC-e ao caixa; abertura, suprimento, sangria e fechamento físico já têm fluxo básico |
| 5 | Produção avançada | Parcial | Roteiro, máquinas, apontamentos, perdas, qualidade e custo real |
| 6 | Financeiro gerencial | Parcial | Conciliação bancária, categorias, DRE e projeção cumulativa; fluxo mensal previsto/realizado básico já disponível |
| 7 | Omnichannel/Mercado Livre | Parcial | Sincronização bilateral, reconciliação, retries e tratamento de conflitos |
| 8 | Fiscal homologado | Pendente | Certificado, homologação real por ambiente/provedor, eventos e auxiliares oficiais |
| 9 | Editor visual de impressão | Implementada | Homologação visual autenticada e ampliação futura dos componentes; editor, prévia, versão e isolamento por empresa estão operacionais |
| 10 | Loja virtual/API | Pendente | Catálogo, checkout, tenant por domínio, API autenticada e segurança operacional |

## Regras de implementação

- O ERP legado orienta processos e campos; não reutilizar código antigo sem revisão.
- A documentação do Bling orienta a experiência e o fluxo, mas as regras fiscais e técnicas precisam de fonte oficial e homologação.
- Saldo, financeiro e fiscal devem ser transacionais, idempotentes e auditáveis.
- Todo estado pendente precisa estar visível: especialmente devolução física sem acerto fiscal/financeiro.
- Não publicar como funcional uma integração externa sem credenciais, configuração, callbacks e teste em homologação.

## Testes transacionais atuais

`tests/ServerBusinessSmoke.php` executa operações com rollback. Abrange reserva, estorno, expedição e consumo por lote, retry idempotente, baixa financeira parcial, pré-validação fiscal, entrada de devolução em inspeção, abertura/movimentação/fechamento de caixa, fluxo mensal e layout de impressão isolado por empresa. `tests/ServerPlatformSmoke.php` verifica a conta de administração global e as estruturas de plataforma. Não substitui teste de interface nem homologação fiscal.