Primi passi

Primi passi

InRoots è un unico container che ascolta la chat che il vostro team già utilizza, analizza una riga al giorno per persona e la trasforma in ore, obiettivi, coaching e un punteggio spiegabile. Questa pagina vi porta da zero al primo check-in.

Cosa serve

  • Un host Linux: l'installer supporta Debian 12 o successivo e Ubuntu 22.04 o successivo. Il prodotto funziona come una singola immagine Docker.
  • Un canale di chat: un server Matrix (K9 Chat è un client Matrix) con un account bot dedicato e il suo token di accesso, oppure un workspace Slack, oppure un tenant Microsoft Teams con una registrazione bot su Azure.
  • Un database: SQLite è il predefinito e non richiede nulla; puntate il prodotto a Postgres per le installazioni multi-host.
  • Una chiave di un provider di IA, oppure un Ollama locale per le installazioni air-gapped (con le risposte vocali disattivate). Il punteggio non ha mai bisogno dell'IA; l'assistente, i riepiloghi e il coaching sì.
  • Un reverse proxy (Nginx o Caddy) che termina il TLS davanti al container.

Installazione

Copiate la release sull'host, eseguite l'installer come root, modificate il file di ambiente che crea e avviate lo stack.

  • Un avvio pulito registra nei log quali stanze standup e ferie il bot sta ascoltando e che la build del front-end è presente.
  • Il primo admin è l'account indicato in BOOTSTRAP_ADMIN_MATRIX_ID; viene promosso automaticamente all'avvio.
  • Le modifiche allo schema sono additive e vengono eseguite a ogni avvio, quindi un aggiornamento è un pull e un riavvio.
sudo bash install.sh
sudo nano /opt/inroots/.env
cd /opt/inroots && sudo docker compose up -d
sudo docker compose logs -f

Collegare la chat

Su Matrix il bot entra nelle stanze che gli assegnate: una stanza standup per team, facoltativamente una stanza ferie, una stanza urgenze e una stanza admin. I messaggi diretti tra il bot e ogni persona sono cifrati end-to-end, e un audit all'avvio attiva la cifratura in ogni stanza DM più vecchia che ne è priva.

  • I workspace Slack si aggiungono con un'installazione OAuth; ogni workspace conserva il proprio token bot, cifrato a riposo.
  • I tenant Teams registrano il proprio bot Azure e incollano le credenziali; viene generato un pacchetto manifest da caricare.
  • Ulteriori identità bot (profili) possono essere create in seguito e assegnate alle stanze singolarmente; ognuna conserva le proprie chiavi di cifratura.
MATRIX_HOMESERVER=https://chat.example.com
MATRIX_USER_ID=@inroots:example.com
MATRIX_ACCESS_TOKEN=...
MATRIX_STANDUP_ROOM_ID=!room:example.com

Accedere alla dashboard

Per impostazione predefinita non ci sono password. Inserite il vostro ID di chat nella pagina di accesso, il bot invia un codice a sei cifre per messaggio diretto e lo digitate. I codici scadono dopo cinque minuti, tre tentativi errati bloccano l'account per quindici minuti, e un'opzione di dispositivo attendibile salta il codice su un dispositivo che usate abitualmente.

Configurare un team

  • Giorni lavorativi: un selettore a sette giorni per team (una settimana da domenica a giovedì è pienamente supportata). Se non impostato, conta ogni giorno.
  • Orario limite di ingresso e tolleranza, oppure l'interruttore di ingresso flessibile che valuta solo sulle ore.
  • Ore attese al giorno, e ore settimanali per dipendente per i part-time.
  • Un calendario delle festività per team, generato offline da un paese e una regione, più una lista valida per tutta l'organizzazione.
  • Una stanza manager per le escalation e, se le volete, le verifiche di disponibilità.

Scegliere un provider di IA

Aprite la pagina Provider, incollate una chiave per uno qualsiasi dei sedici provider supportati e scegliete quello attivo. Impostate invece un endpoint Ollama se il testo degli standup non deve mai lasciare la vostra rete. La catena di failover e il budget giornaliero di chiamate si configurano nella stessa pagina; per i dettagli si vedano Provider di IA e Costi e privacy dell'IA.

Il primo check-in

Chiedete a qualcuno di pubblicare questo nella stanza standup. Il bot lo conferma nella stanza, registra l'orario di ingresso, estrae le attività e il blocco, e avvia la giornata.

  • A fine giornata la persona scrive sign off. Le ore sono la differenza, corretta in base a ciò che la giornata mostra effettivamente.
  • Chiunque può digitare /pulse me in chat per vedere la propria scorecard fin dalla prima settimana.
Yesterday:
- shipped the export fix
Today:
- invoice PDF rendering
Issues: NPs