SIGOC Web — Sistema Empresarial de Gestión de Obras Civiles
Java 21 · Spring Boot 3 · Arquitectura Hexagonal
Plataforma empresarial de control y fiscalización de obras civiles desarrollada bajo Arquitectura Hexagonal (Ports & Adapters) y Domain-Driven Design (DDD). Integra pasarela de pagos con PayPal REST v2, seguimiento de valorizaciones con Curva S acumulada, bloqueo pesimista en base de datos para prevenir sobreventas y generación de reportes ejecutivos en PDF y Excel.
El Desafío Operativo
En el sector de obras civiles y contratistas, las pérdidas financieras se deben frecuentemente al descontrol en las valorizaciones, desorden en almacenes de obra con múltiples despachadores concurrentes y desajustes de flujo de caja. Los sistemas tradicionales de escritorio no ofrecen pagos en línea ni reportes gerenciales en tiempo real.
La Solución de Ingeniería
Se diseñó una arquitectura desacoplada en Spring Boot 3 con Java 21 separando Dominio, Aplicación e Infraestructura mediante Puertos y Adaptadores. Esto asegura que las reglas de negocio sean completamente independientes de MySQL 8 y de servicios externos como PayPal o librerías de reportes, permitiendo alta mantenibilidad y pruebas unitarias aisladas.
Decisiones de Arquitectura & Componentes Críticos
Implementación modular y decisiones técnicas orientadas a resiliencia, mantenibilidad y consistencia transaccional.
Bloqueo Pesimista en Base de Datos (@Lock(PESSIMISTIC_WRITE))
Implementado a nivel de repositorio JPA para garantizar consistencia transaccional absoluta en el stock de materiales y partidas presupuestales ante solicitudes concurrentes simultáneas.
Cálculo y Renderizado de Curva S Acumulada
Algoritmo financiero para comparar el avance físico programado vs. el avance real valorizado a lo largo del tiempo, facilitando la toma de decisiones gerenciales.
Pasarela de Pago PayPal REST v2 con Verificación Criptográfica
Integración robusta de órdenes de pago y captura en tiempo real con Sandbox/Live, validando estados y confirmando pagos de valorizaciones sin intervención manual.
Generación de Reportes Ejecutivos (OpenPDF & Apache POI)
Exportación automatizada de cronogramas, presupuestos y comprobantes en PDF y Excel con tablas formateadas y resúmenes ejecutivos listos para auditoría.
Stack Tecnológico Utilizado
Lenguajes, frameworks, bases de datos y librerías utilizadas en la implementación de este proyecto:
Auditoría de Código y Repositorio en GitHub
Revisa la estructura de carpetas, tests unitarios, Dockerfile y documentación técnica directamente en el repositorio público.
¿Planeas implementar un sistema con este nivel de arquitectura?
Diseño y desarrollo sistemas de software a medida, APIs transaccionales y automatización de datos para empresas y proyectos en Tacna y todo el Perú.