thrilltrack-explorer/docs/moderation/ARCHITECTURE.md

Moderation Queue Architecture

Overview

The moderation queue system is a comprehensive content review platform that enables moderators to review, approve, and reject user-submitted content including park/ride submissions, photo uploads, and user reviews.

System Architecture

Core Components

┌─────────────────────────────────────────────────────────────┐
│                    ModerationQueue (Root)                    │
│  - Entry point for moderation interface                     │
│  - Manages UI state (modals, dialogs)                       │
│  - Delegates business logic to hooks                         │
└────────────┬────────────────────────────────────────────────┘
             │
             ├─► useModerationQueueManager (Orchestrator)
             │   └─► Combines multiple sub-hooks
             │       ├─► useModerationFilters (Filtering)
             │       ├─► usePagination (Page management)
             │       ├─► useModerationQueue (Lock management)
             │       ├─► useModerationActions (Action handlers)
             │       ├─► useEntityCache (Entity name resolution)
             │       └─► useProfileCache (User profile caching)
             │
             ├─► QueueFilters (Filter controls)
             ├─► QueueStats (Statistics display)
             ├─► LockStatusDisplay (Current lock info)
             │
             └─► QueueItem (Individual submission renderer)
                 └─► Wrapped in ModerationErrorBoundary
                     └─► Prevents individual failures from crashing queue