-
Notifications
You must be signed in to change notification settings - Fork 0
Preguntas Frecuentes
¿Mi sesión expira? Sí. El token JWT dura 24 horas. Al expirar, el portal web te redirige automáticamente al login. Tus datos no se pierden — solo debes volver a autenticarte.
¿Puedo recuperar mi contraseña si la olvidé? Actualmente no hay un flujo de recuperación de contraseña en el portal. Contacta a un administrador del sistema para que te asigne una nueva contraseña.
¿Puedo cambiar mi email o nombre? Sí. Ve a Perfil (parte inferior de la barra lateral) y edita tu nombre o email. Si cambias el email, úsalo en el próximo login.
¿Puedo tener varias cuentas? No se bloquea técnicamente, pero cada cuenta de Telegram solo puede vincularse con una cuenta de Kairo.
¿Puedo tener tareas sin sprint? Sí. Las tareas sin sprint asignado forman el backlog del proyecto. Puedes crear tareas directamente en el backlog y planificarlas para futuros sprints.
¿Qué pasa con las tareas incompletas cuando cierro un sprint? Las tareas quedan en el sprint cerrado como historial de solo lectura. Si quieres continuar trabajando en ellas, muévelas al siguiente sprint o al backlog antes o después de cerrar.
¿Se puede reabrir un sprint cerrado?
No. Un sprint CLOSED no puede volver a ACTIVE o PLANNING. Esta restricción existe para proteger la integridad de las métricas históricas. Si necesitas continuar el trabajo, crea un nuevo sprint.
¿Qué son los story points y cómo los uso? Los story points son una estimación del esfuerzo relativo de una tarea, no del tiempo en horas. Un punto no equivale a una hora — son una medida interna del equipo para comparar la complejidad entre tareas. Con el tiempo, el widget Avg Hours per Story Point del dashboard te ayudará a entender cuántas horas reales corresponden a cada punto estimado en tu equipo.
¿Puedo eliminar un proyecto con sprints activos?
Al intentar cerrar un proyecto con sprints activos, el sistema muestra una advertencia con el conteo de sprints y tareas afectadas. Debes confirmar la acción. Al confirmar, todos los sprints PLANNING y ACTIVE se cierran automáticamente.
¿Los cambios desde el bot de Telegram se reflejan en el portal web? Sí, inmediatamente. El bot y el portal comparten la misma base de datos y lógica de negocio. Cualquier cambio en uno se ve en el otro en tiempo real.
¿Por qué no puedo editar una tarea en un sprint cerrado?
Las tareas en sprints CLOSED son de solo lectura para preservar la trazabilidad histórica. La única operación permitida es moverlas a otro sprint o al backlog.
¿Quién puede cambiar el estado de una tarea? El manager del proyecto puede cambiar el estado de cualquier tarea. Un miembro solo puede cambiar el estado de las tareas que tiene asignadas.
¿El bot no responde mis mensajes en lenguaje natural. ¿Qué ocurre?
El NLU (procesamiento de lenguaje natural) requiere que el servidor tenga configurada la variable ANTHROPIC_API_KEY. Si no está configurada, los mensajes sin / reciben una respuesta genérica. Los comandos con / siempre funcionan independientemente.
¿Puedo desvincular mi cuenta de Telegram? No hay un comando de desvinculación en la versión actual. Para desvincular tu cuenta, contacta a un administrador del sistema.
No recibo notificaciones del sprint aunque mi cuenta está vinculada. ¿Por qué? Las posibles causas son:
- La variable
TELEGRAM_BOT_TOKENno está configurada en el servidor (el bot no está activo) - La entrega de la notificación falló — el sistema la reintentará automáticamente al día siguiente
- El sprint todavía tiene más de 3 días para vencer (las notificaciones se envían cuando quedan ≤ 3 días)
¿El comando /login es seguro?
Úsalo solo en una conversación privada con el bot, nunca en grupos o canales. El bot elimina los mensajes de credenciales de su historial cuando es posible. En versiones futuras se reemplazará por un token de vinculación más seguro.
¿Puedo usar el bot desde un grupo de Telegram? El bot está diseñado para conversaciones privadas. Su uso en grupos no está soportado oficialmente en la versión actual.
¿Por qué el dashboard está vacío o muestra "sin datos"?
El dashboard requiere que el proyecto tenga un sprint activo. Si no hay sprint en estado ACTIVE, los widgets de sprint summary, efficiency y completion rate no tienen datos que mostrar. El backlog summary sí muestra datos independientemente del sprint.
¿El gráfico de velocidad incluye el sprint activo?
No. El gráfico de velocidad solo incluye sprints en estado CLOSED. El sprint activo se muestra en el widget de Sprint Summary.
¿Por qué el widget de eficiencia muestra datos incompletos?
El widget de eficiencia se basa en el campo actual_hours de las tareas DONE. Si algunas tareas fueron marcadas como DONE sin registrar horas (lo que no debería ocurrir con las validaciones actuales), esos datos no aparecen en el cálculo.
Agregué a un usuario pero no puede ver el proyecto. ¿Qué ocurre? Verifica que el usuario esté usando la cuenta correcta (el email con el que fue agregado). Si el email es correcto y el problema persiste, el usuario puede cerrar sesión y volver a entrar para refrescar su lista de proyectos.
¿Puedo tener dos managers en un proyecto? No. Cada proyecto tiene exactamente un manager. Si necesitas que otro usuario tenga permisos de manager, usa la función Transferir ownership — el manager actual cede el rol y pasa a ser miembro.
¿Qué pasa con las tareas de un miembro cuando lo remuevo del proyecto? Las tareas permanecen en el proyecto y siguen asignadas a ese usuario en los registros, pero el usuario pierde acceso al proyecto de inmediato. El manager deberá reasignar las tareas si es necesario continuar con ellas.