Help System — Architecture & Overview

packages/common/src/help-types.ts          ← HelpPageData / HelpSection types (10 kinds)
packages/ui/src/HelpPage.tsx               ← full renderer; breadcrumbs; deep links; prev/next; ratings; related
packages/ui/src/HelpCenter.tsx             ← directory with Fuse.js search, ?-shortcut, category filter
packages/ui/src/HelpRating.tsx             ← thumbs up/down rating widget
packages/ui/src/HighlightText.tsx          ← Fuse.js match-index highlight renderer
packages/ui/src/lib/slugify.ts             ← section anchor ID generator

apps/dashboard/src/app/(dashboard)/help/
  ├── _data/index.ts                       ← 41 topics (26 original + 15 content-gap topics)
  ├── page.tsx                             ← /help (HelpCenter + onSearch analytics)
  ├── [slug]/page.tsx                      ← dynamic route (replaces 26 static dirs)
  ├── [slug]/HelpPageClient.tsx            ← client wrapper with onRate action
  └── actions.ts                           ← rateHelpPage() + recordHelpSearch() server actions

apps/dashboard/src/components/help/
  ├── HelpDrawerProvider.tsx               ← slide-in drawer context + open(slug, hash?) / close()
  └── HelpTrigger.tsx                      ← <HelpTrigger slug="..." label="..." /> — used on all 22 feature pages

apps/api/src/routers/help.ts               ← POST /tenant/v1/help/rating + /search-event

interface HelpPageData {
  slug: string;
  title: string;
  description: string;
  category: HelpCategory;     // 13 valid values — see below
  categoryLabel: string;
  icon: string;               // Lucide icon name
  backHref: string;           // required — link shown in breadcrumb
  backLabel: string;
  tags?: string[];
  sections: HelpSection[];
  related?: string[];         // slugs of related topics
}

import { HelpTrigger } from "@/components/help/HelpTrigger";
// In JSX:
<HelpTrigger slug="my-slug" label="Help: My Page" />