Las 5W del incidente
Un buen reporte se mide por completitud, no por longitud. Las 5W te dan completitud sin floritura.
Qué
El síntoma observable. No la interpretación.
- Mal: "El sistema está roto".
- Bien: "Al hacer clic en 'Guardar' del formulario de pedidos, la página queda en blanco y aparece 'Error 500'."
Dónde
URL exacta + módulo + pantalla.
URL: https://app.perlad.com/admin/pedidos/create
Módulo: Ventas
Pantalla: Nuevo Pedido
Cuándo
Fecha y hora con minuto del último incidente, y desde cuándo empezó.
Empezó: 26-may 14:00
Reproducido ahora: 26-may 14:32
Quién
- Tú (tu email).
- Otros usuarios afectados (cuántos, quiénes si los conoces).
- Roles afectados (todos los Operativos, solo Gerentes…).
Por qué (opcional, pero útil)
Tu hipótesis o el cambio reciente que podría haberlo causado.
Cambio reciente: ayer actualizamos el plan de un cliente
Hipótesis: puede estar relacionado con la sincronización de roles
Bonus: cómo
Pasos numerados y exactos para reproducir.
1. Entro a /admin/pedidos/create
2. Selecciono cliente "ACME"
3. Agrego producto "PROD-001" cantidad 2
4. Clic en "Guardar"
5. Sale "Error 500"
Plantilla
QUÉ: ___________
DÓNDE: ___________
CUÁNDO: ___________
QUIÉN: ___________
POR QUÉ (opcional): ___________
CÓMO REPRODUCIR:
1. ___
2. ___
ADJUNTO: captura + log (si aplica)
Tiempo invertido vs ahorro
Escribir el reporte completo te toma 5 minutos. Te ahorra 2 horas de ida y vuelta con el agente.
¿No resolvió tu caso?
Si tras enviar el reporte el agente pide más información, agrégala como comentario del ticket — no abras uno nuevo.