KPI za "rok" končí dneškem — doklad s budoucím datem zmizí
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Uživatel vystaví doklad s datem o pár dní dopředu (typicky ke konci měsíce nebo k datu plnění). Doklad je v seznamu, je vidět ve sloupcovém grafu za daný měsíc — ale hlavní KPI “za tento rok” ho nezapočítá. Součet měsíců v grafu se nerovná číslu v KPI a uživatel hlásí, že “to špatně počítá”.
Root cause
Sekce “Root cause”Období „rok” bylo implementované jako year-to-date a horní hranice se uzavírala dnešním dnem:
-- KPIWHERE issue_date >= date_trunc('year', CURRENT_DATE) AND issue_date < CURRENT_DATE + INTERVAL '1 day' -- ⚠ ořízne budoucnostGraf nad týmiž daty žádnou horní hranici neměl (generoval měsíce a seskupoval
podle date_trunc('month', issue_date)), takže doklad s budoucím datem v něm
zůstal. Stejná nekonzistence vznikla i mezi obdobími: filtr „měsíc” používal
date_trunc('month', …) + INTERVAL '1 month', tedy celý měsíc včetně budoucích
dnů — přepnutím filtru se číslo skokově změnilo.
Datum vystavení není měřením minulosti; je to atribut dokladu, který uživatel smí zadat dopředu. Jakmile se nad ním staví okno končící „dneškem”, část dat tiše zmizí.
Fix
Sekce “Fix”Období „rok” = celý kalendářní rok, srovnávací období = celý předchozí rok:
-- předP_START = date_trunc('year', CURRENT_DATE)P_END = CURRENT_DATE + INTERVAL '1 day'
-- poP_START = date_trunc('year', CURRENT_DATE)P_END = date_trunc('year', CURRENT_DATE) + INTERVAL '1 year'Popisek srovnání se musí změnit spolu s tím (z „vs stejné období loni” na „vs celý loňský rok”) — jinak lže druhým směrem.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -n "CURRENT_DATE + INTERVAL '1 day'"a obecně každá horní hranice odvozená odnow()/CURRENT_DATEnad sloupcem, který zadává uživatel (datum vystavení, splatnosti, plnění, plánovaného dodání). Kontrolní test:SUM(měsíce z grafu) == KPI za rok. - Anti-pattern: hranice období definované na dvou místech (jednou pro KPI, podruhé v CTE pro graf) v různém tvaru.
- Lepší přístup: hranice počítat jednou (
P_START/P_END) a předat je všem dotazům dané obrazovky. Pokud je „do dneška” opravdu záměr, musí to platit i pro graf a musí to být v UI napsané.
Sister bugs / související
Sekce “Sister bugs / související”Příbuzná třída chyb: agregace, která tiše vynechá část řádků kvůli filtru,
o kterém uživatel neví (stav DRAFT, měna, smazané řádky). Uživatel vidí
jedno číslo a nemá jak zjistit, co v něm není — proto musí popisek období
i filtru odpovídat tomu, co dotaz skutečně dělá.