Skip to content

v1.0.0 - Stable MVP

Choose a tag to compare

@vinicius3w vinicius3w released this 30 Nov 23:12
· 138 commits to main since this release

🎉 Release Notes - Bisolhador Dashboard v1.0.0

We're thrilled to announce the launch of Bisolhador Dashboard v1.0.0, the first stable release of our GitHub Repository Analysis tool! This milestone marks the culmination of dedicated efforts to create an intuitive, reliable platform for educators and developers to gain valuable insights into software engineering practices.

🚀 What's New in v1.0.0

🔍 Busca & Dados (Fail-Safe, Token)

  • Intelligent Search: Seamlessly search and analyze GitHub repositories using the simple owner/repo format.
  • Robust Fail-Safe Mechanisms: Built-in error handling ensures the application remains stable even during API failures, rate limits, or connectivity issues.
  • GitHub Token Integration: Easily configure personal tokens via the settings ⚙️ button to increase request limits from 60 to 5,000 per hour, enabling uninterrupted analysis sessions.

📊 Métricas Visuais (Gráficos, Stack Tecnológica)

  • Dynamic Charts: Visualize commit patterns across weekdays with intuitive bar charts that highlight work habits and crunch periods.
  • Technological Stack Visualization: Explore project language composition through dynamic, color-coded doughnut charts. Known languages feature standardized colors, while unknown languages receive algorithmically generated hues for optimal readability.

🔬 Análise de Processo (Bus Factor, Crunch, Taxa de Resolução)

  • Contributors Table: Analyze team composition and distribution through a comprehensive contributors ranking, helping identify Bus Factor risks.
  • Crunch Detection: Automated analysis of commit timing to detect excessive weekend or late-night work, promoting healthy development practices.
  • Resolution Rate: Calculate issue resolution efficiency with real-time metrics showing open vs. closed issue ratios, supporting project health assessments.

🛡️ Governança (Health Score, Maturidade de Engenharia)

  • Community Health Score: Evaluate repository governance through a scoring system based on 7 critical files (README, License, Contributing Guidelines, etc.), providing a percentage-based health indicator with color-coded feedback.
  • Engineering Maturity Assessment: Inspect infrastructure quality by checking for Automated Tests, CI/CD pipelines, Linters, and Security Auditing tools, displayed through intuitive badge visualizations.

🛠️ Utilitários (PDF, Tooltips)

  • PDF Export: Generate comprehensive PDF reports of all dashboard metrics, perfect for documentation, presentations, or archival purposes.
  • Interactive Tooltips: Contextual help throughout the interface with hover-based explanations, ensuring users understand each metric's significance.
  • Responsive Design: Mobile-friendly layouts that adapt gracefully across devices, built with modern Tailwind CSS.

🏆 Key Highlights

  • Educational Focus: Designed specifically to support Software Engineering education, helping students and instructors identify best practices and common pitfalls.
  • Open Source Community: Built for collaboration, using GitHub's ecosystem to analyze projects within the platform.
  • Privacy-First: All configured tokens remain local to your browser, ensuring data security and user control.
  • Zero Dependencies Setup: Launch the dashboard instantly using VS Code's Live Server extension - no complex installations required.

📈 Performance & Reliability

  • Stable API Integrations: Comprehensive error handling for all GitHub API calls, maintaining functionality even during network issues.
  • Efficient Rendering: Fast, responsive UI updates powered by Chart.js and Vanilla JS architecture.
  • Accessible Interface: Professional design with Shark/Ocean color themes, clear typography, and semantic HTML structure.

🤝 Acknowledgments

A heartfelt thank you to everyone who contributed to making Bisolhador v1.0.0 a reality:

  • Core Development Team: Vinicius Cardoso Garcia and the ASSERT Lab community for their vision and expertise.
  • Beta Testers: Early adopters who provided invaluable feedback on usability and functionality.
  • Open Source Community: Leveraging powerful tools like GitHub API, Tailwind CSS, and Chart.js to build this solution.
  • Educators and Developers: Whose innovative practices inspired the creation of tools to measure and improve software engineering excellence.

We're excited to see how the community uses Bisolhador to enhance educational outcomes and promote better development habits. This is just the beginning - stay tuned for future updates and enhancements!


Get Started: Clone the repository, install the Live Server extension in VS Code, and open index.html. Happy analyzing!

Celebrating this milestone with 🦈 (our Recife roots)!