Skript, ktorý vie, ako vyzerá bežný týždeň

Toto je osobný, nekomerčný vedľajší projekt, ktorý som si pripravil na učenie — nie je to produkt ani služba.

Príspevok #16 tvrdil, že nezvyčajná platba vynikne len voči bežnej. Nižšie je malý prototyp, ktorý z vzorových dát postaví to „bežné" a skontroluje voči nemu jeden týždeň.

Skontrolovaných vzorových platieb

Označená na druhý pohľad

3,4×

Označená suma oproti obvyklej u dodávateľa

Skript nerozhoduje, či je platba v poriadku. Len zapíše na jedno miesto, čo za bežné považuje história každého dodávateľa, a ukáže, kde s tým tento týždeň nesúhlasí.

Vzorové dáta

Osemnásť vymyslených dodávateľov, deväť týždňov platieb a jeden týždeň na kontrolu. Pre každého dodávateľa skript postaví základňu z predchádzajúcich týždňov: obvyklú sumu a rozptyl, obvyklý deň v týždni a účty, ktoré používal.

payments.csv — vzorové dáta, šesť z osemnástich dodávateľov

Dodávateľ	Obvyklá suma	Obvyklý deň	Tento týždeň	Výsledok
Raw Materials Supplier	≈ 18 262	Ut	3 platby	V pásme
Freight Carrier	≈ 2 853	Št	4 platby	V pásme
Maintenance Contractor	≈ 4 214	Ut	2 platby	Označená
Software Platform	2 400 (pevná)	Ut	1 platba	V pásme
Courier Services	≈ 415	Št	4 platby	V pásme
Insurance Broker	5 200 (pevná)	Št	1 platba	V pásme

Ako to funguje

Načítanie platiebNačíta CSV s jedným riadkom na platbu: id, dátum, dodávateľ, suma, účet.

Základňa pre každého dodávateľaZ platieb pred kontrolovaným týždňom: medián sumy, robustný rozptyl, obvyklý deň v týždni, známe účty.

Kontrola týždňaKaždá platba sa porovná so základňou vlastného dodávateľa, nie s globálnym limitom.

Označenie a vysvetleniePlatbu označí suma mimo pásma, opakovaná suma alebo nový účet. Nezvyčajný deň v týždni sa zobrazí len ako kontext.

Výpis výsledkuVypíše každú označenú platbu s dôvodmi. Nič sa neblokuje, nezadržiava ani neodosiela.

Vyskúšajte si to

1 — Naklonujte repozitár

# ten istý osobný, nekomerčný repozitár ako pri predchádzajúcich demách v tejto sérii
git clone https://github.com/LuliBobo/cfo-agents.git
cd cfo-agents

2 — Pridajte vlastné platby (voliteľné)

id,date,supplier,amount,account
P0004,2026-08-04,Packaging Supplier,6581,ACC-PAC1
P0349,2026-10-02,Maintenance Contractor,14400,ACC-MAI2
# ...pridajte toľko riadkov, koľko máte platieb; nechajte pár týždňov histórie pred kontrolovaným týždňom

3 — Spustite skript

python anomaly_watch_agent.py data/payments.csv

4 — Prečítajte si výstup

================================================================
  Anomaly Watch Agent — Unusual Payment Check
================================================================

[Step 1] Loaded 378 payment(s) from CSV
[Step 2] Built a baseline per supplier from 336 payment(s) before 2026-09-28
[Step 3] Checking 42 payment(s) in the week of 2026-09-28 against each supplier's own history

P0349  2026-10-02 Fri  Maintenance Contractor   14,400  ⚠ amount 3.4x usual (4,214 +/- 261) · new account for this supplier · usual day Tue

[Step 4] 1 of 42 payment(s) flagged
[Step 5] Nothing is blocked or sent — a person looks at each flag

5 — Zmeňte toleranciu

# úzke pásmo, len kontrola sumy
python anomaly_watch_agent.py data/payments.csv --tolerance 1.5 --signals amount
[Step 4] 9 of 42 payment(s) flagged

# veľmi voľné pásmo, len kontrola sumy
python anomaly_watch_agent.py data/payments.csv --tolerance 60 --signals amount
[Step 4] 0 of 42 payment(s) flagged

Z čoho je vyrobený

Zdroj dát

Obyčajné CSV s platbami — žiadne prepojenie na banku ani ERP, nič nad rámec vzorových dát.

Výpočet

Bežný Python bez externých knižníc — medián, robustný rozptyl a tri kontroly.

Nastaviteľné

Tolerancia, okno opakovania a použité signály sú parametre príkazového riadku, nie pevne zadané hodnoty.

Len na čítanie

Skript iba číta a reportuje. Nezadrží, neblokuje ani neodošle ani jednu platbu a nenahrádza kontroly, ktoré organizácia už má.

Čo je v repozitári

Ten istý osobný, nekomerčný repozitár ako pri predchádzajúcich demách v tejto sérii:

anomaly_watch_agent.py — celý skript použitý vyššie
data/payments.csv — vzorové dáta z tohto postupu
Collections Priority Agent z príspevku #12, Invoice Priority Agent z príspevku #11, Idle Cash Agent z príspevku #10, FX Monitoring Agent z príspevku #9 a Invoice Agent z príspevku #3

Zobraziť na GitHub Späť na príspevok #16

Sledujte sériu

Príspevok #17 sa pozrie na iné slepé miesto: maržu na jednom produkte alebo zákazníkovi a ako sa môže prepadnúť do mínusu, bez toho, aby si to niekto všimol v mesačnom priemere.

Odoberať zadarmo

Žiadny spam. Jeden príspevok týždenne. Odhlásenie kedykoľvek.