erp-vidrio-templado/docs/08-epicas/EPIC-VT-003-produccion.md

7.2 KiB

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)

  • Historias de usuario definidas
  • Criterios de aceptacion claros
  • Dependencias identificadas
  • 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