Caso de uso: Retail

Este caso de uso describe cómo una tienda minorista configura y opera Zentto en su día a día, desde la apertura hasta el cierre, cubriendo ventas, inventario y caja.

Perfil de la empresa

• Tipo: Tienda minorista (ropa, electrónica, ferretería, etc.)
• Sucursales: 1 a 5 puntos de venta.
• Empleados: 3-20 personas.
• Módulos clave: POS, Inventario, Facturación, CxC, Compras.

Configuración inicial

1. Datos de la empresa

Configurar razón social, RIF/NIF, dirección y logo en Administración → Empresa.

2. Inventario

• Crear categorías de productos.
• Cargar el catálogo de productos con precios de venta y costo.
• Definir stock mínimo para alertas de reposición.
• Configurar método de costeo (promedio ponderado recomendado para retail).

3. Punto de venta

• Configurar el POS con nombre, impresora fiscal y formas de pago.
• Vincular el POS a la sucursal y almacén correspondiente.
• Asignar cajeros con su rol y permisos.

4. Clientes y proveedores

• Registrar proveedores habituales.
• Configurar lista de precios si hay precios diferenciados (mayor/detal).

📸 Captura: Dashboard de tienda retail con ventas del día y stock bajo

Operación diaria

Apertura del día

1. El cajero inicia sesión en el POS.
2. Realiza la apertura de caja con el monto inicial.
3. El sistema muestra alertas de stock bajo si hay productos por debajo del mínimo.

Ventas

1. Escanear código de barras o buscar producto por nombre.
2. Agregar productos al carrito.
3. Aplicar descuento si aplica (con límite según rol).
4. Seleccionar forma de pago (efectivo, tarjeta, transferencia, mixto).
5. Emitir factura o ticket fiscal.
6. La impresora fiscal genera el documento legal.

Cierre del día

1. Realizar cierre de caja: el cajero cuenta el dinero físico.
2. El sistema compara con el total teórico (ventas del día).
3. Se registran diferencias (sobrante/faltante).
4. Se genera el Reporte Z en la impresora fiscal.
5. Los datos quedan disponibles para el resumen gerencial.

📸 Captura: Pantalla de cierre de caja con comparación teórico vs real

Reposición de inventario

Cuando un producto alcanza el stock mínimo:

1. El sistema genera una alerta de stock bajo.
2. El comprador crea una orden de compra al proveedor.
3. Al llegar la mercancía, se registra la recepción.
4. El inventario se actualiza automáticamente.

Reportes clave para retail

Reporte	Frecuencia	Utilidad
Ventas por día	Diario	Control de ingresos
Productos más vendidos	Semanal	Decisiones de reposición
Margen por producto	Mensual	Rentabilidad
Inventario valorizado	Mensual	Control de activos
CxC vencidas	Semanal	Cobranza

Flujo del usuario

Vista no tecnica del proceso. Pensada para duenos de tienda, supervisores de piso y cajeros que evaluan o usan Zentto.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo tecnico

Vista tecnica para desarrolladores: modulos frontend, endpoints, stored procedures y tablas involucrados.

Componente	Tipo	Ubicacion
module-pos	Micro-frontend Next.js	web/modular-frontend/packages/module-pos/src/
module-inventario	Micro-frontend Next.js	web/modular-frontend/packages/module-inventario/src/
module-ventas	Micro-frontend Next.js	web/modular-frontend/packages/module-ventas/src/
/v1/pos/sale	Route Express	web/api/src/routes/pos/sale.ts
/v1/inventario/products	Route Express	web/api/src/routes/inventario/products.ts
usp_pos_Sale_Insert	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_pos_CashSession_*	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_inv_Product_List	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
usp_cmp_PurchaseOrder_*	Stored procedure dual PG + MSSQL	web/api/sqlweb-pg/includes/sp/
pos.sales / pos.cash_sessions	Tablas operativas	web/api/migrations/postgres/
inv.products / inv.stock_movements	Tablas operativas	web/api/migrations/postgres/

Editable en draw.io: descarga el SVG → File → Import from → Device.