Блог CZ
2026-11-14 15:01 Telegram a automatizace

Mini App ukazuje uloženo, ale manažer vidí stará data: jak potvrdit změny

Klient v Telegram Mini App upraví údaje poptávky, uvidí „Uloženo“, ale manažer dál pracuje se starou verzí. Nejde jen o vzhled: zakázka se může zpracovat podle chybných pokynů. Příčinou bývá lokální stav rozhraní, přerušené API volání, zpožděná synchronizace, souběžné úpravy nebo zastaralá data v CRM. Je třeba přesně stanovit, kdy je změna opravdu uložená.

Změna pole není potvrzení serveru

Rozhraní musí rozlišovat „lokálně upraveno“, „ukládá se“, „server potvrdil“, „odmítnuto“ a „nutno znovu načíst“. Nenastavujte úspěch ihned po kliknutí, pokud API neodpovědělo. U offline režimu dohodněte, zda vzniká místní koncept, co přežije restart a kdy dojde k synchronizaci. Čekající požadavek není dokončená operace. Pro návrh srozumitelných stavů „ukládá se“, chyby spojení a bezpečného opakování může posloužit matice chybových a čekajících stavů rozhraní. Návrh obrazovky však sám neověří zápis na server ani konzistenci s CRM.

Souběžné editace vyžadují pravidlo konfliktu

Dva lidé otevřou revizi 7. První uloží revizi 8, zatímco druhý dál upravuje původní hodnotu. Bez verze záznamu či jiného dohodnutého zámku může pozdější odeslání neviditelně přepsat práci druhého. Posílejte očekávanou revizi a ověřujte ji na serveru. U důležitých údajů raději ukažte konflikt a vyžádejte nové potvrzení.

Telegram identita sama nedává právo upravovat vše

Oficiální dokumentace Telegramu vyžaduje ověřit Mini App initData na serveru; initDataUnsafe nesmí být důvěryhodným podkladem. Samotné ověření přihlášení ale nedává právo měnit cizí poptávky. Backend vždy prověří vlastnictví záznamu a oprávnění ke konkrétní operaci. Vývoj Telegram Mini Apps musí tuto logiku sladit s databází a obrazovkou manažera.

Vyplněný TASK-099: změna času kontaktu

Fiktivní poptávka A-099 má v revizi 7 čas 14:00. Klient jej změní na 16:00, server ověří práva a potvrdí revizi 8. Manažer, který má ještě otevřenou revizi 7, musí dostat upozornění nebo bezpečně načíst nový stav.

  1. Otevřete A-099 ve verzi 7 a místně změňte čas; do odpovědi serveru jde o neuložené údaje.
  2. Odešlete ID žádosti, očekávanou revizi 7 a čas 16:00, na serveru zkontrolujte vlastnictví.
  3. Teprve po odpovědi zobrazte potvrzení času 16:00 a případně identifikátor revize 8.
  4. V manažerském rozhraní aktualizujte hodnotu nebo ukažte, že pracuje se zastaralým záznamem.
  5. Vyzkoušejte konflikt: manažer z revize 7 předtím uloží 15:00. Server nesmí potichu ztratit jednu ze změn.

Pozitivní test: všichni vidí potvrzenou revizi 8 nebo zřetelný požadavek na obnovení. Negativní: aplikace ukazuje úspěch před API odpovědí, staré údaje přepíší nové nebo si uživatel změnou ID otevře cizí záznam.

Co musí být součástí zadání

Předejte datové schéma, editační kroky, role, API, způsob synchronizace, požadované logy, přípustná zpoždění a anonymizované konflikty. Technická podpora a úpravy webu mohou řešit část problémů s rozhraním; správu souběžných zápisů a zabezpečení je třeba řešit také na backendu. Zelený štítek „Uloženo“ není důkazem zápisu.

Verzování a strategie konfliktů

Pro každý upravovaný záznam určete autoritativní systém, správce revizí a reakci na konflikt. Kompatibilní změny různých polí lze spojit jen podle schváleného pravidla; dvě neslučitelné hodnoty vyžadují odmítnutí a nové rozhodnutí. Klientský údaj o čísle revize se vždy kontroluje na serveru.

Individuální technické ocenění

Přehled služeb a cen uvádí postup kalkulace podle práce, ale neobsahuje zaručenou transakční synchronizaci všech Mini App a CRM systémů. Složitost závisí na API, databázi, cache, opakovaných požadavcích a auditním protokolu. K posouzení pošlete přes kontakty architekturu, přístupové role, ukázkové požadavky a chyby bez osobních údajů.

Druhý scénář: doručovací adresa M-99

Klient M-99 otevře profil s verzí 7 a změní adresu A na B. API obdrží ID záznamu, očekávanou verzi 7 a novou hodnotu. Server po kontrole buď potvrdí revizi 8, nebo vrátí konflikt. Pokud manažer mezitím z téže revize uloží adresu C, nesmí se jedna z úprav bez vysvětlení ztratit.

  1. V Mini App je B lokální změnou; při výpadku sítě vznikne chybové hlášení, nikoli falešný úspěch.
  2. Server ověří identitu, práva k poli i očekávanou revizi 7, pak teprve může vytvořit revizi 8.
  3. Po úspěšné odpovědi aplikace znovu přečte autoritativní zdroj a ukáže B, CRM aktualizuje podle dohodnutého toku.
  4. Při konfliktu zobrazí aktuální stav a vyžádá výslovné nové potvrzení; C se automaticky nepřepisuje.

Přejímka TASK-099

Pozitivní: po opětovném otevření zůstává B a manažer po přípustné synchronizaci vidí stejnou verzi. Negativní: „hotovo“ se ukáže před serverem, pak vypadne síť a C přepíše B. Prověřte také pokus o změnu ID cizího záznamu, opožděné CRM události, bezpečné opakování a zastaralou cache. Úspěch na obrazovce nepředstavuje garanci nulového zpoždění mezi službami. Při opakovaném doručení stejné události se hodí principy idempotentního webhooku a bezpečného opakování operace. Ty řeší duplicity stejné události; konflikt dvou odlišných úprav revize 7 musí server vyhodnotit samostatně.