# EPICA: EPIC-VT-003 - Producción

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-VT-003 |
| **Nombre** | Producción |
| **Modulo** | produccion |
| **Fase** | Fase 1 - MVP |
| **Prioridad** | P0 (Critico) |
| **Estado** | Backlog |
| **Story Points** | 42 |
| **Sprint(s)** | Sprint 4-5 |

---

## Descripcion

Gestión completa de órdenes de producción para vidrio templado. Controla el flujo desde la recepción del pedido hasta la entrega del producto terminado, pasando por corte, templado y control de calidad. Incluye planificación de capacidad y seguimiento en tiempo real.

---

## Objetivo de Negocio

- Control total del proceso productivo
- Reducir tiempos muertos entre etapas
- Trazabilidad completa por lote
- Optimizar uso de hornos de templado
- Minimizar desperdicios de material

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-VT003-001 | Como jefe de producción, quiero crear orden de producción desde cotización aprobada para iniciar el proceso | P0 | 5 | Backlog |
| US-VT003-002 | Como jefe de producción, quiero ver tablero de órdenes en proceso para supervisar producción | P0 | 5 | Backlog |
| US-VT003-003 | Como operador de corte, quiero ver mis piezas asignadas del día para planificar trabajo | P0 | 3 | Backlog |
| US-VT003-004 | Como operador de corte, quiero marcar piezas cortadas para avanzar a siguiente etapa | P0 | 3 | Backlog |
| US-VT003-005 | Como operador de horno, quiero ver piezas listas para templado agrupadas por espesor | P0 | 5 | Backlog |
| US-VT003-006 | Como operador de horno, quiero registrar lote de templado con temperatura y tiempo | P0 | 5 | Backlog |
| US-VT003-007 | Como inspector de calidad, quiero registrar resultado de inspección para liberar producto | P0 | 5 | Backlog |
| US-VT003-008 | Como jefe de producción, quiero ver métricas de producción diaria para medir eficiencia | P1 | 5 | Backlog |
| US-VT003-009 | Como jefe de producción, quiero reprogramar orden para ajustar prioridades | P1 | 3 | Backlog |
| US-VT003-010 | Como admin, quiero configurar estaciones de trabajo para asignar órdenes | P2 | 3 | Backlog |

**Total Story Points:** 42 SP

---

## Flujo de Producción

```
┌─────────────┐
│  PROGRAMADA │  ← Orden creada y programada
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  EN_CORTE   │  ← Piezas siendo cortadas
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  CORTADO    │  ← Todas las piezas cortadas
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ EN_TEMPLADO │  ← Piezas en horno
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  TEMPLADO   │  ← Templado completado
└──────┬──────┘
       │
       ▼
┌─────────────┐
│    EN_QC    │  ← Inspección de calidad
└──────┬──────┘
       │
       ├──────────────┐
       ▼              ▼
┌─────────────┐ ┌─────────────┐
│   APROBADO  │ │  RECHAZADO  │
└──────┬──────┘ └──────┬──────┘
       │               │
       ▼               ▼
┌─────────────┐ ┌─────────────┐
│ LISTO_ENVIO │ │ REPROCESO   │
└─────────────┘ └─────────────┘
```

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Crear orden desde cotización aprobada
- [ ] Asignar a línea de producción
- [ ] Registrar avance por etapa (corte, templado, QC)
- [ ] Registrar parámetros de templado (temp, tiempo)
- [ ] Registrar resultados de QC
- [ ] Gestionar reprocesos
- [ ] Dashboard de producción en tiempo real

**No Funcionales:**
- [ ] Actualización de tablero < 5 segundos
- [ ] Soporte para 100+ órdenes activas
- [ ] Registro de etapas en < 3 clicks

**Tecnicos:**
- [ ] Integración con módulo de corte (nesting)
- [ ] Integración con módulo de templado (hornos)
- [ ] Integración con módulo de calidad
- [ ] Alertas de órdenes atrasadas

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-VT-001 Fundamentos | Backlog | Si |
| EPIC-VT-002 Cotizaciones | Backlog | Si |
| EPIC-VT-004 Inventario | Backlog | Si |

**Esta epica bloquea:**
| Epica/Modulo | Razon |
|--------------|-------|
| EPIC-VT-005 Corte | Requiere órdenes de producción |
| EPIC-VT-006 Templado | Requiere órdenes de producción |
| EPIC-VT-007 Calidad | Requiere órdenes de producción |
| EPIC-VT-008 Despacho | Requiere producción completada |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `production`
- [ ] Tablas: 8 (production_orders, order_items, stages, stage_logs, workstations, etc.)
- [ ] Funciones: 4 (advance_stage, calculate_times, etc.)
- [ ] Indices: Por orden, fecha, etapa, estación

**Backend:**
- [ ] Modulo: `production`
- [ ] Entities: 6 (ProductionOrder, OrderItem, Stage, StageLog, Workstation)
- [ ] Endpoints: 18
- [ ] Tests: 35

**Frontend:**
- [ ] Paginas: 5 (ProductionBoard, OrderDetail, StageTracker, Metrics, Config)
- [ ] Componentes: 15 (OrderCard, StageProgress, WorkstationSelector, etc.)
- [ ] Stores: 2 (productionStore, workstationsStore)

---

## Endpoints API

| Metodo | Endpoint | Descripcion |
|--------|----------|-------------|
| POST | /api/production/orders | Crear orden de producción |
| GET | /api/production/orders | Listar órdenes |
| GET | /api/production/orders/:id | Detalle de orden |
| PATCH | /api/production/orders/:id | Actualizar orden |
| POST | /api/production/orders/:id/advance | Avanzar etapa |
| POST | /api/production/orders/:id/assign | Asignar a estación |
| GET | /api/production/board | Tablero de producción |
| GET | /api/production/metrics | Métricas de producción |
| GET | /api/workstations | Listar estaciones |

---

## Riesgos

| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Cuellos de botella en templado | Alta | Alto | Planificación por capacidad de hornos |
| Pérdida de trazabilidad | Media | Alto | Registro obligatorio por etapa |
| Reprocesos no controlados | Media | Medio | Flujo de reproceso definido |

---

## Definition of Ready (DoR)

- [x] Historias de usuario definidas
- [x] Criterios de aceptacion claros
- [x] Dependencias identificadas
- [x] Estimacion completada
- [ ] Flujo de etapas aprobado
- [ ] Estaciones de trabajo definidas

## Definition of Done (DoD)

- [ ] Flujo completo de producción funcionando
- [ ] Tablero en tiempo real operativo
- [ ] Trazabilidad por lote implementada
- [ ] Tests de integración pasando
- [ ] Documentación de API

---

## Historial

| Fecha | Cambio | Autor |
|-------|--------|-------|
| 2025-12-08 | Creacion de epica | Claude-Agent |

---

**Creada por:** Claude-Agent
**Fecha:** 2025-12-08
**Ultima actualizacion:** 2025-12-08
