Clock_out_Time_Calculator/ui/chart_widget.py

"""
matplotlib 기반 차트 위젯.

stats_view에서 주간/월간 추세를 시각화. matplotlib 미설치 시
ImportError 안내 라벨로 fallback.
"""
from typing import List, Tuple

from PyQt5.QtWidgets import QWidget, QVBoxLayout, QLabel
from PyQt5.QtCore import Qt

try:
    import matplotlib
    from matplotlib.figure import Figure
    # frozen(main.exe) 빌드는 PyInstaller matplotlib hook이 'QtAgg'(backend_qtagg)만
    # 번들함 → backend_qt5agg import가 실패해 차트가 안 뜨던 문제.
    # 번들된 backend_qtagg를 우선 사용하고, 구버전(dev) 호환으로 qt5agg 폴백.
    try:
        from matplotlib.backends.backend_qtagg import FigureCanvasQTAgg as FigureCanvas
    except Exception:
        from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg as FigureCanvas
    matplotlib.rcParams['font.family'] = ['NanumSquare', 'Malgun Gothic', 'Apple SD Gothic Neo', 'sans-serif']
    matplotlib.rcParams['axes.unicode_minus'] = False
    _MPL = True
except Exception as _mpl_err:
    # ImportError 외 backend/sip 로딩 오류도 폴백 처리 + 실제 원인 기록(진단용)
    _MPL = False
    try:
        from utils.debug_log import dlog
        dlog(f"chart_widget: matplotlib unavailable: {type(_mpl_err).__name__}: {_mpl_err}")
    except Exception:
        pass


# 차트 색상 — 배경/그리드/텍스트는 현재 테마를 따름(_refresh_chart_colors),
# 막대/선은 데이터 구분용 고정 색.
_CHART_BG = '#25262B'
_CHART_GRID = '#2C2E33'
_CHART_TEXT = '#909296'
_CHART_BAR_NORMAL = '#4DABF7'  # accent blue
_CHART_BAR_OVERTIME = '#ff90b8'  # pink (데이터 구분용)
_CHART_BAR_WEEKEND = '#fcd34d'  # gold (데이터 구분용)
_CHART_AVG_LINE = '#51CF66'  # green


def _refresh_chart_colors() -> None:
    """배경/그리드/텍스트 색을 현재 앱 테마로 갱신 (라이트/다크 추종)."""
    global _CHART_BG, _CHART_GRID, _CHART_TEXT
    try:
        from ui.styles import ThemeColors
        _CHART_BG = ThemeColors.get('bg_secondary')
        _CHART_GRID = ThemeColors.get('border_subtle')
        _CHART_TEXT = ThemeColors.get('text_secondary')
    except Exception:
        pass


def _apply_dark_axes(ax) -> None:
    """차트 ax에 다크 테마 적용 — 텍스트, 그리드, spines, 배경."""
    ax.set_facecolor(_CHART_BG)
    ax.tick_params(axis='both', colors=_CHART_TEXT)
    ax.xaxis.label.set_color(_CHART_TEXT)
    ax.yaxis.label.set_color(_CHART_TEXT)
    ax.title.set_color(_CHART_TEXT)
    for spine in ax.spines.values():
        spine.set_color(_CHART_GRID)
    ax.grid(axis='y', alpha=0.25, color=_CHART_GRID)


def _apply_dark_figure(fig) -> None:
    """figure 배경을 현재 테마 톤으로 (모든 draw_* 진입점에서 호출됨)."""
    _refresh_chart_colors()
    fig.patch.set_facecolor(_CHART_BG)


class _Fallback(QWidget):
    """matplotlib 미설치 시 안내."""
    def __init__(self, message: str):
        super().__init__()
        layout = QVBoxLayout()
        label = QLabel(message)
        label.setAlignment(Qt.AlignCenter)
        label.setWordWrap(True)
        label.setStyleSheet("color: #909296; padding: 20px;")
        layout.addWidget(label)
        self.setLayout(layout)


def make_chart_widget(parent=None) -> QWidget:
    """차트가 그려질 빈 캔버스 위젯. matplotlib 없으면 fallback."""
    if not _MPL:
        return _Fallback("차트 표시에는 matplotlib가 필요합니다.\npip install matplotlib")
    _refresh_chart_colors()
    widget = QWidget(parent)
    widget.setStyleSheet(f"background: {_CHART_BG}; border-radius: 8px;")
    layout = QVBoxLayout()
    layout.setContentsMargins(0, 0, 0, 0)
    fig = Figure(figsize=(5, 3), dpi=100, tight_layout=True, facecolor=_CHART_BG)
    canvas = FigureCanvas(fig)
    canvas.setStyleSheet(f"background: {_CHART_BG};")
    layout.addWidget(canvas)
    widget.setLayout(layout)
    widget._figure = fig
    widget._canvas = canvas
    return widget


def draw_daily_hours(widget: QWidget, records: List[dict]) -> None:
    """일별 근무시간 막대 그래프 (호버 시 정확한 수치 툴팁)."""
    if not getattr(widget, '_figure', None):
        return
    fig = widget._figure
    fig.clear()
    _apply_dark_figure(fig)
    if not records:
        ax = fig.add_subplot(111)
        _apply_dark_axes(ax)
        ax.text(0.5, 0.5, '기록 없음', ha='center', va='center',
                  transform=ax.transAxes, color=_CHART_TEXT, fontsize=11)
        widget._canvas.draw()
        return

    dates = [r['date'][5:] for r in records]  # MM-DD만
    full_dates = [r['date'] for r in records]
    hours = [r.get('total_hours', 0) or 0 for r in records]
    overtimes = [(r.get('overtime_minutes', 0) or 0) / 60 for r in records]
    base = [max(h - o, 0) for h, o in zip(hours, overtimes)]

    ax = fig.add_subplot(111)
    bars_base = ax.bar(dates, base, label='정상', color=_CHART_BAR_NORMAL)
    bars_ot = ax.bar(dates, overtimes, bottom=base, label='연장',
                       color=_CHART_BAR_OVERTIME)
    ax.set_ylabel('시간')
    legend = ax.legend(loc='upper left', fontsize=8, facecolor=_CHART_BG,
                          edgecolor=_CHART_GRID, labelcolor=_CHART_TEXT)
    ax.tick_params(axis='x', labelrotation=45, labelsize=8)
    _apply_dark_axes(ax)

    # 호버 annotation 설정
    annot = ax.annotate(
        "", xy=(0, 0), xytext=(15, 15),
        textcoords="offset points",
        bbox=dict(boxstyle="round,pad=0.4", fc="#1a1a26", ec=_CHART_BAR_NORMAL,
                    alpha=0.95),
        color="white", fontsize=9,
        arrowprops=dict(arrowstyle="->", color=_CHART_BAR_NORMAL),
    )
    annot.set_visible(False)

    def on_hover(event):
        if event.inaxes != ax:
            if annot.get_visible():
                annot.set_visible(False)
                widget._canvas.draw_idle()
            return
        for bars, kind in ((bars_base, 'base'), (bars_ot, 'ot')):
            for i, bar in enumerate(bars):
                if bar.contains(event)[0]:
                    h = hours[i]; ot = overtimes[i]
                    text = f"▼ {full_dates[i]}\n근무 {h:.1f}h"
                    if ot > 0:
                        text += f"\n연장 +{ot:.1f}h"
                    annot.xy = (bar.get_x() + bar.get_width() / 2, bar.get_height() + bar.get_y())
                    annot.set_text(text)
                    annot.set_visible(True)
                    widget._canvas.draw_idle()
                    # 도전과제 #stat_chart_hover — 첫 발견 시 1회만 기록
                    db = getattr(widget, '_achievement_db', None)
                    if db is not None:
                        try:
                            if db.get_setting('chart_hover_discovered', 'false').lower() != 'true':
                                db.set_setting('chart_hover_discovered', 'true')
                        except Exception:
                            pass
                    return
        if annot.get_visible():
            annot.set_visible(False)
            widget._canvas.draw_idle()

    widget._canvas.mpl_connect("motion_notify_event", on_hover)
    widget._canvas.draw()


def draw_clock_in_distribution(widget: QWidget, records: List[dict]) -> None:
    """출근 시각 분포 히스토그램 (30분 빈)."""
    if not getattr(widget, '_figure', None):
        return
    fig = widget._figure
    fig.clear()
    _apply_dark_figure(fig)
    if not records:
        ax = fig.add_subplot(111)
        _apply_dark_axes(ax)
        ax.text(0.5, 0.5, '기록 없음', ha='center', va='center',
                  transform=ax.transAxes, color=_CHART_TEXT, fontsize=11)
        widget._canvas.draw()
        return

    minutes_list = []
    for r in records:
        ci = r.get('clock_in')
        if not ci:
            continue
        parts = ci.split(':')
        if len(parts) >= 2:
            try:
                minutes_list.append(int(parts[0]) * 60 + int(parts[1]))
            except ValueError:
                pass

    if not minutes_list:
        ax = fig.add_subplot(111)
        _apply_dark_axes(ax)
        ax.text(0.5, 0.5, '기록 없음', ha='center', va='center',
                  transform=ax.transAxes, color=_CHART_TEXT, fontsize=11)
        widget._canvas.draw()
        return

    bin_size = 30
    min_m = (min(minutes_list) // bin_size) * bin_size
    max_m = ((max(minutes_list) // bin_size) + 1) * bin_size
    bins = list(range(min_m, max_m + bin_size, bin_size))

    ax = fig.add_subplot(111)
    ax.hist(minutes_list, bins=bins, color=_CHART_BAR_NORMAL,
              edgecolor=_CHART_BG, linewidth=1)
    avg = sum(minutes_list) / len(minutes_list)
    ax.axvline(avg, color=_CHART_AVG_LINE, linestyle='--', linewidth=2,
                label=f'평균 {int(avg//60):02d}:{int(avg%60):02d}')
    ax.set_xticks([m for m in bins if m % 60 == 0])
    ax.set_xticklabels([f"{m//60:02d}:00" for m in bins if m % 60 == 0],
                       rotation=45, fontsize=8)
    ax.set_ylabel('일수')
    legend = ax.legend(loc='upper right', fontsize=8, facecolor=_CHART_BG,
                          edgecolor=_CHART_GRID, labelcolor=_CHART_TEXT)
    _apply_dark_axes(ax)
    widget._canvas.draw()


def draw_weekday_avg(widget: QWidget, records: List[dict]) -> None:
    """요일별 평균 근무시간 막대 그래프."""
    if not getattr(widget, '_figure', None):
        return
    fig = widget._figure
    fig.clear()
    _apply_dark_figure(fig)

    from datetime import datetime as _dt
    weekday_totals = [0.0] * 7
    weekday_counts = [0] * 7
    for r in records:
        try:
            d = _dt.strptime(r['date'], '%Y-%m-%d')
        except (ValueError, TypeError):
            continue
        weekday_totals[d.weekday()] += r.get('total_hours', 0) or 0
        weekday_counts[d.weekday()] += 1

    avg = [(t / c) if c else 0 for t, c in zip(weekday_totals, weekday_counts)]
    labels = ['월', '화', '수', '목', '금', '토', '일']

    ax = fig.add_subplot(111)
    colors = [_CHART_BAR_NORMAL] * 5 + [_CHART_BAR_WEEKEND] * 2  # 주말 골드 강조
    ax.bar(labels, avg, color=colors)
    ax.set_ylabel('평균 시간')
    _apply_dark_axes(ax)
    widget._canvas.draw()