Reprodukovatelná analýza dat: z jednorázového dotazu udělejte postup, který dá vždycky stejné číslo

Poraď mi, jestli tuhle analýzu zmrazit do spustitelného skriptu,
nebo ji nechat jako jednorázový dotaz v chatu.

Co dělám: [popis analýzy, např. měsíční přehled tržeb po kategoriích
a kanálech ze tří exportů]
Jak často: [jednou měsíčně]
Kdo výsledek dostane: [vedení, účtárna, klient]
Co se podle toho rozhoduje: [rozpočet na příští měsíc, výše provizí]
Jak velká data: [~40 tisíc řádků, roste o ~3 tisíce měsíčně]
Kdo to bude dělat, když nebudu: [nikdo / kolegyně z účtárny]

Odpověz strukturovaně:
1. Doporučení: chat / skript / skript s formálním schvalováním.
2. Zdůvodnění po jednotlivých kritériích, ne obecně.
3. Co by bylo potřeba zapsat, aby to zvládl někdo jiný.
4. Co se stane, když to nechám tak, jak to je — jaká chyba
   mi nejpravděpodobněji projde.
Rovnou napiš doporučení a přiznej, kde si nejsi jistý.

Než začneš cokoli počítat, projdi si soubor [název] a vypiš mi
rozhodnutí, která bys musel udělat za mě.

Chci přehled [co chci spočítat, např. tržby po měsících
a kategoriích za rok 2026].

Vypiš očíslovaný seznam otázek, na které potřebuješ mou odpověď,
seřazený podle toho, jak moc ovlivní výsledek. U každé napiš,
co konkrétně nevíš, jaké jsou možnosti, jak by se výsledek lišil
a co bys zvolil ty, kdybych neodpověděl.

Typicky mě zajímá: co se počítá jako jeden případ, které řádky
vyřadit, podle jakého data se řadí do období, jestli jsou částky
s daní a jak se zachází s prázdnými hodnotami.
Zatím nepočítej, jen se ptej.

Máme hotovo. Teď to, na čem jsme se právě shodli, zapiš do jednoho
spustitelného souboru, ať to příště nemusíš vymýšlet znovu.

Požadavky:
- Jeden soubor, název podle toho, co dělá: mesicni-prehled-trzeb.
- Nahoře komentářová hlavička: co soubor počítá, z jakých vstupů,
  co je výstup, kdy vznikl a kdo za obsah odpovídá.
- Všechno, co se mezi běhy mění (cesta ke vstupu, období, prahy),
  dej jako pojmenované hodnoty na jedno místo pod hlavičku.
  Nikde jinde ať se čísla ani cesty nepíšou natvrdo.
- Rozděl to na části: načtení, kontrola vstupu, čištění, výpočet,
  výstup do konzole i do CSV s datem v názvu.
- Nic navíc, co jsme si neřekli. Kde jsi musel něco předpokládat,
  napiš to do hlavičky jako otevřenou otázku pro mě.

Pak mi soubor ukaž celý a vysvětli česky, co dělá každá část.

Doplň do skriptu komentáře, ale ne popisné, nýbrž vysvětlující.
U každého kroku napiš:
- co se v něm děje běžnou češtinou,
- PROČ se to dělá — jaké obchodní pravidlo za tím stojí,
- co by se stalo, kdyby ten krok chyběl,
- kdo nebo co rozhodlo, že to má být takhle (kdo mi to potvrdil).

Zvlášť pečlivě okomentuj každý filtr a každou podmínku — u nich
chci vidět důvod, ne popis. Piš tak, aby to pochopil kolega,
který zná naši firmu, ale neprogramuje.
Komentáře česky, bez diakritiky nešetři.

Přidej do skriptu kontrolní výpisy, ať vidím, co se s daty děje.

Konkrétně:
- počet řádků hned po načtení souboru,
- počet řádků před a po každém filtru a rozdíl v absolutním čísle
  i v procentech,
- součet klíčové částky před a po čištění, ať vidím, kolik peněz
  filtrováním zmizelo,
- počet prázdných a nesmyslných hodnot ve sloupcích, které
  vstupují do výpočtu,
- počet unikátních kategorií a seznam těch, které se objevují
  méně než [pětkrát] — tam bývají překlepy.

Výpisy očísluj podle kroků postupu. Na konec dej souhrnný řádek:
kolik řádků vstoupilo, kolik vypadlo a kolik jich je ve výsledku.

mesicni-uzaverka/
  data/           exporty s datem v názvu, nikdy se nepřepisují
  vystup/         výsledky jednotlivých běhů, taky s datem
  mesicni-prehled-trzeb.sql   samotný výpočet
  definice.md     co znamenají pojmy a co jsme se rozhodli počítat
  navod.md        jak to spustit
  historie.md     co se kdy změnilo a proč

Projdi náš skript a vytáhni z něj všechna implicitní rozhodnutí,
která jsou v kódu, ale nikde nejsou vysvětlená.

Pro každé napiš, co skript dělá (s odkazem na řádek), jaké jiné
rozumné řešení by existovalo a kdy by na tom rozdílu záleželo.

Pak sestav soubor definice.md: seznam pojmů, které výpočet používá
(například [tržba, aktivní zákazník, měsíc, storno]), u každého
jednou větou definici, jak ji skript reálně používá, a poznámku,
kdo ji potvrdil.
U pojmů, u kterých jsem ti rozhodnutí nikdy nedal, napiš
NEPOTVRZENO a připoj otázku, kterou se mám zeptat.

Zaveď v téhle složce historii verzí přes git, ať se dá vrátit
k libovolné starší podobě výpočtu.

Nastav to takhle:
- Do historie patří skript, definice.md, navod.md a historie.md.
- Do historie NEPATŘÍ složka data/ ani vystup/ — jsou to velké
  soubory a jsou v nich provozní údaje. Nastav to tak, aby se
  tam nedostaly ani omylem.
- Ulož současný stav jako výchozí bod.

Pak mi na pěti řádcích vysvětli, co mám udělat pokaždé, když
skript změním, a jak si zobrazím rozdíl mezi dvěma verzemi.
Piš jako pro člověka, který git nikdy neviděl, s příkazy
k okopírování.

Od teď platí: kdykoli na můj pokyn skript změníš, ulož změnu
do historie s popisem v češtině, který říká, CO se věcně
změnilo (například „dobropisy se nově odečítají od tržby"),
ne technicky.

Nastav pravidelné spuštění tohoto postupu.

Kdy: [prvního každý měsíc v 7:00]
Co se má stát:
1. Spustit skript nad nejnovějším exportem ve složce data/.
2. Uložit výstup do vystup/ s datem v názvu.
3. Uložit i celý průběh běhu (kontrolní výpisy) do souboru v log/.
4. Poslat mi [e-mailem / do chatu] krátké shrnutí: hlavní čísla,
   kontrolní součty, co se liší proti minulému běhu a jestli
   běh skončil chybou.

Pravidla:
- Když ve složce data/ není novější export než minule,
  nic nepočítej a napiš mi, že chybí podklad.
- Když skript skončí chybou, pošli mi chybovou hlášku
  a nesnaž se to obcházet.
- Nikomu jinému nic neposílej a nic nezveřejňuj — výstup jde
  jen mně a rozhodnutí, co s ním, dělám já.

Napiš mi, kam se to nastavení uložilo a jak ho vypnu.

Přidej na začátek skriptu kontrolu vstupu, která ho zastaví,
když data nevypadají, jak mají.

Kontroluj:
- že soubor existuje a není prázdný,
- že obsahuje přesně očekávané sloupce — chybějící i neznámý
  sloupec navíc ať skript zastaví,
- že datový typ sedí (datum je datum, částka je číslo),
- že počet řádků je v rozumném rozmezí proti minulému běhu
  (odchylka nad [30] % ať skript zastaví),
- že se neobjevily nové kategorie, které postup nezná,
- že nejsou duplicity podle [číslo dokladu].

Když kontrola selže, skript ať skončí chybou a vypíše česky,
CO je špatně a co s tím mám udělat. Žádné automatické opravy,
žádné dopočítávání chybějících hodnot, žádné pokračování
s varováním — buď data sedí, nebo se nepočítá.

Vytvoř mi regresní kontrolu pro tenhle postup.

1. Z našich dat vyrob malý testovací vzorek (řádově [200] řádků)
   se všemi důležitými případy: běžné záznamy, storno, prázdné
   hodnoty, hraniční data na přelomu měsíce, duplicita, kategorie
   s překlepem. Osobní údaje nahraď smyšlenými.
2. Spusť nad ním skript a výsledek ulož jako očekávaný výstup.
3. Vypiš, jak jsi k jednotlivým číslům došel, ať je můžu ověřit ručně.
4. Připrav postup, který skript spustí nad vzorkem, porovná ho
   s očekávaným výstupem a při rozdílu vypíše, které číslo a o kolik.

Chci to pouštět pokaždé, než změněný skript nasadím na ostrá data.

Porovnej výstup dnešního běhu se souborem z minulého běhu.

Dnešní: [vystup/trzby-2026-08-01.csv]
Minulý: [vystup/trzby-2026-07-01.csv]

Vrať mi:
1. Tabulku: metrika, minule, dnes, rozdíl absolutně, rozdíl v %.
2. Které hodnoty se změnily o víc než [10] % — vypiš zvlášť.
3. Změny v období, které už je uzavřené (starší měsíce by se
   měnit neměly) — tyhle vypiš jako první, jsou nejpodezřelejší.
4. Nové a zmizelé kategorie nebo položky.
5. U každého většího rozdílu nabídni možná vysvětlení a napiš,
   čím si ho mám ověřit — v jakém systému a co tam mám hledat.

Netvrď, co se stalo. Vypiš, co je vidět, a co z toho plyne
za otázky pro mě.

Napiš mi zápis o dnešním běhu do souboru historie.md.

Podklady: [výstup skriptu + porovnání s minulým během].

Struktura (max 12 řádků):
- datum běhu a použitý vstupní soubor,
- hlavní čísla: [tržba celkem, počet dokladů, počet kategorií],
- kontrolní součty a jestli sedí s očekáváním,
- co se změnilo proti minulému běhu a jaké je vysvětlení,
- co zůstalo nevysvětlené a je potřeba dohledat,
- jestli se od minula měnil skript a jak,
- kdo výsledek schválil (nech prázdné, doplním).

Piš věcně. Kde vysvětlení neznáš, napiš „nevysvětleno" —
nedomýšlej si důvody.