# Manual do Usuário

## 1. Acesso

1. Abra o sistema no navegador.
2. Informe usuário e senha.
3. No primeiro acesso, troque a senha.

## 2. Tela principal

A tela principal concentra:

- formulário de nova demanda
- painel geral
- filtros rápidos
- listagem das demandas
- acesso ao mapa
- acesso aos módulos administrativos, conforme permissão

## 3. Cadastrar uma demanda

Preencha os campos principais:

- número
- tipo
- data de abertura
- assunto
- endereço
- complemento, se houver
- observações
- origem/processo
- destino
- requerente
- vereador, se houver
- tramitação
- execução
- situação

Depois clique em:

- `Registrar demanda`

## 4. Editar uma demanda

Na listagem:

1. clique em `Editar`
2. ajuste os campos
3. clique em `Atualizar demanda`

## 5. Excluir uma demanda

Na listagem:

1. clique em `Excluir`
2. confirme a exclusão

## 6. Histórico

Cada demanda possui:

- botão `Histórico`

Nele é possível ver:

- alterações realizadas
- usuário responsável
- momento da alteração

## 7. Filtros rápidos

Os filtros permitem localizar demandas por:

- base/ano
- palavra-chave
- assunto
- requerente
- origem/processo
- tipo
- destino
- vereador
- situação
- tramitação
- execução
- período

Use `Limpar filtros` para restaurar a visualização padrão.

## 8. Busca

A busca considera:

- número
- origem/processo
- texto livre
- variações de formatação

O sistema prioriza número exato quando ele existe.

## 9. Relatórios

Na área `Demandas registradas`, use:

- `Exportar CSV`
- `Imprimir relatório`
- `Narrativa IA`

Os relatórios podem usar:

- ano da demanda
- ano da execução
- combinação de ambos, conforme configuração

## 10. Relatório por vereador

A seção mostra cards dos vereadores com demandas vinculadas.

Ao clicar no card:

- abre a lista das demandas daquele vereador
- mostra endereço
- mostra situação
- destaca total de executados

## 11. Mapa georreferenciado

O mapa permite:

- visualizar demandas no território
- usar heatmap
- abrir em nova aba
- imprimir/exportar
- filtrar por base, assunto, situação e vereador
- auditar pendências de georreferenciamento

## 12. Importação

O sistema aceita:

- `.xlsx`
- `.odt`

Fluxo:

1. clique em `Importar XLSX/ODT`
2. selecione o arquivo
3. revise a pré-visualização
4. confirme a importação

Recursos no preview:

- triagem IA em lote
- autoaplicação de sugestões IA
- alertas de duplicidade
- validação estrutural

## 13. Administração

Conforme o perfil, a área `Administração` pode incluir:

- usuários
- destinos
- auditoria
- qualidade dos dados
- backup/restauração

## 14. Qualidade dos dados

O módulo de qualidade mostra:

- base inconsistente
- pendências de coordenadas
- vereadores compostos
- endereços suspeitos
- assuntos fora do padrão
- risco operacional
- backlog priorizado por IA
- analytics da IA

## 15. Ferramentas de IA

O sistema possui:

- assistente de triagem
- insights IA por demanda
- narrativa automática
- deduplicação semântica
- geocodificação assistida
- leitura de anexo
- busca conversacional

## 16. Atalhos operacionais

Dependendo da tela, o sistema suporta atalhos como:

- `/` para focar a busca principal por palavra-chave.
  Use quando o cursor não estiver digitando em um campo de formulário.
- `Esc` para fechar modais abertos.
  Se não houver modal aberto, também pode cancelar edição em andamento, sair do mapa maximizado ou encerrar ajustes temporários.
- `Ctrl+Enter` para enviar o formulário principal da demanda enquanto você estiver digitando em um campo.
  Em macOS, o atalho equivalente é `Cmd+Enter`.
- `Alt+N` para focar rapidamente o campo `Número`.
- `Alt+M` para abrir a área do mapa.

## 17. Observações importantes

- mudanças são auditadas
- o histórico da demanda não substitui backup
- filtros ativos podem ocultar registros que existem na base