Add sponsor a spot

Events can allow sponsorships: a "Sponsor a spot" button lets anyone
(guests included) pay through Yoco for whole spots or a custom amount,
anonymously or with a name and message. Payments land as event
donations in a sponsorship pool that supervisors assign with the
existing donation flow. Adds optional public progress towards a goal,
a sponsor receipt and Automations thank-you, pool columns in the
Donations report, and sponsorship labels/filter in Payments.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-19 15:04:29 +02:00
co-authored by Claude Opus 5.5
parent 9bdd3250bf
commit dff83d47af
23 changed files with 594 additions and 177 deletions
@@ -0,0 +1,146 @@
"use client";
import React, { useEffect, useState } from "react";
import { HeartHandshake, X } from "lucide-react";
import { apiFetch } from "@/lib/api";
import { useAuth } from "@/hooks/useAuth";
type Sponsorship = { enabled: boolean; open?: boolean; spotPrice?: number | null; showProgress?: boolean; goalSpots?: number | null; spotsFunded?: number | null; sponsors?: number | null };
const inputCls = "w-full border rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-brand-400";
const rand = (n: number) => `R${n.toLocaleString("en-ZA", { minimumFractionDigits: n % 1 ? 2 : 0, maximumFractionDigits: 2 })}`;
/**
* "Sponsor a spot": progress towards the event's sponsorship goal, and a form to fund
* one or more spots (or any amount) for people who can't afford to come. Payment is
* through Yoco; the money lands in the event's sponsorship pool.
*/
export function SponsorSpot({ eventId, eventTitle }: { eventId: string; eventTitle: string }) {
const { token, user } = useAuth();
const [data, setData] = useState<Sponsorship | null>(null);
const [open, setOpen] = useState(false);
const [mode, setMode] = useState<"spots" | "amount">("spots");
const [spots, setSpots] = useState(1);
const [amount, setAmount] = useState("");
const [anonymous, setAnonymous] = useState(false);
const [sponsorName, setSponsorName] = useState("");
const [message, setMessage] = useState("");
const [guest, setGuest] = useState({ name: "", email: "" });
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const [returned, setReturned] = useState<string | null>(null);
useEffect(() => {
apiFetch<Sponsorship>(`/api/sponsorships/event/${encodeURIComponent(eventId)}`).then(setData).catch(() => setData(null));
try {
const s = new URLSearchParams(window.location.search).get("sponsored");
if (s) setReturned(s);
} catch { /* no window */ }
}, [eventId]);
if (!data?.enabled) return null;
const price = data.spotPrice || null;
const loggedIn = !!(token && user);
const total = mode === "spots" && price ? spots * price : Number(amount) || 0;
const goal = data.goalSpots || 0;
const funded = data.spotsFunded ?? 0;
const submit = async (e: React.FormEvent) => {
e.preventDefault();
setBusy(true);
setError(null);
try {
const res = await apiFetch<{ redirectUrl: string }>("/api/sponsorships/checkout", {
method: "POST",
...(loggedIn ? { authToken: token! } : {}),
body: {
eventId,
...(mode === "spots" && price ? { spots } : { amount: Number(amount) }),
anonymous,
...(!anonymous && sponsorName.trim() ? { sponsorName: sponsorName.trim() } : {}),
...(message.trim() ? { message: message.trim() } : {}),
...(!loggedIn ? { name: guest.name, email: guest.email } : {}),
},
});
window.location.href = res.redirectUrl;
} catch (err: any) {
setError(err?.message || "Couldn't start the payment");
setBusy(false);
}
};
return (
<div className="mt-4 border-t pt-4 space-y-2">
{returned === "1" && <div className="text-sm rounded-lg bg-green-50 text-green-800 p-2">Thank you for sponsoring! Your receipt is on its way.</div>}
{returned === "failed" && <div className="text-sm rounded-lg bg-red-50 text-red-800 p-2">The payment didn&apos;t go through. You can try again.</div>}
{data.showProgress && price && (goal > 0 || funded > 0) && (
<div>
<div className="flex justify-between text-xs text-gray-600 mb-1">
<span>{goal > 0 ? `${Math.min(funded, goal)} of ${goal} spots sponsored` : `${funded} spot${funded === 1 ? "" : "s"} sponsored`}</span>
{data.sponsors ? <span>{data.sponsors} sponsor{data.sponsors === 1 ? "" : "s"}</span> : null}
</div>
{goal > 0 && (
<div className="h-2 rounded-full bg-gray-100 overflow-hidden" role="progressbar" aria-valuemin={0} aria-valuemax={goal} aria-valuenow={Math.min(funded, goal)}>
<div className="h-full bg-rose-500" style={{ width: `${Math.min(100, (funded / goal) * 100)}%` }} />
</div>
)}
</div>
)}
{data.open && (
<button onClick={() => setOpen(true)} className="w-full inline-flex items-center justify-center gap-2 border border-rose-300 text-rose-700 px-4 py-2 rounded-lg hover:bg-rose-50 font-medium text-sm">
<HeartHandshake className="w-4 h-4" /> Sponsor a spot
</button>
)}
{open && (
<div className="fixed inset-0 bg-black/40 flex items-center justify-center z-50" onClick={() => setOpen(false)}>
<form onSubmit={submit} className="bg-white rounded-xl shadow-lg max-w-md w-full mx-4 p-5 space-y-3 max-h-[90vh] overflow-y-auto" onClick={e => e.stopPropagation()}>
<div className="flex items-center justify-between">
<h3 className="text-lg font-semibold flex items-center gap-2"><HeartHandshake className="w-5 h-5 text-rose-600" /> Sponsor a spot</h3>
<button type="button" onClick={() => setOpen(false)} aria-label="Close" className="p-1 rounded hover:bg-gray-100"><X className="w-4 h-4" /></button>
</div>
<p className="text-sm text-gray-600">Help someone come to {eventTitle} who couldn&apos;t otherwise afford it. Your gift goes into a sponsorship pool that the organisers use to cover places.</p>
{price ? (
<div className="flex gap-2 text-sm">
<button type="button" onClick={() => setMode("spots")} className={`flex-1 px-3 py-1.5 rounded-lg border ${mode === "spots" ? "bg-rose-600 text-white border-rose-600" : "hover:bg-gray-50"}`}>Whole spots</button>
<button type="button" onClick={() => setMode("amount")} className={`flex-1 px-3 py-1.5 rounded-lg border ${mode === "amount" ? "bg-rose-600 text-white border-rose-600" : "hover:bg-gray-50"}`}>Any amount</button>
</div>
) : null}
{mode === "spots" && price ? (
<div className="flex items-center gap-2 text-sm">
<input type="number" min={1} max={100} className={`${inputCls} w-24`} value={spots} onChange={e => setSpots(Math.max(1, Math.min(100, parseInt(e.target.value, 10) || 1)))} aria-label="Number of spots" />
<span>spot{spots === 1 ? "" : "s"} × {rand(price)} = <strong>{rand(spots * price)}</strong></span>
</div>
) : (
<div>
<label className="block text-xs text-gray-600 mb-1">Amount (R)</label>
<input type="number" min={15} step="0.01" className={inputCls} value={amount} onChange={e => setAmount(e.target.value)} placeholder="e.g. 200" required />
<p className="text-xs text-gray-500 mt-1">Minimum R15.</p>
</div>
)}
{!loggedIn && (
<div className="grid grid-cols-1 sm:grid-cols-2 gap-2">
<input className={inputCls} placeholder="Your name" value={guest.name} onChange={e => setGuest({ ...guest, name: e.target.value })} required />
<input type="email" className={inputCls} placeholder="Email (for your receipt)" value={guest.email} onChange={e => setGuest({ ...guest, email: e.target.value })} required />
</div>
)}
<label className="flex items-center gap-2 text-sm cursor-pointer">
<input type="checkbox" checked={anonymous} onChange={e => setAnonymous(e.target.checked)} /> Give anonymously
</label>
{!anonymous && (
<input className={inputCls} placeholder={`Name to show the organisers (e.g. "The Smith family")`} value={sponsorName} onChange={e => setSponsorName(e.target.value)} maxLength={100} />
)}
<textarea className={inputCls} rows={2} placeholder="A message for the organisers (optional)" value={message} onChange={e => setMessage(e.target.value)} maxLength={300} />
<p className="text-xs text-gray-500">You&apos;ll get a receipt by email. We never share who is helped by sponsorships.</p>
{error && <div className="p-2 rounded bg-red-50 text-red-800 text-sm">{error}</div>}
<button type="submit" disabled={busy || !(total >= 15)} className="w-full px-4 py-2 rounded-lg bg-rose-600 text-white hover:bg-rose-700 disabled:opacity-50 font-medium">
{busy ? "Opening payment…" : `Pay ${total > 0 ? rand(total) : ""} securely`}
</button>
</form>
</div>
)}
</div>
);
}
@@ -970,7 +970,10 @@ export default function ReportsV2({ onBack }: { onBack?: () => void } = {}) {
const used = dons.reduce((s: number, p: any) => s + usedFor(evId, p.id), 0);
const unused = Math.max(total - used, 0);
grandTotal += total; grandUsed += used;
rows.push([ev?.title || evId, Number(total.toFixed(2)), Number(used.toFixed(2)), Number(unused.toFixed(2)), dons.length]);
const pool = dons.filter((p: any) => p.isSponsorship);
const poolIn = pool.reduce((s: number, p: any) => s + (p.amount || 0), 0);
const poolUsed = pool.reduce((s: number, p: any) => s + usedFor(evId, p.id), 0);
rows.push([ev?.title || evId, Number(total.toFixed(2)), Number(used.toFixed(2)), Number(unused.toFixed(2)), dons.length, Number(poolIn.toFixed(2)), Number(poolUsed.toFixed(2)), Number(Math.max(poolIn - poolUsed, 0).toFixed(2))]);
});
const grandUnused = Math.max(grandTotal - grandUsed, 0);
return {
@@ -981,7 +984,7 @@ export default function ReportsV2({ onBack }: { onBack?: () => void } = {}) {
{ label: 'Unused', value: `R ${grandUnused.toFixed(2)}`, tone: 'amber' },
],
chart: { title: 'Used vs. unused, across all selected events', data: [{ label: "Used", value: grandUsed, displayValue: `R ${grandUsed.toFixed(2)}` }, { label: "Unused", value: grandUnused, displayValue: `R ${grandUnused.toFixed(2)}` }] },
table: { columns: ["Event", "Donations (R)", "Used (R)", "Unused (R)", "Count"], rows }
table: { columns: ["Event", "Donations (R)", "Used (R)", "Unused (R)", "Count", "Sponsorship pool (R)", "Pool assigned (R)", "Pool remaining (R)"], rows }
};
}
if (report === "consentStatus") {
@@ -1775,7 +1778,10 @@ export default function ReportsV2({ onBack }: { onBack?: () => void } = {}) {
const used = dons.reduce((s: number, p: any) => s + usedFor(evId, p.id), 0);
const unused = Math.max(total - used, 0);
grandTotal += total; grandUsed += used; grandCount += dons.length;
return { evId, title: ev?.title || evId, total, used, unused, count: dons.length };
const pool = dons.filter((p: any) => p.isSponsorship);
const poolIn = pool.reduce((s: number, p: any) => s + (p.amount || 0), 0);
const poolUsed = pool.reduce((s: number, p: any) => s + usedFor(evId, p.id), 0);
return { evId, title: ev?.title || evId, total, used, unused, count: dons.length, poolIn, poolUsed, poolLeft: Math.max(poolIn - poolUsed, 0) };
});
const grandUnused = Math.max(grandTotal - grandUsed, 0);
return (
@@ -1799,6 +1805,9 @@ export default function ReportsV2({ onBack }: { onBack?: () => void } = {}) {
<th className="py-2 px-3 text-right">Unused (R)</th>
<th className="py-2 px-3 text-right">Count</th>
<th className="py-2 px-3 text-right">Avg (R)</th>
<th className="py-2 px-3 text-right">Sponsorship pool (R)</th>
<th className="py-2 px-3 text-right">Pool assigned (R)</th>
<th className="py-2 px-3 text-right">Pool remaining (R)</th>
</tr>
</thead>
<tbody>
@@ -1810,6 +1819,9 @@ export default function ReportsV2({ onBack }: { onBack?: () => void } = {}) {
<td className="py-2 px-3 text-right">R {row.unused.toFixed(2)}</td>
<td className="py-2 px-3 text-right">{row.count}</td>
<td className="py-2 px-3 text-right">{row.count ? `R ${(row.total / row.count).toFixed(2)}` : '-'}</td>
<td className="py-2 px-3 text-right">R {row.poolIn.toFixed(2)}</td>
<td className="py-2 px-3 text-right">R {row.poolUsed.toFixed(2)}</td>
<td className="py-2 px-3 text-right">R {row.poolLeft.toFixed(2)}</td>
</tr>
))}
<tr className="font-semibold bg-gray-50 border-t border-gray-200">
@@ -1819,6 +1831,9 @@ export default function ReportsV2({ onBack }: { onBack?: () => void } = {}) {
<td className="py-2 px-3 text-right">R {grandUnused.toFixed(2)}</td>
<td className="py-2 px-3 text-right">{grandCount}</td>
<td className="py-2 px-3"></td>
<td className="py-2 px-3 text-right">R {perEvent.reduce((s, r) => s + r.poolIn, 0).toFixed(2)}</td>
<td className="py-2 px-3 text-right">R {perEvent.reduce((s, r) => s + r.poolUsed, 0).toFixed(2)}</td>
<td className="py-2 px-3 text-right">R {perEvent.reduce((s, r) => s + r.poolLeft, 0).toFixed(2)}</td>
</tr>
</tbody>
</table>