Guía de uso
Lista de pedidos y filtros
The orders workbench helps teams search, filter, export, and update order status without opening the full detail workspace.
Intención de la página
The intent of Orders List & Filters is to answer operational questions quickly and surface the right order before editing deeper data.
Contexto para soporte
Para problemas de list/filter, incluya el modo de búsqueda activo, los filtros utilizados, la identificación del pedido esperado y si el problema estaba en los KPI, la fila visible o la exportación.
Cómo funciona
The page opens with KPI cards and the create-order action, then moves into filtering and results. This layout lets the user understand workload first and search second.
Quick status filtering answers broad questions such as how many pending orders remain. Simple search is best when the user knows an id, ordered-by name, or order-for text. Advanced search is best when the user needs several filters together.
The results table is designed for fast scanning: customer, dependent, type, product line, dates, totals, e-invoice state, status, and actions sit in one visible row. That means the user can decide whether to edit, change status, export, or open detail from the same screen.
Status updates, row editing, and deletion are lightweight management actions. They are useful for correcting basic fields or moving work between pending, in progress, paid, or cancelled without stepping into line-level traceability.
La lista no debe usarse para explicar profundamente un pedido. Cuando el equipo necesita desglose de líneas, trazabilidad de lotes, contexto de facturas o tareas vinculadas, la decisión correcta es abrir Detalles del pedido.
Botones y acciones
| Acción | Qué hace |
|---|---|
Create order | Inicia un nuevo pedido desde el banco de trabajo principal. |
Simple | Muestra el modo de búsqueda rápida. |
Advanced | Muestra filtros agrupados para identificación, fechas y clasificación. |
Search | Aplica el modo de búsqueda activa. |
Clear | Restablece los filtros y el estado de búsqueda. |
Export CSV | Exporta filas visibles de la lista de pedidos. |
Edit | Abre el cuadro de diálogo de edición ligero para los campos del encabezado del pedido. |
Delete | Elimina el pedido seleccionado después de la confirmación. |
Status selector | Cambia el estado del pedido directamente desde la fila de la tabla. |
Create Ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Mapa de contenido
Columna izquierda / bloque rápido
Quick filter
Filtro rápido por estado para cambiar el foco sin construir una consulta compleja.
Contenido visible
- Estado all/pending/in progreso/paid/cancelled según etiquetas visibles.
Acciones
- Moverse rapido entre estados operativos.
Modo sencillo
Simple search
Busqueda directa cuando el usuario recuerda un id, ordenado por o pedido para.
Contenido visible
- Una sola entrada de texto.
- Buscar y Borrar.
Acciones
- Buscar por texto amplio sin llenar todos los filtros.
Modo avanzado
Advanced filters
Busqueda agrupada para identificación, fechas y clasificación.
Contenido visible
- DNI, cliente, dependiente y tipo.
- Fecha de creación y fecha de entrega.
- Estado y línea de productos.
Acciones
- Hacer filtros de precisión para soporte, auditoría o seguimiento.
tabla principal
DataGrid de resultados
Vista tabular final de la consulta con acciones por fila.
Contenido visible
- Columnas operativas completas.
- Recuento visible/total.
- Acciones Editar, Eliminar y estado por fila.
Acciones
- Exportar CSV.
- Abrir detalle.
- Estado de actualización.
Ejemplos operativos
Ejemplo 1: si un supervisor necesita solo pedidos pendientes para hoy, combine estado rápido con fecha de entrega y reduzca la tabla a trabajo accionable.
Ejemplo 2: si un cliente dice que su pedido no aparece, usa una simple búsqueda por nombre o id antes de asumir que el pedido no existe.
Ejemplo 3: si exportas un CSV para revisión externa, primero deja la tabla exactamente en el subconjunto que quieres compartir.
Cómo se lee en el código
| Archivo | Qué hace |
|---|---|
frontend/src/modules/orders/components/orders-workbench-sections.tsx | Aquí viven OrdersDesktopFiltersSection, tarjetas KPI, enlaces DataGrid y construcción visual del banco de trabajo de filtros y resultados. |
frontend/src/modules/orders/components/orders-workbench-panel.tsx | Controla filterMode, simpleSearch, advancedFilters, statusFilter y filteredRows. Esa es la lógica que decide qué pedido aparece o no aparece en la tabla. |