Panel VMI

Arquitectura de plataforma

Modelo de datos conceptual (§5), flujos (§6), integraciones (§7), seguridad (§8), roadmap (§9) y consideraciones Perú (§10).

API Mock & Diagramas
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)
  1. 02:00

    ETL ventas día anterior (APIs retailers)

  2. 02:30

    ML recalcula forecast 7–14 días

  3. 03:00

    Replenishment Engine evalúa cada location (FEFO, SAN)

  4. 03:30

    Auto-aprobación umbrales · Escalación excepciones >20%

  5. 04:00

    Órdenes aprobadas → TMS rutas

  6. 06:00

    Picking planta FEFO

  7. 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)
SistemaProtocoloDatos
SAP ERP San FernandoRFC / BAPI / IDocMateriales, órdenes, facturación
SAP / Oracle RetailersEDI EDIFACT / RESTVentas, stock, recepciones
TMS TransporteREST / WebhooksRutas, tracking camiones
WMS AlmacénRESTPicking, packing, despacho
IoT Sensirion / EmersonMQTT / LoRaWANTemperatura, humedad
SAN / DIGESASOAP / RESTTrazabilidad, alertas
SUNATREST API UBL 2.1Facturació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