CASO DE ESTUDIO / API DE GESTIÓN DE ACTIVOS
PatrimonioGest API
Desarrollo de una API REST para modernizar la gestión de activos municipales mediante servicios backend mantenibles y lógica de depreciación específica del dominio.
Flujo del sistema
02
Resumen del proyecto
Responsabilidades, tecnologías y alcance de la capa API REST de una plataforma municipal de activos.
- Desarrollé módulos de API REST con Node.js, Express y TypeScript.
- Implementé autenticación, validación, documentación y manejo de archivos.
- Trabajé con PostgreSQL y reglas de depreciación anual de activos.
03
El desafío detrás del proyecto
El cliente gestionaba activos municipales en una plataforma legacy para registrar y administrar bienes públicos como terrenos, edificios y vehículos.
El sistema existente se había vuelto difícil de mantener y ampliar, lo que limitaba nuevas funciones y su evolución técnica. El trabajo de API contribuyó a establecer una base backend más estable.
- Las categorías de activos municipales exigían comprender bien el dominio.
- Las reglas de depreciación anual influían en el comportamiento backend.
- Las futuras integraciones necesitaban una base API más clara.
04
Convertir reglas municipales en comportamiento backend
El enfoque reunió fórmulas y criterios de expertos del dominio, los convirtió en reglas de negocio y validó el comportamiento de la API frente a los resultados esperados.
Flujo del sistema
05
Arquitectura y decisiones técnicas
API REST en capas con Node.js, TypeScript, Express y TypeORM sobre PostgreSQL.
Alcance frontend
No se documentó participación en frontend; la contribución de Wilhen se centró en la capa API REST.
Capa API REST
Endpoints con Node.js, Express y TypeScript, y autenticación JWT.
Datos en PostgreSQL
Entidades TypeORM y persistencia para flujos de activos municipales.
Documentación e integración
Documentación Swagger, validación, manejo de archivos e integración con Cloudinary.
06
Desafíos principales
El desafío documentado fue traducir los criterios de depreciación anual en reglas backend confiables.
- 01 — Identificar qué activos municipales estaban sujetos a depreciación.
- 02 — Convertir las fórmulas del cliente en comportamiento de la aplicación.
- 03 — Validar la lógica de depreciación frente a los criterios esperados.
07
Mi contribución y soluciones destacadas
La contribución de Wilhen se enfocó en implementar la API y apoyar las reglas del dominio, no en asumir el frontend.
- Construí módulos de API REST con Node.js, Express, TypeScript y TypeORM.
- Implementé autenticación JWT, validación de entradas y documentación Swagger.
- Integré PostgreSQL, manejo de documentos e imágenes y soporte de Cloudinary.
- Apoyé la lógica de depreciación anual según los criterios del cliente.
Flujo del sistema
08
Impacto en el negocio
El impacto documentado es cualitativo: mejor mantenimiento, estandarización de flujos y continuidad, sin métricas numéricas verificadas.
- Mejor mantenimiento
- Flujos municipales de activos estandarizados
- Soporte para futuras integraciones
- Continuidad operativa
09
Lecciones aprendidas
Este proyecto reforzó la importancia de comprender reglas específicas del dominio antes de codificarlas en software.
- Las administraciones municipales manejan categorías de activos con reglas distintas.
- La depreciación anual puede definir directamente el comportamiento del software.
- Los criterios administrativos y financieros deben guiar las decisiones técnicas.
10
Próxima evolución
Seguir apoyando nuevas funciones, mantenimiento e integraciones futuras conforme evolucionen las necesidades de gestión de activos.
HABLEMOS