Skip to content

Portal Web

Arturo Gomez edited this page May 25, 2026 · 2 revisions

Portal Web

El portal web de Kairo es una aplicación React con diseño limpio y minimalista. Tiene una barra lateral fija a la izquierda y el contenido principal a la derecha. La navegación lateral cambia según el proyecto seleccionado.


Estructura de la interfaz

┌─────────────────┬──────────────────────────────────────┐
│   Barra lateral │   Contenido principal                │
│                 │                                      │
│  Kairo          │   (vista actual: tareas, sprints,    │
│                 │    dashboard, etc.)                  │
│  Mis Proyectos  │                                      │
│                 │                                      │
│  [Proyecto X]   │                                      │
│  > Tareas       │                                      │
│  > Sprints      │                                      │
│  > Backlog      │                                      │
│  > Miembros     │                                      │
│  > Dashboard    │                                      │
│                 │                                      │
│  [usuario]      │                                      │
└─────────────────┴──────────────────────────────────────┘
  • La sesión se mantiene en localStorage — al recargar la página no pierdes el acceso.
  • Al expirar el JWT (24 horas), el sistema te redirige automáticamente al login.

Mis Proyectos

Pantalla principal tras el login. Muestra todos los proyectos en los que participas:

  • Tarjetas de proyecto: nombre, estado del proyecto, tu rol (Manager / Miembro) y fecha de creación.
  • Crear proyecto: botón para iniciar un nuevo proyecto. Al crearlo, quedas como manager.

Al hacer clic en un proyecto, la barra lateral muestra las secciones de ese proyecto.


Tareas

Vista de las tareas del proyecto. Incluye dos modos de visualización:

Vista Kanban

Cuatro columnas, una por estado:

| TODO | IN_PROGRESS | BLOCKED | DONE |

Cada tarjeta muestra: nombre de la tarea, miembro asignado, story points y badge de prioridad.

Vista Lista / Tabla

Tabla con columnas ordenables y filtros:

Filtro Opciones
Estado TODO, IN_PROGRESS, BLOCKED, DONE
Sprint Cualquier sprint del proyecto
Asignado a Cualquier miembro
Prioridad LOW, MEDIUM, HIGH

Detalle de tarea

Al hacer clic en cualquier tarea (en Kanban o Lista) se abre el panel de detalle:

  • Todos los campos de la tarea (nombre, descripción, estado, prioridad, story points, asignado a, sprint)
  • Historial de actividad: comentarios, cambios de estado, movimientos entre sprints — en orden cronológico
  • Agregar comentario: campo de texto para dejar una nota en la tarea

💡 El historial de actividad es inmutable. Una vez registrado, no puede editarse ni borrarse.


Sprints

Lista todos los sprints del proyecto con sus estados y fechas. El sprint activo aparece destacado.

Acciones disponibles:

Acción Quién puede Cuándo
Crear sprint Manager Siempre
Activar sprint Manager Si no hay otro sprint ACTIVE
Cerrar sprint Manager Si el sprint está ACTIVE

Al hacer clic en un sprint puedes ver sus tareas, el objetivo, las fechas y un resumen de estadísticas.

⚠️ Un sprint cerrado no puede reabrirse. Las tareas en sprints cerrados son de solo lectura — la única operación permitida es moverlas a otro sprint o al backlog.


Backlog

Muestra las tareas del proyecto que no tienen sprint asignado. Desde aquí puedes:

  • Ver todas las tareas pendientes de planificación
  • Mover tareas al sprint activo o a cualquier sprint en PLANNING
  • Crear nuevas tareas directamente en el backlog

Miembros

Lista los integrantes del proyecto con nombre y email. El manager está identificado visualmente.

  • Agregar miembro: el manager puede agregar a cualquier usuario registrado en Kairo usando su email.
  • Remover miembro: el manager puede remover miembros en cualquier momento. Sus tareas asignadas permanecen, pero el usuario pierde acceso al proyecto.

⚠️ Solo el manager puede gestionar miembros. Los miembros regulares ven la lista pero no pueden modificarla.


Dashboard

Panel de métricas del proyecto. Disponible para todos los participantes. Contiene 8 widgets:

Widget Qué muestra
Sprint Summary Conteo de tareas y SP por estado en el sprint activo
Velocity SP completados por sprint en los últimos N sprints cerrados
Efficiency SP completados vs horas reales por miembro en el sprint activo
Completion Rate % de tareas DONE en el sprint activo
Avg Hours per SP Horas reales promedio por story point — calibración de estimaciones
Workload Matriz miembro × estado (toggle: conteo de tareas o story points)
Hours per Member Ranking de miembros por horas totales en tareas DONE
Blocked Alert Tareas actualmente bloqueadas con tiempo transcurrido
Backlog Summary Total de tareas y SP en el backlog, distribución por prioridad

Ver la descripción completa de cada widget en Dashboard y Métricas.


Perfil de usuario

Accesible desde la parte inferior de la barra lateral. Permite ver y editar tu nombre completo y email.

💡 Cambiar tu email actualiza también las credenciales de acceso al portal y al bot de Telegram.

Clone this wiki locally