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 Tasks 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
When a task cannot be reassigned or a comment is missing, include the task id and whether the center, board, calendar, or detail view was open.
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.
Board 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 |
|---|---|
Center | Abre la vista de seguimiento diario con filtros pendientes, terminados y todos. |
Board | Abre la tabla de tareas y el flujo de trabajo de creación. |
Calendar | Abre la vista de planificación semanal para las tareas asignadas. |
New task | Abre el flujo de creación de tareas. |
Create task | Guarda una nueva tarea con propietario, prioridad, fecha de vencimiento y descripción. |
Edit task | Abre una tarea existente para cambios. |
Save changes | Persiste las ediciones de tareas como estado, propietario, prioridad y fecha de vencimiento. |
Save note | Agrega un comentario o nota de seguimiento al historial de tareas. |
Assign | Agrega un usuario como asignado a una tarea. |
Change | Cambia el propietario de la tarea. |
Remove | Elimina un propietario o asignado del contexto de la tarea. |
Open order | Navega desde el detalle de la tarea al orden relacionado cuando la tarea está vinculada a uno. |
Search | Applies the visible filters to narrow the records shown on the page. |
Clear | Resets filters so the user can return to the full working list. |
Create Ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Mapa de contenido
Parte superior
Encabezado de Tasks
Identifica la vista activa de la página: Task center, Task board o Task calendar.
Contenido visible
- Título de la vista actual.
- Banner de tenant demo cuando aplica.
- Help for this flow 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 Tasks
Tabs Center, Board y Calendar
Selector de modo de trabajo. Cambia el query param view y renderiza el panel correcto.
Contenido visible
- Center: seguimiento diario.
- Board: creación y búsqueda de tareas.
- Calendar: planificacion semanal por persona.
Acciones
- Center para actualizar tareas existentes.
- Board para crear tareas nuevas.
- Calendar para revisar carga y fechas.
Vista Center
Task center
Lista de seguimiento personal y operativo. Es la vista por defecto cuando no hay view en la URL.
Contenido visible
- Contadores Pending y Done.
- Filtros Pending, Done y All.
- Tabla con Task, Status, Priority y Assignees/Owner cuando hay permiso.
- Orden relacionada debajo del título de cada tarea.
- Boton Notes para abrir historial y nuevo comentario.
Acciones
- Cambiar status entre todo, in_progress y done.
- Cambiar prioridad low, medium o high.
- Usar Update task para guardar status/prioridad.
- Asignar usuario, cambiar owner o remover relacion.
- Abrir la tarea desde el título para ver detalle completo.
Vista Board
Task board
Tabla operativa para buscar tareas y abrir la creación de trabajo nuevo.
Contenido visible
- DataGrid con título Tasks.
- 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 Create task.
- Abrir el detalle desde el título de la tarea.
Modal dentro de Board
Create task modal
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.
- Related order requerido.
- Due date requerido.
- Tabla Assign users con usuario, email y roles.
Acciones
- Seleccionar uno o varios usuarios asignados.
- Guardar con Save 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.
- Related order con estado, cliente y link Open order.
- People involved: owner, created by y assigned users.
- Task notes con historial y formulario para agregar nota.
Acciones
- Back to tasks para volver a Center o Board.
- Open order para ir a la orden relacionada.
- Edit task para cambiar campos.
- Save changes para persistir cambios.
- Save note para agregar comentario trazable.
Vista Calendar
Task calendar
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 Mark read y Remove from list.
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 Create task desde Board. | Toast temporal en la esquina superior; desaparece solo si no es error. | Se invalidan las queries tasks y my-tasks para refrescar Board y Center. |
| Alerta local: asignar o remover usuario | El usuario usa Assign o Remove en Task center. | 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 Change, o usa Remove owner. | 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 Save note. | Toast temporal y seccion Task notes. | Se invalidan task-comments y, desde Center, tambien my-tasks para refrescar historial y conteos. |
| Alerta local: tarea actualizada | El usuario guarda status/prioridad en Center o Save changes en Detail. | Toast temporal del frontend. | Se refrescan my-tasks, tasks y task-detail según la vista; Center 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 Orders o Lots. |
| Leer u ocultar notificación | El usuario presiona Mark read, abre una notificación pendiente con destino, o usa Remove from list. | 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. Tasks permite verla en centro, cambiar estado, asignar responsable y dejar comentarios.
Ejemplo 2: si el equipo necesita planificacion visual, cambia a board. Si necesita fechas, cambia a calendar. Es la misma tarea vista desde distintas necesidades.
Ejemplo 3: desde Order Detail 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 Calendar pero no en Center, revisa owner/asignados, filtros Pending/Done/All 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 center, board y calendar usando query params y guided steps; si hay taskId, renderiza TaskDetailPanel. |
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, Create task y el formulario con title, description, priority, status, taskType, owner, related order, due date y assigned users. |
frontend/src/modules/tasks/components/task-detail-panel.tsx | TaskDetailPanel 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. |