Kompletní manuál

Popis celého prototypu Mooncher — co která část dělá, jak se používá při testování v terénu a jak se výsledky vyhodnocují. Verze k srpnu 2026.

01Co to je

Dnes je každý dárkový poukaz uzavřený ostrov. Hotel ho vydá, hotel ho přijme, a když ho host nevyčerpá, zůstane v rozvaze závazek. Slevové portály na tom vydělávají tím, že prodají nabídku a vezmou si provizi z prodeje — čím míň hostů dorazí, tím lépe pro ně.

Mooncher staví opak: sdílenou akceptační vrstvu. Voucher vydaný jedním členem sítě lze uplatnit i u jiného. Peníze přitom celou dobu leží na účtu vydavatele. Platíme se z uplatnění, ne z prodeje — takže máme stejný zájem jako hotel i jako host, aby ten poukaz někdo skutečně vyčerpal.

02Části systému

Vše kromě dashboardu běží na demo.mooncher.com. Rozcestník je na kořenové adrese.

03Rychlý start

1. Otevřít terminál v telefonudemo.mooncher.com/terminal.html
2. Přidat na plochuMenu prohlížeče → Přidat na domovskou obrazovku. Otevře se pak bez adresního řádku, jako aplikace.
3. Nastavit svou značkuKlepnout na řádek TESTER v horní liště, napsat iniciály a telefon.
4. Záložka UkázkaOtevře se rovnou QR kód. Od téhle chvíle jde jen o to někomu ho ukázat.

04Příprava testera

Nastavuje se jednou a uloží se do telefonu.

05Ukázka krok za krokem

Celé to má trvat do dvou minut. Rozhoduje první moment — ať druhý člověk co nejdřív drží něco vlastního.

1. Podržte displejZáložka Ukázka se otevře rovnou na QR kódu. Nic nemačkejte.
2. Ať to naskenuje fotoaparátemNic si neinstaluje. Na jeho telefonu naskočí karta s hodnotou 500 Kč. Tohle jsou ty tři vteřiny, ve kterých se rozhoduje.
3. Přepněte na Přijmout voucherZadejte 100 a načtěte QR z jeho displeje.
4. Potvrďte čerpáníUvidí, že mu zbylo 400 — a hlavně že zbytek zůstal jemu.
5. Zeptejte se„Kdyby tohle mohli lidi uplatnit u vás, chtěl byste to?“ Na jeho kartě jsou dvě tlačítka: Chci to pro svůj podnik a Zatím ne.
6. Vezměte si kódPo odpovědi se mu ukáže čtyřznakový kód. Nadiktuje vám ho.
7. Zadejte kód u sebeUkázka → pole Kód od něj → Uplatnit. Připíše se vám los.

06Potvrzovací kódy

Kód spojuje to, co udělala druhá strana, s tím, komu se má připsat los. Bez něj se k testerovi nic nedostane, protože telefony spolu nekomunikují.

• Kód se počítá z čísla karty, takže ho terminál ověří i bez internetu
• Každá akce dá jiný kód — v testovacím režimu neomezeně, v ostrém provozu nejvýš tři na kartu
• Stejný kód nejde uplatnit dvakrát
• Kód projde jen v tom terminálu, který kartu vydal

Když tester zadá kód s odpovědí „zatím ne“, terminál se ho rovnou zeptá na důvod. Tahle informace je z celého testu nejcennější — proto se sbírá u testera, ne na kartě.

07Terminál

Tři záložky: Přijmout voucher, Vydat voucher, Ukázka.

Přijmout voucher

Nejdřív částka, pak voucher — obráceně to nejde, protože bez částky není co autorizovat. Autorizace a potvrzení jsou dva kroky: schválení jen rezervuje, teprve Potvrdit čerpání odečte. Do té chvíle jde zrušit.

• Částečné čerpání — když je částka vyšší než zůstatek, nabídne se vyčerpat, co na kartě je
• Storno — u každého řádku v deníku, zůstatek se vrátí
• Doklad o čerpání — po potvrzení jde stáhnout i vytisknout na 80mm pásku

Vydat voucher

Hodnota, okruh, platnost, způsob předání — a vznikne kód s QR. Voucher je od té chvíle platný a jde hned uplatnit.

Souhrn dole neukazuje obrat, ale Vydáno / Uplatněno / Saldo. Vydání totiž není tržba, ale závazek; tržba nastane až uplatněním. Saldo je číslo, které dnes hoteliér nikde nevidí.

Offline režim

Přepíná se tlačítkem vpravo nahoře. Do 500 Kč terminál rozhodne sám a transakci zařadí do fronty; nad limit vrátí kód 91 a odmítne. Je to kompromis mezi rizikem a použitelností, který se v ostrém provozu nastavuje per provozovna.

Deník a uzávěrka

Deník drží všechny transakce, uzávěrka je sečte a rozepíše na vydané, uplatněné, saldo, offline frontu a storna.

08Karta

To, co uvidí druhá strana. Otevře se naskenováním QR běžným fotoaparátem, bez instalace a bez registrace — hodnota je v odkazu.

09Konzole sítě

Pravidla schématu. Každý akceptační okruh je samostatná omezená síť s vlastním stropem — proto se dá růst a přitom zůstat mimo těžkou regulaci.

• Karty okruhů — objem za dvanáct měsíců proti stropu a předpověď, kdy na něj při daném tempu narazí. Posuvník růstu tu předpověď přepočítává živě.
• Matice — kdo do kterého okruhu vydává a co přijímá. Buňky se proklikávají: mimo okruh → vydává → přijímá → obojí.
• Upozornění — okruh bez akceptantů, bez vydavatelů, nebo úplně opuštěný.

Vydávání a akceptace jsou dva různé seznamy. Provozovna může do okruhu vydávat, ale nepřijímat ho, a naopak.

10Čtečka

Nejjednodušší díl a historicky první. Přečte QR a vyloží, co v něm je — kód voucheru, pozvánka, peněženka, nebo něco cizího. Neptá se nikoho, takže neověřuje platnost ani zůstatek. Na placení používejte terminál.

11Dashboard

Jak se do něj dostanou data

1. Tester ťukne Odeslat dataDole v záložce Ukázka. Telefon nabídne sdílení.
2. Pošle to přes WhatsApp, SMS nebo mailJe to text, žádný soubor.
3. Vložíte a dáte NačístMůžete vložit víc dávek najednou i stejného testera opakovaně — novější přepíše starší.

Co ukazuje

• Přehled — testeři, ukázky, ano, ne, podíl ano, neúspěšné pokusy
• Odpovědi provozoven — rozpad na ano, ne a zapsaná místa
• Proč ne — žebříček důvodů. Tohle je jediné číslo, kvůli kterému se test dělá.
• Podle testera — kdo kolik ukázal a s jakým výsledkem
• Poptávka — pokusy, které neprošly, s částkami
• Tikety — kdo má kolik losů, s kontaktem

12Slosování

Z každého uplatněného kódu vzniknou dva tikety — jeden testerovi za ukázku, jeden provozovně za to, že odpověděla. Tiket dostane i ten, kdo řekl ne, takže se nikomu nevyplácí říkat ano.

1. Napište výhruA vyberte skupinu — všichni, jen průzkumníci, nebo jen provozovny.
2. Vygenerujte seed a zveřejněte hoTohle je to podstatné. Seed musí ven dřív, než losování proběhne.
3. LosujteVýsledek se spočítá z kombinace seedu a čísel tiketů, takže si ho každý může přepočítat.
4. Kolo se uložíSe seedem, skupinou, počtem tiketů a výherci včetně kontaktu.

13Referenční tabulky

Chybové kódy

Testovací vouchery

Terminál je nastavený jako Hotel Royal — recepce, přijímá okruhy wellness a gastro, vydává do wellness. Proto Golden Blot vrátí kód 57 — není to chyba, je to ukázka toho, jak okruhy fungují.

14Technické poznámky

Bezserverový voucher

Kód nese zůstatek, platnost, okruh, vydavatele, značku toho, kdo kartu předal, a kontrolní blok. Terminál ho ověří podpisem, odečte a vygeneruje nový kód s novým zůstatkem. Proto se karta po každém čerpání musí přeskenovat.

Funguje to bez internetu a bez databáze. Nevýhoda: kdo si QR vyfotí, má stejnou hodnotu jako držitel. Pro ukázku to nevadí, pro ostrý provoz to vyřeší až společná hlavní kniha.

Kontrolní blok

Čtyři znaky na konci kódu se počítají z pořadového čísla tajným klíčem. Je to stejný princip jako CVV u karty — bez klíče se nedá spočítat, i když algoritmus i vstup znáte. Terminál díky tomu pozná padělek i offline. Abeceda je bez znaků, které se pletou, aby se kód dal diktovat po telefonu.

Verze a mezipaměť

Dole na terminálu i na kartě je číslo verze. Když po nahrání nové verze číslo nesedí, drží prohlížeč starou — načtěte natvrdo, nebo zkuste anonymní okno. Service worker přednostně bere síť, takže se to obvykle nestává.

Aplikace na ploše

Po přidání na plochu běží bez adresního řádku. Když se ikona nebo režim nezmění, smažte starého zástupce a přidejte ho znovu — sám se nepřepne.

15Co zatím nefunguje

16Když něco nejde

ROOMS MANAGEMENT s.r.o. · IČO 27433935 · srpen 2026
Prototyp, ne hotový produkt. Žádné skutečné peníze, žádné účtování.
Dotazy a postřehy posílejte tomu, kdo vám poslal odkaz.