Manual de Usuario

1. Introducción

OFControl es un sistema de control digital de órdenes de fabricación diseñado para empresas del sector alimentario e industrial que necesitan registrar, controlar y trazar cada paso de su proceso productivo. Sustituye los registros en papel y las hojas Excel por un sistema digital completo: los operarios rellenan los controles de cada fase desde una tablet, y el responsable de producción gestiona las órdenes, los procesos, las incidencias y los informes desde el PC.

OFControl forma parte del ecosistema TrazIA, una familia de aplicaciones diseñadas para digitalizar el control de calidad, el mantenimiento, la limpieza, las visitas, las inspecciones y la producción en empresas industriales y alimentarias.

1.1. ¿Por qué digitalizar las órdenes de fabricación?

• Trazabilidad completa: cada campo rellenado en cada fase queda registrado con fecha, hora, operario y valores exactos. Puedes buscar cualquier lote de materia prima y saber en qué órdenes se ha utilizado.
• Control de calidad en tiempo real: los campos numéricos tienen rangos de validación configurables. Si un operario introduce un valor fuera de rango, el sistema genera automáticamente una incidencia de calidad.
• Procesos configurables: cada empresa define sus propios procesos, campos, catálogos y estructuras de fabricación. No es necesario programar nada: todo se configura desde la aplicación.
• Procesos iterativos: para procesos que se repiten según un dato del pedido (por ejemplo, un bloque de campos por cada color de serigrafía), el sistema genera automáticamente las repeticiones necesarias.
• Multi-registro: para procesos con cambios de lote o días diferentes de producción, los operarios pueden añadir múltiples registros dentro del mismo paso sin perder los datos anteriores.
• Informes imprimibles: informes de orden completa, trazabilidad de lotes, desviaciones y resúmenes por periodo, listos para auditoría.
• Integración con Claude Desktop: conexión opcional con el asistente de inteligencia artificial de Anthropic para consultar órdenes, buscar lotes y generar informes en lenguaje natural.

1.2. Características principales

1.3. Requisitos técnicos

• Servidor: PC con Windows 10/11. OFControl se instala como un servicio en este PC.
• Clientes: cualquier dispositivo con navegador web moderno (Chrome, Edge, Firefox, Safari) conectado a la misma red local.
• Tablet: cualquier tablet (Android, iPad, Windows) con navegador web. No requiere instalación de app.
• Puerto: 5006 (configurable). El servidor MCP para Claude Desktop usa el puerto 5106.

2. Acceso a la aplicación

2.1. Acceso desde el navegador

OFControl es una aplicación web. Una vez instalada en el PC servidor, todos los usuarios de la red local acceden a través del navegador:

• Desde el mismo PC: http://localhost:5006
• Desde otro dispositivo de la red: http://IP_DEL_SERVIDOR:5006 (ejemplo: http://192.168.1.50:5006)

2.2. Pantalla de inicio de sesión

Al acceder a la aplicación se muestra la pantalla de login. Introduce la contraseña de administrador para acceder al panel de gestión:

• Contraseña por defecto: admin123

Esta contraseña se puede cambiar desde Configuración → Empresa.

2.3. Acceso a la tablet

La interfaz tablet no requiere la contraseña de administrador. Los operarios acceden directamente a:

• http://IP_DEL_SERVIDOR:5006/tablet

Cada operario se identifica con su PIN de 4 dígitos, configurado previamente en Configuración → Operarios.

En la barra lateral (sidebar) de la aplicación de escritorio encontrarás un código QR que enlaza directamente a la URL de la tablet. Escanea este QR desde la tablet para acceder sin tener que escribir la dirección manualmente.

2.4. Estructura de la aplicación

La aplicación se divide en dos interfaces:

3. Panel de control (Dashboard)

El Dashboard es la pantalla principal de OFControl. Muestra un resumen visual del estado de la producción en tiempo real. Se accede automáticamente tras iniciar sesión o pulsando Dashboard en la barra lateral.

3.1. Indicadores principales (KPIs)

En la parte superior del Dashboard se muestran los contadores clave:

3.2. Lista de órdenes activas

Debajo de los KPIs se muestra la lista de órdenes de fabricación activas, con la siguiente información para cada una:

• Número de pedido y número de OF
• Estructura asignada
• Estado actual (abierta, en progreso, completada)
• Barra de progreso visual con las fases completadas
• Fecha de creación

3.3. Modal detalle de orden

Al pulsar el botón «Ver» en cualquier orden del Dashboard, se abre un modal con el detalle completo de la orden sin necesidad de navegar a otra página. El modal incluye:

• Cabecera: datos del pedido (número de pedido, OF, cliente, artículo, estructura)
• Barra de flujo visual: muestra el progreso a través de las fases de la estructura con iconos de estado (pendiente, en progreso, completado)
• Procesos desplegables: cada proceso se puede expandir para ver todos los valores registrados por los operarios, incluyendo fechas, operario, máquina utilizada y cada campo rellenado

3.4. Filtros y búsqueda

El Dashboard permite filtrar las órdenes por estado y buscar por número de pedido, OF o cliente. Los filtros se aplican en tiempo real.

4. Órdenes de fabricación

Las órdenes de fabricación son el elemento central de OFControl. Cada orden representa la fabricación de un producto o lote, y contiene todos los datos de trazabilidad: materias primas, controles de proceso, operarios, máquinas y tiempos.

4.1. Conceptos clave

Antes de crear órdenes, es importante entender la relación entre los elementos principales:

4.2. Crear una orden de fabricación

Para crear una nueva orden desde el panel de escritorio:

1. Ve a Órdenes de fabricación en la barra lateral.
2. Pulsa el botón «+ Nueva orden».
3. Rellena los campos obligatorios:
   • Nº Pedido: número del pedido del cliente (puede repetirse en varias OF).
   • Nº OF: número único de la orden. Si la auto-numeración está activada (Configuración → Empresa), este campo se rellena automáticamente con el siguiente número disponible.
   • Estructura: selecciona la estructura de fabricación que determina qué fases seguirá el producto.
4. Rellena los campos configurables del pedido (los que hayas definido en Configuración → Campos del pedido): cliente, código de artículo, cantidades, etc.
5. Pulsa «Crear orden».

Al crear la orden, el sistema genera automáticamente un paso (step) por cada proceso de la estructura seleccionada, todos en estado Pendiente.

4.3. Auto-numeración de OF

Si activas la auto-numeración en Configuración → Empresa, cada nueva orden recibirá automáticamente el siguiente número de OF. Puedes configurar:

• Prefijo: texto que precede al número (ejemplo: OF-).
• Próximo número: el siguiente número a asignar.
• Dígitos: número de dígitos del número (con ceros a la izquierda). Ejemplo: 4 dígitos = OF-0001.

La vista previa del siguiente número se muestra en tiempo real al modificar la configuración.

4.4. Estados de una orden

4.5. Ver detalle de una orden

Desde la lista de órdenes, puedes ver el detalle completo de cada orden. El detalle incluye:

• Datos generales del pedido y la OF
• Campos personalizados del pedido (cliente, artículo, cantidades...)
• Flujo de procesos con barra visual de progreso
• Para cada proceso: estado, operario, máquina, hora de inicio y fin, y todos los valores de los campos registrados
• En procesos iterativos: cada iteración con sus registros
• Incidencias asociadas a la orden

4.6. Flujo de procesos

Cada orden sigue una secuencia de procesos definida por su estructura. El flujo se muestra visualmente como una barra horizontal con cada fase:

• Pendiente: la fase aún no ha sido iniciada.
• En progreso: un operario ha abierto la fase en la tablet y está rellenando los campos.
• Completada: todos los campos obligatorios han sido rellenados y el operario ha confirmado la finalización de la fase.
• Omitida: fase no obligatoria que ha sido saltada (solo para pasos marcados como no obligatorios en la estructura).

5. Tablet — Interfaz para operarios

La tablet es la interfaz principal para los operarios de planta. Está diseñada para su uso táctil con botones grandes, campos amplios y un flujo paso a paso. Los operarios no necesitan conocer la contraseña de administrador: se identifican con su PIN personal.

5.1. Acceso a la tablet

1. Abre el navegador en la tablet y ve a http://IP_DEL_SERVIDOR:5006/tablet.
2. Alternativamente, escanea el código QR disponible en la barra lateral de la aplicación de escritorio.

5.2. Identificación del operario

La pantalla inicial de la tablet muestra la lista de operarios activos. El flujo es:

1. Seleccionar operario: pulsa sobre tu nombre en la lista.
2. Introducir PIN: se muestra un teclado numérico de 4 dígitos. Introduce tu PIN personal (configurado por el administrador en Configuración → Operarios).
3. Acceso al panel: tras validar el PIN, accedes al panel de órdenes activas.

5.3. Panel de órdenes

Tras identificarse, el operario ve la lista de órdenes de fabricación activas (abiertas y en progreso). Para cada orden se muestra:

• Número de pedido y número de OF
• Estructura asignada
• Estado y progreso visual
• Cliente (si está configurado como campo del pedido)

El operario puede:

• Seleccionar una orden existente para rellenar sus procesos.
• Crear una nueva orden directamente desde la tablet (botón «+ Nueva orden»), rellenando los mismos campos que desde el escritorio.

5.4. Crear orden desde la tablet

Al pulsar «+ Nueva orden» en la tablet, se muestra un formulario con:

• Nº Pedido (obligatorio)
• Nº Orden de Fabricación (obligatorio; si la auto-numeración está activada, se rellena automáticamente con la etiqueta «Auto»)
• Estructura (desplegable con las estructuras disponibles)
• Los campos configurables del pedido (cliente, código artículo, cantidades...)

5.5. Flujo de trabajo: rellenar procesos

Al seleccionar una orden, el operario ve la lista de fases (procesos) de la estructura:

1. Seleccionar fase: pulsa sobre la fase que vas a rellenar. Las fases completadas se muestran en verde; las pendientes, en gris.
2. Rellenar campos: se abre un modal con todos los campos configurados para ese proceso. Según el tipo de campo:
   • Texto: campo libre de escritura.
   • Número: campo numérico con validación de rango (si está configurado).
   • Desplegable (catálogo): selección de un valor del catálogo asociado (colores, materiales, chocolates...).
   • Booleano (check): casilla de verificación para confirmaciones (verificaciones, comprobaciones).
   • Temperatura: campo numérico con unidad °C y rango de validación. Algunos rangos pueden ser dinámicos (depender de un valor seleccionado en otro proceso).
   • Máquina (activo TrazIA): desplegable con las máquinas de la base maestra de activos.
3. Controles de intervalo: algunos campos se muestran agrupados en una tabla compacta por unidades producidas (ejemplo: centrado y serigrafiado a 250, 750, 1000 y 5000 unidades). El operario marca los checks en cada intervalo.
4. Guardar: el operario puede:
   • «Guardar sin completar»: guarda los datos introducidos hasta el momento pero no cierra la fase. Se puede volver a editar.
   • «Completar fase»: marca la fase como completada. Los campos obligatorios deben estar rellenados.

5.6. Auto-guardado

OFControl incluye auto-guardado automático para evitar la pérdida de datos:

• Cualquier cambio en un campo programa un guardado silencioso a los 1,5 segundos.
• Al cerrar el modal de un proceso (botón X), los datos se guardan automáticamente antes de cerrar.
• No es posible cerrar el modal accidentalmente pulsando fuera de él (protección contra cierre accidental).
• Los datos guardados automáticamente se marcan como borrador y se pre-cargan al volver a abrir la fase, con una etiqueta naranja «(borrador auto-guardado)».

5.7. Incidencias desde la tablet

Dentro de cada proceso, el operario tiene acceso a un botón rojo «Incidencia» que permite reportar un problema:

• Se pide al operario si la incidencia es de máquina o de calidad.
• Si es de máquina, la incidencia se envía automáticamente a MaintenControl (si está instalado en el mismo servidor) para que el equipo de mantenimiento la gestione.
• Si es de calidad, se registra en OFControl vinculada a la orden y al proceso actual.

5.8. Temperatura dinámica

Algunos campos de temperatura tienen rangos dinámicos que dependen de valores introducidos en otros procesos de la misma orden. Por ejemplo, la temperatura del túnel de enfriamiento puede variar según el tipo de chocolate seleccionado en la fase de dosificado:

• Sucedáneo blanco: rango 17-18 °C
• Resto de chocolates: rango 17-22 °C

El sistema lee automáticamente el valor seleccionado en el proceso anterior y ajusta el rango. Si el chocolate aún no ha sido seleccionado, se muestra un aviso al operario.

6. Procesos iterativos y multi-registro

OFControl permite configurar procesos con dos modos avanzados de registro: iterativo y multi-registro. Estos modos se pueden usar por separado o combinarse en un mismo proceso.

6.1. Proceso iterativo

Un proceso iterativo repite automáticamente todos sus campos un número de veces determinado por un dato del pedido. Esto es útil cuando un mismo proceso se ejecuta varias veces con datos diferentes.

Ejemplo práctico

El proceso de Serigrafiado se repite una vez por cada color. Si el pedido indica 4 colores, el sistema genera automáticamente 4 bloques idénticos de campos (uno por color), cada uno con su propia selección de color, lote de pintura, controles de centrado, mermas, etc.

Configuración

Para configurar un proceso como iterativo (desde Configuración → Procesos):

• Activar «Proceso con repeticiones»: marca la casilla que indica «Los campos se repiten según un dato del pedido, ej: 1 bloque por cada color».
• Campo del pedido: selecciona qué campo del pedido determina el número de repeticiones (ejemplo: «Número de colores»).
• Etiqueta: nombre que recibe cada iteración (ejemplo: «Color»). Se mostrará como «Color 1», «Color 2», etc.

6.2. Multi-registro

El modo multi-registro permite añadir múltiples registros dentro de un mismo paso, sin sobrescribir los datos anteriores. Esto es útil cuando un mismo proceso se ejecuta en días diferentes o con cambios de lote de materia prima.

Ejemplo práctico

El proceso de Dosificado puede ejecutarse durante 3 días consecutivos, con cambio de lote de chocolate cada día. El operario crea un nuevo registro cada vez, y los registros anteriores se conservan en verde (solo lectura). El nuevo registro se muestra en azul (editable).

Configuración

Para activar el multi-registro (desde Configuración → Procesos):

• Marca la casilla «Permite múltiples registros (cambios de lote, días diferentes)».

6.3. Modo combinado: iterativo + multi-registro

Cuando un proceso tiene ambas opciones activadas y el número de iteraciones es mayor que 1, se activa el modo combinado. Este modo implementa un sistema de 3 niveles de guardado que ofrece el máximo control sobre el registro de datos.

Nivel 1: Guardar registro (Cambio de lote)

Dentro de cada iteración, el operario puede crear múltiples registros:

• El botón «Cambio de lote» (naranja) cierra el registro actual y abre uno nuevo.
• Los campos de lote (todos los campos cuyo código empieza por LOT_) se vacían automáticamente para que el operario introduzca el nuevo lote. Los campos vacíos se destacan con borde naranja y la etiqueta «Revisa el lote».
• El resto de campos se copian del registro anterior (para no tener que reintroducirlos).
• Los registros anteriores se muestran en verde (solo lectura).
• Se pide confirmación antes del cambio de lote: «Se cerrará el registro actual. Asegúrate de que todos los campos están completos.»

Nivel 2: Finalizar iteración

Una vez que todos los registros de una iteración están completos:

• El botón «Finalizar [nombre iteración]» (verde) cierra la iteración.
• Se requiere al menos 1 registro consolidado (no borrador) para finalizar.
• Una vez finalizada, la iteración se muestra en verde y solo lectura.
• Se puede reabrir una iteración finalizada si es necesario hacer correcciones.

Nivel 3: Completar fase

Cuando todas las iteraciones han sido finalizadas:

• El botón «Completar fase» se habilita en el footer del modal.
• Al completar la fase, el proceso entero se marca como completado y se avanza a la siguiente fase de la estructura.
• Si alguna iteración no está finalizada, el botón permanece deshabilitado con un mensaje indicando qué iteraciones faltan.

6.4. Estructura de datos del modo combinado

Internamente, los datos del modo combinado se almacenan como:

• _iter_records: diccionario con una lista de registros por cada iteración ({"1": [{...reg1...}, {...reg2...}], "2": [...]}).
• _iter_finalized: diccionario con el estado de finalización de cada iteración ({"1": true, "2": false}).
• _draft: marcador de registros temporales que no aparecen en informes.

6.5. Convención de campos de lote

7. Incidencias

El módulo de incidencias permite registrar, seguir y resolver cualquier problema detectado durante la fabricación. Las incidencias pueden crearse manualmente o generarse automáticamente cuando un valor está fuera de rango.

7.1. Tipos de incidencia

7.2. Niveles de gravedad

7.3. Incidencias automáticas

OFControl genera incidencias automáticamente cuando un operario introduce un valor fuera de los rangos configurados. Por ejemplo:

• Si el campo «Temperatura túnel» tiene un rango configurado de 17-22 °C y el operario introduce 25 °C, el sistema crea automáticamente una incidencia de tipo temperatura con gravedad moderada.
• La incidencia incluye automáticamente: el número de orden, el proceso, el campo afectado, el valor introducido y el rango esperado.
• La incidencia se vincula a la orden y al proceso donde se ha producido la desviación.

7.4. Crear incidencia manual

Las incidencias se pueden crear de tres formas:

1. Desde la tablet: dentro de cualquier proceso, el operario pulsa el botón rojo «Incidencia». Se le pregunta si es de máquina o de calidad y se le solicita una descripción.
2. Desde el panel de escritorio: en la sección Incidencias del sidebar, pulsa «+ Nueva incidencia» y rellena el formulario completo con orden, proceso, tipo, gravedad y descripción.
3. Automáticamente: al introducir un valor fuera de rango en la tablet (ver sección anterior).

7.5. Gestión de incidencias

La página de Incidencias en el sidebar muestra:

• Contadores: número de incidencias por estado (abiertas, en progreso, cerradas).
• Filtros: por estado, tipo, gravedad y orden.
• Buscador: búsqueda por descripción o número de orden.
• Lista: cada incidencia muestra tipo, gravedad, orden, proceso, descripción, fecha y estado.

7.6. Estados de una incidencia

7.7. Cerrar una incidencia

Para cerrar una incidencia es obligatorio documentar la acción correctiva tomada:

1. Abre la incidencia desde la lista.
2. Rellena el campo «Acción correctiva / Notas de resolución».
3. Selecciona el operario que resuelve la incidencia.
4. Pulsa «Cerrar incidencia».

El sistema registra automáticamente la fecha y hora de cierre.

7.8. Integración con MaintenControl

Las incidencias de tipo máquina se envían automáticamente a MaintenControl (si está instalado en el mismo servidor). El sistema lee el fichero ports.json para detectar automáticamente el puerto de MaintenControl y crear la incidencia en su sistema, donde el equipo de mantenimiento la gestionará.

8. Informes

OFControl ofrece 4 tipos de informes diseñados para cubrir las necesidades de trazabilidad, control de calidad y auditoría. Todos los informes son imprimibles y exportables.

8.1. Informe de OF completa

Genera un informe detallado de una orden de fabricación específica con toda su trazabilidad.

Cómo generar el informe

1. Ve a Informes en la barra lateral.
2. Selecciona la pestaña «OF Completa».
3. Busca la orden por número de pedido, número de OF o cliente.
4. Pulsa «Generar informe».

Contenido del informe

• Cabecera: datos de la empresa (nombre, código documento, revisión), datos del pedido y la OF.
• Campos del pedido: todos los datos personalizados (cliente, artículo, cantidades...).
• Detalle por proceso: para cada fase de la estructura:
  • Estado, operario (con código), máquina utilizada.
  • Hora de inicio y finalización, duración calculada.
  • Todos los valores de los campos registrados.
  • En procesos iterativos: cada iteración con sus registros.
  • En multi-registro: todos los registros numerados.
• Incidencias: listado de incidencias vinculadas a la orden.
• Firma: espacio para firma del responsable.

8.2. Informe de trazabilidad de lotes

Permite buscar cualquier lote de materia prima y obtener la lista de todas las órdenes de fabricación donde se ha utilizado.

Cómo usarlo

1. Ve a Informes → pestaña «Trazabilidad de lotes».
2. Introduce el número de lote a buscar (ejemplo: LOT-CHO-2026-015).
3. Pulsa «Buscar».

Resultado

El sistema busca el texto del lote en todos los campos de todas las órdenes y devuelve una lista con:

• Número de pedido y OF donde aparece el lote.
• Proceso y campo donde se ha registrado.
• Fecha de registro.
• Operario que lo registró.

8.3. Informe de desviaciones

Muestra todos los valores que han quedado fuera de los rangos configurados durante un periodo determinado.

Cómo usarlo

1. Ve a Informes → pestaña «Desviaciones».
2. Selecciona el periodo (fecha inicio y fecha fin).
3. Pulsa «Generar».

Resultado

Tabla con todas las desviaciones detectadas, incluyendo:

8.4. Informe resumen por periodo

Ofrece una visión general de la actividad productiva en un rango de fechas.

Cómo usarlo

1. Ve a Informes → pestaña «Resumen periodo».
2. Selecciona el periodo (fecha inicio y fecha fin).
3. Pulsa «Generar».

Contenido

• Contadores generales: órdenes creadas, completadas, canceladas, incidencias abiertas/cerradas.
• Barra de progreso por OF: progreso visual de cada orden activa durante el periodo.
• Tabla completa: listado de todas las órdenes del periodo con su estado, estructura, fechas y progreso.

9. Configuración

La configuración de OFControl se organiza en pestañas accesibles desde Configuración en la barra lateral. Es fundamental completar la configuración antes de empezar a crear órdenes de fabricación.

9.1. Empresa

Datos generales de la empresa que aparecen en los informes y cabeceras de documentos:

• Nombre de la empresa: aparece en los informes impresos.
• Código de documento: referencia del sistema documental (ejemplo: OF-REG-01).
• Revisión: número de revisión del documento (ejemplo: Rev.1).
• Fecha: fecha de vigencia del documento.
• Idioma: idioma de la interfaz (Español, Catalán, Inglés).
• Contraseña de administrador: contraseña de acceso al panel de escritorio.

Auto-numeración de OF

En esta misma pestaña se configura la auto-numeración de órdenes de fabricación:

• Activar/desactivar: casilla «Generar nº OF automáticamente».
• Prefijo: texto que precede al número (ejemplo: OF-).
• Próximo número: el siguiente número que se asignará.
• Dígitos: longitud del número con ceros a la izquierda (ejemplo: 4 dígitos = OF-0001).
• Vista previa: muestra en tiempo real cómo quedará el siguiente número de OF.

9.2. Operarios

Gestión de las personas que usarán la aplicación. CRUD completo con los siguientes campos:

Roles disponibles

9.3. Procesos

Los procesos son las fases individuales de fabricación. Cada proceso tiene un código único, un nombre y una lista de campos configurables que los operarios deben rellenar.

Crear un proceso

1. Ve a Configuración → Procesos.
2. Pulsa «+ Nuevo proceso».
3. Rellena: código (único, ejemplo: SER), nombre (ejemplo: «Serigrafiado»), descripción y código de control (referencia documental).
4. Guarda el proceso.

Opciones del proceso

• Proceso con repeticiones (iterativo): los campos se repiten según un dato del pedido (ver sección 6.1).
• Permite múltiples registros (multi-registro): permite añadir registros sucesivos (ver sección 6.2).

Campos del proceso

Dentro de cada proceso se configuran los campos que los operarios deben rellenar. Para gestionar los campos:

1. Pulsa sobre un proceso en la lista.
2. En el modal de detalle, ve a la sección «Campos».
3. Pulsa «+ Añadir campo».
4. Configura el campo:

Los campos se pueden editar, reordenar (flechas arriba/abajo) y eliminar (con confirmación) desde el modal de detalle del proceso.

Acciones sobre procesos

• Ver: modal solo lectura con toda la información del proceso y sus campos.
• Editar: modificar nombre, descripción, opciones iterativo/multi-registro.
• Eliminar: desactivación lógica (soft delete) con confirmación. El proceso desaparece de la lista pero se conserva en la base de datos para mantener la trazabilidad de las órdenes existentes.

9.4. Estructuras

Las estructuras definen la secuencia de procesos que sigue un tipo de producto. Cada estructura es una lista ordenada de procesos.

Crear una estructura

1. Ve a Configuración → Estructuras.
2. Pulsa «+ Nueva estructura».
3. Rellena: código (único), nombre y descripción.
4. Añade los procesos en orden:
   • Selecciona cada proceso del desplegable y pulsa «Añadir».
   • Los procesos se muestran en el orden en que se añaden.
   • Puedes reordenar los procesos arrastrando o con los botones de flecha.
   • Marca cada paso como obligatorio u opcional.
5. Guarda la estructura.

Ejemplo

Estructura «Chocolate con lámina serigrafiada» (código: CHOC-SER):

Gestión de estructuras

• Las estructuras se pueden editar (añadir/quitar procesos, reordenar, cambiar obligatoriedad).
• Las estructuras se pueden eliminar (soft delete) si no tienen órdenes activas vinculadas.
• Al crear una orden, se selecciona la estructura del desplegable y el sistema genera automáticamente un paso por cada proceso de la estructura.

9.5. Catálogos

Los catálogos son listas de valores reutilizables que se usan como desplegables en los campos de procesos y en los campos del pedido. Cada empresa crea los catálogos que necesite.

Ejemplos de catálogos

Crear un catálogo

1. Ve a Configuración → Catálogos.
2. Pulsa «+ Nuevo catálogo».
3. Rellena: código (único), nombre y descripción.
4. Opcionalmente, define columnas adicionales para los items del catálogo (por defecto: código + nombre).
5. Guarda el catálogo.

Gestionar items

Dentro de cada catálogo puedes:

• Añadir items: introduce los valores uno a uno con el formulario.
• Editar items: pulsa el icono de lápiz junto a cada item para modificar sus valores.
• Eliminar items: con confirmación.
• Ordenar: los items se ordenan automáticamente por el primer campo (código).

Importar y exportar

• Importar CSV/Excel: selecciona un archivo CSV (separador ; o ,) o Excel. El sistema detecta automáticamente el separador, salta la cabecera e importa los items.
• Exportar CSV: descarga los items del catálogo como archivo CSV separado por ; con codificación UTF-8 (BOM).

Valores pendientes

Si un operario introduce un valor de texto libre en un campo vinculado a un catálogo y ese valor no existe en el catálogo, el sistema lo registra como valor pendiente. Los valores pendientes se pueden revisar y añadir al catálogo desde Configuración → Catálogos.

9.6. Campos del pedido

Los campos del pedido son datos adicionales que se solicitan al crear una orden de fabricación. Además de los campos fijos (número de pedido, número de OF, estructura), puedes configurar campos personalizados.

Crear un campo del pedido

1. Ve a Configuración → Campos del pedido.
2. Pulsa «+ Nuevo campo».
3. Configura:
   • Nombre: etiqueta visible en el formulario (ejemplo: «Cliente»).
   • Código: identificador interno (ejemplo: CLI).
   • Tipo: texto, número, desplegable de catálogo, fecha, booleano.
   • Catálogo: si el tipo es desplegable, selecciona el catálogo de valores.
   • Obligatorio: si el campo es obligatorio al crear la orden.

Campos fijos vs. configurables

La pestaña de campos del pedido muestra primero los campos fijos (Nº Pedido, Nº OF, Estructura) que no se pueden modificar ni eliminar, seguidos de los campos configurables que puedes crear, editar, reordenar y eliminar libremente.

Reordenar campos

Los campos configurables se pueden reordenar con los botones de flecha o arrastrando. El orden determina la posición en el formulario de creación de orden (tanto en escritorio como en tablet).

10. Activos TrazIA

OFControl comparte la base maestra de activos con las demás aplicaciones del ecosistema TrazIA (MaintenControl, CleanControl, ChecklistControl, VisitControl). Esta base maestra centraliza todos los equipos, máquinas e instalaciones de la empresa en un único catálogo compartido.

10.1. Ubicación de la base maestra

• Base de datos: C:\ProgramData\TrazIA\trazia_assets.db
• Código: C:\ProgramData\TrazIA\trazia_assets.py

Todas las aplicaciones TrazIA leen y escriben en esta misma base de datos, garantizando que los activos estén siempre sincronizados.

10.2. Acceso desde OFControl

La página Activos TrazIA está disponible en la barra lateral (al final). Ofrece un CRUD completo:

• Ver activos: lista con búsqueda y filtros por categoría. Las categorías se muestran como chips compactos en línea.
• Crear activo: añadir un nuevo equipo a la base maestra con código numérico único auto-generado.
• Editar activo: modificar nombre, descripción, categoría, ubicación...
• Eliminar activo: desactivación lógica (el activo desaparece de las listas pero se conserva en la BD).
• Gestionar categorías: crear y renombrar categorías de activos.

10.3. Uso en procesos

Los activos de la base maestra se pueden usar como desplegables en los campos de los procesos. Al configurar un campo de tipo «machine» (máquina), el operario verá un desplegable con las máquinas disponibles en la base maestra. Esto permite registrar qué máquina se ha utilizado en cada fase de fabricación, garantizando la trazabilidad del equipo.

11. Claude Desktop (MCP)

OFControl se puede conectar con Claude Desktop, el asistente de inteligencia artificial de Anthropic. Mediante el protocolo MCP (Model Context Protocol), Claude Desktop puede consultar las órdenes de fabricación, buscar lotes, ver incidencias y ayudar en la configuración inicial, todo en lenguaje natural.

11.1. ¿Qué es Claude Desktop?

Claude Desktop es una aplicación de escritorio de Anthropic que permite interactuar con la IA Claude. Mediante el protocolo MCP, Claude Desktop puede conectarse a herramientas externas (como OFControl) y acceder a sus datos directamente, sin necesidad de copiar y pegar información.

11.2. Requisitos

• Claude Desktop instalado en el PC (descarga gratuita desde claude.ai/download).
• Python 3.8 o superior instalado en el PC (necesario para el bridge MCP).
• Un operario con email registrado en OFControl (Configuración → Operarios). El email es el identificador que Claude Desktop usa para autenticarse.

11.3. Puerto MCP

OFControl utiliza el puerto 5106 para el servidor MCP SSE (puerto de la aplicación 5006 + 100, siguiendo la convención TrazIA). Este servidor se arranca automáticamente junto con la aplicación.

11.4. Configuración inicial

La configuración de Claude Desktop con OFControl se realiza desde la pantalla de Licencia de la aplicación:

Para el usuario del PC servidor (local)

1. Ve a la pantalla de Licencia en OFControl.
2. Pulsa el botón «Conectar con Claude Desktop».
3. El sistema configura automáticamente el archivo claude_desktop_config.json con la conexión a OFControl.
4. Reinicia Claude Desktop.

Para usuarios remotos (otros PCs de la red)

1. En la pantalla de Licencia, sección «Claude Desktop para otros usuarios», descarga el archivo instalar_trazia_mcp.bat.
2. Copia el archivo .bat al PC del usuario remoto.
3. El usuario hace doble clic en el .bat. El script instala automáticamente un bridge Python que conecta Claude Desktop con OFControl a través de la red.
4. Reinicia Claude Desktop en el PC remoto.

11.5. Configuración inicial con Claude Desktop — Paso a paso

Paso 1 — Iniciar la configuración

Abre Claude Desktop y escribe:

Paso 2 — Dar de alta los operarios

Paso 3 — Crear los catálogos

Paso 4 — Definir los procesos de fabricación

Paso 5 — Crear las estructuras

11.6. Operativa diaria con Claude Desktop

Una vez configurada la aplicación, puedes preguntarle a Claude Desktop en cualquier momento:

Consultas de producción

• “¿Qué órdenes de fabricación están en curso?”
• “¿En qué fase está la orden OF-0015?”
• “¿Cuántas órdenes se han completado esta semana?”
• “Dame el detalle completo de la orden del pedido BC26/148.”

Trazabilidad

• “Busca en qué órdenes se ha usado el lote de pintura LOT-2026-015.”
• “¿Qué lotes de chocolate se han usado este mes?”

Incidencias y calidad

• “¿Hay incidencias abiertas?”
• “Cierra la incidencia 5 con la nota: corregido el ajuste de temperatura.”
• “¿Hay desviaciones de valores este mes?”

Gestión

• “Da de alta un operario nuevo llamado Pere, código PE-10, rol operario.”
• “Crea un nuevo catálogo de Presentaciones.”
• “Copia los operarios de MaintenControl.”
• “¿Cómo está configurada la aplicación ahora?”

11.7. Herramientas disponibles

Una vez configurado, Claude Desktop tiene acceso a las siguientes herramientas de OFControl:

11.6. Ejemplos de uso

Una vez conectado, puedes escribir en Claude Desktop frases como:

• «¿Qué órdenes de fabricación están en curso?»
• «¿En qué fase está la orden OF-0015?»
• «¿Hay incidencias abiertas?»
• «Busca en qué órdenes se ha usado el lote LOT-CHO-2026-015»
• «¿Cuántas órdenes se han completado esta semana?»
• «Ayúdame a configurar la aplicación desde cero»
• «Da de alta un operario nuevo llamado Pere, código PE-10, rol operario»
• «Cierra la incidencia 5 con la nota: corregido el ajuste de temperatura»

11.7. Registro de puertos

Al arrancar, OFControl registra sus puertos en el fichero compartido C:\ProgramData\TrazIA\ports.json:

{
  "OFControl": {
    "port": 5006,
    "mcp_port": 5106
  }
}

Este fichero permite a las demás aplicaciones TrazIA detectar automáticamente qué apps están instaladas y en qué puertos. El instalador remoto de Claude Desktop lee este fichero para configurar automáticamente todas las apps TrazIA disponibles.

12. Copias de seguridad

OFControl realiza copias de seguridad automáticas de la base de datos para proteger la información ante cualquier eventualidad.

12.1. Copias automáticas

El sistema genera una copia de seguridad automática después de cada operación de escritura (crear, modificar o eliminar datos). Las características de las copias automáticas son:

• Frecuencia: se genera una copia por semana (fecha en formato YYYY_WNN, donde NN es el número de semana).
• Ubicación: C:\BackupOF\ (en Windows).
• Formato: archivo SQLite con nombre ofcontrol_YYYY_WNN.db.

12.2. Base de datos principal

La base de datos principal de OFControl se encuentra en:

• C:\ProgramData\TrazIA\OFControl\ofcontrol.db

Este archivo contiene todos los datos de la aplicación: órdenes, procesos, configuración, operarios, incidencias, etc.

12.3. Archivos de configuración

Además de la base de datos, OFControl usa un archivo de configuración:

• C:\ProgramData\TrazIA\OFControl\config.json — configuración de la empresa, idioma, auto-numeración, etc.
• C:\ProgramData\TrazIA\OFControl\logos\ — logos de la empresa.

12.4. Restaurar una copia

Para restaurar una copia de seguridad:

1. Detener la aplicación (cerrar OFControl desde la bandeja del sistema).
2. Navegar a la carpeta de copias (C:\BackupOF\).
3. Copiar el archivo de backup deseado y renombrarlo como ofcontrol.db.
4. Reemplazar el archivo original en C:\ProgramData\TrazIA\OFControl\ofcontrol.db.
5. Reiniciar la aplicación.

12.5. Recomendaciones

• Copias externas: Además de las copias automáticas locales, se recomienda realizar copias periódicas en un disco externo, unidad de red o servicio en la nube.
• Verificación: Comprueba periódicamente que las copias se están generando correctamente revisando la carpeta C:\BackupOF\.
• Antes de actualizar: Antes de instalar una nueva versión de OFControl, realiza siempre una copia manual de ofcontrol.db y config.json.

Control Digital de Órdenes de Fabricación

© 2026 TrazIA. Todos los derechos reservados.