Sprint‐0‐Proyecto‐2 - Svillamizar05/Polygon-Wiki GitHub Wiki
Sumicolor es una empresa reconocida por la fabricación de MASTERBATCH (concentrados de color) para la industria plástica. Cuenta con una amplia experiencia en el desarrollo de colores estándar, especiales y de efectos, trabajando con diferentes polímeros base y materiales de ingeniería. Entre los materiales que procesa se encuentran polietileno (PE), polipropileno (PP), poliestireno (PS), PET, EVA, poliamidas (PA), ABS y POM, entre otros. Sus productos están dirigidos a diversos procesos de transformación de termoplásticos, como inyección, soplado, extrusión y rotomoldeo.
Actualmente, Sumicolor realiza el seguimiento de sus órdenes de producción mediante hojas físicas que acompañan cada lote durante todo el proceso de fabricación. Estas hojas contienen la información y las actividades que deben ejecutar los diferentes operarios en cada etapa del proceso productivo.
Al tratarse de documentación en papel, las hojas deben ser trasladadas manualmente de un operador a otro, lo que dificulta el flujo de información, aumenta el riesgo de pérdida o deterioro de los documentos y retrasa la consulta del estado de una orden de producción. Además, este método representa una carga administrativa adicional, ya que la información debe revisarse y organizarse manualmente, limitando la trazabilidad y el control oportuno de los procesos.
Como solución a esta problemática, se propone el desarrollo de un gestor de procesos de producción, cuyo objetivo principal será digitalizar las hojas de seguimiento de las órdenes de producción y centralizar toda la información en una única plataforma.
El sistema estará diseñado para funcionar tanto en tabletas como en computadores, permitiendo que cada operario registre el avance de las actividades correspondientes a su proceso de forma rápida y sencilla. Asimismo, el software contará con una interfaz intuitiva y fácil de utilizar, adaptada a las necesidades de los trabajadores de planta, minimizando la curva de aprendizaje y facilitando su adopción.
Con la implementación de esta solución se espera mejorar la trazabilidad de las órdenes de producción, optimizar el flujo de información entre las diferentes áreas, reducir el uso de papel, disminuir los errores asociados al manejo manual de documentos y proporcionar a la administración un seguimiento en tiempo real del estado de cada proceso productivo.
| Integrante | Foto | Correo | Rol |
|---|---|---|---|
| Simón Castro Valencia | [email protected] | Scrum master-tester | |
| Samuel Herrera Galvis | [email protected] | Desarrollador | |
| Michael Andrey Agudelo Ortiz | [email protected] | Arquitecto | |
| Santiago Villamizar | [email protected] | Desarrollador | |
| Alejandro Jaramillo Rodríguez | [email protected] | UX |
El sistema Software Polygon tiene como objetivo digitalizar el proceso de producción de Sumicolor, reemplazando los formatos físicos por registros electrónicos realizados desde computadores y tabletas ubicados en cada una de las bases de producción. Cada orden de producción (OP) avanza de manera secuencial entre las diferentes etapas del proceso. El sistema valida que la información requerida en una base haya sido diligenciada completamente antes de permitir que la orden continúe hacia la siguiente etapa, garantizando la trazabilidad y evitando omisiones de información.
El administrador es el usuario encargado de la configuración y mantenimiento del sistema. Sus principales funciones son:
-
Crear, modificar o desactivar módulos (bases de producción).
-
Agregar, editar o eliminar campos de los formularios de cada módulo cuando sea necesario.
-
Configurar parámetros generales del sistema.
-
Supervisar el correcto funcionamiento de la plataforma.
El administrador no participa directamente en el proceso productivo, sino que garantiza que el sistema se adapte a las necesidades de la empresa.
El proceso inicia en el módulo de Planeación.
El personal de planeación registra la información inicial de la Orden de Producción, como:
-
Número de orden.
-
Producto a fabricar.
-
Cantidad solicitada.
-
Materia prima requerida.
-
Observaciones.
-
Información necesaria para iniciar la fabricación.
Una vez todos los campos obligatorios estén diligenciados, el sistema habilita automáticamente el siguiente módulo (Picky).
El personal encargado del área de Picky consulta las órdenes pendientes y registra la preparación o entrega de las materias primas necesarias para la producción.
Después de completar la información requerida, el sistema permite que la orden avance al módulo de Pesaje.
El operario de pesaje registra la información correspondiente al pesaje de las materias primas utilizadas para la orden de producción.
Mientras la información obligatoria no esté completa, el sistema no permitirá avanzar la orden hacia la siguiente etapa.
Al finalizar correctamente el registro, la orden pasa al módulo de Mezcla.
El operario de mezcla consulta la orden y registra la información correspondiente al proceso de mezclado de materiales.
Una vez finalizado el registro y validados los datos, el sistema habilita el módulo de extrusión.
El personal de extrusión registra la información del proceso de extrusión del material.
El sistema verifica que todos los datos requeridos hayan sido diligenciados antes de permitir el paso al área de Calidad.
El área de calidad realiza las inspecciones correspondientes y registra los resultados obtenidos durante el proceso.
Si la información está completa y cumple con las validaciones establecidas, la orden continúa hacia el módulo de Empaque.
Por otro lado, si la orden no pasa calidad, se habilitaria un subproceso donde se determina en que base fallo y dependendiendo el fallo se manda a tamizaje, saranda, homogenizado, secado o molino
El operario de empaque registra la información relacionada con el embalaje y finalización del producto.
Una vez completado el registro, la orden queda lista para ser enviada al módulo Espacio Cliente.
En este módulo se registra la información final relacionada con la entrega del producto al cliente o la finalización del proceso productivo.
Aquí puede consultarse el historial completo de la orden de producción, incluyendo todas las etapas por las que pasó y la información registrada en cada una de ellas.
Identificar las necesidades de la empresa Sumicolor para desarrollar el software Polygon, el cual busca digitalizar el proceso de producción, reemplazando los formatos físicos por registros digitales desde computadores y tabletas, mejorando la trazabilidad y el seguimiento de las órdenes de producción.
Descripción
Se realizó una entrevista con el personal de la empresa para conocer el proceso actual de producción, identificar los problemas existentes y comprender las necesidades que debe satisfacer el sistema.
Objetivo
Obtener información directamente de los responsables del proceso productivo.
Información obtenida
-
Actualmente la información se registra en hojas físicas.
-
Las órdenes de producción pasan manualmente entre las diferentes bases.
-
Se presentan dificultades para consultar información histórica.
-
No existe trazabilidad en tiempo real.
-
Se requiere un sistema que permita registrar la información desde tabletas o computadores.
-
Cada orden debe avanzar únicamente cuando la etapa anterior haya sido completada.
Descripción
Se revisaron las órdenes de producción utilizadas actualmente por la empresa para identificar la información registrada en cada etapa del proceso.
Objetivo
Determinar qué datos deberán almacenarse dentro del sistema.
Información obtenida
Se identificaron:
-
Número de orden
-
Información del lote
-
Materias primas
-
Cantidades
-
Operario responsable
-
Fechas
-
Observaciones
-
Resultados de calidad
| Participante | Rol |
|---|---|
| Equipo de Proyecto 2 | Analistas de requerimientos y encargados de recopilar la información necesaria para el desarrollo del sistema. |
| Jefe de Producción de Sumicolor | Explicó el flujo del proceso productivo, las necesidades de la empresa y los problemas del proceso actual basado en formatos físicos. |
| Ingeniero de Procesos de Sumicolor | Describió las actividades realizadas en cada base de producción, los datos que deben registrarse y los requerimientos funcionales del sistema. |
| Equipo de TI de Sumicolor | Explicó la infraestructura tecnológica actual de la empresa, los sistemas existentes (como SQL Servers, Visual Control y Excel), y brindó orientación sobre la viabilidad técnica e integración del Software Polygon con los recursos tecnológicos disponibles. |
Fecha: Viernes 24 de julio de 2026 2:30 pm*.*
Lugar: Instalaciones de SUMICOLOR S.A.
| Código | Requerimiento |
|---|---|
| RF-01 | El sistema debe permitir crear una Orden de Producción. |
| RF-02 | El sistema debe permitir registrar información desde cada base de producción. |
| RF-03 | El sistema debe impedir que una orden avance si la etapa anterior no ha sido completada. |
| RF-04 | El sistema debe permitir consultar el historial completo de una orden. |
| RF-05 | El administrador podrá crear, modificar o eliminar módulos del sistema. |
| RF-06 | El administrador podrá agregar, editar o eliminar campos dentro de cada módulo. |
| RF-07 | El sistema debe administrar usuarios y roles. |
| RF-08 | El sistema debe almacenar toda la información en una base de datos SQL Servers. |
| RF-09 | El sistema debe permitir el acceso desde tabletas y computadores. |
Durante el análisis del mercado se identificaron diferentes soluciones de tipo MES (Manufacturing Execution System) y ERP con módulos de manufactura, las cuales ofrecen funcionalidades similares a las que se implementarán en Software Polygon.
| Aplicación | Empresa | Costo | Diferencia con Software Polygon |
|---|---|---|---|
| Tulip | Tulip Interfaces Inc. | Desde USD 100 por interfaz/mes (plan Essentials, mínimo 10 interfaces). (Tulip) | Tulip es una plataforma muy completa para la digitalización industrial, pero está diseñada para múltiples industrias y suele requerir una inversión considerable. Software Polygon estará desarrollado específicamente para el proceso productivo de Sumicolor, adaptándose exactamente al flujo de Planeación → Picky → Pesaje → Mezcla → Extrusión → Calidad → Empaque → Espacio Cliente, sin funcionalidades innecesarias. |
| Odoo Manufacturing (MRP) | Odoo S.A. | Desde USD 24,90 por usuario/mes (plan Estándar). (Odoo) | Odoo es un ERP completo que incluye contabilidad, ventas, inventario, CRM y muchos otros módulos. La propuesta de Software Polygon se enfoca exclusivamente en la gestión de órdenes de producción de Sumicolor, ofreciendo una solución más sencilla, personalizada y fácil de implementar para la empresa. |
| Prodsmart | Prodsmart (Autodesk) | Precio bajo cotización; estimaciones del mercado indican aproximadamente USD 45–165 por usuario/mes, dependiendo del plan y número de usuarios. (VendorBenchmark) | Prodsmart permite controlar la producción en tiempo real y recopilar datos de planta. Sin embargo, es una solución comercial orientada a diferentes tipos de fabricantes. Software Polygon incorpora reglas específicas del proceso de Sumicolor, como impedir que una orden avance a la siguiente base hasta que la información de la etapa actual haya sido diligenciada completamente. |
https://miro.com/app/board/uXjVH1COXho=/?share_link_id=626833667391
https://github.com/users/SimonCastroV/projects/10
La solución propuesta consiste en el desarrollo de una plataforma web configurable para la gestión y digitalización de procesos productivos, capaz de adaptarse a distintos tipos de industrias mediante la definición de flujos de trabajo representados como grafos. La plataforma permitirá modelar procesos a través de etapas interconectadas, configurar formularios dinámicos para cada etapa, gestionar órdenes de trabajo, gestionar usuarios y roles, visualizar el estado de cada orden, mantener trazabilidad del proceso, generar reportes, administrar catálogos de datos, integrarse con sistemas externos y ofrecer herramientas de configuración que permitan adaptar el flujo productivo sin necesidad de realizar modificaciones al código fuente. La arquitectura de la solución estará orientada a la escalabilidad y extensibilidad, permitiendo incorporar nuevas funcionalidades y módulos de manera progresiva conforme evolucionen las necesidades de las organizaciones que la utilicen.
El MVP contempla únicamente el desarrollo del motor de flujos de trabajo, compuesto por la creación de procesos mediante nodos y conexiones, la configuración de formularios por etapa y la ejecución de órdenes que recorren el flujo definido. Esta versión permitirá validar la arquitectura propuesta y el funcionamiento del núcleo de la plataforma, dejando las funcionalidades complementarias para futuras iteraciones sin comprometer la escalabilidad del sistema.
Software Polygon será utilizado principalmente por el personal operativo y administrativo de Sumicolor para gestionar digitalmente las Órdenes de Producción (OP), reemplazando completamente el uso de formatos físicos durante el proceso productivo. El sistema deberá funcionar continuamente durante la jornada laboral y permitir que múltiples usuarios registren información simultáneamente desde diferentes estaciones de trabajo.
Tipo de usuario | Cantidad aproximada -- | -- Administradores | 2 - 5 Planeación | 3 - 5 Operarios de producción (Picky, Pesaje, Mezcla, Extrusión, Calidad, Empaque) | 30 - 50 Supervisores / Consulta | 5 - 10Usuarios concurrentes esperados: 20–30 usuarios.
Se estima que diariamente el sistema administrará entre 300 y 600 Órdenes de Producción, dependiendo de la carga operativa de la planta.
Cada orden recorrerá todas las etapas del proceso productivo, generando múltiples registros durante su ciclo de vida.
Cada Orden de Producción almacenará información correspondiente a:
- Planeación
- Picky
- Pesaje
- Mezcla
- Extrusión
- Calidad
- Empaque
- Espacio Cliente
- Historial de cambios
- Usuario responsable
- Fechas y horas
- Observaciones
Se espera almacenar varios miles de registros históricos sin afectar el rendimiento del sistema.
Debido a que el sistema será utilizado principalmente para diligenciar formularios y consultar órdenes:
- Consultas por segundo: 5 – 10
- Escrituras por segundo: 3 – 5
- Pico esperado: hasta 15 peticiones por segundo durante cambios de turno o inicio de jornada.
No se espera un tráfico masivo, pero sí disponibilidad constante durante la operación de la planta.
Operación | Tiempo esperado -- | -- Inicio de sesión | < 2 segundos Consulta de OP | < 2 segundos Cambio de módulo | < 2 segundos Guardar formulario | < 3 segundos Generar historial | < 5 segundos Generar reporte | < 10 segundosEl sistema deberá encontrarse disponible durante toda la jornada de producción.
Disponibilidad esperada: 99 % durante horario laboral.
La arquitectura deberá permitir:
- Agregar nuevos módulos de producción;
- Incorporar nuevos formularios sin modificar el código fuente;
- Aumentar el número de usuarios;
- Adaptar el sistema a otras plantas o empresas.
El sistema deberá responder a las operaciones habituales en menos de 3 segundos, garantizando fluidez durante el registro de información.
El sistema deberá permanecer disponible durante toda la jornada de producción, minimizando interrupciones del servicio.
El acceso al sistema requerirá autenticación mediante usuario y contraseña.
Cada usuario visualizará únicamente las funcionalidades autorizadas según su rol.
No podrá avanzarse una Orden de Producción mientras existan campos obligatorios pendientes en la etapa actual.
Todas las modificaciones realizadas sobre una Orden de Producción deberán registrar:
usuario fecha hora etapa acción realizada
La interfaz deberá:
ser minimalista; reducir la cantidad de clics; utilizar botones grandes; emplear colores fácilmente distinguibles; mantener una navegación simple.
Este requisito responde al perfil de los operarios descrito en el proyecto, buscando minimizar la curva de aprendizaje.
La aplicación deberá facilitar su uso por personas con baja experiencia tecnológica mediante:
tipografía grande; alto contraste; iconografía clara; mensajes sencillos; formularios simples.
El sistema deberá funcionar correctamente en:
computadores de escritorio; tabletas Android; navegadores modernos (Chrome y Edge).
Los administradores podrán modificar formularios y módulos sin necesidad de realizar cambios en el código fuente, alineado con la capacidad de configuración definida para Polygon.
La arquitectura permitirá incorporar nuevas etapas del proceso productivo sin afectar las funcionalidades existentes.
Toda la información almacenada deberá poder respaldarse periódicamente para evitar pérdida de datos.
El sistema conservará el historial completo de cada Orden de Producción para facilitar auditorías internas y consultas históricas.
Representa cualquier persona autorizada para acceder al sistema.
Atributos principales:
- id
- nombre
- correo
- contraseña
- estado
Determina los permisos del usuario.
Principales roles del sistemas:
- Administrador.
- Operario.
Es la entidad principal del sistema.
Representa una orden de fabricación desde su creación hasta su finalización.
Atributos:
- número OP
- fecha
- estado
- producto
- cantidad
- observaciones
Representa cada etapa del proceso:
- Planeación
- Picky
- Pesaje
- Mezcla
- Extrusión
- Calidad
- Empaque
- Espacio Cliente
Conjunto de campos que debe diligenciar un operario en una etapa determinada.
Cada módulo posee su propio formulario configurable.
Representa cada dato configurable del formulario:
- Cantidad
- Temperatura
- Observación
- Fecha
- Responsable
Información diligenciada por un usuario en una etapa específica.
Cada registro queda asociado a una Orden de Producción y forma parte de su historial.
Permite conocer toda la trazabilidad de una Orden de Producción.
Incluye:
- usuario
- fecha
- acción
- etapa
Producto que será fabricado.
Materias primas utilizadas durante la producción.
classDiagram
class Usuario{
+id
+nombre
+correo
+estado
}
class Rol{
+id
+nombre
}
class OrdenProduccion{
+id
+numero
+fecha
+estado
+cantidad
}
class Producto{
+id
+nombre
}
class ModuloProduccion{
+id
+nombre
+orden
}
class Formulario{
+id
+nombre
}
class CampoFormulario{
+id
+nombre
+tipo
+obligatorio
}
class Registro{
+id
+fechaHora
+valor
}
class Historial{
+id
+fechaHora
+accion
}
class MateriaPrima{
+id
+nombre
}
Usuario --> Rol : posee
Usuario --> Registro : registra
OrdenProduccion --> Producto : fabrica
OrdenProduccion --> Historial : genera
OrdenProduccion --> Registro : contiene
ModuloProduccion --> Formulario : utiliza
Formulario --> CampoFormulario : contiene
Registro --> ModuloProduccion : pertenece
Registro --> Formulario : diligencia
OrdenProduccion --> MateriaPrima : utiliza
Interfaz gráfica utilizada por administradores y operadores. Permite construir flujos de trabajo, diligenciar formularios y gestionar órdenes de producción mediante una SPA. Se construye utilizando Vue 3, Vite y Tailwind CSS.
Expone los servicios necesarios para la comunicación entre el cliente y la base de datos, implementando la lógica de negocio, autenticación y validación de las operaciones del sistema. Se construye utilizando Django.
Subsistema encargado de administrar los procesos definidos como grafos, validando las transiciones entre etapas y controlando el avance de las órdenes dentro del flujo. Django.
Administra la definición, almacenamiento y renderizado de formularios configurables asociados a cada etapa del proceso. DJango y PostgreSQL
Administra el ciclo de vida de las órdenes de trabajo, su estado actual, historial de etapas y la información diligenciada durante el proceso. DJango y PostgreSQL.
Controla el acceso a la plataforma mediante autenticación y asignación de roles (Administrador y Operador para el MVP). JWT y DJango.
Almacena toda la información del sistema: procesos, nodos, conexiones, formularios, usuarios, órdenes y registros del flujo de trabajo. PostgreSQL.
Capa encargada de mapear las entidades del sistema a la base de datos y facilitar las operaciones CRUD. Prisma ORM.
---
config:
layout: dagre
---
flowchart LR
Usuario["Operador / Administrador"] --> Frontend["Frontend (SPA)<br>Vue 3 + Tailwind CSS"]
Frontend --> API["API REST"]
API --> Workflow["Motor de Flujos de Trabajo"]
Workflow --> Formularios["Motor de Formularios"] & Ordenes["Gestión de Órdenes"] & Usuarios["Autenticación y Usuarios"] & Catalogos["Catálogos"] & BD[("PostgreSQL")]
Formularios --> BD
Ordenes --> BD
Usuarios --> BD
Catalogos --> BD
La arquitectura propuesta sigue un modelo cliente-servidor, compuesto por una aplicación web (SPA), una API REST, varios componentes especializados de lógica de negocio y una base de datos centralizada. Este diseño fue seleccionado por su modularidad, facilidad de mantenimiento y capacidad de crecimiento, características fundamentales para un sistema que busca digitalizar el proceso productivo de Sumicolor y que, en el futuro, pueda adaptarse a otros procesos industriales.
El Frontend, desarrollado como una Single Page Application (SPA), proporciona una interfaz rápida e intuitiva para los usuarios finales. Esta decisión permite reducir los tiempos de carga y ofrecer una experiencia de uso sencilla, aspecto especialmente importante debido a que los principales usuarios del sistema serán operarios de planta con distintos niveles de experiencia tecnológica. Asimismo, el uso de Vue 3 y Tailwind CSS facilita el desarrollo de interfaces responsivas, compatibles con computadores y tabletas, favoreciendo la accesibilidad y la usabilidad del sistema.
La API REST actúa como punto central de comunicación entre el cliente y la lógica de negocio. Esta separación entre presentación y procesamiento permite desacoplar ambos componentes, facilitando el mantenimiento, la incorporación de nuevas funcionalidades y la reutilización de los servicios por otros clientes o aplicaciones en el futuro.
La lógica del negocio se encuentra dividida en componentes especializados, cada uno con responsabilidades claramente definidas. El Motor de Flujos de Trabajo administra la secuencia de etapas del proceso productivo y valida que una Orden de Producción únicamente pueda avanzar cuando la etapa anterior haya sido completada correctamente. El Motor de Formularios permite gestionar formularios dinámicos asociados a cada etapa del proceso, haciendo posible adaptar el sistema a cambios futuros sin modificar la estructura principal de la aplicación. Por su parte, el componente de Gestión de Órdenes controla el ciclo de vida de las Órdenes de Producción y mantiene su trazabilidad, mientras que Autenticación y Usuarios garantiza el acceso seguro mediante roles y permisos. Finalmente, el componente de Catálogos centraliza la administración de información maestra, como productos, materias primas y demás datos de referencia utilizados durante la operación.
Toda la información se almacena en una base de datos PostgreSQL, lo que garantiza consistencia, integridad y persistencia de los datos registrados durante el proceso productivo. Al centralizar la información en un único repositorio, el sistema facilita la consulta histórica de las órdenes, mejora la trazabilidad del proceso y reduce los riesgos asociados al manejo de documentación física.
Esta arquitectura responde directamente a los principales requisitos no funcionales definidos para el proyecto. La separación por componentes favorece la mantenibilidad, al permitir realizar cambios en un módulo sin afectar los demás. La organización modular también mejora la escalabilidad, haciendo posible incorporar nuevas etapas del proceso, formularios o funcionalidades con un impacto mínimo sobre la arquitectura existente. El uso de autenticación basada en roles fortalece la seguridad, asegurando que cada usuario acceda únicamente a las funciones autorizadas. Finalmente, la comunicación mediante una SPA y una API REST contribuye a cumplir los requisitos de rendimiento, ofreciendo tiempos de respuesta bajos incluso cuando múltiples usuarios registren información simultáneamente desde diferentes estaciones de trabajo.
En conjunto, esta solución arquitectónica proporciona una base sólida para el desarrollo del MVP de Polygon, permitiendo validar el funcionamiento del proceso de digitalización de órdenes de producción y ofreciendo una estructura preparada para evolucionar hacia una plataforma configurable para otros procesos industriales.
Puedes consultar el prototipo interactivo en el siguiente enlace:
Se realizó una sesión de validación del prototipo con el Product Owner de Sumicolor, en la cual se presentaron los principales módulos de la aplicación y el flujo general de trabajo para los operarios y administradores.
| Caso de prueba | Resultado |
|---|---|
| Navegación entre los módulos del sistema | ✅ Correcto |
| Visualización de las órdenes de producción por estado | ✅ Correcto |
| Inicio y continuación del proceso de una Orden de Producción | ✅ Correcto |
| Identificación visual de estados (Pendiente, En proceso, Requiere ajuste y Reproceso) | ✅ Correcto |
| Acceso al módulo de administración de formularios | ✅ Correcto |
| Flujo general entre el módulo operativo y el administrativo | ✅ Correcto |
Durante la sesión, el Product Owner manifestó su conformidad con el diseño propuesto, destacando la simplicidad de la interfaz, la facilidad para identificar el estado de las órdenes de producción y la organización de la información. Asimismo, confirmó que el flujo planteado representa adecuadamente el proceso actual de la empresa y consideró que el prototipo cumple con las expectativas iniciales del proyecto.