Diego Viscarra
←Volver a proyectos
Enterprise Financial ERP / B2B Web Platform

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
1,730+
Pruebas automatizadas

Pytest + Vitest + AST Linter para garantizar cero regresiones matemáticas

DECIMAL(18,6)
Precisión unitaria

Cálculo de tasas sin redondeo para evitar fugas silenciosas de miles de dólares

7 estados
Máquina de estados finita

Ciclo de vida inmutable con trazabilidad estricta de aprobaciones

0
Aritmética en cliente

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:

  1. 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.

  2. 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.

  3. 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.

  4. 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 Puro

El 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ático

Prohibició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