StockFlow API
API REST para la gestión de inventarios construido con Spring Boot y PostgreSQL, funcionando además como punto de venta (POS) con registro de ventas e historial de movimientos.
Construido con
Java
Spring Boot
PostgreSQL
Docker
{
"productId": 17,
"quantity": 3
}
{
"saleId": 204,
"productName": "Teclado mecánico",
"quantity": 3,
"total": 450.00,
"stockRemaining": 12,
"createdAt": "2026-07-12T13:04:22Z"
}
Ejemplo real: registrar una venta descuenta el stock automáticamente
Resumen
StockFlow es una API REST que proporciona un sistema de gestión de inventarios pensado para pequeños y medianos negocios, ya que administra proveedores, catálogo de productos y niveles de stock desde un único backend.
Además de la gestión de inventario, StockFlow funciona como punto de venta (POS): registra ventas, actualiza el stock automáticamente y mantiene un historial completo de movimientos para trazabilidad total.
Rol
Desarrollo individual
Estado
En producción (self-hosted)
Documentación
Swagger / OpenAPI
Despliegue
Docker en servidor personal
Cómo funciona
Proveedor
Se registra y se asocia a los productos que surte.
Producto & Stock
Se da de alta en el catálogo con su cantidad disponible.
Punto de Venta
Cada venta descuenta stock y calcula el total al instante.
Historial
El movimiento queda registrado para trazabilidad y auditoría.
Funcionalidades clave
Punto de Venta (POS)
Registro de ventas que descuenta stock automáticamente y calcula totales con y sin impuestos al momento.
Catálogo de Productos y Stock
Control de existencias en tiempo real, con actualización automática ante cada movimiento.
Historial de Movimientos
Trazabilidad completa de entradas y salidas de inventario para auditoría y reportes.
Gestión de Proveedores
Alta, edición y consulta de proveedores asociados a los productos del inventario.
Stack Tecnológico
Lenguaje & Framework
Java
Spring Boot
Spring Web
Persistencia
PostgreSQL
JPA / Hibernate
Pruebas y documentación
Postman
OpenAPI
Swagger UI
Infraestructura y despliegue
Ubuntu Server
Docker
Arquitectura
- API REST construida con Spring Boot y Spring Web
- Persistencia con JPA / Hibernate sobre PostgreSQL
- Documentación interactiva con Swagger / OpenAPI
- Contenerizada con Docker y desplegada en el home lab personal
Documentación de la API
Explora todos los endpoints, modelos de datos y prueba las peticiones directamente desde Swagger UI.
Construí StockFlow para poner en práctica arquitectura backend real: persistencia con JPA/Hibernate y PostgreSQL, reglas de negocio, documentación con Swagger y despliegue con Docker.
— Jesús Romero, desarrollador
¿Quieres ver más proyectos?
Regresa al portafolio para conocer el resto de mi trabajo.
Volver al portafolio