Práce s Leady :: Strýček Příhoda

Krok 0 – Struktura složek a souborů

Hlavní složka: C:\Users\Lenovo\OneDrive\Plocha\stahování kontaktů\
Spustitelný soubor GUI:
- dist\kontakty_gui.exe – hlavní aplikace pro všechny kroky (report, balíčky, měsíce).
Python skripty (podklad pro GUI, běžně se nespouštějí ručně):
- seznam_report_merge.py – stažení a sloučení reportů z e‑mailu
- rozdeleni_balicku.py – rozdělení kontaktů do balíčků po 200
- rozdeleni_do_mesicu.py – rozdělení balíčků do měsíců podle počtu pracovních dní
Důležité Excel soubory:
- combined_report.xlsx – sloučený report ze skriptu
- contacts_clean.xlsx – vyčištěné kontakty
- záloha kontaktů.xlsx – záloha
Podsložky:
- balíčky – výstup z rozdělení do balíčků
- balíčky měsíc – výstup z rozdělení do měsíců
- VSLeady – další zdrojová data (podle potřeby)

Rychlý přehled funkcí v GUI

Tlačítko v aplikaci	Co provede	Vstup	Výstup
`Stáhnout a sloučit report`	Spustí logiku ze `seznam_report_merge.py`	Přílohy z e‑mailu (reporty)	`combined_report.xlsx` (+ případně `contacts_clean.xlsx`)
`Rozdělit do balíčků`	Spustí logiku ze `rozdeleni_balicku.py`	`combined_report.xlsx` nebo `contacts_clean.xlsx`	Soubory v `balíčky`, balíčky kontaktů po 200 ks
`Rozdělit do měsíců`	Spustí logiku ze `rozdeleni_do_mesicu.py`	Balíčky z podsložky `balíčky`	Měsíční složky/soubory v `balíčky měsíc`

Prvky v okně aplikace

Hlavní tlačítka jsou tučná pro lepší přehled (každé odpovídá jednomu kroku workflow).
Dole v okně je progress lišta, která ukazuje průběh právě běžícího kroku.
Vpravo dole je tlačítko Zastav akci, které se pokusí aktuální běh bezpečně ukončit (pokud to daný krok umožňuje).

Progress lišta se může některé okamžiky zdát „zamrzlá“, pokud skript zrovna intenzivně pracuje. V takovém případě nepanikař, počkej pár sekund – pokud Windows hlásí „neodpovídá“ dlouhodobě, můžeš zkusit Zastav akci nebo aplikaci zavřít.

Vzhled okna aplikace

Umístění souborů a popis

Ukázka struktury složek a souvisejících souborů pro zpracování kontaktů:

Hlavní okno aplikace

Takto vypadá hlavní okno aplikace kontakty_gui.exe s tlačítky, progress lištou a tlačítkem Zastav akci:

Krok 1 – Stažení a sloučení reportů z e‑mailu

GUI – tlačítko „Stáhnout a sloučit report“

Účel

Automaticky stáhnout přílohy z e‑mailu a vytvořit sloučený report combined_report.xlsx.

Postup v aplikaci

Spusť kontakty_gui.exe (ideálně přes zástupce, který ukazuje na dist\kontakty_gui.exe).
V okně klikni na tlačítko Stáhnout a sloučit report.
Dole sleduj progress lištu, která ukazuje průběh stahování a zpracování.
Po dokončení se zobrazí hláška o úspěchu nebo chybě (např. chybějící přílohy).

Výsledek

Ve složce se objeví / aktualizuje combined_report.xlsx (hlavní zdroj pro další kroky).
Doporučeno: udělat si kopii jako záloha kontaktů.xlsx před dalšími úpravami.

Krok 2 – Rozdělení kontaktů do balíčků po 200

GUI – tlačítko „Rozdělit do balíčků“

Účel

Vytvořit z hlavního seznamu balíčky kontaktů (xlsx) po 200 kusech.

Příprava

Ujisti se, že vstupní soubor (např. contacts_clean.xlsx nebo combined_report.xlsx) odpovídá tomu, co očekává logika skriptu.
Zkontroluj, že složka balíčky je prázdná nebo obsahuje pouze staré balíčky, které můžeš přepsat.

Postup v aplikaci

V okně klikni na tlačítko Rozdělit do balíčků.
Během zpracování sleduj progress lištu dole; u větších souborů může postupovat po „skocích“.
Proces můžeš v nouzi přerušit tlačítkem Zastav akci (nedokončené výstupy pak raději smaž a spusť znovu).

Výsledek

Vytvoří se soubory v podsložce balíčky – balíčky kontaktů po 200 (např. balicek_01.xlsx, balicek_02.xlsx atd.).

Pokud někdy změníš limit (200 → jiný počet), upravíš pouze logiku příslušného Python skriptu; používání tlačítka v GUI zůstává stejné.

Krok 3 – Rozdělení balíčků do měsíců

GUI – tlačítko „Rozdělit do měsíců“

Účel

Rozdělit kontakty z balíčků do měsíčních složek podle počtu pracovních dnů v daném měsíci.

Příprava

Ve složce balíčky musí být připravené balíčky z předchozího kroku.
Ujisti se, že složka balíčky měsíc je připravená jako cílová (prázdná nebo s daty, která lze přepsat).

Postup v aplikaci

V okně klikni na tlačítko Rozdělit do měsíců.
Progress lišta dole ukazuje průběh – rozdělování může být rychlé, nebo naopak chvíli trvat podle objemu dat.
Po dokončení se zobrazí informace o počtu vytvořených měsíčních souborů/složek.

Princip

Logika spočítá počet pracovních dnů v cílovém měsíci (bez víkendů, případně i bez svátků – dle nastavení ve skriptu).
Kontakty z balíčků rozdělí do měsíčních složek/souborů tak, aby odpovídal plánovaný počet kontaktů na den.

Výsledek

Ve složce balíčky měsíc vzniknou měsíční složky/soubory s kontakty připravené na zpracování po dnech.

Krok 4 – Záloha a úklid

MANUÁLNÍ

Doporučení

Hotové měsíční kontakty přesuň do archivu (např. Archiv\YYYY_MM).
Soubory combined_report.xlsx a contacts_clean.xlsx si pravidelně zálohuj jako záloha kontaktů.xlsx.
Staré balíčky a mezivýstupy ve složkách balíčky a balíčky měsíc průběžně mazej, ať máš jasno, co je aktuální.

Poznámky k přesunu na jiný počítač

Celou složku stahování kontaktů (včetně dist a podsložky Manuál) přenes na nový počítač.
Zkontroluj, že zástupce na ploše ukazuje na správnou cestu k dist\kontakty_gui.exe.
Pokud mají Python skripty někde natvrdo cesty k podsložkám, je nutné je upravit i tam (jiný uživatel/jiná cesta).