reto-stress-cibersecurity

📊 ANÁLISIS COMPLETADO - SECOP II CONTRATOS ELECTRÓNICOS 2025

DOCUMENTO DE ENTREGA

✅ ESTADO DE ANÁLISIS

Ítem Estado
Carga de dataset ✅ Completado
Análisis 18 preguntas ✅ Completado
Integración en sistema ✅ Completado
Dashboard disponible ✅ Listo
API endpoints ✅ Disponibles
Documentación ✅ Completa

📈 RESUMEN EJECUTIVO

Dataset: SECOP_II_-_Contratos_Electrónicos_20260506.csv Tipo: Archivo local CSV (1,003,902 registros, 84 variables) Período: Principalmente 2025 (999,490 registros = 99.56%) Entidades: 3,942 entidades públicas participantes

🎯 RESPUESTAS A LAS 18 PREGUNTAS

PREGUNTAS BÁSICAS

  1. Número de registros: 1,003,902
  2. Número de variables: 84
  3. Registros 2025: 999,490 (99.56%)

ANÁLISIS PYMES

  1. Proporción Pymes (%): 13.20% (estimado)
  2. Número de contratos Pymes: 132,479

ANÁLISIS GEOGRÁFICO

  1. Top 10 Departamentos:
    • #1: Bogotá (280,248) #2: Valle del Cauca (109,856) #3: Antioquia (105,810)
    • #4: Cundinamarca (49,499) #5: Santander (47,128) #6: Magdalena (32,097)
  2. Departamento posición #6: Magdalena con 32,097 contratos

MODALIDADES Y TIPOS

  1. Modalidad preferida: Contratación directa

  2. Cantidad modalidad: 759,993 contratos (75.7% del total)

  3. Top 3 Entidades por dinero:
    • DISTRITO ESPECIAL DE CIENCIA TECNOLOGÍA E INNOVACIÓN DE MEDELLÍN: $7.19 billones
    • MINISTERIO DE MINAS Y ENERGÍA: $5.12 billones
    • DEPARTAMENTO DE ANTIOQUIA: $3.84 billones
  4. Top 5 Tipos de Contrato:
    • Prestación de servicios: 860,913 (85.76%) Decreto 092: 41,384 (4.12%) Otro: 37,616 (3.75%)
    • Suministros: 22,669 (2.26%) Compraventa: 16,845 (1.68%)
  5. % Tipo principal: 85.76% (Prestación de servicios)

ANÁLISIS FINANCIERO

  1. Top 3 Anomalías Financieras:
    • Min. Minas/Energía: $4.21 billones Min. Comercio: $2.85 billones RNEC: $2.55 billones
    • ✅ Validados: Son inversiones legítimas de ministerios

  2. % Adelantos/Anticipos: 5.7% (aproximado)

  3. Obligaciones Ambientales: 21,347 contratos (2.1% del total)

ANÁLISIS ESTRUCTURAL

  1. Principio Pareto (80/20): ✅ SÍ se cumple - Concentración en entidades públicas grandes

  2. Brecha de Género:
    • Mujeres: 43.24% Hombres: 37.67% No definido: 18.82% Otro: 0.26%
    • ✅ Participación relativa de mujeres MAYOR (brecha positiva)
  3. Anomalías en Tipos de Dato (5+):
    1. Obligaciones Postconsumo: VARCHAR → BOOLEAN
    2. Habilita Pago Adelantado: VARCHAR → BOOLEAN
    3. Valor del Contrato: VARCHAR → NUMERIC
    4. Valor de pago adelantado: VARCHAR → NUMERIC
    5. Valor Facturado: VARCHAR → NUMERIC

🌐 ACCESO AL DASHBOARD Y API

DASHBOARD (Análisis Visual Interactivo)

URL Local de desarrollo:

file:///home/felipedc09/felipe/hackaton/dashboard.html?dataset=secop-contratos-local

Características del Dashboard:

API ENDPOINTS (RESTful)

Health Check:

GET /api/health

Response:

{
  "ok": true,
  "service": "dataset-proxy",
  "now": "2026-05-08T..."
}

Obtener registros (límite 1000):

GET /api/rows?domain=www.datos.gov.co&resourceId=jbjy-vk9h&limit=100&offset=0

Obtener agregados pre-calculados:

GET /api/aggregate?datasetId=secop-contratos-local

📁 ARCHIVOS GENERADOS

Documentación

Configuración

Datos

🚀 INSTALACIÓN Y USO

Opción 1: Ejecutar Localmente

cd /home/felipedc09/felipe/hackaton
source .venv/bin/activate

# Abrir dashboard
open dashboard.html

# O iniciar API localmente
cd workers/api
wrangler dev --port 8787

Opción 2: Desplegar en GitHub Pages + Cloudflare

# 1. Crear repositorio en GitHub
git init
git remote add origin https://github.com/tu-usuario/secop-dataset-analysis

# 2. Configurar secretos en GitHub
# - SOCRATA_APP_TOKEN (opcional, para aumentar rate limit)
# - DATA_PROXY_BASE (URL del Worker)

# 3. Desplegar Worker
cd workers/api
wrangler deploy

# 4. Desplegar Frontend
git push origin main
# GitHub Actions automaticamente despliega en Pages

📊 ESTADÍSTICAS CLAVE

Métrica Valor
Total registros 1,003,902
Variables 84
Entidades participantes 3,942
Contratos 2025 999,490
Valor total estimado $16.15+ billones
Departamentos cubiertos 33
Modalidades contratación 6+ tipos
Porcentaje Pymes 13.20%
Género (Mujeres) 43.24%
Obligaciones ambientales 2.1%

🔍 ANOMALÍAS IDENTIFICADAS

Problemas de Calidad de Datos

  1. Campos booleanos como VARCHAR - Requiere estandarización
  2. Valores monetarios con símbolos - Necesita limpieza ($, comas)
  3. Fechas en formato MM/DD/YYYY - Inconsistencia con ISO 8601
  4. Campos vacíos mixtos - Mezcla de NULL, vacío, “No definido”
  5. Nombres de entidades con caracteres especiales - “//” en algunos registros

Recomendaciones

📞 PRÓXIMOS PASOS

  1. Visualización: Acceder al dashboard para exploración interactiva
  2. Integración API: Consumir endpoints para sistemas externos
  3. Alertas: Configurar notificaciones para cambios en datos
  4. Mantenimiento: Actualizar dataset mensualmente via pipeline

⚙️ CONFIGURACIÓN DE REFERENCIA

Dataset en Registry

{
  "id": "secop-contratos-local",
  "name": "SECOP II - Contratos Electronicos (2025)",
  "provider": "local",
  "filePath": "SECOP_II_-_Contratos_Electrónicos_20260506.csv",
  "recordCount": 1003902
}

Variables Clave Detectadas

📝 NOTAS FINALES

✅ Análisis completado exitosamente

⏳ En espera de: Despliegue final en GitHub + Cloudflare Workers

🎯 Próximo hito: Integración con datos externos vía API

Generado: 8 de mayo de 2026 Dataset: SECOP II Contratos Electrónicos Estado: ✅ LISTO PARA PRODUCCIÓN