FT-FLU-06 · Plantilla en línea para carga y enriquecimiento masivo

En 30 segundos

Para no depender de Excel, el seller puede capturar o pegar columnas en una plantilla en línea dentro del portal. Cada celda le avisa al momento si falta un obligatorio, si el valor no está en la lista o si no corresponde al campo del que depende; lo demás se valida en segundo plano. No es otro flujo: lo capturado entra a la misma carga masiva, con el mismo reporte y la misma creación.

• Módulo dueño: MS-02 Producto. También participan: MS-01 Catálogo, MS-06 Evaluación.
• Etapa 0 · Entrada. Recibe «PE-C · Catálogo vigente», «PE-T · Usuario con permisos y bitácora» y entrega «PE-1 · Propuesta en Borrador».
• APIs: construye 1 y usa 10 que construyen otras épicas.
• Eventos: publica 2 y consume 1.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

Tareas que abre o cierra: Validación automática.

2. Diagrama de contexto

Quién participa y cómo se conecta. Las pantallas llegan por el BFF del portal, que valida el token y compone; cada módulo vuelve a validar el token y decide sus permisos con los roles de MS-13.

🟩 Verde: nuevo, se construye · 🟦 Azul: ya existe y se queda, se reutiliza su código · 🟧 Naranja: temporal o se retira (se apaga en R3) · ⬜ Gris: sistema externo · ★ módulo dueño

3. Diagrama de flujo

El camino principal, paso por paso. Cuando una pantalla llama a un módulo se ven dos flechas: la pantalla al BFF y el BFF al módulo. Los eventos salen del outbox del módulo después de guardar; quien los consume ignora los repetidos.

3.1 Más de 500 renglones: sigue en Excel

3.2 Campo que depende de otro

3.3 Retoma lo que guardó sin enviar

4. Si algo sale mal

• Pega un valor que no está en la lista. La celda se marca al momento con el aviso; si se envía así, la validación de MS-02 lo regresa como «por corregir» con la columna y el motivo, y ese renglón no se crea.
• Intenta guardar más de 500 renglones. MS-02 rechaza el envío completo por el límite (413 LIMIT_EXCEEDED) y el portal le ofrece bajar la plantilla de Excel para seguir fuera de línea.
• Se corta la sesión antes de enviar. Lo guardado como carga sin aplicar sigue en MS-02 y se retoma desde «Mis cargas»; lo que no se guardó se pierde, porque el portal no guarda datos del catálogo.
• La plantilla cambia mientras captura. Los renglones a los que les falta algo de la versión vigente salen con TEMPLATE_VERSION_OUTDATED y el portal recarga la cuadrícula con la versión nueva.

5. APIs

Las que construye esta épica (1)

null

{
  "success": true,
  "data": {
    "templateId": "EU4-0412",
    "version": 7,
    "business": "MKP",
    "maxRows": 500,
    "columns": [
      {
        "code": "MARCA",
        "level": "REQUIRED",
        "type": "LIST",
        "list": "MARCA",
        "search": true
      },
      {
        "code": "COLOR",
        "level": "REQUIRED",
        "type": "LIST",
        "list": "COLOR"
      },
      {
        "code": "TONO",
        "level": "OPTIONAL",
        "type": "LIST",
        "list": "TONO",
        "dependsOn": "COLOR"
      },
      {
        "code": "CAPACIDAD",
        "level": "REQUIRED",
        "type": "NUMBER",
        "unit": "MAH"
      },
      {
        "code": "MATERIAL",
        "level": "RECOMMENDED",
        "type": "LIST",
        "list": "MATERIAL"
      }
    ],
    "lists": {
      "COLOR": [
        {
          "code": "NEGRO",
          "label": "Negro"
        },
        {
          "code": "ROJO",
          "label": "Rojo"
        }
      ],
      "TONO": {
        "byParent": {
          "ROJO": [
            {
              "code": "ROJO_VINO",
              "label": "Rojo vino"
            }
          ]
        }
      },
      "MATERIAL": [
        {
          "code": "PLASTICO",
          "label": "Plástico"
        }
      ]
    },
    "rows": [
      {
        "productId": "PRD-0004812",
        "sku": "1000004812",
        "cells": {
          "MARCA": "MARCA01",
          "COLOR": "ROJO",
          "CAPACIDAD": 10000
        }
      }
    ],
    "prefillNote": null
  }
}

Las que usa y construye otra épica (10)

Su request y su response están en la página de la épica que la construye.

6. Eventos

Publica

Consume

7. Datos

Cada colección tiene un solo dueño, el único que escribe en ella.

8. Historias que cubre

9. Decisiones de esta épica

Las tomó el TL como arquitecto; quedan como [Propuesta] hasta que el equipo de la épica las revise.

• D-FLU-06-1. La plantilla en línea es otra forma de llenar la misma carga masiva: lo capturado se manda a MS-02 como renglones (API-02-046 con source ROWS, origen BULK y canal ONLINE_TEMPLATE), con la misma validación asíncrona, la misma evaluación de MS-06 y el mismo reporte; el SKU se crea con la misma lógica que si viniera de Excel. Por qué: Cumple H4 (misma creación por Excel o en línea) y no agrega un segundo motor de validación que mantener. Se apoya en DEC-55, DEC-54, RN-MAS-02, RN-ALT-12.
• D-FLU-06-2. En vivo sólo los avisos que salen de los datos de MS-01: obligatorio vacío, valor fuera de lista y dependencia de un nivel entre atributos, que la cuadrícula toma de la vista efectiva compuesta por el BFF. Todo lo demás (tipos, reglas de calidad, lista negra, coincidencias) corre en segundo plano al guardar o al enviar. Por qué: Es lo que pide RF-MAS-11 y evita que la regla viva en el navegador: la lista y la dependencia vienen del dueño del catálogo, y la validación que decide es la de MS-02. Se apoya en RF-MAS-11, RN-GEN-04, RF-CAL-03.
• D-FLU-06-3. Guardar sin enviar es una carga con applyWhenValidated = false: los renglones y sus resultados quedan en MS-02 y se retoman desde «Mis cargas». El portal no guarda nada. Por qué: Los fronts no guardan datos del catálogo y así no hace falta otro almacén de borradores para la cuadrícula. Se apoya en ADR-12.
• D-FLU-06-4. Límite de arranque: 500 renglones por envío; para más, Excel. Las listas grandes, como marcas, se buscan por texto contra MS-01 con paginación y nunca se bajan completas. Por qué: Un seller con 12,000 registros sigue con Excel (H4); el valor exacto lo fija la evaluación técnica con la prueba de intermitencia. Se apoya en PEN-58, PEN-91, S10-RF-25.
• D-FLU-06-5. Se construye después del Excel (ola 3) y sólo si la evaluación técnica la aprueba; no bloquea R2 ni agrega nada al núcleo: es una ruta del BFF sobre la carga de FT-FLU-04. Por qué: La propuesta formal está acordada pero su factibilidad no; así su costo queda en la pantalla y en una composición del BFF. Se apoya en DEC-55, PEN-90.

Qué falta decidir

Nada propio de esta épica: lo que sigue abierto está en las decisiones del programa.

También siguen abiertos: PEN-90, Elaborar la propuesta formal de la plantilla en línea; el corpus no le da responsable; PEN-91, El equipo técnico evalúa capacidad e intermitencia de la cuadrícula con la carga esperada; PEN-58, Fijar el límite de renglones de la versión en línea (aquí arranca en 500).

Fuentes

1. [D] trazabilidad/features/FT-FLU-06-plantilla-en-linea-carga-masiva.md: la ficha de la épica, con sus historias, reglas y bloqueos.
2. [D] ADR-12 · Un solo sistema: backend compartido y una sola base (sección 3.4).
3. [D] docs/arquitectura/por-epica/base/: piezas, colecciones, eventos y el hilo de punta a punta.
4. [D] docs/arquitectura/omega-a-pim-headless/contratos-api.md: convenciones y endpoints de partida.
5. [D] docs/arquitectura/maquina-de-estados-to-be/propuesta-maquina-de-estados.md §7: estados, tareas y canales.
6. [I] Las decisiones de la sección 9 son del TL sobre esas fuentes.