Skip to main content
Perecederos – Gestión de Recibo y Caducidades es una plataforma full-stack diseñada para los equipos de recibo y manejo de productos perecederos en tiendas de retail. Centraliza el control de inventario, registra recepciones de proveedores y de CEDIS, gestiona órdenes de compra, y genera alertas automáticas diferenciadas por tipo de producto antes de que caduquen. El sistema está orientado a supervisores de área y personal operativo que necesitan visibilidad en tiempo real sobre el estado del inventario, trazabilidad de recepciones y control de retornos RPC.

​
Características principales

Alertas de caducidad inteligentes

Genera alertas automáticas diferenciadas por tipo de producto: carnes y aves con 3 días de anticipación, farmacia con 30 días, frutas y lácteos con 1 día.

Dashboard en tiempo real

Panel central con conteos de productos caducados, próximos a caducar y total de alertas críticas activas, actualizado en cada carga.

Recepciones CEDIS

Registra la carga de camiones y filtra recepciones por número de camión, departamento o división para trazabilidad completa.

Órdenes de compra

Crea y gestiona órdenes con validación automática de vigencia y control de estados del ciclo de compra.

Control RPC

Audita entregas y retornos de productos entre almacén y piso de tienda con bandeja de pendientes y completados por camión.

Discrepancias

Registra y consulta discrepancias detectadas durante recepciones para control de calidad y seguimiento de incidencias.

​
Arquitectura del sistema

El stack se compone de tres servicios que se despliegan juntos con Docker Compose:
CapaTecnologíaPuerto
FrontendReact 18 + Vite + Material UI3000
BackendSpring Boot 3 REST API8080
Base de datosPostgreSQL 155432
  • El frontend hace peticiones al backend a través de la base URL http://localhost:8080/api.
  • El backend se conecta a PostgreSQL. En el despliegue Docker el valor SPRING_JPA_HIBERNATE_DDL_AUTO=none protege los datos existentes, por lo que el esquema de base de datos debe existir antes del primer arranque (usa update la primera vez para que Hibernate lo cree automáticamente).
  • Los tres servicios se orquestan desde un único archivo Docker-compose.yml en la raíz del repositorio.
La API REST responde en formato JSON. Consulta la Referencia de API para ver todos los endpoints disponibles y sus parámetros.

​
Módulos disponibles

El sistema está dividido en módulos funcionales, cada uno con su propia vista en el frontend y sus propios endpoints en el backend:

Dashboard

Resumen global de alertas de inventario con acceso rápido a todos los módulos.

Inventario

Listado completo del stock con filtros por caducidad, código de barras, división y departamento.

Recepciones CEDIS

Registro y consulta de recepciones de camiones provenientes del centro de distribución.

Órdenes de compra

Creación, listado y gestión de estados del ciclo de órdenes de compra.

Control RPC

Registro de entregas y retornos, con vista de pendientes y completados por camión.

Discrepancias

Registro de diferencias detectadas en recepciones para auditoría y seguimiento.