Start

Erste Schritte

InRoots ist ein Container, der den Chat mitliest, den Ihr Team bereits nutzt, eine Zeile pro Tag und Person verarbeitet und daraus Stunden, Ziele, Coaching und eine erklärbare Bewertung macht. Diese Seite führt Sie von null bis zum ersten Check-in.

Was Sie benötigen

  • Einen Linux-Host: Der Installer unterstützt Debian 12 oder neuer und Ubuntu 22.04 oder neuer. Das Produkt läuft als ein einzelnes Docker-Image.
  • Einen Chat-Kanal: einen Matrix-Server (K9 Chat ist ein Matrix-Client) mit einem dedizierten Bot-Konto und dessen Zugriffstoken, oder einen Slack-Workspace, oder einen Microsoft-Teams-Mandanten mit einer Azure-Bot-Registrierung.
  • Eine Datenbank: SQLite ist der Standard und benötigt nichts weiter; für Deployments über mehrere Hosts richten Sie das Produkt auf Postgres.
  • Einen Schlüssel für einen KI-Anbieter oder ein lokales Ollama für abgeschottete Installationen (bei ausgeschalteten gesprochenen Antworten). Die Bewertung braucht die KI nie; der Assistent, Zusammenfassungen und Coaching schon.
  • Einen Reverse-Proxy (Nginx oder Caddy), der TLS vor dem Container terminiert.

Installation

Kopieren Sie das Release auf den Host, führen Sie den Installer als root aus, bearbeiten Sie die von ihm erzeugte Umgebungsdatei und starten Sie den Stack.

  • Ein sauberer Start protokolliert, welche Standup- und Urlaubsräume der Bot beobachtet und dass der Frontend-Build vorhanden ist.
  • Der erste Admin ist das in BOOTSTRAP_ADMIN_MATRIX_ID benannte Konto; es wird beim Start automatisch befördert.
  • Schemaänderungen sind additiv und laufen bei jedem Start, sodass ein Upgrade aus einem Pull und einem Neustart besteht.
sudo bash install.sh
sudo nano /opt/inroots/.env
cd /opt/inroots && sudo docker compose up -d
sudo docker compose logs -f

Ihren Chat anbinden

Auf Matrix tritt der Bot den Räumen bei, die Sie ihm zuweisen: ein Standup-Raum je Team, optional ein Urlaubsraum, ein Dringlichkeitsraum und ein Admin-Raum. Direktnachrichten zwischen dem Bot und jeder Person sind Ende-zu-Ende-verschlüsselt, und eine Prüfung beim Start aktiviert die Verschlüsselung für jeden älteren DM-Raum, dem sie fehlt.

  • Slack-Workspaces werden über eine OAuth-Installation hinzugefügt; jeder Workspace speichert sein eigenes Bot-Token, im Ruhezustand verschlüsselt.
  • Teams-Mandanten registrieren ihren eigenen Azure-Bot und fügen die Zugangsdaten ein; ein Manifestpaket wird für den Upload generiert.
  • Zusätzliche Bot-Identitäten (Personas) können später angelegt und Räumen einzeln zugewiesen werden; jede behält ihre eigenen Verschlüsselungsschlüssel.
MATRIX_HOMESERVER=https://chat.example.com
MATRIX_USER_ID=@inroots:example.com
MATRIX_ACCESS_TOKEN=...
MATRIX_STANDUP_ROOM_ID=!room:example.com

Am Dashboard anmelden

Standardmäßig gibt es keine Passwörter. Geben Sie auf der Anmeldeseite Ihre Chat-ID ein, der Bot sendet per Direktnachricht einen sechsstelligen Code, und Sie tippen ihn ein. Codes verfallen nach fünf Minuten, drei Fehlversuche sperren das Konto für fünfzehn Minuten, und eine Option für vertrauenswürdige Geräte überspringt den Code auf einem Gerät, das Sie regelmäßig verwenden.

Ein Team konfigurieren

  • Arbeitstage: eine Sieben-Tage-Auswahl je Team (eine Woche von Sonntag bis Donnerstag wird vollständig unterstützt). Ohne Angabe zählt jeder Tag.
  • Anmeldefrist und Kulanz, oder der Schalter für flexible Anmeldung, der nur nach Stunden bewertet.
  • Erwartete Stunden pro Tag sowie Wochenstunden je Mitarbeiterin oder Mitarbeiter für Teilzeitkräfte.
  • Ein Feiertagskalender je Team, offline aus Land und Region generiert, plus eine organisationsweite Liste.
  • Ein Führungskräfteraum für Eskalationen und, falls gewünscht, Verfügbarkeits-Pings.

Einen KI-Anbieter wählen

Öffnen Sie die Seite „Anbieter“, fügen Sie einen Schlüssel für einen der sechzehn unterstützten Anbieter ein und wählen Sie den aktiven aus. Hinterlegen Sie stattdessen einen Ollama-Endpunkt, wenn Standup-Text Ihr Netzwerk nie verlassen darf. Die Failover-Kette und das tägliche Aufrufbudget werden auf derselben Seite konfiguriert; Details finden Sie unter KI-Anbieter sowie KI-Kosten und Datenschutz.

Der erste Check-in

Bitten Sie jemanden, dies im Standup-Raum zu posten. Der Bot bestätigt es im Raum, erfasst die Anmeldezeit, extrahiert die Aufgaben und den Blocker und beginnt den Tag.

  • Am Ende des Tages postet die Person sign off. Die Stunden sind die Differenz, korrigiert um das, was der Tag tatsächlich zeigt.
  • Jede Person kann /pulse me im Chat eingeben und sieht ab der ersten Woche ihre eigene Scorecard.
Yesterday:
- shipped the export fix
Today:
- invoice PDF rendering
Issues: NPs