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>
This commit is contained in:
2026-08-06 15:00:10 +02:00
co-authored by Claude Sonnet 5
parent d74fec3a5c
commit 8e6cb542d9
119 changed files with 5116 additions and 4316 deletions
+5 -5
View File
@@ -4,14 +4,14 @@ import Link from "next/link";
import { usePathname } from "next/navigation";
import { useAuth } from "@/hooks/useAuth";
import { Home, Calendar, Phone, LogIn, UserPlus, LayoutDashboard, LogOut } from "lucide-react";
import { useSiteSettings } from "@/contexts/SiteSettingsContext";
import { brandColor } from "@/lib/siteConfig";
import { BRAND_600 } from "@/lib/theme";
export const BottomNav = () => {
const { user, loading: authLoading, logout } = useAuth();
const pathname = usePathname();
const { settings } = useSiteSettings();
const accentColor = settings.accent_color || brandColor;
// Fixed brand color — unlike the navbar's org name, nothing here is
// admin-configurable (see globals.css for the rule).
const accentColor = BRAND_600;
const handleLogout = () => {
logout();
@@ -32,7 +32,7 @@ export const BottomNav = () => {
const items: NavItem[] = [
{ href: "/", label: "Home", icon: Home },
{ href: "/events", label: "Events", icon: Calendar },
{ href: "/#contact", label: "Contact", icon: Phone },
{ href: "/contact", label: "Contact", icon: Phone },
...(authLoading
? []
: user
+25 -4
View File
@@ -2,6 +2,7 @@
import Link from "next/link";
import Image from "next/image";
import { usePathname } from "next/navigation";
import { useAuth } from "@/hooks/useAuth";
import { useSiteSettings } from "@/contexts/SiteSettingsContext";
import { BottomNav } from "./BottomNav";
@@ -18,10 +19,20 @@ type NavLink = {
export const Navbar = () => {
const { user, loading: authLoading, logout } = useAuth();
const { settings, loading: settingsLoading } = useSiteSettings();
const pathname = usePathname();
// Admin-configurable — applied ONLY to the org name text below via inline
// style. No other element in the navbar (or anywhere else) should read
// this; everything else uses the fixed brand-* palette.
const displayName = settings.org_name || appName;
const displayColor = settings.accent_color || brandColor;
const logoSrc = settings.logo_url ? resolveToApiOrigin(settings.logo_url) : null;
const isActive = (href: string) => {
if (href.includes("#")) return false;
if (href === "/") return pathname === "/";
return pathname?.startsWith(href) ?? false;
};
const handleLogout = () => {
logout();
window.location.href = "/";
@@ -30,7 +41,7 @@ export const Navbar = () => {
const navLinks: NavLink[] = [
{ href: "/", label: "Home" },
{ href: "/events", label: "Events" },
{ href: "/#contact", label: "Contact" },
{ href: "/contact", label: "Contact" },
];
const authLinks: NavLink[] = user
@@ -78,7 +89,12 @@ export const Navbar = () => {
<Link
key={link.href}
href={link.href}
className="text-sm text-gray-700 hover:text-blue-600"
className={
"text-sm pb-0.5 border-b-2 transition-colors " +
(isActive(link.href)
? "text-brand-600 border-brand-600 font-medium"
: "text-gray-700 border-transparent hover:text-brand-600")
}
>
{link.label}
</Link>
@@ -92,7 +108,7 @@ export const Navbar = () => {
<button
key={link.label}
onClick={link.onClick}
className="text-sm text-gray-700 hover:text-blue-600"
className="text-sm text-gray-700 hover:text-brand-600"
>
{link.label}
</button>
@@ -100,7 +116,12 @@ export const Navbar = () => {
<Link
key={link.href}
href={link.href}
className="text-sm text-gray-700 hover:text-blue-600"
className={
"text-sm pb-0.5 border-b-2 transition-colors " +
(isActive(link.href)
? "text-brand-600 border-brand-600 font-medium"
: "text-gray-700 border-transparent hover:text-brand-600")
}
>
{link.label}
</Link>
+73 -79
View File
@@ -1,106 +1,100 @@
"use client";
import React from "react";
import React, { useState } from "react";
import Link from "next/link";
import { Calendar, User, LayoutDashboard, ShieldCheck, Globe, Menu, type LucideIcon } from "lucide-react";
import { useAuth } from "@/hooks/useAuth";
import { RoleBadge } from "@/components/shared/RoleBadge";
import { useRouter, usePathname } from "next/navigation";
import { RoleBadge, type Role } from "@/components/shared/RoleBadge";
import { UserAvatar } from "@/components/shared/UserAvatar";
import { usePathname } from "next/navigation";
import { Sheet, SheetContent, SheetTrigger } from "@/components/ui/sheet";
const navLinks: { href: string; label: string; roles?: string[] }[] = [
{ href: "/dashboard/user", label: "My Events", roles: ["user", "staff", "supervisor", "admin"] },
{ href: "/dashboard/user/profile", label: "Profile & Security", roles: ["user", "staff", "supervisor", "admin"] },
{ href: "/dashboard/staff", label: "Staff", roles: ["staff"] },
{ href: "/dashboard/supervisor", label: "Supervisor", roles: ["supervisor"] },
{ href: "/dashboard/admin", label: "Admin", roles: ["admin"] },
{ href: "/dashboard/admin/settings", label: "Site Settings", roles: ["admin"] }
const navLinks: { href: string; label: string; icon: LucideIcon; roles?: string[] }[] = [
{ href: "/dashboard/user", label: "My Events", icon: Calendar, roles: ["user", "staff", "supervisor", "admin"] },
{ href: "/dashboard/user/profile", label: "Profile & Security", icon: User, roles: ["user", "staff", "supervisor", "admin"] },
{ href: "/dashboard/staff", label: "Staff", icon: LayoutDashboard, roles: ["staff"] },
{ href: "/dashboard/supervisor", label: "Supervisor", icon: LayoutDashboard, roles: ["supervisor"] },
{ href: "/dashboard/admin", label: "Admin", icon: ShieldCheck, roles: ["admin"] },
{ href: "/dashboard/admin/settings", label: "Site Settings", icon: Globe, roles: ["admin"] },
];
export function Sidebar() {
function SidebarNavContent({ onNavigate }: { onNavigate?: () => void }) {
const { user } = useAuth();
const role = user?.role || "user";
const role = (user?.role || "user") as Role;
const pathname = usePathname();
const links = navLinks.filter(l => !l.roles || l.roles.includes(role));
return (
<aside className="w-60 shrink-0 border-r bg-white p-4">
<div className="mb-4">
<div className="font-semibold">Dashboard</div>
{user && (
<div className="mt-1 text-xs text-gray-600 flex items-center space-x-2">
<span>{user.name}</span>
<RoleBadge role={role as any} />
<div className="flex flex-col h-full">
{user && (
<div className="mb-6 flex items-center gap-3">
<UserAvatar name={user.name} />
<div className="min-w-0">
<div className="text-sm font-semibold text-gray-900 truncate">{user.name}</div>
<RoleBadge role={role} className="mt-0.5" />
</div>
)}
</div>
</div>
)}
<nav className="space-y-1">
{navLinks
.filter((l) => !l.roles || l.roles.includes(role))
.map((l) => (
<Link key={l.href} className="block rounded px-3 py-2 text-sm hover:bg-gray-50" href={l.href}>
{links.map(l => {
const Icon = l.icon;
const active = pathname === l.href;
return (
<Link
key={l.href}
href={l.href}
onClick={onNavigate}
className={
"flex items-center gap-3 rounded-lg px-3 py-2 text-sm transition-colors " +
(active ? "bg-brand-50 text-brand-700 font-medium" : "text-gray-600 hover:bg-gray-50")
}
>
<Icon className="w-4 h-4 shrink-0" />
{l.label}
</Link>
))}
);
})}
</nav>
</div>
);
}
/** Desktop sidebar — fixed/pinned, does not scroll with page content. */
export function Sidebar() {
return (
<aside className="hidden md:flex md:flex-col w-64 shrink-0 h-full overflow-y-auto border-r bg-white p-4">
<SidebarNavContent />
</aside>
);
}
/** Mobile equivalent — a slim top strip with a hamburger that opens the same nav in a drawer. */
export function MobileSidebar() {
const { user } = useAuth();
const router = useRouter();
const role = user?.role || "user";
const pathname = usePathname();
const options = navLinks.filter((l) => !l.roles || l.roles.includes(role));
// Determine selected value based on current path or default by role
// Use longest matching href to handle nested paths (e.g. /dashboard/user/profile over /dashboard/user)
const selectedFromPath = options
.filter((o) => pathname?.startsWith(o.href))
.sort((a, b) => b.href.length - a.href.length)[0]?.href;
const roleDefault: Record<string, string> = {
admin: "/dashboard/admin",
supervisor: "/dashboard/supervisor",
staff: "/dashboard/staff",
user: "/dashboard/user",
};
const selectedValue = selectedFromPath || roleDefault[role] || options[0]?.href || "";
const handleChange = (e: React.ChangeEvent<HTMLSelectElement>) => {
const value = e.target.value;
if (value && value !== selectedValue) router.push(value);
};
const role = (user?.role || "user") as Role;
const [open, setOpen] = useState(false);
return (
<div className="md:hidden border-b bg-white px-4 py-3 shadow-sm">
<div className="flex items-center justify-between">
<div>
<div className="font-semibold">Dashboard</div>
{user && (
<div className="mt-0.5 text-xs text-gray-600 flex items-center space-x-2">
<span>{user.name}</span>
<RoleBadge role={role as any} />
</div>
)}
<div className="md:hidden border-b bg-white px-4 py-3 shadow-sm flex items-center justify-between shrink-0">
{user && (
<div className="flex items-center gap-2 min-w-0">
<UserAvatar name={user.name} className="w-8 h-8 text-xs" />
<div className="min-w-0">
<div className="text-sm font-semibold text-gray-900 truncate">{user.name}</div>
<RoleBadge role={role} />
</div>
</div>
</div>
<label className="sr-only" htmlFor="mobile-dashboard-nav">Navigate dashboard</label>
<select
id="mobile-dashboard-nav"
className="mt-3 w-full rounded-md border-gray-300 text-sm py-2 px-3 shadow-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500 bg-white"
value={selectedValue}
onChange={handleChange}
>
{/* Keep placeholder hidden if a value is selected */}
{!selectedValue && (
<option value="" disabled>
Select section...
</option>
)}
{options.map((l) => (
<option key={l.href} value={l.href}>
{l.label}
</option>
))}
</select>
)}
<Sheet open={open} onOpenChange={setOpen}>
<SheetTrigger asChild>
<button type="button" aria-label="Open navigation" className="p-2 rounded-md hover:bg-gray-100 shrink-0">
<Menu className="w-5 h-5" />
</button>
</SheetTrigger>
<SheetContent side="left" className="w-72 p-4">
<SidebarNavContent onNavigate={() => setOpen(false)} />
</SheetContent>
</Sheet>
</div>
);
}