CheckWise

Problema

La reforma de subcontratación de 2021 (REPSE) hace a una empresa responsable solidaria de las obligaciones laborales y fiscales de sus proveedores. Para estar cubierta, debe reunir y revisar evidencia recurrente de cada proveedor: declaraciones mensuales, bimestrales, cuatrimestrales y anuales ante SAT, IMSS, INFONAVIT y la STPS. En la práctica eran miles de PDFs, hojas de cálculo y correos, sin una vista clara de la exposición.

Restricciones

• Tres públicos con trabajos distintos: proveedores que cargan, revisores de LegalShelf que deciden y empresas cliente que leen el riesgo.
• Los proveedores suelen ser contadores no técnicos que trabajan en español, muchos desde el celular.
• Las decisiones críticas requieren revisión humana autorizada. Las verificaciones objetivas y reglas configuradas por el cliente tienen un alcance explícito y auditable.
• Un equipo pequeño responsable de la operación, revisión de migraciones y liberaciones controladas.

Decisiones

1. Modelar obligaciones como institución × ciclo, no como lista

   Una lista plana no puede expresar que un pago del IMSS es mensual y una declaración del INFONAVIT es bimestral. Modelar cada obligación por institución y ciclo hizo que el calendario, los recordatorios y la vista de riesgo salieran de una sola estructura.

2. Reglas explícitas, revisión trazable

   Cada carga recibe una prevalidación automática: un veredicto claro, los datos que leyó y en qué parte de la página los leyó. Las decisiones críticas quedan en manos de un revisor autorizado; las reglas configuradas de aceptación y rechazo son distintas de la lectura del modelo, y las transiciones conservan su historial.

3. Un solo vocabulario de estados, protegido por pruebas

   Tres portales que describen el mismo documento de forma distinta destruyen la confianza. Las etiquetas de estado viven en un solo módulo y las pruebas rompen el build si una pantalla inventa su propia redacción.

4. Publicar con agentes, detrás de compuertas

   Defino arquitectura y restricciones antes de usar agentes de programación. Revisión de tipos, pruebas pertinentes, cobertura y revisión determinan qué está listo para una liberación controlada.

Espacio del cliente

Cómo se construyó

• Me hice cargo del modelo de obligaciones, APIs, interfaces de revisión y entrega para proveedores, clientes y revisores.
• Conecté instituciones, ciclos, periodos y contratos para que calendarios y estados compartan el modelo de dominio.
• Construí flujos documentales separando sugerencias del modelo, reglas configuradas y decisiones humanas autorizadas.
• Dirijo agentes de programación en worktrees aislados, defino restricciones y verificaciones, y reviso los cambios antes de liberarlos.

Cómo construyo →

Resultado

El corte de septiembre de 2026 registró 7 empresas cliente, más de 15 proveedores y cerca de 20,000 documentos procesados; los revisores resolvían unos 50 documentos diarios en cerca de un minuto cada uno. La liberación del 19 de octubre añadió flujos por contrato para proveedores, calendarios por contrato y herramientas de prospectos. Tiene seis superficies: portal de proveedores, portal de clientes, consola de revisión, sitio público, una academia integrada con 33 lecciones filmadas y un módulo de reportes. Las cargas pasan por verificación en vivo de folios CFDI ante el SAT y detección de documentos generados por IA, y los clientes pueden definir sus propias reglas de aceptación y rechazo automático.

Evidencia

• 7 empresas cliente, más de 15 proveedores y cerca de 20,000 documentos procesados en producción.
• 2,454 commits en la rama principal entre el 12 de mayo y el 11 de septiembre de 2026.
• 667 pull requests fusionados entre junio y septiembre.
• 9,941 pruebas de backend y 4,773 de frontend en el corte de verificación de septiembre de 2026; es una referencia fechada, no un contador en vivo.
• En línea en checkwise.com.mx. El código es privado; con gusto lo muestro en una llamada.

Tecnologías

Python · FastAPI · PostgreSQL · Next.js 16 · React 19 · TypeScript · Claude API · Google Document AI · Render · Vercel · Playwright

Enlaces

Ver el sitio en línea ↗