PRIVATE PRODUCTION SYSTEM
API para gestión digital de expedientes
Backend para reemplazar un flujo apoyado en una planilla Excel compartida por una API estructurada y mantenible.
Contexto y problema
El flujo de gestión de expedientes se apoyaba en una planilla Excel compartida. El objetivo fue reemplazar ese soporte por una API que permitiera centralizar la información, las reglas, las validaciones y las operaciones del proceso.
El trabajo consistió en llevar una necesidad operativa a un backend estructurado y mantenible, con una interfaz explícita para la aplicación consumidora.
Mi responsabilidad
Desarrollé principalmente el backend: diseño e implementación de la API, acceso a datos, autenticación, documentación, testing y CI. Mi responsabilidad fue conectar esas piezas para dar soporte al flujo de gestión de expedientes.
Enfoque técnico
Implementé la API REST con Node.js y Express, utilizando Sequelize y MySQL para el acceso y la persistencia de datos relacionales. La API concentró las reglas y validaciones de las operaciones, separándolas de la interfaz consumidora.
La autenticación utilizó JWT.
Contratos y documentación
Documenté los contratos de la API con Swagger/OpenAPI 3 para hacer explícita la interfaz de integración: qué operaciones ofrece, qué entradas espera y qué respuestas puede devolver. La documentación permite consultar el contrato sin tener que reconstruirlo desde el código del backend.
Este caso explica el propósito de esos contratos sin publicar rutas, modelos ni payloads privados.
Testing, reproducibilidad y CI
Utilicé Jest y Supertest para tests de integración y de API, y Docker Compose para reproducir el entorno local. La validación no se limitó a probar lógica JavaScript aislada: también involucró una base MySQL y su preparación mediante migraciones y seeds.
En GitHub Actions, el flujo preparó ese entorno y ejecutó la suite. Esto permitió detectar problemas de inicialización y del estado real de la base de datos, además de errores en la lógica de la aplicación.
La secuencia pública conceptual es: Push/PR → GitHub Actions → Docker Compose → MySQL → migraciones → seeds → Jest/Supertest. Resume el recorrido de validación sin reproducir la configuración privada.
Resultado y mantenimiento
El sistema llegó a producción y fue utilizado por más de veinte usuarios. Hubo ajustes iniciales y, tras la estabilización, el mantenimiento fue relativamente reducido.
Participé profesionalmente en la puesta en producción y el mantenimiento desde mi responsabilidad sobre el backend.
Qué demuestra
- Desarrollar un backend desde un problema operativo hasta una aplicación utilizada en producción.
- Definir y documentar contratos de API para su integración con un frontend consumidor.
- Construir una validación reproducible con base de datos, migraciones, seeds y tests de integración/API.
- Participar profesionalmente en la puesta en producción y el mantenimiento del backend.
Tecnología y evidencia
Tecnología principal: Node.js · Express · Sequelize · MySQL · JWT · Swagger/OpenAPI 3 · Jest · Supertest · Docker Compose · GitHub Actions.
La implementación, la documentación y la evidencia técnica privada respaldan este relato profesional. La evidencia visual pública incluye los diagramas conceptuales derivados de arquitectura e ingeniería: permiten explicar el enfoque sin exponer el sistema interno ni equivaler a una verificación pública de su operación.
Nota de privacidad
PRIVATE PRODUCTION SYSTEM
El sistema pertenece a un contexto profesional privado. No se publican nombres institucionales, datos, endpoints, modelos, payloads ni detalles de infraestructura. Tampoco se enlazan repositorios o documentación institucionales.