1 Planteamiento del trabajo

Este documento desarrolla, mediante datos completamente simulados, una demostración reproducible de los ocho controles estructurales asignados a Leonardo para el Taller n.º 3. El propósito es mostrar cómo se pueden detectar problemas de estructura, consistencia, temporalidad, faltantes y trazabilidad antes de realizar cualquier análisis comparativo de boxeadores pound-for-pound (P4P).

Límite fundamental: este ejercicio no utiliza ni reconstruye la base maestra del proyecto. No se solicitaron ni modificaron matrices A10. Los ejemplos ficticios no constituyen hallazgos sobre boxeadores o combates reales.

Delimitación de la población: para la clasificación, se contempla exclusivamente el grupo de 25 boxeadores masculinos. Las 14 boxeadoras corresponden a una ampliación exploratoria voluntaria del proyecto y no forman parte de la clasificación masculina solicitada.

El correo de coordinación reporta 106 combates diferentes y 118 participaciones individuales para el proyecto ampliado. Estas cantidades no deben atribuirse automáticamente al grupo de 25 boxeadores masculinos, debido a que no se dispone de un desglose verificado de esos registros por población. Por tanto, se conservan únicamente como cifras de referencia comunicadas por coordinación y no como resultados auditados de este ejercicio.

2 Objetivos

2.1 Objetivo general

Construir una rutina reproducible en R para ilustrar los controles EST-01 a EST-08 y establecer qué limitaciones deben resolverse antes de producir indicadores comparativos o un ranking P4P.

2.2 Objetivos específicos

  1. Separar la unidad evento/combate de la unidad participación atleta-evento.
  2. Comprobar identificadores, duplicaciones, simetría de resultados y período de inclusión.
  3. Diferenciar valores observados iguales a cero de datos ausentes.
  4. Clasificar la procedencia documental sin asumir que toda URL es evidencia primaria.
  5. Implementar una condición de bloqueo para evitar cálculos o publicaciones prematuras.
  6. Delimitar una propuesta estadística exploratoria que solo pueda desarrollarse después de la liberación documental.

3 Alcance, unidades y reglas

Elemento Definición utilizada en esta demostración
Unidad evento Un combate identificado por id_evento.
Unidad participación Un registro por atleta incluido en el marco y por evento.
Período principal Del 08/11/2024 al 07/11/2026, ambos extremos incluidos.
Datos Ficticios, creados dentro del propio R Markdown.
Evidencia Se simula su clasificación; no se verifican documentos ni enlaces reales.
Liberación I07 e I08 permanecen pendientes; no se calcula R/A/Q ni ranking final.
Población de clasificación 25 boxeadores masculinos. Las 14 boxeadoras son una ampliación exploratoria voluntaria, fuera de la clasificación solicitada.

Nota sobre EST-02: un evento puede generar una o dos participaciones dentro del marco de atletas estudiados. Si el adversario no pertenece al marco, no se crea una segunda participación para ese adversario.

4 Preparación del entorno

El análisis utiliza funciones de R base. Para producir las tablas se requiere knitr, que normalmente se instala junto con R Markdown.

paquetes <- c("knitr")
faltantes <- paquetes[!vapply(paquetes, requireNamespace, logical(1), quietly = TRUE)]

if (length(faltantes) > 0) {
  stop(
    "Faltan paquetes: ", paste(faltantes, collapse = ", "),
    ". Instálelos en la consola con install.packages()."
  )
}

library(knitr)

5 Construcción de los datos simulados

Se construyen dos tablas separadas:

Se incluyen deliberadamente algunos casos negativos para que el código pueda demostrar cómo se detectan incidencias. Por ejemplo, E003 contiene resultados incompatibles y E005 se duplica en una copia de prueba.

eventos <- data.frame(
  id_evento = c("E001", "E002", "E003", "E004", "E005", "E006", "E007"),
  fecha = as.Date(c(
    "2024-11-08", # límite inicial: se incluye
    "2025-02-15",
    "2025-05-20",
    "2026-11-07", # límite final: se incluye
    "2026-11-08", # fuera del período
    "2025-09-10",
    "2026-03-12"
  )),
  sede = c("Sede simulada 1", "Sede simulada 2", "Sede simulada 3",
           "Sede simulada 4", "Sede simulada 5", "Sede simulada 6",
           "Sede simulada 7"),
  stringsAsFactors = FALSE
)

participaciones <- data.frame(
  id_evento = c("E001", "E001", "E002", "E003", "E003",
                "E004", "E005", "E006", "E006", "E007"),
  atleta = c("Boxeador_A", "Boxeador_B", "Boxeador_A", "Boxeador_C",
             "Boxeador_D", "Boxeador_B", "Boxeador_A", "Boxeador_C",
             "Boxeador_E", "Boxeador_E"),
  adversario = c("Boxeador_B", "Boxeador_A", "Atleta_fuera_del_marco",
                 "Boxeador_D", "Boxeador_C", "Atleta_fuera_del_marco",
                 "Atleta_fuera_del_marco", "Boxeador_E", "Boxeador_C",
                 "Atleta_fuera_del_marco"),
  resultado = c("victoria", "derrota", "victoria", "victoria", "victoria",
                "derrota", "victoria", "derrota", "victoria", "empate"),
  metodo = c("decisión", "decisión", "KO", "TKO", "TKO",
             "decisión", NA, "decisión", "decisión", "empate"),
  stringsAsFactors = FALSE
)

kable(eventos, caption = "Tabla simulada de eventos")
Tabla simulada de eventos
id_evento fecha sede
E001 2024-11-08 Sede simulada 1
E002 2025-02-15 Sede simulada 2
E003 2025-05-20 Sede simulada 3
E004 2026-11-07 Sede simulada 4
E005 2026-11-08 Sede simulada 5
E006 2025-09-10 Sede simulada 6
E007 2026-03-12 Sede simulada 7
kable(participaciones, caption = "Tabla simulada de participaciones")
Tabla simulada de participaciones
id_evento atleta adversario resultado metodo
E001 Boxeador_A Boxeador_B victoria decisión
E001 Boxeador_B Boxeador_A derrota decisión
E002 Boxeador_A Atleta_fuera_del_marco victoria KO
E003 Boxeador_C Boxeador_D victoria TKO
E003 Boxeador_D Boxeador_C victoria TKO
E004 Boxeador_B Atleta_fuera_del_marco derrota decisión
E005 Boxeador_A Atleta_fuera_del_marco victoria NA
E006 Boxeador_C Boxeador_E derrota decisión
E006 Boxeador_E Boxeador_C victoria decisión
E007 Boxeador_E Atleta_fuera_del_marco empate empate

6 Controles estructurales EST-01 a EST-08

6.1 EST-01. Identificador de evento no vacío y único

La clave id_evento debe estar presente y representar un solo evento en la tabla de eventos.

validar_id_evento <- function(datos) {
  vacios <- is.na(datos$id_evento) | trimws(datos$id_evento) == ""
  duplicados <- unique(datos$id_evento[
    !is.na(datos$id_evento) & duplicated(datos$id_evento)
  ])

  data.frame(
    prueba = c("ID vacío", "ID duplicado"),
    cantidad = c(sum(vacios), length(duplicados)),
    detalle = c(
      if (sum(vacios) == 0) "Ninguno" else paste(which(vacios), collapse = ", "),
      if (length(duplicados) == 0) "Ninguno" else paste(duplicados, collapse = ", ")
    )
  )
}

resultado_est01 <- validar_id_evento(eventos)
kable(resultado_est01, caption = "EST-01 aplicado a la tabla original")
EST-01 aplicado a la tabla original
prueba cantidad detalle
ID vacío 0 Ninguno
ID duplicado 0 Ninguno
# Caso negativo deliberado: se duplica E003 en una copia de prueba.
# Se utiliza E003 para unificar el ejemplo en todos los documentos.

eventos_prueba_duplicado <- rbind(
  eventos,
  eventos[eventos$id_evento == "E003", ]
)

kable(
  validar_id_evento(eventos_prueba_duplicado),
  caption = "EST-01: demostración de detección del ID E003 duplicado"
)
EST-01: demostración de detección del ID E003 duplicado
prueba cantidad detalle
ID vacío 0 Ninguno
ID duplicado 1 E003

Interpretación: El primer resultado debe mostrar cero identificadores vacíos y cero duplicados. La segunda tabla debe detectar E003 repetido. La copia alterada existe solo para probar la rutina; no modifica eventos.

6.2 EST-02. Número de participaciones dentro del marco

Se cuentan las filas de participación por id_evento. El número esperado dentro del marco es una o dos, no necesariamente dos.

conteo_participaciones <- aggregate(
  atleta ~ id_evento,
  data = participaciones,
  FUN = length
)
names(conteo_participaciones)[2] <- "n_participaciones_marco"

conteo_participaciones$estado <- ifelse(
  conteo_participaciones$n_participaciones_marco %in% c(1, 2),
  "Compatible con regla de 1 o 2",
  "Revisar: fuera de 1 o 2"
)

kable(conteo_participaciones, caption = "EST-02: participaciones por evento")
EST-02: participaciones por evento
id_evento n_participaciones_marco estado
E001 2 Compatible con regla de 1 o 2
E002 1 Compatible con regla de 1 o 2
E003 2 Compatible con regla de 1 o 2
E004 1 Compatible con regla de 1 o 2
E005 1 Compatible con regla de 1 o 2
E006 2 Compatible con regla de 1 o 2
E007 1 Compatible con regla de 1 o 2

Interpretación: E002 tiene una sola participación porque su adversario está fuera del marco del estudio. Esto no es, por sí mismo, un dato faltante ni un error.

6.3 EST-03. Validación de consistencia entre contendientes

Este control verifica cuatro aspectos:

  1. Reciprocidad: cada boxeador debe identificar al otro como adversario.
  2. Unicidad: un mismo boxeador no debe aparecer dos veces en el mismo combate.
  3. Simetría: una victoria debe corresponder a una derrota y un empate a otro empate.
  4. Resultados especiales: decisiones técnicas, descalificaciones y no contest deben quedar señalados para revisión documental.
# --------------------------------------------------
# A. DETECTAR PARTICIPACIONES DUPLICADAS
# --------------------------------------------------

clave_participacion <- paste(
  participaciones$id_evento,
  participaciones$atleta,
  sep = "::"
)

duplicados_participacion <- participaciones[
  duplicated(clave_participacion) |
    duplicated(clave_participacion, fromLast = TRUE),
  c("id_evento", "atleta", "adversario", "resultado")
]

kable(
  duplicados_participacion,
  caption = "EST-03A: participaciones duplicadas por atleta y combate"
)
EST-03A: participaciones duplicadas por atleta y combate
id_evento atleta adversario resultado
# --------------------------------------------------
# B. IDENTIFICAR PAREJAS DE CONTENDIENTES
# --------------------------------------------------

pares <- merge(
  participaciones,
  participaciones,
  by = "id_evento",
  suffixes = c("_1", "_2")
)

# Evitar mostrar dos veces la misma pareja.
pares <- pares[
  !is.na(pares$atleta_1) &
    !is.na(pares$atleta_2) &
    pares$atleta_1 < pares$atleta_2,
]

# --------------------------------------------------
# C. VERIFICAR RECIPROCIDAD DE ADVERSARIOS
# --------------------------------------------------

pares$adversarios_reciprocos <-
  !is.na(pares$adversario_1) &
  !is.na(pares$adversario_2) &
  pares$adversario_1 == pares$atleta_2 &
  pares$adversario_2 == pares$atleta_1

# --------------------------------------------------
# D. VERIFICAR SIMETRIA DE RESULTADOS
# --------------------------------------------------

correspondencia_valida <- function(r1, r2) {

  if (is.na(r1) || is.na(r2)) {
    return(NA)
  }

  (r1 == "victoria" & r2 == "derrota") |
    (r1 == "derrota" & r2 == "victoria") |
    (r1 == "empate" & r2 == "empate")
}

pares$simetria_resultado <- mapply(
  correspondencia_valida,
  pares$resultado_1,
  pares$resultado_2
)

# --------------------------------------------------
# E. IDENTIFICAR RESULTADOS ESPECIALES
# --------------------------------------------------

resultados_estandar <- c(
  "victoria",
  "derrota",
  "empate"
)

pares$resultado_especial <-
  !pares$resultado_1 %in% resultados_estandar |
  !pares$resultado_2 %in% resultados_estandar |
  is.na(pares$resultado_1) |
  is.na(pares$resultado_2)

# --------------------------------------------------
# F. ASOCIAR DUPLICADOS AL EVENTO
# --------------------------------------------------

eventos_con_duplicados <- unique(
  duplicados_participacion$id_evento
)

pares$duplicado_participacion <-
  pares$id_evento %in% eventos_con_duplicados

# --------------------------------------------------
# G. CONSOLIDAR ALERTAS
# --------------------------------------------------

pares$requiere_revision <-
  is.na(pares$simetria_resultado) |
  !pares$simetria_resultado |
  !pares$adversarios_reciprocos |
  pares$duplicado_participacion |
  pares$resultado_especial

pares$estado <- ifelse(
  pares$requiere_revision,
  "REVISAR DOCUMENTALMENTE",
  "CONSISTENTE"
)

# --------------------------------------------------
# H. PRESENTAR RESULTADOS
# --------------------------------------------------

reporte_est03 <- pares[, c(
  "id_evento",
  "atleta_1",
  "adversario_1",
  "resultado_1",
  "atleta_2",
  "adversario_2",
  "resultado_2",
  "adversarios_reciprocos",
  "simetria_resultado",
  "duplicado_participacion",
  "resultado_especial",
  "estado"
)]

kable(
  reporte_est03,
  caption = "EST-03: auditoría de reciprocidad y consistencia de resultados"
)
EST-03: auditoría de reciprocidad y consistencia de resultados
id_evento atleta_1 adversario_1 resultado_1 atleta_2 adversario_2 resultado_2 adversarios_reciprocos simetria_resultado duplicado_participacion resultado_especial estado
2 E001 Boxeador_A Boxeador_B victoria Boxeador_B Boxeador_A derrota TRUE TRUE FALSE FALSE CONSISTENTE
7 E003 Boxeador_C Boxeador_D victoria Boxeador_D Boxeador_C victoria TRUE FALSE FALSE FALSE REVISAR DOCUMENTALMENTE
13 E006 Boxeador_C Boxeador_E derrota Boxeador_E Boxeador_C victoria TRUE TRUE FALSE FALSE CONSISTENTE
# --------------------------------------------------
# I. PRUEBA ADICIONAL DE DUPLICACIÓN
# --------------------------------------------------

# Crear una copia temporal con una participación repetida.
# La tabla original no se modifica.

participaciones_prueba <- rbind(
  participaciones,
  participaciones[
    participaciones$id_evento == "E001" &
      participaciones$atleta == "Boxeador_A",
  ]
)

clave_prueba <- paste(
  participaciones_prueba$id_evento,
  participaciones_prueba$atleta,
  sep = "::"
)

duplicados_prueba <- participaciones_prueba[
  duplicated(clave_prueba) |
    duplicated(clave_prueba, fromLast = TRUE),
  c("id_evento", "atleta", "adversario", "resultado")
]

kable(
  duplicados_prueba,
  caption = "EST-03: demostración de detección de participación duplicada"
)
EST-03: demostración de detección de participación duplicada
id_evento atleta adversario resultado
1 E001 Boxeador_A Boxeador_B victoria
11 E001 Boxeador_A Boxeador_B victoria

Interpretación: E001 presenta resultados compatibles y adversarios recíprocos. E003 debe generar una alerta porque ambos contendientes aparecen con victoria. La prueba adicional demuestra cómo detectar una participación duplicada. Los resultados especiales y cualquier inconsistencia deben revisarse con la documentación oficial; el código no modifica ni corrige registros automáticamente.

6.4 EST-04. Validación del período temporal

El período principal es inclusivo: 08/11/2024 a 07/11/2026.

fecha_inicio <- as.Date("2024-11-08")
fecha_fin <- as.Date("2026-11-07")

eventos$incluido_periodo <- eventos$fecha >= fecha_inicio &
  eventos$fecha <= fecha_fin

kable(
  eventos[, c("id_evento", "fecha", "incluido_periodo")],
  caption = "EST-04: evaluación de fechas"
)
EST-04: evaluación de fechas
id_evento fecha incluido_periodo
E001 2024-11-08 TRUE
E002 2025-02-15 TRUE
E003 2025-05-20 TRUE
E004 2026-11-07 TRUE
E005 2026-11-08 FALSE
E006 2025-09-10 TRUE
E007 2026-03-12 TRUE
cat("Eventos dentro del período:", sum(eventos$incluido_periodo), "\n")
#> Eventos dentro del período: 6
cat("Eventos fuera del período:", sum(!eventos$incluido_periodo), "\n")
#> Eventos fuera del período: 1

Interpretación: las fechas 08/11/2024 y 07/11/2026 se incluyen. La fecha 08/11/2026 se excluye. Antes de aplicar este control a datos reales, debe confirmarse que la fecha registrada corresponde a la fecha local oficial del combate.

6.5 EST-05. Datos ausentes frente a cero observado

0 es un valor numérico observado; NA representa un valor no disponible. No deben intercambiarse.

ejemplo_faltantes <- data.frame(
  atleta = c("Boxeador_A", "Boxeador_B", "Boxeador_C"),
  numero_de_eventos = c(0, 3, NA),
  metodo = c("decisión", NA, "KO")
)

ejemplo_faltantes$estado_numero <- ifelse(
  is.na(ejemplo_faltantes$numero_de_eventos),
  "Ausente (NA)",
  ifelse(ejemplo_faltantes$numero_de_eventos == 0,
         "Cero observado", "Valor observado positivo")
)

kable(ejemplo_faltantes, caption = "EST-05: distinción entre cero y dato ausente")
EST-05: distinción entre cero y dato ausente
atleta numero_de_eventos metodo estado_numero
Boxeador_A 0 decisión Cero observado
Boxeador_B 3 NA Valor observado positivo
Boxeador_C NA KO Ausente (NA)

Interpretación: el cero del primer registro significa que se observó un conteo igual a cero; el NA del tercer registro significa que el dato no está disponible. En variables categóricas, como método o resultado, no se debe asignar 0 salvo que exista una definición formal que lo justifique.

6.6 EST-06. Trazabilidad y clasificación de fuentes

Una URL no es evidencia suficiente por sí sola. Deben registrarse emisor, tipo documental, fecha de consulta, página o fragmento y el evento que respalda.

fuentes_simuladas <- data.frame(
  id_evento = c("E001", "E002", "E003"),
  url_ejemplo = c(
    "https://ejemplo.invalid/acta",
    "https://ejemplo.invalid/informe",
    "https://ejemplo.invalid/noticia"
  ),
  emisor = c("Comisión deportiva ficticia",
             "Organismo institucional ficticio",
             "Medio periodístico ficticio"),
  tipo_documento = c("Acta oficial simulada",
                     "Informe institucional simulado",
                     "Crónica periodística simulada"),
  clase_provisional = c("Posible fuente primaria",
                        "Fuente institucional",
                        "Fuente secundaria")
)

kable(fuentes_simuladas, caption = "EST-06: ejemplo ficticio de trazabilidad")
EST-06: ejemplo ficticio de trazabilidad
id_evento url_ejemplo emisor tipo_documento clase_provisional
E001 https://ejemplo.invalid/acta Comisión deportiva ficticia Acta oficial simulada Posible fuente primaria
E002 https://ejemplo.invalid/informe Organismo institucional ficticio Informe institucional simulado Fuente institucional
E003 https://ejemplo.invalid/noticia Medio periodístico ficticio Crónica periodística simulada Fuente secundaria

Interpretación: las direcciones .invalid son marcadores ficticios y no deben abrirse ni citarse como fuentes reales. En una auditoría real, la clasificación depende de verificar el organismo emisor y el documento, no del formato del enlace.

6.7 EST-07. Separar eventos de participaciones

El número de eventos se calcula con identificadores únicos de la tabla de eventos; el número de participaciones se calcula contando filas de la tabla atleta-evento.

resumen_unidades <- data.frame(
  unidad = c("Eventos/combates", "Participaciones atleta-evento"),
  cantidad_simulada = c(
    length(unique(eventos$id_evento)),
    nrow(participaciones)
  )
)

kable(resumen_unidades, caption = "EST-07: unidades de conteo en la muestra ficticia")
EST-07: unidades de conteo en la muestra ficticia
unidad cantidad_simulada
Eventos/combates 7
Participaciones atleta-evento 10
referencia_coordinacion <- data.frame(
  unidad = c("Combates diferentes", "Participaciones individuales"),
  cantidad_reportada = c(106, 118),
  procedencia = "Cifras comunicadas por coordinación; no recalculadas aquí"
)

kable(referencia_coordinacion,
      caption = "Cifras de referencia del correo — no son resultados de esta simulación")
Cifras de referencia del correo — no son resultados de esta simulación
unidad cantidad_reportada procedencia
Combates diferentes 106 Cifras comunicadas por coordinación; no recalculadas aquí
Participaciones individuales 118 Cifras comunicadas por coordinación; no recalculadas aquí

Interpretación: los conteos de la muestra ficticia son independientes de las cifras de coordinación. Los 118 registros de participación comunicados no deben describirse como 118 combates.

6.8 Control complementario de liberación I07/I08 (no confundir con OPER-02 EST-08)

La plantilla indica que I07 e I08 siguen pendientes. Sus definiciones operativas y las de R/A/Q no están incluidas en el material disponible para este ejercicio. Por tanto, el código no inventa sus significados ni calcula puntuaciones finales.

estado_liberacion <- data.frame(
  control = c("I07", "I08"),
  estado = c("Pendiente", "Pendiente"),
  aprobado = c(FALSE, FALSE)
)

liberar_resultados_finales <- all(estado_liberacion$aprobado)

kable(estado_liberacion, caption = "EST-08: estado de controles de liberación")
EST-08: estado de controles de liberación
control estado aprobado
I07 Pendiente FALSE
I08 Pendiente FALSE
if (!liberar_resultados_finales) {
  cat("BLOQUEO: no calcular ni publicar R/A/Q final ni ranking P4P.\n")
} else {
  cat("Controles aprobados. Aún se requiere autorización metodológica para liberar resultados.\n")
}
#> BLOQUEO: no calcular ni publicar R/A/Q final ni ranking P4P.

Interpretación: con I07 e I08 pendientes, el resultado de la condición es FALSE. Incluso si ambos controles se aprobaran, la aprobación técnica no sustituye la autorización de coordinación ni la validación de la metodología.

7 Resumen consolidado de los ocho controles

resumen_controles <- data.frame(
  control = c(sprintf("EST-%02d", 1:7), "Liberación I07/I08"),
  comprobacion = c(
    "ID de evento no vacío y único",
    "Una o dos participaciones del marco por evento",
    "Reciprocidad, unicidad de participación y simetría de resultados entre contendientes",
    "Fecha dentro del período inclusivo",
    "Diferenciar cero y dato ausente",
    "Atribución y tipo de fuente",
    "Separar eventos y participaciones",
    "Bloqueo complementario de liberación mientras I07/I08 estén pendientes"
  ),
  naturaleza = c(
    "Automatizable",
    "Automatizable",
    "Automatizable con reglas deportivas definidas",
    "Automatizable",
    "Automatizable con diccionario de datos",
    "Revisión documental",
    "Automatizable",
    "Regla de gobernanza"
  )
)

kable(resumen_controles, caption = "Matriz resumen de controles")
Matriz resumen de controles
control comprobacion naturaleza
EST-01 ID de evento no vacío y único Automatizable
EST-02 Una o dos participaciones del marco por evento Automatizable
EST-03 Reciprocidad, unicidad de participación y simetría de resultados entre contendientes Automatizable con reglas deportivas definidas
EST-04 Fecha dentro del período inclusivo Automatizable
EST-05 Diferenciar cero y dato ausente Automatizable con diccionario de datos
EST-06 Atribución y tipo de fuente Revisión documental
EST-07 Separar eventos y participaciones Automatizable
Liberación I07/I08 Bloqueo complementario de liberación mientras I07/I08 estén pendientes Regla de gobernanza

8 Propuesta estadística: qué puede hacerse y qué debe esperar

8.1 Etapa permitida en esta fase

Con la información disponible, la contribución estadística inmediata debe concentrarse en la calidad y estructura de los datos:

  • conteos de eventos y participaciones por separado;
  • frecuencia de valores ausentes por variable;
  • distribución de eventos por fecha y fuente documental;
  • proporción de registros con fuente primaria verificada, una vez que exista evidencia;
  • listado de inconsistencias que requieren revisión manual.

Estas salidas describen la integridad del conjunto de datos; no miden por sí solas la calidad deportiva de los boxeadores.

8.2 Etapa que no debe ejecutarse todavía

No se debe calcular ni publicar una puntuación P4P definitiva, ni indicadores finales denominados R/A/Q, porque:

  1. I07 e I08 figuran pendientes en la plantilla.
  2. El correo de coordinación indica que la cobertura documental de los combates y la integridad de los historiales individuales aún no están demostradas.
  3. No se dispone de las definiciones operativas, fórmulas, ponderaciones ni reglas de elegibilidad aprobadas para R/A/Q.
  4. No se ha autorizado la liberación de un ranking.

8.3 Diseño metodológico futuro — sujeto a aprobación

Una vez liberada la base y aprobadas las reglas, podría evaluarse un marco multicriterio con dimensiones como rendimiento, calidad de oposición, actividad y actualidad de resultados. Cada dimensión necesitaría:

  • definición operacional y ventana temporal;
  • fuente y regla de validación;
  • tratamiento de diferencias de categoría/peso y número de combates;
  • escala comparable y dirección de interpretación;
  • ponderaciones justificadas antes de observar el ranking;
  • análisis de sensibilidad para comprobar cuánto cambia el orden ante ponderaciones alternativas.

Esto es una propuesta para discusión, no una fórmula adoptada ni una puntuación calculada. La selección de variables y pesos debe ser acordada por el equipo.

9 Conclusiones

  1. La auditoría debe distinguir claramente la tabla de eventos de la tabla de participaciones atleta-evento.
  2. Los controles automatizables permiten detectar identificadores duplicados, fechas fuera del período, participaciones atípicas y contradicciones entre resultados.
  3. Los datos ausentes no deben convertirse automáticamente en ceros, y las fuentes deben clasificarse por emisor y naturaleza documental.
  4. Las cifras de 106 combates y 118 participaciones son referencias comunicadas por coordinación; este ejercicio no las verifica.
  5. Los datos usados en el código son ficticios y sirven únicamente para demostrar el procedimiento.
  6. Mientras I07/I08 permanezcan pendientes y no exista autorización metodológica, no corresponde calcular ni publicar R/A/Q final ni un ranking P4P.

10 Información que debe confirmarse con coordinación

Antes de integrar los controles a un proceso oficial, solicitar confirmación de:


Declaración de integridad: este R Markdown contiene datos simulados. No accede a la base maestra, no certifica historiales de atletas, no verifica actas reales y no produce un ranking deportivo.

11 OPER-02 — Ejecución de las seis pruebas solicitadas

Esta sección responde a la hoja OPER-02_Leonardo_tests. Los seis casos de aceptación fueron verificados independientemente en Python con datos simulados controlados. El código R reproducible se incorpora aquí, pero debe ejecutarse mediante Knit en RStudio para generar evidencia de ejecución propia de R. Los estados PASS no certifican datos reales.

# EST-01: clave compuesta evento + atleta
op01 <- data.frame(
  id_evento = c("E001", "E001"),
  atleta = c("A", "B"),
  stringsAsFactors = FALSE
)
op01_con_duplicado <- rbind(op01, op01[1, ])
op01$clave <- paste(op01$id_evento, op01$atleta, sep = "::")
op01_con_duplicado$clave <- paste(op01_con_duplicado$id_evento,
                                   op01_con_duplicado$atleta, sep = "::")
op01_res <- data.frame(
  eventos = length(unique(op01$id_evento)),
  participaciones = nrow(op01),
  duplicados_detectados = sum(duplicated(op01_con_duplicado$clave))
)
stopifnot(op01_res$eventos == 1,
          op01_res$participaciones == 2,
          op01_res$duplicados_detectados == 1)
knitr::kable(op01_res, caption = "OPER-02 EST-01: resultado observado")
OPER-02 EST-01: resultado observado
eventos participaciones duplicados_detectados
1 2 1

Resultado observado: 1 evento, 2 participaciones originales y exactamente 1 duplicado en la copia de prueba.

# EST-02/EST-03: rivales recíprocos, resultado opuesto y unicidad.
validar_pareja <- function(a, b) {
  errores <- 0L
  if (a$adversario != b$atleta || b$adversario != a$atleta) {
    errores <- errores + 1L
  }
  resultado_ok <- (a$resultado == "victoria" && b$resultado == "derrota") ||
    (a$resultado == "derrota" && b$resultado == "victoria") ||
    (a$resultado == "empate" && b$resultado == "empate")
  if (!resultado_ok) errores <- errores + 1L
  errores
}
a <- data.frame(atleta="A", adversario="B", resultado="victoria")
b <- data.frame(atleta="B", adversario="A", resultado="derrota")
b_falso <- data.frame(atleta="B", adversario="C", resultado="derrota")
op02_03 <- data.frame(
  caso = c("Pareja correcta", "Pareja con rival falso"),
  errores = c(validar_pareja(a, b), validar_pareja(a, b_falso))
)
stopifnot(op02_03$errores[1] == 0, op02_03$errores[2] == 1)
knitr::kable(op02_03, caption = "OPER-02 EST-02/EST-03: reciprocidad y simetría")
OPER-02 EST-02/EST-03: reciprocidad y simetría
caso errores
Pareja correcta 0
Pareja con rival falso 1

Resultado observado: 0 errores en la pareja correcta y 1 error de rival no recíproco en el caso negativo. La unicidad se comprueba con la clave evento + atleta, como en EST-01.

# EST-04: ventana inclusiva de fechas
op04 <- data.frame(
  fecha = as.Date(c("2024-11-07", "2024-11-08",
                    "2026-11-07", "2026-11-08"))
)
op04$incluido <- op04$fecha >= as.Date("2024-11-08") &
  op04$fecha <= as.Date("2026-11-07")
op04_res <- data.frame(
  fecha = op04$fecha,
  resultado = ifelse(op04$incluido, "INCLUIR", "EXCLUIR")
)
stopifnot(sum(op04$incluido) == 2, sum(!op04$incluido) == 2)
knitr::kable(op04_res, caption = "OPER-02 EST-04: prueba de límites")
OPER-02 EST-04: prueba de límites
fecha resultado
2024-11-07 EXCLUIR
2024-11-08 INCLUIR
2026-11-07 INCLUIR
2026-11-08 EXCLUIR

Resultado observado: 07/11/2024 y 08/11/2026 quedan fuera; 08/11/2024 y 07/11/2026 quedan dentro.

# EST-05/EST-06: NA no equivale a cero; URL no prueba autoridad.
op05 <- data.frame(
  registro = c("q ausente", "q observado cero"),
  q = c(NA_real_, 0)
)
op05$estado <- ifelse(is.na(op05$q), "NA conservado",
                      ifelse(op05$q == 0, "Cero observado", "Valor observado"))
stopifnot(is.na(op05$q[1]), identical(op05$q[2], 0))

op06 <- data.frame(
  fuente = c("URL crónica", "URL atribuida a comisión"),
  tipo_declarado = c("Crónica periodística", "Documento de comisión"),
  clasificacion = c("Secundaria; no acta primaria",
                    "Pendiente de verificar emisor y documento"),
  stringsAsFactors = FALSE
)
knitr::kable(op05, caption = "EST-05: NA y cero")
EST-05: NA y cero
registro q estado
q ausente NA NA conservado
q observado cero 0 Cero observado
knitr::kable(op06, caption = "EST-06: clasificación prudente de fuentes")
EST-06: clasificación prudente de fuentes
fuente tipo_declarado clasificacion
URL crónica Crónica periodística Secundaria; no acta primaria
URL atribuida a comisión Documento de comisión Pendiente de verificar emisor y documento

Resultado observado: NA permanece como NA y cero permanece como cero. La crónica no se eleva a acta. La URL atribuida a una comisión queda pendiente de verificación documental; el dominio o enlace por sí solo no prueba autoridad.

# EST-07: eventos, participaciones y documentos son unidades distintas.
op07_eventos <- data.frame(id_evento = c("E001", "E002"))
op07_participaciones <- data.frame(
  id_evento = c("E001", "E001", "E002"),
  atleta = c("A", "B", "A")
)
op07_documentos <- data.frame(
  id_documento = c("PDF1", "PDF1"),
  id_evento = c("E001", "E002")
)
op07_res <- data.frame(
  unidad = c("Eventos", "Participaciones", "PDF únicos"),
  cantidad = c(length(unique(op07_eventos$id_evento)),
               nrow(op07_participaciones),
               length(unique(op07_documentos$id_documento)))
)
stopifnot(op07_res$cantidad[1] == 2,
          op07_res$cantidad[2] == 3,
          op07_res$cantidad[3] == 1)
knitr::kable(op07_res, caption = "OPER-02 EST-07: recuento triple")
OPER-02 EST-07: recuento triple
unidad cantidad
Eventos 2
Participaciones 3
PDF únicos 1

Resultado observado: 2 eventos, 3 participaciones y 1 PDF único. El documento que cubre dos eventos se cuenta una sola vez como documento.

# EST-08: comparación versionada. R y A se mantienen fijos.
corrida_v1 <- data.frame(
  version = "v1", R = 50, A = 70, q_evento = NA_real_, Q_atleta = NA_real_
)
corrida_v2 <- data.frame(
  version = "v2", R = 50, A = 70, q_evento = 100, Q_atleta = NA_real_
)
comparacion <- data.frame(
  variable = c("R", "A", "q_evento", "Q_atleta"),
  v1 = c(corrida_v1$R, corrida_v1$A,
         corrida_v1$q_evento, corrida_v1$Q_atleta),
  v2 = c(corrida_v2$R, corrida_v2$A,
         corrida_v2$q_evento, corrida_v2$Q_atleta)
)
comparacion$cambio_documental <- ifelse(
  is.na(comparacion$v1) & !is.na(comparacion$v2), "NA -> valor observado",
  ifelse(!is.na(comparacion$v1) & is.na(comparacion$v2),
         "valor observado -> NA",
         ifelse(comparacion$v1 == comparacion$v2, "Sin cambio", "Cambio"))
)
# Q_atleta sigue NA; por tanto no se calcula índice basal.
indice_basal_v1 <- NA_real_
indice_basal_v2 <- NA_real_
delta_p4p_escenico <- 0
stopifnot(corrida_v1$R == corrida_v2$R,
          corrida_v1$A == corrida_v2$A,
          is.na(corrida_v2$Q_atleta),
          is.na(indice_basal_v1), is.na(indice_basal_v2),
          delta_p4p_escenico == 0)
knitr::kable(comparacion, caption = "OPER-02 EST-08: comparación entre versiones")
OPER-02 EST-08: comparación entre versiones
variable v1 v2 cambio_documental
R 50 50 Sin cambio
A 70 70 Sin cambio
q_evento NA 100 NA -> valor observado
Q_atleta NA NA NA
cat("Delta P4P escénico:", delta_p4p_escenico,
    "| Índice basal: NA (bloqueado) | Cambio documental: q_evento NA -> 100\\n")
#> Delta P4P escénico: 0 | Índice basal: NA (bloqueado) | Cambio documental: q_evento NA -> 100\n

Resultado observado: R y A permanecen fijos; q_evento cambia de NA a 100; Q_atleta sigue NA. El delta escénico es 0 porque el índice no puede calcularse mientras Q/C permanezca no disponible; el índice basal se conserva como NA. Se registra el cambio documental sin liberar un ranking.

11.1 Matriz de resultados OPER-02

oper02_resultados <- data.frame(
  ID_test = c("EST-01", "EST-02/EST-03", "EST-04",
              "EST-05/EST-06", "EST-07", "EST-08"),
  esperado = c(
    "1 evento; 2 participaciones; 1 duplicado",
    "0 errores correcto; 1 error caso falso",
    "2 fechas dentro; 2 fuera",
    "NA distinto de cero; crónica no es acta",
    "2 eventos; 3 participaciones; 1 PDF",
    "delta escénico 0; índice basal NA; cambio registrado"
  ),
  obtenido = c(
    "1; 2; 1",
    "0; 1",
    "2; 2",
    "NA y cero preservados; fuente no elevada",
    "2; 3; 1",
    "0; NA; q_evento NA -> 100"
  ),
  estado = rep("PASS — validación independiente Python; Knit R pendiente", 6),
  stringsAsFactors = FALSE
)
knitr::kable(oper02_resultados, caption = "OPER-02: esperado frente a observado")
OPER-02: esperado frente a observado
ID_test esperado obtenido estado
EST-01 1 evento; 2 participaciones; 1 duplicado 1; 2; 1 PASS — validación independiente Python; Knit R pendiente
EST-02/EST-03 0 errores correcto; 1 error caso falso 0; 1 PASS — validación independiente Python; Knit R pendiente
EST-04 2 fechas dentro; 2 fuera 2; 2 PASS — validación independiente Python; Knit R pendiente
EST-05/EST-06 NA distinto de cero; crónica no es acta NA y cero preservados; fuente no elevada PASS — validación independiente Python; Knit R pendiente
EST-07 2 eventos; 3 participaciones; 1 PDF 2; 3; 1 PASS — validación independiente Python; Knit R pendiente
EST-08 delta escénico 0; índice basal NA; cambio registrado 0; NA; q_evento NA -> 100 PASS — validación independiente Python; Knit R pendiente

Nota de integridad: PASS significa que los casos simulados fueron verificados independientemente en Python y que el bloque R contiene las comprobaciones reproducibles correspondientes. Falta ejecutar Knit en RStudio para adjuntar el HTML y la salida efectiva de R. No equivale a auditar ni aprobar registros reales. El bloqueo independiente I07/I08 permanece vigente; no se calcula ni publica un ranking basal.