Files
hope-events/frontend/src/components/shared/HelpFab.tsx
T
joshuaandClaude Sonnet 5 8e6cb542d9 Full site redesign, help system, and dashboard stats fixes
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>
2026-08-06 15:00:10 +02:00

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} />}
</>
);
}