import os import logging import pandas as pd import re from datetime import datetime from pathlib import Path import markdown import matplotlib.pyplot as plt import base64 from io import BytesIO logger = logging.getLogger(__name__) class ReportGenerator: """ Клас для генерації звітів на основі аналізу даних Jira """ def __init__(self, df, stats=None, inactive_issues=None, ai_analysis=None): """ Ініціалізація генератора звітів. Args: df (pandas.DataFrame): DataFrame з даними Jira stats (dict): Словник зі статистикою (або None) inactive_issues (dict): Дані про неактивні тікети (або None) ai_analysis (str): Текст AI аналізу (або None) """ self.df = df self.stats = stats self.inactive_issues = inactive_issues self.ai_analysis = ai_analysis def create_markdown_report(self, inactive_days=14): """ Створення звіту у форматі Markdown. Args: inactive_days (int): Кількість днів для визначення неактивних тікетів Returns: str: Текст звіту у форматі Markdown """ try: report = [] # Заголовок звіту report.append("# Звіт аналізу Jira") report.append(f"*Створено: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}*") # Загальна статистика report.append("\n## Загальна статистика") if self.stats and 'total_tickets' in self.stats: report.append(f"**Загальна кількість тікетів:** {self.stats['total_tickets']}") else: report.append(f"**Загальна кількість тікетів:** {len(self.df)}") # Статистика за статусами if self.stats and 'status_counts' in self.stats and self.stats['status_counts']: report.append("\n### Статуси тікетів") for status, count in self.stats['status_counts'].items(): percentage = count / self.stats['total_tickets'] * 100 if self.stats['total_tickets'] > 0 else 0 report.append(f"- **{status}:** {count} ({percentage:.1f}%)") elif 'Status' in self.df.columns: status_counts = self.df['Status'].value_counts() report.append("\n### Статуси тікетів") for status, count in status_counts.items(): percentage = count / len(self.df) * 100 if len(self.df) > 0 else 0 report.append(f"- **{status}:** {count} ({percentage:.1f}%)") # Статистика за типами if self.stats and 'type_counts' in self.stats and self.stats['type_counts']: report.append("\n### Типи тікетів") for type_name, count in self.stats['type_counts'].items(): percentage = count / self.stats['total_tickets'] * 100 if self.stats['total_tickets'] > 0 else 0 report.append(f"- **{type_name}:** {count} ({percentage:.1f}%)") elif 'Issue Type' in self.df.columns: type_counts = self.df['Issue Type'].value_counts() report.append("\n### Типи тікетів") for type_name, count in type_counts.items(): percentage = count / len(self.df) * 100 if len(self.df) > 0 else 0 report.append(f"- **{type_name}:** {count} ({percentage:.1f}%)") # Статистика за пріоритетами if self.stats and 'priority_counts' in self.stats and self.stats['priority_counts']: report.append("\n### Пріоритети тікетів") for priority, count in self.stats['priority_counts'].items(): percentage = count / self.stats['total_tickets'] * 100 if self.stats['total_tickets'] > 0 else 0 report.append(f"- **{priority}:** {count} ({percentage:.1f}%)") elif 'Priority' in self.df.columns: priority_counts = self.df['Priority'].value_counts() report.append("\n### Пріоритети тікетів") for priority, count in priority_counts.items(): percentage = count / len(self.df) * 100 if len(self.df) > 0 else 0 report.append(f"- **{priority}:** {count} ({percentage:.1f}%)") # Аналіз часових показників if 'Created' in self.df.columns and pd.api.types.is_datetime64_dtype(self.df['Created']): report.append("\n## Часові показники") min_date = self.df['Created'].min() max_date = self.df['Created'].max() report.append(f"**Період створення тікетів:** з {min_date.strftime('%Y-%m-%d')} по {max_date.strftime('%Y-%m-%d')}") # Тікети за останній тиждень last_week = (datetime.now() - pd.Timedelta(days=7)) recent_tickets = self.df[self.df['Created'] >= last_week] report.append(f"**Тікети, створені за останній тиждень:** {len(recent_tickets)}") # Неактивні тікети if self.inactive_issues: report.append(f"\n## Неактивні тікети (>{inactive_days} днів)") total_inactive = self.inactive_issues.get('total_count', 0) percentage = self.inactive_issues.get('percentage', 0) report.append(f"**Загальна кількість неактивних тікетів:** {total_inactive} ({percentage:.1f}%)") if 'by_status' in self.inactive_issues and self.inactive_issues['by_status']: report.append("\n**Неактивні тікети за статусами:**") for status, count in self.inactive_issues['by_status'].items(): report.append(f"- **{status}:** {count}") if 'top_inactive' in self.inactive_issues and self.inactive_issues['top_inactive']: report.append("\n**Топ 5 найбільш неактивних тікетів:**") for i, ticket in enumerate(self.inactive_issues['top_inactive']): key = ticket.get('key', 'Невідомо') summary = ticket.get('summary', 'Невідомо') status = ticket.get('status', 'Невідомо') days = ticket.get('days_inactive', 'Невідомо') report.append(f"{i+1}. **{key}:** {summary}") report.append(f" - Статус: {status}") report.append(f" - Днів неактивності: {days}") # AI Аналіз if self.ai_analysis: report.append("\n## AI Аналіз") report.append(self.ai_analysis) logger.info("Звіт успішно згенеровано у форматі Markdown") return "\n".join(report) except Exception as e: logger.error(f"Помилка при створенні звіту: {e}") return f"Помилка при створенні звіту: {str(e)}" def create_html_report(self, inactive_days=14, include_visualizations=False, visualization_data=None): """ Створення звіту у форматі HTML. Args: inactive_days (int): Кількість днів для визначення неактивних тікетів include_visualizations (bool): Чи включати візуалізації у звіт visualization_data (dict): Словник з об'єктами Figure для візуалізацій Returns: str: Текст звіту у форматі HTML """ try: # Спочатку створюємо звіт у форматі Markdown md_report = self.create_markdown_report(inactive_days) # Конвертуємо Markdown у HTML html_report = self.convert_markdown_to_html(md_report) # Додаємо візуалізації, якщо потрібно if include_visualizations and visualization_data: html_with_charts = self._add_visualizations_to_html(html_report, visualization_data) return html_with_charts return html_report except Exception as e: logger.error(f"Помилка при створенні HTML звіту: {e}") return f"
{str(e)}
" def convert_markdown_to_html(self, md_text): """ Конвертація тексту з формату Markdown у HTML. Args: md_text (str): Текст у форматі Markdown Returns: str: Текст у форматі HTML """ try: # Додаємо CSS стилі css = """ """ # Конвертація Markdown в HTML html_content = markdown.markdown(md_text, extensions=['tables', 'fenced_code']) # Складаємо повний HTML документ html = f"""{str(e)}
" def _add_visualizations_to_html(self, html_content, visualization_data): """ Додавання візуалізацій до HTML звіту. Args: html_content (str): Текст HTML звіту visualization_data (dict): Словник з об'єктами Figure для візуалізацій Returns: str: HTML звіт з візуалізаціями """ try: # Додаємо розділ з візуалізаціями перед закриваючим тегом body charts_html = "