IMAP sync mazal „chybějící" zprávy podle INBOXu — přesunuté do jiné složky skončily v koši
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Klient: „zpráva smazaná v telefonu zůstává v CRM”. Inkrementální UID sync stahuje jen nové zprávy (UID lastUid+1:*), o mazání se nikdy nedozví. První implementace „reconcile” načetla Message-ID hlavičky INBOXu a vše, co v CRM v INBOXu bylo a na serveru ne, přesunula do koše. Hned první běh: u 6 schránek 3–43 zpráv do koše, u 3 schránek pojistka (> 50 % nebo > 500 zpráv) běh zastavila — 249/415, 304/503, 690/6708 „chybějících”.
Root cause
Sekce “Root cause”Uživatelé v telefonu zprávy přesouvají (Archiv, vlastní složky), ne jen mažou. Přesunutá zpráva v INBOXu na serveru chybí, ale existuje jinde. CRM si u zprávy drží složku z doby stažení (dedup podle userId+messageId zabrání znovustažení v nové složce), takže z pohledu INBOX-only porovnání vypadá jako smazaná.
Fix
Sekce “Fix”- Index přes všechny složky:
Message-ID → [složky]+složka → UID set(jen hlavičkyHEADER.FIELDS (MESSAGE-ID), žádná těla). - Rozhodnutí per zpráva: nikde ⇒ koš; v jiné složce ⇒ přeřadit v CRM (Trash/Junk ⇒ koš), cílovou složku v CRM založit, aby zpráva „nezmizela” z UI.
- Pojistky zůstaly: index kompletní vč. INBOXu, server neprázdný, zprávy < 15 min se nehodnotí (závod s doručením), > 50 % / > 500 ⇒ přeskočit + log.
- Throttle 1× za hodinu na schránku (uloženo v JSON stavu syncu), protože index celé schránky je drahý.
- Jednorázová oprava: zprávy v koši CRM, které jsou na serveru v jiné složce než INBOX/Trash/Junk, vrátit do té složky (ty v INBOXu nevracet — to jsou ruční smazání v CRM, které se na server nepropisují).
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: po prvním běhu porovnat podíl „smazaných” per schránka; desítky procent = špatná definice „smazáno”. Pojistka na podíl/počet je levná a zachránila 3 schránky.
- Anti-pattern: odvozovat smazání z nepřítomnosti v jedné složce; zapisovat destruktivní stav (deleted) tam, kde stačí přeřazení.
- Lepší přístup: IMAP
\Deleted/EXPUNGE nelze zpětně zjistit — jediný spolehlivý signál je „Message-ID není v žádné složce”. U mailů bez Message-ID držet fallback na UID + UIDVALIDITY.
Sister bugs / související
Sekce “Sister bugs / související”- Ruční smazání v CRM se na IMAP nepropisuje — proto reconcile nesmí „obnovovat” zprávy nalezené v INBOXu (undo uživatelské akce v CRM).