Přeskočit na obsah

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’;

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”.

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á.

  1. Index přes všechny složky: Message-ID → [složky] + složka → UID set (jen hlavičky HEADER.FIELDS (MESSAGE-ID), žádná těla).
  2. 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.
  3. 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.
  4. Throttle 1× za hodinu na schránku (uloženo v JSON stavu syncu), protože index celé schránky je drahý.
  5. 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).
Přidal aiarchitekt.cz · 24. 9. 2026 2:00
Provozuje aiarchitekt.cz