← Voltar ao início

CoOps – Métricas GitHub

Visualização, análise e explicação de métricas de colaboração em repositórios e organizações GitHub.

Introdução

O projeto CoOps foi desenvolvido na disciplina Métodos de Desenvolvimento de Software (MDS) da Engenharia de Software (UnB). Seu objetivo é apoiar desenvolvedores, mantenedores e organizações na análise da colaboração dentro de projetos GitHub, fornecendo métricas claras, visuais e interpretadas por IA.

Equipe

Scrum Master: Pedro Druck

Product Owner (PO): Marcos Antonio

Time de Desenvolvimento:

Gustavo, Pedro Rocha, Carlos, Heitor

Tecnologias Utilizadas

🐍 Python

Extração de dados via API GitHub

⚡ GitHub Actions

Automação de workflows

🎨 HTML5 & CSS3

Frontend e documentação (GitHub Pages)

📝 Markdown

Documentação estruturada

🎨 Figma

Protótipos e design

⚛️ React/Next.js

Interface moderna e responsiva

Arquitetura do Projeto

O projeto segue uma arquitetura orientada a serviços, com automações para coleta de dados e geração de relatórios.

📊 Coletor de Métricas

Scripts Python que extraem dados da API do GitHub.

🔄 Workflows

GitHub Actions para orquestrar a coleta e atualização dos dados.

🌐 Frontend

GitHub Pages para visualização e documentação.

📊 Diagramas C4 - Arquitetura do Sistema

📋 Componentes da Arquitetura:

👥 Atores do Sistema:
  • Gestores de Projetos - Donos de organizações GitHub
  • Estudantes - Contribuidores de engenharia de software
  • Pesquisadores - Analistas de dados de repositórios
🔧 Sistemas Principais:
  • Sistema de Visualização - Interface de métricas
  • Sistema de Extração - Coleta de dados GitHub
  • Arquitetura Medallion - Processamento em camadas

Requisitos

Requisitos Funcionais

  • RF01:Exibir dashboard de métricas de colaboração.
  • RF02:Permitir alternar entre visão de repositório e organização.
  • RF03:Coletar e exibir métricas de issues, commits, pull requests, tecnologias e qualidade de código.
  • RF04:Fornecer explicações automáticas das métricas via IA.
  • RF05:Atualizar dados automaticamente via GitHub Actions.

Requisitos Não-Funcionais

  • RNF01:Interface responsiva e acessível.
  • RNF02:Código aberto e documentado.
  • RNF03:Atualização automática dos dados sem intervenção manual.
  • RNF04:Segurança dos dados sensíveis (tokens, etc).

📖 User Stories

Story Map Interativo

Explore o mapeamento completo das histórias de usuário do CoOps. O Story Map apresenta a jornada do usuário organizada por épicos, features e tarefas, mostrando o fluxo completo desde o acesso inicial até a análise avançada de métricas.

Story Map CoOps - User StoriesAbrir no Figma →

🎯 Épicos Principais

  • • Autenticação e Acesso
  • • Visualização de Métricas
  • • Análise de Dados
  • • Configurações do Sistema

👥 Personas Identificadas

  • Gestor de Projetos
  • Desenvolvedor
  • Pesquisador
  • Estudante

📊 Funcionalidades Core

  • • Dashboard de métricas
  • • Análise de colaboração
  • • Relatórios automatizados
  • • Exportação de dados

🔑 Histórias Principais

Gestor: Visualizar métricas consolidadas da organização para tomada de decisões estratégicas

Desenvolvedor: Acompanhar contribuições individuais e performance da equipe

Pesquisador: Acessar dados brutos para análises acadêmicas e estudos

Estudante: Entender métricas de colaboração para aprendizado

🎨 Protótipos

Protótipo de Alta Fidelidade

Visualize o protótipo interativo da aplicação CoOps desenvolvido no Figma. O protótipo apresenta a interface principal com métricas de colaboração, dashboards e funcionalidades de análise de repositórios GitHub.

Protótipo CoOps - Alta FidelidadeAbrir no Figma →

🎯 Funcionalidades Principais

  • • Dashboard de métricas interativo
  • • Visualização de dados de repositórios
  • • Análise de colaboração entre desenvolvedores
  • • Interface responsiva e intuitiva

Documentação Técnica

🔧 Backend

O backend do CoOps é desenvolvido em Python e é responsável pela extração, processamento e análise dos dados do GitHub.

  • Tecnologias: Python, GitHub API, Pandas, NumPy
  • Responsabilidades: Coleta de dados, processamento ETL, análise de métricas
  • Arquitetura: Scripts modulares com automação via GitHub Actions

🎨 Frontend

O frontend é desenvolvido em Next.js e fornece uma interface moderna e responsiva para visualização das métricas.

  • Tecnologias: Next.js, React, TypeScript, Tailwind CSS
  • Features: Dashboard interativo, visualizações de dados, design responsivo
  • Deploy: GitHub Pages com automação via GitHub Actions

📋 Requisitos

Documentação completa dos requisitos funcionais e não-funcionais do projeto CoOps.

Requisitos Funcionais

  • • Dashboard de métricas
  • • Visualização de dados
  • • Análise de colaboração
  • • Relatórios automáticos

Requisitos Não-Funcionais

  • • Performance otimizada
  • • Interface responsiva
  • • Segurança de dados
  • • Código aberto

📝 Atas de Reuniões

Registro completo de todas as reuniões da equipe, decisões tomadas e planejamentos realizados.

Reuniões Recentes

  • • 15/09/2025 - Pivô Estratégico
  • • 09/09/2025 - Definição de Acesso
  • • 08/09/2025 - Sprint 2
  • • 01/09/2025 - Retrospectiva

Tópicos Principais

  • • Planejamento de sprints
  • • Definições técnicas
  • • Retrospectivas
  • • Decisões estratégicas