M04 -- Producción: Modelo de Datos

Campo	Valor
Estado	Borrador
Última actualización	2026-03-25
Documento de requerimientos	M04-requerimientos.md

---

1. Diagrama de entidades

---

2. Descripción de entidades

OrdenProduccion

Entidad central del módulo. Representa una solicitud de producción confirmada que llega desde M03 B2B o M05 Marketplace. Contiene la información necesaria para planificar, ejecutar y cerrar la producción de un preparado magistral.

EtapaProduccion

Registra el paso de la orden por cada etapa del flujo productivo. Permite medir tiempos por etapa, identificar cuellos de botella y mantener trazabilidad del avance. Cada orden tiene múltiples etapas en secuencia.

Lote

Representa el producto elaborado. Cada orden genera un lote con su identificador RM único y correlativo. El lote es la unidad que se despacha y que se vincula con el QR dinámico para seguimiento post-entrega (M07).

Insumo

Materia prima, principio activo, excipiente o material utilizado en la producción. Cada insumo tiene su identificador RO único y correlativo. Incluye información de stock, proveedor y vencimiento. Es la base para el control de inventario y la trazabilidad de pérdidas.

UsoInsumo

Registro del consumo efectivo de cada insumo en una orden específica. Vincula el insumo con la orden y registra la cantidad utilizada, el lote de origen y si hubo sustitución. Es la pieza clave para resolver las pérdidas de inventario (reunión 2026-03-10).

LibroProduccion

Registro digital equivalente al libro de producción físico que el ISP exige. Se genera automáticamente a partir de los datos de la orden, el lote y los insumos utilizados. Incluye firma digital del farmacéutico responsable. No puede modificarse una vez firmado.

Despacho

Información del envío del producto terminado. Incluye operador logístico, número de seguimiento y confirmación de entrega. La entrega confirmada genera el evento que activa M07 Seguimiento.

HistorialEstado

Registro de auditoría de cada cambio de estado de una orden. Cumple la regla R-M04-002: todo cambio deja registro con actor, timestamp y contexto.

---

3. Relaciones clave

Relación	Cardinalidad	Descripción
OrdenProduccion - EtapaProduccion	1:N	Una orden pasa por múltiples etapas (planificación, preparación, producción, control, despacho).
OrdenProduccion - Lote	1:1	Una orden genera un lote. En MVP, una orden produce un único lote.
OrdenProduccion - UsoInsumo	1:N	Una orden consume múltiples insumos, cada uno registrado individualmente.
Insumo - UsoInsumo	1:N	Un insumo puede ser utilizado en múltiples órdenes.
OrdenProduccion - Despacho	1:1	Una orden tiene un despacho asociado.
OrdenProduccion - LibroProduccion	1:1	Una orden genera un registro en el libro de producción.
Lote - LibroProduccion	1:1	Cada lote tiene su registro correspondiente en el libro.
OrdenProduccion - HistorialEstado	1:N	Cada cambio de estado genera un registro de auditoría.

---

4. Notas de diseño

• Los identificadores RO y RM son únicos, correlativos y no reutilizables. Se generan automáticamente al crear el insumo (RO) o el lote (RM).
• El campo qr_dinamico del Lote almacena una URL única que vincula el producto físico con el sistema digital (M07 Seguimiento).
• El LibroProduccion es inmutable una vez firmado. Cualquier corrección genera un nuevo registro de enmienda.
• La relación con M03 B2B y M05 Marketplace se mantiene a través de id_orden_origen en OrdenProduccion, pero no hay dependencia directa entre las bases de datos de los módulos.

---

Volver al Requerimientos M04 | Ver Historias de usuario M04