# Manual do Sistema — MAIORE Simulador Tributário

| Campo | Valor |
|-------|--------|
| Sistema | **MAIORE — Simulador Tributário** |
| URL de referência | http://simulador-tributario.local |
| Público | Analistas, contadores e administradores |
| Versão | 1.1 |
| Data | 2026-09-29 |

> **Este é o manual de uso.** Orientação prática: o que fazer em cada tela, passo a passo.  
> Para regras de negócio e casos de uso formais, veja a [Documentação Funcional](DOCUMENTACAO_FUNCIONAL_SISTEMA.md).  
> Para arquitetura e código, veja a [Especificação Técnica](ESPECIFICACAO_TECNICA.md).

---

## 1. O que é o Simulador Tributário

O MAIORE Simulador Tributário é o sistema web para:

- importar **SPED** e montar análises fiscais;
- conferir a **qualidade dos dados** (prontidão / pendências);
- simular o impacto da **Reforma Tributária (CBS + IBS)**;
- comparar com o **regime atual**;
- exportar **PDF/Excel** para apresentação.

Acesse pelo navegador (ambiente de referência): **http://simulador-tributario.local**

---

## 2. Como entrar no sistema

### 2.1 Login

1. Abra a página de login (`/sign-in`).
2. Informe seu **usuário** (ou e-mail) e **senha**.
3. Clique em **Entrar**.
4. Você será direcionado à lista de **Simulações**.

![Tela de login](pdf-assets/login.jpg)

### 2.2 Esqueci minha senha

1. Na tela de login, clique em **Esqueci minha senha**.
2. Informe o e-mail cadastrado.
3. Abra o e-mail recebido e defina uma nova senha.

![Recuperar senha](pdf-assets/recuperar-senha.jpg)

### 2.3 Avisos importantes

- Se você abrir o sistema em outro computador/navegador, a sessão anterior pode ser desconectada (**sessão única**).
- Não compartilhe senha.

---

## 3. Menu principal

Após o login, o menu lateral organiza as funções:

| Grupo | Itens |
|-------|--------|
| Principal | Simulações · Cenários CBS/IBS |
| Cadastros | Clientes · Pendências |
| Sistema | Auditoria · Feedback testes · Usuários |

A biblioteca **De-para** e o **upload SPED** também existem no fluxo da simulação (mesmo sem item dedicado no menu).

![Lista de Simulações (tela inicial)](pdf-assets/simulacoes-listagem.jpg)

---

## 4. Fluxo completo em 5 etapas

O produto foi desenhado em cinco etapas. A própria tela mostra o progresso:

| Etapa | O que você faz | Resultado |
|-------|----------------|-----------|
| 1. Ingestão | Importa SPEDs (lote anual recomendado) | Dados do cliente no sistema |
| 2. Confronto | Revisa produtos, NCM, cadastro e pendências | Score de prontidão |
| 3. Parametrização | Ajusta de-para e alíquotas/cenário | Premissas claras |
| 4. Simulação | Calcula reforma CBS/IBS | Comparativo atual × reforma |
| 5. Dashboard | Lê o resumo e exporta PDF/Excel | Entregável consultivo |

![Edição da simulação (wizard)](pdf-assets/simulacao-edicao.jpg)

---

## 5. Clientes

**Caminho:** menu **Clientes**.

### Para que serve
Cadastro das empresas analisadas (CNPJ, regime, UF etc.).

### Como usar

1. Consulte a listagem.
2. Inclua ou edite o cliente necessário.
3. Salve.

> **Dica:** para começar uma análise, você pode ir direto em **Simulações → Nova simulação → Importar lote SPED**. O sistema lê o CNPJ no arquivo e detecta/cria o cliente automaticamente.

![Clientes](pdf-assets/clientes-listagem.jpg)

![Novo cliente](pdf-assets/clientes-cadastro.jpg)

---

## 6. Criar uma simulação e importar SPED

**Caminho:** menu **Simulações** → **Nova simulação**.

### Opção recomendada — Importar lote SPED

1. Na área **Importar lote SPED**, selecione os arquivos `*SPED-EFD.txt` e, se tiver, `PISCOFINS_*.txt`.
2. Em **Cliente**, deixe detectar automaticamente pelos arquivos (quando disponível).
3. Clique em **Iniciar importação** e aguarde.
4. Volte à lista: a análise mensal ou consolidada anual aparecerá.

![Nova simulação](pdf-assets/nova-simulacao.jpg)

### Outras opções

- **Um arquivo SPED** — para um único período.
- **Cadastro manual** — quando não houver arquivo (mais trabalhoso).

---

## 7. Confronto e prontidão

**Caminho:** abrir a simulação → etapa **Confronto**.

### Para que serve
Fazer o “check-up” dos dados antes de confiar no resultado da reforma.

### Como usar

1. Revise o resumo de qualidade.
2. Trate NCM, cClassTrib e vínculos de cadastro nas sub-etapas.
3. Acompanhe as **Pendências** no menu correspondente.
4. Observe a classificação: **simulável**, **simulável com ressalva** ou **não simulável**.

![Confronto](pdf-assets/etapa-confronto.jpg)

![Pendências](pdf-assets/pendencias-listagem.jpg)

### Como tratar uma pendência

1. Abra **Pendências**.
2. Filtre por cliente/status/criticidade.
3. Altere o status (em revisão / resolvida / ignorada).
4. Ao resolver ou ignorar, informe a **justificativa**.

---

## 8. Parâmetros, De-para e Cenários

### Na simulação (etapa 3)

1. Revise as regras De-para da análise.
2. Ajuste parâmetros CBS/IBS e o ano de cenário.
3. Se quiser, copie regras da biblioteca De-para.

![Parâmetros / De-para](pdf-assets/etapa-depara.jpg)

### Menu Cenários CBS/IBS

1. Abra **Cenários CBS/IBS**.
2. Consulte/edite a tabela de transição por ano.
3. Sincronize do config quando necessário.

![Cenários](pdf-assets/cenarios.jpg)

### Biblioteca De-para

Acesse `/admin/depara` para manter templates reutilizáveis.

![De-para](pdf-assets/depara-listagem.jpg)

---

## 9. Simulação da Reforma CBS/IBS

**Caminho:** etapa **Simulação / Reforma** na edição.

### Como usar

1. Gere ou recalcule a reforma.
2. Revise produtos e classificação de origem (nacional, importado, exportação, serviço…).
3. Compare com o regime atual.
4. Se o sistema bloquear por prontidão “não simulável”, sane as pendências bloqueantes antes de recalcular.

![Reforma](pdf-assets/etapa-reforma.jpg)

![Regime atual](pdf-assets/etapa-regime-atual.jpg)

---

## 10. Dashboard consolidado e exportações

**Caminho:** etapa **Dashboard** / botão consolidado na lista.

### Como usar

1. Abra o resumo anual (ou o detalhe mensal).
2. Observe qualidade do dado, KPIs e comparativo real × simulação.
3. Exporte:
   - Excel / PDF da reforma;
   - Excel / PDF consolidado;
   - PDF executivo (quando disponível).

![Consolidado](pdf-assets/etapa-consolidado.jpg)

---

## 11. Auditoria, usuários e feedback

### Auditoria
**Caminho:** menu **Auditoria**.  
Consulte o histórico de alterações (parâmetros, pendências, versões etc.).

![Auditoria](pdf-assets/auditoria-listagem.jpg)

### Usuários
**Caminho:** menu **Usuários**.  
Crie/edite contas e papéis de acesso.

![Usuários](pdf-assets/usuarios-listagem.jpg)

### Feedback testes
**Caminho:** menu **Feedback testes**.  
Triagem de comentários feitos nos cartões de ajuda da interface.

![Feedback](pdf-assets/feedback-listagem.jpg)

---

## 12. Dicas rápidas

| Situação | O que fazer |
|----------|-------------|
| Não sei por onde começar | Login → Simulações → Nova simulação → lote SPED |
| Resultado parece “travado” | Veja Pendências e a prontidão no Confronto |
| Preciso apresentar ao cliente | Use o Dashboard e exporte PDF/Excel |
| Quero mudar alíquotas por ano | Menu Cenários CBS/IBS |
| Fui desconectado sem querer | Alguém pode ter entrado com o mesmo login (sessão única) |

---

## 13. O que o sistema NÃO faz

- Não substitui o contador nem gera guia oficial de pagamento.
- Não é o ERP fiscal (Domínio, SCI, Fortes etc.).
- Não é revisão completa de NCM como produto principal.

---

## 14. Glossário rápido

| Termo | Em linguagem simples |
|-------|----------------------|
| SPED | Arquivo fiscal que alimenta a análise |
| CBS / IBS | Tributos novos da reforma |
| Prontidão | Se a base está boa o bastante para simular |
| Pendência | Problema de dado que precisa de atenção |
| Confronto | Tela de conferência da qualidade |
| De-para | Regras de mapeamento fiscal |
| cClassTrib | Código de classificação da reforma |

---

## 15. Documentos relacionados

| Documento | Arquivo |
|-----------|---------|
| Documentação Funcional | `DOCUMENTACAO_FUNCIONAL_SISTEMA.pdf` |
| Especificação Técnica | `ESPECIFICACAO_TECNICA.pdf` |
| Acervo detalhado | pasta `documentacao-sistema/` |