parser.py

# -*- coding: utf-8 -*-
"""
NPN Decoder - Motor de Análisis y Validación del Número Predial Nacional.
"""

import re
from .dane_codes import DEPARTMENTS, MUNICIPIOS

CONDICION_PREDIO = {
    "0": "No reglamentado en Propiedad Horizontal (No PH)",
    "1": "Servidumbre de tránsito o similar / Condición especial",
    "2": "Predio informal (Ocupación / Posesión)",
    "3": "Bien de uso público diferente a vía",
    "4": "Vía pública",
    "5": "Mejora por edificación en terreno ajeno (no PH)",
    "6": "Mejora por edificación en terreno ajeno sometida a PH",
    "7": "Parque cementerio",
    "8": "Sometido a PH con área de terreno común y privada (Condominio / Conjunto cerrado)",
    "9": "Sometido a PH con área de terreno exclusivamente común (PH Estándar)"
}

ZONA_PREDIO = {
    "00": "Zona Rural (Vereda)",
    "01": "Zona Urbana (Cabecera Municipal)",
}

def clean_npn(npn_str):
    """Limpia el NPN eliminando espacios, guiones, puntos y caracteres especiales.

    :param npn_str: Cadena de texto del NPN a limpiar.
    :return: NPN limpio de solo dígitos.
    """
    if not npn_str:
        return ""
    # Remover todo lo que no sea dígito
    return re.sub(r"\D", "", str(npn_str))

def parse_npn(npn_str):
    """Analiza y desglosa el Número Predial Nacional (NPN) de 22 o 30 dígitos
    siguiendo con rigor catastral la Resolución 1149 de 2021 de la Divipola (DANE) e IGAC.

    :param npn_str: Cadena del NPN.
    :return: Diccionario con los resultados del análisis y desglose.
    """
    original = str(npn_str).strip()
    npn_clean = clean_npn(original)

    result = {
        "original": original,
        "clean": npn_clean,
        "valid": False,
        "error": None,
        "format": None,  # '30-digitos', '22-digitos', 'invalido'
        "components": {},
        "parsed_components": [],  # Lista estructurada de componentes catastrales para renderizado dinámico
        "details": {}
    }

    if not npn_clean:
        result["error"] = "El código catastral está vacío."
        return result

    if not npn_clean.isdigit():
        result["error"] = "El código contiene caracteres no numéricos."
        return result

    length = len(npn_clean)
    if length != 30 and length != 22:
        result["error"] = f"Longitud incorrecta ({length} dígitos). Debe tener 22 o 30 dígitos."
        return result

    # 1. Obtener nombres geográficos
    dpto = npn_clean[0:2]
    mpio_rel = npn_clean[2:5]
    mpio_full = npn_clean[0:5]
    dpto_name = DEPARTMENTS.get(dpto, "Departamento Desconocido")
    mpio_name = MUNICIPIOS.get(mpio_full, "Municipio Desconocido")
    
    # 2. Obtener Zona
    zona = npn_clean[5:7]
    zona_desc = ZONA_PREDIO.get(zona)
    if not zona_desc:
        if zona.isdigit() and int(zona) >= 2:
            zona_desc = f"Zona Urbana - Corregimiento No. {int(zona):02d}"
        else:
            zona_desc = f"Zona Especial ({zona})"

    is_rural = (zona == "00")
    manzana_vereda_label = "Vereda" if is_rural else "Manzana"

    # Inicialización por defecto de descripciones para evitar NameError potenciales
    condicion_desc = ""
    construccion_desc = ""

    # Configuración de parsing según la longitud
    if length == 30:
        result["format"] = "30-dígitos (Resolución 1149 de 2021)"
        result["valid"] = True
        
        # Desglose 30 dígitos exacto según estándar catastral nacional
        sector = npn_clean[7:9]
        comuna = npn_clean[9:11]
        barrio = npn_clean[11:13]
        manzana_vereda = npn_clean[13:17]
        terreno = npn_clean[17:21]
        condicion = npn_clean[21]
        torre = npn_clean[22:24]
        piso = npn_clean[24:26]
        unidad_ph = npn_clean[26:30]
        
        condicion_desc = CONDICION_PREDIO.get(condicion, f"Condición Especial ({condicion})")
        
        # Guardar en diccionario estructurado
        result["components"] = {
            "departamento": dpto,
            "municipio": mpio_rel,
            "zona": zona,
            "sector": sector,
            "comuna": comuna,
            "barrio": barrio,
            "manzana_vereda": manzana_vereda,
            "terreno": terreno,
            "condicion": condicion,
            "torre": torre,
            "piso": piso,
            "unidad_ph": unidad_ph
        }
        
        # Generar lista de componentes detallada para la UI
        result["parsed_components"] = [
            {"name": "Código de Departamento", "positions": "1 - 2", "code": dpto, "desc": dpto_name},
            {"name": "Código de Municipio", "positions": "3 - 5", "code": mpio_rel, "desc": mpio_name},
            {"name": "Zona (Área del predio)", "positions": "6 - 7", "code": zona, "desc": zona_desc},
            {"name": "Sector catastral", "positions": "8 - 9", "code": sector, "desc": f"Sector Catastral {sector}"},
            {"name": "Comuna", "positions": "10 - 11", "code": comuna, "desc": f"Comuna / Localidad {comuna}" if comuna != "00" else "Sin Comuna (No aplica o Rural)"},
            {"name": "Barrio", "positions": "12 - 13", "code": barrio, "desc": f"Barrio Catastral {barrio}" if barrio != "00" else "Sin Barrio (No aplica o Rural)"},
            {"name": manzana_vereda_label, "positions": "14 - 17", "code": manzana_vereda, "desc": f"{manzana_vereda_label} {manzana_vereda.lstrip('0') or '0'}"},
            {"name": "Terreno", "positions": "18 - 21", "code": terreno, "desc": f"Código de Terreno {terreno.lstrip('0') or '0'} individual"},
            {"name": "Condición del predio", "positions": "22", "code": condicion, "desc": condicion_desc},
            {"name": "Número de Edificio / Torre", "positions": "23 - 24", "code": torre, "desc": f"Edificio o Torre {torre.lstrip('0') or '0'}" if torre != "00" else "No aplica (Lote o Terreno matriz)"},
            {"name": "Número de Piso", "positions": "25 - 26", "code": piso, "desc": f"Piso {piso.lstrip('0') or '0'}" if piso != "00" else "No aplica (Lote o Nivel 0)"},
            {"name": "Unidad PH / Mejora", "positions": "27 - 30", "code": unidad_ph, "desc": f"Unidad Catastral {unidad_ph.lstrip('0') or '0'} en Propiedad Horizontal o Mejora" if unidad_ph != "0000" else "No aplica (Terreno matriz / Unidad global)"}
        ]
        
        construccion_desc = "Sin construcciones en PH"
        if any(c != '0' for c in (torre + piso + unidad_ph)):
            construccion_desc = f"Torre/Edif: {torre.lstrip('0') or '0'}, Piso: {piso.lstrip('0') or '0'}, Unidad: {unidad_ph.lstrip('0') or '0'}"
        
    elif length == 22:
        result["format"] = "22-dígitos (Formato Histórico Anterior)"
        result["valid"] = True
        
        # Desglose histórico 22 dígitos
        sector = npn_clean[7:9]
        manzana_vereda = npn_clean[9:13]
        terreno = npn_clean[13:17]
        condicion = npn_clean[17]
        construccion = npn_clean[18:22]
        
        condicion_desc = CONDICION_PREDIO.get(condicion, f"Condición Especial ({condicion})")
        construccion_desc = f"Unidad Constructiva: {construccion.lstrip('0') or '0'}" if any(c != '0' for c in construccion) else "Sin construcciones"
        
        result["components"] = {
            "departamento": dpto,
            "municipio": mpio_rel,
            "zona": zona,
            "sector": sector,
            "manzana_vereda": manzana_vereda,
            "terreno": terreno,
            "condicion": condicion,
            "construccion": construccion
        }
        
        result["parsed_components"] = [
            {"name": "Código de Departamento", "positions": "1 - 2", "code": dpto, "desc": dpto_name},
            {"name": "Código de Municipio", "positions": "3 - 5", "code": mpio_rel, "desc": mpio_name},
            {"name": "Zona", "positions": "6 - 7", "code": zona, "desc": zona_desc},
            {"name": "Sector catastral", "positions": "8 - 9", "code": sector, "desc": f"Sector Catastral {sector}"},
            {"name": manzana_vereda_label, "positions": "10 - 13", "code": manzana_vereda, "desc": f"{manzana_vereda_label} {manzana_vereda.lstrip('0') or '0'}"},
            {"name": "Terreno", "positions": "14 - 17", "code": terreno, "desc": f"Código de Terreno {terreno.lstrip('0') or '0'}"},
            {"name": "Condición del predio", "positions": "18", "code": condicion, "desc": condicion_desc},
            {"name": "Construcción / Unidad", "positions": "19 - 22", "code": construccion, "desc": construccion_desc}
        ]

    result["details"] = {
        "departamento_nombre": dpto_name,
        "municipio_nombre": mpio_name,
        "zona_descripcion": zona_desc,
        "manzana_vereda_tipo": manzana_vereda_label,
        "condicion_descripcion": condicion_desc,
        "construccion_descripcion": construccion_desc,
        "departamento_municipio": f"{dpto_name} - {mpio_name}"
    }

    # Advertencias de coherencia
    if dpto_name == "Departamento Desconocido":
        result["valid"] = False
        result["error"] = f"El código de departamento '{dpto}' no es válido en la división política de Colombia."
    elif mpio_name == "Municipio Desconocido":
        result["details"]["municipio_nombre"] = f"Código DANE {mpio_rel} (Municipio no indexado)"

    return result