Exportacion de Datos Taxonomicos

FORMATO JSON - ESTRUCTURA JERARQUICA ANIDADA

Estructura Padre → Hijo (top-down): el arbol inicia en la raiz (nivel 0) y los descendientes estan en el array hijos. Facilita renderizado de TreeView.

{
  "metadata": {
    "nombre": "cargo_puesto",
    "version": "3.0_reorganizada",
    "total_categorias": 29
  },
  "jerarquia": [
    {
      "id": 1000,
      "nombre": "TODO EL PERSONAL",
      "observaciones": "NIVEL_0",
      "hijos": [
        {
          "id": 1100,
          "nombre": "FUNCIONARIOS JUDICIALES",
          "observaciones": "NIVEL_1",
          "hijos": [
            {
              "id": 1110,
              "nombre": "MAGISTRATURAS",
              "observaciones": "NIVEL_2",
              "hijos": []
            },
            {
              "id": 1120,
              "nombre": "JUDICATURAS",
              "observaciones": "NIVEL_2",
              "hijos": []
            }
          ]
        }
        // ... mas nodos
      ]
    }
  ]
}

FORMATO CSV - TABLA PLANA CON REFERENCIAS

Formato tabular apto para importacion directa a RDBMS. La jerarquia se reconstruye via JOINs.

id,nombre,parent_id,nivel
1000,TODO EL PERSONAL,,0
1100,FUNCIONARIOS JUDICIALES,1000,1
1110,MAGISTRATURAS,1100,2
1120,JUDICATURAS,1100,2
1200,AUXILIARES JUDICIALES,1000,1
1210,SECRETARIOS JUDICIALES,1200,2
1220,OFICIALES JUDICIALES,1200,2
1230,DILIGENCIAMIENTO Y EJECUCION,1200,2
1600,PERSONAL ADMINISTRATIVO Y TECNICO,1000,1
1300,PERSONAL TECNICO Y PROFESIONAL,1600,2
1310,ASESORIA JURIDICA DE ALTO NIVEL,1300,3
1320,ASESORIA ESPECIALIZADA,1300,3
...

Query para obtener hijos directos:

SELECT * FROM categorias WHERE parent_id = 1000;

FORMATO JSON - ENTIDAD CON ARBOL DE CATEGORIAS

Estructura Padre → Hijo (top-down): inicia en la raiz y desciende via array hijos. El campo id_entidad solo aparece cuando existe en la BD origen.

{
  "metadata": {
    "tipo_relacion": "cargo_categoria",
    "tipo_entidad": "cargo",
    "total_entidades": 73,
    "entidades_con_id_original": 68,
    "total_relaciones": 221,
    "nota": "id_entidad es el ID original de la BD institucional..."
  },
  "entidades": [
    {
      "id_entidad": 40,  // ID original de BD institucional
      "nombre": "AGENTE DE SEGURIDAD",
      "tipo": "cargo",
      "categorias_arbol": [...]
    },
    {
      "id_entidad": 3,
      "nombre": "GERENTE",
      "tipo": "cargo",
      "categorias_arbol": [
        {
          "id": 1000,
          "nombre": "TODO EL PERSONAL",
          "nivel": 0,
          "hijos": [
            {
              "id": 1600,
              "nombre": "PERSONAL ADMIN. Y TECNICO",
              "hijos": [...]
            }
          ]
        }
      ]
    },
    {
      // Sin id_entidad = no existe en archivo fuente
      "nombre": "AUXILIAR MISCELANEO",
      "tipo": "cargo",
      "categorias_arbol": [...]
    }
  ]
}

FORMATO CSV - TABLA ASOCIATIVA PLANA

Formato para importacion directa. Los IDs originales provienen de los archivos maestros institucionales.

id_entidad,id_categoria,nombre_entidad
3,1000,GERENTE
3,1600,GERENTE
3,1400,GERENTE
3,1410,GERENTE
604,1000,JUEZ DE INSTANCIA
604,1100,JUEZ DE INSTANCIA
604,1120,JUEZ DE INSTANCIA
40,1000,AGENTE DE SEGURIDAD
40,1500,AGENTE DE SEGURIDAD
40,1550,AGENTE DE SEGURIDAD
0,1000,AUXILIAR MISCELANEO  // 0 = sin ID original
...

Query para obtener entidades de una categoria (con descendientes):

-- Obtener todos los cargos bajo "FUNCIONARIOS JUDICIALES" (1100)
WITH RECURSIVE descendientes AS (
  SELECT id FROM categorias WHERE id = 1100
  UNION ALL
  SELECT c.id FROM categorias c
  JOIN descendientes d ON c.parent_id = d.id
)
SELECT DISTINCT r.id_entidad, r.nombre_entidad
FROM relacion_cargo_cat r
WHERE r.id_categoria IN (SELECT id FROM descendientes);

FORMATO JSON - REGISTRO CONSOLIDADO COMPLETO

{
  "metadata": {
    "tipo_entidad": "dependencia",
    "taxonomias": ["dependencias", "ramos"],
    "total_entidades": 1805,
    "entidades_con_id_original": 1805,  // 100% cobertura
    "nota": "id_entidad es el ID original de la BD institucional..."
  },
  "entidades": [
    {
      "id_entidad": 123,  // ID de arbol_dependencias.csv
      "nombre": "JUZGADO PRIMERO DE PAZ CIVIL GUATEMALA",
      "tipo": "dependencia",
      "categorias_dependencia": [
        {
          "id": 2000,
          "nombre": "TODAS LAS DEPENDENCIAS",
          "nivel": 0,
          "ruta": "TODAS LAS DEPENDENCIAS"
        },
        {
          "id": 2100,
          "nombre": "DEPENDENCIAS JURISDICCIONALES",
          "nivel": 1,
          "ruta": "TODAS > JURISDICCIONALES"
        },
        {
          "id": 2150,
          "nombre": "JUZGADOS DE PAZ",
          "nivel": 2,
          "ruta": "TODAS > JURISDICCIONALES > JUZGADOS DE PAZ"
        }
      ],
      "ramos": [
        {
          "id": 3000,
          "nombre": "TODOS LOS RAMOS",
          "nivel": 0,
          "ruta": "TODOS LOS RAMOS"
        },
        {
          "id": 3020,
          "nombre": "RAMO CIVIL",
          "nivel": 1,
          "ruta": "TODOS LOS RAMOS > RAMO CIVIL"
        }
      ]
    }
  ]
}

FORMATO CSV - CAMPOS MULTIVALUADOS

nombre_dependencia,categorias_ids,ramos_ids
JUZGADO PRIMERO DE PAZ CIVIL GUATEMALA,2000|2100|2150,3000|3020
JUZGADO SEGUNDO DE TRABAJO GUATEMALA,2000|2100|2140,3000|3040
SALA PRIMERA CIVIL CORTE APELACIONES,2000|2100|2120,3000|3020
GERENCIA FINANCIERA,2000|2200|2220,3000|3130
CENTRO DE MEDIACION QUETZALTENANGO,2000|2300|2370,3000|3130
...

Para procesar campos multivaluados en SQL:

-- PostgreSQL: convertir campo | a array
SELECT
  nombre_dependencia,
  string_to_array(categorias_ids, '|')::integer[] as cat_array
FROM dependencias_consolidadas
WHERE '2150' = ANY(string_to_array(categorias_ids, '|'));

-- MySQL: buscar dentro de campo concatenado
SELECT * FROM dependencias_consolidadas
WHERE FIND_IN_SET('2150', REPLACE(categorias_ids, '|', ','));