Inicio

Primeros pasos

InRoots es un contenedor que escucha el chat que el equipo ya usa, analiza una línea al día por persona y la convierte en horas, objetivos, coaching y una puntuación explicable. Esta página lleva desde cero hasta el primer check-in.

Qué hace falta

  • Un servidor Linux: el instalador está pensado para Debian 12 o posterior y Ubuntu 22.04 o posterior. El producto se ejecuta como una única imagen Docker.
  • Un canal de chat: un servidor Matrix (K9 Chat es un cliente Matrix) con una cuenta de bot dedicada y su token de acceso, o un espacio de trabajo de Slack, o un tenant de Microsoft Teams con un registro de bot en Azure.
  • Una base de datos: SQLite es la opción por defecto y no necesita nada; para despliegues en varios servidores, el producto puede apuntar a Postgres.
  • Una clave de proveedor de IA, o un Ollama local para instalaciones aisladas de la red (con las respuestas habladas desactivadas). La puntuación nunca necesita la IA; el asistente, los resúmenes y el coaching sí.
  • Un proxy inverso (Nginx o Caddy) que termine TLS delante del contenedor.

Instalar

Copiar la versión al servidor, ejecutar el instalador como root, editar el archivo de entorno que crea y arrancar la pila.

  • Un arranque limpio registra qué salas de standup y de permisos escucha el bot y que la compilación del front-end está presente.
  • El primer administrador es la cuenta indicada en BOOTSTRAP_ADMIN_MATRIX_ID; se promociona automáticamente al arrancar.
  • Los cambios de esquema son aditivos y se ejecutan en cada arranque, así que una actualización es un pull y un reinicio.
sudo bash install.sh
sudo nano /opt/inroots/.env
cd /opt/inroots && sudo docker compose up -d
sudo docker compose logs -f

Conectar el chat

En Matrix, el bot se une a las salas que se le asignan: una sala de standup por equipo y, opcionalmente, una sala de permisos, una sala de urgencias y una sala de administración. Los mensajes directos entre el bot y cada persona están cifrados de extremo a extremo, y una auditoría al arrancar activa el cifrado en cualquier sala de mensajes directos antigua que no lo tenga.

  • Los espacios de trabajo de Slack se añaden mediante una instalación OAuth; cada espacio guarda su propio token de bot, cifrado en reposo.
  • Los tenants de Teams registran su propio bot en Azure y pegan las credenciales; se genera un paquete de manifiesto listo para subir.
  • Más adelante pueden crearse identidades de bot adicionales (perfiles) y asignarse a salas de forma individual; cada una conserva sus propias claves de cifrado.
MATRIX_HOMESERVER=https://chat.example.com
MATRIX_USER_ID=@inroots:example.com
MATRIX_ACCESS_TOKEN=...
MATRIX_STANDUP_ROOM_ID=!room:example.com

Iniciar sesión en el panel

Por defecto no hay contraseñas. Se introduce el ID de chat en la página de inicio de sesión, el bot envía un código de seis dígitos por mensaje directo y se escribe en el formulario. Los códigos caducan a los cinco minutos, tres intentos fallidos bloquean la cuenta durante quince minutos, y una opción de dispositivo de confianza omite el código en un dispositivo de uso habitual.

Configurar un equipo

  • Días laborables: un selector de siete días por equipo (una semana de domingo a jueves está totalmente admitida). Sin definir, cuentan todos los días.
  • Hora límite y margen de inicio de jornada, o el interruptor de inicio flexible que evalúa solo por horas.
  • Horas esperadas por día, y horas semanales por empleado para quienes trabajan a tiempo parcial.
  • Un calendario de festivos por equipo, generado sin conexión a partir de un país y una región, más una lista para toda la organización.
  • Una sala de gerentes para escalados y, si se desea, pings de disponibilidad.

Elegir un proveedor de IA

En la página de Proveedores se pega una clave de cualquiera de los dieciséis proveedores admitidos y se elige el activo. Si el texto de los standups nunca debe salir de la red, se configura en su lugar un endpoint de Ollama. La cadena de conmutación por error y el presupuesto diario de llamadas se configuran en la misma página; los detalles están en Proveedores de IA y en Costo y privacidad de la IA.

El primer check-in

Basta con que alguien publique esto en la sala de standup. El bot lo confirma en la sala, registra la hora de inicio de jornada, extrae las tareas y el bloqueo, y arranca el día.

  • Al final del día la persona publica el cierre de jornada. Las horas son la diferencia, corregida según lo que el día muestra realmente.
  • Cualquiera puede escribir /pulse me en el chat para ver su propia tarjeta de puntuación desde la primera semana.
Yesterday:
- shipped the export fix
Today:
- invoice PDF rendering
Issues: NPs