Início

Primeiros passos

O InRoots é um contentor que escuta o chat que a equipa já utiliza, analisa uma linha por dia por pessoa e transforma-a em horas, objetivos, orientação e uma pontuação explicável. Esta página leva-vos do zero ao primeiro check-in.

O que é preciso

  • Um servidor Linux: o instalador destina-se a Debian 12 ou mais recente e Ubuntu 22.04 ou mais recente. O produto corre como uma única imagem Docker.
  • Um canal de chat: um servidor Matrix (o K9 Chat é um cliente Matrix) com uma conta de bot dedicada e o respetivo token de acesso, ou um espaço de trabalho Slack, ou um tenant Microsoft Teams com um registo de bot no Azure.
  • Uma base de dados: o SQLite é o valor por defeito e não precisa de nada; apontem o produto para Postgres em implementações com vários servidores.
  • Uma chave de fornecedor de IA, ou um Ollama local para instalações isoladas da rede (com as respostas faladas desligadas). A pontuação nunca precisa da IA; o assistente, os resumos e a orientação precisam.
  • Um proxy inverso (Nginx ou Caddy) a terminar o TLS à frente do contentor.

Instalar

Copiem a versão para o servidor, executem o instalador como root, editem o ficheiro de ambiente que ele cria e arranquem a stack.

  • Um arranque limpo regista que salas de standup e de férias o bot está a escutar e que a build do front-end está presente.
  • O primeiro administrador é a conta indicada em BOOTSTRAP_ADMIN_MATRIX_ID; é promovida automaticamente no arranque.
  • As alterações ao esquema são aditivas e correm em cada arranque, por isso uma atualização é um pull e um restart.
sudo bash install.sh
sudo nano /opt/inroots/.env
cd /opt/inroots && sudo docker compose up -d
sudo docker compose logs -f

Ligar o chat

No Matrix, o bot entra nas salas que lhe atribuírem: uma sala de standup por equipa e, opcionalmente, uma sala de férias, uma sala de urgências e uma sala de administração. As mensagens diretas entre o bot e cada pessoa são cifradas de ponta a ponta, e uma auditoria no arranque ativa a cifra em qualquer sala de mensagens diretas mais antiga que não a tenha.

  • Os espaços de trabalho Slack são adicionados por instalação OAuth; cada espaço guarda o seu próprio token de bot, cifrado em repouso.
  • Os tenants Teams registam o seu próprio bot no Azure e colam as credenciais; é gerado um pacote de manifesto para carregarem.
  • Podem ser criadas mais tarde identidades de bot adicionais (personas) e atribuídas a salas individualmente; cada uma mantém as suas próprias chaves de cifra.
MATRIX_HOMESERVER=https://chat.example.com
MATRIX_USER_ID=@inroots:example.com
MATRIX_ACCESS_TOKEN=...
MATRIX_STANDUP_ROOM_ID=!room:example.com

Iniciar sessão no painel

Por defeito não há palavras-passe. Introduzam o vosso ID de chat na página de início de sessão, o bot envia um código de seis dígitos por mensagem direta e escrevem-no. Os códigos expiram ao fim de cinco minutos, três tentativas erradas bloqueiam a conta durante quinze minutos, e uma opção de dispositivo de confiança dispensa o código num dispositivo que usem regularmente.

Configurar uma equipa

  • Dias de trabalho: um seletor de sete dias por equipa (uma semana de domingo a quinta é totalmente suportada). Sem definição, todos os dias contam.
  • Hora-limite de entrada e tolerância, ou o interruptor de entrada flexível que avalia apenas pelas horas.
  • Horas esperadas por dia e horas semanais por colaborador para quem trabalha a tempo parcial.
  • Um calendário de feriados por equipa, gerado offline a partir de um país e de uma região, mais uma lista para toda a organização.
  • Uma sala de gestores para escaladas e, se as quiserem, verificações de disponibilidade.

Escolher um fornecedor de IA

Abram a página Fornecedores, colem uma chave de qualquer um dos dezasseis fornecedores suportados e escolham o ativo. Em alternativa, definam um endpoint Ollama se o texto dos standups nunca puder sair da vossa rede. A cadeia de failover e o orçamento diário de chamadas configuram-se na mesma página; ver Fornecedores de IA e Custo e privacidade da IA para os detalhes.

O primeiro check-in

Peçam a alguém que publique isto na sala de standup. O bot confirma na sala, regista a hora de entrada, extrai as tarefas e o bloqueio e inicia o dia.

  • No fim do dia, a pessoa publica sign off. As horas são a diferença, corrigida pelo que o dia efetivamente mostra.
  • Qualquer pessoa pode escrever /pulse me no chat para ver o seu próprio cartão de pontuação logo desde a primeira semana.
Yesterday:
- shipped the export fix
Today:
- invoice PDF rendering
Issues: NPs