Multi-phase visual facelift (design tokens, dashboards, sidebar/navbar shell, per-page help guides, and a layout/content pass across every remaining page) plus backend fixes to the dashboard KPI stats: - Admin/Supervisor dashboard KPIs (revenue, donations, registrations, tickets sold) now use a rolling trailing-month window (today back one calendar month, e.g. 9 May - 8 June if today is 8 June) instead of calendar month-to-date, which under-counted for most of the month. The comparison window shifts the same way, so like is still compared with like. - Reports deep-links from those stat tiles now match the same window (range=trailing_month, replacing range=this_month). - Design tokens (brand-* Tailwind scale + shadcn CSS variables), a site-wide contextual help button, fixed dashboard sidebar/navbar, Admin/Supervisor/Staff/User dashboard rebuilds backed by a new GET /api/stats/overview endpoint, a dedicated Contact page, Site Settings restyle with WhatsApp config folded in, and an Account activity feed backed by a new SecurityEvent model. - Every remaining page (home, events, registration flow, auth, legal, payment results, and every Admin/Supervisor/Staff/User tool page) restyled onto the same design tokens, several with real layout upgrades (home hero, events list/detail, donate page, auth pages). - 20+ new dedicated help guides so the whole site has page-specific help content instead of falling back to a generic guide. - Assorted fixes surfaced along the way: donation-leg double-counting in payment stats, donations not counting toward revenue, refund netting in per-method report breakdowns, and donation over-allocation after a refund. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
46 lines
1.7 KiB
TypeScript
46 lines
1.7 KiB
TypeScript
"use client";
|
|
|
|
import React from "react";
|
|
import { usePathname } from "next/navigation";
|
|
import { HelpCircle } from "lucide-react";
|
|
import { useHelpGuide } from "@/hooks/useHelpGuide";
|
|
import { resolveHelpContent } from "@/content/help/registry";
|
|
import HelpGuideModal from "./HelpGuideModal";
|
|
|
|
/**
|
|
* The site's single help entry point — a floating round button, present on
|
|
* every page (mounted once in the root layout). Content is resolved from
|
|
* the current route via content/help/registry.ts, falling back to general
|
|
* baseline content (how to register / view tickets) for any page without a
|
|
* dedicated guide yet.
|
|
*/
|
|
// Unattended/operator-driven screens where a floating help button would just
|
|
// get in the way (kiosk touchscreen, first-run setup wizard) — this hook
|
|
// still runs, it just renders nothing there.
|
|
const EXCLUDED_PREFIXES = ["/self-service", "/setup"];
|
|
|
|
export default function HelpFab() {
|
|
const pathname = usePathname() || "/";
|
|
const { slug, content } = resolveHelpContent(pathname);
|
|
const { open, openGuide, closeGuide } = useHelpGuide(slug);
|
|
|
|
if (EXCLUDED_PREFIXES.some(prefix => pathname.startsWith(prefix))) {
|
|
return null;
|
|
}
|
|
|
|
return (
|
|
<>
|
|
<button
|
|
type="button"
|
|
onClick={openGuide}
|
|
aria-label="Help"
|
|
// bottom-20 on mobile clears BottomNav (fixed, h-16 + safe-area, z-50).
|
|
className="fixed z-40 bottom-20 md:bottom-6 right-4 md:right-6 w-12 h-12 rounded-full bg-brand-600 text-white shadow-lg hover:bg-brand-700 hover:scale-105 hover:shadow-xl active:scale-95 flex items-center justify-center transition-all"
|
|
>
|
|
<HelpCircle className="w-6 h-6" />
|
|
</button>
|
|
{open && <HelpGuideModal content={content} onClose={closeGuide} />}
|
|
</>
|
|
);
|
|
}
|