Construcción & Obras Civiles (Enterprise) 2024 - 2026

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.

Tacna & Nacional
Construcción & Obras Civiles (Enterprise)
Captura del sistema SIGOC Web — Sistema Empresarial de Gestión de Obras Civiles
Arquitectura Hexagonal DDD
Concurrencia Bloqueo Pesimista
Pagos Online PayPal Sandbox v2
Reportes PDF & Excel Auto

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:

Java 21 Spring Boot 3 Arquitectura Hexagonal Domain-Driven Design (DDD) MySQL 8 Spring Data JPA PayPal REST API v2 OpenPDF Apache POI Spring Security Docker

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.

GitHub Ver Código en GitHub

¿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ú.