Guía de uso
Tareas
Las tareas coordinan la asignación, el estado, los comentarios, la planificación del calendario, las vistas del tablero y el seguimiento de los pedidos.
Intención de la página
La intención de Tareas es mantener el trabajo activo visible, asignado y en movimiento sin mezclar la ejecución diaria con el mantenimiento del catálogo.
Contexto para soporte
Cuando una tarea no pueda reasignarse o falte un comentario, incluye el id de la tarea e indica si estaba abierta la vista Centro, Tablero, Calendario o Detalle.
Cómo funciona
Tareas funciona como la cola de trabajo operativa. La página se abre en el Centro de forma predeterminada, donde el usuario ve primero el trabajo pendiente, puede cambiar a Listo o Todo y puede actualizar el estado, la prioridad, el propietario, los asignados y las notas sin salir del contexto de seguimiento.
Tablero es la vista de creación y gestión de tablas. Permite al usuario buscar tareas, abrir el modo de creación, definir título, descripción, prioridad, estado, tipo de tarea, propietario, orden relacionada, fecha de vencimiento y usuarios asignados, luego guardar la tarea como trabajo operativo.
Calendario es la vista de planificación. Muestra el trabajo asignado por tiempo y persona para que un equipo pueda coordinar quién hace qué sin tratar el seguimiento de las tareas como una hoja de cálculo.
Detalles de la tarea es la vista de edición profunda. Al abrir una tarea se muestra el estado, la prioridad, el tipo, la descripción, las fechas, el orden relacionado, las personas involucradas, los usuarios asignados y los comentarios. Los usuarios con permiso de escritura pueden editar la tarea y guardar los cambios.
Las notificaciones se dividen en dos capas. Las alertas locales confirman acciones inmediatas, como la tarea creada, la asignación del usuario, la nota agregada, la actualización del propietario o la tarea actualizada. Las notificaciones persistentes se leen desde los puntos finales de notificación del backend y pueden dirigir al usuario a una tarea, pedido o lote.
Botones y acciones
| Acción | Qué hace |
|---|---|
Centro | Abre la vista de seguimiento diario con filtros pendientes, terminados y todos. |
Tablero | Abre la tabla de tareas y el flujo de trabajo de creación. |
Calendario | Abre la vista de planificación semanal para las tareas asignadas. |
Nueva tarea | Abre el flujo de creación de tareas. |
Crear tarea | Guarda una nueva tarea con propietario, prioridad, fecha de vencimiento y descripción. |
Editar tarea | Abre una tarea existente para cambios. |
Guardar cambios | Persiste las ediciones de tareas como estado, propietario, prioridad y fecha de vencimiento. |
Guardar nota | Agrega un comentario o nota de seguimiento al historial de tareas. |
Asignar | Agrega un usuario como asignado a una tarea. |
Cambiar | Cambia el propietario de la tarea. |
Quitar | Elimina un propietario o asignado del contexto de la tarea. |
Abrir pedido | Navega desde el detalle de la tarea al orden relacionado cuando la tarea está vinculada a uno. |
Buscar | Aplica los filtros visibles para acotar los registros mostrados en la página. |
Limpiar | Restablece los filtros para volver a la lista completa de trabajo. |
Crear ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Mapa de contenido
Parte superior
Encabezado de Tareas
Identifica la vista activa de la página: Centro de tareas, Tablero de tareas o Calendario de tareas.
Contenido visible
- Título de la vista actual.
- Banner de tenant demo cuando aplica.
- Ayuda de este flujo para abrir la guia contextual.
Acciones
- Usar el tour/ayuda para entender el flujo.
- Confirmar si se está en ambiente demo antes de reportar datos borrados o simulados.
Tarjeta de navegación de Tareas
Pestañas Centro, Tablero y Calendario
Selector de modo de trabajo. Cambia el parámetro view de la URL y renderiza el panel correcto.
Contenido visible
- Centro: seguimiento diario.
- Tablero: creación y búsqueda de tareas.
- Calendario: planificación semanal por persona.
Acciones
- Centro para actualizar tareas existentes.
- Tablero para crear tareas nuevas.
- Calendario para revisar carga y fechas.
Vista Centro
Centro de tareas
Lista de seguimiento personal y operativo. Es la vista por defecto cuando no hay view en la URL.
Contenido visible
- Contadores Pendiente y Listo.
- Filtros Pendiente, Listo y Todo.
- Tabla con Tarea, Estado, Prioridad y Asignados/Propietario cuando hay permiso.
- Orden relacionada debajo del título de cada tarea.
- Botón Notas para abrir historial y nuevo comentario.
Acciones
- Cambiar estado entre todo, en progreso y listo.
- Cambiar prioridad baja, media o alta.
- Usar Actualizar tarea para guardar status/prioridad.
- Asignar usuario, cambiar propietario o remover relacion.
- Abrir la tarea desde el título para ver detalle completo.
Vista Tablero
Tablero de tareas
Tabla operativa para buscar tareas y abrir la creación de trabajo nuevo.
Contenido visible
- DataGrid con título Tareas.
- Busqueda sobre id, título, descripción, estado, prioridad, owner, orden y fecha.
- Columnas Task, Status, Priority, Owner, Order y Due date.
- Paginacion de tareas.
Acciones
- Buscar una tarea por texto.
- Abrir Crear tarea.
- Abrir el detalle desde el título de la tarea.
Modal dentro de Tablero
Modal Crear tarea
Formulario donde se registra una tarea nueva y se conecta con orden, owner, fecha y usuarios asignados.
Contenido visible
- Title y Description.
- Priority y Status.
- Task type opcional.
- Owner opcional con avatar/resumen.
- Pedido relacionado requerido.
- Due date requerido.
- Tabla Asignar usuarios con usuario, email y roles.
Acciones
- Seleccionar uno o varios usuarios asignados.
- Guardar con Guardar cuando título, descripción y fecha están completos.
- Cancelar para cerrar sin crear.
Ruta /tasks/:id
Task detail
Vista profunda para revisar o editar una tarea especifica.
Contenido visible
- Task ID, status, priority, due date, created/updated.
- Descripcion completa.
- Pedido relacionado con estado, cliente y link Abrir pedido.
- People involved: owner, created by y assigned users.
- Task notes con historial y formulario para agregar nota.
Acciones
- Volver a tareas para volver a Centro o Tablero.
- Abrir pedido para ir a la orden relacionada.
- Editar tarea para cambiar campos.
- Guardar cambios para persistir cambios.
- Guardar nota para agregar comentario trazable.
Vista Calendario
Calendario de tareas
Vista visual para coordinar tareas por semana y persona asignada.
Contenido visible
- Calendario semanal de tareas asignadas.
- Filtro de equipo/personas cuando está disponible.
- Tareas ubicadas por fecha o bloque de planificacion.
Acciones
- Cambiar semana o fecha.
- Comparar carga entre personas.
- Abrir tareas desde la agenda cuando el calendario expone el enlace.
Campana / Activity panel
Panel de notificaciones
Centro lateral o global que muestra conteo y feed de notificaciones persistentes.
Contenido visible
- Contador de pendientes y total.
- Feed con título, mensaje y estado read/pending.
- Acciones Marcar como leida y Quitar de la lista.
Acciones
- Abrir una notificación con taskId para navegar a /tasks/:id.
- Marcar como leída.
- Ocultarla de la lista.
Notificaciones y alertas
| Notificación | Disparador | Dónde aparece | Resultado |
|---|---|---|---|
| Alerta local: tarea creada | El usuario guarda Crear tarea desde Tablero. | Toast temporal en la esquina superior; desaparece solo si no es error. | Se invalidan las queries tasks y my-tasks para refrescar Tablero y Centro. |
| Alerta local: asignar o remover usuario | El usuario usa Asignar o Quitar en Centro de tareas. | Toast temporal del frontend. | Se invalida my-tasks para que la tabla muestre el nuevo estado de responsables/asignados. |
| Alerta local: cambiar owner | El usuario selecciona owner y presiona Cambiar, o usa Quitar responsable. | Toast temporal del frontend. | Se refresca my-tasks para que Current owner cambie en la lista. |
| Alerta local: nota agregada | El usuario escribe una nota y presiona Guardar nota. | Toast temporal y seccion Task notes. | Se invalidan task-comments y, desde Centro, tambien my-tasks para refrescar historial y conteos. |
| Alerta local: tarea actualizada | El usuario guarda status/prioridad en Centro o Guardar cambios en Detalle. | Toast temporal del frontend. | Se refrescan my-tasks, tasks y task-detail según la vista; Centro tambien invalida notifications-feed y notification-counter. |
| Notificacion persistente: feed y contador | El backend publica una notificación asociada a metadata como eventType, taskId, salesOrderId o lotId. | NotificationFeedPanel y NotificationCenterPanel. | Si la metadata incluye taskId o eventType task_*, al abrirla navega a /tasks/:id; tambien puede navegar a Pedidos o Lotes. |
| Leer u ocultar notificación | El usuario presiona Marcar como leida, abre una notificación pendiente con destino, o usa Quitar de la lista. | Feed de notificaciones y contador. | Se invalidan notifications-feed y notification-counter para reflejar pendiente/leída/oculta. |
Ejemplos operativos
Ejemplo 1: soporte crea una tarea para revisar un pedido. Tareas permite verla en centro, cambiar estado, asignar responsable y dejar comentarios.
Ejemplo 2: si el equipo necesita planificacion visual, cambia a tablero. Si necesita fechas, cambia a calendario. Es la misma tarea vista desde distintas necesidades.
Ejemplo 3: desde Detalle de pedido se puede crear una tarea vinculada al pedido para que el seguimiento no quede perdido en mensajes externos.
Ejemplo 4: si una persona dice que no recibió aviso, revisa si hablamos de alerta local o notificación persistente. La alerta local confirma una acción propia; la notificación persistente viene del backend y aparece en el feed.
Ejemplo 5: si una notificación abre el lugar equivocado, revisa metadata: taskId debe llevar a /tasks/:id, salesOrderId a /orders/:id y lotId a la pantalla de lote.
Ejemplo 6: si una tarea aparece en Calendario pero no en Centro, revisa propietario/asignados, filtros Pendiente/Listo/Todo y la fecha dueAt.
Cómo se lee en el código
| Archivo | Qué hace |
|---|---|
frontend/src/pages/tasks/tasks.desktop.tsx | TasksDesktop decide entre centro, tablero y calendario usando query params y guided steps; si hay taskId, renderiza TaskDetallePanel. |
frontend/src/modules/tasks/components/my-tasks-panel.tsx | El centro de tareas gestiona seguimiento personal, filtros y comentarios. Es la vista para ejecucion diaria. |
frontend/src/modules/tasks/components/task-board-panel.tsx | El tablero muestra DataGrid, búsqueda, Crear tarea y el formulario con título, descripción, prioridad, estado, tipo de tarea, propietario, pedido relacionado, fecha de vencimiento y usuarios asignados. |
frontend/src/modules/tasks/components/task-detail-panel.tsx | TaskDetallePanel carga detalle, comentarios, usuarios, tipos y órdenes; permite editar campos, asignados y notas cuando el usuario tiene tasks:write. |
frontend/src/lib/api/endpoints/tasks.api.ts | Define los endpoints /tasks/mine, /tasks/create, /tasks/update, /tasks/assign-users, /tasks/change-owner, /tasks/comments y normaliza la data que usa la página. |
frontend/src/app/alert-center.tsx | AlertProvider crea alertas temporales con pushAlert/pushApiError. Las alertas success/info desaparecen después de 3 segundos; los errores quedan hasta que el usuario los cierre. |
frontend/src/modules/notifications/components/notification-feed-panel.tsx | NotificationFeedPanel lee /notifications/mine cada 5 segundos, resuelve destino por metadata y permite marcar como leída u ocultar. |
frontend/src/lib/api/endpoints/notifications.api.ts | Normaliza notificaciones desde /notifications/mine y contador desde /notifications/counter; extrae taskId, salesOrderId y lotId desde columnas o metadata. |