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

8.5 KiB

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)

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