Skip to main content
Bienvenido a la documentación oficial del sistema Perecederos. Esta plataforma ayuda a las áreas de recibo y manejo de productos perecederos a controlar su inventario, registrar recepciones, gestionar órdenes de compra y recibir alertas automáticas antes de que los productos caduquen.

Inicio rápido

Levanta el sistema en minutos con Docker Compose y realiza tu primera operación.

Dashboard

Consulta las métricas clave de inventario, alertas de caducidad y RPC en tiempo real.

Inventario

Gestiona el stock de productos perecederos y recibe alertas automáticas por caducidad.

API Reference

Explora todos los endpoints REST disponibles para integrar o automatizar flujos.

¿Qué puedes hacer con Perecederos?

Alertas de caducidad

Recibe alertas automáticas diferenciadas por tipo de producto: carne, farmacia, frutas y más.

Recepciones CEDIS

Registra y rastrea recepciones por camión, departamento y división con trazabilidad completa.

Control RPC

Audita entregas y retornos de productos entre almacén y tienda con bandejas de pendientes y completados.

Órdenes de compra

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

Discrepancias

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

Docker listo

Despliega el stack completo (backend, frontend, base de datos) con un solo comando.

Primeros pasos

1

Despliega el sistema

Clona el repositorio y levanta todos los servicios con Docker Compose. Ver Despliegue con Docker.
2

Accede al dashboard

Abre el navegador en http://localhost:3000, inicia sesión con tu usuario y tienda, y revisa el panel de alertas.
3

Registra una recepción

Ve al módulo de Recepciones CEDIS para registrar la carga de un camión y asociar productos por departamento.
4

Consulta el inventario

Usa el módulo de Inventario para ver qué productos están próximos a caducar y actuar antes de que generen pérdida.
La API REST está disponible en http://localhost:8080/api. Consulta la Referencia de API para ver todos los endpoints disponibles.