Panel VMI
Arquitectura de plataforma
Modelo de datos conceptual (§5), flujos (§6), integraciones (§7), seguridad (§8), roadmap (§9) y consideraciones Perú (§10).
Vista general del sistema
Módulos 4.1–4.7 e integraciones SAP, TMS, SAN, SUNAT
Entidades (§5)
PostgreSQL · ClickHouse (Fase 3)
productscustomerscustomer_locationsinventory_snapshotsdemand_forecastsvmi_ordersvmi_order_linescold_chain_events
Ciclo diario (§6.1)
02:00
ETL ventas día anterior (APIs retailers)
02:30
ML recalcula forecast 7–14 días
03:00
Replenishment Engine evalúa cada location (FEFO, SAN)
03:30
Auto-aprobación umbrales · Escalación excepciones >20%
04:00
Órdenes aprobadas → TMS rutas
06:00
Picking planta FEFO
08:00–14:00
Delivery ventanas · QR actualiza inventario cliente
DDL conceptual (extracto)
-- Productos (Catálogo San Fernando)
CREATE TABLE products (
sku VARCHAR(20) PRIMARY KEY,
name VARCHAR(255),
category VARCHAR(50),
shelf_life_days INT,
storage_temp_min DECIMAL(3,1),
storage_temp_max DECIMAL(3,1),
uom VARCHAR(10)
);
-- Clientes (Retailers, HORECA)
CREATE TABLE customers (
id UUID PRIMARY KEY,
ruc VARCHAR(11),
business_name VARCHAR(255),
channel VARCHAR(20),
vmi_contract_id UUID,
geo_region VARCHAR(50)
);
-- Inventario en tiempo real
CREATE TABLE inventory_snapshots (
id BIGSERIAL PRIMARY KEY,
location_id UUID,
sku VARCHAR(20),
lot_number VARCHAR(50),
expiry_date DATE,
quantity DECIMAL(10,2),
recorded_at TIMESTAMPTZ,
source VARCHAR(20)
);Integraciones externas (§7)
| Sistema | Protocolo | Datos |
|---|---|---|
| SAP ERP San Fernando | RFC / BAPI / IDoc | Materiales, órdenes, facturación |
| SAP / Oracle Retailers | EDI EDIFACT / REST | Ventas, stock, recepciones |
| TMS Transporte | REST / Webhooks | Rutas, tracking camiones |
| WMS Almacén | REST | Picking, packing, despacho |
| IoT Sensirion / Emerson | MQTT / LoRaWAN | Temperatura, humedad |
| SAN / DIGESA | SOAP / REST | Trazabilidad, alertas |
| SUNAT | REST API UBL 2.1 | Facturación electrónica |
Seguridad y compliance (§8)
- •OAuth 2.0 + MFA usuarios internos
- •API Keys + JWT integraciones B2B
- •RBAC + ABAC por región y canal
- •TLS 1.3 · AES-256 · campos RUC cifrados
- •audit_log con hash encadenado (SAN)
- •Circuit breakers si retailer cae · cache
- •DR multi-AZ AWS · RPO < 15 min
Roadmap (§9)
Fase 1 — VMI Lite
Meses 1–4- • 2–3 retailers (API/archivos)
- • Inventario + órdenes semi-auto
- • Dashboard fill rate
- • PostgreSQL + Redis + NestJS
Fase 2 — Automatización
Meses 5–8- • Motor replenishment (reglas)
- • EDI SAP
- • App repartidor Flutter
- • Trazabilidad por lotes
Fase 3 — Inteligencia
Meses 9–12- • ML Prophet/XGBoost
- • ClickHouse analytics
- • IoT HORECA premium
- • Alertas SAN auto
Fase 4 — Escala
Meses 13–18- • Kafka + microservicios
- • TFT demand sensing
- • E-commerce / export
- • Marketplace API
Mercado peruano (§10)
- • Conectividad intermitente (norte/selva): app offline-first con sync diferida
- • SUNAT: facturación electrónica UBL 2.1 obligatoria
- • HORECA/bodegas sin ERP: onboarding con app de conteo semanal
- • Temporadas: Fiestas Patrias (jul), Navidad (dic), Semana Santa