NPN Explorer Colombia 🇨🇴 - Complemento Catastral para QGIS

NPN Explorer Colombia es un plugin de alto rigor desarrollado para QGIS 3.x diseñado para agilizar la lectura, desglose, validación y control de calidad (QC) del Número Predial Nacional (NPN) de 30 y 22 dígitos en Colombia, integrando además consultas en tiempo real con la Ventanilla Única de Registro (VUR) de la Superintendencia de Notariado y Registro (SNR).

---

🌟 Características Principales

1. Descodificador de NPN Inteligente

• Desglosa en bloques interactivos los componentes del NPN: Departamento, Municipio, Zona, Sector, Manzana/Vereda, Terreno, Condición del predio y Unidad Constructiva.
• Resuelve códigos DANE al instante mapeando el departamento y municipio en texto comprensible gracias a su base de datos integrada.
• Identifica la condición jurídica según la posición 22 (PH, No PH, mejoras, matrices, condominios, etc.) e interpreta la unidad constructiva (torre, piso, apartamento).

2. Conexión Directa a la Ventanilla SNR (VUR)

• Autenticación SiteMinder Segura: Permite ingresar tu usuario y contraseña del portal VUR para realizar consultas reales en tiempo real.
• Modo de Simulación de Alto Rigor (Demo): Si no posees credenciales activas, puedes usar el motor de simulación catastral incorporado, el cual emula con precisión folios de matrículas reales, con sus propietarios, gravámenes e historiales.

3. Tablero Comparativo en Tiempo Real "Registro vs. Catastro"

Al identificar un predio en el mapa, el plugin confronta de manera paralela la información:

• Comparación Física de Áreas: Calcula el área métrica elipsoidal (QGIS) de la geometría del predio y la compara automáticamente con el área registrada en el Folio de Matrícula (VUR/SNR). Si se detectan discrepancias mayores al 5.0%, se enciende un cartel naranja de alerta física catastral.
• Cruce de Propietarios: Despliega los titulares de dominio inscritos en la SNR con su documento de identidad y porcentaje de participación.
• Alertas Jurídicas Críticas: Si el folio reporta medidas cautelares activas (🚨 EMBARGOS), se gatilla una alarma visual en el panel y un banner rojo de advertencia crítica del sistema en QGIS para proteger la seguridad jurídica de tus análisis.
• Línea de Tiempo de Anotaciones: Tabla dinámica con el historial completo de anotaciones del folio (Compraventas, Hipotecas, Embargos, etc.).

4. Herramientas Interactivas y Edición

• Identificación en Mapa: Activa el cursor de precisión y haz clic en cualquier predio para abrir el comparador. El plugin seleccionará visualmente el predio y reenfocará la pestaña al instante.
• Control de Calidad (QC) por Lotes: Analiza todos los predios de una capa vectorial e inyecta de forma automática los campos npn_valido (1/0) y npn_error en la tabla de atributos para facilitar la simbología temática.

---

📁 Estructura del Proyecto

El plugin contiene la siguiente estructura de archivos fuente:

• __init__.py: Inicializador del complemento en QGIS.
• metadata.txt: Datos administrativos del plugin para la tienda oficial de QGIS.
• plugin.py: Lógica central de interacción espacial, cálculo elipsoidal de áreas e integración de flujos de trabajo.
• ui.py: Panel lateral premium diseñado con estilos CSS avanzados (QSS).
• vur_client.py: Cliente HTTP seguro para el portal SiteMinder del VUR e inyección de simulaciones realistas.
• colombia_en_mapas_client.py: Cliente de API para interactuar con la plataforma "Colombia en Mapas" y recuperar metadatos geográficos.
• parser.py: Motor lógico de validación de estructuras NPN de 22/30 dígitos.
• dane_codes.py: Diccionario indexado de códigos de municipios y departamentos de Colombia.
• logger.py: Módulo de registro de logs centralizado, tanto a archivo local como a consola nativa de QGIS.
• icon.png: Logotipo moderno del plugin.
• build_zip.py: Script para compilar el plugin en un archivo .zip listo para publicar.

---

🛠️ Instalación para Desarrollo Local

Para probar e instalar el plugin localmente en tu QGIS:

Paso 1: Copiar a la carpeta de complementos de QGIS

Copia la carpeta completa PLUGGIN (o renombrarla a npn_explorer_colombia) dentro de la ruta de plugins activos de tu QGIS:

• Windows:
  C:\Users\<TuUsuario>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\

• Linux:
  ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/

• macOS:
  /Users/<TuUsuario>/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/

Paso 2: Activar el plugin en QGIS

1. Abre QGIS.
2. Ve al menú superior: Complementos → Administrar e instalar complementos.
3. En la sección Instalados, busca NPN Explorer Colombia y marca la casilla para activarlo.
4. Aparecerá el icono en tu barra de herramientas y en el menú Vectorial → NPN Explorer Colombia.

---

📦 Empaquetar y Publicar

Para generar el archivo ZIP de publicación compatible con la tienda de plugins oficial de QGIS:

1. Ejecuta el script build_zip.py en tu terminal:

   python build_zip.py

2. Esto generará el archivo npn_explorer_colombia.zip en la raíz del proyecto.
3. Sube el ZIP en: plugins.qgis.org/plugins/add/

---

🔗 Repositorio Oficial

Puedes acceder al código fuente, reportar problemas y colaborar en el repositorio oficial de GitHub del proyecto: 👉 DGZ-Engineering-Lab/NPN_Explorer