Buscar en la documentación

Mis incidentes: Kanban

El tablero de quien atiende incidentes, cómo se carga y qué pasa al arrastrar una tarjeta a otro estado.

Módulo incidents1 min de lecturaVer en GitHub

“Mis incidentes” es el tablero de quien atiende (incidents.view.assigned): lo que tiene asignado y sigue en curso, más lo que cerró o canceló en los últimos 7 días. Tiene cuatro vistas sobre los mismos datos: Kanban, Lista, Calendario y Mi día. Este flujo sigue el Kanban, que es donde se cambia el estado arrastrando.

Diagrama4 carriles · 10 pasos · 3 salidas de error
SíNoSíNoSíNoAbre Mis incidentes1Pide GET/incidents/mine2¿Tieneincidents.view.assigned?3Responde 403Trae hasta 500asignados4Arrastra unatarjeta a otracolumna5¿Ese destinoestá en susnext_statuses?6No se puedesoltar ahíPide nota oconfirmación si eldestino lo exige7Cambia el estadocomo en el detalle8¿Se guardó?9Muestra el errory recargaLa tarjeta queda ensu columna nueva10
Los números coinciden con el paso a paso. En pantallas pequeñas el diagrama se desliza de lado.

Paso a paso

  1. PersonaAbre Mis incidentes

    Botón "Mis incidentes" junto a "Nuevo incidente". La vista elegida queda en ?vista= y se recuerda en el navegador.

  2. NavegadorPide GET /incidents/mine
  3. API¿Tiene incidents.view.assigned?
  4. Base de datosTrae hasta 500 asignados

    En curso y terminados de los últimos 7 días (por updated_at), con el índice del dashboard: unos 1,5 ms. Si hay más de 500, avisa con truncated. Cada tarjeta trae sus next_statuses.

  5. PersonaArrastra una tarjeta a otra columna

    En portátil y monitor. Al tomarla, se marcan las columnas a las que puede ir y se apagan las demás. En celular y tablet, y con teclado, se usa "Mover a…" en la tarjeta.

  6. Navegador¿Ese destino está en sus next_statuses?

    Solo sirve para no ofrecer lo imposible; la regla la aplica la API.

  7. NavegadorPide nota o confirmación si el destino lo exige

    Resuelto y Cancelado piden nota; los estados finales piden confirmación. Es el mismo diálogo del detalle.

  8. APICambia el estado como en el detalle

    PUT /incidents/{id}/status con la versión de la tarjeta. Mismas reglas, errores y avisos que el flujo "Cambiar de estado".

  9. API¿Se guardó?
  10. NavegadorLa tarjeta queda en su columna nueva

    Cuando llegan cambios de otras personas por tiempo real, el tablero se recarga tras 1,5 s, para juntar varios avisos seguidos en una sola consulta.

Qué ve la persona en cada error

CódigoHTTPCuándoMensaje en pantalla
FORBIDDEN_ACTION403Su rol no atiende incidentesNo tienes permiso para hacer esta acción. Si crees que deberías tenerlo, habla con un administrador.
VERSION_CONFLICT409El incidente cambió desde que se cargó el tableroAlguien más guardó cambios en este incidente mientras lo tenías abierto. Recarga para ver la versión actual antes de seguir.
INVALID_STATUS_TRANSITION409Otra persona ya lo movióEse cambio de estado no está permitido desde el estado actual. Recarga la página para ver las opciones disponibles.
STATUS_NOTE_REQUIRED422Resuelto o Cancelado sin notaPara este cambio de estado hace falta una nota. Escribe brevemente qué pasó y vuelve a intentarlo.

Dónde está en el código