Skip to content

User Guide

Jump to bottom
Arturo Gomez edited this page May 25, 2026 · 4 revisions

Guía de Usuario — Kairo

Versión: v1.1.0  |  Fecha: 2026-05-25  |  Audiencia: Desarrolladores y Project Managers
Plataforma: Portal Web (navegador moderno) · Bot de Telegram · API REST
Compatibilidad: Chrome 110+, Firefox 110+, Safari 16+, Edge 110+

Tabla de contenidos

  1. ¿Qué es Kairo?
  2. Inicio rápido — tu primer proyecto en 5 minutos
  3. Requisitos previos
  4. Perfiles de usuario — ¿por dónde empiezo?
  5. Mapa de funcionalidades
  6. Guías paso a paso
  7. Convenciones de esta guía
  8. Glosario rápido
  9. Solución de problemas frecuentes
  10. Recursos y soporte

¿Qué es Kairo?

Kairo es un sistema de gestión de tareas y proyectos para equipos de desarrollo. Combina un portal web, un bot de Telegram (Chuva Bot) y una API REST para que los equipos planifiquen sprints, registren avances y midan su rendimiento — todo en un solo lugar.

Componente Para qué sirve
Portal Web Crear y gestionar proyectos, sprints, tareas y miembros desde el navegador
Chuva Bot Consultar y actualizar tareas directamente desde Telegram con comandos o lenguaje natural
API REST Integrar Kairo con herramientas externas o automatizar flujos

Inicio rápido — tu primer proyecto en 5 minutos

Sigue estos pasos para lograr tu primer resultado sin configuración avanzada.

Note

Este camino asume que ya tienes acceso al portal. Si no, pídele a tu manager que te agregue como miembro o crea una cuenta nueva en la pantalla de registro.

  1. Abre el portal web e inicia sesión con tu email y contraseña.
  2. En la pantalla Mis Proyectos, haz clic en Crear proyecto.
  3. Ingresa un nombre (ej. "Mi primer proyecto") y haz clic en Guardar.
  4. En la barra lateral, ve a Sprints → Crear sprint → define nombre y fechas → Guardar.
  5. Ve a Tareas → Nueva tarea → completa nombre, story points y asignado → Guardar.
  6. Regresa a Sprints y haz clic en Activar junto a tu sprint.

Resultado: tienes un proyecto activo con un sprint en marcha y una tarea asignada.

Tip

¿Quieres gestionar este sprint desde Telegram? Ve a Vincular Telegram y en 2 minutos tendrás todo en tu celular.

Requisitos previos

Acceso al sistema

Requisito Detalle
Cuenta registrada Email y contraseña creados en la pantalla de Registrarse
Rol asignado Manager (puede crear proyectos) o Miembro (accede a proyectos donde fue invitado)
Conexión a internet Requerida para el portal y el bot; no existe modo offline

Permisos por función

Acción Manager Miembro
Crear / eliminar proyectos ✅ ❌
Agregar / remover miembros ✅ ❌
Crear y cerrar sprints ✅ ❌
Crear y asignar tareas ✅ ✅
Actualizar estado de sus tareas ✅ ✅
Ver el dashboard ✅ ✅

Note

Los permisos son por proyecto. Un usuario puede ser Manager en un proyecto y Miembro en otro simultáneamente. Ver Permisos y Roles para el detalle completo.

Perfiles de usuario — ¿por dónde empiezo?

Soy nuevo y quiero registrarme y configurar mi primer proyecto

→ Empezando con Kairo — registro, primer proyecto, primer sprint.

Soy miembro del equipo y quiero gestionar mis tareas

→ Portal Web — sección "Tareas y Kanban".
→ Bot de Telegram — Chuva Bot — si prefieres operar desde Telegram.

Soy manager y quiero planificar y hacer seguimiento del equipo

→ Gestión de Sprints — ciclo de vida completo del sprint.
→ Dashboard y Métricas — interpretar los 9 widgets del dashboard.

Quiero entender el modelo conceptual antes de empezar

→ Conceptos Clave — proyectos, sprints, tareas, estados y reglas del sistema.

Necesito integrar Kairo con otra herramienta

→ Referencia de API — endpoints REST, autenticación y ejemplos.

Mapa de funcionalidades

Kairo
├── Portal Web
│   ├── Mis Proyectos         → crear, ver y acceder a proyectos
│   ├── Sprints               → planificar, activar y cerrar sprints
│   ├── Tareas / Kanban       → crear, asignar y mover tareas
│   ├── Backlog               → tareas sin sprint asignado
│   ├── Miembros              → gestionar el equipo del proyecto
│   ├── Dashboard             → métricas y gráficas del sprint
│   └── Perfil                → datos personales y configuración
├── Chuva Bot (Telegram)
│   ├── Consultar tareas      → /mytasks, /task <id>
│   ├── Actualizar estado     → /done <id>, /start <id>
│   └── Lenguaje natural      → "¿cuáles son mis tareas de hoy?"
└── API REST
    └── /api/v1               → endpoints para integraciones externas

Guías paso a paso

Crear y gestionar tu cuenta

  1. Ve al portal web y haz clic en Registrarse.
  2. Completa los campos:
    • Nombre completo — aparecerá en tareas y notificaciones
    • Email — es tu identificador permanente de acceso
    • Contraseña — mínimo 8 caracteres recomendado
  3. Haz clic en Crear cuenta.
  4. El sistema te redirige automáticamente a Mis Proyectos.

Warning

Las sesiones expiran después de 24 horas. Al expirar, serás redirigido al login automáticamente. Guarda tu trabajo antes de cerrar el navegador en sesiones largas.

Crear un proyecto

  1. En Mis Proyectos, haz clic en Crear proyecto.
  2. Ingresa:
    • Nombre del proyecto — nombre descriptivo visible para el equipo
    • Descripción (opcional) — contexto o objetivo del proyecto
  3. Haz clic en Guardar.

Quedarás asignado automáticamente como Manager del proyecto.

Caution

Eliminar un proyecto borra también todos sus sprints, tareas y métricas. Esta acción es irreversible.

Planificar un sprint

  1. Accede a tu proyecto y ve a Sprints en la barra lateral.
  2. Haz clic en Crear sprint.
  3. Completa:
    • Nombre del sprint — ej. "Sprint 3 — Autenticación"
    • Fecha de inicio y Fecha de fin
    • Objetivo (opcional pero recomendado)
  4. Haz clic en Guardar. El sprint se crea en estado PLANNING.
  5. Agrega tareas desde Tareas o Backlog asignándolas a este sprint.
  6. Cuando esté listo, regresa a Sprints y haz clic en Activar.

Note

Solo puede haber un sprint ACTIVE por proyecto a la vez. Activar uno nuevo requiere cerrar el anterior.

Gestionar tareas

  1. Ve a Tareas o al tablero Kanban del proyecto.
  2. Haz clic en Nueva tarea e ingresa:
    • Nombre — descripción concisa de la tarea
    • Story points — estimación de esfuerzo (campo obligatorio)
    • Prioridad — LOW, MEDIUM o HIGH
    • Asignado a — un miembro del proyecto
    • Sprint — el sprint al que pertenece
  3. Haz clic en Guardar.

Para actualizar el estado de una tarea:

Transición Significado
TODO → IN_PROGRESS Comenzaste a trabajar en ella
IN_PROGRESS → BLOCKED Estás bloqueado, necesitas ayuda
IN_PROGRESS → DONE Tarea completada

Warning

Al marcar una tarea como DONE, el sistema solicitará las horas reales trabajadas. Este dato es obligatorio y alimenta directamente las métricas del dashboard. No puede modificarse después de guardado.

Vincular tu cuenta con Telegram

  1. Abre Telegram y busca @ChuvaBot (o el alias configurado por tu equipo).
  2. Inicia una conversación privada con el bot.
  3. Envía el comando: 
    /login tu@email.com tuContraseña
  4. El bot responderá confirmando la vinculación.

A partir de este momento puedes usar todos los comandos del bot y recibirás notificaciones de sprints y tareas asignadas.

Caution

El comando /login transmite credenciales en texto plano. Úsalo exclusivamente en una conversación privada con el bot, nunca en grupos ni canales públicos de Telegram.

Exportar datos del dashboard como CSV

  1. Ve a Dashboard del proyecto.
  2. Selecciona el sprint en el selector de la parte superior.
  3. En cualquier gráfica (Efficiency, Hours by Developer, Tasks by Developer, Velocity, Workload Table), haz clic en el ícono de descarga ↓ CSV.
  4. El archivo se descargará automáticamente con el nombre de la gráfica y la fecha.

Note

La exportación incluye el dataset completo del sprint seleccionado, independientemente de los filtros activos en pantalla.

Convenciones de esta guía

Elemento Formato Ejemplo
Botones y elementos de la interfaz Negrita Haz clic en Guardar
Valores del sistema y estados código Estado DONE
Campos de formulario código Completa el campo Email
Teclas del teclado [Corchetes] Presiona [Enter] para confirmar
Rutas de navegación Negrita → Negrita Ve a Sprints → Crear sprint
Notas informativas > [!NOTE] Bloque azul en la página
Consejos opcionales > [!TIP] Bloque verde en la página
Advertencias importantes > [!WARNING] Bloque amarillo en la página
Acciones irreversibles > [!CAUTION] Bloque rojo en la página

Glosario rápido

Término Definición
Proyecto Espacio de trabajo que agrupa sprints, tareas y miembros
Sprint Período de trabajo acotado con tareas planificadas y una fecha de cierre
Backlog Lista de tareas creadas pero no asignadas a ningún sprint
Story points Unidad de estimación de esfuerzo de una tarea (número entero)
Manager Rol con permisos completos sobre el proyecto
Miembro Rol con acceso de lectura y edición de tareas propias
TODO Estado inicial de una tarea recién creada
IN_PROGRESS Tarea en la que se está trabajando activamente
BLOCKED Tarea bloqueada que requiere acción externa
DONE Tarea completada con horas reales registradas
PLANNING Estado de un sprint antes de ser activado
ACTIVE Sprint en curso (solo uno por proyecto)
CLOSED Sprint finalizado, en modo solo lectura
Chuva Bot Bot de Telegram integrado con Kairo para operar sin abrir el portal
Dashboard Vista de métricas y gráficas del sprint activo o cerrado

Para definiciones más detalladas, consulta Conceptos Clave.

Solución de problemas frecuentes

No puedo iniciar sesión

  • Verifica que el email no tenga espacios al final.
  • Las contraseñas distinguen mayúsculas y minúsculas.
  • Si tu sesión expiró (24 horas), cierra la pestaña y vuelve a abrir el portal.

No veo el proyecto de mi equipo

  • Pídele al Manager del proyecto que te agregue como miembro con tu email registrado.
  • Confirma que estás en la cuenta correcta (el email con el que te invitaron).

El bot de Telegram no responde

  • Revisa que enviaste el comando /login en una conversación privada con el bot.
  • Si el bot confirma el login pero no responde a comandos, intenta /start para reiniciar la sesión.

No puedo activar el sprint

  • Solo el Manager puede activar sprints.
  • Verifica que no haya otro sprint en estado ACTIVE en el mismo proyecto.

El dashboard no muestra datos

  • El dashboard solo carga datos de sprints con tareas en estado DONE que tengan horas reales registradas.
  • Selecciona un sprint diferente en el selector si el actual está vacío.

Para más casos, consulta Preguntas Frecuentes.

Recursos y soporte

Recurso Enlace
Guía de inicio rápido Empezando con Kairo
Modelo conceptual del sistema Conceptos Clave
Guía del portal web Portal Web
Gestión de sprints Gestión de Sprints
Bot de Telegram Bot de Telegram — Chuva Bot
Métricas y dashboard Dashboard y Métricas
Roles y permisos Permisos y Roles
Referencia de API Referencia de API
Preguntas frecuentes Preguntas Frecuentes
Historial de cambios Releases en GitHub

Kairo

Inicio
Guía de Usuario

Primeros pasos

Guías de uso

Infraestructura

Referencia

Clone this wiki locally