# Guia — Importação Excel e qualidade dos dados

## Objetivo desta fase

O centro de importação lê o ficheiro Excel e cria uma **pré-visualização de revisão**. Nesta versão, a análise não cria nem altera clientes, serviços, domínios, alojamentos, pagamentos ou projetos reais.

## Folhas reconhecidas

- `Alojamentos`
- `Domínios` ou `Dominios`
- `Websites`
- `Domínios Associados` ou `dominios associados`

Se o campo **Folhas selecionadas** ficar vazio, a plataforma deteta automaticamente as folhas suportadas.

## Fluxo de utilização

1. Abrir **Dados e qualidade > Importações Excel**.
2. Criar uma nova importação e carregar o ficheiro `.xlsx`.
3. Guardar o registo.
4. Na listagem, selecionar o ficheiro e executar **Analisar os ficheiros selecionados**.
5. Abrir **Rever linhas**.
6. Comparar os dados originais com os campos normalizados.
7. Escolher uma decisão para cada linha:
   - Importar;
   - Ignorar;
   - Arquivar como histórico;
   - Associar a registo existente;
   - Por decidir.
8. Corrigir manualmente cliente, serviço, domínio, data, valores ou notas quando necessário.
9. Quando não existirem erros bloqueantes nem linhas por decidir, executar **Validar seleção e marcar como pronta**.

## Validações automáticas atuais

- fórmulas com `#REF!`;
- ausência de domínio ou identificação principal;
- vários domínios na mesma célula;
- datas de renovação vazias ou inválidas;
- clientes inferidos que precisam de confirmação;
- domínios já existentes na plataforma;
- duplicações dentro do próprio Excel;
- dados técnicos sem pasta ou base de dados;
- folhas não suportadas.

## Estados da análise

- **Carregado:** ficheiro guardado, ainda não analisado;
- **Em análise:** leitura em curso;
- **Em revisão:** linhas disponíveis para validação;
- **Pronto para importar:** todas as decisões foram tomadas e não há erros bloqueantes;
- **Falhou:** ocorreu um erro na leitura;
- **Cancelado:** processo abandonado;
- **Importado:** reservado para a fase em que a confirmação final criar os registos reais.

## Limite intencional

A ação final de escrita nas tabelas de negócio está desativada nesta entrega. Esta proteção permite confirmar primeiro o mapeamento do Excel e evitar que dados antigos, duplicados ou ambíguos contaminem a base de dados.

## Validação com o Excel original

O analisador foi executado com o ficheiro `Alojamentos2020.xlsx` e reconheceu automaticamente as quatro folhas relevantes. A leitura terminou em estado **Em revisão**, sem criar dados de negócio.
