DialFix India & Ireland

CodeMyContacts — Descripción completa de la aplicación
=======================================

DESCRIPCIÓN GENERAL
--------
CodeMyContacts es una aplicación de utilidad para Android desarrollada con Kotlin y Jetpack Compose. Audita
y limpia la lista de contactos de tu teléfono, centrándose principalmente en garantizar que cada número de teléfono
tenga el código de país internacional correcto. La aplicación está dirigida a usuarios que se desplazan entre India (+91)
e Irlanda (+353) y acumulan contactos en formatos mixtos con el tiempo.

EL PROBLEMA QUE RESUELVE
---------------------
Los contactos guardados sin código de país (por ejemplo, 9876543210 en lugar de +91 9876543210)
dificultan las llamadas internacionales, la función de emparejamiento de WhatsApp y otros servicios que dependen del formato internacional E.164. Esta aplicación escanea, identifica y corrige masivamente esos números, de forma segura,
con una revisión previa a cualquier cambio.

CARACTERÍSTICAS
--------

1. Escanear y formatear contactos

- Lee todos los contactos (o un subconjunto reciente filtrado) e identifica los números a los que les falta un
código de país.

- Muestra una pantalla de revisión con todos los cambios propuestos antes de que se guarden.

- Clasifica automáticamente los números como indios o irlandeses analizando patrones de dígitos
(longitud, dígitos iniciales).

- Los números ambiguos —por ejemplo, un número de 9 dígitos que empieza por 8 y que podría ser irlandés—
se marcan y requieren que el usuario seleccione el país antes de continuar.

- Una configuración de País predeterminado permite resolver automáticamente los números ambiguos sin
la intervención del usuario.

- Detección de duplicados: si formatear un número creara una entrada que ya existe
con formato, ese número se omite automáticamente para evitar crear un duplicado.

- Todos los cambios se aplican en un solo lote; Se guarda una copia de seguridad del estado anterior para que todo el proceso
se pueda deshacer con un solo toque.

- Tras aplicar los cambios, se genera un informe de texto compartible que enumera cada
cambio de "original → formateado".

2. Limpiar contactos duplicados

- Busca contactos con el mismo número subyacente tanto formateado

(+91 / +353) como sin formatear.

- Muestra una lista de revisión que indica qué entrada se eliminará (el número sin formato) y

cuál se conservará (el número formateado).

- Elimina todos los duplicados confirmados en una sola operación.

3. Comprobar números sospechosos

- Marca los números guardados sin el prefijo + pero que no se pueden identificar como indios
o irlandeses.

- Detecta números demasiado cortos (menos de 7 dígitos) o con un
formato no reconocido; útil para detectar errores tipográficos o entradas basura.

4. Contactos sin número de teléfono

- Muestra todos los contactos que no tienen ningún número de teléfono guardado, para que puedas decidir
si añadir un número o borrar la entrada.

5. Panel de inicio

Muestra cinco tarjetas de estadísticas en tiempo real en la pantalla de inicio:

- Total de contactos

- Necesitan formato (resaltado en rojo si > 0)

- Duplicados encontrados (resaltado en rojo si > 0)

- Ya formateados

- Sin número de teléfono (resaltado en rojo si > 0)

6. Monitor en segundo plano

- Una tarea periódica opcional (con tecnología de WorkManager) que se ejecuta cada 6 horas.

- Si encuentra algún contacto sin código de país, muestra una notificación que le indica
al usuario que abra la aplicación y lo corrija.

- Se puede activar o desactivar en cualquier momento desde Ajustes.

7. Historial

- Un registro de cada sesión de formateo que muestra la fecha, cuántos números se actualizaron,
cuántos se omitieron y si la sesión fue una operación de deshacer.
- El historial se puede borrar desde la pantalla de Historial.

8. Ajustes

- País predeterminado para números ambiguos: Preguntar siempre / Asignar automáticamente India /

Asignar automáticamente Irlanda.

- Filtro de escaneo: Escanear todos los contactos o solo los modificados en los últimos 7 o 30 días.

- Activar/desactivar la comprobación en segundo plano: Activar o desactivar la comprobación periódica en segundo plano cada 6 horas.