🏭 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étodo	Ruta	Descripción	Justificación
GET	/api/production-orders	Listar órdenes	Control de planta
POST	/api/production-orders	Crear orden	Planificación
GET	/api/production-orders/{id}	Ver orden	Seguimiento y análisis
POST	/api/production-orders/{id}/start	Iniciar	Cambiar estado
POST	/api/production-orders/{id}/complete	Finalizar	Cierre técnico
POST	/api/production-orders/{id}/materials	Registrar consumo	Costeo y validación
POST	/api/production-orders/{id}/log	Comentarios / incidencias	Trazabilidad 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)

Vista	Campos sugeridos	Acciones
Producción	Código, producto, cantidad, fechas, estado	Ver, Iniciar, Finalizar
Formulario	Producto, cantidad, fecha, insumos esperados	Guardar
Registro insumos	Producto, requerido, usado	Confirmar
Bitácora	Fecha, tipo, usuario, nota	Añadir nota

---

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

Acción en Frontend	Método/API	Resultado esperado
Ver órdenes	GET /api/production-orders	Tabla con filtros
Crear orden	POST /api/production-orders	Nueva programación
Iniciar orden	POST /api/production-orders/{id}/start	Estado actualizado
Finalizar orden	POST /api/production-orders/{id}/complete	Estado = finalizada
Registrar materiales	POST /api/production-orders/{id}/materials	Consumo registrado
Bitácora	POST /api/production-orders/{id}/log	Nota 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.