Dashboard de vacíos bibliográficos con ruteo por tipo de documento

 # Prompt: Dashboard de vacíos bibliográficos con ruteo por tipo de documento

## (Gobernado por la Matriz de Consistencia — versión 3)

## ROL

Actúa como analista de datos + diseñador de información + ingeniero frontend. Tu prioridad es la INTEGRIDAD DE LOS DATOS por encima de la estética. Un dashboard bonito sobre datos falsos es peor que no tener dashboard.

## OBJETIVO

Construir un dashboard {{HTML autónomo de un solo archivo | otro formato}} que responda a esta pregunta central:

«{{pregunta o decisión que el dashboard debe ayudar a resolver}}»

El dashboard tiene DOS sistemas de análisis que **no se mezclan entre sí**:

- **Track A — Índices de vacío (solo Journal Article):** IST, IA, IPD, ITG sobre el subconjunto depurado de artículos de revista.

- **Track B — Clasificación complementaria por tipo documental:** Report, generic (Book), web_page, Conference Proceedings, book_section, statute. Cada tipo alimenta su propia sub-matriz y luego la matriz consolidada de Categoría × Enfoque.

**Regla maestra (no negociable): TODA categoría, enfoque, dimensión o etiqueta usada en el dashboard debe derivar directamente de la Matriz de Consistencia del proyecto — nunca de una taxonomía libre o inventada.**

## PÚBLICO Y USO

- Audiencia: {{jurado, comité ejecutivo, equipo interno}}

- Contexto de uso: {{defensa, reunión de decisión, monitoreo continuo}}

- Nivel de detalle esperado: {{ejecutivo / técnico / mixto}}

---

## MATERIAL A ANEXAR (obligatorio, antes de cualquier procesamiento)

Se requieren dos tipos de insumo, nunca uno sin el otro:

### 1. Matriz de Consistencia del proyecto (obligatoria, gobierna todo el dashboard)

- Archivo: {{nombre — ej. "Matriz_Consistencia_v5_Final.docx"}}

- Debe contener: Problema, Objetivos, Hipótesis, Variables (X, Y1/Y2/Y3, VM, VMod, VC), Dimensiones e Indicadores, Instrumentos, Metodología, Diseño.

- Función: define qué "categorías" y qué "enfoques" existen legítimamente en el dashboard. Ninguna categoría/enfoque puede aparecer en Track A, Track B, la matriz de vacíos o la tabla dinámica si no deriva de una variable, dimensión o indicador presente en esta matriz.

- Si no se adjunta, DETENTE antes de construir cualquier categorización.

### 2. Archivos bibliográficos del corpus (obligatorios, en cualquiera de estos formatos)

- PDF (documento fuente completo)

- MD / DOCX (documento fuente completo o transcrito)

- XML / RIS / BIB (registro de metadatos, sin archivo fuente completo)

- {{nombres específicos de archivos o carpetas del corpus}}

### Regla de cruce obligatoria

Cada referencia del corpus debe mapearse a una o más celdas de la Matriz de Consistencia (variable × dimensión) ANTES de entrar a cualquier cálculo. Si no puede mapearse, se marca "fuera de matriz — no asignable" y se reporta aparte.

## FUENTE DE DATOS (bibliográfica)

- Archivo(s): {{nombres y formato}}

- Campos disponibles: {{lista o "descúbrelos tú"}}

- Tamaño aproximado: {{n registros totales}}

- Fuente de verdad para conflicto de dato bibliográfico: {{cuál archivo manda}}

- Fuente de verdad para categorías/enfoques: **la Matriz de Consistencia, sin excepción.**

- **Campo de tipo de documento:** {{nombre exacto — ej. `document_type`}}. Obligatorio. Si no existe, DETENTE.

- **Formato de almacenamiento físico:** cuenta cuántos documentos están en PDF, cuántos en MD/DOCX, y cuántos solo en metadatos (XML/RIS/BIB) sin archivo fuente. Reporte de trazabilidad independiente de los índices. Duplicados de formato se cuentan una sola vez.

---

## FASE -1 — VALIDACIÓN DE LA MATRIZ DE CONSISTENCIA (obligatoria, antes de Fase 0)

1. Extrae el árbol completo de variables y dimensiones: X, Y1, Y2, Y3, VM, VMod, VC.

2. Construye la tabla canónica "Categoría ↔ Enfoque" usando EXCLUSIVAMENTE estos elementos.

3. Si el corpus contiene categorías/enfoques que NO están en la Matriz, repórtalos aparte en "Categorías no cubiertas por la Matriz de Consistencia" — esto es en sí mismo un hallazgo de vacío.

4. Documenta la correspondencia variable → indicador → instrumento (ej. Y11 Fluidez → TTCT Figural → A1).

5. No avances a Fase 0 sin cerrar y validar esta tabla contigo.

---

## FASE 0 — CLASIFICACIÓN Y RUTEO

1. Cuenta registros reales por tipo de documento. Reporta distribución completa.

2. Verifica Journal Articles depurados contra la cifra {{ }}. Si no coincide, DETENTE con tabla comparativa.

3. **Pregunta bloqueante:** ¿  es (a) subconjunto filtrado de corpus mayor, o (b) corpus independiente? No asumas.

4. Divide en Lista A (Journal Article) → Fase 1A, y Lista B (los 6 tipos restantes) → Fase 1B.

5. Asigna cada referencia a categoría/enfoque según Fase -1. Reporta ambigüedades aparte.

6. **Reporte de formato físico:** tabla con PDF / MD·DOCX / solo metadato / duplicados.

---

## FASE 1A — ÍNDICES DE VACÍO (solo Journal Article)

1. **IST** — directo, calculado dentro de cada categoría/enfoque de la Matriz.

2. **IA** — directo, con criterio de vigencia documentado.

3. **IPD** — PROVISIONAL, proxy documentado (cercanía al contexto IESTP DYC/Lima/Diseño).

4. **ITG** — PROVISIONAL, proxy y validación pendiente documentados.

---

## FASE 1B — CLASIFICACIÓN POR TIPO DOCUMENTAL (sin mezclar)

- **1B.2 Report:** naturaleza institucional/vigencia normativa. ¿Datos verificables o solo recomendaciones sobre Y1/Y2/Y3?

- **1B.3 Book:** rol metodológico. ¿Sustenta X/VM/VMod sin verificación empírica en el contexto IESTP DYC?

- **1B.4 web_page:** ¿Definición de constructo o dato primario?

- **1B.5 Conference Proceedings:** ¿Replicado luego en journal article dentro de la misma categoría?

- **1B.6 book_section:** ¿Submarco sin estudios empíricos propios?

- **1B.7 statute:** ¿Norma vigente sobre Y3 sin estudios de implementación real en el aula?

---

## FASE 2 — MATRIZ DE VACÍOS · CATEGORÍA × ENFOQUE (gobernada por la Matriz de Consistencia)

- 7 matrices individuales por tipo documental + 1 consolidada, con filas/columnas EXACTAS a las categorías/enfoques validados en Fase -1.

- Escala: verde >5 · ámbar 3-5 · rojo 1-2 · gris 0.

- Cada celda declara en hover/click: composición por tipo documental + variable/dimensión/indicador correspondiente (ej. "Y22 → CES-D").

- Señala qué celdas son solo Track A, mixtas, o solo Track B.

- Destaca qué variables de la Matriz (ej. Y3 Equidad e Inclusión) tienen menor soporte bibliográfico.

---

## FASE 3 — NARRATIVA Y SECCIÓN 07

Sección de procedencia: origen de datos, filtrado en Fase 0, campos provisionales/no verificables, conteo de formato físico, y versión exacta de la Matriz de Consistencia usada.

### SECCIÓN 07 — TABLA DINÁMICA DE REFERENCIAS

| Columna | Contenido | Ejemplo |

|---|---|---|

| ID | Identificador corto | id12 |

| Categoría (Matriz) | Variable/dimensión de la Matriz | Y1 Competencias Creativas |

| Enfoque (Matriz) | Componente de X o marco teórico | X3 Ciclo Kolb |

| Tipo documental | 7 tipos | Journal Article |

| Año | Año | 1984 |

| Rol | Núcleo/Contexto/Normativo | Núcleo |

| Track | A/B | A |

| Formato fuente | PDF/MD·DOCX/Solo metadato | PDF |

| DOI | Enlace corto | [DOI ↗] |

Filtros: tipo documental, formato fuente, variable de la Matriz (chips), buscador de texto. Contador dinámico. Datos siempre embebidos, nunca hardcodeados.

---

## FASE 4 — IMPLEMENTACIÓN TÉCNICA

Validar: 0 errores runtime; sumas correctas Track A/B y formato físico; **chequeo cruzado automático de que todas las categorías/enfoques mostrados existen literalmente en la Matriz de Consistencia adjunta**.

---

## FASE 5 — ENTREGA

Cifras canónicas por track y formato físico; verificado vs. provisional vs. no verificable; tabla de categorías no cubiertas por la Matriz si la hubo; pendientes de decisión.

---

## RESTRICCIONES GENERALES

- No avanzar de fase con conflictos sin resolver; Fase 0 no arranca sin cerrar Fase -1.

- **Ninguna categoría o enfoque puede existir si no deriva de la Matriz de Consistencia — restricción más importante del prompt.**

- El corpus bibliográfico y la Matriz de Consistencia son dos insumos obligatorios y distintos; el dashboard no se construye con uno solo.

- Trazabilidad sobre vistosidad. Verdad incómoda sobre cifra cómoda.