Files
sorsfonalak/docs/promokodok.md
T
fecoandClaude Opus 5.5 8e1205359d
CI / test (push) Successful in 1m35s
CI / build (push) Successful in 8m7s
CI / deploy (push) Skipped
Inviting shown but off until launch; waitlist confirmation; waitlist invites with a package
USER_INVITES (default false) keeps users from inviting others until the
launch: the 'Meghívom' option and a 'Hívd meg, akit szeretsz' card on the
persons page are shown, disabled, with 'Hamarosan'; the backend refuses
with invites_disabled (admins may always).

Joining the waitlist sends one confirmation e-mail (waitlist_joined) with a
link that takes the address off the list and opts it out; at most 10 per
address in 15 minutes. Admins can pick a package for waitlist invitations,
like on the invitation form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-19 11:07:13 +00:00

4.6 KiB
Raw Blame History

Promókódok

Amíg a fizetés nincs bekötve, a csomagokat promókóddal (és admin ajándékkal) lehet megkapni. Élesben a vásárlás ki van kapcsolva: a MOCK_PAYMENTS alapértéke a deploy/docker-compose.yml-ben false. A csomagkártyákon ilyenkor „Hamarosan” felirat áll.

Admin: Admin → Promókódok

  • Kódkészítés:
    • Csomag (a fő csomagok és a kiegészítők közül), darab (1–500) és egy megjegyzés: kinek szól, melyik kampány.
    • Az elkészült kódok egy listában jelennek meg, a „Mind másolása” gombbal kimásolhatók.
    • A kód formája ABCD-EFGH-JKLM: 12 karakter, összetéveszthető betűk és számok nélkül (nincs 0/O, 1/I/L).
  • Lista:
    • Szűrhető állapotra: fel nem használt (ez az alapértelmezés), beváltott, visszavont, mind.
    • Szűrhető csomagra, és kereshető kódrészletre, megjegyzésre vagy a beváltó e-mail-címére.
    • A beváltott kódnál látszik, ki és mikor váltotta be.
  • Visszavonás: fel nem használt kódot vissza lehet vonni. Utána nem váltható be.

Felhasználó: beváltás

  • Hol lehet beváltani:
    • a fejléc „Kód beváltása” linkje (/bevaltas);
    • a Csomagok oldal „Van promókódod?” doboza;
    • a részletes elemzés ajánlata és a kérdés-válasz rész is ide vezet, ha nincs felhasználható egység.
  • Kitöltött link: a sorsfonalak.hu/bevaltas?kod=ABCD-EFGH-JKLM link kitöltve nyitja meg a kódot. Aki nincs belépve, a belépés után ide tér vissza. Elég ezt a linket elküldeni a meghívottaknak.
  • Beírás: a kód kis- vagy nagybetűvel, kötőjellel vagy anélkül is beírható.
  • Beváltás = feltöltés: a kód nem hozzáad, hanem feltölti az egyenleget a csomag szintjéig. Minden egységnél (képletelemzés, kapcsolati elemzés, előrejelzés, kérdés, szabad személyhely) az új egyenleg a csomag mennyisége lesz, ha addig kevesebb volt.
    • Ami elhasznált belőle, visszajön; ami ennél több van (például vett hozzá), megmarad.
    • Példa: a „Páros” csomag 2 képletelemzést ad. Ha valakinek 0 maradt, 2 lesz; ha 5 van, 5 marad.
    • Ha a felhasználónak már mindenből megvan a csomag mennyisége, a kódot nem váltjuk be (megmarad későbbre), és ezt üzenetben meg is mondjuk.
    • Könyvelés: egy package_orders sor promo forrással, 0 Ft-tal, és credit_ledger sorok csak a ténylegesen hozzáadott mennyiségekkel. A válaszban az added mező mondja meg, mi került hozzá.
  • Egyszer: egy kód egyszer váltható be. A „már felhasználták”, „már nem érvényes” és „nincs ilyen kód” esetekre külön üzenet van.
  • Találgatás ellen: 10 sikertelen próbálkozás után a felhasználó negyed óráig nem próbálkozhat.

Meghívó csomaggal

Az Admin → Meghívók oldalon az „Ajándék csomag” választóval minden meghívott kap egy promókódot a választott csomagra (megjegyzés: „meghívó: <cím>”).

  • A levélben benne van a csomag neve és a kód. A levél előnézete is mutatja (minta kóddal).
  • Regisztrációkor a kód magától beváltódik, ugyanazzal a feltöltéssel, mint a kézi beváltásnál. Ha mégsem, a kód kézzel is beváltható.
  • Újraküldéskor a levélben ugyanaz a kód marad.
  • Visszavonás: a meghívó visszavonása a még fel nem használt kódot is visszavonja.
  • A meghívók listájában látszik a csomag, és hogy beváltották-e.
  • A várólistán lévőket is csomaggal lehet meghívni: a „Várólista” táblázat fölötti választóval a „Meghívás” gomb azzal a csomaggal küldi a meghívót.

Várólista

  • Visszaigazolás: aki feliratkozik, egyszer kap egy visszaigazoló levelet (waitlist_joined), benne leiratkozó linkkel.
  • Leiratkozás: a link leveszi a címet a listáról, és felveszi a „nem kér levelet” listára, így meghívót sem küldünk oda többet.
  • Korlát: IP-címenként 15 percen belül legfeljebb 10 levél megy ki, hogy az űrlappal ne lehessen mások postafiókját elárasztani. A lista legfeljebb 10 000 cím.

API

Végpont Ki Mit csinál
POST /v1/admin/promo-codes {package, count, note?} admin kódok készítése
GET /v1/admin/promo-codes?status=unused|used|revoked|all&package=&q=&limit=&offset= admin lista
POST /v1/admin/promo-codes/{id}/revoke admin visszavonás
POST /v1/promo-codes/redeem {code} belépett felhasználó beváltás (feltöltés); a válaszban az új egyenleg, a csomag és az added
POST /v1/admin/invitations {emails, message?, locale?, package?} admin meghívó, opcionálisan csomaggal