# Roadmap de Desenvolvimento

## Método

Entregar fatias verticais pequenas. Nenhuma fase começa com dezenas de telas sem regras/testes. Cada marco precisa ser utilizável em staging e aprovado pela N4STi.

## Marco 0 — Fundação técnica

- repositório e convenções;
- ambiente Ubuntu/Apache/PHP/MySQL/Redis;
- núcleo HTTP, roteamento, views e erros;
- migrations próprias;
- logs e correlation ID;
- autenticação, sessão, CSRF e recuperação;
- grupos, empresas, estabelecimentos;
- memberships, RBAC e módulos;
- auditoria;
- filas/outbox/scheduler;
- pipeline de qualidade;
- layout base e design tokens.

**Saída:** administrador cria empresa, usuário e permissões; isolamento automatizado aprovado.

## Marco 1 — Cadastros e catálogo

- pessoas e papéis;
- endereços/contatos;
- unidades, categorias, marcas;
- produtos, variantes e imagens;
- configurações por empresa;
- fiscal básico estrutural;
- tabelas de preço;
- importação inicial controlada.

**Saída:** catálogo preparado para estoque, venda, marketplace e fiscal.

## Marco 2 — Estoque e almoxarifado

- depósitos/localizações/status;
- ledger e projeção de saldo;
- lote/série/validade;
- entradas, saídas, ajustes;
- reservas;
- transferências com trânsito;
- inventário;
- etiquetas básicas;
- reconciliação de saldo.

**Saída:** estoque auditável e concorrência testada.

## Marco 3 — Comercial e expedição

- orçamento versionado;
- pedido, aprovação e reserva;
- venda e devolução básica;
- separação por leitura;
- embalagem/volumes;
- conferência e despacho;
- impressão de etiquetas;
- status compostos.

**Saída:** venda local completa, da cotação à baixa física.

## Marco 4 — Financeiro inicial

- contas e categorias;
- títulos/parcelas;
- contas a pagar/receber;
- caixa e bancos;
- baixa parcial/total e estorno;
- rateios e centros de custo;
- fluxo previsto/realizado;
- visão individual/consolidada.

**Saída:** efeitos da venda e operações manuais controlados.

## Marco 5 — Mercado Livre

- aplicação e OAuth;
- conexão por empresa;
- categoria/atributos;
- publicação e alteração;
- preço/estoque;
- webhooks;
- importação de pedidos;
- logística necessária;
- painel de sincronização;
- retry/dead-letter/reconciliação;
- piloto com conta real controlada.

**Saída:** venda local e Mercado Livre compartilham estoque com rastreabilidade.

## Marco 6 — Compras

- pedido de compra;
- aprovação;
- recebimento parcial;
- qualidade e lote;
- devolução;
- geração financeira;
- preparação para documento fiscal de entrada.

## Marco 7 — Produção e terceirização

- BOM/roteiro versionados;
- OP e materiais;
- apontamentos, resultados e perdas;
- custos previstos/realizados;
- ordem de industrialização externa;
- remessa, trânsito e terceiro;
- retorno, transformação e genealogia;
- exemplo completo de tecido/tinturaria.

**Saída:** rastreabilidade do insumo ao produto final interno ou terceirizado.

## Marco 8 — NF-e

- parâmetros e regras fiscais validadas;
- certificado A1;
- NFePHP encapsulado;
- emissão em homologação;
- autorização/rejeição/consulta;
- DANFE/XML;
- cancelamento, inutilização e CC-e conforme definição;
- venda, devolução e operações de industrialização definidas com contador;
- entrada gradual em produção.

## Marco 9 — Evoluções

- Shopee/Amazon após homologação;
- conciliação bancária automática;
- agente local de impressão;
- MRP e planejamento avançado;
- comissões;
- portal B2B;
- API pública;
- BI/data warehouse;
- app móvel seletivo.

## Backlog transversal

Em todos os marcos:

- permissões;
- auditoria;
- acessibilidade;
- testes multiempresa;
- desempenho;
- importação/migração;
- documentação operacional;
- métricas e alertas;
- backup/restore;
- LGPD.

## Estratégia de releases

- versões semânticas;
- changelog;
- feature flags;
- piloto com uma empresa interna/controlada;
- expansão por módulos;
- migrations compatíveis;
- rollback definido;
- nenhuma integração fiscal diretamente em todos os clientes sem período piloto.

## Primeiro ciclo recomendado ao Claude Code

1. Bootstrap sem framework e testes do núcleo.
2. Migration runner.
3. Request/Response/router/middleware.
4. autenticação e sessão segura.
5. grupo/empresa/estabelecimento.
6. contexto selecionado.
7. RBAC/Policies.
8. módulos habilitados.
9. auditoria/outbox.
10. layout base.

Somente depois iniciar Produto. Isso evita que as telas nasçam sem isolamento e autorização.

## Referência competitiva (Bling)

Comparação feita em 2026-09-17 contra a tabela de planos do Bling
(https://www.bling.com.br/planos-e-precos), para acompanhar o quanto o
N4STi Gestão se aproxima de um ERP comercial maduro ao longo dos marcos.
O diferencial do N4STi Gestão sobre o Bling é a Produção/Fábrica (BOM,
roteiro, OP, apontamento, industrialização externa com genealogia de lote)
— algo que o Bling não oferece. Os itens abaixo são o que o Bling tem e
o N4STi Gestão ainda não cobre; não são compromisso de entrega, são
candidatos a avaliar por demanda real ao evoluir o roadmap:

- **Loja virtual nativa**: editor no-code, checkout transparente, domínio
  próprio, recuperação de carrinho, cupons/promoções, SEO/IA de conteúdo.
- **PDV (frente de caixa)**: caixas individuais, integração com maquininha
  POS, balança comercial, controle de mesas, cobrança Pix QR-Code
  conciliada automaticamente.
- **Conta digital PJ / meios de pagamento**: emissão de boletos com
  conciliação automática, pagamento de contas por código de barras, link
  de pagamento, pagamento automático de DAS-MEI e de folha, empréstimo.
- **Conciliação bancária automática por importação de extrato (OFX)** e
  **DRE/fluxo de caixa prontos** (Marco 9 já prevê conciliação; formalizar
  DRE como relatório).
- **Notas fiscais além da NF-e/NFC-e**: NFS-e (municipal e NFS-e Nacional),
  GNRE (emissão e pagamento em lote), importação de CT-e, notas de
  importação/exportação, espaço para o contador.
- **Logística própria estilo "Bling Envios"**: painel pós-postagem,
  cotação automática multi-transportadora, geração/impressão de etiqueta
  com DANFE simplificado, gestão de ocorrências, logística reversa.
- **Serviços**: ordens de serviço e contratos de serviço (hoje o N4STi
  Gestão foca em produto; serviço como documento de primeira classe é
  lacuna).
- **Chatbot de vendas em redes sociais** e **agentes de IA** (descrição/SEO
  de produto, geração de imagem, sugestão em anúncios).
- **Multiempresa com visão gerencial consolidada dentro do mesmo plano**
  (o N4STi Gestão já nasce multiempresa por design — ADR-003/ADR-006 —,
  então isso tende a já estar coberto estruturalmente antes mesmo de virar
  tela; validar quando o financeiro consolidado for construído).

Não copiar cegamente limites comerciais do Bling (cota de usuários,
armazenamento, pedidos importados por faixa) — esses são parâmetros de
plano SaaS deles, não requisitos funcionais do N4STi Gestão.