Skip to main content

🏭 Producción


1. 🧩 Descripción General

El módulo de Producción permite planificar, ejecutar y registrar procesos de fabricación dentro de la empresa. Gestiona órdenes de producción, consumo de insumos, tiempos, productos terminados y costos asociados. Se integra directamente con Inventarios, Finanzas, Nómina y CRM técnico/postventa.


2. 🧱 Modelos del Módulo

a. ProductionOrder

  • id: integer (PK)
  • code: string (único)
  • status: enum (pendiente, en_proceso, finalizada, cancelada)
  • product_id: FK → Product
  • quantity: decimal
  • start_date: date
  • end_date: date (nullable)
  • created_by: FK → User
  • cost_estimate: decimal
  • cost_real: decimal

b. ProductionMaterial

  • id: integer (PK)
  • production_order_id: FK → ProductionOrder
  • product_id: FK → Product
  • quantity_required: decimal
  • quantity_used: decimal (registrado al final)

c. ProductionLog

  • id: integer (PK)
  • production_order_id: FK → ProductionOrder
  • note: string
  • log_type: enum (inicio, pausa, incidente, fin)
  • timestamp: datetime
  • user_id: FK → User

3. 🔁 Funciones del Controlador

  • index(): Listar órdenes de producción.
  • store(): Crear nueva orden.
  • show($id): Ver detalle y seguimiento.
  • startProduction(): Cambiar estado a “en proceso”.
  • completeProduction(): Registrar como finalizada.
  • registerMaterials(): Registrar consumo real.
  • logNote(): Añadir comentario de operación.

4. 🌐 Endpoints detallados y justificados

MétodoRutaDescripciónJustificación
GET/api/production-ordersListar órdenesControl de planta
POST/api/production-ordersCrear ordenPlanificación
GET/api/production-orders/{id}Ver ordenSeguimiento y análisis
POST/api/production-orders/{id}/startIniciarCambiar estado
POST/api/production-orders/{id}/completeFinalizarCierre técnico
POST/api/production-orders/{id}/materialsRegistrar consumoCosteo y validación
POST/api/production-orders/{id}/logComentarios / incidenciasTrazabilidad operativa

5. 🖥️ Diseño UX sugerido (flujo de usuario)

Página: "Órdenes de Producción"

  • Tabla con código, producto, cantidad, estado, fechas
  • Filtros por estado, fecha, responsable
  • Acciones: Ver, Iniciar, Finalizar

Página: "Detalle de Orden"

  • Producto objetivo, insumos requeridos
  • Bitácora de eventos (inicio, pausa, fin, notas)
  • Formulario de materiales reales usados

6. 📄 Vistas sugeridas (tipo wireframe)

VistaCampos sugeridosAcciones
ProducciónCódigo, producto, cantidad, fechas, estadoVer, Iniciar, Finalizar
FormularioProducto, cantidad, fecha, insumos esperadosGuardar
Registro insumosProducto, requerido, usadoConfirmar
BitácoraFecha, tipo, usuario, notaAñadir nota

7. 🔗 Conexión Frontend ↔ API JSON:API

Acción en FrontendMétodo/APIResultado esperado
Ver órdenesGET /api/production-ordersTabla con filtros
Crear ordenPOST /api/production-ordersNueva programación
Iniciar ordenPOST /api/production-orders/{id}/startEstado actualizado
Finalizar ordenPOST /api/production-orders/{id}/completeEstado = finalizada
Registrar materialesPOST /api/production-orders/{id}/materialsConsumo registrado
BitácoraPOST /api/production-orders/{id}/logNota agregada

🏭 Este módulo integra control de planta con inventarios y costos de producción, permitiendo trazabilidad completa desde la programación hasta el ingreso de producto terminado.