Sistema de Control Presupuestario de Obras
Gobernanza financiera, auditoría con precisión de 6 decimales y prevención de sobrecostos en tiempo real.
- Rol
- Lead Fullstack Engineer & Software Architect
- Cliente
- Grupo ConstruMarket
- Periodo
- 2026 — En Producción
- Estado
- Sistema en producción activa
Pytest + Vitest + AST Linter para garantizar cero regresiones matemáticas
Cálculo de tasas sin redondeo para evitar fugas silenciosas de miles de dólares
Ciclo de vida inmutable con trazabilidad estricta de aprobaciones
Invariante I-14: todo cálculo financiero se ejecuta en el núcleo de dominio
Así se ve
Espacio de Proyecto (Project Command Center). Centro de mando unificado con semáforos de desviación de margen en tiempo real, KPIs ejecutivos e historial de eventos sin pestañas fragmentadas.
Aviso: Los datos, cifras y registros mostrados son ficticios y corresponden a pruebas simuladas (mock data); no pertenecen a la empresa ni exponen información real.
El problema
ConstruMarket diseña, suministra e instala obras arquitectónicas monumentales (centros comerciales, pérgolas bioclimáticas, cancelería). En proyectos de 2 a 12 meses con cientos de insumos, el sistema legacy en hojas de cálculo sufría de 4 dolores críticos:
- 01
Fugas silenciosas por redondeo
El sistema legacy trataba el costo unitario como dinero con 2 decimales en vez de una tasa. En 14,800m de cable, redondear $0.1534 a $0.15 causaba pérdidas inmediatas de $50 por línea.
- 02
Gasto a ciegas y sobrecostos tardíos
Compras emitía pedidos sin saber el saldo remanente real del rubro; los sobregiros se detectaban semanas después cuando la factura del proveedor llegaba a contabilidad.
- 03
Mutabilidad de presupuestos aprobados
Cualquier ajuste sobreescribía la base de datos, destruyendo la foto histórica original ('papel de lo aprobado') aprobada por el comité de gerencia.
- 04
ERP corporativo intocable
El ERP corporativo (SAMI, 500+ tablas) prohibía modificaciones en su esquema. Toda la solución debía convivir en un esquema satélite sin bloqueos transaccionales.
Decisiones de arquitectura
Arquitectura Hexagonal Pura (Ports & Adapters)
Dominio PuroEl núcleo de dominio no tiene ninguna dependencia externa (ni Flask, ni SQL Server, ni bibliotecas externas).
- Reglas de negocio y cálculos financieros encapsulados en entidades puras de Python.
- Puertos abstractos (Interfaces ABC) para repositorios de datos y servicios externos.
- Adaptadores HTTP e infraestructura desacoplados y fácilmente testeables.
Gobernanza Financiera: Invariante I-14
Rigor MatemáticoProhibición total de cálculos de dinero en el frontend.
- El cliente web solo renderiza valores exactos devueltos por el backend.
- Validación en milisegundos de disponibilidad de rubro antes de admitir cualquier solicitud de gasto.
- Instantáneas inmutables mes a mes para el cierre financiero de proyectos.
Stack
- Backend
- Python 3.13
- Flask 3.0
- pyodbc 5.2
- ReportLab 5.0
- OpenPyXL
- Frontend
- React 19
- TypeScript
- Vite
- TanStack Query v5
- Tailwind CSS
- Base de datos
- Microsoft SQL Server
- Esquema aislado proyectos.*
- Transacciones atómicas