Tablero Kanban de Tareas
El Tablero Kanban es una vista visual alternativa a la lista de tareas del CRM. Presenta las tareas como tarjetas distribuidas en columnas que representan cada estado del flujo de trabajo, lo que permite ver de un vistazo en qué etapa se encuentra cada actividad y moverlas entre estados simplemente arrastrando y soltando.
Ruta en el sistema: CRM > Tareas > Kanban
Estructura del Tablero
Columnas
Cada columna del tablero corresponde a un Estado de Tarea configurado en su empresa. Las columnas se ordenan de izquierda a derecha según el campo Orden de cada estado y, en caso de empate, por nombre alfabético.
[ Pendiente ] [ En Progreso ] [ En Revisión ] [ Esperando Resp. ]
| | | |
[ Tarea A ] [ Tarea C ] [ Tarea E ] [ Tarea G ]
[ Tarea B ] [ Tarea D ] [ Tarea H ]
Las columnas no están fijas en el sistema. Se generan a partir de los estados activos configurados en CRM > Tareas > Estados de Tareas. Si agrega, modifica o desactiva un estado, el tablero se actualiza automáticamente.
Los estados cuyo nombre contiene las palabras "completada", "cancelada", "finaliz", "termin", "done" o "finished" se consideran estados terminales. Las tareas en estos estados quedan excluidas del tablero para mantenerlo enfocado en el trabajo activo.
Para reorganizar las columnas del tablero, vaya a CRM > Tareas > Estados de Tareas y ajuste el campo Orden de cada estado. Los cambios se reflejan de inmediato en el Kanban.
Tarjetas de Tarea
Cada tarea se representa como una tarjeta dentro de la columna que corresponde a su estado actual. Las tarjetas muestran la información más relevante a simple vista.
Elementos de la Tarjeta
| Elemento | Descripción |
|---|---|
| Título | Nombre de la tarea, truncado a dos líneas. Si el título es largo, puede ver el texto completo editando la tarea |
| Badge de Prioridad | Indicador de color en la esquina superior derecha (ver tabla de prioridades) |
| Descripción | Texto descriptivo, truncado a 80 caracteres para no sobrecargar la vista |
| Cliente | Nombre del cliente vinculado, precedido de un icono de empresa. Solo visible si la tarea tiene un cliente asignado |
| Tipo de Tarea | Etiqueta con el color e icono configurado en el tipo (ej: icono de teléfono para "Llamada", sobre para "Correo") |
| Fecha de Vencimiento | Fecha límite de la tarea. Aparece en rojo si la fecha ya pasó (tarea vencida) |
| Avatar del Responsable | Círculo con las iniciales del usuario asignado sobre fondo azul corporativo (#004AAD) |
Prioridades
| Nivel | Valor | Color del Badge | Cuándo usarlo |
|---|---|---|---|
| Alta | 3 o superior | Rojo | Tareas urgentes que requieren atención inmediata |
| Media | 2 | Amarillo | Tareas importantes pero no urgentes |
| Baja | 1 | Azul | Tareas de seguimiento o baja urgencia |
Filtros del Tablero
La barra superior del Kanban ofrece filtros para acotar las tarjetas visibles. Los filtros se aplican en tiempo real: al cambiar cualquier valor, el tablero se recarga con las tareas que cumplan los criterios seleccionados.
Filtros Disponibles
| Filtro | Valor por Defecto | Descripción |
|---|---|---|
| Rango de Vencimiento | Este mes | Filtra las tareas según su fecha de vencimiento |
| Rango de Creación | Sin filtro | Filtra por la fecha en que se creó la tarea |
| Asignado a | Usuario actual | Muestra solo las tareas del usuario seleccionado |
| Cliente | Sin filtro | Muestra solo las tareas vinculadas al cliente seleccionado |
| Estado | Sin filtro | Muestra solo la columna del estado seleccionado |
Opciones de Rango de Vencimiento
| Opción | Descripción |
|---|---|
| Hoy | Tareas que vencen hoy |
| Mañana | Tareas que vencen mañana |
| Esta semana | Tareas con vencimiento en la semana actual |
| Próximo mes | Tareas con vencimiento el mes siguiente |
| Vencidas | Tareas cuya fecha de vencimiento ya pasó |
| Sin fecha | Tareas que no tienen fecha de vencimiento asignada |
Al entrar al Kanban, el filtro de vencimiento se establece automáticamente en Este mes y el filtro de usuario en el usuario actualmente conectado. Esto asegura que cada miembro del equipo vea su propio trabajo pendiente del mes sin necesidad de configurar nada.
Arrastrar y Soltar (Drag & Drop)
La función principal del tablero Kanban es la capacidad de mover tareas entre columnas sin necesidad de abrir el formulario de edición.
Cómo Mover una Tarea
- Haga clic sostenido sobre cualquier tarjeta de tarea
- Arrastre la tarjeta hacia la columna de destino
- Suelte la tarjeta cuando la columna de destino esté resaltada
- El sistema actualiza el estado de la tarea automáticamente
Retroalimentación Visual Durante el Arrastre
El tablero proporciona señales visuales que confirman que la operación se está realizando correctamente:
| Elemento | Cambio Visual | Significado |
|---|---|---|
| Tarjeta arrastrada | Se vuelve semitransparente | Indica que la tarjeta está en movimiento |
| Columna de destino | Fondo azul claro con borde punteado | Indica que puede soltar la tarjeta en esta columna |
| Otras columnas | Sin cambio | No son destinos activos en ese momento |
Actualización Optimista
El tablero utiliza una estrategia de actualización optimista para ofrecer una experiencia fluida:
- Al soltar la tarjeta, el cambio se refleja de inmediato en la pantalla (sin esperar la respuesta del servidor)
- En segundo plano, se envía la actualización al servidor mediante
PUT api/tasks/status - Si la actualización en el servidor es exitosa, el cambio queda confirmado
- Si el servidor devuelve un error, el tablero revierte automáticamente la tarjeta a su columna original y muestra un mensaje de error
Si ve que una tarjeta regresa a su columna original después de soltarla, significa que hubo un error al guardar el cambio en el servidor. Verifique su conexión a internet y vuelva a intentarlo. Si el error persiste, contacte a soporte técnico.
Tareas Excluidas del Kanban
No todas las tareas del sistema aparecen en el tablero Kanban. Se excluyen automáticamente:
- Tareas con fecha de completado registrada — Si la tarea tiene el campo
CompletedDateestablecido, no se muestra en el Kanban - Tareas en estados terminales — Aquellos estados cuyo nombre incluye las palabras:
| Palabra Clave | Ejemplos de Nombre de Estado |
|---|---|
completada | "Completada", "Tarea Completada" |
cancelada | "Cancelada", "Solicitud Cancelada" |
finaliz | "Finalizada", "Finalizado" |
termin | "Terminada", "Terminado" |
done | "Done", "Task Done" |
finished | "Finished" |
Estas tareas permanecen accesibles desde la vista de lista en CRM > Tareas, donde puede consultar el historial completo incluyendo las tareas cerradas.
El Kanban está diseñado para mostrar el trabajo activo. Las tareas finalizadas o canceladas saturarían el tablero y dificultarían el seguimiento de lo que realmente está en progreso. Si necesita ver tareas cerradas, utilice la vista de lista.
Relación con Otras Vistas y Configuraciones
El tablero Kanban es parte del ecosistema de gestión de tareas del CRM. Todas las vistas comparten los mismos datos; el Kanban es simplemente una presentación diferente de la misma información.
Páginas Relacionadas
| Página | Ruta | Descripción |
|---|---|---|
| Tareas (Vista Lista) | /crm/tasks | Vista de grilla con dashboard, filtros avanzados, comentarios y adjuntos |
| Tablero Kanban | /crm/tasks/kanban | Esta página — vista visual con arrastrar y soltar |
| Estados de Tareas | /crm/taskstatuses | Configura las columnas del Kanban |
| Tipos de Tareas | /crm/tasktypes | Configura los tipos con colores e íconos que aparecen en las tarjetas |
Cómo se Relacionan
graph LR
A[Estados de Tareas\n/crm/taskstatuses] -->|Define columnas| B[Tablero Kanban\n/crm/tasks/kanban]
C[Tipos de Tareas\n/crm/tasktypes] -->|Define etiquetas| B
D[Tareas\n/crm/tasks] -->|Misma data, vista grilla| B
B -->|Actualiza estado vía drag & drop| D
Referencia Técnica de la API
Esta sección es de referencia para administradores de sistema e integradores.
Endpoints Utilizados
| Método | Endpoint | Descripción |
|---|---|---|
GET | api/tasks/statuses | Obtiene los estados activos de la empresa, ordenados por Order y luego por Name |
GET | api/tasks/bycompany | Obtiene las tareas activas de la empresa (sin CompletedDate y sin estados terminales) |
PUT | api/tasks/status | Actualiza el estado de una tarea al soltar una tarjeta en una nueva columna |
GET | api/companyusers/company/{companyId} | Obtiene los usuarios de la empresa para el filtro de asignado |
GET | api/customers/bycompany | Obtiene los clientes activos para el filtro de cliente |
DTO de Actualización de Estado
Al arrastrar una tarjeta de una columna a otra, el sistema envía la siguiente estructura al endpoint PUT api/tasks/status:
{
"taskId": 1042,
"newStatusId": 5
}
| Campo | Tipo | Descripción |
|---|---|---|
taskId | int | Identificador único de la tarea que se movió |
newStatusId | int | Identificador del estado de destino (la columna donde se soltó) |
Entidades Principales
Task (Tarea)
| Campo | Tipo | Descripción |
|---|---|---|
Id | int | Identificador único |
CompanyId | int | Empresa propietaria (aislamiento multi-empresa) |
Title | string | Título de la tarea |
Description | string | Descripción detallada |
DueDate | DateTime? | Fecha de vencimiento (opcional) |
CreatedDate | DateTime | Fecha de creación |
CompletedDate | DateTime? | Fecha de completado; si tiene valor, se excluye del Kanban |
StatusId | int | FK al estado actual (define en qué columna aparece) |
TypeId | int | FK al tipo de tarea |
CustomerId | int? | FK al cliente vinculado (opcional) |
UserId | string | FK al usuario asignado |
Priority | int | Prioridad numérica (1=Baja, 2=Media, 3+=Alta) |
IsActive | bool | Si la tarea está activa |
IsRecurring | bool | Si es una tarea recurrente |
TaskStatus (Estado de Tarea)
| Campo | Tipo | Descripción |
|---|---|---|
Id | int | Identificador único |
CompanyId | int | Empresa propietaria |
Name | string | Nombre del estado (aparece como encabezado de columna en el Kanban) |
Color | string | Color en formato hexadecimal (ej: #3B82F6) usado en el encabezado de columna |
Order | int | Posición de la columna de izquierda a derecha |
IsActive | bool | Si el estado está disponible; los inactivos no aparecen en el Kanban |
TaskType (Tipo de Tarea)
| Campo | Tipo | Descripción |
|---|---|---|
Id | int | Identificador único |
CompanyId | int | Empresa propietaria |
Name | string | Nombre del tipo (ej: "Reunión", "Llamada") |
Color | string | Color hexadecimal de la etiqueta en la tarjeta |
Icon | string | Clase de icono FontAwesome (ej: fa-phone, fa-envelope) |
Order | int | Orden en listas desplegables |
IsActive | bool | Si el tipo está disponible |
Buenas Prácticas
- Use el Kanban para la gestión diaria — Abra el tablero al inicio del día para revisar qué tareas tiene asignadas este mes y moverlas según avance
- Mueva las tarjetas en tiempo real — No espere al final del día para actualizar los estados; mueva las tarjetas a medida que completa actividades para que el equipo vea el progreso al instante
- Combine con la vista de lista — Use el Kanban para mover tareas rápidamente y la vista de lista para ver historial, comentarios y adjuntos detallados
- Configure bien los estados — El valor del Kanban depende de tener estados significativos y ordenados. Defina un flujo claro en Estados de Tareas antes de usar el tablero
- Aproveche los filtros por usuario — En reuniones de equipo, puede cambiar el filtro "Asignado a" para revisar la carga de trabajo de cada miembro sin salir del tablero
- Identifique cuellos de botella — Si una columna acumula muchas tarjetas, es una señal de que ese estado del proceso necesita atención. Use esta información para redistribuir trabajo
- Limite el trabajo en progreso — Una buena práctica de Kanban es no tener demasiadas tareas simultáneas en "En Progreso". Si ve que una columna se satura, priorice completar antes de iniciar nuevas tareas
Preguntas Frecuentes
¿Por qué no veo algunas tareas en el tablero? Las tareas pueden estar ocultas si: (a) tienen una fecha de completado registrada, (b) su estado contiene palabras como "completada" o "cancelada", o (c) no cumplen con los filtros activos. Revise los filtros en la barra superior o consulte la vista de lista para ver todas las tareas.
¿Puedo tener más de una tarea en la misma columna? Sí, no hay límite de tarjetas por columna. Las tarjetas se apilan verticalmente dentro de cada columna.
¿El orden de las tarjetas dentro de una columna tiene significado? Las tarjetas dentro de cada columna se ordenan por fecha de creación (más recientes primero). Por ahora no se puede reordenar manualmente dentro de una columna.
¿Qué pasa si muevo una tarea a una columna y el cambio no se guarda? Si hay un error de conexión, la tarjeta regresará automáticamente a su columna original y verá un mensaje de error en pantalla. Esto garantiza que el tablero siempre refleje el estado real guardado en la base de datos.
¿Puedo editar una tarea directamente desde el Kanban? Actualmente, para editar los detalles completos de una tarea (descripción, adjuntos, comentarios, etc.) debe ir a la vista de lista y usar el botón de editar. Desde el Kanban solo puede cambiar el estado mediante arrastrar y soltar.
¿Los cambios hechos en el Kanban se reflejan en la vista de lista? Sí, ambas vistas muestran los mismos datos. Un cambio de estado hecho en el Kanban se verá reflejado de inmediato al visitar la vista de lista.