# Raporty — Analityka pracy

> Raportuj godziny pracy z wielu projektów jednocześnie

Globalne raporty pracy z filtrowaniem po projektach, użytkownikach, sprintach i zakresie dat. Eksport do PDF dla stakeholderów. Oddzielne śledzenie wpisów AI vs. ręcznych.

## Funkcje

- **Cross-project agregacja**: Jeden widok raportów ze wszystkich projektów. Superuser widzi wszystko, członek projektu widzi tylko swoje projekty.
- **Multi-select filtry**: Wybierz wiele projektów, użytkowników i sprintów jednocześnie. Zakres dat z domyślnymi ostatnimi 30 dniami.
- **Statystyki**: Łączne godziny, średnia na wpis, liczba unikalnych użytkowników, podział wpisów AI vs. ręczne.
- **Eksport PDF**: Sformatowany raport generowany server-side przez weasyprint. Gotowy do wysłania stakeholderom.
- **Tabela wpisów**: Użytkownik, klucz ticketu (PIM-1), sprint, data, godziny, opis. Paginacja po 20 wpisów.
- **Wykrywanie wpisów AI**: Flaga created_via_ai na każdym wpisie. Oddzielne liczniki dla AI i ręcznych wpisów.

## Jak to działa

1. **Otwórz Raporty**: Dashboard raportów jest globalny — nie wymaga wybrania projektu. Widoczny z głównej nawigacji.
2. **Ustaw filtry**: Wybierz projekty, użytkowników i sprinty. Domyślnie: wszystkie projekty, ostatnie 30 dni.
3. **Przejrzyj statystyki**: Na górze widoczne podsumowanie: łączne godziny, średnia, użytkownicy, podział AI/ręczne.
4. **Eksportuj do PDF**: Kliknij przycisk eksportu — raport generuje się server-side i pobiera jako PDF.

## AI i MCP

Raporty agregują dane logowane przez narzędzie log_time w module Scrum. Agent AI loguje czas pracy przez MCP — wpisy oznaczane automatycznie jako AI.

- `log_time`: Zaloguj czas pracy do ticketu (w module Scrum). Wpis oznaczony jako AI-created.
- `list_tickets`: Przejrzyj tickety z zalogowanym czasem
- `get_ticket`: Szczegóły ticketu z listą wpisów czasu

## Szczegóły techniczne

- **Agregacja**: Serwisowa warstwa agreguje godziny per projekt, sprint i użytkownik. Filtry walidowane przeciwko uprawnieniom.
- **PDF**: weasyprint generuje PDF server-side. CSS styling w szablonie HTML.
- **AI detection**: Flaga created_via_ai na modelu TimeTrackingEntry. Wpisy z MCP automatycznie oznaczane.
- **Uprawnienia**: Superuser widzi wszystkie projekty. Członek widzi tylko projekty, do których należy.