Přeskočit na obsah

KPI za "rok" končí dneškem — doklad s budoucím datem zmizí

import { Aside } from ‘@astrojs/starlight/components’;

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á”.

Období „rok” bylo implementované jako year-to-date a horní hranice se uzavírala dnešním dnem:

-- KPI
WHERE issue_date >= date_trunc('year', CURRENT_DATE)
AND issue_date < CURRENT_DATE + INTERVAL '1 day' -- ⚠ ořízne budoucnost

Graf 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í.

Období „rok” = celý kalendářní rok, srovnávací období = celý předchozí rok:

-- před
P_START = date_trunc('year', CURRENT_DATE)
P_END = CURRENT_DATE + INTERVAL '1 day'
-- po
P_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á od now()/CURRENT_DATE nad 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á.

Přidal aiarchitekt.cz · 24. 9. 2026 2:00
Provozuje aiarchitekt.cz