# Especificação do Produto

## Visão

O N4STi Gestão é uma plataforma de gestão operacional para empresas comerciais e industriais. Seu diferencial é manter uma única rastreabilidade entre venda, marketplace, estoque, compra, produção, industrialização externa, expedição, financeiro e fiscal.

## Perfis de cliente

1. Comércio com venda local e Mercado Livre.
2. Distribuidor com múltiplos depósitos e representantes.
3. Grupo empresarial com vários CNPJs e visão consolidada.
4. Indústria discreta com componentes, peças e montagem.
5. Indústria por processo/lote, como tecidos, tinturaria e beneficiamento.
6. Empresa que terceiriza etapas produtivas.

## Capacidades funcionais

### Plataforma

- grupos, empresas, estabelecimentos e depósitos;
- usuários, equipes, funções e permissões por escopo;
- módulos habilitáveis por empresa;
- numerações e sequências por empresa/estabelecimento;
- anexos, comentários, tarefas e auditoria;
- notificações internas;
- importação/exportação controlada;
- preferências regionais, moedas, unidades e timezone.

### Cadastros

- pessoas físicas/jurídicas com papéis múltiplos;
- clientes, fornecedores, transportadoras e terceiros industriais;
- endereços, contatos, documentos e dados bancários;
- produtos, serviços, variantes, kits e componentes;
- categorias, marcas, unidades, atributos e imagens;
- tributação por empresa e classificação fiscal;
- tabelas de preço e condições comerciais.

### Comercial

- orçamento versionado;
- pedido de venda;
- aprovação por desconto/limite;
- reserva de estoque;
- venda balcão e venda faturada;
- comissão estruturalmente prevista;
- devolução, troca e cancelamento;
- múltiplas formas de pagamento;
- status operacional e financeiro separados.

### Estoque e WMS leve

- múltiplos depósitos e endereçamentos;
- movimentos imutáveis;
- estoque físico, reservado, disponível, bloqueado, em trânsito e com terceiros;
- lote, série, validade e rastreabilidade;
- inventário rotativo e geral;
- transferência com expedição e recebimento;
- separação, conferência e embalagem por código de barras;
- etiquetas de produto, lote, volume e expedição.

### Compras

- solicitação e cotação previstas;
- pedido de compra;
- recebimento parcial ou total;
- divergência de quantidade/preço;
- entrada de estoque;
- vínculo financeiro e fiscal;
- devolução ao fornecedor.

### Financeiro

- contas a pagar e receber;
- parcelas, juros, multa, desconto e baixa parcial;
- caixa, bancos e transferências;
- categorias e centros de custo;
- rateio entre centros, projetos e empresas quando permitido;
- fluxo de caixa previsto/realizado;
- conciliação manual inicialmente;
- consolidação gerencial por grupo;
- vínculo obrigatório com documentos de origem.

### Produção

- ficha técnica/BOM versionada;
- roteiro e operações;
- ordem de produção;
- necessidade, reserva e consumo de materiais;
- apontamento de produção, mão de obra, máquina e perda;
- produtos intermediários e acabados;
- coprodutos/subprodutos previstos;
- lote e rastreabilidade de entrada/saída;
- custo previsto e realizado;
- reprocesso e desmontagem previstos no modelo.

### Industrialização externa

- ordem de beneficiamento/terceirização;
- separação e remessa de insumos;
- estoque em trânsito e em poder do terceiro;
- confirmação de recebimento pelo terceiro opcional;
- retorno parcial, total, perdas e sobras;
- transformação de um SKU/lote em outro;
- serviço cobrado pelo terceiro e custos adicionais;
- materiais adicionados pelo terceiro;
- reconciliação do que foi enviado, consumido, devolvido e perdido;
- suporte fiscal posterior a remessa e retorno de industrialização.

### Marketplace

- conexão OAuth por empresa e conta;
- anúncios, variações, imagens, preço e estoque;
- mapeamento de categorias/atributos;
- importação de pedidos;
- reservas e baixa centralizada;
- tratamento de cancelamentos e devoluções;
- sincronização assíncrona com reconciliação;
- dashboard de falhas e reprocessamento;
- Mercado Livre na primeira integração.

### Fiscal

- perfil fiscal por empresa;
- certificado A1 e ambiente;
- NF-e, eventos e DANFE via NFePHP;
- numeração e série isoladas;
- XML autorizado e protocolo imutáveis;
- cancelamento, inutilização e CC-e conforme escopo aprovado;
- regras por natureza de operação;
- armazenamento e distribuição de XML;
- preparação estrutural para documentos futuros.

## Requisitos não funcionais

- disponibilidade-alvo inicial: 99,5% mensal, excluindo manutenção programada;
- páginas comuns: p95 inferior a 800 ms no backend sem chamadas externas;
- comandos operacionais por leitor: resposta percebida inferior a 300 ms quando local ao sistema;
- RPO inicial de 15 minutos e RTO de 4 horas;
- logs estruturados e métricas por módulo;
- acessibilidade compatível com WCAG 2.1 AA nos fluxos principais;
- suporte às versões atuais de Chrome e Edge;
- português do Brasil como idioma inicial;
- LGPD: minimização, finalidade, controle de acesso e trilha de tratamento.

## Indicadores do produto

- pedidos importados sem intervenção;
- tempo entre venda e reserva de estoque;
- divergências de sincronização;
- acurácia de estoque;
- tempo de separação e expedição;
- ordens produzidas dentro do prazo;
- perdas de produção;
- inadimplência e caixa projetado;
- erros fiscais por causa;
- incidentes de autorização/isolamento: meta zero.