Plantillas de Proceso

Una plantilla de proceso es un conjunto declarativo de etapas (operaciones) conectadas en flujo, reusable en tu plano de planta digital-twin. Zentto proporciona una biblioteca de plantillas de sistema (modelos probados por industria) que puedes aplicar directamente al plano sin escribir código.

Cómo acceder

Navegar a Manufactura → Operaciones → Plantillas de Proceso en el menú lateral.

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de operación, planificación y supervisión de piso.

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

El flujo típico es:

1. Elegir plantilla desde la biblioteca (tarjetas con industria y número de etapas; las de Sistema son base reutilizable, las Propias son de tu empresa)
2. Ver el detalle — el diálogo muestra las etapas como flujo horizontal (Op / tipo / ciclo, tooltip con la regla)
3. Aplicar al plano — genera automáticamente los nodos de etapas y sus conexiones en el plano principal (default) del digital-twin
4. Enlazar máquinas — en el Plano de planta, asigna máquinas reales a cada etapa
5. Operar y monitorear — el sistema muestra estado real y OEE sobre el plano

Biblioteca de plantillas de sistema

La biblioteca sembrada incluye flujos reales por industria, entre ellos:

Industria	Plantilla
Automotriz	Línea de ensamblaje de vehículos · Estampado y ensamble de autopartes
Bebidas	Embotelladora de bebidas · Embotellado aséptico de jugos · Producción de cerveza (cervecería)
Alimentos	Enlatadora de pescado · Línea HACCP de alimentos procesados
Tecnología / Electrónica	Ensamblaje electrónico SMT/PCB
Metalmecánica / Metalurgia	Mecanizado CNC y soldadura metalmecánica · Fundición de metales
Plásticos	Moldeo por inyección de plásticos
Farmacéutica	Tabletas farmacéuticas (sólidos orales, GMP)
Textil / Confección	Confección textil (prenda de vestir)
Muebles / Madera	Fabricación de muebles de madera
Cosméticos	Cosméticos: crema / loción (emulsión)
Panadería / Repostería	Panadería / repostería industrial
Lácteos	Lácteos: leche pasteurizada y yogurt
Química	Producción de pinturas y recubrimientos

Cómo aplicar una plantilla

1. Haz clic en la tarjeta de la plantilla deseada
2. Verás un preview de las etapas y conexiones como flujo horizontal
3. Haz clic en Aplicar al plano
4. El sistema genera automáticamente los nodos (etapas) y aristas (flujo) en el plano principal del digital-twin
5. El aviso de éxito ofrece Ver plano para saltar al diseñador, donde puedes ajustar el layout y enlazar cada nodo a su máquina real

Duplicar y personalizar

Las plantillas de sistema no se editan ni se eliminan directamente. Para adaptarlas:

1. Pulsa el icono Duplicar en la tarjeta → se crea una copia editable con nombre <original> (copia) en tu catálogo privado (solo tu empresa la ve)
2. Edita la copia con el icono Editar (abre el wizard) y ajusta etapas, tiempos de ciclo y conexiones según tu línea real
3. Las plantillas propias también se pueden Eliminar (con confirmación)

Crear una plantilla nueva con el Wizard

Para procesos que no encajan en la biblioteca, pulsa Nueva plantilla. El wizard te guía por pasos:

• Datos: nombre (obligatorio), industria (opcional — sirve para sugerir etapas típicas del sector) y descripción
• Etapas: agrega cada operación con nombre, tipo (máquina, centro de trabajo, buffer, entrada, salida) y ciclo en segundos; se requieren al menos 2 etapas con nombre para formar un flujo
• Revisión: resumen de etapas y conexiones en secuencia antes de guardar

La plantilla guardada queda lista para aplicarse al plano cuantas veces necesites.

Buenas prácticas de diseño

Práctica	Por qué	Ejemplo
Etapas por operación unitaria	Facilita análisis de cuellos de botella y asignación de personal	Usa “Soldadura”, no “Soldadura + Limpieza”
Nombra por función, no por máquina	Permite reasignar máquinas sin rediseñar el proceso	”Llenado” (no “Llenadoras PLC-3000”)
Ordena secuencial	El flujo en el plano sigue tu orden; desorden = layout confuso	Siempre izq → derecha
Buffers entre ciclos desiguales	Previenen acumulación entre etapas lentas y rápidas	Cocción (180s) + Buffer → Enlatado (12s)
Define tiempo de ciclo real	El análisis de capacidad depende de esto	Mide 10 ciclos, promedia, agrega 5% amortiguador
Reserva etapas QA/Inspección	Facilita rastreo de defectos	Inspección final + inspección cada N ciclos

---

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures, tablas y servicios involucrados.

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

Modelo de datos

mfg.ProcessTemplate
  ProcessTemplateId         BIGINT (PK)
  CompanyId                 INT (NULL para sistema, >0 para empresa)
  Name                      VARCHAR(150) — nombre único por CompanyId
  Industry                  VARCHAR(80) — "Automotriz", "Bebidas", etc.
  Description               VARCHAR(500)
  Stages                    JSONB — array [{ seq, name, kind, cycleSec, rule }]
  Edges                     JSONB — array [{ from, to }] por seq
  IsSystem                  BOOL (TRUE → plantillas globales, no editables)
  IsActive                  BOOL
  CreatedAt, UpdatedAt      TIMESTAMP

Stages schema:
  {
    "seq": 10,                        // orden (10, 20, 30...)
    "name": "Estampado",              // nombre operativo
    "kind": "machine|workcenter|buffer|input|output",
    "cycleSec": 90,                   // tiempo ciclo en segundos
    "rule": "rate<=step-20 OR capacity>500"  // regla opcional (documental)
  }

Edges schema:
  { "from": 10, "to": 20 }            // seq origen → seq destino

Endpoints (REST)

Método	Endpoint	Descripción
GET	/v1/manufactura/procesos/plantillas	Listar plantillas de sistema + empresa
GET	/v1/manufactura/procesos/plantillas/:id	Detalle: Stages + Edges + metadatos
POST	/v1/manufactura/procesos/plantillas	Upsert de plantilla propia (crear, o editar pasando id; solo IsSystem=false)
DELETE	/v1/manufactura/procesos/plantillas/:id	Eliminar plantilla propia
POST	/v1/manufactura/procesos/plantillas/:id/duplicar	Copiar plantilla (sistema o propia) → plantilla de empresa
POST	/v1/manufactura/procesos/plantillas/:id/aplicar-plano	Generar digital-twin: convierte Stages→nodos, Edges→aristas en mfg.PlantLayout

Stored Procedures (PostgreSQL)

SP	Resultado
usp_mfg_processtemplate_list	Plantillas sistema + empresa, con StageCount
usp_mfg_processtemplate_get	Detalle de una plantilla
usp_mfg_processtemplate_upsert	Crear/editar solo propias — TABLE(ok, mensaje, ProcessTemplateId)
usp_mfg_processtemplate_delete	Eliminar propias (rechaza las de sistema)
usp_mfg_processtemplate_duplicate	Duplicar como plantilla de empresa
usp_mfg_processtemplate_apply_to_layout	Genera mfg.PlantLayout con nodos + aristas

Nota: usp_mfg_processtemplate_apply_to_layout es idempotente: si el plano ya existe (mismo CompanyId + Name), lo reemplaza. Los nodos se posicionan automáticamente en fila (x = 60 + idx×180, y = 140).

Tabla PlantLayout (resultado de apply)

mfg.PlantLayout — UNIQUE(CompanyId, Name)
  PlantLayoutId             BIGINT (PK)
  CompanyId                 INT (FK)
  Name                      VARCHAR(100) — "default", "linea-2", etc.
  Layout                    JSONB { nodes: [...], edges: [...] }
  UpdatedByUserId           INT (FK → sec.User)
  UpdatedAt                 TIMESTAMP

// Tras apply, el usuario enlaza máquinas desde el diseñador de plano
// usando el código de máquina como dataKey del nodo.

Convenciones al diseñar etapas

• seq incrementa de 10 en 10 (10, 20, 30…) para poder insertar etapas intermedias sin renumerar; el orden define el layout izquierda→derecha.
• Tipos de etapa (kind): input (entrada de material), machine (máquina automatizada), workcenter (centro manual/semiautomático), buffer (almacenamiento intermedio de desacople), output (salida a cliente/almacén).
• cycleSec en segundos: promedio de tiempo entre unidades (no incluye setup). Si una etapa es mucho más lenta que la anterior, agrega un buffer.
• Edges mapean por seq, no por índice; se soportan ramificaciones (una salida a múltiples destinos).
• rule es documental: describe la lógica condicional del proceso (p. ej. rate <= tapado AND temp > 65). El SP no la valida ni la ejecuta; el control real vive en el PLC/MES del cliente.

Tabla de componentes técnicos

Componente	Tipo	Ubicación	Responsabilidad
/v1/manufactura/procesos/plantillas*	Routes Express	web/api/src/modules/manufactura/routes.ts	CRUD + duplicar + aplicar-plano
usp_mfg_processtemplate_*	Funciones PL/pgSQL	web/api/migrations/postgres/00292, 00295 + sqlweb-pg/	Persistencia y aplicación al plano
mfg.ProcessTemplate (+ seeds de biblioteca)	Tabla PostgreSQL	migraciones 00292_mfg_process_templates.sql, 00296_mfg_process_templates_library.sql	Plantillas + biblioteca de sistema
mfg.PlantLayout	Tabla PostgreSQL	migración 00289_mfg_plant_layout.sql	Resultado de apply; nodos + aristas del digital-twin
ProcesosPage.tsx	Componente React	web/modular-frontend/packages/module-manufactura/src/components/	Biblioteca de tarjetas, detalle, aplicar/duplicar/eliminar
ProcesoWizardDialog.tsx	Componente React	web/modular-frontend/packages/module-manufactura/src/components/	Wizard por pasos crear/editar plantilla
PlanoPlantaPage.tsx	Componente React	web/modular-frontend/packages/module-manufactura/src/components/	Diseñador del plano; enlace de máquinas
callSp / callSpTx	Helpers	web/api/src/db/query.ts	Invocación de funciones PG

---

Próximos pasos

• Duplica una plantilla de sistema para adaptarla a tu línea real
• Crea tu primera plantilla con el wizard
• Aplica al plano y enlaza máquinas desde el diseñador de planta
• Monitorea el OEE en tiempo real desde la pantalla OEE