Démarrer

Prise en main

InRoots est un conteneur unique qui écoute la messagerie que votre équipe utilise déjà, analyse une ligne par jour et par personne, et la transforme en heures, objectifs, coaching et score explicable. Cette page vous mène de zéro au premier point quotidien.

Ce dont vous avez besoin

  • Un hôte Linux : l’installateur cible Debian 12 ou plus récent et Ubuntu 22.04 ou plus récent. Le produit s’exécute sous forme d’une seule image Docker.
  • Un canal de messagerie : un serveur Matrix (K9 Chat est un client Matrix) avec un compte de bot dédié et son jeton d’accès, ou un espace de travail Slack, ou un tenant Microsoft Teams avec un enregistrement de bot Azure.
  • Une base de données : SQLite est le choix par défaut et ne nécessite rien ; pointez le produit vers Postgres pour les déploiements multi-hôtes.
  • Une clé de fournisseur d’IA, ou un Ollama local pour les installations isolées du réseau (réponses vocales désactivées). Le score n’a jamais besoin de l’IA ; l’assistant, les résumés et le coaching, si.
  • Un reverse proxy (Nginx ou Caddy) terminant le TLS devant le conteneur.

Installer

Copiez la version sur l’hôte, exécutez l’installateur en tant que root, modifiez le fichier d’environnement qu’il crée et démarrez la pile.

  • Un démarrage propre consigne les salons de points quotidiens et de congés que le bot écoute, et confirme que le build du front-end est présent.
  • Le premier administrateur est le compte nommé dans BOOTSTRAP_ADMIN_MATRIX_ID ; il est promu automatiquement au démarrage.
  • Les changements de schéma sont additifs et s’exécutent à chaque démarrage, de sorte qu’une mise à niveau se résume à un pull et un redémarrage.
sudo bash install.sh
sudo nano /opt/inroots/.env
cd /opt/inroots && sudo docker compose up -d
sudo docker compose logs -f

Connecter votre messagerie

Sur Matrix, le bot rejoint les salons que vous lui assignez : un salon de points quotidiens par équipe, et en option un salon de congés, un salon d’urgence et un salon d’administration. Les messages directs entre le bot et chaque personne sont chiffrés de bout en bout, et un audit au démarrage active le chiffrement sur tout ancien salon de message direct qui en serait dépourvu.

  • Les espaces de travail Slack sont ajoutés par une installation OAuth ; chaque espace stocke son propre jeton de bot, chiffré au repos.
  • Les tenants Teams enregistrent leur propre bot Azure et collent les identifiants ; un paquet de manifeste est généré pour que vous le téléversiez.
  • Des identités de bot supplémentaires (personas) peuvent être créées plus tard et assignées aux salons individuellement ; chacune conserve ses propres clés de chiffrement.
MATRIX_HOMESERVER=https://chat.example.com
MATRIX_USER_ID=@inroots:example.com
MATRIX_ACCESS_TOKEN=...
MATRIX_STANDUP_ROOM_ID=!room:example.com

Se connecter au tableau de bord

Il n’y a pas de mot de passe par défaut. Saisissez votre identifiant de messagerie sur la page de connexion, le bot envoie un code à six chiffres par message direct, et vous le saisissez. Les codes expirent après cinq minutes, trois tentatives erronées verrouillent le compte pendant quinze minutes, et une option d’appareil de confiance dispense du code sur un appareil que vous utilisez régulièrement.

Configurer une équipe

  • Jours travaillés : un sélecteur sur sept jours par équipe (une semaine du dimanche au jeudi est entièrement prise en charge). Non défini signifie que chaque jour compte.
  • Heure limite de connexion et délai de tolérance, ou l’option de connexion flexible qui n’évalue que les heures.
  • Heures attendues par jour, et heures hebdomadaires par employé pour les temps partiels.
  • Un calendrier de jours fériés par équipe, généré hors ligne à partir d’un pays et d’une région, plus une liste à l’échelle de l’organisation.
  • Un salon des managers pour les escalades et, si vous le souhaitez, les pings de disponibilité.

Choisir un fournisseur d’IA

Ouvrez la page Fournisseurs, collez une clé pour l’un des seize fournisseurs pris en charge et choisissez le fournisseur actif. Définissez plutôt un point de terminaison Ollama si le texte des points quotidiens ne doit jamais quitter votre réseau. La chaîne de bascule et le budget d’appels quotidien se configurent sur la même page ; voir Fournisseurs d’IA et Coût et confidentialité de l’IA pour les détails.

Le premier point quotidien

Demandez à quelqu’un de publier ceci dans le salon des points quotidiens. Le bot en accuse réception dans le salon, enregistre l’heure de connexion, extrait les tâches et le blocage, et démarre la journée.

  • En fin de journée, la personne publie sa déconnexion. Les heures sont la différence, corrigée selon ce que la journée montre réellement.
  • Chacun peut taper /pulse me dans la messagerie pour voir sa propre fiche de score dès la première semaine.
Yesterday:
- shipped the export fix
Today:
- invoice PDF rendering
Issues: NPs