joshuaandClaude Opus 5.5
709ea38c10
Percentage, fixed-amount and comp codes, limited by event, ticket option or variant, dates, use counts, minimum quantity, and people, roles or an email domain. The discount is locked in on the registration (mirrored on Registration.discountTotal so every total sees it), shows on invoices, receipts, emails and the Yoco checkout, and is released on cancellation. Use limits are enforced under an advisory lock. Ticket options and variants can also carry a staff price that Staff and above get automatically. Adds a Supervisor > Coupon codes page, code fields on registration, My Events, manual registration, at the door and the kiosk, a Discounts report, and audit log entries. Also fixes Yoco line items and the free-registration check for lines spanning several price tranches. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
74 lines
4.2 KiB
TypeScript
74 lines
4.2 KiB
TypeScript
import React from "react";
|
|
import { TicketPercent, Plus, Users, CalendarClock, Layers, Ban, BarChart2, BadgePercent, DoorOpen } from "lucide-react";
|
|
import { GuideItem } from "@/components/shared/GuideItem";
|
|
import type { HelpContent } from "./types";
|
|
|
|
/** Help content for /dashboard/supervisor/coupons. */
|
|
export const supervisorCouponsHelpContent: HelpContent = {
|
|
title: "Coupon codes",
|
|
subtitle: "Discounts for staff, leaders, volunteers and promotions.",
|
|
tabs: [
|
|
{
|
|
key: "create",
|
|
label: "Creating codes",
|
|
icon: Plus,
|
|
content: (
|
|
<div className="space-y-4">
|
|
<div className="space-y-4">
|
|
<GuideItem icon={TicketPercent} title="Discount type" tone="brand">
|
|
A percentage off, a fixed rand amount off, or free (100%). People type the code on the registration page; it isn't case-sensitive.
|
|
</GuideItem>
|
|
<GuideItem icon={Layers} title="Events and tickets" tone="green">
|
|
Leave the events unticked for every event, or pick one or more. Once events are picked you can limit the code to certain ticket options or variants — otherwise it discounts the whole registration.
|
|
</GuideItem>
|
|
<GuideItem icon={BadgePercent} title="Early-bird prices" tone="violet">
|
|
By default the better of the two prices wins: the code is worked out against the standard price, and only what beats the early-bird price comes off. Tick "Also apply on top of early-bird prices" to stack them.
|
|
</GuideItem>
|
|
<GuideItem icon={CalendarClock} title="Dates and limits" tone="amber">
|
|
Optional start and end dates, a maximum number of uses overall, a maximum per person (1 by default), and a minimum number of tickets.
|
|
</GuideItem>
|
|
<GuideItem icon={Users} title="Who can use it" tone="blue">
|
|
Anyone with the code, people with certain roles (e.g. Staff and above), specific people, or an email domain. Restricted codes need the person to be logged in, so they can't be passed around a group chat.
|
|
</GuideItem>
|
|
</div>
|
|
</div>
|
|
),
|
|
},
|
|
{
|
|
key: "using",
|
|
label: "How discounts work",
|
|
icon: TicketPercent,
|
|
content: (
|
|
<div className="space-y-4">
|
|
<div className="space-y-4">
|
|
<GuideItem icon={TicketPercent} title="Locked in when applied" tone="brand">
|
|
The discount is saved on the registration and shows as its own line on invoices, receipts, emails and the payment page. Turning a code off later doesn't change discounts already given.
|
|
</GuideItem>
|
|
<GuideItem icon={Layers} title="Changing items" tone="green">
|
|
If the items on a registration change, percentage and free codes are worked out again on the new items. Fixed-amount codes keep their amount.
|
|
</GuideItem>
|
|
<GuideItem icon={Ban} title="Cancellations" tone="rose">
|
|
Cancelling a registration frees its code so it can be used again. A free code that covers everything marks the registration paid and sends the tickets.
|
|
</GuideItem>
|
|
<GuideItem icon={DoorOpen} title="Applying for someone" tone="amber">
|
|
Manual registration, At the door and the kiosk all have a "Have a code?" field. Every code staff apply is recorded in the admin audit log.
|
|
</GuideItem>
|
|
</div>
|
|
<p className="text-xs text-gray-500">Staff price: a ticket option can also have a staff price (set in the event's Items & pricing step) that Staff and above get automatically, with no code.</p>
|
|
</div>
|
|
),
|
|
},
|
|
{
|
|
key: "tracking",
|
|
label: "Tracking",
|
|
icon: BarChart2,
|
|
content: (
|
|
<div className="space-y-4">
|
|
<p>"Uses" on each code lists who used it, on which event, and how much it took off. The <strong>Discounts</strong> report (Reports → Financial) totals uses and value given away per code and event, and the Finance report shows sales after discounts.</p>
|
|
<p className="text-xs text-gray-500">A code that has been used can't be renamed — turn it off and create a new one instead.</p>
|
|
</div>
|
|
),
|
|
},
|
|
],
|
|
};
|