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.
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.
| 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.
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)
Se construyen dos tablas separadas:
eventos: una fila por evento o combate.participaciones: una fila por atleta del marco que
participó en ese evento.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")
| 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")
| 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 |
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")
| 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"
)
| 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.
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")
| 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.
Este control verifica cuatro aspectos:
# --------------------------------------------------
# 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"
)
| 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"
)
| 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"
)
| 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.
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"
)
| 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.
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")
| 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.
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")
| 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.
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")
| 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")
| 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.
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")
| 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.
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")
| 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 |
Con la información disponible, la contribución estadística inmediata debe concentrarse en la calidad y estructura de los datos:
Estas salidas describen la integridad del conjunto de datos; no miden por sí solas la calidad deportiva de los boxeadores.
No se debe calcular ni publicar una puntuación P4P definitiva, ni indicadores finales denominados R/A/Q, porque:
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:
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.
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.
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")
| 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")
| 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")
| 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")
| 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")
| 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")
| 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")
| 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.
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")
| 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.