James Valencia
← Proyectos

2025 — presente

DocuCobro — gestión contable multiempresa con integración SIIGO

Fundador y autor único — CtisEvolution

Impacto

El equipo dejó de reconciliar a mano entre el sistema de cobro y la contabilidad en SIIGO — y el sistema sigue funcionando aunque el servicio de autenticación externo tenga una caída.

ReactTypeScriptExpressPostgreSQLDrizzleJWTPlaywright

El problema

Empresas que ya llevan su contabilidad en SIIGO necesitaban facturación, cobro recurrente y portales de cliente sin duplicar el tipeo entre dos sistemas distintos.

El enfoque

Los comandos hacia SIIGO se generan y ejecutan a través de un servicio dedicado, con cada comando correlacionado por UUID contra el archivo Excel de resultado que SIIGO termina generando — así el sistema sabe qué resultado corresponde a qué operación aunque el proceso sea asíncrono.

La autenticación es híbrida y resiliente: intenta primero contra un servicio de autenticación externo de la empresa y, si ese servicio no responde, cae automáticamente a autenticación local con bcrypt contra la base propia — degradación elegante en vez de que todo el sistema quede inutilizable por una dependencia caída.

Hay también una lección de bundling documentada en el propio código: usar await import() dinámico para jsonwebtoken y bcrypt rompía en producción porque esbuild los empaquetaba mal (el error en runtime era del tipo "función no es una función"); la solución fue volver a imports estáticos.

El sistema tiene tests e2e con Playwright cubriendo el flujo completo, incluyendo variantes de pasarela de pago.

Es un producto propio de CtisEvolution, construido prácticamente en solitario — la ayuda externa se limitó a piezas puntuales, nunca al diseño ni a la implementación completa.

Resultado

El equipo dejó de reconciliar a mano entre el sistema de cobro y la contabilidad en SIIGO — y el sistema sigue funcionando aunque el servicio de autenticación externo tenga una caída.