Inspiración

En EIRA Movimiento Rosa cada coordinación lleva su propio Excel: Tamizaje Rosa registra atenciones, Melenas en Movimiento registra trenzas donadas y pelucas entregadas, y así cada programa. Cuando un aliado pide un informe, Presidencia los junta a mano. Nos lo contaron el mismo día del evento: es lento, se presta a errores, y una misma mujer puede aparecer en dos programas o en dos versiones del mismo archivo.

Detrás de cada fila hay una mujer que recibió atención. Queríamos que esas cifras se pudieran sumar con confianza y contar sin pasar una tarde copiando y pegando.

Qué hace

Informes que unen convierte los Excel sueltos de cada programa en un tablero vivo y en informes listos para entregar.

  1. Tablero. Presidencia filtra por programa, municipio y periodo, y las cifras, el mapa y las gráficas cambian al instante.
  2. Subir archivos. Arrastra el Excel o CSV de una coordinación. Cada archivo recibe de 1 a 5 estrellas de calidad y una explicación en palabras ("8 filas sin ID", "Este archivo ya se cargó como rosa.xlsx").
  3. Los datos se actualizan. Al terminar la carga, el tablero refleja lo nuevo: sube la cifra, aparece el municipio en el mapa y la carga queda en el historial con sus estrellas.
  4. Dos informes. Uno de impacto para aliados estratégicos y otro territorial para gobierno y hospitales, con la selección actual del tablero, en PDF y CSV.

Cada cifra dice de qué archivos sale y con qué fecha de corte. Las cifras que pidió EIRA van primero: personas impactadas, edad promedio y desglose por ciudad.

Lo que nos importó

  • Contar a cada persona una sola vez. El mismo archivo se reconoce aunque cambie de nombre, se vuelva a guardar o se exporte a CSV. La misma fila registrada por dos coordinaciones cuenta una vez. Y cuando dos registros tienen el mismo ID con nombres distintos, el sistema no adivina: lo pregunta a una persona.
  • No mezclar lo que no se suma. Quien dona una trenza es donante y no infla la cifra de personas impactadas; quien recibe una peluca sí cuenta. Una atención no es una persona.
  • Cifras exactas, nunca estimadas. La guía de EIRA prohíbe presentar una deduplicación aproximada como cifra oficial, y la respetamos.
  • Privacidad desde la entrada. En las bases no hay nombres completos ni el ID en claro: los datos se seudonimizan al llegar.

Cómo lo construimos

  • Valkey es el centro: cola de trabajos (Streams con grupo de consumidores), memoria de duplicados, conjuntos de personas para contar únicas y cruzar programas con SCARD y SINTERCARD, y el canal de avisos que actualiza el tablero.
  • Un motor en Python (pandas, openpyxl, RapidFuzz) lee cada Excel, calcula la huella de cada archivo y de cada fila, y propone los pares dudosos de personas.
  • El frontend en Next.js y el motor nunca se llaman entre sí: hablan solo por un contrato de claves en Valkey que escribimos antes del código.
  • Los resultados viven en SQLite, que alimenta tableros de Metabase.
  • La presencia territorial usa el catálogo oficial de INEGI (2,478 municipios) y se muestra como "presencia en N municipios", nunca como faltante.
  • Agregar un programa nuevo es agregar una entrada al catálogo, sin tocar el código.
  • Trabajamos con Devin por ramas: un agente construía y otro revisaba cada pieza antes de integrarla.

Retos

  • El ID de EIRA (iniciales más fecha de nacimiento) puede repetirse entre dos mujeres distintas. Decidimos que el sistema proponga y una persona decida.
  • "El mismo archivo" casi nunca tiene el mismo nombre. Por eso hay huellas de bytes, de contenido y de cada fila.
  • Varias piezas en paralelo en pocas horas sin que se pisaran: el contrato de claves en Valkey fue lo que lo hizo posible.

Qué aprendimos

Lo difícil no es graficar, es decidir qué cuenta. Una donante no es una beneficiaria, una inasistencia no es una atención, y un archivo con otro nombre no es un informe nuevo. Con datos de salud, el humano tiene que seguir en el bucle.

Qué sigue

Probarlo con los Excel reales de una coordinación, acordar con EIRA un identificador más robusto (como la CURP), y sumar cuentas de usuario, respaldos y aviso de privacidad para un piloto. El proyecto es código abierto (MIT) para que cualquier organización social pueda usarlo.

Built With

  • claude-code
  • devin
  • duckdb
  • hermes
  • inegi
  • metabase
  • next.js
  • orca
  • playwright
  • react
  • shadcn/ui
  • sqlite
  • tailwind
  • typescript
  • valkey
  • vitest
Share this project:

Updates

Submission history