erp-vidrio-templado/docs/08-epicas/EPIC-VT-007-calidad.md

228 lines
8.5 KiB
Markdown

# 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