# Karta definicji miary i odbioru aplikacji

Materiał roboczy, 12.10.2026. Własne pliki: CC BY 4.0. Wypełnia właściciel
miary z wykonawcą. Przykład dotyczy raportowania zarządczego; nie określa
przychodu podatkowego ani zasad sprawozdawczości finansowej.

## Wypełniony przykład jednej miary

| Pole | Ustalenie w demonstracji |
| --- | --- |
| Identyfikator i wersja | sales_net_before_returns, v1 |
| Nazwa widoczna | Sprzedaż netto po rabatach, przed zwrotami |
| Jednostka | PLN; kwoty zapisane jako dziesiętne, 2 miejsca |
| Ziarno danych | Jeden wiersz na unikalny order_id; jeden oddział na zamówienie |
| Wzór | Suma list_net_pln minus discount_net_pln |
| Statusy | Wyłącznie fulfilled; status w wyciągu syntetycznym |
| Okres i pole czasu | ordered_at_utc przeliczone na Europe/Warsaw; [2026-09-01 00:00, 2026-10-01 00:00) |
| Zwroty | Poza tą miarą; osobne miary zdarzeniowa i kohortowa |
| Braki i zera | Brak ceny/rabatu odrzuca dane do uzupełnienia; zero jest liczbą; koszt nie jest potrzebny do tej miary |
| Marża jako osobna miara | Brak kosztu A04 zatrzymuje pełny wynik; częściowy wynik musi mieć zakres; koszt 0 A07 pozostaje w obliczeniu |
| Tożsamość i zakres | Użytkownik WAW widzi tylko wiersze oddziału WAW, także w szczegółach i eksporcie |
| Filtry | Te same zakresy czasu, statusu i oddziału w karcie, tabeli i eksporcie |
| Źródło i odświeżenie | Plik dashboard-ai-zamowienia.csv, syntetyczny stan ustalony w protokole z 12.10.2026 |
| Wynik ogólny | 3000,00 PLN, A01/A02/A03/A04/A07/A09 |
| Wynik WAW | 1600,00 PLN, A01/A02/A07 |
| Właściciel zatwierdzający | Do wskazania w firmie |

## Formularz do własnej aplikacji

Nazwa i wersja miary: .....................................................
Właściciel biznesowy / data akceptacji: ...................................
Widoczna nazwa / jednostka / waluta: ......................................
Wzór i ziarno danych / reguła duplikatów: ..................................
Źródło / identyfikator wyciągu / data aktualności: .........................
Pole czasu / strefa / dolna i górna granica: ...............................
Statusy / rabaty / zwroty / moment ich uwzględnienia: ......................
Puste wartości / potwierdzone zera / błędy źródłowe: .......................
Rola testowego użytkownika / dozwolone oddziały: ...........................
Filtry wspólne dla karty, szczegółów i eksportu: ...........................
Oczekiwany wynik / oczekiwane identyfikatory wierszy: .......................
Zaokrąglenie / tolerancja porównania: .....................................

## Próby odbiorowe i wymagane dowody

| Próba | Wynik oczekiwany w przykładzie | Dowód od wykonawcy |
| --- | --- | --- |
| Suma i tożsamość wierszy | 3000,00 z sześciu wskazanych order_id | Zapytanie albo zapis obliczenia i eksport wkładu każdego wiersza |
| Czas przy granicy | A09 wchodzi; A08 nie wchodzi do września w Warszawie | Czas UTC i lokalny w szczegółach |
| Statusy | A05 cancelled i A06 paid wyłączone | Filtr i lista odrzuconych wierszy |
| Zwrot innego miesiąca | R02 tylko w zdarzeniowej; R03 tylko w kohortowej | Powiązanie return_id z order_id i datą |
| Brak kosztu i koszt zerowy | A04 zatrzymuje pełną marżę; A07 pozostaje w częściowej | Oddzielny sygnał braku danych, bez zamiany na zero |
| Dozwolony WAW | A01/A02/A07; 1600,00 | Wynik z tożsamością rzeczywistej roli testowej |
| Celowo wadliwy wybór | A01/A02/A04; 1600,00, lecz odmowa odbioru | A04 spoza zakresu oraz pominięty A07 |
| Szczegóły i eksport | Identyczny dozwolony zbiór jak w karcie | Osobne przejście każdą drogą dostępu |

Ten pakiet sprawdza lokalne listy danych. Serwerowe uprawnienia, szczegóły
interfejsu i eksport gotowej aplikacji trzeba sprawdzić na jej instancji;
nasz skrypt ich nie testował.

## Jawne sprostowanie po znalezieniu różnicy

Nie zmieniaj po cichu formuły lub etykiety do uzyskania spodziewanej sumy.
Ustal, czy błąd leży w źródłowym wierszu, definicji, filtrze czy prezentacji.
Zapisz identyfikator wiersza, poprzednią wartość, zmianę, powód i osobę
zatwierdzającą. Dołącz wersję źródła i miary, oba wyniki oraz datę odświeżenia.
Powtórz próby czasu, braków i uprawnień; udokumentuj nowy wynik.

W przykładzie nie korygujemy braku kosztu A04 fikcyjnym zerem. Uzupełnienie
wymaga prawdziwej wartości ze źródła. Zmiana definicji zwrotów wymaga nowej
nazwy albo jawnego opisu okresu. Zmiana zakresu dostępu wymaga poprawy
reguły po stronie systemu obsługującego dane.