Agregar sistema de vinculaciones con registros externos de Metabase

- Nuevo schema BD para vinculaciones_externas con constraint único por período
- Cliente Metabase para consultar Ingresos, Carretas, Salidas y Rechazos
- Endpoints API para registros externos (/api/externos/*) y vinculaciones (/api/vinculaciones/*)
- Composable useRegistrosExternos con lógica de vinculación individual y masiva
- Componentes: TablaRegistros, ModalAsignar, ProgressDashboard
- Tab "Externos" en app.vue con sub-tabs y dashboard de progreso
- LotesCard.vue ahora muestra registros vinculados al lote

nuxt4/server/database/03_vinculaciones_externas.sql

@@ -0,0 +1,128 @@
+-- =====================================================
+-- SISTEMA DE TRAZABILIDAD - VINCULACIONES EXTERNAS
+-- =====================================================
+-- Este esquema permite vincular registros de sistemas externos
+-- (Ingresos, Carretas, Salidas, Rechazos) con los lotes del sistema.
+-- Los registros externos se consultan via Metabase API (solo lectura).
+
+-- =====================================================
+-- TABLA: vinculaciones_externas
+-- =====================================================
+-- Relaciona registros de tablas externas con lotes locales.
+-- Cardinalidad: N registros → 1 lote
+
+CREATE TABLE IF NOT EXISTS vinculaciones_externas (
+  id                UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+
+  -- Identificación del registro externo
+  tipo_registro     TEXT NOT NULL,                    -- 'ingreso', 'carreta', 'salida', 'rechazo'
+  registro_id       BIGINT NOT NULL,                  -- ID del registro en la tabla externa
+
+  -- Vinculación al lote local
+  lote_id           UUID NOT NULL REFERENCES lotes(id) ON DELETE CASCADE,
+
+  -- Metadatos de la vinculación
+  fecha_vinculacion TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  usuario_id        TEXT,                             -- Usuario de Authentik que hizo la vinculación
+  observaciones     TEXT,
+
+  -- Cache de datos del registro externo (para evitar consultas repetidas)
+  datos_cache       JSONB,                            -- Snapshot del registro al momento de vincular
+
+  -- Periodo de cosecha (para filtros y unicidad)
+  periodo_cosecha   TEXT NOT NULL DEFAULT '25-26',    -- '25-26' para cosecha 2025-2026
+
+  -- Un registro externo solo puede vincularse una vez por periodo
+  CONSTRAINT vinculaciones_registro_unico UNIQUE (tipo_registro, registro_id, periodo_cosecha),
+
+  CONSTRAINT vinculaciones_tipo_valido CHECK (tipo_registro IN (
+    'ingreso',
+    'carreta',
+    'salida',
+    'rechazo'
+  ))
+);
+
+-- Índices para consultas frecuentes
+CREATE INDEX IF NOT EXISTS idx_vinculaciones_lote ON vinculaciones_externas(lote_id);
+CREATE INDEX IF NOT EXISTS idx_vinculaciones_tipo ON vinculaciones_externas(tipo_registro);
+CREATE INDEX IF NOT EXISTS idx_vinculaciones_periodo ON vinculaciones_externas(periodo_cosecha);
+CREATE INDEX IF NOT EXISTS idx_vinculaciones_registro ON vinculaciones_externas(tipo_registro, registro_id);
+CREATE INDEX IF NOT EXISTS idx_vinculaciones_fecha ON vinculaciones_externas(fecha_vinculacion DESC);
+
+-- Comentarios
+COMMENT ON TABLE vinculaciones_externas IS 'Vincula registros de sistemas externos (Ingresos, Carretas, Salidas, Rechazos) con lotes locales';
+COMMENT ON COLUMN vinculaciones_externas.tipo_registro IS 'Tipo de registro externo: ingreso, carreta, salida, rechazo';
+COMMENT ON COLUMN vinculaciones_externas.registro_id IS 'ID del registro en la tabla externa (Metabase)';
+COMMENT ON COLUMN vinculaciones_externas.lote_id IS 'FK al lote local al que se vincula';
+COMMENT ON COLUMN vinculaciones_externas.datos_cache IS 'Snapshot JSONB del registro al momento de vincular (para evitar consultas repetidas)';
+COMMENT ON COLUMN vinculaciones_externas.periodo_cosecha IS 'Periodo de cosecha en formato YY-YY (ej: 25-26)';
+
+
+-- =====================================================
+-- VISTA: vista_lotes_con_vinculaciones
+-- =====================================================
+-- Muestra cada lote con el conteo de vinculaciones por tipo.
+
+CREATE OR REPLACE VIEW vista_lotes_con_vinculaciones AS
+SELECT
+  l.id,
+  l.codigo,
+  l.tipo,
+  l.fecha_creado,
+  l.cantidad_kg,
+  l.meta,
+  l.lugar_id,
+  COUNT(*) FILTER (WHERE v.tipo_registro = 'ingreso') AS ingresos_vinculados,
+  COUNT(*) FILTER (WHERE v.tipo_registro = 'carreta') AS carretas_vinculadas,
+  COUNT(*) FILTER (WHERE v.tipo_registro = 'salida') AS salidas_vinculadas,
+  COUNT(*) FILTER (WHERE v.tipo_registro = 'rechazo') AS rechazos_vinculados,
+  COUNT(v.id) AS total_vinculaciones
+FROM lotes l
+LEFT JOIN vinculaciones_externas v ON v.lote_id = l.id
+GROUP BY l.id, l.codigo, l.tipo, l.fecha_creado, l.cantidad_kg, l.meta, l.lugar_id;
+
+COMMENT ON VIEW vista_lotes_con_vinculaciones IS 'Muestra lotes con conteo de registros vinculados por tipo';
+
+
+-- =====================================================
+-- FUNCIÓN: get_estadisticas_vinculacion
+-- =====================================================
+-- Obtiene estadísticas de vinculación para un periodo dado.
+
+CREATE OR REPLACE FUNCTION get_estadisticas_vinculacion(p_periodo TEXT DEFAULT '25-26')
+RETURNS TABLE (
+  tipo_registro   TEXT,
+  total           BIGINT,
+  vinculados      BIGINT,
+  sin_vincular    BIGINT,
+  porcentaje      NUMERIC
+) AS $$
+BEGIN
+  RETURN QUERY
+  SELECT
+    v.tipo_registro,
+    COUNT(*)::BIGINT AS total,
+    COUNT(*)::BIGINT AS vinculados,
+    0::BIGINT AS sin_vincular,  -- Se calculará con datos de Metabase
+    100.0 AS porcentaje
+  FROM vinculaciones_externas v
+  WHERE v.periodo_cosecha = p_periodo
+  GROUP BY v.tipo_registro
+  ORDER BY v.tipo_registro;
+END;
+$$ LANGUAGE plpgsql;
+
+COMMENT ON FUNCTION get_estadisticas_vinculacion IS 'Retorna estadísticas de vinculación por tipo de registro para un periodo';
+
+
+-- =====================================================
+-- MENSAJES DE ÉXITO
+-- =====================================================
+DO $$
+BEGIN
+  RAISE NOTICE '✓ Esquema de vinculaciones externas creado exitosamente';
+  RAISE NOTICE '  - Tabla vinculaciones_externas creada';
+  RAISE NOTICE '  - Vista vista_lotes_con_vinculaciones creada';
+  RAISE NOTICE '  - Función get_estadisticas_vinculacion() creada';
+END $$;