# EPICA: EPIC-VT-007 - Calidad (QC)

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | EPIC-VT-007 |
| **Nombre** | Calidad (QC) |
| **Modulo** | calidad |
| **Fase** | Fase 1 - MVP |
| **Prioridad** | P0 (Critico) |
| **Estado** | Backlog |
| **Story Points** | 32 |
| **Sprint(s)** | Sprint 7-8 |

---

## Descripcion

Control de calidad especializado para vidrio templado. Incluye inspección visual, pruebas de fragmentación, medición de tensión superficial y generación de certificados de calidad. Gestiona rechazos y reprocesos con trazabilidad completa.

---

## Objetivo de Negocio

- Garantizar calidad del producto
- Cumplir normativas de seguridad (NOM, ASTM, EN)
- Reducir rechazos y devoluciones
- Trazabilidad para garantías
- Certificación de lotes

---

## Historias de Usuario

| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-VT007-001 | Como inspector, quiero ver piezas templadas pendientes de inspección para planificar trabajo | P0 | 3 | Backlog |
| US-VT007-002 | Como inspector, quiero registrar inspección visual con lista de defectos para documentar | P0 | 5 | Backlog |
| US-VT007-003 | Como inspector, quiero registrar resultado de prueba de fragmentación para certificar templado | P0 | 5 | Backlog |
| US-VT007-004 | Como inspector, quiero adjuntar fotos de defectos para evidencia | P0 | 3 | Backlog |
| US-VT007-005 | Como inspector, quiero aprobar o rechazar pieza para liberar a despacho o reproceso | P0 | 3 | Backlog |
| US-VT007-006 | Como jefe de calidad, quiero generar certificado de calidad por lote para entregar al cliente | P0 | 5 | Backlog |
| US-VT007-007 | Como jefe de calidad, quiero ver métricas de rechazos para identificar problemas | P1 | 3 | Backlog |
| US-VT007-008 | Como jefe de producción, quiero ver piezas rechazadas para programar reproceso | P1 | 3 | Backlog |
| US-VT007-009 | Como admin, quiero configurar tipos de defectos y criterios de aceptación | P2 | 2 | Backlog |

**Total Story Points:** 32 SP

---

## Pruebas de Calidad

```
┌─────────────────────────────────────────────────────────┐
│              INSPECCIÓN DE VIDRIO TEMPLADO              │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  1. INSPECCIÓN VISUAL                                   │
│     ├── Rayaduras                                       │
│     ├── Burbujas                                        │
│     ├── Manchas                                         │
│     ├── Ondulaciones                                    │
│     └── Dimensiones correctas                           │
│                                                         │
│  2. PRUEBA DE FRAGMENTACIÓN (destructiva - muestreo)    │
│     ├── Mínimo 40 fragmentos por 50mm²                  │
│     ├── Sin fragmentos mayores a 100mm²                 │
│     └── Patrón uniforme                                 │
│                                                         │
│  3. MEDICIÓN DE TENSIÓN (opcional - no destructiva)     │
│     ├── Tensión superficial: 95-120 MPa                 │
│     └── Tensión central: < 7 MPa                        │
│                                                         │
└─────────────────────────────────────────────────────────┘

Resultado: APROBADO / RECHAZADO / REPROCESO
```

---

## Flujo de Inspección

```
┌─────────────┐
│  PENDIENTE  │  ← Pieza llega de templado
└──────┬──────┘
       │
       ▼
┌─────────────┐
│ EN_INSPECC  │  ← Inspector revisando
└──────┬──────┘
       │
       ├────────────────┬────────────────┐
       ▼                ▼                ▼
┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│  APROBADA   │  │  RECHAZADA  │  │  REPROCESO  │
└──────┬──────┘  └──────┬──────┘  └──────┬──────┘
       │                │                │
       ▼                ▼                ▼
┌─────────────┐  ┌─────────────┐  ┌─────────────┐
│ A_DESPACHO  │  │    BAJA     │  │  A_CORTE    │
└─────────────┘  └─────────────┘  └─────────────┘
```

---

## Criterios de Aceptacion de la Epica

**Funcionales:**
- [ ] Ver piezas pendientes de inspección
- [ ] Registrar inspección visual con checklist de defectos
- [ ] Registrar prueba de fragmentación
- [ ] Adjuntar fotos de evidencia
- [ ] Aprobar/rechazar con motivo
- [ ] Generar certificado de calidad PDF
- [ ] Métricas de rechazos por tipo de defecto
- [ ] Gestión de reprocesos

**No Funcionales:**
- [ ] Registro de inspección < 2 minutos
- [ ] Generación de certificado < 5 segundos
- [ ] Historial de 2 años de inspecciones

**Tecnicos:**
- [ ] Integración con módulo de templado
- [ ] Integración con módulo de despacho
- [ ] Almacenamiento de fotos
- [ ] Templates de certificados configurables

---

## Dependencias

**Esta epica depende de:**
| Epica/Modulo | Estado | Bloqueante |
|--------------|--------|------------|
| EPIC-VT-001 Fundamentos | Backlog | Si |
| EPIC-VT-003 Produccion | Backlog | Si |
| EPIC-VT-006 Templado | Backlog | Si |

**Esta epica bloquea:**
| Epica/Modulo | Razon |
|--------------|-------|
| EPIC-VT-008 Despacho | Requiere piezas aprobadas |

---

## Desglose Tecnico

**Database:**
- [ ] Schema: `quality`
- [ ] Tablas: 6 (inspections, inspection_defects, fragmentation_tests, certificates, defect_types, photos)
- [ ] Funciones: 2 (generate_certificate_number, calculate_rejection_rate)
- [ ] Indices: Por pieza, lote, fecha, resultado

**Backend:**
- [ ] Modulo: `quality`
- [ ] Entities: 5 (Inspection, InspectionDefect, FragmentationTest, Certificate, DefectType)
- [ ] Endpoints: 12
- [ ] Tests: 24

**Frontend:**
- [ ] Paginas: 4 (InspectionQueue, InspectionForm, Certificates, Metrics)
- [ ] Componentes: 10 (DefectChecklist, PhotoUploader, CertificateViewer, etc.)
- [ ] Stores: 1 (qualityStore)

---

## Endpoints API

| Metodo | Endpoint | Descripcion |
|--------|----------|-------------|
| GET | /api/quality/pending | Piezas pendientes de inspección |
| POST | /api/quality/inspections | Crear inspección |
| GET | /api/quality/inspections/:id | Detalle de inspección |
| POST | /api/quality/inspections/:id/defects | Agregar defecto |
| POST | /api/quality/inspections/:id/photos | Subir foto |
| POST | /api/quality/inspections/:id/approve | Aprobar pieza |
| POST | /api/quality/inspections/:id/reject | Rechazar pieza |
| POST | /api/quality/certificates | Generar certificado |
| GET | /api/quality/certificates/:id/pdf | Descargar certificado PDF |
| GET | /api/quality/metrics | Métricas de calidad |

---

## Riesgos

| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Inspección superficial | Media | Alto | Checklist obligatorio |
| Pérdida de trazabilidad | Baja | Alto | Registro por pieza individual |
| Certificados incorrectos | Baja | Alto | Validación de datos antes de generar |

---

## Definition of Ready (DoR)

- [x] Historias de usuario definidas
- [x] Criterios de aceptacion claros
- [x] Dependencias identificadas
- [x] Estimacion completada
- [ ] Tipos de defectos definidos
- [ ] Template de certificado aprobado

## Definition of Done (DoD)

- [ ] Flujo de inspección funcionando
- [ ] Generación de certificados operativa
- [ ] Fotos de evidencia almacenadas
- [ ] Métricas de rechazos disponibles
- [ ] 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