Document SOGo mail filter workflow

docs/mail-sogo-change-log-2026-08-06.md

@@ -0,0 +1,285 @@
+# Provedene upravy SOGo - info@9b-plus.com
+
+Datum: 2026-08-06
+Rezim: upravy schvalene uzivatelem v SOGo
+
+## Pred upravami
+
+Stare nastaveni bylo ulozeno pred zasahem:
+
+- `docs/mail-sogo-old-settings-2026-08-06.json`
+- `docs/mail-sogo-old-settings-2026-08-06.md`
+- `docs/mail-sogo-audit-2026-08-06.md`
+
+## Provedene zmeny
+
+### Vytvorene slozky
+
+- `01 - Akcni - k reseni`
+- `07 - Reklamace`
+- `99 - Automaticky odfiltrovano`
+
+Poznamka: misto lomitka v `01 - Akcni / k reseni` byl pouzit spojovnik, protoze lomitko muze v IMAP znamenat hierarchii podslozek.
+
+### Prejmenovane slozky
+
+- `AAA - vyřízená konverzace` -> `90 - Archiv vyrizeno`
+- `B2B - faktury` -> `04 - B2B faktury a doklady`
+- `B2B - potvrzeni objednavky` -> `03 - B2B objednavky`
+- `B2C - potvrzení objednávky` -> `02 - Objednavky zakaznici`
+- `Dopravci - doručované zásilky` -> `05 - Dopravci - dorucovani`
+- `Dopravci - faktury atd.` -> `06 - Dopravci - dobirky a faktury`
+- `Google - ADS` -> `09 - Marketing a platformy`
+- `Recenze od zákazníků` -> `08 - Recenze`
+
+### Presun zprav
+
+- Z `Koš` bylo presunuto `5520` zprav do `99 - Automaticky odfiltrovano`.
+- Po presunu ukazoval `Koš` stav `Žádná zpráva`.
+- Cilova slozka `99 - Automaticky odfiltrovano` byla overena se stavem `5520 zprávy`.
+
+### Uprava cilu filtru
+
+Po prejmenovani slozek zustaly filtry napojene na stare nazvy nebo na `Koš`. Proto byly prepsany cilove slozky filtru:
+
+- `Koš` -> `99 - Automaticky odfiltrovano`
+- `B2B - faktury` -> `04 - B2B faktury a doklady`
+- `B2B - potvrzeni objednavky` -> `03 - B2B objednavky`
+- `B2C - potvrzení objednávky` -> `02 - Objednavky zakaznici`
+- `Dopravci - doručované zásilky` -> `05 - Dopravci - dorucovani`
+- `Dopravci - faktury atd.` -> `06 - Dopravci - dobirky a faktury`
+- `Recenze od zákazníků` -> `08 - Recenze`
+- `Google - ADS` -> `09 - Marketing a platformy`
+
+Celkem bylo zkontrolovano/upraveno 61 filtru:
+
+- 1 filtr byl nastaven na novy cil pri testovaci uprave
+- dalsich 60 filtru bylo nasledne presmerovano podle mapy vyse
+- hlavni `save` v SOGo byl potvrzen a po ulozeni bylo tlacitko `save` opet neaktivni
+
+## Overeni
+
+Kontrolne byly overeny tyto filtry po ulozeni:
+
+- `Smazat oznámení PKO - PayU` -> `99 - Automaticky odfiltrovano`
+- `B2B - faktury - Yate` -> `04 - B2B faktury a doklady`
+- `Dopravci - Balíkovna - Vezeme Vám balík` -> `05 - Dopravci - dorucovani`
+
+Kontrolni pruchod cteni vsech filtru po ulozeni se zastavil po 18 filtrech kvuli pomalemu otevreni jednoho dialogu v UI, ale prvnich 18 overenych filtru a tri cilene vzorky vcetne konce seznamu ukazovaly spravne cile.
+
+## Co zatim nebylo meneno
+
+- Zadna zprava nebyla smazana.
+- Zadny filtr nebyl smazan.
+- Nebylo zapnuto zadne preposilani.
+- Nebyly odeslany zadne e-maily.
+
+## Dodatecna uprava nazvu filtru
+
+Po strukturalnich zmenach byly prejmenovany vsechny filtry tak, aby byl primo v nazvu videt cil trideni.
+
+Format:
+
+`CILOVA_SLOZKA - ZDROJ - TYP_ZPRAVY`
+
+Priklady:
+
+- `03 B2B objednavky - Vertone - prijata objednavka`
+- `04 B2B faktury/doklady - Yate - faktura`
+- `05 Dopravci dorucovani - GLS - doruceno`
+- `99 Automaticky odfiltrovano - Fio/DPD - prijem COD`
+
+Mapa prejmenovani je ulozena zde:
+
+- `docs/mail-sogo-filter-rename-map-2026-08-06.json`
+- `docs/mail-sogo-filter-rename-map-2026-08-06.md`
+
+Overeni po reloadu SOGo:
+
+- pocet nazvu filtru: 61
+- prvni filtry zacinaji `99 Automaticky odfiltrovano...`
+- posledni overeny filtr: `05 Dopravci dorucovani - Balikovna - vezeme balik`
+
+## Dalsi doporucena faze
+
+1. Zkontrolovat, jestli neexistuji duplicity hlavne u DPD, GLS, PPL, Zasilkovny a Vertone.
+2. Rozhodnout, jestli spamovy OR filtr `99 Automaticky odfiltrovano - Spam domeny - blokovani` ponechat jako samostatny blacklist, nebo ho pozdeji rozdelit na citelnejsi jednotlive filtry.
+
+## Dodatecna uprava podminek filtru
+
+Byla doplnena ochrana proti odfiltrovani zive komunikace.
+
+Do 60 beznych filtru s rezimem `odpovidaji vsem nasledujicim pravidlum` byla doplnena podminka:
+
+- `Predmet` `neodpovida regularnimu vyrazu` `^(RE|Re|AW|Aw|FWD|Fwd)\s*:`
+
+Vynechan byl 1 filtr:
+
+- `99 Automaticky odfiltrovano - Spam domeny - blokovani`
+
+Duvod: tento filtr pouziva rezim `odpovidaji nekteremu z nasledujicich pravidel`, tedy OR logiku. Pridat do nej stejnou podminku by nebylo spolecnym guardem pro vsechny spamove podminky.
+
+Detailni log je ulozen zde:
+
+- `docs/mail-sogo-reply-guard-log-2026-08-06.md`
+
+## Pracovni agent pro priste
+
+Pro navazani v pristich sezenich byl zalozen agent/instruktazni soubor:
+
+- `.agents/sogo-mail-filter-agent.md`
+
+## Dodatecny presun slozek pod Dorucenou postu
+
+Na zaklade pozadavku uzivatele byly pod `Dorucena posta` presunuty slozky:
+
+- `01 - Akcni - k reseni`
+- `07 - Reklamace`
+- `99 - Automaticky odfiltrovano`
+
+Po presunu slozky `99 - Automaticky odfiltrovano` bylo nutne opravit cile filtru, protoze filtry ukazovaly placeholder `Postovni schranka`.
+
+Opraveno:
+
+- 17 filtru s prefixem `99 Automaticky odfiltrovano`
+- cil byl znovu nastaven na `99 - Automaticky odfiltrovano`
+- SOGo zmeny byly ulozeny hlavnim `save`
+
+Detailni log je ulozen zde:
+
+- `docs/mail-sogo-folder-inbox-move-log-2026-08-06.md`
+
+## Rucni trideni Inboxu mail po mailu
+
+Po predchozi chybne davce byl dalsi uklid provaden jen rucne po jednotlivych viditelnych zpravach. Presunuty byly pouze zpravy s jasnou shodou na existujici filtr nebo blacklist, vzdy po otevreni/overeni detailu.
+
+Provedene presuny:
+
+- `fordogtrainers.it` / `"Wegovy" ohne Spritze? Diese Kapsel schmilzt Fett .` -> `99 - Automaticky odfiltrovano`
+- `info@hoffmannkuechen.de` / `RE: "Wegovy" ohne Spritze? Diese Kapsel schmilzt Fett .` -> `99 - Automaticky odfiltrovano`
+- `HKTDC Conference` / `Register NOW: Belt and Road Summit 2026` -> `99 - Automaticky odfiltrovano`
+- `Thomas Brandstater - jt-Trading UG` / `New Balance, Adidas, Puma & Converse - neue Angebote / New Offers - KW 29/1` -> `99 - Automaticky odfiltrovano`
+- `Heureka.sk` / `Faktura - danovy doklad VS 2100037790` -> `99 - Automaticky odfiltrovano`
+- `Google Ads` / `Aktualizace sluzby: Zkontrolujte nastaveni strategii nabidek zalozenych na cili` -> `09 - Marketing a platformy`
+- `Google Ads` / `Udelejte dalsi krok k optimalizaci kampane PL-PL-3-LOW-PC` -> `09 - Marketing a platformy`
+- `reports@gls-czech.com` / `Aktualni stav jednotlivych baliku...` -> `06 - Dopravci - dobirky a faktury`
+- `Instagram` / `9bplus, podivejte se, co se deje na Instagramu` -> `99 - Automaticky odfiltrovano`
+- `HKTDC Exhibition` / `[CENTRESTAGE 2026] Announcing the CENTRESTAGE ELITES Designer!` -> `99 - Automaticky odfiltrovano`
+- `NOREPLY@dpd.cz` / `Dnes Vam dorucime balicek` -> `05 - Dopravci - dorucovani`
+
+Inbox po teto rucni casti: `364` zprav. Nejasne zpravy, zive odpovedi (`RE:`, `FW:`), objednavky z e-shopu, ucetni doklady a mozne nove spam vzory bez existujiciho pravidla byly ponechany v Inboxu.
+
+## Novy filtr Vertone B2B
+
+Na zaklade potvrzeni uzivatele byl 2026-08-07 v SOGo pridan novy filtr pro novy Vertone B2B rezim.
+
+Filtr:
+
+- nazev: `03 B2B objednavky - Vertone - objednavka vyrizena`
+- rezim: odpovidaji vsem nasledujicim pravidlum
+- podminky:
+  - `Odesilatel` je rovno `noreply@vert1.cz`
+  - `Predmet` obsahuje `Objednavka`
+  - `Predmet` obsahuje `byla prave vyrizena`
+  - `Predmet` neodpovida regularnimu vyrazu `^(RE|Re|AW|Aw|FWD|Fwd)\s*:`
+- akce: ulozit zpravu do `03 - B2B objednavky`
+
+Po ulozeni SOGo zobrazilo `Predvolby ulozeny`. Pocet filtru v DOM byl overen jako `62` a novy filtr byl pritomen v seznamu. Stare Vertone filtry nebyly mazany ani upravovany.
+
+Lokální evidence:
+
+- `docs/mail-sogo-current-filter-additions-2026-08-07.json`
+
+## Novy filtr Outdoor Concept B2B objednavky
+
+Na zaklade pozadavku uzivatele byl 2026-08-07 v SOGo pridan novy filtr pro potvrzeni B2B objednavky Outdoor Concept.
+
+Filtr:
+
+- nazev: `03 B2B objednavky - Outdoor Concept - objednavka prijata`
+- rezim: odpovidaji vsem nasledujicim pravidlum
+- podminky:
+  - `Odesilatel` je rovno `cpz@outdoorconcept.cz`
+  - `Predmet` obsahuje `OC B2B - Objednavka`
+  - `Predmet` obsahuje `prijata`
+  - `Predmet` neodpovida regularnimu vyrazu `^(RE|Re|AW|Aw|FWD|Fwd)\s*:`
+- akce: ulozit zpravu do `03 - B2B objednavky`
+
+Po ulozeni SOGo zobrazilo `Predvolby ulozeny`. Pocet filtru byl overen jako `64` a novy filtr byl pritomen v seznamu.
+
+Lokální evidence:
+
+- `docs/mail-sogo-current-filter-additions-2026-08-07.json`
+
+## Novy filtr Rock Empire B2B faktury
+
+Na zaklade potvrzeni uzivatele byl 2026-08-07 v SOGo pridan novy filtr pro B2B faktury Rock Empire.
+
+Filtr:
+
+- nazev: `04 B2B faktury/doklady - Rock Empire - faktura B2B`
+- rezim: odpovidaji vsem nasledujicim pravidlum
+- podminky:
+  - `Odesilatel` je rovno `jakub.kurfirt@rockempire.cz`
+  - `Predmet` obsahuje `Fakta - B2B`
+  - `Predmet` neodpovida regularnimu vyrazu `^(RE|Re|AW|Aw|FWD|Fwd)\s*:`
+- akce: ulozit zpravu do `04 - B2B faktury a doklady`
+
+Po ulozeni SOGo zobrazilo `Predvolby ulozeny`. Pocet filtru v DOM byl overen jako `63` a novy filtr byl pritomen v seznamu. Stavajici Rock Empire filtr na objednavky z `b2b@rockempire.cz` nebyl menen.
+
+Lokální evidence:
+
+- `docs/mail-sogo-current-filter-additions-2026-08-07.json`
+
+## Hromadny presun starych zprav podle existujicich filtru
+
+Na zaklade pozadavku uzivatele byly v SOGo hromadne vyhledany a presunuty stare zpravy z `Dorucena posta`, ktere odpovidaly uz existujicim filtrum. Nebyly vytvareny nove filtry a zpravy nebyly mazany.
+
+Provedene davky:
+
+- `PPL - Prevzali jsme Vasi/vasi zasilku`: 41 zprav -> `05 - Dopravci - dorucovani`
+- `DPD - Vas balicek je na ceste`: 98 zprav -> `05 - Dopravci - dorucovani`
+- `Pinguin - Potvrzeni objednavky ze systemu B2B`: 12 zprav -> `03 - B2B objednavky`
+- `Sea to Summit Order Confirmation Order`: 14 zprav -> `03 - B2B objednavky`
+- `Zasilkovna - Prehled vybranych dobirek`: 229 zprav -> `99 - Automaticky odfiltrovano`
+
+U jednotlivych davek byl pred presunem overen pocet vybranych zprav v SOGo a po presunu bylo zkontrolovano, ze vysledky hledani zmizely nebo ukazaly `Zadna zprava`.
+
+## Hromadny uklid a obnova po chybne davce
+
+Pri dalsim hromadnem uklidu byly presouvany jasne davky podle existujicich filtru. Behem davky `Dropbox - Last week's updates in your shared folders` vratilo SOGo hledani chybne cely Inbox misto maleho Dropbox vysledku. Dalsi prace byla okamzite zastavena, slozka `99 - Automaticky odfiltrovano` byla otevrena a bylo potvrzeno, ze se do ni omylem dostaly i zive zpravy z Inboxu.
+
+Obnova:
+
+- obsah `99 - Automaticky odfiltrovano` byl hromadne presunut zpet do `Dorucena posta`
+- obnoveno bylo `15151` zprav
+- pote byl znovu zkontrolovan Inbox, mel `15151` zprav
+- nasledne byly znovu presunuty jen jasne existujici filtry s pevnou pojistkou na maximalni pocet vysledku
+
+Pojistka od teto chvile:
+
+- pokud hledani vrati podezrele moc vysledku, davka se nesmi vybrat ani presunout
+- u beznych davkovych uklidu pouzivat limit napr. `1000` zprav, u konkretni vetsi bankovni davky lze limit zvednout jen po posouzeni
+- `Dropbox - Last week's updates in your shared folders` neuklizet pres bezne hledani bez dalsi rucni kontroly, protoze SOGo pri tomto dotazu vratilo `13283` vysledku
+
+Po obnoveni a opatrnem znovuuklizeni mel Inbox `13283` zprav.
+
+## Dodatecny presun slozek pod Dorucenou postu
+
+Na zaklade pozadavku uzivatele byly pod `Dorucena posta` presunuty slozky:
+
+- `01 - Akcni - k reseni`
+- `07 - Reklamace`
+- `99 - Automaticky odfiltrovano`
+
+Po presunu slozky `99 - Automaticky odfiltrovano` bylo nutne opravit cile filtru, protoze filtry ukazovaly placeholder `Postovni schranka`.
+
+Opraveno:
+
+- 17 filtru s prefixem `99 Automaticky odfiltrovano`
+- cil byl znovu nastaven na `99 - Automaticky odfiltrovano`
+- SOGo zmeny byly ulozeny hlavnim `save`
+
+Detailni log je ulozen zde:
+
+- `docs/mail-sogo-folder-inbox-move-log-2026-08-06.md`