Conceptos Clave

Conceptos Clave

Esta página explica los bloques fundamentales de Kairo. Entender estos conceptos te ayudará a aprovechar mejor el sistema y a interpretar las reglas de negocio que aplican en cada situación.

---

Proyecto

El proyecto es la entidad raíz. Todo en Kairo vive dentro de un proyecto: sprints, tareas y miembros.

• Al crear un proyecto, el creador se convierte automáticamente en su manager.
• Un proyecto puede estar en tres estados: ACTIVE, PAUSED, o CLOSED.
• Cerrar un proyecto cierra automáticamente todos sus sprints activos y en planificación.
• Las tareas en proyectos cerrados quedan como historial de solo lectura.

---

Sprint

Un sprint es un período de tiempo acotado dentro de un proyecto. Define las fechas de inicio y fin, y contiene las tareas que el equipo se compromete a completar en ese período.

Estados del sprint

PLANNING → ACTIVE → CLOSED

Estado	Descripción
PLANNING	Sprint en preparación. Se pueden agregar o quitar tareas libremente.
ACTIVE	Sprint en curso. Solo puede haber uno activo por proyecto al mismo tiempo.
CLOSED	Sprint finalizado. Sus tareas son de solo lectura (excepto moverlas a otro sprint).

⚠️ Un sprint en estado CLOSED no puede reabrirse. Si necesitas continuar trabajo, crea un nuevo sprint.

Ver detalles completos en Gestión de Sprints.

---

Backlog

El backlog es el conjunto de tareas del proyecto que no están asignadas a ningún sprint. Sirve como repositorio de trabajo pendiente o ideas por priorizar.

• Cualquier miembro puede ver el backlog.
• El manager puede mover tareas del backlog a un sprint (y viceversa).
• Las tareas del backlog no afectan las métricas del sprint activo.

---

Tarea

Una tarea es la unidad de trabajo dentro de un proyecto. Puede estar en el backlog o asignada a un sprint.

Estados de una tarea

TODO → IN_PROGRESS → DONE
            ↓
         BLOCKED

Estado	Descripción
TODO	Tarea pendiente de iniciar
IN_PROGRESS	En progreso por el miembro asignado
BLOCKED	Bloqueada — dispara notificación al manager automáticamente
DONE	Completada — requiere registrar horas reales trabajadas

⚠️ Al mover una tarea a DONE es obligatorio ingresar las horas reales trabajadas. Este dato es irreemplazable para calcular eficiencia y calibrar estimaciones futuras.

Campos de una tarea

Campo	Obligatorio	Descripción
Nombre	Sí	Descripción corta de la tarea
Story Points	Sí	Estimación de esfuerzo (número entero)
Estado	Sí	Empieza en TODO
Prioridad	No	LOW, MEDIUM, o HIGH
Asignado a	No	Miembro responsable (puede quedar sin asignar)
Sprint	No	Si es null, la tarea va al backlog
Horas reales	Solo al completar	Se registra al marcar como DONE

---

Story Points

Los story points son una estimación de esfuerzo relativo, no de tiempo. Un story point no equivale a una hora de trabajo — son una medida del equipo para comparar la complejidad relativa entre tareas.

• Son un campo obligatorio en todas las tareas.
• El sistema los usa para calcular velocidad, eficiencia y el burn-down del sprint.
• Con el tiempo, el widget Avg Hours per Story Point del dashboard te ayudará a calibrar tus estimaciones comparando los puntos estimados contra las horas reales.

---

Historial de actividad

Cada tarea tiene un historial de actividad inmutable que registra:

• Comentarios: mensajes de cualquier participante del proyecto
• Cambios de estado: quién cambió el estado y cuándo
• Cambios de sprint: si la tarea fue movida entre sprints

💡 El historial nunca se borra. Proporciona trazabilidad completa de lo que ocurrió con cada tarea a lo largo del tiempo.

---

Diagrama de relaciones

PROYECTO
  ├── SPRINT (PLANNING / ACTIVE / CLOSED)
  │     └── TAREA (TODO / IN_PROGRESS / BLOCKED / DONE)
  │           └── ACTIVIDAD (comentarios, cambios de estado, cambios de sprint)
  └── BACKLOG (tareas sin sprint)

PROYECTO
  ├── MANAGER (1 usuario)
  └── MIEMBROS (n usuarios)

---

Permisos resumidos

Los permisos en Kairo son por proyecto, no globales. Un mismo usuario puede ser manager en un proyecto y simple miembro en otro.

Rol	Quién es
Manager	El creador del proyecto (o quien recibió la transferencia)
Miembro	Cualquier usuario agregado al proyecto por el manager

Ver detalles completos en Permisos y Roles.