# Documentación técnica — Kanbo

Este archivo es un ejemplo de base de conocimiento técnica para un agente de IA de soporte. Kanbo es un producto ficticio (gestión de tareas y proyectos en tableros kanban) que usamos como caso de referencia.

Sustituye cada sección por la documentación real de tu producto — cuanto más específicos sean los pasos (nombres exactos de botones, menús, mensajes de error), menos veces el agente tendrá que decir "no tengo esa información disponible" o escalar innecesariamente.

## Cuenta y acceso

### No puedo iniciar sesión

1. Comprueba que el email es el mismo con el que te registraste (Kanbo distingue mayúsculas y minúsculas en el email, no en la contraseña).
2. Si olvidaste la contraseña, usa "¿Olvidaste tu contraseña?" en la pantalla de login — el enlace de restablecimiento llega en menos de 2 minutos.
3. Si usas login con Google o Microsoft y no funciona, revisa que no tengas bloqueadas las ventanas emergentes del navegador.
4. Si el problema persiste tras restablecer la contraseña, puede ser un bloqueo temporal de seguridad tras varios intentos fallidos (se libera automáticamente a los 15 minutos).

### El enlace de restablecimiento de contraseña no me llega

- Revisa la carpeta de spam/promociones.
- Los enlaces caducan a los 30 minutos — si tardaste más, solicita uno nuevo.
- Si tu email es corporativo, puede estar bloqueado por el filtro de la empresa; prueba con un email personal para confirmar.

### Quiero cambiar el email de mi cuenta

Desde Ajustes de cuenta → Perfil → Email, puedes cambiarlo tú mismo. Te llegará un correo de confirmación a la nueva dirección que debes validar en un plazo de 24 horas.

## Tableros y tareas

### Mis cambios no se guardan / no se sincronizan

1. Comprueba tu conexión a internet — Kanbo guarda en tiempo real y necesita conexión activa.
2. Revisa el icono de estado de sincronización en la esquina superior derecha del tablero: un punto naranja indica que hay cambios pendientes de sincronizar.
3. Si el punto naranja no desaparece en más de 1 minuto, recarga la página (los cambios ya guardados localmente no se pierden).
4. Si usas la app de escritorio, comprueba que tienes la última versión — Ajustes → Buscar actualizaciones.

### No veo un tablero que sí veo en el móvil (o al revés)

Los tableros archivados no aparecen en la app móvil, solo en la versión web. Revisa en la web si el tablero está en la sección "Archivados".

### No puedo mover una tarea de columna

Si la columna de destino tiene un límite de tareas configurado (WIP limit) y ya está al máximo, Kanbo bloquea el movimiento y muestra un aviso. El propietario del tablero puede ajustar el límite desde Configuración del tablero → Columnas.

### Borré una tarea por error

Las tareas borradas van a la Papelera del tablero (icono de papelera en la barra superior) y se pueden restaurar hasta 30 días después de borradas. Pasado ese plazo, no es posible recuperarlas.

## Integraciones

### La integración con Slack dejó de enviar notificaciones

1. Ve a Ajustes del tablero → Integraciones → Slack y comprueba que el estado sea "Conectado".
2. Si aparece "Token caducado", pulsa "Reconectar" y vuelve a autorizar el acceso desde Slack.
3. Confirma que el canal de Slack de destino no fue eliminado o renombrado — si lo fue, hay que volver a seleccionar el canal.

### ¿Con qué herramientas se integra Kanbo?

Integraciones nativas disponibles: Slack, Google Calendar, GitHub y Zapier (que a su vez conecta con cientos de herramientas adicionales). La integración con Microsoft Teams está en fase beta — disponible bajo petición.

### La integración con GitHub no vincula los commits a las tareas

El vínculo es automático si el mensaje del commit incluye el identificador de la tarea entre corchetes, por ejemplo `[KAN-124] Corrige el bug de sincronización`. Sin ese identificador, Kanbo no puede saber a qué tarea vincular el commit.

## Límites según el plan

| Función | Plan Free | Plan Pro | Plan Team |
|---------|-----------|----------|-----------|
| Tableros activos | 3 | Ilimitados | Ilimitados |
| Miembros por tablero | 3 | 10 | Ilimitados |
| Almacenamiento de adjuntos | 100 MB | 5 GB | 50 GB |
| Historial de actividad | 7 días | 90 días | Ilimitado |
| Integraciones | Solo Google Calendar | Todas | Todas + Teams beta |
| Automatizaciones por tablero | No disponible | 5 | Ilimitadas |

### Estoy en el límite de tableros del plan Free y no puedo crear uno nuevo

Puedes archivar un tablero existente que ya no uses activamente (Ajustes del tablero → Archivar), lo que libera el cupo sin borrar la información, o actualizar tu plan desde Ajustes de cuenta → Facturación.

### ¿Qué pasa con mis datos si bajo de plan?

Los datos no se borran. Si al bajar de plan superas algún límite (por ejemplo, tienes más tableros activos de los que permite el nuevo plan), Kanbo no borra nada automáticamente, pero archiva por ti los tableros más antiguos hasta ajustarse al nuevo límite — puedes elegir manualmente cuáles antes de que eso ocurra, desde el aviso que se muestra al cambiar de plan.

## Rendimiento y errores generales

### La aplicación va lenta con tableros muy grandes

Los tableros con más de 500 tareas activas pueden ir más lentos, especialmente con muchos adjuntos. Recomendamos archivar tareas completadas periódicamente (Ajustes del tablero → Archivar tareas completadas hace más de X días, configurable).

### Veo el error "Error 502" o "No se pudo conectar con el servidor"

Suele ser un problema temporal de nuestros servidores. Comprueba el estado del servicio en status.kanbo-ejemplo.com. Si el estado es "Operativo" y el error persiste solo para ti, puede ser un problema de red local o proxy corporativo.

### Exporté un tablero a CSV y faltan columnas

La exportación a CSV solo incluye campos estándar (título, estado, responsable, fecha límite). Los campos personalizados requieren exportar a Excel (.xlsx) en su lugar, disponible desde el mismo menú de exportación.

## Cuándo escalar a soporte humano

El agente debe escalar con `human_transfer` cuando:

- El usuario reporta pérdida de datos que no se explica por el comportamiento documentado aquí.
- El problema afecta a facturación real (cobros duplicados, reembolsos).
- Sospecha de una cuenta comprometida o acceso no autorizado.
- El problema técnico no está cubierto por esta documentación ni se resuelve con los pasos indicados.