Pruebas automatizadas
517
pytest en CI · solo el laboratorio
Fuente: conteo del repositorio research/ [derivado]
Laboratorio
ColPulse Research es la carpeta research/ del repositorio: el módulo de investigación. Mientras el pipeline del sitio publica a diario indicadores oficiales de Colombia, este módulo prepara análisis que el sitio solo acepta como paquetes sellados y verificados.
Alcance.
- No hay conexión a un bróker ni capacidad de enviar órdenes.
- Las cifras de esta página se calculan del propio repositorio en cada publicación [derivado].
Decisiones documentadas
28
registros ADR
Fuente: conteo del repositorio research/ [derivado]
Módulos Python
111
monolito modular
Fuente: conteo del repositorio research/ [derivado]
Conectores del laboratorio
7
adaptadores reemplazables
Fuente: conteo del repositorio research/ [derivado]
Escritorio de renta fija colombiana
Es el uso actual de este módulo: un escritorio de análisis de renta fija colombiana que alimenta la página Renta fija. El sitio verifica el paquete sellado que recibe y no recalcula sus cifras. Esto es lo que existe en research/ en este build:
- Matemática de bonos. Código en
research/**/fixed_income/analytics. 204 pruebas de renta fija enresearch/tests. Incluye pruebas con respuesta conocida. - Catálogo sellado. Archivos de catálogo con huellas SHA-256, para que cada instrumento se pueda verificar.
- Libro de pronósticos. Los pronósticos se puntúan con la regla de Brier; la puntuación solo informa con muchos pronósticos resueltos.
- Monitor semanal. Resumen descriptivo de la semana; no emite recomendaciones.
Experimentos heredados de renta variable (congelados)
Nacieron cuando el módulo era un proyecto independiente de acciones. Se conservan con sus pruebas, pero están congelados: no reciben cambios y no alimentan el sitio.
Congelado
Datos empresariales · congelado
Expedientes SEC/EDGAR: hechos XBRL, estados financieros normalizados y valoración.
Congelado
Quant Lab · congelado
Walk-forward con folds purgados, torneo de estrategias, Sharpe deflactado, capacidad e impacto; diagnósticos retrospectivos.
Congelado
Precios de mercado · congelado
Conectores de Tiingo y Alpha Vantage con la clave personal de cada usuario; sus datos no se publican.
Otros componentes
Activo
Datos abiertos y grafo mundial
Banco Mundial, UN Comtrade, GDELT y Wikidata en un grafo temporal de entidades, eventos, comercio y variables macro; la presión de exposición es diagnóstica, no una probabilidad.
Activo
IA supervisada
Cola de trabajo y borradores con citas de un modelo local (Ollama), con compuerta de relevancia. El modelo propone; una persona revisa citas, relevancia y hechos.
Activo
API local y terminal
API de solo lectura y terminal en React, solo en la máquina local; la interfaz explica, no decide ni ejecuta.
Estado de cada componente
Validado, experimental o demostración, con la evidencia calculada de este repositorio. Las definiciones están en el inventario del Caso de estudio.
- validado pruebas automáticas que pasan en CI y controles de calidad en cada corrida. No significa auditado por terceros.
- experimental funciona y tiene pruebas, pero sus resultados no se han evaluado fuera de muestra, no se publican como cifras o dependen de supuestos sin contrastar.
- demostración muestra una capacidad con datos de ejemplo o sin contenido real; no es un producto en uso.
| Módulo o sección | Estado | Evidencia | Limitación principal |
|---|---|---|---|
| Renta fija: matemática de bonos (research/**/fixed_income/analytics) | validado | 204 pruebas (archivos de prueba de renta fija); con pruebas de respuesta conocida | Calcula bajo convenciones declaradas; si una convención no está verificada, el paquete lo marca y la página lo muestra. |
| Renta fija: catálogo sellado con hashes | validado | Archivos de catálogo detectados en research/**/fixed_income | El sello prueba integridad del archivo, no la exactitud de su contenido. |
| Renta fija: libro de pronósticos puntuado con Brier | experimental | Código de puntuación Brier detectado en research/**/fixed_income | Una puntuación Brier solo informa con muchos pronósticos resueltos; no se publica como evidencia de habilidad. |
| Renta fija: monitor semanal | experimental | Código de monitor detectado en research/**/fixed_income | Resume cambios de la semana; es descriptivo y no emite recomendaciones. |
| Conectores de datos abiertos (Banco Mundial, UN Comtrade, GDELT, Wikidata) | experimental | 6 pruebas (parsers con respuestas de ejemplo) | Se ejecutan en local y no alimentan el sitio público. |
| Grafo temporal mundial, exposición y agentes de investigación | experimental | 19 pruebas (grafo, propagación de exposición y agentes) | La presión de exposición es diagnóstica, no una probabilidad; sin evaluación fuera de muestra. |
| Datos empresariales SEC/EDGAR y valoración (renta variable, congelado) | experimental | 41 pruebas (parser XBRL, estados financieros normalizados y valoración) | Congelado: heredado del enfoque de acciones, sin mantenimiento activo. |
| Quant Lab (walk-forward, torneo de estrategias, capacidad, validación prospectiva; congelado) | experimental | 52 pruebas (validación retrospectiva y libro prospectivo) | Congelado. Son diagnósticos retrospectivos; no seleccionan ganadores ni sugieren operaciones. |
| Conectores de precios de mercado (Tiingo, Alpha Vantage; congelado) | demostración | 38 pruebas (contratos con respuestas de ejemplo) | Requieren la clave personal de cada usuario y sus datos no se publican; sin datos reales en el sitio. |
| IA supervisada: cola de trabajo y borradores con citas (Ollama local) | experimental | 35 pruebas (propuesta, citas, relevancia y revisión humana) | El modelo solo propone; una persona revisa. No hay evaluación de la calidad de los borradores. |
| API local de solo lectura y terminal React | demostración | 20 pruebas (contrato de la API) | Corre solo en la máquina local; no está desplegada ni la usa nadie más. |
Cómo fluye la información
- FuentesBanco Mundial · Comtrade · GDELT · Wikidata · SEC (congelado)
- Ingestaidempotente · hash SHA-256 · caché
- Calidadtiempo · linaje · barreras
- Investigacióngrafo temporal · evidencia
- RevisiónIA local propone · una persona decide
Fuentes de los conectores
- SEC / EDGAR
- Banco Mundial
- UN Comtrade
- GDELT
- Wikidata
- Tiingo (clave personal)
- Alpha Vantage (clave personal)
Los precios de mercado usan la clave personal de cada usuario y no se redistribuyen.
Principios
- Validación honesta: lo retrospectivo nunca se presenta como prospectivo.
- Trazabilidad: fuente, corte temporal, hash y manifiesto en cada artefacto.
- Humano en el circuito: ningún modelo de lenguaje aprueba su propio trabajo.
- Sin trading: no hay bróker, órdenes ni recomendaciones de inversión.
- Licencias respetadas: los datos con licencia se quedan en el entorno local y no se publican.
Tecnología
Python 3.12 · Polars · DuckDB · pytest · Ruff · React 19 · TypeScript · Vite · Ollama (modelo local, opcional) · GitHub Actions.
Explorar el código
El módulo vive en research/ dentro del repositorio de ColPulse, con su propia suite de pruebas, contratos de datos y decisiones de arquitectura documentadas. Ver ColPulse Research (repositorio privado; pide acceso por LinkedIn).