DialFix India & Ireland

CodeMyContacts — Descrição Completa do Aplicativo
======================================

VISÃO GERAL
--------
O CodeMyContacts é um aplicativo utilitário para Android desenvolvido com Kotlin e Jetpack Compose. Ele audita
e limpa a lista de contatos do seu telefone, com foco principal em garantir que cada número de telefone
tenha o código de país internacional correto. O aplicativo é voltado para usuários que transitam entre a Índia (+91)
e a Irlanda (+353) e acumulam contatos em formatos mistos ao longo do tempo.

O PROBLEMA QUE ELE RESOLVE
---------------------
Contatos telefônicos salvos sem o código de país (por exemplo, 9876543210 em vez de +91 9876543210)
quebram chamadas internacionais, correspondência do WhatsApp e outros serviços que dependem do formato internacional E.164. Este aplicativo escaneia, identifica e corrige em lote esses números — com segurança,
com uma etapa de revisão antes de qualquer alteração ser gravada.

RECURSOS
--------

1. Escanear e Formatar Contatos

- Lê todos os contatos (ou um subconjunto recente filtrado) e identifica números sem o código do país.

- Exibe uma tela de revisão listando todas as alterações propostas antes de qualquer alteração ser gravada.

- Classifica automaticamente os números como indianos ou irlandeses, analisando padrões de dígitos
(comprimento, dígitos iniciais).

- Números ambíguos — por exemplo, um número de 9 dígitos começando com 8 que pode ser irlandês —
são sinalizados e exigem que o usuário escolha o país antes de prosseguir.

- Uma configuração de País Padrão configurável pode resolver silenciosamente números ambíguos sem
intervenção do usuário.

- Detecção de duplicados: se a formatação de um número criar uma entrada que já existe
formatada, esse número é ignorado automaticamente para evitar a criação de um duplicado.

- Todas as alterações são aplicadas em um único lote; O estado anterior é salvo para que toda a
execução possa ser desfeita com um único toque.

- Após a aplicação, um relatório de texto compartilhável é gerado, listando todas as
alterações "original → formatado".

2. Limpar Contatos Duplicados

- Busca contatos onde o mesmo número subjacente existe tanto em formato formatado
(+91 / +353) quanto em formato não formatado.

- Apresenta uma lista de revisão mostrando qual entrada será excluída (o número sem formatação) e
qual será mantida (o número formatado).

- Exclui todos os duplicados confirmados em uma única operação.

3. Verificar Números Suspeitos

- Sinaliza números salvos sem o prefixo + mas que não podem ser identificados como indianos
ou irlandeses.

- Detecta números muito curtos (menos de 7 dígitos) ou simplesmente em um
formato não reconhecido — útil para identificar erros de digitação ou entradas indesejadas.

4. Contatos sem número de telefone

- Lista todos os contatos que não possuem nenhum número de telefone salvo, para que você possa decidir

se deseja adicionar um número ou limpar o registro.

5. Painel inicial

Exibe cinco cartões de estatísticas em tempo real na tela inicial:

- Total de contatos

- Precisa formatar (destacado em vermelho se > 0)

- Duplicados encontrados (destacado em vermelho se > 0)

- Já formatados

- Sem número de telefone (destacado em vermelho se > 0)

6. Monitoramento em segundo plano

- Uma tarefa periódica opcional (com tecnologia WorkManager) que é executada a cada 6 horas.

- Se encontrar algum contato sem código de país, envia uma notificação solicitando
ao usuário que abra o aplicativo e corrija o problema.

- Pode ser ativado ou desativado a qualquer momento nas Configurações.

7. Histórico

- Um registro de cada sessão de formatação, mostrando a data, quantos números foram atualizados,

quantos foram ignorados e se a sessão foi desfeita. - O histórico pode ser apagado na tela Histórico.

8. Configurações

- País padrão para números ambíguos: Sempre perguntar / Atribuir automaticamente à Índia /
Atribuir automaticamente à Irlanda.

- Filtro de verificação: Verificar todos os contatos ou apenas os contatos modificados nos últimos 7 ou 30 dias.

- Ativar/desativar a observação em segundo plano: Ativar ou desativar a verificação periódica em segundo plano a cada 6 horas.