Listado: filtros, búsqueda y grupos

Los criterios del listado viven solo en la dirección (?estado=…&agrupar=…): se pueden compartir, el botón Atrás funciona y una recarga muestra lo mismo. La API aplica a cada persona la misma regla de visibilidad que el detalle, traducida a SQL, así que nadie ve en la lista algo que no podría abrir.

Paso a paso

1. 1
   PersonaFiltra, busca, agrupa u ordena

   Estado, prioridad, asignado (o sin asignar), creador, rangos de creación y de vencimiento, vencidos, reapertura pendiente y, con permiso, ver eliminados. En celular y tablet los filtros van en un panel en borrador que dice cuántos saldrían antes de aplicar.

2. 2
   NavegadorEscribe los criterios en la dirección

   La búsqueda se envía desde 3 letras. Un filtro nuevo solo toca listing.ts, listQuery.ts y listApi.ts.

3. 3
   NavegadorPide GET /incidents con los parámetros

   page, per_page (máximo 100), sort de lista blanca, search, group_by y filter[...].

4. 4
   API¿Parámetros válidos?

   Una búsqueda necesita al menos una palabra de 3 letras o un código (TZ-26-0142 o 26-142).

5. 5
   APISi pide eliminados, ¿tiene incidents.restore?
6. 6
   APITraduce la visibilidad a SQL

   Todos (incidents.view.any), lo propio, lo asignado y lo sin asignar, según los permisos. Es la misma regla del detalle (VisibilityScope) y una prueba compara ambas persona por persona.

7. 7
   Base de datosBusca con FULLTEXT o por código

   Búsqueda booleana con prefijos ("impre" encuentra "impresora") sobre título y descripción; los operadores que alguien intente colar se quitan. Un código se busca exacto con su año.

8. 8
   Base de datos¿Agrupado?

   Por defecto la lista se agrupa por vencimiento: Vencidos, Vencen hoy, Próximos 7 días, Más adelante y Terminados. También por estado, prioridad, asignado o sin grupos.

9. 9
   Base de datosCuenta cada grupo y salta los anteriores

   Cuenta cada grupo con índices, sin cruzar tablas; salta los grupos que quedan antes de la página y pide solo los ids de los que la tocan. Con 100.000 incidentes, entre 22 y 42 ms.

10. 10
    Base de datosTrae la página con desempate por id

    Orden de lista blanca y id como desempate, para que dos filas iguales no se repitan ni se salten entre páginas. Carga todo lo de la página de una vez (sin N+1).

11. 11
    APIResponde data + meta con actions

    Cada incidente trae actions (lo que esta persona puede hacer), is_overdue y deadline calculados en el back; meta trae el total y, si hay grupos, el total real de cada uno.

12. 12
    NavegadorMuestra la lista agrupada o la tabla

    Lista por defecto; ?vista=tabla cambia a tabla en portátil y monitor (con vista previa lateral en monitor) y tarjetas en tablet y celular. Si otras personas cambian incidentes, aparece "Hay N incidentes con cambios de otras personas · Actualizar" sin mover las filas.

Qué ve la persona en cada error

Una lista sin resultados no es un error: muestra el estado vacío con la opción de quitar los filtros.

Dónde está en el código

• ListIncidents y ListIncidentsRequest.
• VisibilityScope y VisibilitySql: una regla, dos formas.
• EloquentIncidentList, IncidentFilters e IncidentGroups.
• SearchText: mínimo de la búsqueda.
• listQuery, useIncidentList e IncidentListPage.
• Explicación del módulo: Módulo Incidents.