Ir para o conteúdo principal

🙋🏻 Novo colaborador? Comece por aqui!

Olá!

Seja muito bem-vindo(a) ao nosso time! 👋

Preparamos este espaço com muito carinho para ser seu apoio nos primeiros dias conosco. Aqui você encontrará os materiais e todas as informações necessárias para iniciar sua jornada.

Estamos super animados para ter você aqui! 😊

1. Conhecendo nossos produtos:

  • Karoo Chat One: S
  • Karoo BOT: P
  • Omnichannel: F
  • WhatsappWeb: A
  • Karoo Account Manager: 

2. Onde hospedamos as APIS, Serviços e Bancos dos nossos produtos?

3. Repositório dos sistemas na Rede

Antes de acessar é preciso mapear a rede, conforme esse manual da infra: Mapeamento de diretórios na Rede: Linux e Windows

O repositório pode ser acessado de duas formas:

4. Onde estão as aplicações dos sistemas?

Todos os nossos sistemas possuem quatro versões principais:
Produção (ambiente real e em uso),
Review (ambiente de testes, uma cópia fiel da produção, porém com as novas implementações a serem mergeadas em produção),
Staging (utilizada somente no Karoo chat One, é uma cópia fiel do ambiente de produção, apontada para o ambiente de review do omnichannel),
Teste (ambiente totalmente seguro para testes, e sem problemas de realizar alterações).

Abaixo, você encontrará os detalhes de acesso às interfaces de Produção e informações sobre as aplicações:

5. Acesso ao banco de dados

Atualmente, temos diferentes formas para acesso do banco de dados do ambiente de teste, e do ambiente de produção. 
Primeiramente, você precisará baixar o mongoDB compass.

Siga estes passos para baixar e instalar o Compass usando o terminal:

  1. Baixar o Pacote .deb: Você pode baixar o arquivo .deb mais recente diretamente do site da MongoDB usando o comando wget. O link abaixo é um exemplo; você deve sempre verificar a versão mais recente na página oficial de downloads do MongoDB Compass:

    Bash 
    wget https://downloads.mongodb.com/compass/mongodb-compass_1.46.10_amd64.deb

    (Nota: O número da versão 1.46.10 pode mudar. Substitua-o pela versão mais atual.)

  2. Instalar o Pacote: Use o comando dpkg (Gerenciador de Pacotes Debian) com sudo para instalar o arquivo que você acabou de baixar:

    Bash 
    sudo dpkg -i mongodb-compass_1.46.10_amd64.deb

    Se você receber um erro sobre dependências ausentes (o que é comum), execute o comando a seguir para que o apt baixe e instale automaticamente todas as dependências necessárias:

    Bash 
    sudo apt --fix-broken install

  3. Iniciar o MongoDB Compass: Após a instalação bem-sucedida, você pode iniciar o aplicativo de duas maneiras:

    • Pelo Menu de Aplicativos: Procure por "MongoDB Compass" no seu lançador de aplicativos do Ubuntu.

    • Pelo Terminal: Digite o nome do executável:

      Bash 
      mongodb-compass

Banco de Teste:
Para acessar o banco correspondente ao projeto do time Omnichannel, você seguirá este passo a passo de exemplo: 
Acesse o OKD 4 e no seu nome de usuário no canto superior direito, clique em 'Copy login command'

image.png

Abra o terminal da sua máquina e dê um Ctrl + Shift + V (enter)
Oc projects (enter - aqui listamos os nomes dos projetos)
Oc project nome do projeto (enter)
Oc get pod (enter - aqui listamos os pods do projeto)
Oc port-forward nome do banco 27017:27017 (enter)


Para acesso ao banco do karoo chat One, é só você colocar essa url de conexão no compass: mongodb://karoo:gt36KVMc63M8@blackdb-review.karoo.com.br/karoo?directConnection=true&authSource=karoo

Prontinho, agora você poderá acessar o banco de dados dos projetos no MongoDB Compass para fazer os testes necessários no produto 😀

Banco de produção: 
Para acessar o ambiente de produção, você precisará de um convite do teach Lead.
A URL para acesso é: https://cloud.mongodb.com/v2#/org/681b8dec9d89f61eaf133064/projects

6. Monitor do sistema

Atualmente temos um monitor que nos ajuda a verificar os envios / recebimentos de mensagens das plataformas configuradas do cliente no ambiente de produção. 

7. Documentações de APIS:

Utilizamos o Swagger como uma ferramenta essencial para documentar nossas APIs e realizar testes.

Com ele, você pode:

  • Visualizar todos os endpoints existentes em nossos serviços.
  • Entender a funcionalidade de cada um.
  • Consultar os parâmetros necessários para as requisições.

Além disso, o Swagger está integrado ao nosso banco de dados de testes, o que significa que todas as requisições realizadas diretamente pela interface do Swagger serão executadas neste ambiente de teste.

Para acessá-lo, basta pegar a URL da branch, e no final dela acrescentar: /api/help

8. Como funciona a Sprint?

Este tutorial detalha como as tarefas são criadas, priorizadas e desenvolvidas no seu time, seguindo uma metodologia ágil utilizando o Jira da Atlassian: https://jira.alterdata.com.br/

1. Criação e Organização das Tarefas

As tarefas são criadas inicialmente pelo time, sejam Devs, Qas ou o próprio time de suporte, e essas tarefas vão indo para o Backlog

Todo o backlog é organizado conforme os produtos/projetos específicos do time.

2. Planejamento (Planning) e Votação das Tarefas

O processo de planejamento ocorre em sessões de planning.

  1. Seleção das Tarefas: Antes da planning, o Tech Lead seleciona as tarefas do backlog que serão consideradas.
  2. Votação: Após a seleção, o time realiza uma votação para estimar o esforço de cada tarefa. Esta votação segue a sequência de Fibonacci (1, 2, 3, 5, 8, 13...).
  3. Discussão e Voto Final: Depois da votação individual, o time discute cada tarefa para chegar a um consenso e definir o voto final. Esse processo se repete para todas as tarefas selecionadas.
3. Início e Execução da Sprint

Uma vez que as tarefas são votadas, a sprint se inicia.

  • Duração da Sprint: Uma sprint dura 2 semanas corridas, ou, aproximadamente 10 dias úteis.
  • Papel dos Desenvolvedores (Devs): Os desenvolvedores iniciam o trabalho nas tarefas que foram definidas e votadas.
  • Papel dos Analistas de Qualidade (QAs): Os Qas iniciam a sprint com tarefas designadas para o time de qa, tais como liberações, análise de situações reportadas, etc. Quando os devs finalizam as tarefas de programação, automaticamente as tarefas de teste, vinculada as issues, ficarão disponíveis na fila de tarefas pendentes de teste.

Durante o período de desenvolvimento pelos devs, os QAs não ficam ociosos. Eles aproveitam esse tempo para realizar outras atividades importantes, como:

  • Execução de testes e levantamento de requisitos em tarefas avulsas (que não fazem parte do sprint atual, mas estão no backlog).
  • Criação de documentação referente aos produtos ou processos.
  • Resolução de problemas específicos que surgem no dia a dia.

9. Shield 🤠

Para manter a agilidade e a qualidade em nossos ciclos de desenvolvimento, adotamos um sistema de rodízio para a função de "Xerife da Sprint" a cada nova troca de sprint.

Este papel crucial é assumido por um dos nossos QAs (Analistas de Qualidade) e tem como principal objetivo ser a ponte central entre o time de desenvolvimento e as demandas urgentes provenientes do suporte.

🛡️ O Papel do Xerife da Sprint:

O QA designado como Xerife é o guardião da estabilidade e da resolução rápida. Suas responsabilidades incluem:

  • Absorção e Direcionamento: Ser o ponto focal para todas as demandas de suporte que precisam de intervenção do time técnico. Ele absorve a solicitação, faz a primeira análise e direciona a situação, garantindo que a demanda não se perca ou fique estagnada.

  • Triagem e Priorização: Realizar a triagem das solicitações de suporte, analisando dúvidas e, principalmente, mensurando a prioridade e a urgência da situação. Isso evita que o time da sprint seja interrompido por questões de baixa prioridade, enquanto assegura que o crítico seja atendido imediatamente.

  • Garantia do Tempo de Atendimento (SLA): Monitorar ativamente o andamento das resoluções para garantir que todas as demandas de suporte sejam atendidas dentro de um tempo aceitável (SLA), mantendo a satisfação de nossos clientes e usuários.

Este revezamento assegura que o restante do time de QA e desenvolvimento possa manter o foco total nos objetivos da sprint, enquanto temos um profissional dedicado e rotativo cuidando da linha de frente do suporte. É uma estratégia de time para proteger nosso foco de trabalho e, ao mesmo tempo, elevar a qualidade da resposta que oferecemos às urgências.

Vale destacar, que as dúvidas básicas do time do suporte, devem ser registradas pelo Haryon aqui do KB do suporte. 
E nós, devemos registrar essas dúvidas em nossa planilha de monitoramento: Clique aqui!

💽 Sistemas úteis para baixar em sua máquina de trabalho: