Manual de Usuário - QuantumBitBR/API_5SEM GitHub Wiki

Produto: Dashboard de Indicadores de Projetos

1. Visão Geral do Produto

Nome do Produto: Strategy
Descrição: Plataforma web que exibe indicadores de desempenho com base em dados extraídos da ferramenta Taiga, visando apoiar a gestão eficiente de projetos.
Objetivo: Proporcionar visibilidade sobre o fluxo de trabalho e facilitar a tomada de decisões com base em métricas relevantes.
Público-Alvo: Equipes de desenvolvimento, gestores de projeto, analistas e operadores.

2. Contexto e Motivação

A Youtan, empresa de desenvolvimento de software, identificou a necessidade de aprimorar sua gestão de projetos, especialmente no que diz respeito à visualização e análise de indicadores estratégicos. Atualmente, a equipe utiliza a plataforma Taiga, que oferece uma interface Kanban funcional para acompanhamento de tarefas. No entanto, o sistema não fornece, de forma nativa, relatórios detalhados ou dashboards que consolidem métricas essenciais para o acompanhamento do fluxo de trabalho.

Problema

Entre os principais desafios enfrentados, destacam-se:

  • Falta de visibilidade centralizada: Informações como a quantidade de cards criados ou finalizados por período, tempo médio de execução de tarefas e volume de retrabalho não estão facilmente acessíveis.
  • Dificuldade na distribuição e acompanhamento das tarefas por colaborador: A ausência de relatórios específicos impacta na alocação equilibrada da carga de trabalho.
  • Ausência de diferenciação de acesso por perfil de usuário: A plataforma atual não permite restringir ou personalizar a visualização de dados com base na função do usuário (operador, gestor ou administrador), comprometendo a segurança da informação e a eficiência da análise.

Essas limitações tornam a tomada de decisão menos ágil e a gestão menos transparente, afetando diretamente a produtividade das equipes e o controle estratégico dos projetos.

Solução

A proposta consiste em desenvolver uma aplicação web integrada ao banco de dados do Taiga, capaz de consolidar, organizar e apresentar indicadores de desempenho de forma visual, interativa e personalizada, por meio de dashboards modernos e filtros inteligentes. Essa solução contará com níveis diferenciados de acesso, permitindo que cada perfil visualize apenas os dados relevantes ao seu escopo:

  • Operador: visualizará métricas relacionadas exclusivamente aos cards sob sua responsabilidade.
  • Gestor: terá acesso aos indicadores de sua própria atuação e também do time que lidera.
  • Administrador (Admin): poderá visualizar todos os indicadores, de todos os usuários e equipes, com visão global do sistema.

2. Manual do Usuário

Esta seção tem como objetivo orientar o usuário no acesso e utilização da plataforma, desde o login até a navegação pelos indicadores e exportação de relatórios.

1.1 Acesso ao Sistema - (Níveis de acesso: ADMIN, GESTOR, FUNCIONÁRIO)

  • Para acessar o sistema, utilize um navegador web (Google Chrome, Mozilla Firefox, etc.).
  • Digite suas credenciais de login (e-mail e senha) fornecidas pelo administrador do sistema.
  • Clique em “Entrar”. image

1.2 Navegação pelo Dashboard - (Níveis de acesso: ADMIN, GESTOR, FUNCIONÁRIO)

  • Após o login, você será direcionado ao dashboard principal.
  • Nessa etapa, temos alguns níveis de acesso. Para usuário ADMIN e GESTOR, temos os filtros de Projeto e Usuário, onde traz uma lista suspensa para que o usuário logado trabalhe com os dados de acordo com a necessidade.

image

  • Já como usuário FUNCIONÁRIO temos apenas a opção de Projeto e nele possui somente os projetos que ele está participando, caso contrário, aparecerá uma lista suspensa vazia.

image

1.3 Descrição dos Gráficos

Gráfico 01

No primeiro gráfico do dashboard, é possível visualizar a quantidade de cards existentes por sprint, dessa forma é possível identificar a evolução do volume de trabalho planejado ao longo do tempo e apoiar a análise da capacidade da equipe

image

Gráfico 02

Para o segundo gráfico temos a quantidade de cards criados e finalizados durante um período de tempo pré-definido. Dessa forma, é possível acompanhar a evolução da criação e finalização dos cards ao longo do tempo.

image

Gráfico 03

Para o terceiro indicador, temos uma tabela onde mostra a quantidade de cards vinculados a cada etiqueta disponível no projeto. Dessa forma, é possível identificar a quantidade de cards associados a cada categoria e facilitar a análise de organização.

image

Gráfico 04

Para o quarto indicador, temos um gráfico em formato de pizza onde mostra é possível visualizar o percentual de cards em cada status do sistema para acompanhar o desenvolvimento da equipe e suas etapas.

image

Gráfico 05

Para o quinto e sexto indicador, temos uma tabela onde é possível visualizar por user story o tempo médio gasto por ela até o momento e a quantidade de retrabalho que foi realizado nela.

image

1.4 Gerenciamento de Usuário

  • Navega para a aba de Usuários caso seja ADMIN.
  • Para habilitar e desabilitar o usuários utilize a opção disponível.

image

  • Para resetar a senha do usuário (envio da nova senha por e-mail de forma automática) clique no botão resetar senha.

image

  • Para selecionar o gestor do usuário Operador/Funcionário, utilize o dropdown de Gestores.

image

  • Para atribuir/modificar o tipo de usuário, utilize o dropdown de roles.

image

  • Para visualizar o seu perfil, clique em seu nome pela nav-bar. Logo visualizará suas informações, como também poderá resetar sua senha

image

image

1.5 Execução dos Projetos

Para executar cada módulo do sistema individualmente, acesse os repositórios a seguir:

Módulo Descrição Link para o Repositório
ETL Pipeline de extração e carga de dados, responsável pela comunicação com a API do Taiga. GitHub - ETL
Back-end API RESTful desenvolvida em Spring Boot, responsável pelas regras de negócio e integrações. GitHub - Back-end
Front-end Aplicação web desenvolvida com Vue.js, responsável pela interface do usuário. GitHub - Front-end
⚠️ **GitHub.com Fallback** ⚠️